@euqns/nudge-mcp 1.36.0 → 1.38.0

package/README.md

@@ -680,6 +680,56 @@ Overrides are read at each job startup; already-running turns retain their
 existing settings. Do not repeat generated top-level model/auth keys in the
 TOML overrides. Desktop MCP servers remain isolated unless explicitly enabled.
 
+### T3 Code desktop runner threads
+
+When T3 Code is running on the runner's machine, new **Codex** jobs on macOS
+and Linux execute through T3 itself. Look for **Nudge · running · Board · task …**
+under the matching checkout's project. Open the thread to see the prompt,
+streaming responses, and tool activity in the conversation pane. Nudge receives
+the final answer and token usage, and updates the title with the job status.
+
+Nudge resumes and steers these jobs in the same T3 conversation. Cancelling or
+steering a job in Nudge interrupts its T3 turn. Keep using Nudge for job questions,
+review, and scheduling; T3's composer also operates the underlying conversation,
+but does not create or reopen a Nudge job. Completed conversations remain
+available for manual follow-ups in T3.
+
+The Codex bridge preserves the runner's Nudge MCP tools and sandbox: intake and
+question turns stay read-only, ordinary tasks use workspace-write, and jobs that
+explicitly need repository/network actions retain their existing access. T3 gets
+a separate Codex provider instance per conversation using Nudge's isolated Codex
+home. Job credentials live in an owner-only context under `~/.nudge/t3-native`,
+are removed when execution ends, and are never put in T3 titles or prompts.
+
+Claude, Cursor, Windows, and conversations originally started by an external CLI
+continue using the terminal log view. Their previous conversation IDs are kept
+with the original engine. Existing log-only threads and jobs already running
+are not converted or backfilled.
+
+Discovery reads `~/.t3/userdata/server-runtime.json` (or the `dev` variant) and
+only connects over loopback. On macOS it finds T3 Code or T3 Code (Nightly) in
+`/Applications` or `~/Applications`; other installs need a `t3` executable on
+the runner's `PATH`. The installed CLI issues an expiring local session and
+revokes it afterward (24 hours maximum for native execution, five minutes for
+status updates). T3 API credentials are held in memory. Windows gets the fallback
+thread and status updates, with its log saved locally.
+
+| Runner environment variable | Purpose |
+| --- | --- |
+| `NUDGE_T3=0` | Disable automatic T3 threads. |
+| `T3CODE_HOME=/path/to/.t3` | Find a nonstandard T3 data directory. |
+| `NUDGE_T3_CLI=/path/to/t3` | Use a specific installed T3 CLI or executable wrapper. |
+
+T3 must be open before the job starts. Missing T3 is silently skipped for new
+jobs. A native conversation must resume in its original T3 environment; if that
+environment is unavailable, the job reports an error. Once a native turn has
+been submitted, the runner never falls back to a second CLI agent. Verified
+against T3 Code Nightly `0.0.41-nightly.20260908.1400`; native execution requires
+its HTTP orchestration and provider settings RPC interfaces. Fallback JSONL
+logs are owner-only under `~/.nudge/t3-logs` and
+retain up to 8 MiB of live output per run, followed by its final result.
+They remain available after completion and can be removed when no longer needed.
+
 ### Runner output files
 
 A coding turn can optionally write the JSON manifest at the absolute path supplied

package/dist/runner-t3-codex-bridge.js

