@agentdeck/hooks 0.2.0 → 0.2.3

package/dist/codex-install.d.ts

@@ -0,0 +1,64 @@
+export declare const DEFAULT_CODEX_CONFIG_PATH: string;
+/** Sidecar script for the Windows notify fallback. Codex execs `notify`
+ *  as a bare argv array (no shell) and appends the JSON payload as the
+ *  last element; `powershell -File` is the only Windows invocation that
+ *  binds trailing argv into `$args` (`-Command` concatenates them into
+ *  the command text and `-EncodedCommand` rejects them outright), and
+ *  `-File` requires a real script on disk. */
+export declare const DEFAULT_WINDOWS_NOTIFY_SCRIPT_PATH: string;
+export interface InstallOptions {
+    /** Override the codex config path (tests + non-default homes). */
+    configPath?: string;
+    /** Daemon HTTP port to bake into the OTel exporter endpoint. If
+     *  omitted, the installer reads `~/.agentdeck/daemon.json`. */
+    daemonHttpPort?: number;
+    /** Override platform for tests. Defaults to process.platform. */
+    platform?: NodeJS.Platform;
+    /** Override the Windows notify sidecar script path (tests). */
+    notifyScriptPath?: string;
+}
+export interface InstallResult {
+    installed: boolean;
+    /** Human-readable reason when `installed === false`. */
+    reason?: string;
+    /** Non-fatal degradation while `installed === true` (e.g. the Windows
+     *  notify sidecar could not be written, so notify was omitted). */
+    warning?: string;
+}
+interface ManagedBlockOptions {
+    includeNotify?: boolean;
+    includeOtel?: boolean;
+    otelEndpoint?: string;
+    daemonHttpPort?: number;
+    platform?: NodeJS.Platform;
+    notifyScriptPath?: string;
+}
+/** Assemble the body of the AgentDeck-managed fence. Tests call this
+ *  directly to assert schema regressions without driving the file
+ *  installer. */
+export declare function managedBlockBody(opts?: ManagedBlockOptions): string;
+/** Body of the Windows notify sidecar script (`-File` execution binds
+ *  Codex's appended payload argv into `$args`; take the last element to
+ *  mirror POSIX `$1`). ASCII-only so PowerShell 5.1's BOM-less ANSI
+ *  fallback reads it identically to UTF-8. Exported for tests. */
+export declare function windowsNotifyScriptContent(event?: string): string;
+/** Install AgentDeck's Codex observation entries into `~/.codex/config.toml`
+ *  unless the user opted out, the user has authored a conflicting top-level
+ *  `[features]` / `[hooks]` table outside the fence, or the file write
+ *  failed. Idempotent: re-running with the same daemon port produces a
+ *  byte-identical file, so safe to call from setup, `agentdeck codex`,
+ *  and `agentdeck daemon install`. */
+export declare function installCodexHooksIfNeeded(opts?: InstallOptions): InstallResult;
+/** Strip the AgentDeck-managed fence. Idempotent — no-op when the fence
+ *  is absent. Does not delete the config file even if it becomes empty
+ *  (Codex may rely on its existence). */
+export declare function uninstallCodexHooks(opts?: {
+    configPath?: string;
+    notifyScriptPath?: string;
+}): void;
+/** Re-apply the managed block when the daemon port (or any other resolved
+ *  field) might have changed. Equivalent to install but renamed for the
+ *  daemon-restart code path so the intent is clearer at the call site. */
+export declare function migrateCodexHooks(opts?: InstallOptions): InstallResult;
+export {};
+//# sourceMappingURL=codex-install.d.ts.map

package/dist/codex-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-install.d.ts","sourceRoot":"","sources":["../src/codex-install.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,yBAAyB,QAA2C,CAAC;AAClF;;;;;8CAK8C;AAC9C,eAAO,MAAM,kCAAkC,QAAoD,CAAC;AAGpG,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;mEAC+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;uEACmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgCD,UAAU,mBAAmB;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;iBAEiB;AACjB,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,CAsCvE;AAgHD;;;kEAGkE;AAClE,wBAAgB,0BAA0B,CAAC,KAAK,SAAwB,GAAG,MAAM,CAEhF;AAsED;;;;;sCAKsC;AACtC,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,cAAmB,GAAG,aAAa,CAqDlF;AAED;;yCAEyC;AACzC,wBAAgB,mBAAmB,CAAC,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CASvG;AAED;;0EAE0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,cAAmB,GAAG,aAAa,CAE1E"}

package/dist/codex-install.js

