@stigmer/runner 3.0.1

package/dist/activities/execute-deep-agent/subagent-wiring.js

@@ -0,0 +1,40 @@
+/**
+ * Sub-agent middleware composition for ExecuteDeepAgent.
+ *
+ * Each sub-agent gets its own middleware stack with:
+ * - Fresh loop detection (independent cycle tracking)
+ * - Fresh tool truncation (same limits as parent)
+ * - Periodic execution budget (interval=30, max=4 advisories)
+ * - Shared cost cap view (parent's budget, no reset on sub-agent start)
+ *
+ * The sub-agent middleware stack does NOT include:
+ * - Graceful stop (parent handles STOP signal propagation)
+ * - OTel spans (parent's OTel context propagates automatically)
+ * - Error hints (applied at tool level, not sub-agent level)
+ * - Approval gate (sub-agent interrupts propagate to parent checkpoint)
+ */
+import { createLoopDetectionMiddleware } from "../../middleware/loop-detection.js";
+import { createToolTruncationMiddleware } from "../../middleware/tool-truncation.js";
+import { createExecutionBudgetMiddleware } from "../../middleware/execution-budget.js";
+const SUB_AGENT_ADVISORY_INTERVAL = 30;
+const SUB_AGENT_MAX_ADVISORIES = 4;
+/**
+ * Build the middleware stack for a single sub-agent.
+ *
+ * Returns an ordered array matching the Python `compile_subagent` composition:
+ * loop detection → execution budget (periodic) → tool truncation → cost cap view.
+ */
+export function buildSubAgentMiddleware(options = {}) {
+    const stack = [];
+    stack.push(createLoopDetectionMiddleware({ enabled: true }));
+    stack.push(createExecutionBudgetMiddleware({
+        warningInterval: SUB_AGENT_ADVISORY_INTERVAL,
+        maxWarnings: SUB_AGENT_MAX_ADVISORIES,
+    }));
+    stack.push(createToolTruncationMiddleware(options.toolTruncation));
+    if (options.costCap) {
+        stack.push(options.costCap.forSubAgent());
+    }
+    return stack;
+}
+//# sourceMappingURL=subagent-wiring.js.map

package/dist/activities/execute-deep-agent/subagent-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-wiring.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/subagent-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,MAAM,2BAA2B,GAAG,EAAE,CAAC;AACvC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAOnC;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAqC,EAAE;IAEvC,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE7D,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC;QACzC,eAAe,EAAE,2BAA2B;QAC5C,WAAW,EAAE,wBAAwB;KACtC,CAAC,CAAC,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAEnE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/activities/execute-deep-agent/v3-event-recorder.d.ts

@@ -0,0 +1,31 @@
+/**
+ * V3 event recorder for capturing raw LangGraph v3 ProtocolEvents.
+ *
+ * Activated by the V3_EVENT_RECORD_DIR environment variable. When set,
+ * the v3 streaming loop records every raw protocol event and flushes
+ * them atomically to a JSON file after the stream completes.
+ *
+ * This is test/development infrastructure for the v3 streaming migration.
+ * The captured events serve as ground-truth for building the
+ * V3StatusBuilder and validating v3 event shape assumptions.
+ */
+export interface V3EventRecorder {
+    record(event: V3ProtocolEvent, seq: number): void;
+    flush(): Promise<void>;
+}
+export interface V3ProtocolEvent {
+    readonly type: string;
+    readonly seq: number;
+    readonly method: string;
+    readonly params: {
+        readonly namespace: string[];
+        readonly timestamp: number;
+        readonly node?: string;
+        readonly data: unknown;
+    };
+}
+/**
+ * Create a recorder if V3_EVENT_RECORD_DIR is set, otherwise return undefined.
+ * The caller does `recorder?.record(event, seq)` — zero overhead when off.
+ */
+export declare function createV3EventRecorder(executionId: string, recordDir: string | undefined): V3EventRecorder | undefined;

package/dist/activities/execute-deep-agent/v3-event-recorder.js

