@namzu/sdk 46.0.0 → 48.0.0

package/dist/agents/SupervisorAgent.js

@@ -1,419 +1,4 @@
-import { EMPTY_TOKEN_USAGE } from '../constants/limits.js';
-import { ToolNameCollisionError, ToolRegistry } from '../registry/tool/execute.js';
-import { drainQuery } from '../runtime/query/index.js';
-import { PendingAnswers, QuestionParkBinding } from '../runtime/query/question-park.js';
-import { CompletionInbox } from '../scheduler/completion-inbox.js';
-import { LocalTaskScheduler } from '../scheduler/local.js';
-import { ASK_USER_QUESTION_TOOL_NAME, buildCoordinatorTools } from '../tools/coordinator/index.js';
-import { deriveChildState } from '../types/invocation/index.js';
-import { ZERO_COST } from '../utils/cost.js';
-import { AbstractAgent } from './AbstractAgent.js';
-import { resolveAgentBudget } from './budget.js';
-import { childSessionStorage } from './storage.js';
-/**
- * Build the authoritative per-task ledger from the gateway's task handles.
- *
- * A handle carries a `result` only when its worker actually produced one. A
- * handle with NO result never produced a verifiable outcome, so it MUST NOT be
- * synthesized as a success: the synthesized status is always the terminal
- * `'failed'`, regardless of the handle's reported `state` (which may itself be
- * `'completed'`).
- *
- * The earlier implementation cast `handle.state` onto the synthesized result's
- * status, letting a worker that ended without a result count toward
- * `completedTasks`. That produced fabricated "done" workers with empty outputs
- * (observed in a live supervised session): the supervisor reported "3 workers done, 40KB
- * reports" when the workers never started. Real workers (those with a present
- * `result`) are unaffected — their `result` is preserved verbatim.
- */
-export function synthesizeTaskResults(taskHandles, turn, now = Date.now()) {
-    return taskHandles.map((handle, index) => ({
-        agentId: handle.agentId,
-        result: handle.result ?? {
-            sessionId: turn.sessionId,
-            turnId: turn.turnId,
-            status: 'failed',
-            usage: { ...EMPTY_TOKEN_USAGE },
-            cost: { ...ZERO_COST },
-            iterations: 0,
-            durationMs: now - handle.createdAt,
-            messages: [],
-        },
-        taskIndex: index,
-    }));
-}
-/** Count only the task results that genuinely completed. */
-export function countCompletedTasks(taskResults) {
-    return taskResults.filter((t) => t.result.status === 'completed').length;
-}
-export class SupervisorAgent extends AbstractAgent {
-    type = 'supervisor';
-    constructor(metadata, log) {
-        super({
-            ...metadata,
-            type: 'supervisor',
-            capabilities: {
-                supportsTools: true,
-                supportsStreaming: true,
-                supportsConcurrency: true,
-                supportsSubAgents: true,
-            },
-        }, log);
-    }
-    /**
-     * One turn at a time per instance.
-     *
-     * `abortController` and `currentSessionId` are instance state, so two
-     * overlapping turns share one abort controller — cancelling either kills
-     * both — and the second clobbers the first's session, so a later
-     * `cancel()` cancels the wrong children. Neither failure announces itself.
-     * A host that wants parallelism constructs a second instance.
-     */
-    async run(input, config, listener) {
-        return await this.underIdempotencyKey(config.idempotencyKey, () => this.underInvocationLock(() => this.runExclusive(input, config, listener)));
-    }
-    async runExclusive(input, config, listener) {
-        const startTime = Date.now();
-        if (!config.sessionId || !config.topicId || !config.projectId || !config.tenantId) {
-            throw new Error('SupervisorAgent requires sessionId, topicId, projectId, and tenantId in config (session-hierarchy.md §12.1).');
-        }
-        const sessionId = config.sessionId;
-        const turnId = this.createTurnId();
-        this.bindTurn(sessionId, turnId, config.logger);
-        const topicId = config.topicId;
-        const projectId = config.projectId;
-        const tenantId = config.tenantId;
-        const parentActor = {
-            kind: 'agent',
-            agentId: this.metadata.id,
-            tenantId,
-        };
-        // One resolve for the two spellings. Read at each of the three sites
-        // instead, a host that set only `scheduler` would get a working one
-        // on one path and `undefined` on another — a half-migration that
-        // fails silently, which is worse than not renaming the field.
-        const configuredScheduler = config.scheduler;
-        const budget = await resolveAgentBudget(input, { ...config, budget: config.budget ?? configuredScheduler?.budget }, { sessionId, turnId });
-        if (configuredScheduler && configuredScheduler.budget !== budget) {
-            throw new Error('Injected task scheduler must share the supervisor token budget authority');
-        }
-        const childStorage = await childSessionStorage(config, input.workingDirectory);
-        let gateway;
-        if (configuredScheduler) {
-            gateway = configuredScheduler;
-        }
-        else if (config.agentManager) {
-            const mergedFactoryOptions = config.factoryOptions
-                ? {
-                    ...config.factoryOptions,
-                    taskRouter: config.taskRouter ?? config.factoryOptions.taskRouter,
-                }
-                : config.taskRouter
-                    ? {
-                        taskRouter: config.taskRouter,
-                    }
-                    : undefined;
-            const taskContext = {
-                parentSessionId: sessionId,
-                parentTurnId: turnId,
-                parentAgentId: this.metadata.id,
-                parentAbortController: this.abortController,
-                // This context describes the CURRENT supervisor. AgentManager owns
-                // the increment when it constructs the child. Resetting a delegated
-                // supervisor to zero here made every grandchild depth one again.
-                depth: config.depth ?? 0,
-                budget,
-                factoryOptions: mergedFactoryOptions,
-                // The supervisor already hands this to its OWN turn. Handing it to
-                // the spawn context makes a worker's REVIEW-tier calls reach the
-                // same person. It does not grant the root-only question tool.
-                // Without the handler, workers silently auto-approved themselves.
-                ...(config.resumeHandler ? { resumeHandler: config.resumeHandler } : {}),
-                // And the switch that sends batches the handler would otherwise
-                // never see to it (plan mode), so a worker's rule-allowed or
-                // grant-covered call is refused where the supervisor's would be.
-                ...(config.reviewAllowedCalls ? { reviewAllowedCalls: config.reviewAllowedCalls } : {}),
-                // Handed down for the same reason: a worker is a fresh turn whose
-                // executor installs the shipped screens unless the spawn says
-                // otherwise, so the supervisor's own choice — including an
-                // empty list, which `config.toolResultGuardrails` distinguishes
-                // from absent by being an array at all.
-                ...(config.toolResultGuardrails
-                    ? { toolResultGuardrails: config.toolResultGuardrails }
-                    : {}),
-                tenantId,
-                topicId,
-                sessionId,
-                projectId,
-                parentActor,
-                // A supervisor held in memory delegates to workers held in
-                // memory; without this each worker wrote a disk log under
-                // `NAMZU_HOME` its supervisor never asked for.
-                ...(childStorage ? { childStorage } : {}),
-            };
-            // The only hop between the config and the gateway's policy. Omit it
-            // and the field is settable, documented, and read by nothing —
-            // which is exactly the state it was in before.
-            gateway = new LocalTaskScheduler(config.agentManager, taskContext, listener, input, {
-                ...(config.siblingFailurePolicy
-                    ? { siblingFailurePolicy: config.siblingFailurePolicy }
-                    : {}),
-                log: this.log,
-            });
-        }
-        else {
-            // Names `scheduler`, not `gateway`. An error message is a piece of
-            // documentation delivered at the worst moment, and one that names
-            // a field being retired teaches the name on its way out.
-            throw new Error("SupervisorAgentConfig requires either 'scheduler' or 'agentManager'");
-        }
-        let planManagerRef;
-        // Created here because the TOOLS are created here: the durability
-        // channel has to reach the tool instance, and the turn that supplies
-        // it does not exist yet. `query` binds them once it does.
-        const questionParks = new QuestionParkBinding();
-        const pendingAnswers = new PendingAnswers();
-        // Created here for the same reason: both ends are here. The tools claim
-        // a completion when they deliver it as a `tool_result`, and the loop
-        // drains whatever is left over into the transcript — so the inbox has
-        // to be the same object on both sides, and this is the only place that
-        // sees both.
-        //
-        // It attaches through `onTaskCompleted`, which every gateway already
-        // implements, so a host gateway needs no change to take part.
-        const completionInbox = new CompletionInbox(this.log);
-        completionInbox.attach(gateway);
-        // From here to the return in a try/finally, so the listener is released
-        // on every way out. The registration loop below can throw
-        // ToolNameCollisionError, and a host that hits that fixes its config and
-        // runs again — which is how a leak of one listener per turn becomes a leak
-        // of one per ATTEMPT.
-        try {
-            const isRootAgent = (config.depth ?? 0) === 0;
-            const coordinatorToolDefs = buildCoordinatorTools({
-                gateway,
-                completionInbox,
-                workingDirectory: input.workingDirectory,
-                runtimeContext: input.runtimeContext,
-                allowedAgentIds: config.agentIds,
-                // The only hop between the config and the decision. Omit it and
-                // everything still compiles: the field is settable, documented, and
-                // read by nothing — which is the shape of a declaration this repo
-                // has had to go and delete before.
-                allowDelegation: config.allowDelegation,
-                taskStore: input.taskStore,
-                sessionId,
-                turnId,
-                getPlanManager: () => planManagerRef,
-                // A human-question tool belongs only to the root agent. The handler
-                // itself still reaches `drainQuery` below: delegated REVIEW-tier
-                // tool calls must keep asking the operator instead of falling back
-                // to unattended auto-approval.
-                ...(isRootAgent && config.resumeHandler ? { resumeHandler: config.resumeHandler } : {}),
-                questionParks,
-                pendingAnswers,
-                ...(config.onPlanApproved ? { onPlanApproved: config.onPlanApproved } : {}),
-            });
-            const tools = new ToolRegistry();
-            if (config.tools) {
-                for (const tool of config.tools.getAll()) {
-                    // The boundary is semantic, not an implementation detail of the
-                    // built-in builder. A host registry containing the same capability
-                    // must not reopen it for a delegated agent.
-                    if (!isRootAgent && tool.name === ASK_USER_QUESTION_TOOL_NAME)
-                        continue;
-                    tools.register(tool, config.tools.getAvailability(tool.name));
-                }
-            }
-            // Registered the way every other kernel-mounted tool in this SDK is
-            // registered: honouring `runtimeToolOverrides`, and refusing to take a
-            // name the host already used.
-            //
-            // Both halves were missing here and nowhere else. `runtimeToolOverrides`
-            // is declared on `AgentInput`, is forwarded into this very `drainQuery`
-            // call below, and is consulted for the task tools and for the advisory
-            // tools — but the coordinator tools were registered before that and
-            // unconditionally, so `{ create_task: 'disabled' }` was honoured
-            // everywhere except the one surface a host would most want to decline.
-            // A turn that must not delegate had prompt text and a gateway refusal as
-            // its only defences.
-            //
-            // Collision REFUSES rather than overwrites, and the principle is
-            // complete mediation rather than fail-safe defaults: "proposals to gain
-            // performance by remembering the result of an authority check [must] be
-            // examined skeptically. If a change in authority occurs, such remembered
-            // results must be systematically updated" (Saltzer & Schroeder 1975,
-            // §I.A.3(c)). A registry entry is a remembered binding of a name to an
-            // authority, and a later write that rebinds the name leaves every
-            // decision made about the old binding stale.
-            //
-            // The counter-argument is that today the host's tool merely loses
-            // quietly and the turn still works, so six reserved names is a real cost
-            // on a name a consumer may have chosen long ago. It does not hold,
-            // because "loses quietly" is not what happens. `registerOne` ends with
-            // `availability.set(id, state)` and this call passes no state, so a tool
-            // the host registered `deferred` or `suspended` is silently PROMOTED to
-            // active under someone else's implementation; and because the store is a
-            // Map, the replacement inherits the host's insertion position in the
-            // prompt-cache prefix. That is a different authorization surface, not a
-            // lost registration. CWE-390 is the shape `ManagedRegistry` has here —
-            // detection of an error condition without action — and CWE-694's own
-            // mitigation is nearly this fix: do not operate any resource with a
-            // non-unique identifier, and report the error.
-            //
-            // Refusing is also what the peer set does. One runtime's registry
-            // primitive throws on both duplicate and reserved names; another refuses
-            // its injected delegation name in a pre-flight that tells the author to
-            // rename. Closer to home, `ProviderRegistry.register` already throws
-            // unless the caller passes `{ replace: true }` — declared intent is what
-            // separates a legitimate replacement from an accidental one, and no such
-            // intent is expressible here.
-            const overrides = input.runtimeToolOverrides;
-            for (const tool of coordinatorToolDefs) {
-                const override = overrides?.[tool.name];
-                if (override === 'disabled')
-                    continue;
-                if (config.tools?.has(tool.name)) {
-                    throw new ToolNameCollisionError(tool.name, 'the supervisor coordinator surface');
-                }
-                tools.register(tool, override ?? 'active');
-            }
-            const childInvocationState = deriveChildState(config.invocationState ?? { tenantId }, this.metadata.id);
-            const turn = await drainQuery({
-                systemPrompt: config.systemPrompt,
-                skills: config.skills,
-                provider: config.provider,
-                tools,
-                ...(config.toolResultGuardrails !== undefined
-                    ? { toolResultGuardrails: config.toolResultGuardrails }
-                    : {}),
-                ...(input.attachmentStore ? { attachmentStore: input.attachmentStore } : {}),
-                ...(config.attachmentResolveTimeoutMs !== undefined
-                    ? { attachmentResolveTimeoutMs: config.attachmentResolveTimeoutMs }
-                    : {}),
-                turnConfig: {
-                    model: config.model,
-                    tokenBudget: config.tokenBudget,
-                    timeoutMs: config.timeoutMs,
-                    ...(config.sandbox ? { sandbox: config.sandbox } : {}),
-                    ...(config.streamIdleTimeoutMs !== undefined
-                        ? { streamIdleTimeoutMs: config.streamIdleTimeoutMs }
-                        : {}),
-                    ...(config.maxRequestRichContentBytes !== undefined
-                        ? {
-                            maxRequestRichContentBytes: config.maxRequestRichContentBytes,
-                        }
-                        : {}),
-                    maxIterations: config.maxIterations,
-                    temperature: config.temperature,
-                    env: config.env,
-                    ...(config.pruneKeepLast !== undefined ? { pruneKeepLast: config.pruneKeepLast } : {}),
-                    logger: this.log,
-                    // See ReactiveAgent: a hand-listed literal drops what nobody
-                    // remembered to add, and reports nothing when it does.
-                    ...(config.thinking ? { thinking: config.thinking } : {}),
-                    ...(config.effort ? { effort: config.effort } : {}),
-                },
-                questionParks,
-                pendingAnswers,
-                // How wide a fan-out actually runs. Absent leaves the kernel
-                // default — the same forwarding ReactiveAgent has always done,
-                // missing from the one agent whose job is delegation.
-                ...(config.maxToolConcurrency !== undefined
-                    ? { maxToolConcurrency: config.maxToolConcurrency }
-                    : {}),
-                agentId: this.metadata.id,
-                agentName: this.metadata.name,
-                workingDirectory: input.workingDirectory,
-                messages: input.messages,
-                signal: input.signal,
-                sessionId,
-                topicId,
-                projectId,
-                tenantId,
-                turnId,
-                ...(config.parentSessionId ? { parentSessionId: config.parentSessionId } : {}),
-                ...(config.parentTurnId ? { parentTurnId: config.parentTurnId } : {}),
-                depth: config.depth,
-                contextLevel: 'full',
-                onContextCreated: ({ planManager }) => {
-                    planManagerRef = planManager;
-                },
-                taskStore: input.taskStore,
-                runtimeToolOverrides: input.runtimeToolOverrides,
-                runtimeContext: input.runtimeContext,
-                taskScheduler: gateway,
-                budget,
-                completionInbox,
-                advisory: config.advisory,
-                invocationState: childInvocationState,
-                // HITL surface: forward optional review-time hooks so hosts can
-                // run "Ask before acting" supervisors instead of the default
-                // auto-approve. drainQuery falls back to autoApproveHandler
-                // when resumeHandler is omitted (= same behaviour as before).
-                ...(config.resumeHandler ? { resumeHandler: config.resumeHandler } : {}),
-                ...(config.reviewAllowedCalls ? { reviewAllowedCalls: config.reviewAllowedCalls } : {}),
-                // Forwarded for the same reason the handler is. A capability the
-                // kernel honours in `drainQuery` but that never reaches the
-                // surface a host actually constructs is a capability nobody can
-                // use — which is the shape of defect this file has already been
-                // corrected for twice.
-                ...(config.steering ? { steering: config.steering } : {}),
-                ...(config.inboundMessages ? { inboundMessages: config.inboundMessages } : {}),
-                ...(config.projectInstructionContext
-                    ? { projectInstructionContext: config.projectInstructionContext }
-                    : {}),
-                ...(config.authorizationGate ? { authorizationGate: config.authorizationGate } : {}),
-                // The one hop between the config and the tool. `drainQuery`
-                // registers `structured_output` from this and the loop
-                // captures it, so the kernel never cared which archetype it
-                // came from — only `ReactiveAgent` was passing it.
-                ...(config.structuredOutput ? { structuredOutput: config.structuredOutput } : {}),
-                ...(config.sandboxProvider ? { sandboxProvider: config.sandboxProvider } : {}),
-                ...(config.sandboxTeardownTimeoutMs !== undefined
-                    ? { sandboxTeardownTimeoutMs: config.sandboxTeardownTimeoutMs }
-                    : {}),
-                // Working-memory / compaction seam (optional; absent => unchanged
-                // run path, byte-identical for every existing consumer).
-                ...(config.compactionConfig ? { compactionConfig: config.compactionConfig } : {}),
-                ...(config.workingMemoryProvider
-                    ? { workingMemoryProvider: config.workingMemoryProvider }
-                    : {}),
-                ...(config.paths ? { paths: config.paths } : {}),
-                ...(config.sessionLog ? { sessionLog: config.sessionLog } : {}),
-                ...(config.checkpointStore ? { checkpointStore: config.checkpointStore } : {}),
-            }, listener);
-            const taskHandles = gateway.listTasks();
-            const taskResults = synthesizeTaskResults(taskHandles, { sessionId, turnId });
-            const completedTasks = countCompletedTasks(taskResults);
-            return {
-                sessionId,
-                turnId: turn.id,
-                status: turn.status === 'completed' ? 'completed' : 'failed',
-                stopReason: turn.stopReason,
-                usage: turn.tokenUsage,
-                budget: budget.summary(),
-                cost: turn.costInfo,
-                iterations: turn.currentIteration,
-                durationMs: Date.now() - startTime,
-                messages: turn.messages,
-                result: turn.result,
-                // `BaseAgentResult.structuredOutput` names "an archetype's result
-                // literal did not copy it" as a defect it was written to close.
-                // This literal still did not copy it, so the same defect was live
-                // in the one archetype nobody checked: the value would have been
-                // produced, recorded on the turn, serialized into `result`, and
-                // absent from the type a supervisor host actually reads.
-                structuredOutput: turn.structuredOutput,
-                lastError: turn.lastError,
-                taskResults,
-                completedTasks,
-                totalTasks: taskResults.length,
-            };
-        }
-        finally {
-            completionInbox.close();
-        }
-    }
-}
+/** @deprecated Example agent. Define application agents with the SDK Agent contract. */
+export { SupervisorAgent } from './examples/SupervisorAgent.js';
+export { synthesizeTaskResults, countCompletedTasks } from './examples/SupervisorAgent.js';
 //# sourceMappingURL=SupervisorAgent.js.map

