@zaip-ai/cli 4.2.0 → 4.4.0

package/dist/services/codex-config-overlay.js

@@ -0,0 +1,161 @@
+import { createHash } from "node:crypto";
+const HEADER = /^# zaip-managed generated-do-not-edit source=codex-config [^\r\n]*\r?\n/;
+const BEGIN = "# zaip-managed begin agent-registrations";
+const END = "# zaip-managed end agent-registrations";
+/** Locate only real TOML headers/comments, never text inside multiline strings. */
+function lines(text) {
+    const result = [];
+    let multiline = null;
+    let start = 0;
+    for (const raw of text.match(/[^\n]*(?:\n|$)/g) ?? []) {
+        if (!raw)
+            continue;
+        result.push({ text: raw.trim(), start, end: start + raw.length, outside: multiline === null });
+        for (let i = 0; i < raw.length; i++) {
+            if (multiline !== null) {
+                if (multiline === '"""' && raw[i] === "\\") {
+                    i++;
+                    continue;
+                }
+                if (raw.startsWith(multiline, i)) {
+                    i += 2;
+                    multiline = null;
+                }
+            }
+            else if (raw[i] === "#")
+                break;
+            else if (raw[i] === '"' || raw[i] === "'") {
+                const quote = raw[i];
+                if (raw.startsWith(quote.repeat(3), i)) {
+                    multiline = quote.repeat(3);
+                    i += 2;
+                }
+                else
+                    for (i++; i < raw.length; i++) {
+                        if (quote === '"' && raw[i] === "\\")
+                            i++;
+                        else if (raw[i] === quote)
+                            break;
+                    }
+            }
+        }
+        start += raw.length;
+    }
+    return result;
+}
+function sections(text) {
+    const headers = lines(text).filter((line) => line.outside && /^\[.+\]\s*(?:#.*)?$/.test(line.text));
+    return headers.map((line, index) => {
+        const end = headers[index + 1]?.start ?? text.length;
+        return { header: line.text.replace(/\s+#.*$/, ""), start: line.start, end, text: text.slice(line.start, end) };
+    });
+}
+function registrationRange(text) {
+    const source = lines(text).filter((line) => line.outside);
+    const starts = source.filter((line) => line.text === BEGIN);
+    const ends = source.filter((line) => line.text === END);
+    if (!starts.length && !ends.length)
+        return null;
+    if (starts.length !== 1 || ends.length !== 1 || (starts[0]?.start ?? 0) >= (ends[0]?.start ?? 0)) {
+        throw new Error("Ambiguous managed Codex agent registration block");
+    }
+    return { start: starts[0]?.start ?? 0, end: ends[0]?.end ?? text.length };
+}
+function managedHook(section) {
+    return lines(section.text).some((line) => line.outside &&
+        /^command\s*=/.test(line.text) &&
+        /[\\/]zaip-(?:pre-tool-use|conversation-lifecycle|subagent-lifecycle)\.mjs/.test(line.text));
+}
+/** Refresh owned hook entries, retaining third-party entries even in the same hook group. */
+function refreshHooks(current, generated) {
+    const expected = sections(generated);
+    const replacements = new Map();
+    for (let i = 0; i < expected.length; i++) {
+        const section = expected[i];
+        if (section && /^\[\[hooks\.[\w]+\]\]$/.test(section.header) &&
+            expected[i + 1] && managedHook(expected[i + 1])) {
+            replacements.set(section.header, section.text + expected[i + 1]?.text);
+        }
+    }
+    const source = sections(current);
+    const changes = [];
+    const seen = new Set();
+    for (let i = 0; i < source.length; i++) {
+        const parent = source[i];
+        if (!parent || !replacements.has(parent.header))
+            continue;
+        const childHeader = `${parent.header.slice(0, -2)}.hooks]]`;
+        const children = [];
+        while (source[i + 1]?.header === childHeader)
+            children.push(source[++i]);
+        const owned = children.filter(managedHook);
+        if (!owned.length)
+            continue;
+        const thirdParty = children.filter((child) => !managedHook(child));
+        const replacement = seen.has(parent.header) ? "" : replacements.get(parent.header) ?? "";
+        seen.add(parent.header);
+        changes.push({ start: parent.start, end: children.at(-1)?.end ?? parent.end,
+            text: (thirdParty.length ? parent.text + thirdParty.map((child) => child.text).join("") : "") + replacement });
+    }
+    for (const change of changes.reverse())
+        current = current.slice(0, change.start) + change.text + current.slice(change.end);
+    const missing = [...replacements].filter(([header]) => !seen.has(header)).map(([, text]) => text);
+    if (missing.length)
+        current = `${current.trimEnd()}\n\n${missing.join("")}`;
+    return current;
+}
+function enableHooks(current) {
+    const section = sections(current).find((section) => section.header === "[features]");
+    if (!section)
+        return `${current.trimEnd()}\n\n[features]\nhooks = true\n`;
+    const setting = lines(section.text).find((line) => line.outside && /^hooks\s*=/.test(line.text));
+    if (setting) {
+        if (!/^hooks\s*=\s*true\s*(?:#.*)?$/.test(setting.text)) {
+            throw new Error("Codex hooks are explicitly disabled or ambiguous; preserve the user's setting and resolve it before installing ZAIP hooks");
+        }
+        return current;
+    }
+    const newline = current.indexOf("\n", section.start);
+    const headerEnd = newline === -1 ? current.length : newline + 1;
+    return current.slice(0, headerEnd) + (newline === -1 ? "\n" : "") + "hooks = true\n" + current.slice(headerEnd);
+}
+/** A whole-file marker proves ownership only while its checksum still matches. */
+export function isUnchangedCodexConfig(content) {
+    const header = content.match(HEADER)?.[0];
+    const digest = header?.match(/\bsha256=([a-f0-9]{64})\b/)?.[1];
+    return header !== undefined && digest !== undefined &&
+        createHash("sha256").update(content.slice(header.length)).digest("hex") === digest;
+}
+export function reconcileCodexConfig(current, generated, registerAgents = true) {
+    if (isUnchangedCodexConfig(current))
+        return generated;
+    const marked = HEADER.test(current);
+    // An overlay must not retain a generated-do-not-edit/checksum claim about user content.
+    let result = current.replace(HEADER, "");
+    const existingRange = registrationRange(result);
+    const expectedRange = registrationRange(generated);
+    if (expectedRange && (marked || registerAgents || existingRange)) {
+        const block = generated.slice(expectedRange.start, expectedRange.end);
+        if (existingRange)
+            result = result.slice(0, existingRange.start) + block + result.slice(existingRange.end);
+        else {
+            const ownedHeaders = new Set(sections(block).map((section) => section.header));
+            for (const section of sections(result).reverse()) {
+                if (ownedHeaders.has(section.header))
+                    result = result.slice(0, section.start) + result.slice(section.end);
+            }
+            result = `${result.trimEnd()}\n\n${block}`;
+        }
+    }
+    return enableHooks(refreshHooks(result, generated));
+}
+/** Read-only checks classify an invalid overlay as drift instead of aborting doctor JSON. */
+export function isReconciledCodexConfig(current, generated, registerAgents = true) {
+    try {
+        return reconcileCodexConfig(current, generated, registerAgents) === current;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=codex-config-overlay.js.map

package/dist/services/codex-config-overlay.js.map

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

package/dist/services/codex-config-template.js

@@ -94,7 +94,7 @@ matcher = "*"
 type = "command"
 command = '''node "$(git rev-parse --show-toplevel)/.codex/hooks/zaip-subagent-lifecycle.mjs"'''
 command_windows = '''${codexWindowsHookCommand("zaip-subagent-lifecycle.mjs")}'''
-timeout = 3
+timeout = 10
 statusMessage = "Attributing ZAIP subagent Run"
 
 [[hooks.SubagentStop]]
@@ -104,7 +104,7 @@ matcher = "*"
 type = "command"
 command = '''node "$(git rev-parse --show-toplevel)/.codex/hooks/zaip-subagent-lifecycle.mjs"'''
 command_windows = '''${codexWindowsHookCommand("zaip-subagent-lifecycle.mjs")}'''
-timeout = 3
+timeout = 10
 statusMessage = "Finalizing ZAIP subagent Run"
 `;
 //# sourceMappingURL=codex-config-template.js.map

package/dist/services/codex-conversation-lifecycle-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-conversation-lifecycle-hook.d.ts","sourceRoot":"","sources":["../../src/services/codex-conversation-lifecycle-hook.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iCAAiC,QA8M7C,CAAC"}
+{"version":3,"file":"codex-conversation-lifecycle-hook.d.ts","sourceRoot":"","sources":["../../src/services/codex-conversation-lifecycle-hook.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iCAAiC,QAsO7C,CAAC"}

package/dist/services/codex-conversation-lifecycle-hook.js

@@ -2,11 +2,15 @@ export const CODEX_CONVERSATION_LIFECYCLE_HOOK = String.raw `import { writeSync
 import { lstat, open, readFile, realpath, mkdir, rename, writeFile, appendFile, unlink } from "node:fs/promises";
 import { createHash, randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
-import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { dirname, isAbsolute, relative, resolve, toNamespacedPath } from "node:path";
 import { fileURLToPath } from "node:url";
 const hookRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+const activation = await import("./zaip-hook-activation.mjs").catch(() => null);
 let root = hookRoot, local;
-const deadline = Date.now() + 8000;
+// The host hook stays below 10s. Explicit CLI recovery runs in the active Codex
+// tool session and may finish expensive canonical closure within its own bound.
+const replay = process.argv.length === 3 && process.argv[2] === "--replay-receipt";
+const deadline = Date.now() + (replay ? 45000 : 8000);
 const readChunkBytes = 1024 * 1024, maxLineBytes = 8 * 1024 * 1024, maxReadBytes = 16 * 1024 * 1024;
 const hash = value => createHash("sha256").update(value).digest("hex");
 const parse = value => { try { return JSON.parse(value); } catch { return null; } };
@@ -16,10 +20,10 @@ let raw = ""; for await (const chunk of process.stdin) raw += chunk;
 const event = parse(raw), session = text(event?.session_id), turn = text(event?.turn_id);
 let receipt, receiptPath, lease;
 function reply(pending = false) {
-  const result = { hookSpecificOutput: { hookEventName: "Stop" } };
-  // One continuation at most. Persistent failures remain an explicit durable pending event.
-  if (pending && event?.stop_hook_active !== true) Object.assign(result, { decision: "block", reason: receipt?.error === "owned_task_active" ? "ZAIP Task remains marked executing or verifying after Stop reconciliation; this does not prove a live worker. Inspect every launched process by fresh PID/session status, collect terminal exit and output, and either recover the lifecycle or report the concrete blocker. Never claim a process is still running from stale state." : receipt?.error === "owned_task_recoverable" ? "ZAIP Task " + receipt.recovery.task_id + " has a frozen recovery ledger. Observed attempts=" + receipt.recovery.progress.attempts + ", replans=" + (receipt.recovery.progress.total_replans ?? "unknown") + "; next ledger operation=" + receipt.recovery.operation + ". Evaluate the concrete blocker and perform only this authorized canonical operation in this turn. The hook did not dispatch an agent or prove the operation completed. Do not claim three replans without three observed ledger entries." : receipt?.error === "owned_task_unmetered" ? "ZAIP Task " + receipt.recovery.task_id + " is blocked without a frozen recovery ledger. The Stop hook cannot guarantee three replans or dispatch a model. Check the legacy policy and observed attempts, then report the concrete blocker and the missing enforcement honestly; never claim an unobserved replan." : "ZAIP closure or telemetry is pending. Retry this exact turn using its durable Stop receipt; do not report Task completion before canonical closure." });
-  writeSync(1, JSON.stringify(result) + "\n");
+  if (!replay) activation?.recordActivation(root, event, pending ? "pending" : "observed");
+  // Closure belongs to the live orchestrator. Stop only records/reconciles;
+  // a pending receipt must never manufacture another user prompt.
+  writeSync(1, JSON.stringify({}) + "\n");
 }
 async function save(path, value) {
   await mkdir(dirname(path), { recursive: true });
@@ -51,8 +55,11 @@ function proof(offset, line) { return { offset, length: line.length, sha256: has
 function sessionOf(row) { return row?.type === "session_meta" ? row.payload?.id ?? row.payload?.session_id : row?.payload?.type === "session_meta" ? row.payload.id ?? row.payload.session_id : null; }
 async function terminal(path) {
   if (!path || !isAbsolute(path)) throw new Error("transcript_missing");
+  // A local Windows namespace is not a network UNC path. Keep devices and UNC blocked.
+  if (/^(?:\\\\|\/\/)/.test(path) && !/^\\\\\?\\[a-z]:\\/i.test(path)) throw new Error("transcript_unsafe");
+  const identity = value => process.platform === "win32" ? toNamespacedPath(resolve(value)).toLowerCase() : resolve(value);
   const link = await lstat(path);
-  if (!link.isFile() || link.isSymbolicLink() || (await realpath(path)).toLowerCase() !== resolve(path).toLowerCase()) throw new Error("transcript_unsafe");
+  if (!link.isFile() || link.isSymbolicLink() || identity(await realpath(path)) !== identity(path)) throw new Error("transcript_unsafe");
   const h = await open(path, "r");
   try {
     const stat = await h.stat(), sig = signature(stat), prior = receipt.cursor;
@@ -62,7 +69,23 @@ async function terminal(path) {
     if (same && prior.session_proof) same = hash(await bytes(h, prior.session_proof.offset, prior.session_proof.length)) === prior.session_proof.sha256;
     let offset = same ? prior.offset : 0, trusted = same && prior.trusted === true;
     let sessionProof = same ? prior.session_proof : null, terminalProof = same ? prior.terminal_proof : null, status = same ? prior.terminal_status : null;
-    let readBytes = 0, scanOffset = offset, lineOffset = offset, lineBytes = 0, lineParts = [];
+    let initialReadBytes = 0;
+    // The live Stop belongs to the current tail, not hundreds of MB of earlier
+    // turns. Authenticate the first session row, then align a bounded tail scan.
+    // Explicit historical replay retains the full resumable scan when no cursor exists.
+    if (!same && !replay && sig.size > maxReadBytes) {
+      const header = await bytes(h, 0, readChunkBytes), end = header.indexOf(10);
+      if (end < 0) throw new Error("transcript_session_header_too_large");
+      const first = header.subarray(0, end + 1);
+      if (sessionOf(parse(first.toString("utf8"))) !== session) throw new Error("transcript_session_mismatch");
+      trusted = true; sessionProof = proof(0, first);
+      const tailStart = sig.size - Math.floor((maxReadBytes - readChunkBytes) / 2);
+      const boundary = await bytes(h, tailStart, sig.size - tailStart), newline = boundary.indexOf(10);
+      if (newline < 0) throw new Error("transcript_tail_boundary_unavailable");
+      offset = tailStart + newline + 1;
+      initialReadBytes = header.length + boundary.length;
+    }
+    let readBytes = initialReadBytes, scanOffset = offset, lineOffset = offset, lineBytes = 0, lineParts = [];
     const consume = line => {
       const row = parse(line.toString("utf8"));
       if (!row && line.toString("utf8").trim()) throw new Error("transcript_invalid_jsonl");
@@ -153,11 +176,12 @@ try {
   if (!lease) { await note("stop_worker_busy"); reply(true); process.exit(0); }
   const old = parse(await readFile(receiptPath, "utf8").catch(() => ""));
   receipt = old?.schema_version === 1 && old.session_id === session && old.turn_id === turn ? old : { schema_version: 1, session_id: session, turn_id: turn, state: "pending", attempts: 0 };
-  receipt.event = { hook_event_name: "Stop", cwd: root, session_id: session, turn_id: turn, transcript_path: text(event.transcript_path), stop_hook_active: true };
+  const transcriptPath = text(event.transcript_path) ?? text(receipt.event?.transcript_path);
+  receipt.event = { hook_event_name: "Stop", cwd: root, session_id: session, turn_id: turn, transcript_path: transcriptPath, stop_hook_active: true };
   if (receipt.state === "persisted") { reply(); } else {
     receipt.attempts += 1; receipt.state = "pending"; await save(receiptPath, receipt);
     let status = null;
-    for (const delay of [0, 250, 750]) { if (delay) await new Promise(r => setTimeout(r, delay)); status = await terminal(text(event.transcript_path)); if (status) break; }
+    for (const delay of [0, 250, 750]) { if (delay) await new Promise(r => setTimeout(r, delay)); status = await terminal(transcriptPath); if (status) break; }
     if (!status) throw new Error("transcript_pending");
     const cli = resolve(root, ".agents/runtime/bin/zaip.mjs");
     const correlation = parse(await readFile(resolve(root, ".local/codex-telemetry-spool/v1/correlations", correlationKey + ".json"), "utf8").catch(() => ""));
@@ -165,14 +189,14 @@ try {
     if (correlation?.schema_version === 1 && correlation.thread_id === session && correlation.turn_id === turn && correlation.agent_path === null && typeof correlation.run_id === "string") {
       intake = { run: { run_id: correlation.run_id }, task: correlation.task_id === null ? null : { id: correlation.task_id } };
     } else {
-      const started = await call(cli, ["conversation", "start", "--intent", "conversation"], text(event.transcript_path));
+      const started = await call(cli, ["conversation", "start", "--intent", "conversation"], transcriptPath);
       if (started.code !== 0) throw new Error("start_pending");
       intake = parse(started.out);
     }
     const run = intake?.run?.run_id;
     if (typeof run !== "string" || (intake.task !== null && typeof intake.task?.id !== "string")) throw new Error("start_pending");
     receipt.run_id = run; await save(receiptPath, receipt);
-    const result = await call(cli, ["subagent", "reconcile-stop", "--session", session, "--turn", turn], text(event.transcript_path));
+    const result = await call(cli, ["subagent", "reconcile-stop", "--session", session, "--turn", turn], transcriptPath);
     const outcome = parse(result.out);
     const terminalStates = ["completed", "blocked", "failed", "cancelled"];
     const closed = intake.task === null
@@ -180,7 +204,7 @@ try {
       : outcome?.status === "closed" && outcome.parent_run_id === run && outcome.reconciliation?.tasks?.some(task => task.id === intake.task.id && terminalStates.includes(task.status));
     if (result.code !== 0 || !closed) throw new Error("closure_pending");
     if (intake.task !== null && status === "completed") {
-      const shown = await call(cli, ["task", "recovery-status", intake.task.id], text(event.transcript_path));
+      const shown = await call(cli, ["task", "recovery-status", intake.task.id], transcriptPath);
       const recovery = parse(shown.out);
       if (shown.code !== 0 || recovery?.task_id !== intake.task.id || typeof recovery.task_status !== "string") throw new Error("task_state_pending");
       if (["executing", "verifying"].includes(recovery.task_status)) throw new Error("owned_task_active");
@@ -194,7 +218,7 @@ try {
       }
     }
     if (intake.task !== null) {
-      const usage = await call(cli, ["run", "usage", run, "--disable-codex-raw"], text(event.transcript_path));
+      const usage = await call(cli, ["run", "usage", run, "--disable-codex-raw"], transcriptPath);
       if (usage.code !== 0 || parse(usage.out) === null) throw new Error("telemetry_pending");
     }
     receipt.state = "persisted"; receipt.persisted_at = new Date().toISOString(); receipt.error = null;

package/dist/services/codex-conversation-lifecycle-hook.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex-conversation-lifecycle-hook.js","sourceRoot":"","sources":["../../src/services/codex-conversation-lifecycle-hook.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8M1D,CAAC"}
+{"version":3,"file":"codex-conversation-lifecycle-hook.js","sourceRoot":"","sources":["../../src/services/codex-conversation-lifecycle-hook.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsO1D,CAAC"}

package/dist/services/codex-hook-activation.d.ts

@@ -0,0 +1,4 @@
+export declare const HOOK_ACTIVATION_EVENTS: readonly ["PreToolUse", "SubagentStart", "SubagentStop", "Stop"];
+export declare const HOOK_ACTIVATION_FILES: readonly [".codex/config.toml", ".codex/hooks/zaip-pre-tool-use.mjs", ".codex/hooks/zaip-pre-tool-support.mjs", ".codex/hooks/zaip-native-tool-authority.mjs", ".codex/hooks/zaip-subagent-lifecycle.mjs", ".codex/hooks/zaip-conversation-lifecycle.mjs", ".codex/hooks/zaip-hook-activation.mjs"];
+export declare const CODEX_HOOK_ACTIVATION: string;
+//# sourceMappingURL=codex-hook-activation.d.ts.map

package/dist/services/codex-hook-activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-hook-activation.d.ts","sourceRoot":"","sources":["../../src/services/codex-hook-activation.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,YACjC,YAAY,EACZ,eAAe,EACf,cAAc,EACd,MAAM,CACE,CAAC;AACX,eAAO,MAAM,qBAAqB,YAChC,oBAAoB,EACpB,oCAAoC,EACpC,wCAAwC,EACxC,6CAA6C,EAC7C,0CAA0C,EAC1C,8CAA8C,EAC9C,uCAAuC,CAC/B,CAAC;AAGX,eAAO,MAAM,qBAAqB,QA8CjC,CAAC"}

package/dist/services/codex-hook-activation.js

@@ -0,0 +1,64 @@
+export const HOOK_ACTIVATION_EVENTS = [
+    "PreToolUse",
+    "SubagentStart",
+    "SubagentStop",
+    "Stop",
+];
+export const HOOK_ACTIVATION_FILES = [
+    ".codex/config.toml",
+    ".codex/hooks/zaip-pre-tool-use.mjs",
+    ".codex/hooks/zaip-pre-tool-support.mjs",
+    ".codex/hooks/zaip-native-tool-authority.mjs",
+    ".codex/hooks/zaip-subagent-lifecycle.mjs",
+    ".codex/hooks/zaip-conversation-lifecycle.mjs",
+    ".codex/hooks/zaip-hook-activation.mjs",
+];
+// Local diagnostic evidence, not a replacement for Codex's trust store or a security boundary.
+export const CODEX_HOOK_ACTIVATION = String.raw `import { createHash, randomUUID } from "node:crypto";
+import { lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+const files = ${JSON.stringify(HOOK_ACTIVATION_FILES)};
+const events = ${JSON.stringify(HOOK_ACTIVATION_EVENTS)};
+const digest = text => createHash("sha256").update(text).digest("hex");
+function regular(path) {
+  const s = lstatSync(path);
+  if (!s.isFile() || s.isSymbolicLink() || s.size > 2097152) throw new Error("unsafe activation input");
+  return readFileSync(path);
+}
+export function recordActivation(root, event, outcome = "observed") {
+  try {
+    const name = event?.hook_event_name;
+    let directory = root;
+    for (const part of [".local", "hooks", "activation"]) {
+      directory = resolve(directory, part);
+      try { mkdirSync(directory); } catch (e) { if (e.code !== "EEXIST") throw e; }
+      const s = lstatSync(directory);
+      if (!s.isDirectory() || s.isSymbolicLink() || realpathSync(directory).toLowerCase() !== directory.toLowerCase()) return;
+    }
+    const reason = !events.includes(name) ? "event_missing_or_unknown" :
+      typeof event.session_id !== "string" || !event.session_id ? "session_missing" :
+      typeof event.turn_id !== "string" || !event.turn_id ? "turn_missing" :
+      process.env.CODEX_THREAD_ID && process.env.CODEX_THREAD_ID !== event.session_id ? "host_identity_mismatch" : null;
+    if (reason) {
+      // No payload, command, environment value or secret is persisted here.
+      const diagnostic = resolve(directory, "diagnostic.json");
+      const temporary = diagnostic + ".tmp-" + randomUUID();
+      writeFileSync(temporary, JSON.stringify({ reason, observed_at: new Date().toISOString() }), { flag: "wx", mode: 0o600 });
+      renameSync(temporary, diagnostic);
+      return;
+    }
+    // Hook processes do not necessarily inherit CODEX_THREAD_ID. The event is the
+    // protocol identity; receipts remain diagnostics, never proof of Codex trust.
+    const fingerprint = digest(JSON.stringify(files.map(file => [file, digest(regular(resolve(root, file)))])));
+    const path = resolve(directory, name + ".json");
+    const temporary = path + ".tmp-" + randomUUID();
+    writeFileSync(temporary, JSON.stringify({ schema_version: 1, event: name, fingerprint,
+      session_id: event.session_id, turn_id: event.turn_id, outcome,
+      identity_source: process.env.CODEX_THREAD_ID ? "event_and_environment" : "hook_event",
+      observed_at: new Date().toISOString() }) + "\n",
+      { flag: "wx", mode: 0o600 });
+    renameSync(temporary, path);
+  } catch { /* Diagnostics must not break a tool or turn. Missing evidence stays unknown. */ }
+}
+`;
+//# sourceMappingURL=codex-hook-activation.js.map

package/dist/services/codex-hook-activation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-hook-activation.js","sourceRoot":"","sources":["../../src/services/codex-hook-activation.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY;IACZ,eAAe;IACf,cAAc;IACd,MAAM;CACE,CAAC;AACX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,oBAAoB;IACpB,oCAAoC;IACpC,wCAAwC;IACxC,6CAA6C;IAC7C,0CAA0C;IAC1C,8CAA8C;IAC9C,uCAAuC;CAC/B,CAAC;AAEX,+FAA+F;AAC/F,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAA;;;gBAG/B,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;iBACpC,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CtD,CAAC"}

package/dist/services/codex-model-policy.d.ts

@@ -0,0 +1,4 @@
+import type { GuidanceAgent } from "./agent-adapters.js";
+export declare function codexModelInstructions(agent: GuidanceAgent): readonly string[];
+export declare function codexModelConfig(agent: GuidanceAgent): string;
+//# sourceMappingURL=codex-model-policy.d.ts.map

package/dist/services/codex-model-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-model-policy.d.ts","sourceRoot":"","sources":["../../src/services/codex-model-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUzD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAM9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAY7D"}

package/dist/services/codex-model-policy.js

@@ -0,0 +1,24 @@
+function followsDispatchPolicy(agent) {
+    return (agent.role === "orchestrator" ||
+        (["builder", "task-executor"].includes(agent.role) &&
+            agent.execution_eligibility.includes("delivery")));
+}
+export function codexModelInstructions(agent) {
+    return followsDispatchPolicy(agent)
+        ? [
+            "Model and reasoning effort are controlled by the authorized dispatch policy. Catalog preferences are dispatch defaults, not permanent native locks. Before dispatch, the authorized host must select and validate the model/effort allowed by the frozen Task policy and the host's manual selection. Record the requested configuration separately from the effective model/effort observed from the host; never silently inherit a parent configuration or claim a model switch from instructions. If the host cannot select or verify the required configuration, report the capability as unavailable and return the blocked dispatch to the orchestrator.",
+        ]
+        : [];
+}
+export function codexModelConfig(agent) {
+    const model = agent.model.preferred[0];
+    if (followsDispatchPolicy(agent) ||
+        agent.model.preferred.length !== 1 ||
+        model === undefined ||
+        model === "policy-selected") {
+        return "";
+    }
+    const effort = agent.model.reasoning_effort;
+    return `model = ${JSON.stringify(model)}\n${effort === undefined ? "" : `model_reasoning_effort = ${JSON.stringify(effort)}\n`}`;
+}
+//# sourceMappingURL=codex-model-policy.js.map

package/dist/services/codex-model-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-model-policy.js","sourceRoot":"","sources":["../../src/services/codex-model-policy.ts"],"names":[],"mappings":"AAEA,SAAS,qBAAqB,CAAC,KAAoB;IACjD,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,cAAc;QAC7B,CAAC,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAChD,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CACpD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAoB;IACzD,OAAO,qBAAqB,CAAC,KAAK,CAAC;QACjC,CAAC,CAAC;YACE,goBAAgoB;SACjoB;QACH,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACvC,IACE,qBAAqB,CAAC,KAAK,CAAC;QAC5B,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAClC,KAAK,KAAK,SAAS;QACnB,KAAK,KAAK,iBAAiB,EAC3B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC5C,OAAO,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AACnI,CAAC"}

package/dist/services/codex-native-tool-authority-template.d.ts

@@ -0,0 +1,2 @@
+export declare const CODEX_NATIVE_TOOL_AUTHORITY_HOOK: string;
+//# sourceMappingURL=codex-native-tool-authority-template.d.ts.map

package/dist/services/codex-native-tool-authority-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-native-tool-authority-template.d.ts","sourceRoot":"","sources":["../../src/services/codex-native-tool-authority-template.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,gCAAgC,QAsFT,CAAC"}

package/dist/services/codex-native-tool-authority-template.js

@@ -0,0 +1,89 @@
+import { CODEX_VALIDATION_RUNTIME_SUPPORT } from "./codex-validation-runtime-template.js";
+export const CODEX_NATIVE_TOOL_AUTHORITY_HOOK = String.raw `import { createHash } from "node:crypto";
+import { lstat, realpath } from "node:fs/promises";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+const inside = (path, root) => { const scoped = relative(root, resolve(path)); return scoped === "" || (!scoped.startsWith("..") && !isAbsolute(scoped)); };
+const authorityPath = path => /^(?:\.agents\/(?:records|data\/runs)\/|\.local\/(?:codex-hook-|codex-telemetry-spool\/|runs\/))/i.test(path.replaceAll("\\", "/"));
+/** Inspect existing ancestors too: a missing destination can still traverse a junction. */
+export async function isSafePatchPath(target, root) {
+  if (!inside(target, root)) return false;
+  for (let path = resolve(target);; path = dirname(path)) {
+    try {
+      const info = await lstat(path);
+      if (info.isSymbolicLink() || (info.isFile() && info.nlink !== 1)) return false;
+    } catch (error) { if (error.code !== "ENOENT") return false; }
+    if (path === resolve(root)) return true;
+    if (dirname(path) === path) return false;
+  }
+}
+async function canonicalScopes(id, root, boundedRead) {
+  const date = typeof id === "string" && /^TASK-(\d{4})-(\d{2})-(\d{2})-[A-Z0-9-]+$/.exec(id);
+  if (!date) throw new Error("invalid_task");
+  const text = await boundedRead(resolve(root, ".agents/records/tasks", date[1], date[2], id + ".md"), 262144);
+  const front = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(text)?.[1];
+  if (!front || ["id", "status", "write_scopes"].some(key => (front.match(new RegExp("^" + key + ":", "gm")) ?? []).length !== 1) ||
+      !front.split(/\r?\n/).includes("id: " + id) || !/^status: (?:executing|verifying)$/m.test(front.replaceAll("\r", ""))) throw new Error("inactive_task");
+  const lists = [...front.matchAll(/^write_scopes:\r?\n((?:  - [^\r\n]+(?:\r?\n|$))+)/gm)];
+  if (lists.length !== 1) throw new Error("invalid_scopes");
+  return lists[0][1].trimEnd().split(/\r?\n/).map(line => {
+    const value = line.slice(4);
+    if (value.startsWith('"')) return JSON.parse(value);
+    if (value.startsWith("'") && value.endsWith("'")) return value.slice(1, -1).replaceAll("''", "'");
+    if (/[\r\n\x00]|(?:^|\s)#|:\s|^[!&*\[{]/.test(value)) throw new Error("ambiguous_scope");
+    return value;
+  });
+}
+/** Validate only this native child's patch scope and its still-active canonical ancestry. */
+export async function hasNativeDelegatedPatch(event, repositoryRoot, boundedRead) {
+  if (event.tool_name !== "apply_patch" || typeof event.session_id !== "string" || typeof event.turn_id !== "string") return false;
+  try {
+    const key = createHash("sha256").update(JSON.stringify([event.session_id, event.turn_id])).digest("hex");
+    const binding = JSON.parse(await boundedRead(resolve(repositoryRoot, ".local/codex-hook-native/v2", key + ".json"), 65536));
+    if (binding.schema_version !== 2 || binding.session_id !== event.session_id || binding.turn_id !== event.turn_id ||
+        typeof binding.native_session_id !== "string" || ![binding.native_session_id, binding.parent_session_id].includes(event.session_id) ||
+        !Array.isArray(binding.write_scopes) || !binding.write_scopes.length) return false;
+    const readRun = async id => {
+      const match = typeof id === "string" && /^RUN-(\d{4})-(\d{2})-(\d{2})-[A-Z0-9-]+-[A-Z0-9]{2,16}$/.exec(id);
+      if (!match) throw new Error("invalid_run");
+      let text;
+      for (const directory of [match[1] + "/" + match[2], match[1] + "/" + match[2] + "/" + match[3]]) {
+        try {
+          const value = await boundedRead(resolve(repositoryRoot, ".agents/records/runs", directory, id + ".jsonl"), 8388608);
+          if (text !== undefined) throw new Error("ambiguous_run");
+          text = value;
+        } catch (error) { if (error.code !== "ENOENT") throw error; }
+      }
+      if (!text?.endsWith("\n")) throw new Error("incomplete_run");
+      const records = text.split(/\r?\n/).filter(Boolean).map(JSON.parse);
+      if (records.some((row, i) => row.schema_version !== 2 || row.sequence !== i + 1 || row.run_id !== id ||
+          row.type === "run.finished" || row.type === "run.finalization.decided")) throw new Error("inactive_run");
+      if (records[0]?.type !== "run.started") throw new Error("invalid_run");
+      return records[0];
+    };
+    const child = await readRun(binding.run_id), parent = await readRun(binding.parent_run_id);
+    if (child.client !== "codex-subagent" || child.run_role !== "subagent" || child.run_purpose !== "execution" ||
+        !child.execution_eligibility?.includes("delivery") || child.parent_run_id !== parent.run_id ||
+        child.client_thread_id !== binding.agent_id || child.client_turn_id !== event.turn_id ||
+        parent.agent !== "agent-orchestrator" || parent.run_role !== "orchestrator" || parent.parent_run_id !== null ||
+        parent.client_thread_id !== binding.parent_session_id ||
+        parent.entrypoint !== "task" || !binding.task_id || !binding.execution_id ||
+        child.task_id !== binding.task_id || parent.task_id !== binding.task_id ||
+        child.execution_id !== binding.execution_id || parent.execution_id !== binding.execution_id) return false;
+    const command = event.tool_input?.command;
+    if (typeof command !== "string") return false;
+    const scopes = await canonicalScopes(binding.task_id, repositoryRoot, boundedRead);
+    if (JSON.stringify(scopes) !== JSON.stringify(binding.write_scopes)) return false;
+    const paths = [...command.matchAll(/^\*\*\* (?:Add File|Update File|Delete File|Move to): (.+)$/gm)].map(match => match[1].trim());
+    for (const path of paths) if (!await isSafePatchPath(resolve(repositoryRoot, path), repositoryRoot)) return false;
+    return paths.length > 0 && paths.every(path => {
+      const target = resolve(repositoryRoot, path);
+      return !authorityPath(relative(repositoryRoot, target)) && inside(target, repositoryRoot) && scopes.some(scope => {
+        if (typeof scope !== "string" || !scope || isAbsolute(scope) || scope.split(/[\\/]/).includes("..")) return false;
+        const base = resolve(repositoryRoot, scope.replace(/\/\*\*$/, ""));
+        return inside(base, repositoryRoot) && inside(target, base);
+      });
+    });
+  } catch { return false; }
+}
+` + CODEX_VALIDATION_RUNTIME_SUPPORT;
+//# sourceMappingURL=codex-native-tool-authority-template.js.map

package/dist/services/codex-native-tool-authority-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-native-tool-authority-template.js","sourceRoot":"","sources":["../../src/services/codex-native-tool-authority-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAC1F,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFzD,GAAG,gCAAgC,CAAC"}

package/dist/services/codex-pre-tool-hook-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-pre-tool-hook-template.d.ts","sourceRoot":"","sources":["../../src/services/codex-pre-tool-hook-template.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QA+vB/B,CAAC"}
+{"version":3,"file":"codex-pre-tool-hook-template.d.ts","sourceRoot":"","sources":["../../src/services/codex-pre-tool-hook-template.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QAouB/B,CAAC"}