@@ -0,0 +1,101 @@
+// T3 owns the app-server connection. This transparent stdio bridge applies the
+// runner's MCP identity and sandbox to that connection, preserving native events.
+import { spawn } from "node:child_process";
+import { readFile, writeFile } from "node:fs/promises";
+import { createInterface } from "node:readline";
+import { fileURLToPath } from "node:url";
+import { bundledCodexCommand, companionCodexConfig, subscriptionEnvironment } from "./codex-companion.js";
+import { addUsage, emptyUsage } from "./engines/types.js";
+export function applyRunnerPolicy(message, context) {
+    if (!["thread/start", "thread/resume", "thread/fork", "turn/start"].includes(message.method))
+        return message;
+    const params = { ...message.params, approvalPolicy: "never", approvalsReviewer: "user" };
+    if (message.method === "turn/start") {
+        params.sandboxPolicy = { type: context.sandbox === "read-only" ? "readOnly"
+                : context.sandbox === "workspace-write" ? "workspaceWrite" : "dangerFullAccess" };
+    }
+    else {
+        const config = companionCodexConfig(context.env);
+        params.sandbox = context.sandbox;
+        params.config = { ...params.config, model_provider: config.model_provider, "mcp_servers.nudge": config.mcp_servers.nudge };
+    }
+    return { ...message, params };
+}
+export function usageDelta(previous, current, last) {
+    const keys = ["inputTokens", "outputTokens", "cachedInputTokens", "reasoningTokens"];
+    if (!previous || keys.some((key) => (current[key] ?? 0) < (previous[key] ?? 0)))
+        return last;
+    return Object.fromEntries(keys.map((key) => [key, (current[key] ?? 0) - (previous[key] ?? 0)]));
+}
+export async function runBridge() {
+    let context;
+    if (process.env.NUDGE_T3_CONTEXT) {
+        try {
+            context = JSON.parse(await readFile(process.env.NUDGE_T3_CONTEXT, "utf8"));
+        }
+        catch (error) {
+            // A completed job removes its identity. Manual T3 follow-ups still work,
+            // using the normal T3 policy and no credentials from the finished job.
+            if (error.code !== "ENOENT")
+                throw new Error("Cannot read Nudge T3 job context");
+        }
+    }
+    const invocation = bundledCodexCommand(...process.argv.slice(2));
+    const child = spawn(invocation.command, invocation.args, {
+        env: subscriptionEnvironment(process.env), stdio: ["pipe", "pipe", "inherit"],
+    });
+    const input = createInterface({ input: process.stdin });
+    input.on("line", (line) => {
+        try {
+            child.stdin.write(context ? JSON.stringify(applyRunnerPolicy(JSON.parse(line), context)) + "\n" : line + "\n");
+        }
+        catch {
+            child.kill();
+            process.exitCode = 1;
+        }
+    });
+    input.on("close", () => child.stdin.end());
+    child.stdin.on("error", () => undefined);
+    // Keep complete native notifications, including tool calls and assistant deltas.
+    // Record usage separately because the public thread read model omits it.
+    const output = createInterface({ input: child.stdout });
+    let usageWrite = Promise.resolve();
+    const baselineByThread = new Map();
+    let runUsage = emptyUsage();
+    output.on("line", (line) => {
+        process.stdout.write(line + "\n");
+        if (!context)
+            return;
+        try {
+            const event = JSON.parse(line);
+            if (event.method !== "thread/tokenUsage/updated")
+                return;
+            const last = event.params?.tokenUsage?.last;
+            if (!last || typeof event.params.turnId !== "string")
+                return;
+            const total = event.params.tokenUsage.total;
+            const normalize = (value) => ({
+                inputTokens: value.inputTokens ?? 0, outputTokens: value.outputTokens ?? 0,
+                cachedInputTokens: value.cachedInputTokens ?? 0, reasoningTokens: value.reasoningOutputTokens ?? 0,
+            });
+            const current = normalize(total);
+            runUsage = addUsage(runUsage, usageDelta(baselineByThread.get(event.params.threadId), current, normalize(last)));
+            baselineByThread.set(event.params.threadId, current);
+            const target = context.usagePath;
+            const serialized = JSON.stringify(runUsage);
+            usageWrite = usageWrite.then(() => writeFile(target, serialized, { mode: 0o600 })).catch(() => undefined);
+        }
+        catch { /* The provider stream is forwarded unchanged. */ }
+    });
+    for (const signal of ["SIGINT", "SIGTERM"])
+        process.on(signal, () => child.kill(signal));
+    await new Promise((resolve, reject) => {
+        child.once("error", () => reject(new Error("Could not start Codex for T3")));
+        child.once("close", (code) => { process.exitCode = code ?? 1; input.close(); resolve(); });
+    });
+    await usageWrite;
+}
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    runBridge().catch(() => { process.stderr.write("Nudge T3 Codex bridge failed\n"); process.exitCode = 1; });
+}
+//# sourceMappingURL=runner-t3-codex-bridge.js.map

