hurui200320 dd6c20df5d fix(compiler): thread actor-level system_prompt into graph node metadata ...

actor/compiler.py:_map_node() already threaded provider and model from the
actor-level config into each AGENT node's merged_meta via setdefault, but
system_prompt was never added to the same pattern.

Three targeted additions across two files:

1. _map_node() in actor/compiler.py gains an actor_system_prompt parameter
   and applies merged_meta.setdefault("system_prompt", actor_system_prompt)
   inside the AGENT branch, directly after the existing provider/model calls.
   setdefault semantics ensure per-node config.system_prompt overrides take
   precedence, exactly matching the existing provider/model behaviour.

2. compile_actor() now passes actor_system_prompt=config.system_prompt to
   _map_node() so the actor-level field reaches every AGENT node.

3. Node._execute_agent() in langgraph/nodes.py injects the node's
   metadata["system_prompt"] into the context dict (before state.metadata
   is merged) so host agents can read context.get("system_prompt") without
   needing a direct reference to the raw ActorConfigSchema.

Seven BDD scenarios added in features/compiler_system_prompt.feature:
- Actor-level system_prompt is threaded into each AGENT node metadata.
- Per-node system_prompt takes precedence via setdefault semantics.
- process_message() receives system_prompt in the context dict.
- state.metadata["system_prompt"] overrides compiled default at runtime.
- Non-AGENT nodes (TOOL) do not receive system_prompt in metadata.
- Actor without system_prompt compiles metadata as None.
- Absent system_prompt is excluded from runtime context dict.

Bug fix: changed truthiness check from `if node_system_prompt:` to
`if node_system_prompt is not None:` in _execute_agent() to faithfully
pass empty-string system prompts into the context dict. Added explicit
`str | None` type annotation for node_system_prompt.

docs/reference/actor_compiler.md updated to document system_prompt
threading alongside provider and model in the Node Binding table.

Quality gates: lint, typecheck, unit_tests (14/14), coverage_report,
security_scan, dead_code, complexity all pass.

ISSUES CLOSED: #6

2026-05-22 06:05:16 +00:00

..

steps

fix(compiler): thread actor-level system_prompt into graph node metadata

2026-05-22 06:05:16 +00:00

compiler_system_prompt.feature

fix(compiler): thread actor-level system_prompt into graph node metadata

2026-05-22 06:05:16 +00:00

environment.py

docs(my-actor.yaml): add an example actor (#3)

2026-05-20 17:56:54 +00:00

smoke.feature

fix: sync doc with extraction scope, remove boundary violation, add ProviderRegistryPort

2026-05-21 10:10:37 +00:00