@@ -0,0 +1,71 @@
+/**
+ * V3 event recorder for capturing raw LangGraph v3 ProtocolEvents.
+ *
+ * Activated by the V3_EVENT_RECORD_DIR environment variable. When set,
+ * the v3 streaming loop records every raw protocol event and flushes
+ * them atomically to a JSON file after the stream completes.
+ *
+ * This is test/development infrastructure for the v3 streaming migration.
+ * The captured events serve as ground-truth for building the
+ * V3StatusBuilder and validating v3 event shape assumptions.
+ */
+import { writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Create a recorder if V3_EVENT_RECORD_DIR is set, otherwise return undefined.
+ * The caller does `recorder?.record(event, seq)` — zero overhead when off.
+ */
+export function createV3EventRecorder(executionId, recordDir) {
+    if (!recordDir)
+        return undefined;
+    return new FileV3EventRecorder(executionId, recordDir);
+}
+class FileV3EventRecorder {
+    executionId;
+    outputDir;
+    events = [];
+    constructor(executionId, outputDir) {
+        this.executionId = executionId;
+        this.outputDir = outputDir;
+    }
+    record(event, seq) {
+        this.events.push({
+            seq,
+            capturedAt: new Date().toISOString(),
+            type: event.type,
+            method: event.method,
+            namespace: event.params.namespace,
+            timestamp: event.params.timestamp,
+            node: event.params.node,
+            data: safeClone(event.params.data),
+        });
+    }
+    async flush() {
+        if (this.events.length === 0)
+            return;
+        await mkdir(this.outputDir, { recursive: true });
+        const filePath = join(this.outputDir, `${this.executionId}.v3-events.json`);
+        const payload = {
+            executionId: this.executionId,
+            recordedAt: new Date().toISOString(),
+            eventCount: this.events.length,
+            events: this.events,
+        };
+        await writeFile(filePath, JSON.stringify(payload, bigintReplacer, 2));
+    }
+}
+function safeClone(obj) {
+    try {
+        return JSON.parse(JSON.stringify(obj, bigintReplacer));
+    }
+    catch {
+        if (obj && typeof obj === "object") {
+            return { _serializationError: true, keys: Object.keys(obj) };
+        }
+        return { _serializationError: true };
+    }
+}
+function bigintReplacer(_key, value) {
+    return typeof value === "bigint" ? value.toString() : value;
+}
+//# sourceMappingURL=v3-event-recorder.js.map

package/dist/activities/execute-deep-agent/v3-event-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-event-recorder.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/v3-event-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA8BjC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,SAA6B;IAE7B,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,IAAI,mBAAmB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,mBAAmB;IAIJ;IACA;IAJF,MAAM,GAAsB,EAAE,CAAC;IAEhD,YACmB,WAAmB,EACnB,SAAiB;QADjB,gBAAW,GAAX,WAAW,CAAQ;QACnB,cAAS,GAAT,SAAS,CAAQ;IACjC,CAAC;IAEJ,MAAM,CAAC,KAAsB,EAAE,GAAW;QACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,GAAG;YACH,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;YACjC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;YACjC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;YACvB,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,IAAI,CACnB,IAAI,CAAC,SAAS,EACd,GAAG,IAAI,CAAC,WAAW,iBAAiB,CACrC,CAAC;QAEF,MAAM,OAAO,GAAG;YACd,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;QAEF,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9D,CAAC"}

package/dist/activities/execute-deep-agent/v3-events.d.ts

@@ -0,0 +1,102 @@
+/**
+ * StigmerRunEvent — normalized v3 protocol event types.
+ *
+ * The V3ProtocolNormalizer converts raw LangGraph ProtocolEvents into
+ * these typed variants. V3StatusBuilder consumes them to build the
+ * AgentExecutionStatus proto.
+ *
+ * This is a runner-internal contract (not persisted, not exposed to
+ * clients). It isolates the StatusBuilder from LangGraph protocol
+ * instability (field naming, delta shapes, channel semantics).
+ *
+ * ID conventions:
+ *   - `runId`  — LLM invocation ID; shared across message events in one turn
+ *   - `callId` — provider tool call ID (e.g. `toolu_...`); keys ToolCall records
+ *   - `namespace` — formatted string from v3 namespace array; empty = parent agent
+ */
+interface StigmerRunEventBase {
+    readonly kind: string;
+    readonly seq: number;
+    /** Formatted namespace string: empty = parent agent, joined with "|" for nested. */
+    readonly namespace: string;
+    readonly node?: string;
+}
+export interface MessageStartEvent extends StigmerRunEventBase {
+    readonly kind: "message_start";
+    readonly runId: string;
+    readonly messageId?: string;
+}
+export interface TextDeltaEvent extends StigmerRunEventBase {
+    readonly kind: "text_delta";
+    readonly runId: string;
+    readonly text: string;
+}
+export interface ReasoningDeltaEvent extends StigmerRunEventBase {
+    readonly kind: "reasoning_delta";
+    readonly runId: string;
+    readonly text: string;
+}
+export interface ToolCallArgDeltaEvent extends StigmerRunEventBase {
+    readonly kind: "tool_call_arg_delta";
+    readonly callId: string;
+    readonly argsChunk: string;
+}
+export interface MessageFinishEvent extends StigmerRunEventBase {
+    readonly kind: "message_finish";
+    readonly runId: string;
+    readonly usage?: V3UsagePayload;
+    readonly reason?: string;
+}
+export interface ToolStartedEvent extends StigmerRunEventBase {
+    readonly kind: "tool_started";
+    readonly callId: string;
+    readonly name: string;
+    readonly input: Record<string, unknown>;
+}
+export interface ToolOutputDeltaEvent extends StigmerRunEventBase {
+    readonly kind: "tool_output_delta";
+    readonly callId: string;
+    readonly delta: string;
+}
+export interface ToolFinishedEvent extends StigmerRunEventBase {
+    readonly kind: "tool_finished";
+    readonly callId: string;
+    readonly output: unknown;
+}
+export interface ToolErrorEvent extends StigmerRunEventBase {
+    readonly kind: "tool_error";
+    readonly callId: string;
+    readonly message: string;
+}
+export interface UsageEvent extends StigmerRunEventBase {
+    readonly kind: "usage";
+    readonly runId: string;
+    readonly usage: V3UsagePayload;
+}
+export interface LifecycleEvent extends StigmerRunEventBase {
+    readonly kind: "lifecycle";
+    readonly event: string;
+    readonly graphName?: string;
+}
+export interface ProviderEvent extends StigmerRunEventBase {
+    readonly kind: "provider";
+    readonly provider: string;
+    readonly model?: string;
+}
+export interface V3UsagePayload {
+    readonly input_tokens?: number;
+    readonly output_tokens?: number;
+    readonly total_tokens?: number;
+    readonly input_token_details?: {
+        readonly cache_creation?: number;
+        readonly cache_read?: number;
+    };
+}
+export type StigmerRunEvent = MessageStartEvent | TextDeltaEvent | ReasoningDeltaEvent | ToolCallArgDeltaEvent | MessageFinishEvent | ToolStartedEvent | ToolOutputDeltaEvent | ToolFinishedEvent | ToolErrorEvent | UsageEvent | LifecycleEvent | ProviderEvent;
+export declare function formatNamespace(ns: readonly string[]): string;
+/**
+ * Returns the depth (number of segments) of a formatted namespace string.
+ * Empty string → 0, single segment → 1, "a|b" → 2, etc.
+ */
+export declare function namespaceDepth(namespace: string): number;
+export {};

package/dist/activities/execute-deep-agent/v3-events.js

@@ -0,0 +1,35 @@
+/**
+ * StigmerRunEvent — normalized v3 protocol event types.
+ *
+ * The V3ProtocolNormalizer converts raw LangGraph ProtocolEvents into
+ * these typed variants. V3StatusBuilder consumes them to build the
+ * AgentExecutionStatus proto.
+ *
+ * This is a runner-internal contract (not persisted, not exposed to
+ * clients). It isolates the StatusBuilder from LangGraph protocol
+ * instability (field naming, delta shapes, channel semantics).
+ *
+ * ID conventions:
+ *   - `runId`  — LLM invocation ID; shared across message events in one turn
+ *   - `callId` — provider tool call ID (e.g. `toolu_...`); keys ToolCall records
+ *   - `namespace` — formatted string from v3 namespace array; empty = parent agent
+ */
+// ── Namespace Formatting ──────────────────────────────────────────
+export function formatNamespace(ns) {
+    return ns.length === 0 ? "" : ns.join("|");
+}
+/**
+ * Returns the depth (number of segments) of a formatted namespace string.
+ * Empty string → 0, single segment → 1, "a|b" → 2, etc.
+ */
+export function namespaceDepth(namespace) {
+    if (!namespace)
+        return 0;
+    let count = 1;
+    for (let i = 0; i < namespace.length; i++) {
+        if (namespace[i] === "|")
+            count++;
+    }
+    return count;
+}
+//# sourceMappingURL=v3-events.js.map

package/dist/activities/execute-deep-agent/v3-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-events.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/v3-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAwHH,qEAAqE;AAErE,MAAM,UAAU,eAAe,CAAC,EAAqB;IACnD,OAAO,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,IAAI,CAAC,SAAS;QAAE,OAAO,CAAC,CAAC;IACzB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/activities/execute-deep-agent/v3-protocol-normalizer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * V3ProtocolNormalizer — converts raw LangGraph v3 ProtocolEvents
+ * into the StigmerRunEvent discriminated union.
+ *
+ * Stateless: each event is self-describing per real recordings.
+ * Routes by `event.method`, then by `data.event` within channels.
+ *
+ * Defensive parsing: handles both snake_case and camelCase field names
+ * for tool IDs/names (protocol spec uses camelCase but recordings show
+ * snake_case). Uses `data.event` as canonical discriminator, with
+ * `data.type` as fallback (CP04 finding).
+ */
+import type { V3ProtocolEvent } from "./v3-event-recorder.js";
+import type { StigmerRunEvent } from "./v3-events.js";
+export declare function normalize(event: V3ProtocolEvent): StigmerRunEvent[];

package/dist/activities/execute-deep-agent/v3-protocol-normalizer.js

@@ -0,0 +1,235 @@
+/**
+ * V3ProtocolNormalizer — converts raw LangGraph v3 ProtocolEvents
+ * into the StigmerRunEvent discriminated union.
+ *
+ * Stateless: each event is self-describing per real recordings.
+ * Routes by `event.method`, then by `data.event` within channels.
+ *
+ * Defensive parsing: handles both snake_case and camelCase field names
+ * for tool IDs/names (protocol spec uses camelCase but recordings show
+ * snake_case). Uses `data.event` as canonical discriminator, with
+ * `data.type` as fallback (CP04 finding).
+ */
+import { formatNamespace } from "./v3-events.js";
+const loggedUnknowns = new Set();
+export function normalize(event) {
+    const method = event.method;
+    switch (method) {
+        case "messages": return normalizeMessage(event);
+        case "tools": return normalizeTool(event);
+        case "lifecycle": return normalizeLifecycle(event);
+        default:
+            return [];
+    }
+}
+// ── Messages Channel ──────────────────────────────────────────────
+function normalizeMessage(event) {
+    const data = event.params.data;
+    if (!data)
+        return [];
+    const eventType = readEventType(data);
+    const base = {
+        seq: event.seq,
+        namespace: formatNamespace(event.params.namespace),
+        node: event.params.node,
+    };
+    const runId = (data.run_id ?? "");
+    switch (eventType) {
+        case "message-start":
+            return [{
+                    kind: "message_start",
+                    ...base,
+                    runId,
+                    messageId: data.id,
+                }];
+        case "content-block-delta":
+            return normalizeContentBlockDelta(event, data, base, runId);
+        case "message-finish":
+            return [{
+                    kind: "message_finish",
+                    ...base,
+                    runId,
+                    usage: normalizeUsagePayload(data.usage),
+                    reason: data.reason,
+                }];
+        case "usage":
+            return [{
+                    kind: "usage",
+                    ...base,
+                    runId,
+                    usage: normalizeUsagePayload(data.usage),
+                }];
+        case "provider":
+            return [{
+                    kind: "provider",
+                    ...base,
+                    provider: (data.provider ?? ""),
+                    model: extractModel(data),
+                }];
+        case "content-block-start":
+        case "content-block-finish":
+            return [];
+        default:
+            logUnknown("messages", eventType);
+            return [];
+    }
+}
+function normalizeContentBlockDelta(event, data, base, runId) {
+    const delta = data.delta;
+    if (!delta)
+        return [];
+    const deltaType = delta.type;
+    if (deltaType === "text-delta") {
+        const text = (delta.text ?? "");
+        if (!text)
+            return [];
+        return [{ kind: "text_delta", ...base, runId, text }];
+    }
+    if (deltaType === "reasoning-delta") {
+        const text = (delta.reasoning ?? "");
+        if (!text)
+            return [];
+        return [{ kind: "reasoning_delta", ...base, runId, text }];
+    }
+    if (deltaType === "block-delta") {
+        const fields = delta.fields;
+        if (!fields)
+            return [];
+        if (fields.type === "tool_call_chunk") {
+            const callId = (fields.id ?? "");
+            const argsChunk = (fields.args ?? "");
+            if (!argsChunk && !callId)
+                return [];
+            return [{
+                    kind: "tool_call_arg_delta",
+                    ...base,
+                    callId,
+                    argsChunk,
+                }];
+        }
+    }
+    return [];
+}
+// ── Tools Channel ─────────────────────────────────────────────────
+function normalizeTool(event) {
+    const data = event.params.data;
+    if (!data)
+        return [];
+    const eventType = readEventType(data);
+    const base = {
+        seq: event.seq,
+        namespace: formatNamespace(event.params.namespace),
+        node: event.params.node,
+    };
+    switch (eventType) {
+        case "tool-started": {
+            const callId = readToolCallId(data);
+            const name = readToolName(data);
+            const input = parseToolInput(data.input);
+            return [{
+                    kind: "tool_started",
+                    ...base,
+                    callId,
+                    name,
+                    input,
+                }];
+        }
+        case "tool-finished": {
+            const callId = readToolCallId(data);
+            return [{
+                    kind: "tool_finished",
+                    ...base,
+                    callId,
+                    output: data.output,
+                }];
+        }
+        case "tool-error": {
+            const callId = readToolCallId(data);
+            const message = (data.message ?? data.error ?? "");
+            return [{
+                    kind: "tool_error",
+                    ...base,
+                    callId,
+                    message,
+                }];
+        }
+        case "tool-output-delta": {
+            const callId = readToolCallId(data);
+            const delta = (data.delta ?? "");
+            return [{
+                    kind: "tool_output_delta",
+                    ...base,
+                    callId,
+                    delta: String(delta),
+                }];
+        }
+        default:
+            logUnknown("tools", eventType);
+            return [];
+    }
+}
+// ── Lifecycle Channel ─────────────────────────────────────────────
+function normalizeLifecycle(event) {
+    const data = event.params.data;
+    if (!data)
+        return [];
+    return [{
+            kind: "lifecycle",
+            seq: event.seq,
+            namespace: formatNamespace(event.params.namespace),
+            node: event.params.node,
+            event: readEventType(data),
+            graphName: (data.graph_name ?? data.graphName),
+        }];
+}
+// ── Defensive Field Parsers ───────────────────────────────────────
+function readEventType(data) {
+    return (data.event ?? data.type) ?? "";
+}
+function readToolCallId(data) {
+    return (data.tool_call_id ?? data.toolCallId) ?? "";
+}
+function readToolName(data) {
+    return (data.tool_name ?? data.toolName ?? data.name) ?? "unknown_tool";
+}
+function parseToolInput(raw) {
+    if (raw === undefined || raw === null)
+        return {};
+    if (typeof raw === "object" && !Array.isArray(raw))
+        return raw;
+    if (typeof raw === "string") {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return {};
+        }
+    }
+    return {};
+}
+function normalizeUsagePayload(raw) {
+    if (!raw)
+        return undefined;
+    const details = raw.input_token_details;
+    return {
+        input_tokens: raw.input_tokens,
+        output_tokens: raw.output_tokens,
+        total_tokens: raw.total_tokens,
+        input_token_details: details ? {
+            cache_creation: details.cache_creation,
+            cache_read: details.cache_read,
+        } : undefined,
+    };
+}
+function extractModel(data) {
+    const payload = data.payload;
+    return payload?.model;
+}
+function logUnknown(method, eventType) {
+    const key = `${method}:${eventType}`;
+    if (loggedUnknowns.has(key))
+        return;
+    loggedUnknowns.add(key);
+    console.debug(`[V3Normalizer] Unknown event: method=${method} event=${eventType}`);
+}
+//# sourceMappingURL=v3-protocol-normalizer.js.map