package/dist/runner-t3-codex-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-t3-codex-bridge.js","sourceRoot":"","sources":["../src/runner-t3-codex-bridge.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kFAAkF;AAClF,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC1G,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAoB,MAAM,oBAAoB,CAAC;AAQ5E,MAAM,UAAU,iBAAiB,CAAC,OAA4B,EAAE,OAAsB;IACpF,IAAI,CAAC,CAAC,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAC7G,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACzF,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACpC,MAAM,CAAC,aAAa,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU;gBACzE,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACjC,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC7H,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAiC,EAAE,OAAoB,EAAE,IAAiB;IACnG,MAAM,IAAI,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,iBAAiB,CAAU,CAAC;IAC9F,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7F,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAgB,CAAC;AACjH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,OAAkC,CAAC;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACjC,IAAI,CAAC;YAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;QAAC,CAAC;QACnF,OAAO,KAAK,EAAE,CAAC;YACb,yEAAyE;YACzE,uEAAuE;YACvE,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE;QACvD,GAAG,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;KAC9E,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,CAAC;YAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAAC,CAAC;QACvH,MAAM,CAAC;YAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACzC,iFAAiF;IACjF,yEAAyE;IACzE,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,IAAI,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IACnC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuB,CAAC;IACxD,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,2BAA2B;gBAAE,OAAO;YACzD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC;YAC5C,IAAI,CAAC,IAAI,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO;YAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;YAC5C,MAAM,SAAS,GAAG,CAAC,KAA6B,EAAe,EAAE,CAAC,CAAC;gBACjE,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;gBAC1E,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,qBAAqB,IAAI,CAAC;aACnG,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YACjC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjH,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;YACjC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC5C,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5G,CAAC;QAAC,MAAM,CAAC,CAAC,iDAAiD,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU;QAAE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAClG,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IACH,MAAM,UAAU,CAAC;AACnB,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACvD,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7G,CAAC"}

package/dist/runner-t3-engine.js