package/dist/agents/SupervisorAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"SupervisorAgent.js","sourceRoot":"","sources":["../../src/agents/SupervisorAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SupervisorAgent.js","sourceRoot":"","sources":["../../src/agents/SupervisorAgent.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/agents/defineAgent.d.ts

@@ -8,7 +8,8 @@ export interface DefineAgentOptions<TConfig extends BaseAgentConfig = BaseAgentC
     category: string;
     description: string;
     capabilities?: Partial<AgentCapabilities>;
-    run(input: AgentInput, config: TConfig, listener?: SessionEventListener): Promise<TResult>;
+    /** The signal is scoped to this instance; observe it to stop work on cancel. */
+    run(input: AgentInput, config: TConfig, listener: SessionEventListener | undefined, signal: AbortSignal): Promise<TResult>;
     cancel?(): Promise<void>;
 }
 export declare function defineAgent<TConfig extends BaseAgentConfig = BaseAgentConfig, TResult extends BaseAgentResult = BaseAgentResult>(options: DefineAgentOptions<TConfig, TResult>): Agent<TConfig, TResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"defineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/defineAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,KAAK,EACL,iBAAiB,EACjB,UAAU,EAEV,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,MAAM,WAAW,kBAAkB,CAClC,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe;IAEjD,IAAI,EAAE,SAAS,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACzC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1F,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,wBAAgB,WAAW,CAC1B,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe,EAChD,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAoCxE"}
