@stigmer/runner 3.0.1

package/dist/activities/execute-cursor/todo-tracker.js

@@ -0,0 +1,108 @@
+/**
+ * Tracks todo tool call events from the Cursor SDK stream and populates
+ * AgentExecutionStatus.todos with structured TodoItem protos.
+ *
+ * The Cursor SDK emits todo updates as tool_call events. Historically the
+ * tool was named "TodoWrite"; current SDK versions use "updateTodos" with
+ * a slightly different args schema (camelCase statuses, no per-item id).
+ * This tracker accepts both names for resilience across SDK versions.
+ *
+ * The MessageAccumulator captures the same event as a MESSAGE_TOOL
+ * (preserving visibility in the message thread). This tracker is a
+ * parallel extraction into the proto map that downstream consumers
+ * (React TodoList, CLI emitTodoEvents) already know how to render.
+ *
+ * Follows the same single-responsibility pattern as DeltaEnricher:
+ * the orchestrator (execute-cursor.ts) wires it into the event loop.
+ */
+import { create } from "@bufbuild/protobuf";
+import { TodoItemSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/todo_pb";
+import { TodoStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { utcTimestamp } from "./message-translator.js";
+const TODO_TOOL_NAMES = new Set(["TodoWrite", "updateTodos"]);
+const STATUS_MAP = {
+    pending: TodoStatus.TODO_PENDING,
+    in_progress: TodoStatus.TODO_IN_PROGRESS,
+    inprogress: TodoStatus.TODO_IN_PROGRESS,
+    completed: TodoStatus.TODO_COMPLETED,
+    cancelled: TodoStatus.TODO_CANCELLED,
+};
+export class TodoTracker {
+    todos;
+    _isDirty = false;
+    constructor(todos) {
+        this.todos = todos;
+    }
+    /**
+     * Process a stream event. Only acts on completed todo tool calls
+     * (both legacy "TodoWrite" and current SDK "updateTodos").
+     */
+    processEvent(event) {
+        if (event.type !== "tool_call")
+            return;
+        if (!TODO_TOOL_NAMES.has(event.name))
+            return;
+        if (event.status !== "completed")
+            return;
+        const args = this.parseArgs(event.args);
+        if (!args)
+            return;
+        const rawTodos = args.todos;
+        if (!Array.isArray(rawTodos) || rawTodos.length === 0) {
+            if (args.merge !== true) {
+                this.clearMap();
+                this._isDirty = true;
+            }
+            return;
+        }
+        const merge = args.merge === true;
+        const now = utcTimestamp();
+        if (!merge) {
+            this.clearMap();
+        }
+        for (let i = 0; i < rawTodos.length; i++) {
+            const raw = rawTodos[i];
+            const id = raw.id || `todo-${i}`;
+            const statusStr = (raw.status ?? "pending").toLowerCase();
+            const status = STATUS_MAP[statusStr] ?? TodoStatus.TODO_PENDING;
+            const existing = merge ? this.todos[id] : undefined;
+            this.todos[id] = create(TodoItemSchema, {
+                id,
+                content: raw.content ?? "",
+                status,
+                createdAt: existing?.createdAt || raw.created_at || now,
+                updatedAt: now,
+            });
+        }
+        this._isDirty = true;
+        console.log(`TodoTracker: processed ${rawTodos.length} todo(s) from ${event.name} (merge=${merge})`);
+    }
+    get isDirty() {
+        return this._isDirty;
+    }
+    markPersisted() {
+        this._isDirty = false;
+    }
+    parseArgs(args) {
+        if (args == null)
+            return null;
+        if (typeof args === "string") {
+            try {
+                return JSON.parse(args);
+            }
+            catch {
+                return null;
+            }
+        }
+        if (typeof args === "object") {
+            return args;
+        }
+        return null;
+    }
+    clearMap() {
+        for (const key of Object.keys(this.todos)) {
+            delete this.todos[key];
+        }
+    }
+}
+//# sourceMappingURL=todo-tracker.js.map

package/dist/activities/execute-cursor/todo-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-tracker.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/todo-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAE9F,OAAO,EAAE,UAAU,EAAE,MAAM,8DAA8D,CAAC;AAE1F,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;AAE9D,MAAM,UAAU,GAA+B;IAC7C,OAAO,EAAE,UAAU,CAAC,YAAY;IAChC,WAAW,EAAE,UAAU,CAAC,gBAAgB;IACxC,UAAU,EAAE,UAAU,CAAC,gBAAgB;IACvC,SAAS,EAAE,UAAU,CAAC,cAAc;IACpC,SAAS,EAAE,UAAU,CAAC,cAAc;CACrC,CAAC;AASF,MAAM,OAAO,WAAW;IACL,KAAK,CAA8B;IAC5C,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,KAAkC;QAC5C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAiB;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO;QACvC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO;QAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO;QAEzC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAkC,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACxB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;QAClC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAE3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC;YAEhE,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEpD,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,cAAc,EAAE;gBACtC,EAAE;gBACF,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;gBAC1B,MAAM;gBACN,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG;gBACvD,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,OAAO,CAAC,GAAG,CACT,0BAA0B,QAAQ,CAAC,MAAM,iBAAiB,KAAK,CAAC,IAAI,WAAW,KAAK,GAAG,CACxF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,aAAa;QACX,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAEO,SAAS,CAAC,IAAa;QAC7B,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QAE9B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAA8C,CAAC;QACxD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,QAAQ;QACd,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}

package/dist/activities/execute-cursor/usage-accumulator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Accumulates per-turn token usage from Cursor SDK onDelta callbacks.
+ *
+ * Designed for the empty {@code turn-ended} handler in execute-cursor.ts.
+ * Each call to {@link addTurn} sums token counts and computes a running
+ * estimated cost from the cursor-runner's local pricing table.
+ *
+ * The snapshot is written to {@code AgentExecutionStatus.streaming_usage}
+ * on every heartbeat, giving the UI real-time streaming visibility.
+ *
+ * This data is display-only. The authoritative billing source is the
+ * BiDi proxy (CursorBidiStreamHandler) which will record usage from the
+ * wire via ProxyUsageReporter once traffic routing (Task 5B) is complete.
+ */
+export interface TurnUsage {
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly cacheReadTokens?: number;
+    readonly cacheWriteTokens?: number;
+}
+export interface UsageSnapshot {
+    readonly inputTokens: bigint;
+    readonly outputTokens: bigint;
+    readonly cacheReadTokens: bigint;
+    readonly cacheWriteTokens: bigint;
+    readonly totalTokens: bigint;
+    readonly turnCount: number;
+    readonly estimatedCostUsd: number;
+    readonly model: string;
+    readonly observedAt: string;
+}
+export interface TurnRecord {
+    readonly sequence: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+}
+export declare class UsageAccumulator {
+    private readonly model;
+    private inputTokens;
+    private outputTokens;
+    private cacheReadTokens;
+    private cacheWriteTokens;
+    private turnCount;
+    private estimatedCostUsd;
+    private observedAt;
+    private readonly turnRecords;
+    constructor(model: string);
+    addTurn(usage: TurnUsage): void;
+    get hasTurns(): boolean;
+    get modelName(): string;
+    turns(): readonly TurnRecord[];
+    snapshot(): UsageSnapshot;
+}

package/dist/activities/execute-cursor/usage-accumulator.js

@@ -0,0 +1,89 @@
+/**
+ * Accumulates per-turn token usage from Cursor SDK onDelta callbacks.
+ *
+ * Designed for the empty {@code turn-ended} handler in execute-cursor.ts.
+ * Each call to {@link addTurn} sums token counts and computes a running
+ * estimated cost from the cursor-runner's local pricing table.
+ *
+ * The snapshot is written to {@code AgentExecutionStatus.streaming_usage}
+ * on every heartbeat, giving the UI real-time streaming visibility.
+ *
+ * This data is display-only. The authoritative billing source is the
+ * BiDi proxy (CursorBidiStreamHandler) which will record usage from the
+ * wire via ProxyUsageReporter once traffic routing (Task 5B) is complete.
+ */
+import { getCursorModelPricing, computeTurnCost } from "./model-pricing.js";
+const EMPTY_SNAPSHOT = {
+    inputTokens: 0n,
+    outputTokens: 0n,
+    cacheReadTokens: 0n,
+    cacheWriteTokens: 0n,
+    totalTokens: 0n,
+    turnCount: 0,
+    estimatedCostUsd: 0,
+    model: "",
+    observedAt: "",
+};
+export class UsageAccumulator {
+    model;
+    inputTokens = 0;
+    outputTokens = 0;
+    cacheReadTokens = 0;
+    cacheWriteTokens = 0;
+    turnCount = 0;
+    estimatedCostUsd = 0;
+    observedAt = "";
+    turnRecords = [];
+    constructor(model) {
+        this.model = model;
+    }
+    addTurn(usage) {
+        const input = usage.inputTokens ?? 0;
+        const output = usage.outputTokens ?? 0;
+        const cacheRead = usage.cacheReadTokens ?? 0;
+        const cacheWrite = usage.cacheWriteTokens ?? 0;
+        this.inputTokens += input;
+        this.outputTokens += output;
+        this.cacheReadTokens += cacheRead;
+        this.cacheWriteTokens += cacheWrite;
+        this.turnCount++;
+        this.observedAt = new Date().toISOString();
+        this.turnRecords.push({
+            sequence: this.turnCount,
+            inputTokens: input,
+            outputTokens: output,
+            cacheReadTokens: cacheRead,
+            cacheWriteTokens: cacheWrite,
+        });
+        const pricing = getCursorModelPricing(this.model);
+        this.estimatedCostUsd += computeTurnCost(pricing, input, output, cacheWrite, cacheRead);
+    }
+    get hasTurns() {
+        return this.turnCount > 0;
+    }
+    get modelName() {
+        return this.model;
+    }
+    turns() {
+        return this.turnRecords;
+    }
+    snapshot() {
+        if (this.turnCount === 0)
+            return EMPTY_SNAPSHOT;
+        return {
+            inputTokens: BigInt(this.inputTokens),
+            outputTokens: BigInt(this.outputTokens),
+            cacheReadTokens: BigInt(this.cacheReadTokens),
+            cacheWriteTokens: BigInt(this.cacheWriteTokens),
+            totalTokens: BigInt(this.inputTokens +
+                this.outputTokens +
+                this.cacheReadTokens +
+                this.cacheWriteTokens),
+            turnCount: this.turnCount,
+            estimatedCostUsd: this.estimatedCostUsd,
+            model: this.model,
+            observedAt: this.observedAt,
+        };
+    }
+}
+//# sourceMappingURL=usage-accumulator.js.map

package/dist/activities/execute-cursor/usage-accumulator.js.map

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

package/dist/activities/execute-cursor/workspace-provision.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Local workspace provisioning for the Cursor harness.
+ *
+ * Cursor agents run LOCAL (cloud is disabled — see cursor-mode.ts), so the
+ * runner must clone git-repo workspace entries itself and mount local-path
+ * entries before the agent runs, mirroring the native harness. Cloud agents
+ * previously cloned git repos server-side; that path is no longer used.
+ */
+import type { Config } from "../../config.js";
+import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+/**
+ * Provision the session's workspace entries for a LOCAL Cursor agent.
+ *
+ * Clones git-repo entries (using the user's GITHUB_TOKEN from the resolved
+ * execution environment) and mounts local-path entries, then returns the
+ * directories the agent should operate in. Falls back to the configured
+ * workspace root when the session declares no workspace entries.
+ *
+ * provisionGit is idempotent (it reuses an existing clone), so this is safe
+ * to call on every execution, including multi-turn and HITL reinvocations.
+ */
+export declare function provisionCursorWorkspace(config: Config, session: Session, envVars: Record<string, string>, sessionId: string): Promise<string[]>;

package/dist/activities/execute-cursor/workspace-provision.js

@@ -0,0 +1,37 @@
+/**
+ * Local workspace provisioning for the Cursor harness.
+ *
+ * Cursor agents run LOCAL (cloud is disabled — see cursor-mode.ts), so the
+ * runner must clone git-repo workspace entries itself and mount local-path
+ * entries before the agent runs, mirroring the native harness. Cloud agents
+ * previously cloned git repos server-side; that path is no longer used.
+ */
+import { WorkspaceProvisioner } from "../../shared/workspace/provisioner.js";
+import { LocalWorkspaceBackend } from "../../shared/workspace/local-backend.js";
+import { ensurePlatformDir } from "../../shared/workspace/platform-dir.js";
+/**
+ * Provision the session's workspace entries for a LOCAL Cursor agent.
+ *
+ * Clones git-repo entries (using the user's GITHUB_TOKEN from the resolved
+ * execution environment) and mounts local-path entries, then returns the
+ * directories the agent should operate in. Falls back to the configured
+ * workspace root when the session declares no workspace entries.
+ *
+ * provisionGit is idempotent (it reuses an existing clone), so this is safe
+ * to call on every execution, including multi-turn and HITL reinvocations.
+ */
+export async function provisionCursorWorkspace(config, session, envVars, sessionId) {
+    const entries = session.spec?.workspaceEntries ?? [];
+    if (entries.length === 0) {
+        return [config.workspaceRootDir];
+    }
+    const platformDir = await ensurePlatformDir(sessionId);
+    const backend = new LocalWorkspaceBackend(config.workspaceRootDir, platformDir);
+    const provisioner = new WorkspaceProvisioner();
+    const results = await provisioner.provisionAll(entries.map((entry) => ({ name: entry.name, source: entry.source })), backend, envVars, config.mode === "local", config.mode !== "local");
+    const dirs = results
+        .map((result) => result.rootDir)
+        .filter((dir) => Boolean(dir));
+    return dirs.length > 0 ? dirs : [config.workspaceRootDir];
+}
+//# sourceMappingURL=workspace-provision.js.map

package/dist/activities/execute-cursor/workspace-provision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-provision.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/workspace-provision.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,OAAgB,EAChB,OAA+B,EAC/B,SAAiB;IAEjB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,gBAAgB,IAAI,EAAE,CAAC;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IAEhF,MAAM,WAAW,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,YAAY,CAC5C,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,EACpE,OAAO,EACP,OAAO,EACP,MAAM,CAAC,IAAI,KAAK,OAAO,EACvB,MAAM,CAAC,IAAI,KAAK,OAAO,CACxB,CAAC;IAEF,MAAM,IAAI,GAAG,OAAO;SACjB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;SAC/B,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAC5D,CAAC"}

package/dist/activities/execute-cursor/workspace-setup.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Writes Cursor hooks configuration and scripts to the workspace.
+ *
+ * Before creating or resuming a Cursor Agent, the cursor-runner writes:
+ * 1. .cursor/hooks.json — declares the preToolUse hook
+ * 2. .cursor/hooks/stigmer-approval.sh — the hook script
+ * 3. .cursor/hooks/stigmer-approval-state.json — approval state for the hook
+ * 4. .cursor/hooks/stigmer-denials.jsonl — per-turn denial ledger (reset here,
+ *    appended by the hook on each deny, read back by the activity)
+ *
+ * This setup enables the durable HITL model: the hook denies tools that need
+ * approval and records each denial to the ledger; the activity reads the ledger,
+ * marks the gated tool calls WAITING_APPROVAL (the backend then projects
+ * pending_approvals from that status), and returns to the workflow. On
+ * reinvocation the state file is updated with the approved tools so the hook
+ * allows them.
+ */
+import { type ApprovalStateFile } from "./approval-state.js";
+/**
+ * Write the complete hooks setup to the workspace directory.
+ *
+ * Creates or overwrites:
+ * - .cursor/hooks.json (hooks configuration)
+ * - .cursor/hooks/stigmer-approval.sh (hook script, executable)
+ * - .cursor/hooks/stigmer-approval-state.json (approval state)
+ */
+export declare function writeHooksToWorkspace(workspaceRoot: string, approvalState: ApprovalStateFile): Promise<void>;

package/dist/activities/execute-cursor/workspace-setup.js

@@ -0,0 +1,61 @@
+/**
+ * Writes Cursor hooks configuration and scripts to the workspace.
+ *
+ * Before creating or resuming a Cursor Agent, the cursor-runner writes:
+ * 1. .cursor/hooks.json — declares the preToolUse hook
+ * 2. .cursor/hooks/stigmer-approval.sh — the hook script
+ * 3. .cursor/hooks/stigmer-approval-state.json — approval state for the hook
+ * 4. .cursor/hooks/stigmer-denials.jsonl — per-turn denial ledger (reset here,
+ *    appended by the hook on each deny, read back by the activity)
+ *
+ * This setup enables the durable HITL model: the hook denies tools that need
+ * approval and records each denial to the ledger; the activity reads the ledger,
+ * marks the gated tool calls WAITING_APPROVAL (the backend then projects
+ * pending_approvals from that status), and returns to the workflow. On
+ * reinvocation the state file is updated with the approved tools so the hook
+ * allows them.
+ */
+import { writeFile, mkdir, chmod } from "node:fs/promises";
+import { join } from "node:path";
+import { generateHookScript } from "./hook-script.js";
+import { writeApprovalStateFile, resetDenialLedger } from "./approval-state.js";
+const HOOKS_DIR = ".cursor";
+const HOOKS_SCRIPTS_DIR = ".cursor/hooks";
+const HOOKS_CONFIG_FILE = "hooks.json";
+const HOOK_SCRIPT_FILE = "stigmer-approval.sh";
+/**
+ * Write the complete hooks setup to the workspace directory.
+ *
+ * Creates or overwrites:
+ * - .cursor/hooks.json (hooks configuration)
+ * - .cursor/hooks/stigmer-approval.sh (hook script, executable)
+ * - .cursor/hooks/stigmer-approval-state.json (approval state)
+ */
+export async function writeHooksToWorkspace(workspaceRoot, approvalState) {
+    const hooksDir = join(workspaceRoot, HOOKS_DIR);
+    const scriptsDir = join(workspaceRoot, HOOKS_SCRIPTS_DIR);
+    await mkdir(hooksDir, { recursive: true });
+    await mkdir(scriptsDir, { recursive: true });
+    const stateFilePath = await writeApprovalStateFile(workspaceRoot, approvalState);
+    // Reset the denial ledger for this turn (co-located with the state-file write
+    // so the runner only reads denials produced by the current run, even across
+    // HITL reinvocations on the durable workspace and Temporal activity retries).
+    const ledgerFilePath = await resetDenialLedger(workspaceRoot);
+    const hookScriptPath = join(scriptsDir, HOOK_SCRIPT_FILE);
+    await writeFile(hookScriptPath, generateHookScript(stateFilePath, ledgerFilePath), "utf-8");
+    await chmod(hookScriptPath, 0o755);
+    const hooksConfig = {
+        version: 1,
+        hooks: {
+            preToolUse: [
+                {
+                    command: `.cursor/hooks/${HOOK_SCRIPT_FILE}`,
+                    timeout: 10,
+                    failClosed: true,
+                },
+            ],
+        },
+    };
+    await writeFile(join(hooksDir, HOOKS_CONFIG_FILE), JSON.stringify(hooksConfig, null, 2), "utf-8");
+}
+//# sourceMappingURL=workspace-setup.js.map

package/dist/activities/execute-cursor/workspace-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-setup.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/workspace-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAA0B,MAAM,qBAAqB,CAAC;AAExG,MAAM,SAAS,GAAG,SAAS,CAAC;AAC5B,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAC1C,MAAM,iBAAiB,GAAG,YAAY,CAAC;AACvC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,aAAqB,EACrB,aAAgC;IAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAC1D,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAEjF,8EAA8E;IAC9E,4EAA4E;IAC5E,8EAA8E;IAC9E,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAE9D,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAC1D,MAAM,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5F,MAAM,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAEnC,MAAM,WAAW,GAAG;QAClB,OAAO,EAAE,CAAC;QACV,KAAK,EAAE;YACL,UAAU,EAAE;gBACV;oBACE,OAAO,EAAE,iBAAiB,gBAAgB,EAAE;oBAC5C,OAAO,EAAE,EAAE;oBACX,UAAU,EAAE,IAAI;iBACjB;aACF;SACF;KACF,CAAC;IAEF,MAAM,SAAS,CACb,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EACjC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EACpC,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/activities/execute-deep-agent/__test-utils__/v3-event-fixtures.d.ts

@@ -0,0 +1,71 @@
+/**
+ * V3 protocol event factories for normalizer and status builder tests.
+ *
+ * Shapes are derived from real recordings in /tmp/stigmer-v3-provider/
+ * captured during Phase 1 validation with Claude claude-sonnet-4-6.
+ */
+import type { V3ProtocolEvent } from "../v3-event-recorder.js";
+export declare function resetSeq(): void;
+export declare function makeProtocolEvent(method: string, data: unknown, opts?: {
+    seq?: number;
+    namespace?: string[];
+    node?: string;
+    timestamp?: number;
+}): V3ProtocolEvent;
+export declare function makeLifecycleRunning(graphName?: string): V3ProtocolEvent;
+export declare function makeLifecycleStarted(graphName: string, ns?: string[]): V3ProtocolEvent;
+export declare function makeLifecycleCompleted(graphName: string, ns?: string[]): V3ProtocolEvent;
+export declare function makeMessageStart(runId: string, opts?: {
+    messageId?: string;
+    namespace?: string[];
+    node?: string;
+    usage?: Record<string, unknown>;
+}): V3ProtocolEvent;
+export declare function makeMessageFinish(runId: string, opts?: {
+    reason?: string;
+    usage?: Record<string, unknown>;
+    namespace?: string[];
+    node?: string;
+    metadata?: Record<string, unknown>;
+}): V3ProtocolEvent;
+export declare function makeContentBlockStartText(runId: string, index?: number, opts?: {
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeTextDelta(runId: string, text: string, opts?: {
+    index?: number;
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeReasoningDelta(runId: string, text: string, opts?: {
+    index?: number;
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeToolCallArgDelta(runId: string, callId: string, args: string, opts?: {
+    index?: number;
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeContentBlockFinish(runId: string, index?: number, opts?: {
+    content?: unknown;
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeUsageEvent(runId: string, usage: Record<string, unknown>, opts?: {
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeProviderEvent(runId: string, provider: string, model: string, opts?: {
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeToolStarted(callId: string, toolName: string, input?: unknown, opts?: {
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeToolFinished(callId: string, output?: unknown, opts?: {
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeToolError(callId: string, message: string, opts?: {
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeToolOutputDelta(callId: string, delta: string, opts?: {
+    namespace?: string[];
+}): V3ProtocolEvent;
+export declare function makeCheckpointEvent(): V3ProtocolEvent;
+export declare function makeTasksEvent(): V3ProtocolEvent;
+export declare function makeValuesEvent(): V3ProtocolEvent;
+export declare function makeUpdatesEvent(node?: string): V3ProtocolEvent;