@stigmer/runner 3.15.3-dev.20260914121148 → 3.16.0

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

@@ -1,235 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,111 +0,0 @@
-/**
- * V3StatusBuilder — consumes StigmerRunEvents from the V3ProtocolNormalizer
- * and progressively builds the transcript half of the AgentExecutionStatus
- * proto it is handed: messages, tool-call rows and their approval status,
- * sub-agent rows, todos, artifacts, write-backs.
- *
- * The one transcript builder of the native harness since S3 M2b: v3 event
- * semantics (tool_call_id keying, content-block-level deltas, explicit tool
- * lifecycle). Its predecessor, the v2 `StatusBuilder` over LangChain's
- * `streamEvents` v2, was retired with the v2 stream (Q-S3-1); the eight
- * golden sequences both once had to agree on are this builder's test's.
- *
- * What this builder deliberately does NOT write, and who does (the adapter
- * contract's field ownership, `harness/types.ts` `TurnSink`): the phase,
- * `startedAt` and `streamingUsage` are the turn runtime's. A gated tool
- * start is reported as the {@link awaitingApproval} fact and the caller
- * (`turn-stream.ts`) decides what that means for the turn; usage is reported
- * raw through {@link V3StatusBuilderOptions.onUsage} and the caller prices
- * it into the sink (until S3 M2a this builder flipped WAITING_FOR_APPROVAL
- * itself and summed usage into `streamingUsage` — a second writer of each
- * field beside the runtime's).
- *
- * Usage is reported on message_finish only (standalone usage events are
- * no-ops) to prevent double-counting — v3 emits both for the same turn.
- * EVERY graph's usage is reported, the sub-agents' included (S3 M2b,
- * Q-M2b-1): a sub-agent's `message_finish` fires the same hook before it is
- * routed to the tracker, so the execution's usage — and the cost cap the
- * runtime enforces over it — is the whole execution's spend. Until M2b the
- * sub-agents' turns were discarded (S3 M2a finding F-M2a-12); the cost cap
- * then lived inside the graph, where a middleware saw every model call.
- */
-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 "../../shared/execution-status-writer.js";
-import type { StigmerRunEvent, V3UsagePayload } from "./v3-events.js";
-import { type ApprovalPolicyProvider } from "./status-builder-shared.js";
-export interface V3StatusBuilderOptions {
-    /**
-     * Fired once per `message_finish` that carries usage — the parent graph's
-     * and every sub-agent's — with the payload exactly as the protocol
-     * delivered it. The builder never sums or prices: the caller accounts (the
-     * turn runtime through `TurnSink.reportUsage`, priced at the turn's model;
-     * a sub-agent on its own model is priced at the parent's rate, as the
-     * in-graph cost cap always did — per-sub-agent pricing is an S5 item).
-     */
-    readonly onUsage?: (usage: V3UsagePayload) => void;
-}
-export declare class V3StatusBuilder implements ExecutionStatusWriter {
-    readonly executionId: string;
-    private readonly state;
-    private _forceNextUpdate;
-    private _awaitingApproval;
-    private approvalProvider;
-    private readonly onUsage;
-    private readonly subAgentTracker;
-    /** Progressive tool call arg accumulation keyed by callId. */
-    private readonly toolArgBuffers;
-    /**
-     * Builds INTO `status`, by reference: its `messages` and
-     * `subAgentExecutions` arrays are the ones indexed and pushed into, never
-     * replaced, so a caller that wraps the same status (the write-back
-     * coordinator's writer, the runtime's chokepoint) keeps seeing every row.
-     */
-    constructor(executionId: string, status: AgentExecutionStatus, options?: V3StatusBuilderOptions);
-    setApprovalProvider(provider: ApprovalPolicyProvider): void;
-    get currentStatus(): AgentExecutionStatus;
-    /**
-     * True once a tool call this turn was gated and left WAITING_APPROVAL: the
-     * engine has interrupted (or will, at this step's end) and the turn should
-     * end awaiting a decision. A fact about the transcript, not a phase — the
-     * caller owns the phase.
-     */
-    get awaitingApproval(): boolean;
-    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;
-    /**
-     * 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;
-    /**
-     * Clear the streaming flag on every sub-agent message still marked as
-     * streaming — what a turn that stopped mid-delegation owes the transcript
-     * beside the CANCELLED status the caller stamps on the row itself
-     * (`shared/subagent-rows.ts` `cancelInProgressSubAgentProtos`, the one
-     * home of that transition for every harness).
-     */
-    finalizeSubAgentStreaming(): void;
-}