package/dist/activities/execute-deep-agent/v3-protocol-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-protocol-normalizer.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/v3-protocol-normalizer.ts"],"names":[],"mappings":"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"}

package/dist/activities/execute-deep-agent/v3-status-builder.d.ts

@@ -0,0 +1,68 @@
+/**
+ * V3StatusBuilder — consumes StigmerRunEvents from the V3ProtocolNormalizer
+ * and progressively builds the AgentExecutionStatus proto.
+ *
+ * Implements the same behavioral contract as the v2 StatusBuilder for all
+ * 8 golden scenarios, using v3 event semantics (tool_call_id keying,
+ * content-block-level deltas, explicit tool lifecycle).
+ *
+ * Usage is accumulated on message_finish only (standalone usage events are
+ * no-ops) to prevent double-counting — v3 emits both for the same turn.
+ */
+import type { AgentExecutionStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
+import type { WorkspaceWriteBack } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/writeback_pb";
+import type { ExecutionStatusWriter } from "./execution-status-writer.js";
+import type { ApprovalPolicyProvider } from "./status-builder.js";
+import type { StigmerRunEvent } from "./v3-events.js";
+export declare class V3StatusBuilder implements ExecutionStatusWriter {
+    readonly executionId: string;
+    private readonly state;
+    private _forceNextUpdate;
+    private approvalProvider;
+    private readonly usageAccumulator;
+    private readonly subAgentTracker;
+    /** Progressive tool call arg accumulation keyed by callId. */
+    private readonly toolArgBuffers;
+    constructor(executionId: string, initialStatus: AgentExecutionStatus);
+    setApprovalProvider(provider: ApprovalPolicyProvider): void;
+    get currentStatus(): AgentExecutionStatus;
+    get forceNextUpdate(): boolean;
+    clearForceFlag(): void;
+    processEvent(event: StigmerRunEvent): void;
+    addArtifact(artifact: ExecutionArtifact): void;
+    addWriteBack(wb: WorkspaceWriteBack): void;
+    private handleMessageStart;
+    private handleMessageFinish;
+    private appendTextContent;
+    private appendThinkingContent;
+    private handleToolStarted;
+    private handleToolFinished;
+    private handleToolError;
+    private handleToolCallArgDelta;
+    private handleToolOutputDelta;
+    /**
+     * v3 tool events carry namespace like "tools:toolu_abc" or
+     * "subagent:worker-1|tools:toolu_abc". Strip tools:* segments
+     * to get the agent namespace for AI message lookup.
+     */
+    private resolveAgentNamespace;
+    private checkApprovalRequirement;
+    private ensureAiMessage;
+    private ensureAiMessageForToolCall;
+    private accumulateV3Usage;
+    /**
+     * Check if a tool_call_id belongs to a tracked "task" tool invocation.
+     * Used to route tool_finished/tool_error events to both parent and tracker.
+     */
+    private isTrackedTaskTool;
+    /**
+     * Sync sub-agent executions into the proto for persistence.
+     * Called by the streaming orchestrator before each persist.
+     */
+    syncSubAgentExecutions(): void;
+    /**
+     * Cancel all in-progress sub-agents (called on parent cancellation).
+     */
+    cancelSubAgents(): void;
+}