@namzu/sdk 27.0.0 → 28.0.0

package/README.md

@@ -1,13 +1,32 @@
-# Namzu — An Operating System for AI Agents
-
-**A dependency-free, fully controllable kernel that runs, isolates, schedules, remembers, and coordinates AI agents.** Your UI, chat interface, voice surface, CLI, or automation pipeline sits on top of a stable kernel instead of reinventing the hard parts: sandbox isolation, process lifecycle, signals, checkpoints, memory, protocol interop, and audit.
-
-[![npm](https://img.shields.io/npm/v/@namzu/sdk?color=blue)](https://www.npmjs.com/package/@namzu/sdk)
+<!-- okf
+type: Reference
+title: "@namzu/sdk"
+description: >-
+  The Namzu kernel. Runs an agent the way an operating system runs a process:
+  an identity, a budget, a permission boundary, a sandbox, checkpoints and a
+  durable record. Renders no UI, picks no database, favours no model vendor.
+tags: [readme, package, sdk, kernel, typescript]
+timestamp: 2026-08-17T00:00:00Z
+status: active
+diataxis: reference
+-->
+
+<div align="center">
+
+<h1>@namzu/sdk</h1>
+
+**The agent kernel. Everything else in this repository is built on it.**
+
+[![License: FSL-1.1-MIT](https://img.shields.io/badge/license-FSL--1.1--MIT-blue.svg)](https://github.com/cogitave/namzu/blob/main/LICENSE.md)
+[![npm](https://img.shields.io/npm/v/@namzu/sdk.svg?label=%40namzu%2Fsdk)](https://www.npmjs.com/package/@namzu/sdk)
 [![CI](https://github.com/cogitave/namzu/actions/workflows/ci.yml/badge.svg)](https://github.com/cogitave/namzu/actions/workflows/ci.yml)
-[![License](https://img.shields.io/badge/license-FSL--1.1--MIT-green)](./LICENSE.md)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
 [![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org/)
 
+[The thesis](#the-thesis) · [What it provides](#what-the-kernel-provides) · [Architecture](#architecture-in-depth--every-subsystem) · [Install](#install) · [Quick start](#quick-start)
+
+</div>
+
 ---
 
 ## The Thesis
@@ -124,7 +143,7 @@ The `SandboxProvider` abstraction (`sandbox/factory.ts`, `sandbox/provider/`) le
 
 Two layers here, with different jobs.
 
-**Bridge** is cross-process and cross-agent communication. The `bridge/a2a/` folder speaks the Agent-to-Agent protocol: your agents can publish agent cards describing their capabilities and can discover and invoke other agents' capabilities. The `bridge/mcp/` folder speaks the Model Context Protocol, both as a client (consume MCP servers as tools) and as a server (expose your Namzu tools to any MCP-speaking agent). The `bridge/sse/` folder contains the event mapper that turns in-process events into Server-Sent Events for any consumer on the other side of HTTP. `bridge/tools/` wires it all into the tool system.
+**Bridge** is cross-process and cross-agent communication. The `bridge/a2a/` folder speaks the Agent-to-Agent protocol: your agents can publish agent cards describing their capabilities and can discover and invoke other agents' capabilities. The `bridge/mcp/` folder speaks the Model Context Protocol, both as a client (consume MCP servers as tools) and as a server (expose your Namzu tools to any MCP-speaking agent). The `bridge/sse/` folder contains the event mapper that turns in-process events into Server-Sent Events for any consumer on the other side of HTTP. What a *connector* contributes to the tool system lives with the connector, under `connector/tools/`, not here — `bridge/` is protocol boundaries.
 
 **Bus** is in-process. This is where the kernel's internal nervous system lives. The bus emits typed `AgentBusEvent`s for every meaningful transition: run started, iteration begun, checkpoint created, tool call dispatched, tool result returned, agent paused, agent canceled, plan requested, plan approved, error thrown. On top of raw event fan-out, the bus offers three kernel-grade primitives:
 
@@ -150,9 +169,9 @@ When the parent is cancelled — by HITL, by a limit breach, or by an external s
 
 `manager/connector/` manages the lifecycle of external connectors (MCP servers, HTTP connectors). `manager/plan/lifecycle.ts` coordinates HITL plan review. `manager/run/persistence.ts` is the run-level persistence surface, and `manager/run/emergency.ts` is the emergency-save subsystem (see §9 below).
 
-### 4. Scheduling: Router (`router/`), Execution (`execution/`), Limit Checker (`run/LimitChecker.ts`)
+### 4. Scheduling: Router (`model-router/`), Execution (`execution/`), Limit Checker (`run/LimitChecker.ts`)
 
-The router policy (`router/task-router.ts`) decides which model a task should go to. Compaction and summarization go to cheap models; coding and complex reasoning stay on expensive ones. Tiering is user-defined — you decide which models belong in which tier and what guidance the LLM gets about preferring tier-1 tools first.
+The router policy (`model-router/task-router.ts`) decides which model a task should go to. Compaction and summarization go to cheap models; coding and complex reasoning stay on expensive ones. Tiering is user-defined — you decide which models belong in which tier and what guidance the LLM gets about preferring tier-1 tools first.
 
 The execution layer (`execution/base.ts`, `execution/local.ts`) is the concrete executor that invokes the provider, dispatches tool calls, and produces iteration results. Execution is pluggable; you could swap in a remote executor without touching the agent patterns above.
 
@@ -282,7 +301,7 @@ An LLM provider implements a narrow interface: given a typed request, return a t
 
 ### 16. Connectors (`connector/`)
 
-A connector is how an agent reaches external systems. `connector/BaseConnector.ts` is the abstract base; `connector/mcp/` implements MCP connectors in both `stdio` and `http` transports with a `client.ts` and an `adapter.ts` that turns MCP tools into Namzu `ToolDefinition`s; `connector/builtins/` ships the built-in connectors (HTTP, shell, etc.); `connector/execution/` handles connector-level execution concerns. Plugin contributions can register connectors at runtime.
+A connector is how an agent reaches external systems. `connector/BaseConnector.ts` is the abstract base; `connector/mcp/` implements MCP connectors in both `stdio` and `http` transports with a `client.ts` and an `adapter.ts` that turns MCP tools into Namzu `ToolDefinition`s; `connector/builtins/` ships the built-in connectors (HTTP, shell, etc.). WHERE a call runs is not a connector concern and does not live here: all five execution backends are in `execution/`, and a connector is one caller of one. Plugin contributions can register connectors at runtime.
 
 ### 17. Prompt Cache Integration
 
@@ -337,7 +356,8 @@ pnpm add @namzu/sdk
 
 Requirements: Node ≥ 20, TypeScript strict mode, ESM.
 
-The SDK ships the kernel only. Pick an LLM backend by adding a provider package — `@namzu/anthropic`, `@namzu/openai`, `@namzu/ollama`, `@namzu/bedrock`, `@namzu/openrouter`, `@namzu/lmstudio`, or the zero-dep `@namzu/http`. The kernel alone runs against `MockLLMProvider`, which is pre-registered and scriptable — pass `turns` to script tool calls, failures and mid-stream errors. See [Testing Agents](../../docs/sdk/runtime/testing.md).
+The SDK ships the kernel only. Pick an LLM backend by adding a provider package — `@namzu/anthropic`, `@namzu/openai`, `@namzu/ollama`, `@namzu/bedrock`, `@namzu/openrouter`, `@namzu/lmstudio`, or the zero-dep `@namzu/http`. The kernel alone runs against `MockLLMProvider`, which is pre-registered and scriptable — pass `turns` to script tool calls, failures and mid-stream errors. `MockLLMProvider` and its scripting surface are documented in the SDK's own
+type declarations.
 
 ## Quick Start
 
@@ -449,45 +469,28 @@ deserves. Closing that gap is the highest-leverage contribution today.
 
 ---
 
-## Roadmap
-
-Honest view. The kernel is already deep. The next three releases tighten the consumer surface, add the subsystems that are genuinely missing, and extend the driver model to new I/O shapes.
-
-### v0.2 — Surface Polish (short, mostly wiring + docs)
-
-- `Run.replay(runId, { fromCheckpoint })` API on top of the existing checkpoint store
-- **AEP v1 spec** — version and document the event shapes in `bridge/sse/mapper.ts`
-- Public pattern docs for lifecycle, checkpoints, emergency save, budget / quota, verification gate, context cache, file ownership, and circuit breaker
-- `ContextCache` generalized across providers (OpenRouter today → Anthropic, Bedrock next)
-
-### v0.3 — New Subsystems (the four genuinely missing pieces)
-
-- **Workflow / process-graph DSL** — typed `step / branch / parallel / loop / hitl` builder, durable on top of the existing checkpoint and lifecycle
-- **Evaluation subsystem** — `Dataset` + `Scorer` + `Experiment` primitives with a `namzu eval run` CLI, model-graded / rule-based / statistical scorers, SCD-2 versioning
-- **Content-level guardrails** — a second policy layer next to the verification gate, covering LLM I/O (PII, prompt injection, output schema, toxicity) with per-tenant and per-tool attachment
-- **Semantic cache** and **prompt compression** as opt-in additions next to the existing `ContextCache`
-
-### v0.4 — Drivers and I/O (extending the driver model)
-
-- **Voice driver** — unified STT / TTS provider abstraction, duplex streaming, real-time speech-to-speech
-- **Multimodal tool I/O** — MIME-typed binary handles for image, audio, and video inputs and outputs
-- **Computer-use driver** — reference implementation with its own sandbox profile
-- **Deterministic provider replay** — cassette pattern for eval and CI, separate from run-level checkpoints
+## Where this is going
 
-### Explicitly out of scope (community or separate packages)
+The kernel is deep and the surface is deliberately small. What moves next is
+the surface: fewer names, better names, and a deprecation window on every one
+that changes.
 
-- `@namzu/react`, `@namzu/svelte`, `@namzu/vue` chat hooks
-- Next.js / Hono / Cloudflare Workers adapters
-- A dev studio playground (would consume AEP, lives in its own repo)
-- A visual observability dashboard in the style of VoltOps or LangSmith
+This section used to carry a version-numbered roadmap. It was written at 0.x
+and the package is well past it — several of its items shipped under different
+names, one of them (`ContextCache`) is now deprecated, and a plan a reader
+cannot trust is worse than no plan. The changelog is the record of what
+actually landed; the repository's issues are where what is next gets argued.
 
-These are valuable — they belong on top of the kernel, not in it. Keeping the kernel's interface surface small is why the kernel can move fast.
+Explicitly out of scope, and staying that way: framework chat hooks, hosting
+adapters, a studio playground, a dashboard. They belong on top of a kernel with
+a small stable interface, which is the only reason that interface can stay
+small.
 
 ---
 
 ## License and Vision
 
-[FSL-1.1-MIT](./LICENSE.md). Every version becomes fully MIT two years after release.
+[FSL-1.1-MIT](https://github.com/cogitave/namzu/blob/main/LICENSE.md). Every version becomes fully MIT two years after release.
 
 The vision: an open, community-driven agent kernel that reduces systemic dependencies on proprietary platforms — so everyone can build, own, and run AI agents freely. Namzu works with any LLM provider through BYOK, runs in isolation without container orchestration, and surfaces a stable protocol so the application layer stays yours.
 

package/dist/advisory/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/advisory/executor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,KAAK,OAAO,EAA0C,MAAM,2BAA2B,CAAA;AAChG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAgB/D,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;IAC5B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEvC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IAKpD;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAOtB,OAAO,CACZ,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,uBAAuB,CAAC;IAkDnC,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,YAAY;IA6CpB,OAAO,CAAC,gBAAgB;IAqBxB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAW;CAOnB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/advisory/executor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,KAAK,OAAO,EAA0C,MAAM,2BAA2B,CAAA;AAChG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAgB/D,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;IAC5B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEvC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IAKpD;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAOtB,OAAO,CACZ,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,uBAAuB,CAAC;IAkDnC,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,YAAY;IA6CpB,OAAO,CAAC,gBAAgB;IAqBxB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAW;CAOnB"}

package/dist/advisory/executor.js

@@ -1,10 +1,12 @@
 import { CHARS_PER_TOKEN, ZERO_COST } from '../constants/limits.js';
 import { assembleSystemPrompt } from '../persona/assembler.js';
 import { resolveModelPricing } from '../pricing/index.js';
-import { collect } from '../provider/collect.js';
+import { collectChatCompletion } from '../provider/collect-chat-completion.js';
+import { SCOPE_ATTRIBUTE } from '../utils/log/types.js';
+import { GENAI } from '../constants/telemetry/index.js';
 import { createSystemMessage, createUserMessage } from '../types/message/index.js';
 import { accumulateUnpricedCost, calculateCost } from '../utils/cost.js';
-import { getRootLogger } from '../utils/logger.js';
+import { resolveLogger } from '../utils/logger.js';
 import { ADVISORY_RESPONSE_CONTRACT, parseAdvisoryResponse } from './parse.js';
 /**
  * What the advisor is told about how urgent the caller said this is.
@@ -22,7 +24,7 @@ export class AdvisoryExecutor {
     logger;
     budget;
     constructor(logger, budget) {
-        this.logger = (logger ?? getRootLogger()).child({ component: 'AdvisoryExecutor' });
+        this.logger = resolveLogger(logger).child({ [SCOPE_ATTRIBUTE]: 'advisory/executor' });
         this.budget = budget;
     }
     /**
@@ -48,12 +50,12 @@ export class AdvisoryExecutor {
             createUserMessage(request.question),
         ];
         this.logger.debug('advisory call starting', {
-            advisorId: advisor.id,
-            model: advisor.model,
-            messageCount: messages.length,
-            urgency: request.urgency,
+            'namzu.advisory.id': advisor.id,
+            [GENAI.REQUEST_MODEL]: advisor.model,
+            'namzu.advisory.message_count': messages.length,
+            'namzu.advisory.urgency': request.urgency,
         });
-        const response = await collect(advisor.provider.chatStream({
+        const response = await collectChatCompletion(advisor.provider.chatStream({
             model: advisor.model,
             messages,
             temperature: advisor.temperature,
@@ -64,10 +66,10 @@ export class AdvisoryExecutor {
         const result = parseAdvisoryResponse(response.message.content ?? '');
         const cost = this.computeCost(advisor, response.usage);
         this.logger.info('advisory call completed', {
-            advisorId: advisor.id,
-            model: advisor.model,
-            durationMs,
-            totalTokens: response.usage.totalTokens,
+            'namzu.advisory.id': advisor.id,
+            [GENAI.REQUEST_MODEL]: advisor.model,
+            'namzu.duration_ms': durationMs,
+            'namzu.usage.total_tokens': response.usage.totalTokens,
         });
         return {
             result,

package/dist/advisory/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/advisory/executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/advisory/executor.ts"],"names":[],"mappings":"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"}

package/dist/advisory/registry.d.ts

@@ -1,6 +1,6 @@
-import { Registry } from '../registry/Registry.js';
+import { BaseRegistry } from '../registry/BaseRegistry.js';
 import type { AdvisorDefinition } from '../types/advisory/index.js';
-export declare class AdvisorRegistry extends Registry<AdvisorDefinition> {
+export declare class AdvisorRegistry extends BaseRegistry<AdvisorDefinition> {
     private readonly defaultId;
     constructor(advisors: AdvisorDefinition[], defaultId?: string);
     /**

package/dist/advisory/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/advisory/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAEnE,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,iBAAiB,CAAC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAElC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM;IAQ7D;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAmB3E,OAAO,IAAI,iBAAiB,EAAE;CAG9B"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/advisory/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAEnE,qBAAa,eAAgB,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAElC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM;IAQ7D;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAmB3E,OAAO,IAAI,iBAAiB,EAAE;CAG9B"}

package/dist/advisory/registry.js

@@ -1,5 +1,5 @@
-import { Registry } from '../registry/Registry.js';
-export class AdvisorRegistry extends Registry {
+import { BaseRegistry } from '../registry/BaseRegistry.js';
+export class AdvisorRegistry extends BaseRegistry {
     defaultId;
     constructor(advisors, defaultId) {
         super();

package/dist/advisory/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/advisory/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGlD,MAAM,OAAO,eAAgB,SAAQ,QAA2B;IAC9C,SAAS,CAAoB;IAE9C,YAAY,QAA6B,EAAE,SAAkB;QAC5D,KAAK,EAAE,CAAA;QACP,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACnC,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,SAAkB,EAAE,MAAe;QAC1C,IAAI,SAAS,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAC3B,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;YACzB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAA;YACnE,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACxB,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAChC,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QACzB,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3C,CAAC;IAED,OAAO;QACN,OAAO,IAAI,CAAC,MAAM,EAAE,CAAA;IACrB,CAAC;CACD"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/advisory/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAG1D,MAAM,OAAO,eAAgB,SAAQ,YAA+B;IAClD,SAAS,CAAoB;IAE9C,YAAY,QAA6B,EAAE,SAAkB;QAC5D,KAAK,EAAE,CAAA;QACP,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACnC,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,SAAkB,EAAE,MAAe;QAC1C,IAAI,SAAS,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAC3B,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;YACzB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAA;YACnE,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACxB,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAChC,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QACzB,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3C,CAAC;IAED,OAAO;QACN,OAAO,IAAI,CAAC,MAAM,EAAE,CAAA;IACrB,CAAC;CACD"}

package/dist/agents/AbstractAgent.d.ts

@@ -1,12 +1,21 @@
 import type { Agent, AgentCapabilities, AgentInput, AgentMetadata, AgentType, BaseAgentConfig, BaseAgentResult } from '../types/agent/index.js';
 import type { AgentManagerContract } from '../types/agent/manager.js';
 import type { RunId } from '../types/ids/index.js';
+import { type CancelCause } from '../types/run/cancel-cause.js';
 import type { RunEvent, RunEventListener } from '../types/run/index.js';
 import { type Logger } from '../utils/logger.js';
 export declare abstract class AbstractAgent<TConfig extends BaseAgentConfig = BaseAgentConfig, TResult extends BaseAgentResult = BaseAgentResult> implements Agent<TConfig, TResult> {
     abstract readonly type: AgentType;
     readonly metadata: AgentMetadata;
     protected log: Logger;
+    /**
+     * The logger bound at construction, before any run id exists. `this.log`
+     * is rebound to a CHILD of this on every `bindRun` call — never the other
+     * way — so `forRun()` (which builds a fresh shell from `this.metadata`)
+     * can hand the new instance the same base identity without also handing
+     * it a stale run id from whichever run happened to be live last.
+     */
+    private readonly baseLog;
     protected abortController: AbortController;
     private readonly invocationLock;
     /**
@@ -21,7 +30,7 @@ export declare abstract class AbstractAgent<TConfig extends BaseAgentConfig = Ba
     private readonly inflightByKey;
     protected agentManager?: AgentManagerContract;
     protected currentRunId?: RunId;
-    constructor(metadata: AgentMetadata);
+    constructor(metadata: AgentMetadata, log?: Logger);
     abstract run(input: AgentInput, config: TConfig, listener?: RunEventListener): Promise<TResult>;
     /**
      * A fresh shell of this agent, for a run that must not share one.
@@ -98,9 +107,42 @@ export declare abstract class AbstractAgent<TConfig extends BaseAgentConfig = Ba
      * somewhere durable to record the key, which is a store the host owns.
      */
     protected underIdempotencyKey<T>(key: string | undefined, body: () => Promise<T>): Promise<T>;
-    cancel(): Promise<void>;
+    /**
+     * `cause` is optional and has no default, deliberately. An operator
+     * calling this IS the `'user'` case, but a library calling it on the
+     * operator's behalf is not — and a default would attribute every
+     * unlabelled cancellation to a person who did not press anything.
+     *
+     * Children get `'parent'` regardless of what stopped this run: from a
+     * child's side, the fact is that its parent went away.
+     */
+    cancel(cause?: CancelCause): Promise<void>;
     getCapabilities(): AgentCapabilities;
     protected createRunId(): RunId;
+    /**
+     * Rebind this instance's logger to a specific run, so every record
+     * `this.log` writes for the DURATION of that run carries `namzu.run.id` —
+     * and every record after the NEXT call carries that run's id, not this
+     * one.
+     *
+     * Constructor-time binding was the bug this exists to fix: an agent
+     * constructed once and invoked twice (`forRun` aside — a host is free to
+     * reuse one instance across sequential runs, and every concrete `run()`
+     * takes fresh `input`/`config` precisely to allow it) held ONE logger for
+     * its whole lifetime, so a warning from run two carried run one's id, or
+     * none. Every concrete `run()` implementation calls this before touching
+     * `this.log`, right after resolving the run's id — see `RouterAgent`,
+     * `PipelineAgent`, `SupervisorAgent` and `ReactiveAgent`.
+     *
+     * `log` lets a per-run override (`BaseAgentConfig.logger`, a host setting
+     * on ONE call to `.run()`) win over the agent's construction-time base,
+     * without reconstructing the agent to get it.
+     *
+     * Also the one place `currentRunId` is actually assigned. It was declared
+     * and read by `cancel()` but never written — a run could never be
+     * cancelled by id because nothing ever recorded which run was current.
+     */
+    protected bindRun(runId: RunId, log?: Logger): void;
     protected createEmptyResult(runId: RunId, startTime: number): BaseAgentResult;
     protected emitEvent(event: RunEvent, listener?: RunEventListener): Promise<void>;
 }

package/dist/agents/AbstractAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractAgent.d.ts","sourceRoot":"","sources":["../../src/agents/AbstractAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,KAAK,EACL,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAIvE,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAG/D,8BAAsB,aAAa,CAClC,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe,CAChD,YAAW,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;IAEnC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,eAAe,EAAE,eAAe,CAAA;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAE/C;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;IAEpE,SAAS,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAA;IAE7C,SAAS,CAAC,YAAY,CAAC,EAAE,KAAK,CAAA;gBAElB,QAAQ,EAAE,aAAa;IAUnC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAE/F;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,IAAI,IAAI;IAgBd;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,qBAAqB;IAI/B;;;;;;;;;;;;;;;;OAgBG;cACa,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS1E;;;;;;;;;;;;;;;;;;OAkBG;cACa,mBAAmB,CAAC,CAAC,EACpC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC;IAuBP,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B,eAAe,IAAI,iBAAiB;IAIpC,SAAS,CAAC,WAAW,IAAI,KAAK;IAI9B,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe;cAY7D,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAUtF"}
+{"version":3,"file":"AbstractAgent.d.ts","sourceRoot":"","sources":["../../src/agents/AbstractAgent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,KAAK,EACL,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,8BAA8B,CAAA;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAKvE,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAG/D,8BAAsB,aAAa,CAClC,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe,CAChD,YAAW,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;IAEnC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,SAAS,CAAC,eAAe,EAAE,eAAe,CAAA;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAE/C;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;IAEpE,SAAS,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAA;IAE7C,SAAS,CAAC,YAAY,CAAC,EAAE,KAAK,CAAA;gBAElB,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,MAAM;IAYjD,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAE/F;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,IAAI,IAAI;IAmBd;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,qBAAqB;IAI/B;;;;;;;;;;;;;;;;OAgBG;cACa,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS1E;;;;;;;;;;;;;;;;;;OAkBG;cACa,mBAAmB,CAAC,CAAC,EACpC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC;IAuBb;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD,eAAe,IAAI,iBAAiB;IAIpC,SAAS,CAAC,WAAW,IAAI,KAAK;IAI9B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAKnD,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe;cAY7D,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAUtF"}

package/dist/agents/AbstractAgent.js

@@ -1,12 +1,23 @@
 import { EMPTY_TOKEN_USAGE } from '../constants/limits.js';
+import { GENAI, NAMZU } from '../constants/telemetry/index.js';
+import { RunCancelled } from '../types/run/cancel-cause.js';
 import { ZERO_COST } from '../utils/cost.js';
 import { toErrorMessage } from '../utils/error.js';
 import { generateRunId } from '../utils/id.js';
-import { getRootLogger } from '../utils/logger.js';
+import { SCOPE_ATTRIBUTE } from '../utils/log/types.js';
+import { resolveLogger } from '../utils/logger.js';
 import { InvocationLock } from './lock.js';
 export class AbstractAgent {
     metadata;
     log;
+    /**
+     * The logger bound at construction, before any run id exists. `this.log`
+     * is rebound to a CHILD of this on every `bindRun` call — never the other
+     * way — so `forRun()` (which builds a fresh shell from `this.metadata`)
+     * can hand the new instance the same base identity without also handing
+     * it a stale run id from whichever run happened to be live last.
+     */
+    baseLog;
     abortController;
     invocationLock;
     /**
@@ -21,14 +32,16 @@ export class AbstractAgent {
     inflightByKey = new Map();
     agentManager;
     currentRunId;
-    constructor(metadata) {
+    constructor(metadata, log) {
         this.metadata = metadata;
         this.abortController = new AbortController();
         this.invocationLock = new InvocationLock();
-        this.log = getRootLogger().child({
-            component: `Agent:${metadata.type}`,
-            agentId: metadata.id,
+        this.baseLog = resolveLogger(log).child({
+            [SCOPE_ATTRIBUTE]: 'agents',
+            [NAMZU.AGENT_TYPE]: metadata.type,
+            [GENAI.AGENT_ID]: metadata.id,
         });
+        this.log = this.baseLog;
     }
     /**
      * A fresh shell of this agent, for a run that must not share one.
@@ -52,12 +65,12 @@ export class AbstractAgent {
     forRun() {
         try {
             const Ctor = this.constructor;
-            return new Ctor(this.metadata);
+            return new Ctor(this.metadata, this.baseLog);
         }
         catch (err) {
             this.log.warn('Could not build a per-run shell; concurrent runs of this agent will still be refused', {
-                agentId: this.metadata.id,
-                error: err instanceof Error ? err.message : String(err),
+                [GENAI.AGENT_ID]: this.metadata.id,
+                'exception.message': err instanceof Error ? err.message : String(err),
             });
             return this;
         }
@@ -132,8 +145,8 @@ export class AbstractAgent {
         const inflight = this.inflightByKey.get(key);
         if (inflight) {
             this.log.info('Joining an invocation already running under this key', {
-                agentId: this.metadata.id,
-                idempotencyKey: key,
+                [GENAI.AGENT_ID]: this.metadata.id,
+                'namzu.agents.idempotency_key': key,
             });
             return inflight;
         }
@@ -148,8 +161,17 @@ export class AbstractAgent {
             this.inflightByKey.delete(key);
         }
     }
-    async cancel() {
-        this.abortController.abort();
+    /**
+     * `cause` is optional and has no default, deliberately. An operator
+     * calling this IS the `'user'` case, but a library calling it on the
+     * operator's behalf is not — and a default would attribute every
+     * unlabelled cancellation to a person who did not press anything.
+     *
+     * Children get `'parent'` regardless of what stopped this run: from a
+     * child's side, the fact is that its parent went away.
+     */
+    async cancel(cause) {
+        this.abortController.abort(cause ? new RunCancelled(cause) : undefined);
         if (this.agentManager && this.currentRunId) {
             this.agentManager.cancelAll(this.currentRunId);
         }
@@ -160,6 +182,33 @@ export class AbstractAgent {
     createRunId() {
         return generateRunId();
     }
+    /**
+     * Rebind this instance's logger to a specific run, so every record
+     * `this.log` writes for the DURATION of that run carries `namzu.run.id` —
+     * and every record after the NEXT call carries that run's id, not this
+     * one.
+     *
+     * Constructor-time binding was the bug this exists to fix: an agent
+     * constructed once and invoked twice (`forRun` aside — a host is free to
+     * reuse one instance across sequential runs, and every concrete `run()`
+     * takes fresh `input`/`config` precisely to allow it) held ONE logger for
+     * its whole lifetime, so a warning from run two carried run one's id, or
+     * none. Every concrete `run()` implementation calls this before touching
+     * `this.log`, right after resolving the run's id — see `RouterAgent`,
+     * `PipelineAgent`, `SupervisorAgent` and `ReactiveAgent`.
+     *
+     * `log` lets a per-run override (`BaseAgentConfig.logger`, a host setting
+     * on ONE call to `.run()`) win over the agent's construction-time base,
+     * without reconstructing the agent to get it.
+     *
+     * Also the one place `currentRunId` is actually assigned. It was declared
+     * and read by `cancel()` but never written — a run could never be
+     * cancelled by id because nothing ever recorded which run was current.
+     */
+    bindRun(runId, log) {
+        this.currentRunId = runId;
+        this.log = (log ?? this.baseLog).child({ [NAMZU.RUN_ID]: runId });
+    }
     createEmptyResult(runId, startTime) {
         return {
             runId,
@@ -179,7 +228,7 @@ export class AbstractAgent {
         }
         catch (err) {
             this.log.error('Event listener error', {
-                error: toErrorMessage(err),
+                'exception.message': toErrorMessage(err),
             });
         }
     }

package/dist/agents/AbstractAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractAgent.js","sourceRoot":"","sources":["../../src/agents/AbstractAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AbstractAgent.js","sourceRoot":"","sources":["../../src/agents/AbstractAgent.ts"],"names":[],"mappings":"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"}

package/dist/agents/PipelineAgent.d.ts

@@ -1,9 +1,37 @@
+/**
+ * A developer-authored step list, and deliberately not a model-authored
+ * one.
+ *
+ * This distinction has been attributed to a `packages/sdk/src/agents/
+ * AGENTS.md` that does not exist, so it is written here instead. The
+ * proposal it answers is a model that emits an orchestration SCRIPT --
+ * `agent()`, `parallel()`, `pipeline()` as globals -- executed in an
+ * isolate, so that control flow between steps costs no model turns.
+ *
+ * The saving is real and this class already realises most of it: the steps
+ * below run with zero model turns between them, and `SupervisorAgent`
+ * delegates without one. What a script would add is orchestration a
+ * developer did not anticipate, invented at runtime -- which is also the
+ * case where a wrong one is hardest to review before it runs.
+ *
+ * The blocking question is the trust boundary, not the value. `bash` from
+ * a model is mediated by `packages/sandbox` because code from a model is
+ * untrusted; a model-authored script is the same input through another
+ * door, and a strictly more powerful one, since it can call back into the
+ * agent surface. Running it in-process would leave the kernel's one clear
+ * confinement boundary covering the weaker case and not the stronger. So
+ * an isolate is mandatory rather than an optimisation, and the capability
+ * costs a second execution surface to secure, audit and version.
+ *
+ * That is the bar a reopen has to clear.
+ */
 import type { AgentInput, AgentMetadata, PipelineAgentConfig, PipelineAgentResult } from '../types/agent/index.js';
 import type { RunEventListener } from '../types/run/index.js';
+import type { Logger } from '../utils/logger.js';
 import { AbstractAgent } from './AbstractAgent.js';
 export declare class PipelineAgent extends AbstractAgent<PipelineAgentConfig, PipelineAgentResult> {
     readonly type: "pipeline";
-    constructor(metadata: Omit<AgentMetadata, 'type' | 'capabilities'>);
+    constructor(metadata: Omit<AgentMetadata, 'type' | 'capabilities'>, log?: Logger);
     /**
      * One run at a time per instance.
      *

package/dist/agents/PipelineAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PipelineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/PipelineAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EAGnB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,qBAAa,aAAc,SAAQ,aAAa,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;gBAEvB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC;IAalE;;;;;;;;OAQG;IACG,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,mBAAmB,CAAC;YAMjB,YAAY;CAiI1B"}
+{"version":3,"file":"PipelineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/PipelineAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EAGnB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,qBAAa,aAAc,SAAQ,aAAa,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;gBAEvB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAgBhF;;;;;;;;OAQG;IACG,GAAG,CACR,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,mBAAmB,CAAC;YAMjB,YAAY;CAmI1B"}

package/dist/agents/PipelineAgent.js

@@ -1,10 +1,37 @@
+/**
+ * A developer-authored step list, and deliberately not a model-authored
+ * one.
+ *
+ * This distinction has been attributed to a `packages/sdk/src/agents/
+ * AGENTS.md` that does not exist, so it is written here instead. The
+ * proposal it answers is a model that emits an orchestration SCRIPT --
+ * `agent()`, `parallel()`, `pipeline()` as globals -- executed in an
+ * isolate, so that control flow between steps costs no model turns.
+ *
+ * The saving is real and this class already realises most of it: the steps
+ * below run with zero model turns between them, and `SupervisorAgent`
+ * delegates without one. What a script would add is orchestration a
+ * developer did not anticipate, invented at runtime -- which is also the
+ * case where a wrong one is hardest to review before it runs.
+ *
+ * The blocking question is the trust boundary, not the value. `bash` from
+ * a model is mediated by `packages/sandbox` because code from a model is
+ * untrusted; a model-authored script is the same input through another
+ * door, and a strictly more powerful one, since it can call back into the
+ * agent surface. Running it in-process would leave the kernel's one clear
+ * confinement boundary covering the weaker case and not the stronger. So
+ * an isolate is mandatory rather than an optimisation, and the capability
+ * costs a second execution surface to secure, audit and version.
+ *
+ * That is the bar a reopen has to clear.
+ */
 import { EMPTY_TOKEN_USAGE } from '../constants/limits.js';
 import { ZERO_COST } from '../utils/cost.js';
 import { toErrorMessage } from '../utils/error.js';
 import { AbstractAgent } from './AbstractAgent.js';
 export class PipelineAgent extends AbstractAgent {
     type = 'pipeline';
-    constructor(metadata) {
+    constructor(metadata, log) {
         super({
             ...metadata,
             type: 'pipeline',
@@ -14,7 +41,7 @@ export class PipelineAgent extends AbstractAgent {
                 supportsConcurrency: false,
                 supportsSubAgents: false,
             },
-        });
+        }, log);
     }
     /**
      * One run at a time per instance.
@@ -31,6 +58,7 @@ export class PipelineAgent extends AbstractAgent {
     async runExclusive(input, config, listener) {
         const startTime = Date.now();
         const runId = this.createRunId();
+        this.bindRun(runId, config.logger);
         const stepResults = [];
         const previousResults = new Map();
         let completedSteps = 0;
@@ -91,8 +119,9 @@ export class PipelineAgent extends AbstractAgent {
                         await step.rollback(currentInput, context);
                     }
                     catch (rollbackErr) {
-                        this.log.error(`Rollback failed for step "${step.name}"`, {
-                            error: toErrorMessage(rollbackErr),
+                        this.log.error('Rollback failed for a step', {
+                            'namzu.pipeline.step_name': step.name,
+                            'exception.message': toErrorMessage(rollbackErr),
                         });
                     }
                 }