@@ -0,0 +1,243 @@
+import { randomUUID } from "node:crypto";
+import { access, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import os from "node:os";
+import path from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+import { fileURLToPath } from "node:url";
+import { acquireInstallationLock } from "./runner-installation.js";
+import { codexSandboxMode } from "./engines/codex.js";
+import { ensureCodexShadowHome } from "./engines/isolation.js";
+import { estimateCostUsd } from "./engines/pricing.js";
+import { emptyUsage } from "./engines/types.js";
+import { discoverT3, ensureT3JobThread, shellQuote, t3JobThreadId, t3JobTitle, withT3Client } from "./runner-t3.js";
+const DIRECTORY = path.join(os.homedir(), ".nudge", "t3-native");
+const PREFIX = "t3:";
+export function t3ResumeId(environmentId, threadId) {
+    return `${PREFIX}${encodeURIComponent(environmentId)}:${encodeURIComponent(threadId)}`;
+}
+export function parseT3ResumeId(value) {
+    if (!value?.startsWith(PREFIX))
+        return null;
+    const parts = value.split(":");
+    if (parts.length !== 3 || !parts[1] || !parts[2])
+        throw new Error("Invalid T3 conversation reference");
+    const threadId = decodeURIComponent(parts[2]);
+    if (!/^nudge-[a-f0-9]{32}$/.test(threadId))
+        throw new Error("Invalid T3 runner thread ID");
+    return { environmentId: decodeURIComponent(parts[1]), threadId };
+}
+// server.updateSettings replaces the provider map. Serialize Nudge's read/merge/
+// write across runner processes and preserve every unrelated (redacted) entry.
+async function settingsLock(use) {
+    await mkdir(DIRECTORY, { recursive: true, mode: 0o700 });
+    const release = await acquireInstallationLock(path.join(DIRECTORY, "settings"), { timeoutMs: 15_000, retryMs: 100 });
+    try {
+        return await use();
+    }
+    finally {
+        await release();
+    }
+}
+async function configureProvider(client, threadId, contextPath) {
+    const home = await ensureCodexShadowHome();
+    let bridge = fileURLToPath(new URL("./runner-t3-codex-bridge.js", import.meta.url));
+    const args = [];
+    try {
+        await access(bridge);
+    }
+    catch {
+        bridge = fileURLToPath(new URL("./runner-t3-codex-bridge.ts", import.meta.url));
+        args.push("--import", createRequire(import.meta.url).resolve("tsx"));
+    }
+    const executable = path.join(DIRECTORY, "codex");
+    await writeFile(executable, `#!/bin/sh\nexec ${[process.execPath, ...args, bridge].map(shellQuote).join(" ")} "$@"\n`, { mode: 0o700 });
+    const instanceId = `nudge-${threadId}`;
+    await settingsLock(async () => {
+        const settings = await client.rpc("server.getSettings");
+        const instance = {
+            driver: "codex", displayName: "Nudge runner", enabled: true,
+            environment: [{ name: "NUDGE_T3_CONTEXT", value: contextPath, sensitive: false }],
+            config: { binaryPath: executable, homePath: home.path, shadowHomePath: "", launchArgs: "", customModels: [], enabled: true },
+        };
+        if (JSON.stringify(settings.providerInstances?.[instanceId]) !== JSON.stringify(instance)) {
+            await client.rpc("server.updateSettings", { patch: { providerInstances: { ...settings.providerInstances, [instanceId]: instance } } });
+        }
+    });
+    return instanceId;
+}
+export async function runT3Turn(client, threadId, modelSelection, options, pollMs = 1_000) {
+    const route = `/api/orchestration/threads/${encodeURIComponent(threadId)}`;
+    const detail = async () => (await client.request(route)).thread;
+    const before = await detail();
+    const previousTurnId = before.latestTurn?.turnId;
+    const commandId = randomUUID();
+    const messageId = randomUUID();
+    const createdAt = new Date().toISOString();
+    let dispatched = false;
+    let turnId;
+    const seenMessages = new Map();
+    const seenActivities = new Set((before.activities ?? []).map((a) => a.id));
+    let lastContact = Date.now();
+    let dispatchError;
+    try {
+        options.signal.throwIfAborted();
+        if (before.latestTurn?.state === "running") {
+            // Recover an in-flight turn after a runner restart. Never launch another
+            // agent alongside work already owned by this job's native thread.
+            turnId = previousTurnId;
+            dispatched = true;
+            options.log("event", "Reattached to the running T3 Code turn.");
+        }
+        else {
+            dispatched = true; // A timed-out POST may already have committed.
+            await client.dispatch({
+                type: "thread.turn.start", commandId, threadId,
+                message: { messageId, role: "user", text: options.prompt, attachments: [] },
+                modelSelection, runtimeMode: runtimeMode(options), interactionMode: "default", createdAt,
+            }).catch((error) => { dispatchError = error; });
+        }
+        for (;;) {
+            options.signal.throwIfAborted();
+            let thread;
+            try {
+                thread = await detail();
+                lastContact = Date.now();
+            }
+            catch {
+                if (Date.now() - lastContact > 30_000)
+                    throw new Error("Lost connection to T3 Code. The conversation remains in T3; no CLI fallback was started.");
+                await delay(pollMs, undefined, { signal: options.signal });
+                continue;
+            }
+            const turn = thread.latestTurn;
+            if (!turnId && turn && turn.turnId !== previousTurnId)
+                turnId = turn.turnId;
+            // The public projection may take a moment to reflect accepted commands.
+            if (!turnId) {
+                if (thread.session?.status === "error" && thread.session.updatedAt >= createdAt)
+                    throw new Error(thread.session.lastError || "T3 could not start the provider");
+                if (Date.now() - Date.parse(createdAt) > 30_000)
+                    throw new Error(dispatchError
+                        ? "T3 did not confirm the turn start. Inspect the thread before retrying."
+                        : "T3 did not start the provider within 30 seconds");
+            }
+            else {
+                if (turn && turn.turnId !== turnId)
+                    throw new Error("The T3 conversation advanced to another turn. Inspect its result before retrying the job.");
+                for (const activity of thread.activities ?? []) {
+                    if (seenActivities.has(activity.id))
+                        continue;
+                    seenActivities.add(activity.id);
+                    if (activity.summary)
+                        options.log("event", activity.summary);
+                }
+                for (const message of thread.messages ?? []) {
+                    if (message.role !== "assistant" || message.turnId !== turnId || !message.text)
+                        continue;
+                    const previous = seenMessages.get(message.id) ?? "";
+                    if (message.text !== previous) {
+                        options.log("stdout", message.text.startsWith(previous) ? message.text.slice(previous.length) : message.text);
+                        seenMessages.set(message.id, message.text);
+                    }
+                }
+                if (turn?.turnId === turnId && turn.state !== "running") {
+                    const messages = (thread.messages ?? []).filter((m) => m.role === "assistant" && m.turnId === turnId);
+                    const summary = messages.find((m) => m.id === turn.assistantMessageId)?.text ?? messages.at(-1)?.text ?? "";
+                    return {
+                        summary, usage: emptyUsage(), costBasis: "subscription", resolvedModel: options.model ?? undefined,
+                        ...(turn.state !== "completed" ? { error: thread.session?.lastError || `T3 turn ${turn.state}` } : {}),
+                    };
+                }
+            }
+            await delay(pollMs, undefined, { signal: options.signal });
+        }
+    }
+    finally {
+        if (dispatched) {
+            // Also stop a completed session: the next resume starts with fresh job
+            // credentials and cannot retain a stale runner token or sandbox policy.
+            if (options.signal.aborted || dispatchError) {
+                await client.dispatch({ type: "thread.turn.interrupt", threadId, ...(turnId ? { turnId } : {}), createdAt: new Date().toISOString() }).catch(() => undefined);
+            }
+            await client.dispatch({ type: "thread.session.stop", threadId, createdAt: new Date().toISOString() })
+                .catch(() => options.log("event", "Could not stop the T3 session. Check its thread before starting another run."));
+        }
+    }
+}
+function runtimeMode(options) {
+    return options.readOnly ? "approval-required" : codexSandboxMode(options) === "danger-full-access" ? "full-access" : "auto";
+}
+export async function createT3Engine(fallback, job, previousThreadId, warn) {
+    const resumed = parseT3ResumeId(previousThreadId);
+    if (resumed && (fallback.id !== "codex" || process.platform === "win32")) {
+        throw new Error("This T3 conversation requires the Codex runner on macOS or Linux");
+    }
+    // Raw CLI session IDs are not T3 IDs. Preserve their history via the original
+    // engine; newly started native conversations resume through T3 from then on.
+    if (!resumed && (fallback.id !== "codex" || previousThreadId || process.platform === "win32"))
+        return null;
+    let connection;
+    try {
+        connection = await discoverT3();
+    }
+    catch (error) {
+        if (resumed)
+            throw error;
+        warn("T3 Code is unavailable; using the local runner.");
+        return null;
+    }
+    if (!connection) {
+        if (resumed)
+            throw new Error("Open the local T3 Code app to resume this job's conversation");
+        return null;
+    }
+    if (resumed && resumed.environmentId !== connection.environmentId)
+        throw new Error("This job belongs to a different T3 Code environment");
+    const threadId = resumed?.threadId ?? t3JobThreadId(job.deployment, job.id);
+    const reference = t3ResumeId(connection.environmentId, threadId);
+    const view = {
+        threadId, logPath: "", log() { },
+        async finish(status) {
+            await withT3Client(connection, (client) => client.dispatch({ type: "thread.meta.update", threadId, title: t3JobTitle(job, status) }))
+                .catch(() => warn("T3 thread status could not be updated."));
+        },
+    };
+    const engine = {
+        id: fallback.id, displayName: `${fallback.displayName} in T3 Code`, detect: () => fallback.detect(),
+        execute: (options) => withT3Client(connection, async (client) => {
+            options.signal.throwIfAborted();
+            await mkdir(DIRECTORY, { recursive: true, mode: 0o700 });
+            // Only opaque paths go into T3 settings. Runner credentials remain in an
+            // owner-only temporary context and never appear in titles or prompts.
+            const contextPath = path.join(DIRECTORY, `${threadId}.json`);
+            const usagePath = path.join(DIRECTORY, `${threadId}.usage.json`);
+            if (resumed)
+                await client.request(`/api/orchestration/threads/${encodeURIComponent(threadId)}`);
+            const instanceId = await configureProvider(client, threadId, contextPath);
+            const modelSelection = { instanceId, model: options.model ?? job.model,
+                ...(options.effort ? { options: [{ id: "reasoningEffort", value: options.effort }] } : {}) };
+            await ensureT3JobThread(client, job, { threadId, modelSelection, runtimeMode: runtimeMode(options) });
+            options.onThreadId?.(reference);
+            options.log("event", "Running in T3 Code. Open the Nudge thread to see messages and tool activity.");
+            await writeFile(contextPath, JSON.stringify({ env: options.env, sandbox: codexSandboxMode(options), usagePath }), { mode: 0o600 });
+            await rm(usagePath, { force: true });
+            try {
+                const result = await runT3Turn(client, threadId, modelSelection, options);
+                let usage = emptyUsage();
+                try {
+                    usage = JSON.parse(await readFile(usagePath, "utf8"));
+                }
+                catch { /* Provider may fail before reporting usage. */ }
+                const costUsd = estimateCostUsd(options.model ?? job.model, usage);
+                return { ...result, threadId: reference, usage, ...(costUsd != null ? { costUsd, costBasis: "estimated" } : {}) };
+            }
+            finally {
+                await rm(contextPath, { force: true });
+                await rm(usagePath, { force: true });
+            }
+        }, "24h"),
+    };
+    return { engine, view };
+}
+//# sourceMappingURL=runner-t3-engine.js.map

package/dist/runner-t3-engine.js.map

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

package/dist/runner-t3-engine.test.js

@@ -0,0 +1,121 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { applyRunnerPolicy, usageDelta } from "./runner-t3-codex-bridge.js";
+import { createT3Engine, parseT3ResumeId, runT3Turn, t3ResumeId } from "./runner-t3-engine.js";
+import { T3Client, t3JobThreadId } from "./runner-t3.js";
+const options = () => ({ cwd: "/tmp", prompt: "New work", readOnly: true, signal: new AbortController().signal, log() { } });
+const context = { env: { NUDGE_RUNNER_JOB: "job-a", NUDGE_RUNNER_TOKEN: "private-token" }, sandbox: "read-only", usagePath: "/tmp/unused" };
+class FakeT3 extends T3Client {
+    commands = [];
+    snapshots;
+    commitThenTimeout = false;
+    afterRead;
+    constructor(snapshots) { super("http://127.0.0.1", "test"); this.snapshots = snapshots; }
+    async request() {
+        const thread = this.snapshots.length > 1 ? this.snapshots.shift() : this.snapshots[0];
+        this.afterRead?.();
+        return { thread };
+    }
+    async dispatch(command) {
+        this.commands.push(command);
+        if (this.commitThenTimeout && command.type === "thread.turn.start")
+            throw new Error("timeout after commit");
+        return {};
+    }
+}
+const previous = { latestTurn: { turnId: "old", state: "completed" }, messages: [{ id: "old-answer", role: "assistant", turnId: "old", text: "Old answer" }] };
+const completed = { latestTurn: { turnId: "new", state: "completed", assistantMessageId: "final" }, messages: [
+        ...previous.messages,
+        { id: "progress", role: "assistant", turnId: "new", text: "Working" },
+        { id: "final", role: "assistant", turnId: "new", text: "Finished new work" },
+    ] };
+test("native execution submits a real user message and returns only the new turn's final answer", async () => {
+    const client = new FakeT3([previous, completed]);
+    const result = await runT3Turn(client, "thread", { instanceId: "nudge", model: "model" }, options(), 1);
+    assert.equal(result.summary, "Finished new work");
+    assert.deepEqual(client.commands.map((c) => c.type), ["thread.turn.start", "thread.session.stop"]);
+    assert.deepEqual(client.commands[0].message, { messageId: client.commands[0].message.messageId, role: "user", text: "New work", attachments: [] });
+    assert.equal(client.commands[0].threadId, "thread");
+});
+test("an ambiguous start response never starts a duplicate turn", async () => {
+    const client = new FakeT3([previous, completed]);
+    client.commitThenTimeout = true;
+    assert.equal((await runT3Turn(client, "thread", {}, options(), 1)).summary, "Finished new work");
+    assert.equal(client.commands.filter((c) => c.type === "thread.turn.start").length, 1);
+});
+test("runner recovery reattaches to an existing running turn without dispatching another", async () => {
+    const client = new FakeT3([{ latestTurn: { turnId: "new", state: "running" } }, completed]);
+    assert.equal((await runT3Turn(client, "thread", {}, options(), 1)).summary, "Finished new work");
+    assert.deepEqual(client.commands.map((c) => c.type), ["thread.session.stop"]);
+});
+test("steering or cancellation interrupts and stops T3 before propagating the abort", async () => {
+    const abort = new AbortController();
+    const client = new FakeT3([previous, { latestTurn: { turnId: "new", state: "running" } }]);
+    let reads = 0;
+    client.afterRead = () => { if (++reads === 2)
+        abort.abort(); };
+    await assert.rejects(runT3Turn(client, "thread", {}, { ...options(), signal: abort.signal }, 1), { name: "AbortError" });
+    assert.deepEqual(client.commands.map((c) => c.type), ["thread.turn.start", "thread.turn.interrupt", "thread.session.stop"]);
+});
+test("a pre-aborted job starts no T3 turn", async () => {
+    const client = new FakeT3([previous]);
+    await assert.rejects(runT3Turn(client, "thread", {}, { ...options(), signal: AbortSignal.abort() }, 1));
+    assert.equal(client.commands.length, 0);
+});
+test("provider errors and interruption cannot be reported as success", async () => {
+    for (const state of ["error", "interrupted"]) {
+        const client = new FakeT3([previous, { ...completed, latestTurn: { ...completed.latestTurn, state }, session: { lastError: "Provider stopped" } }]);
+        assert.equal((await runT3Turn(client, "thread", {}, options(), 1)).error, "Provider stopped");
+    }
+});
+test("runner references preserve T3 environment and reject paths or raw CLI IDs", () => {
+    const threadId = t3JobThreadId("deployment", "job");
+    assert.deepEqual(parseT3ResumeId(t3ResumeId("environment", threadId)), { environmentId: "environment", threadId });
+    assert.equal(parseT3ResumeId("codex-session"), null);
+    assert.throws(() => parseT3ResumeId("t3:environment:..%2Fprivate"));
+    assert.throws(() => parseT3ResumeId("t3:broken"));
+});
+test("a native resume with T3 disabled fails instead of falling back to a new CLI session", async () => {
+    const prior = process.env.NUDGE_T3;
+    process.env.NUDGE_T3 = "0";
+    try {
+        const fallback = { id: "codex" };
+        assert.equal(await createT3Engine(fallback, {}, null, () => { }), null);
+        await assert.rejects(createT3Engine(fallback, {}, t3ResumeId("env", t3JobThreadId("d", "j")), () => { }), /Open the local T3/);
+        assert.equal(await createT3Engine(fallback, {}, "original-cli-session", () => { }), null);
+    }
+    finally {
+        if (prior === undefined)
+            delete process.env.NUDGE_T3;
+        else
+            process.env.NUDGE_T3 = prior;
+    }
+});
+test("the bridge enforces read-only and Nudge identity on both start and resume", () => {
+    for (const method of ["thread/start", "thread/resume", "thread/fork"]) {
+        const message = applyRunnerPolicy({ id: 7, method, params: { sandbox: "danger-full-access", config: { existing: true } } }, context);
+        assert.equal(message.params.sandbox, "read-only");
+        assert.equal(message.params.approvalPolicy, "never");
+        assert.equal(message.params.config.existing, true);
+        assert.deepEqual(message.params.config["mcp_servers.nudge"].env, context.env);
+    }
+    const turn = applyRunnerPolicy({ method: "turn/start", params: { sandboxPolicy: { type: "dangerFullAccess" } } }, context);
+    assert.deepEqual(turn.params.sandboxPolicy, { type: "readOnly" });
+    assert.equal(turn.params.approvalPolicy, "never");
+    const notification = { method: "initialize", params: { clientInfo: { name: "T3" } } };
+    assert.equal(applyRunnerPolicy(notification, context), notification);
+});
+test("task sandbox choices retain workspace-only and explicitly remote-capable execution", () => {
+    for (const [sandbox, type] of [["workspace-write", "workspaceWrite"], ["danger-full-access", "dangerFullAccess"]]) {
+        assert.deepEqual(applyRunnerPolicy({ method: "turn/start" }, { ...context, sandbox }).params.sandboxPolicy, { type });
+    }
+});
+test("usage counts only the new work on resume, deduplicates totals, and handles a reset", () => {
+    const total = { inputTokens: 1000, outputTokens: 100 };
+    const last = { inputTokens: 50, outputTokens: 5 };
+    assert.deepEqual(usageDelta(undefined, total, last), last);
+    assert.equal(usageDelta(total, total, last).inputTokens, 0);
+    assert.equal(usageDelta(total, { inputTokens: 1100, outputTokens: 110 }, last).inputTokens, 100);
+    assert.deepEqual(usageDelta(total, last, last), last);
+});
+//# sourceMappingURL=runner-t3-engine.test.js.map

package/dist/runner-t3-engine.test.js.map

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

package/dist/runner-t3-log-viewer.js

@@ -0,0 +1,44 @@
+// Invoked in a T3 terminal. The JSONL file is data, never shell input.
+import { open, stat } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+export function safeTerminalText(text) {
+    // Strip controls including ESC, OSC and C1 so agent output cannot issue
+    // terminal/clipboard commands. Preserve readable tabs and line breaks.
+    return text.replace(/[\x00-\x08\x0b-\x1f\x7f-\x9f]/g, "");
+}
+export async function viewRunnerLog(file) {
+    let offset = 0;
+    let pending = "";
+    const decoder = new TextDecoder();
+    for (;;) {
+        const handle = await open(file, "r");
+        let bytesRead;
+        try {
+            const buffer = Buffer.alloc(64 * 1024);
+            ({ bytesRead } = await handle.read(buffer, 0, buffer.length, offset));
+            offset += bytesRead;
+            pending += decoder.decode(buffer.subarray(0, bytesRead), { stream: true });
+        }
+        finally {
+            await handle.close();
+        }
+        let end;
+        while ((end = pending.indexOf("\n")) >= 0) {
+            const entry = JSON.parse(pending.slice(0, end));
+            pending = pending.slice(end + 1);
+            process.stdout.write(safeTerminalText(String(entry.text ?? "")));
+            if (entry.done)
+                return;
+        }
+        if (!bytesRead) {
+            // A crashed runner must not leave a viewer alive indefinitely.
+            if (Date.now() - (await stat(file)).mtimeMs > 24 * 60 * 60 * 1000)
+                return;
+            await new Promise((resolve) => setTimeout(resolve, 500));
+        }
+    }
+}
+if (process.argv[1] === fileURLToPath(import.meta.url) && process.argv[2]) {
+    viewRunnerLog(process.argv[2]).catch(() => { console.error("Nudge runner log is unavailable."); process.exitCode = 1; });
+}
+//# sourceMappingURL=runner-t3-log-viewer.js.map

package/dist/runner-t3-log-viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-t3-log-viewer.js","sourceRoot":"","sources":["../src/runner-t3-log-viewer.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,wEAAwE;IACxE,uEAAuE;IACvE,OAAO,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,SAAS,CAAC;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrC,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;YACvC,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YACtE,MAAM,IAAI,SAAS,CAAC;YACpB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC;gBAAS,CAAC;YAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QACnC,IAAI,GAAW,CAAC;QAChB,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAChD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjE,IAAI,KAAK,CAAC,IAAI;gBAAE,OAAO;QACzB,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,+DAA+D;YAC/D,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;gBAAE,OAAO;YAC1E,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3H,CAAC"}