Epic: Actor YAML & Compiler #392
Notifications
Due Date
No due date set.
Blocks
Depends on
#374 Legendary: Actors, Skills & Tool Execution (Workstream C)
cleveragents/cleveragents-core
#157 feat(actor): extend hierarchical actor YAML schema and loader
cleveragents/cleveragents-core
#158 feat(actor): compile hierarchical actor configs to LangGraph
cleveragents/cleveragents-core
#198 feat(actor): add plan_subplan tool and decision emission
cleveragents/cleveragents-core
#288 feat(cli): align actor commands to YAML
cleveragents/cleveragents-core
#828 feat(plan): implement LLM-powered Strategy Actor
cleveragents/cleveragents-core
#869 feat(cli): add actor context remove, export, and import commands
cleveragents/cleveragents-core
#2065 Bug: `Tool.from_config()` and `Validation.from_config()` do not handle spec-compliant `tool:` wrapper key and `cleveragents:` version header
cleveragents/cleveragents-core
#2066 UAT: `agents tool show` for a Validation does not display spec-required `Attached To` field showing resource attachments
cleveragents/cleveragents-core
#2068 bug(tool): spec `resources:` dict format silently ignored — Tool.from_config() only reads `resource_slots:` list
cleveragents/cleveragents-core
#2069 UAT: `agents tool remove` for a Validation raises `ToolInUseError` instead of auto-detaching attachments as required by spec
cleveragents/cleveragents-core
#2107 bug(skills): `SkillConfigSchema` uses `agent_skill_folders` field name instead of spec-required `agent_skills` — spec-compliant skill YAML files are rejected
cleveragents/cleveragents-core
#2112 UAT: `SkillConfigSchema` uses `inline_tools` field name instead of spec-required `anonymous_tools` — spec-compliant skill YAML files are rejected
cleveragents/cleveragents-core
#2116 UAT: `SkillAgentFolderSchema` missing `sandbox_policy` field — spec-required Agent Skills sandbox configuration is silently ignored
cleveragents/cleveragents-core
#2117 UAT: `SkillConfigSchema` missing `builtins` field — spec-required built-in tool group opt-in is not supported
cleveragents/cleveragents-core
#2119 UAT: `SkillIncludeSchema` missing `tool_overrides` field — spec-required per-tool metadata overrides for included skills are not supported
cleveragents/cleveragents-core
#2123 UAT: `SkillMcpServerSchema` requires `transport` as a mandatory field — spec-compliant MCP server configs without explicit transport are rejected
cleveragents/cleveragents-core
#2124 UAT: `SkillToolRefSchema` missing `override` field — spec-required per-tool metadata overrides in skill tool references are not supported
cleveragents/cleveragents-core
#2125 UAT: `AgentSkillLoader` missing `execute()` method — spec-required 4-stage tool lifecycle is incomplete, Agent Skills cannot be executed
cleveragents/cleveragents-core
#2131 UAT: Agent Skills metadata not injected into actor system prompt in spec-required XML format — `<available_agent_skills>` block is never generated
cleveragents/cleveragents-core
#2136 UAT: `ToolCallRouter.route()` does not pass `linked_resource_types` to `ToolRunner.execute()` — container-routed tools always fail with `ContainerUnavailableError`
cleveragents/cleveragents-core
#2142 UAT: `MCPRefreshHook` only responds to push notifications — spec-required periodic polling for MCP tool changes not implemented
cleveragents/cleveragents-core
#2373 UAT: `agents actor run` missing spec-required structured output panels
cleveragents/cleveragents-core
#2388 UAT: `agents actor show` missing spec-required detail panels and fields
cleveragents/cleveragents-core
#2393 UAT: `agents actor add` silently overwrites existing actor without `--update` flag
cleveragents/cleveragents-core
#2405 UAT: `agents actor context` missing `list`, `show`, and `clear` subcommands
cleveragents/cleveragents-core
#2475 UAT: `SkillRegistry` calls inconsistent method names on `_tool_registry` — `get_tool()` vs `get()` causes `AttributeError` at runtime
cleveragents/cleveragents-core
#2477 UAT: `ActorConfigSchema` missing `global_context` field — Jinja2 template context from actor YAML is silently dropped
cleveragents/cleveragents-core
#2504 UAT: `SkillInlineToolSchema` missing `read_only` capability field — inline tools cannot be declared read-only via skill YAML
cleveragents/cleveragents-core
#2524 UAT: `MCPToolAdapter.register_tools()` infers resource slots but never wires them into domain `Tool` objects or the database — resource bindings are silently lost
cleveragents/cleveragents-core
#2537 UAT: `agents actor run` output missing spec-required structured panels — Run Summary, Inputs, and Result Metrics panels not rendered
cleveragents/cleveragents-core
#2555 UAT: `agents skill add` does not validate that included skills are registered — spec requires pre-registration check at add time
cleveragents/cleveragents-core
#2579 UAT: `agents skill add` does not detect circular includes at registration time — spec requires cycle detection on add
cleveragents/cleveragents-core
#2609 UAT: `agents actor add` does not enforce `--update` flag — re-adding an existing actor silently succeeds without `--update`
cleveragents/cleveragents-core
#2816 UAT: EstimationStubActor used in production instead of real actor registry dispatch
cleveragents/cleveragents-core
#2821 UAT: `agents invariant add` --plan and --action flags are not repeatable as required by spec
cleveragents/cleveragents-core
#2824 UAT: SkillService.get_dependents() always returns empty actors list — spec requires actor dependency tracking
cleveragents/cleveragents-core
#2826 UAT: `agents validation attach` does not reject plain Tools — only Validations should be attachable
cleveragents/cleveragents-core
#2840 UAT: `agents actor context list` command is missing — spec requires it but it is not implemented
cleveragents/cleveragents-core
#2843 UAT: InvariantService persistence fix (#1022) exists in branch but is NOT merged to master — invariants still lost between CLI invocations
cleveragents/cleveragents-core
#2846 UAT: `agents actor context show` command is missing — spec requires it but it is not implemented
cleveragents/cleveragents-core
#2848 UAT: `agents actor context clear` command is missing — spec requires it but it is not implemented
cleveragents/cleveragents-core
#2853 Bug: `agents actor add` bypasses v3 ActorConfigSchema validation — uses legacy v2 parser instead
cleveragents/cleveragents-core
#2885 UAT: `ActorConfigSchema` name validator rejects spec-required `server:namespace/name` format — only `namespace/name` accepted
cleveragents/cleveragents-core
#2887 UAT: `compile_actor()` reads LSP bindings from raw `node.config[\"lsp_bindings\"]` dict instead of structured `node.lsp_binding` field — per-node LSP binding is silently ignored
cleveragents/cleveragents-core
#2888 UAT: `actor_role_warnings()` only validates `ESTIMATION` role — `STRATEGY`, `EXECUTION`, and `INVARIANT_RECONCILIATION` roles have no compatibility checks
cleveragents/cleveragents-core
#2905 UAT: agents actor add - NAME positional argument missing from implementation (spec deviation)
cleveragents/cleveragents-core
#2918 UAT: `Actor` domain model has no `skills` field — actors cannot reference skills by name at the domain model level
cleveragents/cleveragents-core
#2936 UAT: `_TOOL_NAME_PATTERN` and `_SKILL_NAME_PATTERN` allow names/namespaces starting with digits — spec requires names to start with a letter
cleveragents/cleveragents-core
#2949 UAT: `Tool` name validator rejects spec-required server-qualified names — `[[server:]namespace/]name` format not supported
cleveragents/cleveragents-core
#2985 UAT: `ActionArgumentSchema` does not enforce `min_value`/`max_value` for `float` arguments — spec requires enforcement for both integer and float
cleveragents/cleveragents-core
#2989 UAT: Skill, Action, and Resource Type config schemas do not support `${ENV_VAR:default_value}` syntax — only `${ENV_VAR}` without defaults is implemented
cleveragents/cleveragents-core
#3000 UAT: `ActionArgumentSchema.validate_name` allows hyphenated argument names but BDD spec test expects them to be rejected — schema and test are contradictory
cleveragents/cleveragents-core
#3001 UAT: `ActorConfigSchema` does not support spec-defined top-level multi-actor structure — `actors`/`agents` map, `routes`, `merges`, `splits`, `templates`, `instances`, `global_context`, `prompts`, `pipelines` keys missing
cleveragents/cleveragents-core
#3021 UAT: Action name and actor name validators reject the spec-required `server:namespace/name` format — only `namespace/name` is accepted
cleveragents/cleveragents-core
#3039 UAT: `ActionArgumentSchema.validate_name` error message says "or hyphens" are allowed but BDD test expects hyphens to be invalid — misleading error message contradicts spec behavior
cleveragents/cleveragents-core
#3135 UAT: Cohere, Groq, and Together AI providers lack dedicated provider classes — only handled via generic LangChain dynamic imports
cleveragents/cleveragents-core
#3291 BUG-HUNT: [type-safety] Potential TypeError in `_canonical_blob`
cleveragents/cleveragents-core
#3405 UAT: `agents actor remove` missing `--format` flag — spec requires JSON/YAML/plain output support
cleveragents/cleveragents-core
#3410 UAT: Missing `agents actor context list`, `show`, and `clear` CLI subcommands
cleveragents/cleveragents-core
#3415 UAT: ActorRegistry.add() requires `provider` field not defined in v3 ActorConfigSchema
cleveragents/cleveragents-core
#3420 UAT: `agents actor remove` Impact section always shows 0 affected sessions/plans (not computed)
cleveragents/cleveragents-core
#3426 UAT: `agents actor add` bypasses YAML-first `ActorRegistry.add()` path, uses legacy `upsert_actor()` instead
cleveragents/cleveragents-core
#3481 UAT: `agents actor add` bypasses duplicate detection — silently upserts instead of failing without `--update`
cleveragents/cleveragents-core
#3486 UAT: `agents actor add --update` missing "Changes" panel in rich output
cleveragents/cleveragents-core
#3489 UAT: `agents actor show` missing Options, Graph Structure, Access, Usage panels and Built-in field
cleveragents/cleveragents-core
#3497 UAT: `agents tool add` missing "Capability" panel, Config path, and Created timestamp in rich output
cleveragents/cleveragents-core
#3504 UAT: `agents tool add --update` missing "Changes" and "References" panels in rich output
cleveragents/cleveragents-core
#3522 UAT: `agents skill refresh` command exists in implementation but is not defined in the specification
cleveragents/cleveragents-core
#3560 UAT: `agents action create` silently drops `estimation_actor`, `invariant_actor`, `automation_profile`, and `invariants` from YAML config
cleveragents/cleveragents-core
#3568 UAT: `NodeDefinition.actor_ref` field is ignored in actor compiler — SUBGRAPH node composition is broken
cleveragents/cleveragents-core
#3594 UAT: `agents actor add --update` output missing "Changes" panel — spec requires Skills/Model/Graph diff on update
cleveragents/cleveragents-core
#3597 UAT: `agents skill refresh` does not actually refresh MCP server tools — MCP re-enumeration is a TODO stub
cleveragents/cleveragents-core
#3602 UAT: `agents actor update` is an undocumented command — spec only defines `agents actor add --update` for updating actors
cleveragents/cleveragents-core
#3606 UAT: `agents actor` CLI JSON output uses `is_default`/`is_built_in` field names — spec requires `default`/`built_in`
cleveragents/cleveragents-core
#3608 UAT: `agents actor remove` Cleanup panel hardcodes `0 orphaned` contexts — actual orphaned context count is never computed
cleveragents/cleveragents-core
#3610 UAT: `NodeDefinition.tool_sources` field silently dropped by actor compiler — per-node tool source bindings (skills, MCP, builtins) never wired into compiled graph
cleveragents/cleveragents-core
#3611 UAT: `agents actor run` missing spec-required "Actor Run" output panel — outputs raw text instead of structured panel with Actor, Tokens, Duration
cleveragents/cleveragents-core
#3617 UAT: `agents actor update` is an undocumented separate command; spec only defines `agents actor add --update`
cleveragents/cleveragents-core
#3665 UAT: Tool model input_schema and output_schema are Optional (allow None) but spec requires them as mandatory fields
cleveragents/cleveragents-core
#3671 UAT: Validation model does not enforce mandatory `passed` boolean field in output_schema — violates spec Validation contract
cleveragents/cleveragents-core
#3678 UAT: SkillService.get_skill and remove_skill raise KeyError instead of domain NotFoundError
cleveragents/cleveragents-core
#3683 UAT: `agents validation attach` does not reject plain tools — spec requires type enforcement
cleveragents/cleveragents-core
#3684 UAT: `agents validation attach` uses positional `key=value` argument format instead of spec-required `--key value` named option format
cleveragents/cleveragents-core
#3753 BUG: [data-flow] Potential for Inconsistent State in `actor remove` — Missing Transactional Boundary
cleveragents/cleveragents-core
#3756 UAT: `agents actor add` requires undocumented positional NAME argument not in spec
cleveragents/cleveragents-core
#3758 BUG: [validation] Missing Validation for Actor Roles in CLI add/update Commands
cleveragents/cleveragents-core
#3794 UAT: agents actor context list, show, and clear subcommands missing from actor_context.py
cleveragents/cleveragents-core
#3800 UAT: `agents actor remove` Cleanup panel always shows `0 orphaned` contexts — not computing actual orphaned context count
cleveragents/cleveragents-core
#3805 UAT: SkillService.get_dependents() always returns empty actors list — actor-skill associations not tracked
cleveragents/cleveragents-core
#3811 BUG-HUNT: [type-safety] Missing 'timeout' argument in SkillInlineTool constructor in skill_flatten_bench.py
cleveragents/cleveragents-core
#3817 BUG-HUNT: [type-safety] Missing arguments in constructor calls in tool_model_bench.py
cleveragents/cleveragents-core
#3818 UAT: Actor `skills` field in YAML config is stored but never resolved at runtime — skill tools not injected into actor
cleveragents/cleveragents-core
#3821 UAT: `LangGraph.execute()` does not traverse graph nodes — returns immediately after sending to start stream without awaiting node execution
cleveragents/cleveragents-core
#3824 UAT: `response_format` field in actor config not wired to LLM provider calls in `LLMStrategizeActor` and `LLMExecuteActor`
cleveragents/cleveragents-core
#3835 UAT: `PureGraph.topological_order()` returns insertion order instead of a real topological sort, causing incorrect node execution order
cleveragents/cleveragents-core
#3902 UAT: `docs/schema/tool.schema.yaml` missing `wrapped` source enum value — schema diverges from `ToolSource` domain model
cleveragents/cleveragents-core
#3923 UAT: `Skill.from_config()` silently drops tool reference override fields (`description`, `writes`, `checkpointable`) from YAML — schema and domain model mismatch
cleveragents/cleveragents-core
#3934 UAT: `PlanLifecycleService` uses `EstimationStubActor` instead of real actor dispatch — estimation actor config is ignored
cleveragents/cleveragents-core
#4023 UAT: `Action.validate_arguments` silently accepts `bool` values for `INTEGER` type arguments due to Python's `bool` being a subclass of `int`
cleveragents/cleveragents-core
#4024 UAT: `action.py` module docstring incorrectly lists `path` as a supported argument type — `ArgumentType` enum only has `string`, `integer`, `float`, `boolean`, `list`
cleveragents/cleveragents-core
#4028 UAT: `ActionArgument.validate_name` rejects hyphenated argument names but `ActionConfigSchema` allows them — inconsistency between YAML schema and domain model
cleveragents/cleveragents-core
#4055 UAT: Spec documentation for message_router rule fields doesn't match implementation
cleveragents/cleveragents-core
#4058 UAT: Spec documentation for conditional edge condition format doesn't match implementation
cleveragents/cleveragents-core
#4092 UAT: `builtin/shell_execute` tool is completely absent — spec requires a built-in shell execution tool with `writes=True` and `checkpoint=snapshot`
cleveragents/cleveragents-core
#4097 UAT: Built-in tool names use hyphen-prefix format (`builtin/file-read`) but spec requires underscore format (`builtin/read_file`) — naming convention mismatch
cleveragents/cleveragents-core
#8992 feat(actor): implement actor CLI commands for registration, listing, and inspection
cleveragents/cleveragents-core
#8994 feat(actor): integrate compiled actors into subplan workflow execution
cleveragents/cleveragents-core
Reference: cleveragents/cleveragents-core#392
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Background
Covers hierarchical actor YAML schema, actor compiler pipeline, and related subplan generation. Actors can be defined in YAML, compiled into runtime representations, and used in subplan workflows.
Expected Behavior
Actors are defined in YAML using a hierarchical schema, compiled through the actor compiler pipeline into LangGraph StateGraph runtime representations, and integrated into subplan workflows.
Child Issues
Definition of Done
This Epic is complete when all child issues are closed and merged. Actors compile to LangGraph StateGraphs.
freemo referenced this issue2026-04-03 04:17:13 +00:00