@@ -0,0 +1,342 @@
+// codex-install.ts — Install AgentDeck observation entries into
+// ~/.codex/config.toml so Codex CLI sessions report turn boundaries and
+// tool calls to the daemon via lifecycle hooks.
+//
+// Port of apple/AgentDeck/Daemon/Core/CodexConfigInstaller.swift, with
+// the macOS-specific consent flow (NSAlert / NSOpenPanel / security-
+// scoped bookmarks) stripped — Node CLI runs without sandboxing, so
+// invocation is implicit consent. An opt-out env var
+// `AGENTDECK_NO_CODEX_HOOKS=1` (or the `--no-codex-hooks` CLI flag) is
+// honoured by callers.
+//
+// The fence sentinels and PORT-resolution shell are byte-identical with
+// the Swift installer, so a config installed by either side can be
+// migrated / uninstalled by the other without conflict.
+//
+// MUST stay in sync with apple/AgentDeck/Daemon/Core/CodexConfigInstaller.swift
+// (managedBlockBody schema + lifecycle hook table layout).
+import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync, unlinkSync } from 'fs';
+import { dirname, join } from 'path';
+import { homedir } from 'os';
+import { applyManagedBlock, removeManagedBlock, hasTopLevelKeyOutsideFence, hasTableOutsideFence, quoted, } from './codex-mini-toml.js';
+export const DEFAULT_CODEX_CONFIG_PATH = join(homedir(), '.codex', 'config.toml');
+/** Sidecar script for the Windows notify fallback. Codex execs `notify`
+ *  as a bare argv array (no shell) and appends the JSON payload as the
+ *  last element; `powershell -File` is the only Windows invocation that
+ *  binds trailing argv into `$args` (`-Command` concatenates them into
+ *  the command text and `-EncodedCommand` rejects them outright), and
+ *  `-File` requires a real script on disk. */
+export const DEFAULT_WINDOWS_NOTIFY_SCRIPT_PATH = join(homedir(), '.agentdeck', 'codex-notify.ps1');
+const DEFAULT_DAEMON_PORT = 9120;
+/** Honour `AGENTDECK_NO_CODEX_HOOKS=1` from the environment. Callers
+ *  should also accept a `--no-codex-hooks` flag and short-circuit before
+ *  calling install. */
+function envOptOut() {
+    return process.env.AGENTDECK_NO_CODEX_HOOKS === '1';
+}
+/** Read `~/.agentdeck/daemon.json` and return the daemon's HTTP port,
+ *  preferring `httpPort` over `port`. The Apple build splits HTTP and
+ *  WebSocket across different ports; the Node CLI uses a single port,
+ *  so this still resolves correctly. Returns null if the file is
+ *  missing or malformed. */
+function currentDaemonHttpPort() {
+    const path = join(homedir(), '.agentdeck', 'daemon.json');
+    if (!existsSync(path))
+        return null;
+    try {
+        const obj = JSON.parse(readFileSync(path, 'utf-8'));
+        if (typeof obj.httpPort === 'number' && obj.httpPort > 0)
+            return obj.httpPort;
+        if (typeof obj.port === 'number' && obj.port > 0)
+            return obj.port;
+    }
+    catch { /* malformed JSON — fall through */ }
+    return null;
+}
+function buildOtelEndpoint(daemonHttpPort) {
+    const port = daemonHttpPort ?? currentDaemonHttpPort() ?? DEFAULT_DAEMON_PORT;
+    return `http://127.0.0.1:${port}/otel/v1/traces`;
+}
+/** Assemble the body of the AgentDeck-managed fence. Tests call this
+ *  directly to assert schema regressions without driving the file
+ *  installer. */
+export function managedBlockBody(opts = {}) {
+    const includeNotify = opts.includeNotify ?? true;
+    const includeOtel = opts.includeOtel ?? true;
+    const platform = opts.platform ?? process.platform;
+    const lines = [
+        '# Codex lifecycle hooks. Command hooks receive JSON on stdin;',
+        '# each snippet forwards that stdin body unchanged to AgentDeck.',
+        '[features]',
+        'hooks = true',
+    ];
+    lines.push('');
+    lines.push(...buildLifecycleHookTables(platform));
+    if (includeNotify) {
+        lines.push('');
+        lines.push('# Optional turn-complete notification fallback.');
+        if (platform === 'win32') {
+            lines.push('# Codex appends the JSON payload as the last argv entry;');
+            lines.push('# powershell -File binds it into $args. (-Command cannot:');
+            lines.push('# it concatenates trailing argv into the command text.)');
+        }
+        else {
+            lines.push('# Codex appends the JSON payload as the last argv entry,');
+            lines.push('# so the 4th array element acts as $0 and payload lands at $1.');
+        }
+        lines.push(buildNotifyAssignment('codex_turn_complete', platform, opts.notifyScriptPath));
+    }
+    if (includeOtel) {
+        lines.push('');
+        lines.push('# OTel trace exporter — best-effort live progress signal.');
+        lines.push('# Schema: [otel.trace_exporter.otlp-http].');
+        lines.push('[otel.trace_exporter.otlp-http]');
+        lines.push(`endpoint = ${quoted(opts.otelEndpoint ?? buildOtelEndpoint(opts.daemonHttpPort))}`);
+        lines.push('protocol = "json"');
+    }
+    return lines.join('\n');
+}
+/** `notify = ["sh", "-c", "<snippet>", "agentdeck-notify"]`. Two design
+ *  choices stacked here:
+ *    1. `"sh"` uses PATH lookup so no absolute shell path lands in the
+ *       installer config.
+ *    2. The trailing `"agentdeck-notify"` is a dummy `$0`. Codex invokes
+ *       `notify` by appending the JSON payload as the last argv entry.
+ *       Without our 4th element, `sh -c "<snippet>" <json>` would assign
+ *       `<json>` to `$0` and leave `$1` empty. With the dummy in place,
+ *       `<json>` lands at `$1` as the snippet expects. */
+function buildNotifyAssignment(event, platform, notifyScriptPath) {
+    if (platform === 'win32') {
+        const scriptPath = notifyScriptPath ?? DEFAULT_WINDOWS_NOTIFY_SCRIPT_PATH;
+        return `notify = ["powershell.exe", "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", ${quoted(scriptPath)}]`;
+    }
+    return `notify = ["sh", "-c", ${quoted(buildNotifySnippet(event))}, "agentdeck-notify"]`;
+}
+/** Codex notify snippet. PORT-resolution lines are byte-identical with
+ *  `hooks/src/install.ts:buildHookCommand` so the two integrations share
+ *  one canonical port-discovery contract. Only the trailing curl line
+ *  differs: Claude hooks pipe stdin (`-d @-`); Codex notify hands the
+ *  JSON payload as `$1` (`--data-raw "$1"`). */
+function buildNotifySnippet(event) {
+    return [
+        `PORT="\${AGENTDECK_PORT:-}"`,
+        `if [ -z "$PORT" ]; then`,
+        `  for F in "$HOME/.agentdeck/daemon.json" "$HOME/Library/Containers/bound.serendipity.agent.deck/Data/Library/Application Support/AgentDeck/daemon.json" "$HOME/Library/Group Containers/group.bound.serendipity.agent.deck/daemon.json"; do`,
+        `    [ -f "$F" ] || continue`,
+        `    P=$(python3 -c "import json;d=json.load(open('$F'));print(d.get('httpPort') or d.get('port',''))" 2>/dev/null)`,
+        `    [ -n "$P" ] && curl -sf --max-time 0.3 "http://127.0.0.1:$P/health" >/dev/null 2>&1 && { PORT="$P"; break; }`,
+        `  done`,
+        `fi`,
+        `PORT="\${PORT:-9120}"`,
+        `curl -sf --connect-timeout 0.2 --max-time 0.8 -X POST "http://127.0.0.1:$PORT/hooks/${event}" -H 'Content-Type: application/json' --data-raw "$1" 2>/dev/null || true`,
+    ].join('\n');
+}
+const LIFECYCLE_HOOKS = [
+    { codexEvent: 'SessionStart', agentDeckEvent: 'codex_session_start', matcher: 'startup|resume|clear' },
+    { codexEvent: 'UserPromptSubmit', agentDeckEvent: 'codex_user_prompt_submit', matcher: null },
+    { codexEvent: 'PreToolUse', agentDeckEvent: 'codex_tool_start', matcher: '*' },
+    { codexEvent: 'PostToolUse', agentDeckEvent: 'codex_tool_end', matcher: '*' },
+    { codexEvent: 'Stop', agentDeckEvent: 'codex_stop', matcher: null },
+];
+function buildLifecycleHookTables(platform) {
+    const lines = [];
+    for (let idx = 0; idx < LIFECYCLE_HOOKS.length; idx++) {
+        const hook = LIFECYCLE_HOOKS[idx];
+        if (idx > 0)
+            lines.push('');
+        lines.push(`[[hooks.${hook.codexEvent}]]`);
+        if (hook.matcher !== null) {
+            lines.push(`matcher = ${quoted(hook.matcher)}`);
+        }
+        lines.push(`[[hooks.${hook.codexEvent}.hooks]]`);
+        lines.push(`type = "command"`);
+        lines.push(`command = ${quoted(buildLifecycleHookCommand(hook.agentDeckEvent, platform))}`);
+        lines.push(`timeout = 5`);
+    }
+    return lines;
+}
+/** Official Codex lifecycle hooks pass their JSON payload on stdin.
+ *  Keep stdout quiet so Stop / UserPromptSubmit hooks do not accidentally
+ *  feed the daemon's acknowledgement back into Codex as hook output. */
+function buildLifecycleHookCommand(event, platform) {
+    if (platform === 'win32') {
+        return buildWindowsLifecycleHookCommand(event);
+    }
+    return `sh -c ${shellSingleQuoted(buildStdinPostSnippet(event))}`;
+}
+function buildStdinPostSnippet(event) {
+    return [
+        `PORT="\${AGENTDECK_PORT:-}"`,
+        `if [ -z "$PORT" ]; then`,
+        `  for F in "$HOME/.agentdeck/daemon.json" "$HOME/Library/Containers/bound.serendipity.agent.deck/Data/Library/Application Support/AgentDeck/daemon.json" "$HOME/Library/Group Containers/group.bound.serendipity.agent.deck/daemon.json"; do`,
+        `    [ -f "$F" ] || continue`,
+        `    P=$(python3 -c "import json;d=json.load(open('$F'));print(d.get('httpPort') or d.get('port',''))" 2>/dev/null)`,
+        `    [ -n "$P" ] && curl -sf --max-time 0.3 "http://127.0.0.1:$P/health" >/dev/null 2>&1 && { PORT="$P"; break; }`,
+        `  done`,
+        `fi`,
+        `PORT="\${PORT:-9120}"`,
+        `curl -sf --connect-timeout 0.2 --max-time 0.8 -X POST "http://127.0.0.1:$PORT/hooks/${event}" -H 'Content-Type: application/json' -d @- >/dev/null 2>&1 || true`,
+    ].join('\n');
+}
+function shellSingleQuoted(s) {
+    return `'${s.replace(/'/g, "'\"'\"'")}'`;
+}
+function buildWindowsLifecycleHookCommand(event) {
+    return `powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -EncodedCommand ${windowsEncodedCommand(buildWindowsStdinPostSnippet(event))}`;
+}
+function buildWindowsStdinPostSnippet(event) {
+    // Read raw stdin as UTF-8: [Console]::In decodes with the console's OEM
+    // codepage (e.g. CP949) and would garble non-ASCII payload text.
+    return buildWindowsPostSnippet(event, '(New-Object System.IO.StreamReader([Console]::OpenStandardInput(), [System.Text.Encoding]::UTF8)).ReadToEnd()');
+}
+/** Body of the Windows notify sidecar script (`-File` execution binds
+ *  Codex's appended payload argv into `$args`; take the last element to
+ *  mirror POSIX `$1`). ASCII-only so PowerShell 5.1's BOM-less ANSI
+ *  fallback reads it identically to UTF-8. Exported for tests. */
+export function windowsNotifyScriptContent(event = 'codex_turn_complete') {
+    return buildWindowsPostSnippet(event, `$(if ($args.Count -gt 0) { [string]$args[$args.Count - 1] } else { '' })`) + '\n';
+}
+function buildWindowsPostSnippet(event, bodyExpression) {
+    return [
+        `$ErrorActionPreference = 'SilentlyContinue'`,
+        `$ProgressPreference = 'SilentlyContinue'`,
+        `$port = $env:AGENTDECK_PORT`,
+        `if ([string]::IsNullOrWhiteSpace($port)) {`,
+        `  $daemonFile = Join-Path $env:USERPROFILE '.agentdeck\\daemon.json'`,
+        `  if (Test-Path -LiteralPath $daemonFile) {`,
+        `    try {`,
+        `      $daemon = Get-Content -LiteralPath $daemonFile -Raw | ConvertFrom-Json`,
+        `      $candidate = if ($daemon.httpPort) { $daemon.httpPort } else { $daemon.port }`,
+        `      if ($candidate) {`,
+        `        try { Invoke-WebRequest -UseBasicParsing -TimeoutSec 1 -Uri ('http://127.0.0.1:' + $candidate + '/health') | Out-Null; $port = [string]$candidate } catch {}`,
+        `      }`,
+        `    } catch {}`,
+        `  }`,
+        `}`,
+        `if ([string]::IsNullOrWhiteSpace($port)) { $port = '9120' }`,
+        `$body = ${bodyExpression}`,
+        // Post UTF-8 bytes: Invoke-RestMethod encodes string bodies as
+        // ISO-8859-1 when the content type carries no charset, replacing
+        // non-ASCII payload characters with '?'.
+        `$bytes = [System.Text.Encoding]::UTF8.GetBytes([string]$body)`,
+        `try { Invoke-RestMethod -Method Post -TimeoutSec 1 -Uri ('http://127.0.0.1:' + $port + '/hooks/${event}') -ContentType 'application/json; charset=utf-8' -Body $bytes | Out-Null } catch {}`,
+        `exit 0`,
+    ].join('\n');
+}
+function windowsEncodedCommand(s) {
+    return Buffer.from(s, 'utf16le').toString('base64');
+}
+// ─── File I/O ───────────────────────────────────────────────────────────
+function readText(path) {
+    if (!existsSync(path))
+        return '';
+    try {
+        return readFileSync(path, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+/** Write the notify sidecar only when its content changed, so repeated
+ *  installs stay idempotent (no mtime churn). Returns false when the
+ *  script cannot be guaranteed on disk. */
+function writeScriptIfChanged(content, path) {
+    try {
+        if (existsSync(path) && readFileSync(path, 'utf-8') === content)
+            return true;
+    }
+    catch { /* unreadable — fall through to rewrite */ }
+    return writeTextAtomic(content, path);
+}
+function writeTextAtomic(text, path) {
+    const dir = dirname(path);
+    try {
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const tmp = `${path}.agentdeck.tmp`;
+        writeFileSync(tmp, text, 'utf-8');
+        renameSync(tmp, path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Public install / uninstall / migrate ──────────────────────────────
+/** Install AgentDeck's Codex observation entries into `~/.codex/config.toml`
+ *  unless the user opted out, the user has authored a conflicting top-level
+ *  `[features]` / `[hooks]` table outside the fence, or the file write
+ *  failed. Idempotent: re-running with the same daemon port produces a
+ *  byte-identical file, so safe to call from setup, `agentdeck codex`,
+ *  and `agentdeck daemon install`. */
+export function installCodexHooksIfNeeded(opts = {}) {
+    if (envOptOut())
+        return { installed: false, reason: 'AGENTDECK_NO_CODEX_HOOKS=1' };
+    const path = opts.configPath ?? DEFAULT_CODEX_CONFIG_PATH;
+    const original = readText(path);
+    // Refuse to clobber user-authored lifecycle hook config. This line-mode
+    // editor cannot safely merge existing `[features]` or `[hooks]` tables
+    // without a real TOML parser, and duplicate tables would make Codex
+    // reject config.toml.
+    if (hasTableOutsideFence(original, 'features')) {
+        return { installed: false, reason: 'user-authored [features] present' };
+    }
+    if (hasTableOutsideFence(original, 'hooks')) {
+        return { installed: false, reason: 'user-authored [hooks] present' };
+    }
+    const platform = opts.platform ?? process.platform;
+    let includeNotify = !hasTopLevelKeyOutsideFence(original, 'notify');
+    // OTel exporter stays POSIX-only for now — deliberately omitted on
+    // win32 (unverified there); lifecycle hooks + notify carry the signal.
+    const includeOtel = platform !== 'win32' && !hasTableOutsideFence(original, 'otel');
+    let warning;
+    const notifyScriptPath = opts.notifyScriptPath ?? DEFAULT_WINDOWS_NOTIFY_SCRIPT_PATH;
+    if (includeNotify && platform === 'win32') {
+        // The Stop lifecycle hook already reports turn-complete, so a failed
+        // sidecar write downgrades to lifecycle-only rather than aborting.
+        if (!writeScriptIfChanged(windowsNotifyScriptContent(), notifyScriptPath)) {
+            includeNotify = false;
+            warning = `notify sidecar write failed (${notifyScriptPath}) — notify fallback omitted`;
+        }
+    }
+    const otelEndpoint = includeOtel ? buildOtelEndpoint(opts.daemonHttpPort) : undefined;
+    const body = managedBlockBody({
+        includeNotify,
+        includeOtel,
+        otelEndpoint,
+        daemonHttpPort: opts.daemonHttpPort,
+        platform,
+        notifyScriptPath,
+    });
+    const updated = applyManagedBlock(original, body);
+    if (updated === original) {
+        return { installed: true, warning };
+    }
+    if (writeTextAtomic(updated, path)) {
+        return { installed: true, warning };
+    }
+    return { installed: false, reason: `write failed: ${path}` };
+}
+/** Strip the AgentDeck-managed fence. Idempotent — no-op when the fence
+ *  is absent. Does not delete the config file even if it becomes empty
+ *  (Codex may rely on its existence). */
+export function uninstallCodexHooks(opts = {}) {
+    try {
+        unlinkSync(opts.notifyScriptPath ?? DEFAULT_WINDOWS_NOTIFY_SCRIPT_PATH);
+    }
+    catch { /* absent on POSIX installs — nothing to remove */ }
+    const path = opts.configPath ?? DEFAULT_CODEX_CONFIG_PATH;
+    if (!existsSync(path))
+        return;
+    const original = readText(path);
+    const stripped = removeManagedBlock(original);
+    if (stripped !== original)
+        writeTextAtomic(stripped, path);
+}
+/** Re-apply the managed block when the daemon port (or any other resolved
+ *  field) might have changed. Equivalent to install but renamed for the
+ *  daemon-restart code path so the intent is clearer at the call site. */
+export function migrateCodexHooks(opts = {}) {
+    return installCodexHooksIfNeeded(opts);
+}
+//# sourceMappingURL=codex-install.js.map

package/dist/codex-install.js.map

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

package/dist/codex-mini-toml.d.ts

@@ -0,0 +1,22 @@
+export declare const OPEN_FENCE = "# >>> AgentDeck managed (do not edit) <<<";
+export declare const CLOSE_FENCE = "# <<< AgentDeck managed (do not edit) >>>";
+/** Replace the AgentDeck-managed fenced block (or append one when none
+ *  exists). The body is wrapped between OPEN_FENCE / CLOSE_FENCE so
+ *  removeManagedBlock can strip it cleanly later. Returns the full
+ *  updated TOML text. */
+export declare function applyManagedBlock(text: string, body: string): string;
+/** Strip the AgentDeck-managed block entirely. Idempotent — no-op when
+ *  the fence is absent. */
+export declare function removeManagedBlock(text: string): string;
+/** Detect a top-level `<key> = ...` definition outside the fence. Codex
+ *  `notify` is a top-level key; if the user already wrote one our fenced
+ *  `notify` would be a duplicate-key TOML error. */
+export declare function hasTopLevelKeyOutsideFence(text: string, key: string): boolean;
+/** Detect a `[<table>]`, `[<table>.subkey]`, or matching array-of-table
+ *  header outside the fence. Codex `[otel]` / `[features]` / `[hooks]`
+ *  tables collide with the fence we'd write. */
+export declare function hasTableOutsideFence(text: string, table: string): boolean;
+/** Quote a string as a TOML basic string. Escape backslash, double quote,
+ *  and control characters so the output is always single-line safe. */
+export declare function quoted(s: string): string;
+//# sourceMappingURL=codex-mini-toml.d.ts.map

package/dist/codex-mini-toml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-mini-toml.d.ts","sourceRoot":"","sources":["../src/codex-mini-toml.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,UAAU,8CAA8C,CAAC;AACtE,eAAO,MAAM,WAAW,8CAA8C,CAAC;AAEvE;;;yBAGyB;AACzB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAwBpE;AAED;2BAC2B;AAC3B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcvD;AAED;;oDAEoD;AACpD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAkB7E;AAED;;gDAEgD;AAChD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAczE;AAED;uEACuE;AACvE,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAcxC"}

package/dist/codex-mini-toml.js

@@ -0,0 +1,209 @@
+// codex-mini-toml.ts — minimal lossless TOML editor for ~/.codex/config.toml.
+//
+// Direct port of apple/AgentDeck/Daemon/Core/MiniToml.swift. Must stay
+// byte-compatible: the fence sentinels are shared between the App Store
+// Swift daemon and the Node CLI bridge so a config installed by either
+// side can be uninstalled / re-applied by the other.
+//
+// We deliberately do NOT parse TOML semantically. Codex configs contain
+// user-authored keys, comments, profile tables, and MCP server tables that
+// we have no business round-tripping through a semantic serializer.
+// AgentDeck-managed entries live inside a fenced block:
+//
+//     # >>> AgentDeck managed (do not edit) <<<
+//     <our keys>
+//     # <<< AgentDeck managed (do not edit) >>>
+//
+// applyManagedBlock replaces (or appends) the fence; removeManagedBlock
+// strips it. Everything outside the fence is preserved byte-for-byte.
+export const OPEN_FENCE = '# >>> AgentDeck managed (do not edit) <<<';
+export const CLOSE_FENCE = '# <<< AgentDeck managed (do not edit) >>>';
+/** Replace the AgentDeck-managed fenced block (or append one when none
+ *  exists). The body is wrapped between OPEN_FENCE / CLOSE_FENCE so
+ *  removeManagedBlock can strip it cleanly later. Returns the full
+ *  updated TOML text. */
+export function applyManagedBlock(text, body) {
+    const lines = splitLines(text);
+    const fenceRange = locateFence(lines);
+    const bodyLines = body.length === 0 ? [] : splitLines(body);
+    let replacement = [OPEN_FENCE, ...bodyLines, CLOSE_FENCE];
+    if (fenceRange) {
+        const preservedHookState = extractCodexHookState(lines.slice(fenceRange.start + 1, fenceRange.end - 1));
+        if (preservedHookState.length > 0) {
+            replacement = [...replacement, '', ...preservedHookState];
+        }
+        lines.splice(fenceRange.start, fenceRange.end - fenceRange.start, ...replacement);
+    }
+    else {
+        // Pad with a blank line for readability when appending to a non-empty
+        // file. Avoids glueing our fence onto the user's last key.
+        if (lines.length > 0 && lines[lines.length - 1] !== '') {
+            lines.push('');
+        }
+        lines.push(...replacement);
+    }
+    return lines.join('\n');
+}
+/** Strip the AgentDeck-managed block entirely. Idempotent — no-op when
+ *  the fence is absent. */
+export function removeManagedBlock(text) {
+    const lines = splitLines(text);
+    const fenceRange = locateFence(lines);
+    if (!fenceRange)
+        return text;
+    lines.splice(fenceRange.start, fenceRange.end - fenceRange.start);
+    // Collapse a trailing blank line that we may have inserted in
+    // applyManagedBlock so removeManagedBlock truly returns the file to
+    // its pre-apply shape.
+    while (lines.length > 0 && lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    // Restore a single trailing newline if the original ended with one.
+    if (text.endsWith('\n'))
+        lines.push('');
+    return lines.join('\n');
+}
+/** Detect a top-level `<key> = ...` definition outside the fence. Codex
+ *  `notify` is a top-level key; if the user already wrote one our fenced
+ *  `notify` would be a duplicate-key TOML error. */
+export function hasTopLevelKeyOutsideFence(text, key) {
+    const escaped = escapeRegex(key);
+    const regex = new RegExp(`^\\s*${escaped}\\s*=`);
+    let insideFence = false;
+    let insideTable = false;
+    for (const line of splitLines(text)) {
+        if (line === OPEN_FENCE) {
+            insideFence = true;
+            continue;
+        }
+        if (line === CLOSE_FENCE) {
+            insideFence = false;
+            continue;
+        }
+        if (insideFence)
+            continue;
+        const trimmed = line.trim();
+        if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+            insideTable = true;
+            continue;
+        }
+        if (insideTable)
+            continue;
+        if (regex.test(line))
+            return true;
+    }
+    return false;
+}
+/** Detect a `[<table>]`, `[<table>.subkey]`, or matching array-of-table
+ *  header outside the fence. Codex `[otel]` / `[features]` / `[hooks]`
+ *  tables collide with the fence we'd write. */
+export function hasTableOutsideFence(text, table) {
+    const escaped = escapeRegex(table);
+    // Match exactly `[otel]`, `[otel.something]`, `[[otel.something]]`,
+    // but not `[otelfoo]`. Whitespace inside brackets is permissive.
+    const regex = new RegExp(`^\\s*\\[\\[?\\s*${escaped}(\\.[A-Za-z0-9_\\-]+)*\\s*\\]\\]?\\s*$`);
+    let insideFence = false;
+    for (const line of splitLines(text)) {
+        if (line === OPEN_FENCE) {
+            insideFence = true;
+            continue;
+        }
+        if (line === CLOSE_FENCE) {
+            insideFence = false;
+            continue;
+        }
+        if (insideFence)
+            continue;
+        if (table === 'hooks' && isCodexHookStateHeader(line))
+            continue;
+        if (regex.test(line))
+            return true;
+    }
+    return false;
+}
+/** Quote a string as a TOML basic string. Escape backslash, double quote,
+ *  and control characters so the output is always single-line safe. */
+export function quoted(s) {
+    let out = '"';
+    for (const ch of s) {
+        const cp = ch.codePointAt(0);
+        if (ch === '\\')
+            out += '\\\\';
+        else if (ch === '"')
+            out += '\\"';
+        else if (ch === '\n')
+            out += '\\n';
+        else if (ch === '\r')
+            out += '\\r';
+        else if (ch === '\t')
+            out += '\\t';
+        else if (cp < 0x20)
+            out += `\\u${cp.toString(16).padStart(4, '0')}`;
+        else
+            out += ch;
+    }
+    out += '"';
+    return out;
+}
+// ─── internals ──────────────────────────────────────────────────────────
+function splitLines(text) {
+    // String.split('\n') keeps trailing-empty so an input ending in "\n"
+    // round-trips cleanly when re-joined with "\n".
+    return text.split('\n');
+}
+function locateFence(lines) {
+    const start = lines.indexOf(OPEN_FENCE);
+    if (start === -1)
+        return null;
+    // Find first close fence at-or-after start. Defensive against truncated
+    // files: if no close fence is found, treat everything from the open
+    // fence to the end as managed.
+    let end = -1;
+    for (let i = start; i < lines.length; i++) {
+        if (lines[i] === CLOSE_FENCE) {
+            end = i;
+            break;
+        }
+    }
+    if (end === -1)
+        end = lines.length - 1;
+    return { start, end: end + 1 };
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function extractCodexHookState(lines) {
+    const out = [];
+    let capturing = false;
+    for (const line of lines) {
+        const tableHeader = isTableHeader(line);
+        if (isCodexHookStateHeader(line)) {
+            capturing = true;
+            out.push(line);
+            continue;
+        }
+        if (capturing && tableHeader) {
+            break;
+        }
+        if (capturing) {
+            out.push(line);
+        }
+    }
+    while (out.length > 0 && isTrailingNonDataLine(out[out.length - 1])) {
+        out.pop();
+    }
+    return out;
+}
+function isCodexHookStateHeader(line) {
+    const trimmed = line.trim();
+    return trimmed === '[hooks.state]' || (trimmed.startsWith('[hooks.state.') && trimmed.endsWith(']'));
+}
+function isTableHeader(line) {
+    const trimmed = line.trim();
+    return trimmed.startsWith('[') && trimmed.endsWith(']');
+}
+function isTrailingNonDataLine(line) {
+    const trimmed = line.trim();
+    return trimmed.length === 0 || trimmed.startsWith('#');
+}
+//# sourceMappingURL=codex-mini-toml.js.map

package/dist/codex-mini-toml.js.map

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

package/dist/install.d.ts

@@ -1,3 +1,7 @@
+export { installCodexHooksIfNeeded, uninstallCodexHooks, migrateCodexHooks, managedBlockBody as codexManagedBlockBody, DEFAULT_CODEX_CONFIG_PATH, } from './codex-install.js';
+export type { InstallOptions as CodexInstallOptions, InstallResult as CodexInstallResult } from './codex-install.js';
+export { installOpenCodeHooksIfNeeded, uninstallOpenCodeHooks, opencodePluginPath, opencodePluginSource, } from './opencode-install.js';
+export type { OpenCodeInstallOptions, OpenCodeInstallResult } from './opencode-install.js';
 export declare const HOOK_EVENTS: readonly ["SessionStart", "SessionEnd", "PreToolUse", "PostToolUse", "Stop", "Notification", "UserPromptSubmit"];
 /**
  * Shell snippet that resolves the AgentDeck daemon's HTTP port at hook
@@ -10,15 +14,31 @@ export declare const HOOK_EVENTS: readonly ["SessionStart", "SessionEnd", "PreTo
  *      so the hook targets the *owning* daemon even when several daemons
  *      are running in parallel)
  *   2. `~/.agentdeck/daemon.json`                                  (CLI)
- *   3. App Store group container `daemon.json`                     (Swift)
- *   4. `9120` fallback (legacy, never reached in practice)
+ *   3. App Store sandbox container `daemon.json`                   (Swift)
+ *   4. Legacy App Store group container `daemon.json`              (Swift)
+ *   5. `9120` fallback (legacy, never reached in practice)
  *
- * For (2) and (3) the snippet prefers the daemon's `httpPort` field when
+ * For (2)-(4) the snippet prefers the daemon's `httpPort` field when
  * present — Swift runs WS and HTTP on separate ports. Each candidate is
  * verified with a short `/health` probe so a stale daemon.json from a
  * crashed daemon doesn't swallow the hook.
  */
 export declare function buildHookCommand(eventName: string): string;
+/**
+ * Windows variant of `buildHookCommand`. Claude Code v2.1+ executes hook
+ * commands through `cmd.exe` on Windows, so we shell out to PowerShell for
+ * the JSON read + HTTP POST. Discovery is narrower than POSIX since the
+ * macOS App Store sandbox paths don't exist on Windows:
+ *
+ *   1. `$env:AGENTDECK_PORT`
+ *   2. `%USERPROFILE%\.agentdeck\daemon.json` (verified with `/health` probe)
+ *   3. `9120` fallback
+ *
+ * Single quotes are used inside the PowerShell script so the entire `-Command`
+ * argument can stay double-quoted under cmd.exe. Errors are swallowed so a
+ * dead daemon never blocks the host session.
+ */
+export declare function buildHookCommandWin(eventName: string): string;
 export declare function buildHookEntry(eventName: string): {
     matcher: string;
     hooks: any[];

package/dist/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,kHAQd,CAAC;AAEX;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAa1D;AAGD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM;;;EAa/C;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAuB7C;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAwB9C;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAyChF;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,IAAI,CAkBnC;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,IAAI,IAAI,CASrC;AAED;iEACiE;AACjE,wBAAgB,oBAAoB,IAAI,IAAI,CAwB3C"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,IAAI,qBAAqB,EACzC,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,IAAI,mBAAmB,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIrH,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE3F,eAAO,MAAM,WAAW,kHAQd,CAAC;AAEX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA0B1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAe7D;AAGD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM;;;EAgB/C;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAuB7C;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAwB9C;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAyChF;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,IAAI,CAkBnC;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,IAAI,IAAI,CASrC;AAED;iEACiE;AACjE,wBAAgB,oBAAoB,IAAI,IAAI,CAwB3C"}

package/dist/install.js

@@ -1,6 +1,12 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
+// Re-export the Codex installer surface so callers reach it via the
+// canonical `@agentdeck/hooks` entry point alongside the Claude installer.
+export { installCodexHooksIfNeeded, uninstallCodexHooks, migrateCodexHooks, managedBlockBody as codexManagedBlockBody, DEFAULT_CODEX_CONFIG_PATH, } from './codex-install.js';
+// Re-export the OpenCode plugin installer (standalone-session observation
+// via opencode_* lifecycle hooks) through the same canonical entry point.
+export { installOpenCodeHooksIfNeeded, uninstallOpenCodeHooks, opencodePluginPath, opencodePluginSource, } from './opencode-install.js';
 export const HOOK_EVENTS = [
     'SessionStart',
     'SessionEnd',
@@ -21,33 +27,80 @@ export const HOOK_EVENTS = [
  *      so the hook targets the *owning* daemon even when several daemons
  *      are running in parallel)
  *   2. `~/.agentdeck/daemon.json`                                  (CLI)
- *   3. App Store group container `daemon.json`                     (Swift)
- *   4. `9120` fallback (legacy, never reached in practice)
+ *   3. App Store sandbox container `daemon.json`                   (Swift)
+ *   4. Legacy App Store group container `daemon.json`              (Swift)
+ *   5. `9120` fallback (legacy, never reached in practice)
  *
- * For (2) and (3) the snippet prefers the daemon's `httpPort` field when
+ * For (2)-(4) the snippet prefers the daemon's `httpPort` field when
  * present — Swift runs WS and HTTP on separate ports. Each candidate is
  * verified with a short `/health` probe so a stale daemon.json from a
  * crashed daemon doesn't swallow the hook.
  */
 export function buildHookCommand(eventName) {
-    return [
+    const preamble = [
         `PORT="\${AGENTDECK_PORT:-}"`,
         `if [ -z "$PORT" ]; then`,
-        `  for F in "$HOME/.agentdeck/daemon.json" "$HOME/Library/Group Containers/group.bound.serendipity.agentdeck.dashboard/daemon.json"; do`,
+        `  for F in "$HOME/.agentdeck/daemon.json" "$HOME/Library/Containers/bound.serendipity.agent.deck/Data/Library/Application Support/AgentDeck/daemon.json" "$HOME/Library/Group Containers/group.bound.serendipity.agent.deck/daemon.json"; do`,
         `    [ -f "$F" ] || continue`,
         `    P=$(python3 -c "import json;d=json.load(open('$F'));print(d.get('httpPort') or d.get('port',''))" 2>/dev/null)`,
         `    [ -n "$P" ] && curl -sf --max-time 0.3 "http://127.0.0.1:$P/health" >/dev/null 2>&1 && { PORT="$P"; break; }`,
         `  done`,
         `fi`,
         `PORT="\${PORT:-9120}"`,
+    ];
+    // PreToolUse is request-response: the daemon may hold the connection open and
+    // return a permission decision (device approval). Capture the body and echo it
+    // to stdout so Claude can gate the tool; empty output (timeout/error/disabled)
+    // = Claude's normal permission flow. `--max-time 60` exceeds the daemon's
+    // internal 45s "ask" fallback so that fallback reaches Claude before curl quits.
+    if (eventName === 'PreToolUse') {
+        return preamble.concat([
+            `RESP=$(curl -s -X POST "http://127.0.0.1:$PORT/hooks/PreToolUse" -H 'Content-Type: application/json' --max-time 60 -d @- 2>/dev/null)`,
+            `printf '%s' "\${RESP:-}"`,
+        ]).join('\n');
+    }
+    return preamble.concat([
         `curl -sf -X POST "http://127.0.0.1:$PORT/hooks/${eventName}" -H 'Content-Type: application/json' -d @- 2>/dev/null || true`,
-    ].join('\n');
+    ]).join('\n');
+}
+/**
+ * Windows variant of `buildHookCommand`. Claude Code v2.1+ executes hook
+ * commands through `cmd.exe` on Windows, so we shell out to PowerShell for
+ * the JSON read + HTTP POST. Discovery is narrower than POSIX since the
+ * macOS App Store sandbox paths don't exist on Windows:
+ *
+ *   1. `$env:AGENTDECK_PORT`
+ *   2. `%USERPROFILE%\.agentdeck\daemon.json` (verified with `/health` probe)
+ *   3. `9120` fallback
+ *
+ * Single quotes are used inside the PowerShell script so the entire `-Command`
+ * argument can stay double-quoted under cmd.exe. Errors are swallowed so a
+ * dead daemon never blocks the host session.
+ */
+export function buildHookCommandWin(eventName) {
+    const ps = [
+        `$ev='${eventName}'`,
+        `$port=$env:AGENTDECK_PORT`,
+        `if(-not $port){$f=Join-Path $env:USERPROFILE '.agentdeck\\daemon.json'; if(Test-Path $f){try{$d=Get-Content -Raw $f|ConvertFrom-Json; $p=if($d.httpPort){$d.httpPort}else{$d.port}; if($p){try{Invoke-RestMethod -Uri ('http://127.0.0.1:'+$p+'/health') -TimeoutSec 1 -ErrorAction Stop|Out-Null; $port=$p}catch{}}}catch{}}}`,
+        `if(-not $port){$port=9120}`,
+        // Read stdin as UTF-8: [Console]::In decodes piped stdin with the console OEM
+        // codepage (e.g. CP949), garbling non-ASCII payload text.
+        `$body=(New-Object System.IO.StreamReader([Console]::OpenStandardInput(),[System.Text.Encoding]::UTF8)).ReadToEnd()`,
+        // Post UTF-8 bytes: Invoke-RestMethod encodes a string body as ISO-8859-1 when
+        // the content type carries no charset, replacing non-ASCII characters with '?'.
+        `$bytes=[System.Text.Encoding]::UTF8.GetBytes([string]$body)`,
+        `try{Invoke-RestMethod -Uri ('http://127.0.0.1:'+$port+'/hooks/'+$ev) -Method Post -Body $bytes -ContentType 'application/json; charset=utf-8' -TimeoutSec 2 -ErrorAction Stop|Out-Null}catch{}`,
+    ].join('; ');
+    return `powershell -NoProfile -ExecutionPolicy Bypass -Command "${ps}"`;
 }
 // Claude Code v2.1+ requires 3-level nesting: event → matcher group → hook handler.
 export function buildHookEntry(eventName) {
+    const command = process.platform === 'win32'
+        ? buildHookCommandWin(eventName)
+        : buildHookCommand(eventName);
     const handler = {
         type: 'command',
-        command: buildHookCommand(eventName),
+        command,
     };
     // Tool-specific hooks (PreToolUse, PostToolUse) need a glob matcher to fire.
     // Empty string "" means "match nothing" for tool events — use "" for non-tool
@@ -194,12 +247,22 @@ export function migrateHooksIfNeeded() {
     }
 }
 // CLI execution
-const isMainModule = import.meta.url === `file://${process.argv[1]}` ||
-    import.meta.url === new URL(process.argv[1], 'file://').href;
+// Use pathToFileURL so the comparison is correct on Windows too — process.argv[1]
+// is a native path (E:\dev\...\install.js), but import.meta.url is a file:// URL
+// (file:///E:/dev/.../install.js). Manually building `file://${argv[1]}` only
+// matches on POSIX, which is why the installer used to be a silent no-op on
+// Windows.
+import { pathToFileURL } from 'url';
+const isMainModule = process.argv[1] ? import.meta.url === pathToFileURL(process.argv[1]).href : false;
 if (isMainModule) {
     const action = process.argv[2] || 'install';
     if (action === 'uninstall') {
         uninstallHooks();
+        // The OpenCode observer plugin is AgentDeck-owned in its entirety, so
+        // uninstall removes the file (unlike ~/.codex/config.toml, where only
+        // the fenced block is AgentDeck's and removal has its own dedicated
+        // flow to avoid touching user TOML).
+        import('./opencode-install.js').then((m) => m.uninstallOpenCodeHooks()).catch(() => { });
     }
     else {
         installHooks();

package/dist/install.js.map

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

package/dist/opencode-install.d.ts

@@ -0,0 +1,25 @@
+export declare const OPENCODE_PLUGIN_FILENAME = "agentdeck.js";
+/** OpenCode's global config root: `$XDG_CONFIG_HOME/opencode` falling back
+ *  to `~/.config/opencode`. Plugins load from the `plugins/` subdirectory
+ *  (current OpenCode releases; older builds also scanned `plugin/`). */
+export declare function opencodePluginPath(): string;
+export interface OpenCodeInstallOptions {
+    /** Override the plugin file path (tests + non-default homes). */
+    pluginPath?: string;
+}
+export interface OpenCodeInstallResult {
+    installed: boolean;
+    /** Human-readable reason when `installed === false`. */
+    reason?: string;
+}
+/** Assemble the plugin source. Exported so tests can assert schema
+ *  regressions (event names, payload fields, managed-session guard)
+ *  without driving the file installer. */
+export declare function opencodePluginSource(): string;
+/** Install (or refresh) the AgentDeck OpenCode plugin. Idempotent: writes
+ *  only when the on-disk content differs from the current template. Safe to
+ *  call from setup, `agentdeck opencode`, and `agentdeck daemon install`. */
+export declare function installOpenCodeHooksIfNeeded(opts?: OpenCodeInstallOptions): OpenCodeInstallResult;
+/** Remove the AgentDeck OpenCode plugin. Idempotent — no-op when absent. */
+export declare function uninstallOpenCodeHooks(opts?: OpenCodeInstallOptions): void;
+//# sourceMappingURL=opencode-install.d.ts.map

package/dist/opencode-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-install.d.ts","sourceRoot":"","sources":["../src/opencode-install.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAEvD;;wEAEwE;AACxE,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD;;0CAE0C;AAC1C,wBAAgB,oBAAoB,IAAI,MAAM,CAwJ7C;AAeD;;6EAE6E;AAC7E,wBAAgB,4BAA4B,CAAC,IAAI,GAAE,sBAA2B,GAAG,qBAAqB,CAerG;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,sBAA2B,GAAG,IAAI,CAK9E"}

package/dist/opencode-install.js

@@ -0,0 +1,241 @@
+// opencode-install.ts — Install the AgentDeck observation plugin into
+// OpenCode's global plugin directory so standalone `opencode` sessions
+// report turn boundaries to the daemon as opencode_* lifecycle hooks.
+//
+// Why a plugin and not PTY parsing or an SSE attach: OpenCode has no
+// lifecycle-hook config (unlike Claude Code / Codex), and a standalone
+// `opencode` TUI does not listen on any TCP port (the embedded server
+// only exists when launched with `--port`, i.e. managed sessions), so
+// the documented plugin API is the only stable, update-resilient way to
+// observe sessions the user starts outside `agentdeck opencode`. This is
+// the hooks-first direction: no terminal-output parsing anywhere.
+//
+// The plugin file is wholly AgentDeck-owned (header sentinel + version).
+// Install is idempotent: re-running writes only when content changed.
+// Managed sessions are excluded inside the plugin itself via the
+// AGENTDECK_PORT env marker (see plugin source below) — their session
+// bridge already ingests the richer SSE stream, and double-posting would
+// double-count every turn.
+//
+// Counterpart consumers:
+//   - bridge/src/daemon-server.ts /hooks/ handler (opencode_* → shared
+//     observed-session pipeline: APME run/turn + chat_start/chat_response)
+//   - apple .../DaemonServer.swift ignores opencode_* events (timeline
+//     parity on the Swift daemon is a documented follow-up).
+import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync, unlinkSync } from 'fs';
+import { dirname, join } from 'path';
+import { homedir } from 'os';
+export const OPENCODE_PLUGIN_FILENAME = 'agentdeck.js';
+/** OpenCode's global config root: `$XDG_CONFIG_HOME/opencode` falling back
+ *  to `~/.config/opencode`. Plugins load from the `plugins/` subdirectory
+ *  (current OpenCode releases; older builds also scanned `plugin/`). */
+export function opencodePluginPath() {
+    const xdg = process.env.XDG_CONFIG_HOME;
+    const configRoot = xdg && xdg.trim() ? xdg : join(homedir(), '.config');
+    return join(configRoot, 'opencode', 'plugins', OPENCODE_PLUGIN_FILENAME);
+}
+/** Honour `AGENTDECK_NO_OPENCODE_HOOKS=1` from the environment (same
+ *  opt-out contract as AGENTDECK_NO_CODEX_HOOKS). */
+function envOptOut() {
+    return process.env.AGENTDECK_NO_OPENCODE_HOOKS === '1';
+}
+const PLUGIN_VERSION = 1;
+/** Assemble the plugin source. Exported so tests can assert schema
+ *  regressions (event names, payload fields, managed-session guard)
+ *  without driving the file installer. */
+export function opencodePluginSource() {
+    return `// agentdeck-opencode-plugin v${PLUGIN_VERSION} — AUTO-GENERATED by AgentDeck.
+// Do not edit: reinstalls overwrite this file. Remove it (or set
+// AGENTDECK_NO_OPENCODE_HOOKS=1 before installing) to opt out.
+//
+// Forwards OpenCode lifecycle events to the AgentDeck daemon as
+// opencode_* hooks — the same observed-session pipeline Claude Code and
+// Codex use — so standalone \`opencode\` sessions appear on the AgentDeck
+// timeline with the same prompt → response turn shape. Every POST is
+// fire-and-forget with a hard timeout; OpenCode never blocks on AgentDeck.
+
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+const PORT_TTL_MS = 60000;
+let cachedPort = null;
+let cachedAt = 0;
+
+async function resolvePort() {
+  const now = Date.now();
+  if (cachedPort && now - cachedAt < PORT_TTL_MS) return cachedPort;
+  const home = homedir();
+  const candidates = [];
+  for (const f of [
+    join(home, ".agentdeck", "daemon.json"),
+    join(home, "Library/Containers/bound.serendipity.agent.deck/Data/Library/Application Support/AgentDeck/daemon.json"),
+    join(home, "Library/Group Containers/group.bound.serendipity.agent.deck/daemon.json"),
+  ]) {
+    try {
+      const d = JSON.parse(readFileSync(f, "utf-8"));
+      const p = d.httpPort || d.port;
+      if (typeof p === "number" && p > 0 && !candidates.includes(p)) candidates.push(p);
+    } catch { /* missing/malformed — try next */ }
+  }
+  if (!candidates.includes(9120)) candidates.push(9120);
+  for (const p of candidates) {
+    try {
+      const r = await fetch("http://127.0.0.1:" + p + "/health", { signal: AbortSignal.timeout(300) });
+      if (r.ok) { cachedPort = p; cachedAt = now; return p; }
+    } catch { /* dead port — try next */ }
+  }
+  return null;
+}
+
+function post(event, body) {
+  resolvePort().then((port) => {
+    if (!port) return;
+    return fetch("http://127.0.0.1:" + port + "/hooks/" + event, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(800),
+    });
+  }).catch(() => { /* daemon down — observation is best-effort */ });
+}
+
+export const AgentDeckObserver = async ({ directory }) => {
+  // Managed \`agentdeck opencode\` sessions already stream structured SSE
+  // events through their session bridge; posting hooks too would
+  // double-count every turn. AGENTDECK_PORT marks a managed PTY.
+  if (process.env.AGENTDECK_PORT) return {};
+
+  const cwd = directory;
+  const announced = new Set();   // sessionIDs whose opencode_session_start was posted
+  const userMsgs = new Map();    // user messageID -> sessionID
+  const promptSent = new Set();  // user messageIDs whose prompt_submit was posted
+  const promptTimers = new Map();// user messageID -> flush timer
+  const responses = new Map();   // sessionID -> latest assistant text
+  const startedAt = new Map();   // sessionID -> turn start ms
+  const toolPhase = new Map();   // tool callID -> "start" | "end"
+
+  function announce(sessionID) {
+    if (!sessionID || announced.has(sessionID)) return;
+    announced.add(sessionID);
+    post("opencode_session_start", { session_id: sessionID, cwd });
+  }
+
+  function sendPrompt(messageID, sessionID, prompt) {
+    if (promptSent.has(messageID)) return;
+    promptSent.add(messageID);
+    const t = promptTimers.get(messageID);
+    if (t) { clearTimeout(t); promptTimers.delete(messageID); }
+    if (!startedAt.has(sessionID)) startedAt.set(sessionID, Date.now());
+    post("opencode_user_prompt_submit", { session_id: sessionID, prompt: prompt || "", cwd });
+  }
+
+  return {
+    event: async ({ event }) => {
+      try {
+        const type = event.type;
+        const props = event.properties || {};
+        if (type === "message.updated") {
+          const info = props.info || {};
+          const sessionID = info.sessionID;
+          announce(sessionID);
+          if (info.role === "user" && info.id) {
+            userMsgs.set(info.id, sessionID);
+            // Prompt text usually streams via message.part.updated moments
+            // later; flush immediately when the info carries it, otherwise
+            // wait briefly so the chat_start row shows the real prompt.
+            const direct = typeof info.text === "string" ? info.text
+              : (typeof info.content === "string" ? info.content : "");
+            if (direct.trim()) {
+              sendPrompt(info.id, sessionID, direct.trim());
+            } else if (!promptTimers.has(info.id) && !promptSent.has(info.id)) {
+              const timer = setTimeout(() => sendPrompt(info.id, sessionID, ""), 800);
+              if (typeof timer.unref === "function") timer.unref();
+              promptTimers.set(info.id, timer);
+            }
+          }
+        } else if (type === "message.part.updated") {
+          const part = props.part || {};
+          const sessionID = part.sessionID;
+          announce(sessionID);
+          if (part.type === "text" && typeof part.text === "string") {
+            const owner = userMsgs.get(part.messageID);
+            if (owner) sendPrompt(part.messageID, owner, part.text.trim());
+            else responses.set(sessionID, part.text);
+          } else if (part.type === "tool" && part.callID) {
+            const status = (part.state && part.state.status) || "running";
+            const phase = toolPhase.get(part.callID);
+            if (status === "completed" || status === "error") {
+              if (phase !== "end") {
+                toolPhase.set(part.callID, "end");
+                post("opencode_tool_end", { session_id: sessionID, tool_name: part.tool || "tool", cwd });
+              }
+            } else if (!phase) {
+              toolPhase.set(part.callID, "start");
+              post("opencode_tool_start", { session_id: sessionID, tool_name: part.tool || "tool", cwd });
+            }
+            if (toolPhase.size > 512) toolPhase.clear();
+          }
+        } else if (type === "session.idle") {
+          const sessionID = props.sessionID;
+          announce(sessionID);
+          post("opencode_stop", {
+            session_id: sessionID,
+            last_assistant_message: responses.get(sessionID) || "",
+            cwd,
+          });
+          responses.delete(sessionID);
+          startedAt.delete(sessionID);
+          for (const [mid, sid] of userMsgs) {
+            if (sid === sessionID) { userMsgs.delete(mid); promptSent.delete(mid); }
+          }
+        }
+      } catch { /* never throw into OpenCode's event loop */ }
+    },
+  };
+};
+`;
+}
+function writeTextAtomic(text, path) {
+    const dir = dirname(path);
+    try {
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const tmp = `${path}.agentdeck.tmp`;
+        writeFileSync(tmp, text, 'utf-8');
+        renameSync(tmp, path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Install (or refresh) the AgentDeck OpenCode plugin. Idempotent: writes
+ *  only when the on-disk content differs from the current template. Safe to
+ *  call from setup, `agentdeck opencode`, and `agentdeck daemon install`. */
+export function installOpenCodeHooksIfNeeded(opts = {}) {
+    if (envOptOut())
+        return { installed: false, reason: 'AGENTDECK_NO_OPENCODE_HOOKS=1' };
+    const path = opts.pluginPath ?? opencodePluginPath();
+    const desired = opencodePluginSource();
+    try {
+        if (existsSync(path) && readFileSync(path, 'utf-8') === desired) {
+            return { installed: true };
+        }
+    }
+    catch { /* unreadable — rewrite below */ }
+    if (writeTextAtomic(desired, path)) {
+        return { installed: true };
+    }
+    return { installed: false, reason: `write failed: ${path}` };
+}
+/** Remove the AgentDeck OpenCode plugin. Idempotent — no-op when absent. */
+export function uninstallOpenCodeHooks(opts = {}) {
+    const path = opts.pluginPath ?? opencodePluginPath();
+    try {
+        if (existsSync(path))
+            unlinkSync(path);
+    }
+    catch { /* best-effort */ }
+}
+//# sourceMappingURL=opencode-install.js.map

package/dist/opencode-install.js.map

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

package/package.json

@@ -1,13 +1,8 @@
 {
   "name": "@agentdeck/hooks",
-  "version": "0.2.0",
+  "version": "0.2.3",
+  "private": false,
   "type": "module",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/puritysb/AgentDeck.git",
-    "directory": "hooks"
-  },
   "files": [
     "dist",
     "!dist/__tests__"