<!-- Auto-generated by scripts/skill_generator.py. Do not edit manually. -->
<!-- Regenerate with: just skills -->

# API Surface Reference

Complete builder method inventory extracted from `seeds/seed.toml` and `manifest.json`.

## Configuration

| Method | Signature | Description |
|---|---|---|
| `.instruct()` | `(value: str | Callable[[ReadonlyContext], str | Awaitable[str]]) -> Self` | Set the main instruction / system prompt — what the LLM is told to do. Accepts p |

## Data flow

| Method | Signature | Description |
|---|---|---|
| `.context()` | `(spec: Any) -> Self` | Declare what conversation context this agent should see. Accepts a C module tran |

## Tools

| Method | Signature | Description |
|---|---|---|
| `.agent_tool()` | `(agent: Any) -> Self` | Wrap another agent as a callable AgentTool and add it to this agent's tools. The |
| `.tool()` | `(fn_or_tool: Any, *, require_confirmation: bool = False) -> Self` | Add a single tool (appends). Wraps plain callables in FunctionTool when require_ |
| `.tools()` | `(value: Any) -> Self` | Set tools. Accepts a list, a TComposite chain (T.fn(x) | T.fn(y)), or a single t |

## Callbacks

| Method | Signature | Description |
|---|---|---|
| `.guard()` | `(value: Any) -> Self` | Add an output validation guard. Accepts a G composite (G.pii() | G.length(max=50 |

## Transfer control

| Method | Signature | Description |
|---|---|---|
| `.isolate()` | `() -> Self` | Prevent this agent from transferring to parent or peers. Sets both disallow_tran |
| `.no_peers()` | `() -> Self` | Prevent this agent from transferring to sibling agents. The agent can still retu |
| `.stay()` | `() -> Self` | Prevent transfer to parent only (can still transfer to sibling peers). Equivalen |

## Memory

| Method | Signature | Description |
|---|---|---|
| `.memory()` | `(mode: str = 'preload') -> Self` | Add memory tools to this agent. Modes: 'preload', 'on_demand', 'both'. |
| `.memory_auto_save()` | `() -> Self` | Auto-save session to memory after each agent run. |

## Visibility

| Method | Signature | Description |
|---|---|---|
| `.hide()` | `() -> Self` | Force this agent's events to be internal (override topology inference). |
| `.show()` | `() -> Self` | Force this agent's events to be user-facing (override topology inference). |

## Schemas

| Method | Signature | Description |
|---|---|---|
| `.artifact_schema()` | `(schema: type) -> Self` | Attach an ArtifactSchema declaring artifact dependencies. |
| `.artifacts()` | `(*transforms: Any) -> Self` | Attach artifact operations (A.publish, A.snapshot, etc.) that fire after this ag |
| `.callback_schema()` | `(schema: type) -> Self` | Attach a CallbackSchema declaring callback state dependencies. |
| `.prompt_schema()` | `(schema: type) -> Self` | Attach a PromptSchema declaring prompt state dependencies. |
| `.tool_schema()` | `(schema: type) -> Self` | Attach a ToolSchema declaring tool state dependencies. |

## Execution

| Method | Signature | Description |
|---|---|---|
| `.ask()` | `(prompt: str) -> str` | One-shot SYNC execution (blocking). Builds agent, sends prompt, returns response |
| `.ask_async()` | `(prompt: str) -> str` | One-shot ASYNC execution (non-blocking, use with await). Safe in Jupyter, FastAP |
| `.eval()` | `(prompt: str, *, expect: str | None = None, criteria: Any | None = None) -> Any` | Inline evaluation. Run a single eval case against this agent. Returns an EvalSui |
| `.eval_suite()` | `() -> Any` | Create an evaluation suite builder for this agent. Returns an EvalSuite bound to |
| `.events()` | `(prompt: str) -> AsyncIterator[Any]` | Stream raw ADK Event objects. Yields every event including state deltas and func |
| `.map()` | `(prompts: list[str], *, concurrency: int = 5) -> list[str]` | Batch SYNC execution (blocking). Run agent against multiple prompts with bounded |
| `.map_async()` | `(prompts: list[str], *, concurrency: int = 5) -> list[str]` | Batch ASYNC execution (non-blocking, use with await). Safe in Jupyter, FastAPI,  |
| `.session()` | `() -> Any` | Create an interactive multi-turn chat session. Returns an async context manager  |
| `.stream()` | `(prompt: str) -> AsyncIterator[str]` | ASYNC streaming execution. Yields response text chunks as they arrive. Use with  |
| `.test()` | `(prompt: str, *, contains: str | None = None, matches: str | None = None, equals: str | None = None) -> Self` | Run a smoke test. Calls .ask() internally, asserts output matches condition. |

## Introspection

| Method | Signature | Description |
|---|---|---|
| `.to_ir()` | `() -> Any` | Convert this Agent builder to an AgentNode IR node. |

## Other

| Method | Signature | Description |
|---|---|---|
| `.after_agent_callback()` | `(value: CodeConfig) -> Self` | Append to ``after_agent_callbacks`` (lazy — built at .build() time). |
| `.after_model_callback()` | `(value: CodeConfig) -> Self` | Append to ``after_model_callbacks`` (lazy — built at .build() time). |
| `.after_tool_callback()` | `(value: CodeConfig) -> Self` | Append to ``after_tool_callbacks`` (lazy — built at .build() time). |
| `.arg()` | `(value: ArgumentConfig) -> Self` | Append to ``args`` (lazy — built at .build() time). |
| `.before_agent_callback()` | `(value: CodeConfig) -> Self` | Append to ``before_agent_callbacks`` (lazy — built at .build() time). |
| `.before_model_callback()` | `(value: CodeConfig) -> Self` | Append to ``before_model_callbacks`` (lazy — built at .build() time). |
| `.before_tool_callback()` | `(value: CodeConfig) -> Self` | Append to ``before_tool_callbacks`` (lazy — built at .build() time). |
| `.branch()` | `(value: BaseAgent) -> Self` | Append to ``sub_agents`` (lazy — built at .build() time). |
| `.code_block_delimiter()` | `(value: tuple[str, str]) -> Self` | Append to ``code_block_delimiters`` (lazy — built at .build() time). |
| `.injection_config()` | `(value: InjectionConfig) -> Self` | Append to ``injection_configs`` (lazy — built at .build() time). |
| `.plugin()` | `(value: BasePlugin) -> Self` | Append to ``plugins`` (lazy — built at .build() time). |
| `.publish()` | `(*, port: int = 8000, host: str = '0.0.0.0') -> Any` | Publish this agent as an A2A server (returns Starlette app). Shorthand for ``A2A |
| `.skill()` | `(skill_id: str, name: str, *, description: str = '', tags: list[str] | None = None, examples: list[str] | None = None, input_modes: list[str] | None = None, output_modes: list[str] | None = None) -> Self` | Declare an A2A skill for this agent's AgentCard. Skills are metadata consumed by |
| `.step()` | `(value: BaseAgent) -> Self` | Append to ``sub_agents`` (lazy — built at .build() time). |
| `.sub_agent()` | `(value: BaseAgent) -> Self` | Append to ``sub_agents`` (lazy — built at .build() time). |
| `.tool_simulation_config()` | `(value: ToolSimulationConfig) -> Self` | Append to ``tool_simulation_configs`` (lazy — built at .build() time). |
| `.ui()` | `(spec: Any) -> Self` | Attach A2UI surface for rich UI output. Declarative: .ui(UI.form(...)). LLM-guid |
