sessionpipe-core 0.7.0 → 0.10.0

package/dist/service.js

@@ -0,0 +1,155 @@
+// sessionpipe-core 0.10.0 · Apache-2.0 · https://sessionpipe.org
+
+// src/service/index.ts
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+var execQuiet = (cmd, args) => execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 15e3 });
+var xml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+var sd = (s) => `"${s.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/%/g, "%%")}"`;
+function serviceFiles(s) {
+  const home = s.home ?? os.homedir();
+  const env = (manager) => ({ SESSIONPIPE_SERVICE: manager, ...s.env });
+  const plistEnv = Object.entries(env("launchd")).map(([k, v]) => `<key>${xml(k)}</key><string>${xml(v)}</string>`).join("");
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>${xml(s.label)}</string>
+  <key>ProgramArguments</key>
+  <array>${s.argv.map((a) => `<string>${xml(a)}</string>`).join("")}</array>
+  <key>EnvironmentVariables</key><dict>${plistEnv}</dict>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><dict><key>SuccessfulExit</key><false/></dict>
+  <key>ProcessType</key><string>Background</string>
+  <key>StandardOutPath</key><string>${xml(s.logPath)}</string>
+  <key>StandardErrorPath</key><string>${xml(s.logPath)}</string>
+</dict>
+</plist>
+`;
+  const unitEnv = Object.entries(env("systemd")).map(([k, v]) => `Environment=${k === "SESSIONPIPE_SERVICE" ? `${k}=${v}` : sd(`${k}=${v}`)}`).join("\n");
+  const unit = `[Unit]
+Description=${s.description.replace(/\n/g, " ")}
+After=network-online.target
+
+[Service]
+ExecStart=${s.argv.map(sd).join(" ")}
+${unitEnv}
+Restart=on-failure
+RestartForceExitStatus=75
+RestartSec=5
+
+[Install]
+WantedBy=default.target
+`;
+  return {
+    plist: { path: path.join(home, "Library", "LaunchAgents", `${s.label}.plist`), text: plist },
+    unit: { path: path.join(home, ".config", "systemd", "user", s.unit), text: unit }
+  };
+}
+function ensureLinger(user, exec = execQuiet) {
+  const lingering = () => {
+    try {
+      return /^Linger=yes/m.test(exec("loginctl", ["show-user", user, "--property=Linger"]));
+    } catch {
+      return false;
+    }
+  };
+  if (lingering()) return { on: true, note: "it keeps running after you log out (linger was already on)" };
+  try {
+    exec("loginctl", ["enable-linger", user]);
+  } catch {
+  }
+  if (lingering()) return { on: true, note: "it keeps running after you log out (turned linger on)" };
+  return {
+    on: false,
+    note: `it stops when you log out: run \`sudo loginctl enable-linger ${user}\` once to keep it running`
+  };
+}
+var line = (cmd, args) => [cmd, ...args].join(" ");
+function installService(o) {
+  const f = serviceFiles(o);
+  const platform = o.platform ?? process.platform;
+  const uid = o.uid ?? String(process.getuid?.() ?? "");
+  const commands = [];
+  const real = o.exec ?? execQuiet;
+  const run = (cmd, args) => {
+    commands.push(line(cmd, args));
+    return o.dryRun ? "" : real(cmd, args);
+  };
+  const write = (file) => {
+    if (o.dryRun) return;
+    mkdirSync(path.dirname(file.path), { recursive: true });
+    writeFileSync(file.path, file.text);
+  };
+  if (platform === "darwin") {
+    write(f.plist);
+    for (const d of ["gui", "user"])
+      try {
+        run("launchctl", ["bootout", `${d}/${uid}/${o.label}`]);
+      } catch {
+      }
+    try {
+      run("launchctl", ["bootstrap", `gui/${uid}`, f.plist.path]);
+      return { files: [f.plist], commands, manager: "launchd", domain: "gui" };
+    } catch {
+    }
+    run("launchctl", ["bootstrap", `user/${uid}`, f.plist.path]);
+    return { files: [f.plist], commands, manager: "launchd", domain: "user" };
+  }
+  if (platform === "linux") {
+    write(f.unit);
+    try {
+      run("systemctl", ["--user", "daemon-reload"]);
+      run("systemctl", ["--user", "enable", "--now", o.unit]);
+    } catch {
+      return { files: [f.unit], commands, manager: null, unreachable: f.unit.path };
+    }
+    const user = o.user ?? os.userInfo().username;
+    if (o.dryRun) {
+      commands.push(line("loginctl", ["enable-linger", user]));
+      return { files: [f.unit], commands, manager: "systemd", linger: { on: false, note: "dry run" } };
+    }
+    return { files: [f.unit], commands, manager: "systemd", linger: ensureLinger(user, run) };
+  }
+  return { files: [], commands, manager: null };
+}
+function uninstallService(o) {
+  const f = serviceFiles({ ...o, description: "", argv: [], logPath: "" });
+  const platform = o.platform ?? process.platform;
+  const uid = o.uid ?? String(process.getuid?.() ?? "");
+  const commands = [];
+  const files = [];
+  const real = o.exec ?? execQuiet;
+  const run = (cmd, args) => {
+    commands.push(line(cmd, args));
+    if (o.dryRun) return;
+    try {
+      real(cmd, args);
+    } catch {
+    }
+  };
+  const remove = (file) => {
+    files.push(file);
+    if (!o.dryRun) unlinkSync(file);
+  };
+  if (platform === "darwin" && existsSync(f.plist.path)) {
+    run("launchctl", ["bootout", `gui/${uid}/${o.label}`]);
+    run("launchctl", ["bootout", `user/${uid}/${o.label}`]);
+    remove(f.plist.path);
+  }
+  if (platform === "linux" && existsSync(f.unit.path)) {
+    run("systemctl", ["--user", "disable", "--now", o.unit]);
+    remove(f.unit.path);
+    run("systemctl", ["--user", "daemon-reload"]);
+  }
+  return { files, commands };
+}
+export {
+  ensureLinger,
+  installService,
+  serviceFiles,
+  uninstallService
+};
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/service/index.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: Apache-2.0\n/** sessionpipe-core/service \u2014 a per-user background service for a sessionpipe process:\n *  a launchd agent on macOS, a systemd user unit on Linux. The control daemon runs\n *  under it (`org.sessionpipe.control`), and so can a receiver of the person's own (a\n *  board on their machine), with the same files and the same commands. Node only: it\n *  writes files and runs launchctl, systemctl and loginctl, so it is never part of the\n *  root export, which stays Worker- and browser-safe.\n *\n *  Both files restart the process when it exits non-zero, and when it exits\n *  UPDATE_EXIT (75, sessionpipe-core/version) to come back on new code. The process is\n *  told which manager that is in SESSIONPIPE_SERVICE (`launchd`, `systemd`). Nothing\n *  here needs root, and a dry run touches nothing: it answers the files it would write\n *  and the commands it would run. */\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync, mkdirSync, unlinkSync, writeFileSync } from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\n/** One service, as both managers need it. */\nexport interface ServiceSpec {\n  /** The launchd label, also the plist's name: `org.sessionpipe.control`. */\n  label: string;\n  /** The systemd user unit's file name: `sessionpipe-control.service`. */\n  unit: string;\n  /** The unit's Description line. */\n  description: string;\n  /** The program and its arguments, each one argument (never through a shell). */\n  argv: string[];\n  /** More environment for the process, beside SESSIONPIPE_SERVICE. */\n  env?: Record<string, string>;\n  /** Where launchd writes its stdout and stderr (journald keeps a unit's). */\n  logPath: string;\n  /** The home the files go under; the user's own by default. */\n  home?: string;\n}\n\n/** A file the service writes, and what is in it. */\nexport interface ServiceFile {\n  path: string;\n  text: string;\n}\n\n/** Runs one command and answers its stdout; throws when it fails. */\nexport type Exec = (cmd: string, args: string[]) => string;\n\nconst execQuiet: Exec = (cmd, args) =>\n  execFileSync(cmd, args, { encoding: \"utf8\", stdio: [\"ignore\", \"pipe\", \"ignore\"], timeout: 15_000 });\n\nconst xml = (s: string) => s.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\");\n/** One systemd argument, quoted: backslashes and quotes escaped, `%` doubled (a specifier otherwise). */\nconst sd = (s: string) => `\"${s.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"').replace(/%/g, \"%%\")}\"`;\n\n/** The plist and the unit for a service, and where each goes. */\nexport function serviceFiles(s: ServiceSpec): { plist: ServiceFile; unit: ServiceFile } {\n  const home = s.home ?? os.homedir();\n  const env = (manager: string) => ({ SESSIONPIPE_SERVICE: manager, ...s.env });\n  const plistEnv = Object.entries(env(\"launchd\"))\n    .map(([k, v]) => `<key>${xml(k)}</key><string>${xml(v)}</string>`)\n    .join(\"\");\n  const plist = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n  <key>Label</key><string>${xml(s.label)}</string>\n  <key>ProgramArguments</key>\n  <array>${s.argv.map((a) => `<string>${xml(a)}</string>`).join(\"\")}</array>\n  <key>EnvironmentVariables</key><dict>${plistEnv}</dict>\n  <key>RunAtLoad</key><true/>\n  <key>KeepAlive</key><dict><key>SuccessfulExit</key><false/></dict>\n  <key>ProcessType</key><string>Background</string>\n  <key>StandardOutPath</key><string>${xml(s.logPath)}</string>\n  <key>StandardErrorPath</key><string>${xml(s.logPath)}</string>\n</dict>\n</plist>\n`;\n  const unitEnv = Object.entries(env(\"systemd\"))\n    .map(([k, v]) => `Environment=${k === \"SESSIONPIPE_SERVICE\" ? `${k}=${v}` : sd(`${k}=${v}`)}`)\n    .join(\"\\n\");\n  const unit = `[Unit]\nDescription=${s.description.replace(/\\n/g, \" \")}\nAfter=network-online.target\n\n[Service]\nExecStart=${s.argv.map(sd).join(\" \")}\n${unitEnv}\nRestart=on-failure\nRestartForceExitStatus=75\nRestartSec=5\n\n[Install]\nWantedBy=default.target\n`;\n  return {\n    plist: { path: path.join(home, \"Library\", \"LaunchAgents\", `${s.label}.plist`), text: plist },\n    unit: { path: path.join(home, \".config\", \"systemd\", \"user\", s.unit), text: unit },\n  };\n}\n\n/** A systemd user service stops when its person's last login ends \u2014 closing the ssh\n *  session to a lab workstation or a cloud machine stopped the daemon with it \u2014 unless\n *  the user lingers. `loginctl enable-linger` for yourself needs no root on systemd's\n *  default policy; where it does, say the one command that does it. */\nexport function ensureLinger(user: string, exec: Exec = execQuiet): { on: boolean; note: string } {\n  const lingering = () => {\n    try {\n      return /^Linger=yes/m.test(exec(\"loginctl\", [\"show-user\", user, \"--property=Linger\"]));\n    } catch {\n      return false;\n    }\n  };\n  if (lingering()) return { on: true, note: \"it keeps running after you log out (linger was already on)\" };\n  try {\n    exec(\"loginctl\", [\"enable-linger\", user]);\n  } catch {}\n  if (lingering()) return { on: true, note: \"it keeps running after you log out (turned linger on)\" };\n  return {\n    on: false,\n    note: `it stops when you log out: run \\`sudo loginctl enable-linger ${user}\\` once to keep it running`,\n  };\n}\n\n/** What an install did, or would do in a dry run. */\nexport interface ServicePlan {\n  /** The files written (or that would be). */\n  files: ServiceFile[];\n  /** The commands run (or that would be), one string each, in order. */\n  commands: string[];\n  /** Which manager runs it now: null on a platform with none, or where it isn't reachable. */\n  manager: \"launchd\" | \"systemd\" | null;\n  /** launchd: `gui` when someone is at the screen, else `user` (it starts again at the next login there). */\n  domain?: \"gui\" | \"user\";\n  /** systemd: whether it outlives the login, in words. */\n  linger?: { on: boolean; note: string };\n  /** The file that was written for a manager that couldn't be reached. */\n  unreachable?: string;\n}\n\nexport interface InstallOptions extends ServiceSpec {\n  /** Answer the plan and touch nothing. */\n  dryRun?: boolean;\n  exec?: Exec;\n  platform?: NodeJS.Platform;\n  /** The user's id (launchd's domains) and name (linger); this process's by default. */\n  uid?: string;\n  user?: string;\n}\n\nconst line = (cmd: string, args: string[]) => [cmd, ...args].join(\" \");\n\n/** Write the service for this platform and start it now; a service already there is\n *  replaced (launchd: booted out first). */\nexport function installService(o: InstallOptions): ServicePlan {\n  const f = serviceFiles(o);\n  const platform = o.platform ?? process.platform;\n  const uid = o.uid ?? String(process.getuid?.() ?? \"\");\n  const commands: string[] = [];\n  const real = o.exec ?? execQuiet;\n  const run: Exec = (cmd, args) => {\n    commands.push(line(cmd, args));\n    return o.dryRun ? \"\" : real(cmd, args);\n  };\n  const write = (file: ServiceFile) => {\n    if (o.dryRun) return;\n    mkdirSync(path.dirname(file.path), { recursive: true });\n    writeFileSync(file.path, file.text);\n  };\n  if (platform === \"darwin\") {\n    write(f.plist);\n    for (const d of [\"gui\", \"user\"])\n      try {\n        run(\"launchctl\", [\"bootout\", `${d}/${uid}/${o.label}`]);\n      } catch {}\n    try {\n      run(\"launchctl\", [\"bootstrap\", `gui/${uid}`, f.plist.path]);\n      return { files: [f.plist], commands, manager: \"launchd\", domain: \"gui\" };\n    } catch {}\n    // No one logged in at the screen (an ssh session to a Mac mini): the gui domain\n    // doesn't exist. The user domain runs it now; after a restart it starts again at\n    // the next login at the screen.\n    run(\"launchctl\", [\"bootstrap\", `user/${uid}`, f.plist.path]);\n    return { files: [f.plist], commands, manager: \"launchd\", domain: \"user\" };\n  }\n  if (platform === \"linux\") {\n    write(f.unit);\n    try {\n      run(\"systemctl\", [\"--user\", \"daemon-reload\"]);\n      run(\"systemctl\", [\"--user\", \"enable\", \"--now\", o.unit]);\n    } catch {\n      return { files: [f.unit], commands, manager: null, unreachable: f.unit.path };\n    }\n    const user = o.user ?? os.userInfo().username;\n    if (o.dryRun) {\n      commands.push(line(\"loginctl\", [\"enable-linger\", user]));\n      return { files: [f.unit], commands, manager: \"systemd\", linger: { on: false, note: \"dry run\" } };\n    }\n    return { files: [f.unit], commands, manager: \"systemd\", linger: ensureLinger(user, run) };\n  }\n  return { files: [], commands, manager: null };\n}\n\nexport interface UninstallOptions {\n  label: string;\n  unit: string;\n  home?: string;\n  dryRun?: boolean;\n  exec?: Exec;\n  platform?: NodeJS.Platform;\n  uid?: string;\n}\n\n/** Stop the service and remove its file, where this platform has one; nothing where\n *  there is none. A manager that says it wasn't loaded is no failure. */\nexport function uninstallService(o: UninstallOptions): { files: string[]; commands: string[] } {\n  const f = serviceFiles({ ...o, description: \"\", argv: [], logPath: \"\" });\n  const platform = o.platform ?? process.platform;\n  const uid = o.uid ?? String(process.getuid?.() ?? \"\");\n  const commands: string[] = [];\n  const files: string[] = [];\n  const real = o.exec ?? execQuiet;\n  const run = (cmd: string, args: string[]) => {\n    commands.push(line(cmd, args));\n    if (o.dryRun) return;\n    try {\n      real(cmd, args);\n    } catch {}\n  };\n  const remove = (file: string) => {\n    files.push(file);\n    if (!o.dryRun) unlinkSync(file);\n  };\n  if (platform === \"darwin\" && existsSync(f.plist.path)) {\n    run(\"launchctl\", [\"bootout\", `gui/${uid}/${o.label}`]);\n    run(\"launchctl\", [\"bootout\", `user/${uid}/${o.label}`]);\n    remove(f.plist.path);\n  }\n  if (platform === \"linux\" && existsSync(f.unit.path)) {\n    run(\"systemctl\", [\"--user\", \"disable\", \"--now\", o.unit]);\n    remove(f.unit.path);\n    run(\"systemctl\", [\"--user\", \"daemon-reload\"]);\n  }\n  return { files, commands };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/adapters/acp-control.d.ts

@@ -0,0 +1,87 @@
+import { type Mode } from "./headless.js";
+export interface AcpAgent {
+    /** sessionpipe's harness name (ADAPTERS.md): the registry's id unless a hook adapter already named it. */
+    harness: string;
+    /** The registry's id. */
+    registry: string;
+    label: string;
+    /** The CLI's name on PATH. */
+    bin: string;
+    args: string[];
+}
+/** The agents the daemon can drive, with the launch line the registry publishes. */
+export declare const ACP_AGENTS: readonly AcpAgent[];
+export declare const ACP_HARNESSES: readonly string[];
+export declare const acpAgent: (harness: string) => AcpAgent | undefined;
+/** The env var that names an agent's CLI by hand: `SESSIONPIPE_ACP_GEMINI_CLI`. */
+export declare const acpOverride: (harness: string) => string;
+/** An agent's CLI on this machine: the override, else on PATH, else beside the node
+ *  running this (an `npm install -g` there) or where the installers put it. */
+export declare function findAcpAgent(harness: string, env?: NodeJS.ProcessEnv, home?: string, nodeDir?: string): {
+    bin: string;
+    args: string[];
+} | null;
+/** The ACP agents installed here, by harness name, for the daemon's hello. */
+export declare function acpHarnesses(env?: NodeJS.ProcessEnv): string[];
+type Json = Record<string, unknown>;
+interface Option {
+    optionId: string;
+    kind: string;
+}
+/** Which permission option the machine's mode picks, or null for `cancelled`: safe
+ *  refuses (once, else always), auto allows (once, else always). Inherit refuses as safe
+ *  does: the agent asked because its own settings want a person, and none is there.
+ *  Never the other way. */
+export declare function permissionChoice(options: unknown, mode: Mode): Option | null;
+/** A JSON-RPC error in words: its message, and its `data` where that says more (goose
+ *  1.55 answers session/new with "Internal error" and the reason in `data`). */
+export declare function errorWords(err: Json): string;
+/** A session the daemon holds (the shape of daemon.ts's SdkSession, plus the agent's own id). */
+export interface AcpHeld {
+    /** Deliver one message; resolves with the agent's reply when the turn ends. */
+    send(text: string): Promise<{
+        reply: string;
+        error?: string;
+    }>;
+    interrupt(): Promise<void>;
+    close(): void;
+    readonly busy: boolean;
+    readonly lastUsed: number;
+    readonly mode: "api";
+    /** The id the agent gave the session. */
+    readonly session: string;
+    /** The process is gone or was closed: nothing more can be sent. */
+    readonly closed: boolean;
+}
+export interface AcpOptions {
+    bin: string;
+    args: string[];
+    cwd: string;
+    mode: Mode;
+    label: string;
+    env?: NodeJS.ProcessEnv;
+    /** Reopen this session of the agent's (`session/load`) instead of starting a new one. */
+    load?: string;
+    /** The reply so far, each time it grows. */
+    onText?: (text: string) => void;
+    log?: (line: string) => void;
+    now?: () => number;
+    /** A turn still running after this is cancelled, then stopped. */
+    timeoutMs?: number;
+    /** How long the agent may take to answer `initialize` and open the session. */
+    openTimeoutMs?: number;
+    /** On close, how long the agent gets to leave by itself before SIGTERM (then SIGKILL). */
+    closeGraceMs?: number;
+}
+export type AcpStart = {
+    held: AcpHeld;
+} | {
+    failed: string;
+} | {
+    unsupported: string;
+};
+/** Run an ACP agent and open a session in it. Resolves once the agent has answered
+ *  `session/new` (or `session/load`); every later turn goes through `held.send`. */
+export declare function startAcp(o: AcpOptions): Promise<AcpStart>;
+export {};
+//# sourceMappingURL=acp-control.d.ts.map

package/dist/src/adapters/acp-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-control.d.ts","sourceRoot":"","sources":["../../../src/adapters/acp-control.ts"],"names":[],"mappings":"AAeA,OAAO,EAAkD,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1F,MAAM,WAAW,QAAQ;IACvB,0GAA0G;IAC1G,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,oFAAoF;AACpF,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EA0CzC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAqC,CAAC;AAEjF,eAAO,MAAM,QAAQ,YAAa,MAAM,KAAG,QAAQ,GAAG,SAA0D,CAAC;AAEjH,mFAAmF;AACnF,eAAO,MAAM,WAAW,YAAa,MAAM,KAAG,MAAuE,CAAC;AAEtH;+EAC+E;AAC/E,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,SAAe,EACnB,OAAO,SAAiC,GACvC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAgBxC;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAE3E;AAED,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAIpC,UAAU,MAAM;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;2BAG2B;AAC3B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAW5E;AAED;gFACgF;AAChF,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAI5C;AASD,iGAAiG;AACjG,MAAM,WAAW,OAAO;IACtB,+EAA+E;IAC/E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAIxF;oFACoF;AACpF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CA+QzD"}

package/dist/src/adapters/antigravity-control.d.ts

@@ -1,14 +1,24 @@
+import type { RunLevel, StartPermission } from "../control/verify.js";
 import { type Mode, type Reading, type RunResult } from "./headless.js";
 /** The `agy` to run: SESSIONPIPE_AGY, else on PATH, else where its installer puts it. */
 export declare function findAgy(env?: NodeJS.ProcessEnv, home?: string): string | null;
-/** Permission flags for the machine's mode. Safe: none — agy denies every tool call
- *  nobody is there to approve, and says which. Auto: `--mode accept-edits`. Never
- *  `--dangerously-skip-permissions`: no path here writes it. */
-export declare function agyModeFlags(mode: Mode): string[];
+/** Permission flags for a level. Safe: none — agy denies every tool call nobody is
+ *  there to approve, and says which. Edits: `--mode accept-edits`, its widest, which is
+ *  also what an auto machine's mode means for it. Inherit: none either, so agy runs as
+ *  it would by itself. agy has no read-only mode known, so `read` is never offered and
+ *  throws rather than run at safe. Never `--dangerously-skip-permissions`: no path here
+ *  writes it. */
+export declare function agyModeFlags(level: RunLevel): string[];
+/** The levels a start may ask agy for on a machine in `mode`: safe, and edits on an
+ *  auto machine. */
+export declare const offeredLevels: (mode: Mode) => StartPermission[];
+/** What a start that names no level gets, said as what it is: edits on an auto machine,
+ *  no flag on an inherit one. */
+export declare const defaultLevel: (mode: Mode) => RunLevel;
 /** One headless turn in the folder it is spawned in. A message that starts with a dash
  *  would read as a flag after `-p`; a leading space keeps it the prompt. */
 export declare function agyArgs(o: {
-    mode: Mode;
+    permission: RunLevel;
     prompt: string;
     resume?: string;
 }): string[];

package/dist/src/adapters/antigravity-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"antigravity-control.d.ts","sourceRoot":"","sources":["../../../src/adapters/antigravity-control.ts"],"names":[],"mappings":"AAUA,OAAO,EAAkC,KAAK,IAAI,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,eAAe,CAAC;AAIpH,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,SAAe,GAAG,MAAM,GAAG,IAAI,CAOhG;AAED;;gEAEgE;AAChE,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAEjD;AAED;4EAC4E;AAC5E,wBAAgB,OAAO,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAUpF;AAED,yCAAyC;AACzC,eAAO,MAAM,MAAM,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,MAAM,CAAC,UAAyB,CAAC;AAE/F,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,0BAA0B;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAgCrD;AAYD,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAU3D;AAED;yCACyC;AACzC,qBAAa,UAAW,YAAW,OAAO;IACxC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9B,KAAK,SAAK;IACV,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,IAAI,CAAuB;IAEnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAe3B,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;CAkBhE;AAED,eAAO,MAAM,OAAO,QAAO,UAA8B,CAAC"}
+{"version":3,"file":"antigravity-control.d.ts","sourceRoot":"","sources":["../../../src/adapters/antigravity-control.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAkC,KAAK,IAAI,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,eAAe,CAAC;AAIpH,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,SAAe,GAAG,MAAM,GAAG,IAAI,CAOhG;AAED;;;;;iBAKiB;AACjB,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,CAGtD;AAED;oBACoB;AACpB,eAAO,MAAM,aAAa,SAAU,IAAI,KAAG,eAAe,EAAsD,CAAC;AAEjH;iCACiC;AACjC,eAAO,MAAM,YAAY,SAAU,IAAI,KAAG,QAA8C,CAAC;AAEzF;4EAC4E;AAC5E,wBAAgB,OAAO,CAAC,CAAC,EAAE;IAAE,UAAU,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAU9F;AAED,yCAAyC;AACzC,eAAO,MAAM,MAAM,SAAS,MAAM,CAAC,UAAU,KAAiB,MAAM,CAAC,UAAyB,CAAC;AAE/F,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,0BAA0B;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAgCrD;AAYD,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAU3D;AAED;yCACyC;AACzC,qBAAa,UAAW,YAAW,OAAO;IACxC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9B,KAAK,SAAK;IACV,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,IAAI,CAAuB;IAEnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAa1B;IAED,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAiB9D;CACF;AAED,eAAO,MAAM,OAAO,QAAO,UAA8B,CAAC"}

package/dist/src/adapters/antigravity.d.ts

@@ -1,4 +1,4 @@
-import type { Adapter, FactsState, SessionFacts } from "./types.js";
+import type { Adapter, SessionFacts } from "./types.js";
 export declare const AG_EVENTS: readonly ["PreInvocation", "PostInvocation", "PostToolUse", "Stop"];
 /** What a PreToolUse entry an older install left behind gets, until a restarted
  *  conversation reads the rewritten hooks.json: the person's own prompt, with why. The
@@ -26,7 +26,6 @@ export declare function antigravityRemoteUrl(transcript: string, opts: {
 export declare function antigravityFacts(file: string, opts: {
     conversation: string;
     workspaces: string[];
-    state: FactsState;
     env: NodeJS.ProcessEnv;
 }): SessionFacts;
 //# sourceMappingURL=antigravity.d.ts.map

package/dist/src/adapters/antigravity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"antigravity.d.ts","sourceRoot":"","sources":["../../../src/adapters/antigravity.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EACV,OAAO,EAEP,UAAU,EAMV,YAAY,EACb,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,SAAS,qEAAsE,CAAC;AAC7F;;yFAEyF;AACzF,eAAO,MAAM,gBAAgB,yKACmI,CAAC;AACjK,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,MAA8D,CAAC;AAiBjH,eAAO,MAAM,WAAW,EAAE,OAoJzB,CAAC;AAOF,+FAA+F;AAC/F,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAahD;AACD,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAAM,EAIR,CAAC;AAoC7C,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAiBjH;AAED;uEACuE;AACvE,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACnG,MAAM,GAAG,IAAI,CAiBf;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GAC9F,YAAY,CAyBd"}
+{"version":3,"file":"antigravity.d.ts","sourceRoot":"","sources":["../../../src/adapters/antigravity.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EACV,OAAO,EAOP,YAAY,EACb,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,SAAS,YAAI,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,CAAU,CAAC;AAC7F;;yFAEyF;AACzF,eAAO,MAAM,gBAAgB,yKACmI,CAAC;AACjK,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,UAAW,MAAM,KAAG,MAA8D,CAAC;AAiBjH,eAAO,MAAM,WAAW,EAAE,OAoJzB,CAAC;AAOF,+FAA+F;AAC/F,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAahD;AACD,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,MAAM,EAIR,CAAC;AAuC7C,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAiBjH;AAED;uEACuE;AACvE,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACnG,MAAM,GAAG,IAAI,CAiBf;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GAC3E,YAAY,CAyBd"}

package/dist/src/adapters/claude-code-control.d.ts

@@ -1,5 +1,8 @@
+import { type RunLevel, type StartPermission } from "../control/verify.js";
 import { JOB_TIMEOUT_MS, type Login, type Mode, type RunOptions, type RunResult } from "./headless.js";
 export { JOB_TIMEOUT_MS, type Login, type Mode, type RunResult };
+/** Dotted versions by number, a missing part as 0: 1.9.0 < 1.10 = 1.10.0. */
+export declare const cmpVersion: (a: string, b: string) => number;
 /** The `claude` to run: on PATH, else where the installers put it, else the newest
  *  copy the desktop app ships. Null when this machine has none. */
 export declare function findClaude(env?: NodeJS.ProcessEnv, home?: string): string | null;
@@ -13,10 +16,44 @@ export interface Caps {
     stream?: boolean;
 }
 export declare function parseCaps(help: string): Caps;
-/** Permission flags for the machine's mode. Safe: `dontAsk` (nothing that needs
- *  approval runs). Auto: Claude Code's own auto mode, or a refusal. Never
- *  bypassPermissions — no path here writes it. */
-export declare function modeFlags(mode: Mode, caps: Caps): {
+/** Permission flags for a level (a machine's mode is one: safe, auto, inherit). Read:
+ *  plan mode. Safe: `dontAsk` (nothing that needs approval runs). Edits: acceptEdits.
+ *  Auto: Claude Code's own auto mode. Inherit: none, so the turn starts in the mode
+ *  Claude Code picks by itself here, its settings' `permissions.defaultMode` (a resume
+ *  too: Claude Code never restores a session's earlier mode). A level this Claude Code
+ *  has no mode for is a refusal, never another level. Never bypassPermissions — no path
+ *  here writes it. */
+export declare function modeFlags(level: RunLevel, caps: Caps): {
+    args: string[];
+} | {
+    error: string;
+};
+/** The widest level a start may name on a machine in `mode`: the mode itself, and safe
+ *  on an inherit machine, whose own default sessionpipe can't rank, so a message there may
+ *  only narrow to a level that never runs anything needing approval. */
+export declare const ceilingLevel: (mode: Mode) => StartPermission;
+/** The levels a start may ask Claude Code for on a machine in `mode`: never above its
+ *  ceiling, and each only where `claude --help` lists the mode it maps to (safe always). */
+export declare function offeredLevels(mode: Mode, caps: Caps): StartPermission[];
+/** What a start that names no level gets: what the machine's mode means for Claude Code. */
+export declare const defaultLevel: (mode: Mode) => RunLevel;
+/** How a headless run prints: streamed where this Claude Code can, else one JSON at the end. */
+export declare function outputArgs(caps: {
+    stream?: boolean;
+}): string[];
+/** One headless `claude -p` run: a new session (`session`), or the next message of one
+ *  (`resume`, optionally as a fork). The model is its own argument after `--model`, and
+ *  a prompt that starts with a dash gets a leading space, so it is never read as a flag. */
+export declare function claudeArgs(o: {
+    caps: Caps;
+    level: RunLevel;
+    prompt: string;
+    session?: string;
+    resume?: string;
+    fork?: boolean;
+    model?: string;
+    allowedTools?: string[];
+}): {
     args: string[];
 } | {
     error: string;

package/dist/src/adapters/claude-code-control.d.ts.map

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

package/dist/src/adapters/claude-code.d.ts

@@ -1,3 +1,4 @@
+import type { HarnessAccount } from "../types.js";
 import type { Adapter, FactsState, SessionFacts } from "./types.js";
 export declare const CLAUDE_EVENTS: readonly ["SessionStart", "UserPromptSubmit", "PreToolUse", "PostToolUse", "PostToolUseFailure", "PermissionRequest", "Notification", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "SessionEnd", "StopFailure"];
 /** Every Claude Code config dir on this machine. `home` follows the env's HOME, so a
@@ -5,9 +6,18 @@ export declare const CLAUDE_EVENTS: readonly ["SessionStart", "UserPromptSubmit"
  *  once rewrote a real settings.json with its fake hook paths on every run. */
 export declare function claudeDirs(env?: NodeJS.ProcessEnv, home?: string): string[];
 export declare const claudeCode: Adapter;
+/** Another harness reading this settings file, not Claude Code. Several harnesses
+ *  import `~/.claude/settings.json` hooks, so our entries there can be run by a tool
+ *  that has its own adapter: it would arrive under the wrong name, with ids that mean
+ *  nothing to a Claude Code reader. Every Claude Code payload names a transcript and a
+ *  UUID session (all 21 recorded fixtures do); a payload with neither is somebody else's. */
+export declare function notClaudeCode(id: string, s: Record<string, unknown>): boolean;
 /** The Claude Code process that ran this hook: the nearest ancestor with a registry
  *  file (hooks run under a shell, so usually the parent's parent). */
 export declare function claudePid(env?: NodeJS.ProcessEnv): number | null;
+/** Every account signed in across these config dirs, read fresh (a person signs in to
+ *  another account without restarting anything), for control's pair and hello. */
+export declare function claudeAccounts(dirs: string[], home?: string): HarnessAccount[];
 /** A first ask as the Claude Code app titles an untitled session: whitespace
  *  collapsed, whole up to 50 characters, else its first 50 and "...". */
 export declare function appTitle(text: string): string;

package/dist/src/adapters/claude-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude-code.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,OAAO,EAEP,UAAU,EAKV,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,aAAa,0OAehB,CAAC;AAaX;;+EAE+E;AAC/E,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,SAAmB,GAAG,MAAM,EAAE,CAiBlG;AAgBD,eAAO,MAAM,UAAU,EAAE,OAwMxB,CAAC;AA4EF;sEACsE;AACtE,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAa7E;AA4DD;yEACyE;AACzE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AA2DD;;qFAEqF;AACrF,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,UAAU,GAChB,YAAY,CA6Fd;AAED,6GAA6G;AAC7G,eAAO,MAAM,kBAAkB,QAAO,IAGrC,CAAC"}
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude-code.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EACV,OAAO,EAEP,UAAU,EAKV,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,aAAa,YACxB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,MAAM,EACN,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,CACL,CAAC;AAaX;;+EAE+E;AAC/E,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,SAAwB,GAAG,MAAM,EAAE,CAiBvG;AAgBD,eAAO,MAAM,UAAU,EAAE,OAgPxB,CAAC;AAOF;;;;6FAI6F;AAC7F,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAE7E;AA0FD;sEACsE;AACtE,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAa7E;AAsFD;kFACkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,SAAY,GAAG,cAAc,EAAE,CAUjF;AAcD;yEACyE;AACzE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AA2DD;;qFAEqF;AACrF,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,UAAU,GAChB,YAAY,CA6Fd;AAED,6GAA6G;AAC7G,eAAO,MAAM,kBAAkB,QAAO,IAGrC,CAAC"}

package/dist/src/adapters/claude-shaped.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-shaped.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude-shaped.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB;8DAC0D;IAC1D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACnD,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;iGACiG;AACjG,eAAO,MAAM,IAAI,QAA+F,CAAC;AACjH,eAAO,MAAM,MAAM,GAAI,GAAG;IAAE,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,KAAG,OACwC,CAAC;AAExG,MAAM,MAAM,QAAQ,GAChB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;CACvB,GACD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,GAAG,EAAE,EAAE,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,IAAI,CAAA;CAAE,GAClH;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD;sDACsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA4BnD;AAED,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAG5G;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG9D;AAUD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,mBAAmB,GACrB,aAAa,CAyCf;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAO,GAC3C,aAAa,CA0Bf;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,mBAAmB,GACrB,SAAS,GAAG,OAAO,GAAG,SAAS,CAiBjC"}
+{"version":3,"file":"claude-shaped.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude-shaped.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB;8DAC0D;IAC1D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACnD,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;iGACiG;AACjG,eAAO,MAAM,IAAI,QAA+F,CAAC;AACjH,eAAO,MAAM,MAAM,MAAO;IAAE,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,KAAG,OACwC,CAAC;AAExG,MAAM,MAAM,QAAQ,GAChB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;CACvB,GACD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,GAAG,EAAE,EAAE,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,IAAI,CAAA;CAAE,GAClH;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD;sDACsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA4BnD;AAED,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAG5G;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG9D;AAUD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,mBAAmB,GACrB,aAAa,CAyCf;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAO,GAC3C,aAAa,CAyBf;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,mBAAmB,GACrB,SAAS,GAAG,OAAO,GAAG,SAAS,CAiBjC"}

package/dist/src/adapters/codex-config.d.ts

@@ -17,8 +17,8 @@ export declare function readNotify(text: string): Notify | null;
 export declare function insertTopLevel(text: string, line: string): string;
 /** The config with `line` as its notify, for a config whose notify is ours or absent. */
 export declare function withNotify(text: string, line: string): string;
-/** The config with its top-level notify line replaced by `line`. */
-export declare function replaceNotify(text: string, line: string): string | null;
+/** The config with its notify line `n` (as readNotify found it in `text`) replaced by `line`. */
+export declare function replaceNotify(text: string, n: Notify, line: string): string;
 /** The config with our top-level or misplaced notify removed. */
 export declare function withoutNotify(text: string): string;
 export declare function previousNotify(argv: string[] | null): string[] | null;

package/dist/src/adapters/codex-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-config.d.ts","sourceRoot":"","sources":["../../../src/adapters/codex-config.ts"],"names":[],"mappings":"AASA,gFAAgF;AAChF,eAAO,MAAM,IAAI,QAA0D,CAAC;AAoC5E,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD;AAOD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAOtD;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmCtD;AAMD,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvE;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAKD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,IAAI,CAIrE;AACD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,CAM5E;AACD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AACD,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAGnE;AACD,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,GAAG,IAAI,KAAG,OAC6C,CAAC"}
+{"version":3,"file":"codex-config.d.ts","sourceRoot":"","sources":["../../../src/adapters/codex-config.ts"],"names":[],"mappings":"AASA,gFAAgF;AAChF,eAAO,MAAM,IAAI,QAA0D,CAAC;AAoC5E,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD;AAOD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAOtD;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0BtD;AAMD,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAKD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,IAAI,CAIrE;AACD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,CAM5E;AACD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AACD,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAGnE;AACD,eAAO,MAAM,aAAa,SAAU,MAAM,EAAE,GAAG,IAAI,KAAG,OAC6C,CAAC"}

package/dist/src/adapters/codex-control.d.ts

@@ -1,21 +1,37 @@
+import { type RunLevel, type StartPermission } from "../control/verify.js";
 import { type Login, type Mode, type Reading, type RunResult } from "./headless.js";
 export { codexFacts, findRollout } from "./codex.js";
 /** The `codex` to run: SESSIONPIPE_CODEX, else on PATH, else beside the node running
  *  this (an `npm install -g` there) or where the installers put it. */
 export declare function findCodex(env?: NodeJS.ProcessEnv, home?: string, nodeDir?: string): string | null;
-/** Sandbox flags for the machine's mode. Safe: workspace-write, and nothing escalates
- *  unattended (exec never asks). Auto: approval requests go through Codex's own
- *  automatic review. Never `--dangerously-bypass-approvals-and-sandbox` or
- *  `--dangerously-bypass-hook-trust`: no path here writes them. */
-export declare function codexModeFlags(mode: Mode, resume?: boolean): string[];
+/** Sandbox flags for a level (a machine's mode is one: safe, auto, inherit). Read: the
+ *  read-only sandbox. Safe: workspace-write, and nothing escalates unattended (exec never
+ *  asks); that sandbox already edits inside the folder, so `edits` is never offered and
+ *  means the same. Auto: approval requests go through Codex's own automatic review.
+ *  Inherit: none, so `sandbox_mode` and `approval_policy` come from the person's own
+ *  config.toml, a new session's and a resume's alike. Never
+ *  `--dangerously-bypass-approvals-and-sandbox`, `--dangerously-bypass-hook-trust` or
+ *  `danger-full-access`: no path here writes them. */
+export declare function codexModeFlags(level: RunLevel, resume?: boolean): string[];
+/** The levels a start may ask Codex for on a machine in `mode`: read and safe, and auto
+ *  on an auto machine. */
+export declare const offeredLevels: (mode: Mode) => StartPermission[];
+/** What a start that names no level gets: what the machine's mode means for Codex. */
+export declare const defaultLevel: (mode: Mode) => RunLevel;
 /** One headless turn. A new session runs in `cwd` (`-C`); a resume names the thread.
- *  The prompt goes after `--`, so a message that starts with a dash is never a flag. */
+ *  The model is its own argument after `-m`. The prompt goes after `--`, so a message
+ *  that starts with a dash is never a flag. */
 export declare function codexArgs(o: {
-    mode: Mode;
+    permission: RunLevel;
     prompt: string;
     cwd?: string;
     resume?: string;
+    model?: string;
 }): string[];
+/** The models a hello offers for Codex (CONTROL.md §2 `start`): the slugs Codex's own
+ *  picker lists, from `$CODEX_HOME/models_cache.json` (visibility `list`; hidden ones,
+ *  such as its review model, left out), at most 50. Empty when there is no cache. */
+export declare function codexModels(env?: NodeJS.ProcessEnv, home?: string): string[];
 /** The env a headless turn runs with. */
 export declare const codexEnv: (env?: NodeJS.ProcessEnv) => NodeJS.ProcessEnv;
 export declare const LOGIN_HINT = "Codex isn't signed in on this machine: run `codex login --device-auth` there.";

package/dist/src/adapters/codex-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-control.d.ts","sourceRoot":"","sources":["../../../src/adapters/codex-control.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,KAAK,SAAS,EAGf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIrD;uEACuE;AACvE,wBAAgB,SAAS,CACvB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,SAAe,EACnB,OAAO,SAAiC,GACvC,MAAM,GAAG,IAAI,CAOf;AAED;;;mEAGmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,UAAQ,GAAG,MAAM,EAAE,CAenE;AAED;wFACwF;AACxF,wBAAgB,SAAS,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAIpG;AAED,yCAAyC;AACzC,eAAO,MAAM,QAAQ,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,MAAM,CAAC,UAAyB,CAAC;AAEjG,eAAO,MAAM,UAAU,kFAAkF,CAAC;AAE1G;;uEAEuE;AACvE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,KAAK,CAAC,CAc5F;AAED,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAiCzD;AAED,iFAAiF;AACjF,qBAAa,YAAa,YAAW,OAAO;IAC1C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9B,KAAK,SAAK;IACV,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,IAAI,CAAuB;IAEnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAgB3B;2EACuE;IACvE,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;CAShE;AAYD,eAAO,MAAM,OAAO,QAAO,YAAkC,CAAC"}
+{"version":3,"file":"codex-control.d.ts","sourceRoot":"","sources":["../../../src/adapters/codex-control.ts"],"names":[],"mappings":"AAYA,OAAO,EAAY,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,KAAK,SAAS,EAGf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIrD;uEACuE;AACvE,wBAAgB,SAAS,CACvB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,SAAe,EACnB,OAAO,SAAiC,GACvC,MAAM,GAAG,IAAI,CAOf;AAED;;;;;;;sDAOsD;AACtD,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAQ,GAAG,MAAM,EAAE,CAiBxE;AAED;0BAC0B;AAC1B,eAAO,MAAM,aAAa,SAAU,IAAI,KAAG,eAAe,EACK,CAAC;AAEhE,sFAAsF;AACtF,eAAO,MAAM,YAAY,SAAU,IAAI,KAAG,QAAgB,CAAC;AAE3D;;+CAE+C;AAC/C,wBAAgB,SAAS,CAAC,CAAC,EAAE;IAC3B,UAAU,EAAE,QAAQ,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,EAAE,CAcX;AAED;;qFAEqF;AACrF,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,SAAe,GAAG,MAAM,EAAE,CAa/F;AAED,yCAAyC;AACzC,eAAO,MAAM,QAAQ,SAAS,MAAM,CAAC,UAAU,KAAiB,MAAM,CAAC,UAAyB,CAAC;AAEjG,eAAO,MAAM,UAAU,kFAAkF,CAAC;AAE1G;;uEAEuE;AACvE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,KAAK,CAAC,CAc5F;AAED,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAiCzD;AAED,iFAAiF;AACjF,qBAAa,YAAa,YAAW,OAAO;IAC1C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9B,KAAK,SAAK;IACV,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,IAAI,CAAuB;IAEnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAc1B;IAED;2EACuE;IACvE,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAQ9D;CACF;AAYD,eAAO,MAAM,OAAO,QAAO,YAAkC,CAAC"}

package/dist/src/adapters/codex-rollout.d.ts

@@ -0,0 +1,8 @@
+/** A thread another thread started — a subagent, a review — names a `source.subagent`
+ *  in its own metadata (the rollout's first record). A fork the person made carries
+ *  only `forked_from_id`, and is a session of its own. */
+export declare function codexSubagent(meta: Record<string, unknown> | null | undefined): boolean;
+/** A fork starts with its own metadata, then replays the parent's history. Only
+ *  an event naming the new thread establishes where its own records begin. */
+export declare function codexReplayBoundary(meta: Record<string, unknown> | null | undefined): ((record: Record<string, unknown> | null) => boolean) | undefined;
+//# sourceMappingURL=codex-rollout.d.ts.map

package/dist/src/adapters/codex-rollout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-rollout.d.ts","sourceRoot":"","sources":["../../../src/adapters/codex-rollout.ts"],"names":[],"mappings":"AAEA;;0DAE0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAIvF;AAED;8EAC8E;AAC9E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,aAIlE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,0BAK/C"}

package/dist/src/adapters/codex.d.ts

@@ -5,6 +5,6 @@ export declare const CODEX_EVENTS: readonly ["SessionStart", "UserPromptSubmit",
  *  short or odd one never matches some other session's file. */
 export declare function findRollout(threadId: string, env?: NodeJS.ProcessEnv): string | null;
 export declare const codex: Adapter;
-/** Codex keeps no title; its first real ask stands in. */
+/** Codex keeps no title; its first real ask stands in. A fork's replay is not its ask. */
 export declare function codexFacts(file: string): SessionFacts;
 //# sourceMappingURL=codex.d.ts.map

package/dist/src/adapters/codex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/adapters/codex.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,OAAO,EAOP,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,YAAY,kMAaf,CAAC;AAuFX;;gEAEgE;AAChE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAwBjG;AAED,eAAO,MAAM,KAAK,EAAE,OAoLnB,CAAC;AAOF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA2CrD"}
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/adapters/codex.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,OAAO,EAOP,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,YAAY,YACvB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,MAAM,EACN,WAAW,EACX,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,CACJ,CAAC;AAmFX;;gEAEgE;AAChE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAwBjG;AAeD,eAAO,MAAM,KAAK,EAAE,OAwMnB,CAAC;AAOF,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA2DrD"}