+{"version":3,"file":"defineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/defineAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,KAAK,EACL,iBAAiB,EACjB,UAAU,EAEV,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,MAAM,WAAW,kBAAkB,CAClC,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe;IAEjD,IAAI,EAAE,SAAS,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACzC,gFAAgF;IAChF,GAAG,CACF,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,wBAAgB,WAAW,CAC1B,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,SAAS,eAAe,GAAG,eAAe,EAChD,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAyCxE"}

package/dist/agents/defineAgent.js

@@ -13,8 +13,13 @@ export function defineAgent(options) {
     return {
         type: options.type,
         metadata,
+        // AgentManager asks for a fresh shell per delegated turn. Reusing one
+        // controller would make a cancelled sibling abort another sibling's work.
+        forTurn() {
+            return defineAgent(options);
+        },
         async run(input, config, listener) {
-            return options.run(input, config, listener);
+            return options.run(input, config, listener, abortController.signal);
         },
         async cancel() {
             abortController.abort();

package/dist/agents/defineAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineAgent.js","sourceRoot":"","sources":["../../src/agents/defineAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AA2BlE,MAAM,UAAU,WAAW,CAGzB,OAA6C;IAC9C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;IAE7C,MAAM,QAAQ,GAAkB;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,EAAE,GAAG,oBAAoB,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE;KAClE,CAAA;IAED,OAAO;QACN,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ;QAER,KAAK,CAAC,GAAG,CACR,KAAiB,EACjB,MAAe,EACf,QAA+B;YAE/B,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC5C,CAAC;QAED,KAAK,CAAC,MAAM;YACX,eAAe,CAAC,KAAK,EAAE,CAAA;YACvB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,OAAO,CAAC,MAAM,EAAE,CAAA;YACvB,CAAC;QACF,CAAC;QAED,eAAe;YACd,OAAO,QAAQ,CAAC,YAAY,CAAA;QAC7B,CAAC;KACD,CAAA;AACF,CAAC"}
+{"version":3,"file":"defineAgent.js","sourceRoot":"","sources":["../../src/agents/defineAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAiClE,MAAM,UAAU,WAAW,CAGzB,OAA6C;IAC9C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;IAE7C,MAAM,QAAQ,GAAkB;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,EAAE,GAAG,oBAAoB,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE;KAClE,CAAA;IAED,OAAO;QACN,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ;QACR,sEAAsE;QACtE,0EAA0E;QAC1E,OAAO;YACN,OAAO,WAAW,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;QAED,KAAK,CAAC,GAAG,CACR,KAAiB,EACjB,MAAe,EACf,QAA+B;YAE/B,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,CAAA;QACpE,CAAC;QAED,KAAK,CAAC,MAAM;YACX,eAAe,CAAC,KAAK,EAAE,CAAA;YACvB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,OAAO,CAAC,MAAM,EAAE,CAAA;YACvB,CAAC;QACF,CAAC;QAED,eAAe;YACd,OAAO,QAAQ,CAAC,YAAY,CAAA;QAC7B,CAAC;KACD,CAAA;AACF,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * A developer-authored step list, and deliberately not a model-authored
+ * one.
+ *
+ * The proposal this 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 { SessionEventListener } from '../../types/session/events.js';
+import type { Logger } from '../../utils/logger.js';
+import { AbstractAgent } from '../AbstractAgent.js';
+/** @deprecated Example of developer-authored fixed-step orchestration. */
+export declare class PipelineAgent extends AbstractAgent<PipelineAgentConfig, PipelineAgentResult> {
+    readonly type: "pipeline";
+    constructor(metadata: Omit<AgentMetadata, 'type' | 'capabilities'>, log?: Logger);
+    /**
+     * One turn at a time per instance.
+     *
+     * `abortController` and `currentSessionId` are instance state, so two
+     * overlapping turns share one abort controller — cancelling either kills
+     * both — and the second clobbers the first's session, so a later
+     * `cancel()` cancels the wrong children. Neither failure announces itself.
+     * A host that wants parallelism constructs a second instance.
+     */
+    run(input: AgentInput, config: PipelineAgentConfig, listener?: SessionEventListener): Promise<PipelineAgentResult>;
+    private runExclusive;
+}
+//# sourceMappingURL=PipelineAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/examples/PipelineAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EAGnB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,KAAK,EAAgB,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAKvF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGnD,0EAA0E;AAC1E,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,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;YAMjB,YAAY;CA+L1B"}