@namzu/sdk 46.0.0 → 48.0.0

package/dist/advisory/history.js

@@ -10,6 +10,26 @@ function attachmentSummary(attachment) {
 function publicBlock(block) {
     return block.type === 'text' ? { type: 'text', text: block.text } : attachmentSummary(block);
 }
+/**
+ * What the advisor is told about a call whose arguments could not be read,
+ * whose `arguments` are then `"{}"`. `inputTruncated` is set for every such
+ * call, cut off or malformed alike, so it cannot say which: the advisor was
+ * told a malformed call's arguments were incomplete. `inputError` says which,
+ * and a call an older runtime recorded without it is called unreadable, which
+ * is all that is known.
+ */
+function unreadableArguments(call) {
+    if (!call.metadata?.inputTruncated)
+        return {};
+    switch (call.metadata.inputError?.reason) {
+        case 'truncated':
+            return { argumentsIncomplete: true };
+        case 'malformed':
+            return { argumentsMalformed: true };
+        default:
+            return { argumentsUnreadable: true };
+    }
+}
 /** Text projection, not provider-native replay or independent verification. */
 function renderRecord(message, stage) {
     const record = {
@@ -30,7 +50,7 @@ function renderRecord(message, stage) {
                 id: call.id,
                 name: call.function.name,
                 arguments: call.function.arguments,
-                ...(call.metadata?.inputTruncated ? { argumentsIncomplete: true } : {}),
+                ...unreadableArguments(call),
             }));
         }
         if (message.textParts?.length) {

package/dist/advisory/history.js.map

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

package/dist/advisory/index.d.ts

@@ -1,6 +1,6 @@
 export { assertBudgetEnforceable } from './budget.js';
 export { ADVISORY_RESPONSE_CONTRACT, parseAdvisoryResponse } from './parse.js';
-export { AdvisorRegistry } from './registry.js';
+export { AdvisorCollisionError, AdvisorRegistry } from './registry.js';
 export { AdvisoryExecutor } from './executor.js';
 export type { AdvisoryCallContext, AdvisoryExecutionResult, AdvisoryTurnContext, } from './executor.js';
 export { TriggerEvaluator } from './evaluator.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/advisory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EACX,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/advisory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EACX,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/advisory/index.js

@@ -1,6 +1,6 @@
 export { assertBudgetEnforceable } from './budget.js';
 export { ADVISORY_RESPONSE_CONTRACT, parseAdvisoryResponse } from './parse.js';
-export { AdvisorRegistry } from './registry.js';
+export { AdvisorCollisionError, AdvisorRegistry } from './registry.js';
 export { AdvisoryExecutor } from './executor.js';
 export { TriggerEvaluator } from './evaluator.js';
 export { AdvisoryContext } from './context.js';

package/dist/advisory/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/advisory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAMhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/advisory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAMhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/advisory/registry.d.ts

@@ -1,8 +1,25 @@
 import { BaseRegistry } from '../registry/BaseRegistry.js';
+import { RegistryCollisionError } from '../registry/collision.js';
 import type { AdvisorDefinition } from '../types/advisory/index.js';
+/** Two advisors claiming one id. */
+export declare class AdvisorCollisionError extends RegistryCollisionError {
+    readonly advisorId: string;
+    constructor(advisorId: string);
+}
 export declare class AdvisorRegistry extends BaseRegistry<AdvisorDefinition> {
     private readonly defaultId;
     constructor(advisors: AdvisorDefinition[], defaultId?: string);
+    /**
+     * A second advisor claiming an id an earlier one already holds used to
+     * overwrite in total silence (see
+     * `gaps/critic-registry-collision-idiom-inconsistency.md`). Every SDK
+     * registry now throws on a duplicate id by default (see
+     * `registry/collision.ts`), and this one had no exception to name, so it
+     * converges too: two advisors sharing an id is a configuration mistake,
+     * not a supersession, and the loser vanishing silently is exactly the
+     * failure this now refuses instead of logging.
+     */
+    register(id: string, advisor: AdvisorDefinition): void;
     /**
      * Resolves the advisor for a given request.
      *

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,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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/advisory/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAEnE,oCAAoC;AACpC,qBAAa,qBAAsB,SAAQ,sBAAsB;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,SAAS,EAAE,MAAM;CAS7B;AAED,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;;;;;;;;;OASG;IACM,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAO/D;;;;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,4 +1,14 @@
 import { BaseRegistry } from '../registry/BaseRegistry.js';
+import { RegistryCollisionError } from '../registry/collision.js';
+/** Two advisors claiming one id. */
+export class AdvisorCollisionError extends RegistryCollisionError {
+    advisorId;
+    constructor(advisorId) {
+        super('AdvisorRegistry', advisorId, `Advisor "${advisorId}" is already registered. Two advisors picked the same id, or the same advisor was registered twice — pick a different id, or find the second registration.`);
+        this.name = 'AdvisorCollisionError';
+        this.advisorId = advisorId;
+    }
+}
 export class AdvisorRegistry extends BaseRegistry {
     defaultId;
     constructor(advisors, defaultId) {
@@ -8,6 +18,22 @@ export class AdvisorRegistry extends BaseRegistry {
         }
         this.defaultId = defaultId;
     }
+    /**
+     * A second advisor claiming an id an earlier one already holds used to
+     * overwrite in total silence (see
+     * `gaps/critic-registry-collision-idiom-inconsistency.md`). Every SDK
+     * registry now throws on a duplicate id by default (see
+     * `registry/collision.ts`), and this one had no exception to name, so it
+     * converges too: two advisors sharing an id is a configuration mistake,
+     * not a supersession, and the loser vanishing silently is exactly the
+     * failure this now refuses instead of logging.
+     */
+    register(id, advisor) {
+        if (this.has(id)) {
+            throw new AdvisorCollisionError(id);
+        }
+        super.register(id, advisor);
+    }
     /**
      * Resolves the advisor for a given request.
      *

package/dist/advisory/registry.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/advisory/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAGjE,oCAAoC;AACpC,MAAM,OAAO,qBAAsB,SAAQ,sBAAsB;IACvD,SAAS,CAAQ;IAE1B,YAAY,SAAiB;QAC5B,KAAK,CACJ,iBAAiB,EACjB,SAAS,EACT,YAAY,SAAS,4JAA4J,CACjL,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;CACD;AAED,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;;;;;;;;;OASG;IACM,QAAQ,CAAC,EAAU,EAAE,OAA0B;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,qBAAqB,CAAC,EAAE,CAAC,CAAA;QACpC,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAC5B,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/PipelineAgent.d.ts

@@ -1,47 +1,3 @@
-/**
- * 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 { SessionEventListener } from '../types/session/events.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'>, 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;
-}
+/** @deprecated Example agent. Define application agents with the SDK Agent contract. */
+export { PipelineAgent } from './examples/PipelineAgent.js';
 //# sourceMappingURL=PipelineAgent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PipelineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/PipelineAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EAGnB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAgB,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAKpF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,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"}
+{"version":3,"file":"PipelineAgent.d.ts","sourceRoot":"","sources":["../../src/agents/PipelineAgent.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/agents/PipelineAgent.js

@@ -1,243 +1,3 @@
-/**
- * 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 { withTokenBudget } from '../provider/token-budget.js';
-import { ZERO_COST } from '../utils/cost.js';
-import { toErrorMessage } from '../utils/error.js';
-import { generateMessageId } from '../utils/id.js';
-import { AbstractAgent } from './AbstractAgent.js';
-import { resolveAgentBudget } from './budget.js';
-export class PipelineAgent extends AbstractAgent {
-    type = 'pipeline';
-    constructor(metadata, log) {
-        super({
-            ...metadata,
-            type: 'pipeline',
-            capabilities: {
-                supportsTools: false,
-                supportsStreaming: false,
-                supportsConcurrency: false,
-                supportsSubAgents: false,
-            },
-        }, 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) {
-        if (config.sandbox) {
-            throw new Error('PipelineAgent cannot enforce a turn-level sandbox around developer-authored step callbacks. Configure confinement inside each step or use a tool-running agent.');
-        }
-        const startTime = Date.now();
-        const sessionId = this.resolveSessionId(config.sessionId);
-        const turnId = this.createTurnId();
-        this.bindTurn(sessionId, turnId, config.logger);
-        const budget = await resolveAgentBudget(input, config, { sessionId, turnId });
-        const settlement = (status, iterations) => ({
-            status,
-            iterations,
-            usage: budget.ownUsage,
-            cost: { ...ZERO_COST, unpricedTokens: budget.ownTokens },
-            durationMs: Date.now() - startTime,
-            resultSource: 'model',
-            abandonedTaskIds: [],
-            abandonedJobIds: [],
-        });
-        const provider = config.provider ? withTokenBudget(config.provider, budget) : undefined;
-        try {
-            const stepResults = [];
-            const previousResults = new Map();
-            let completedSteps = 0;
-            await this.emitEvent(turnStarted(sessionId, turnId, config, budget), listener);
-            let currentInput = input.messages
-                .filter((m) => m.role === 'user')
-                .map((m) => m.content)
-                .filter((c) => c !== null)
-                .join('\n');
-            for (let i = 0; i < config.steps.length; i++) {
-                const step = config.steps[i];
-                if (!step)
-                    throw new Error(`Pipeline step at index ${i} is undefined`);
-                const stepStart = Date.now();
-                if (this.abortController.signal.aborted) {
-                    stepResults.push({
-                        stepName: step.name,
-                        status: 'skipped',
-                        durationMs: 0,
-                    });
-                    continue;
-                }
-                await this.emitEvent({ type: 'iteration_started', sessionId, turnId, iteration: i + 1 }, listener);
-                const context = {
-                    sessionId,
-                    turnId,
-                    stepIndex: i,
-                    totalSteps: config.steps.length,
-                    previousResults,
-                    provider,
-                    budget,
-                    signal: this.abortController.signal,
-                    env: config.env ?? {},
-                };
-                try {
-                    if (step.validate && !step.validate(currentInput)) {
-                        throw new Error(`Validation failed for step "${step.name}"`);
-                    }
-                    const output = await step.execute(currentInput, context);
-                    previousResults.set(step.name, output);
-                    currentInput = output;
-                    completedSteps++;
-                    stepResults.push({
-                        stepName: step.name,
-                        status: 'completed',
-                        output,
-                        durationMs: Date.now() - stepStart,
-                    });
-                }
-                catch (err) {
-                    const errorMsg = toErrorMessage(err);
-                    stepResults.push({
-                        stepName: step.name,
-                        status: 'failed',
-                        error: errorMsg,
-                        durationMs: Date.now() - stepStart,
-                    });
-                    if (step.rollback) {
-                        try {
-                            await step.rollback(currentInput, context);
-                        }
-                        catch (rollbackErr) {
-                            this.log.error('Rollback failed for a step', {
-                                'namzu.pipeline.step_name': step.name,
-                                'exception.message': toErrorMessage(rollbackErr),
-                            });
-                        }
-                    }
-                    if (!config.continueOnError) {
-                        await this.emitEvent({
-                            type: 'turn_failed',
-                            sessionId,
-                            turnId,
-                            error: errorMsg,
-                            budget: budget.summary(),
-                            settlement: settlement('failed', i + 1),
-                        }, listener);
-                        return {
-                            sessionId,
-                            turnId,
-                            status: 'failed',
-                            stopReason: 'error',
-                            usage: budget.ownUsage,
-                            budget: budget.summary(),
-                            cost: { ...ZERO_COST, unpricedTokens: budget.ownTokens },
-                            iterations: i + 1,
-                            durationMs: Date.now() - startTime,
-                            messages: input.messages,
-                            lastError: errorMsg,
-                            stepResults,
-                            completedSteps,
-                            totalSteps: config.steps.length,
-                        };
-                    }
-                }
-            }
-            const finalStatus = completedSteps === config.steps.length ? 'completed' : 'failed';
-            const lastOutput = stepResults[stepResults.length - 1]?.output;
-            const result = typeof lastOutput === 'string' ? lastOutput : JSON.stringify(lastOutput);
-            // A pipeline that finished with failed steps (under `continueOnError`)
-            // did not complete its turn, so it settles as `turn_failed`: the
-            // terminal verdict is the event type (spec §2.10).
-            await this.emitEvent(finalStatus === 'completed'
-                ? {
-                    type: 'turn_completed',
-                    sessionId,
-                    turnId,
-                    budget: budget.summary(),
-                    result,
-                    stopReason: 'end_turn',
-                    settlement: settlement('completed', config.steps.length),
-                }
-                : {
-                    type: 'turn_failed',
-                    sessionId,
-                    turnId,
-                    budget: budget.summary(),
-                    error: `${config.steps.length - completedSteps} of ${config.steps.length} pipeline steps failed`,
-                    settlement: settlement('failed', config.steps.length),
-                }, listener);
-            return {
-                sessionId,
-                turnId,
-                status: finalStatus,
-                stopReason: 'end_turn',
-                usage: budget.ownUsage,
-                budget: budget.summary(),
-                cost: { ...ZERO_COST, unpricedTokens: budget.ownTokens },
-                iterations: config.steps.length,
-                durationMs: Date.now() - startTime,
-                messages: input.messages,
-                result,
-                stepResults,
-                completedSteps,
-                totalSteps: config.steps.length,
-            };
-        }
-        finally {
-            budget.settle();
-            await budget.flush();
-        }
-    }
-}
-/**
- * The turn a pipeline runs, announced the way `query()` announces one. The
- * user message id names the input the steps were handed; nothing is written
- * to a session log, because the steps are callbacks, not model calls.
- */
-function turnStarted(sessionId, turnId, config, budget) {
-    return {
-        type: 'turn_started',
-        sessionId,
-        turnId,
-        userMessageId: generateMessageId(),
-        config: {
-            model: config.model,
-            tokenBudget: config.tokenBudget,
-            timeoutMs: config.timeoutMs,
-        },
-        ...(budget.binding ? { budget: budget.binding } : {}),
-    };
-}
+/** @deprecated Example agent. Define application agents with the SDK Agent contract. */
+export { PipelineAgent } from './examples/PipelineAgent.js';
 //# sourceMappingURL=PipelineAgent.js.map

package/dist/agents/PipelineAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"PipelineAgent.js","sourceRoot":"","sources":["../../src/agents/PipelineAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PipelineAgent.js","sourceRoot":"","sources":["../../src/agents/PipelineAgent.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/agents/QueryAgent.d.ts

@@ -0,0 +1,21 @@
+import type { AgentMetadata, ManagedAgentInput, QueryAgentConfig, QueryAgentResult } 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';
+export declare class QueryAgent extends AbstractAgent<QueryAgentConfig, QueryAgentResult> {
+    readonly type: string;
+    constructor(metadata: Omit<AgentMetadata, '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: ManagedAgentInput, config: QueryAgentConfig, listener?: SessionEventListener): Promise<QueryAgentResult>;
+    private runExclusive;
+    cancel(): Promise<void>;
+}
+//# sourceMappingURL=QueryAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryAgent.d.ts","sourceRoot":"","sources":["../../src/agents/QueryAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAsIlD,qBAAa,UAAW,SAAQ,aAAa,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAiBvE;;;;;;;;OAQG;IACG,GAAG,CACR,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;YAmBd,YAAY;IAmEX,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}