@assethub/cli 0.1.31 → 0.1.33

package/README.md

@@ -378,12 +378,19 @@ assembly was made. Follow a run started without `--wait` with
 While a V4 run works, `--wait`, `runs watch` and `runs get` show where it is.
 The receipt's `progress` field has the phase, a one-line summary, each part's
 state and the Blender assembly rounds, in the words of the canvas Part Composer
-card. `--wait` and `runs watch` print a stderr line only when it changes:
+card. `--wait` and `runs watch` print a stderr line, with the local time, only
+when the run really moves on (a new step, another mesh ready, a part kept with
+an issue, the end); part states that come and go do not print:
 
 ```text
-[run] 557d2a58-… running · Step 3 of 4 · Making the parts · 3 of 9 meshes ready · 4 redoing, 2 checking
+19:52  run 557d2a58  3/4 Making the parts · 3 of 9 meshes ready
+19:58  run 557d2a58  ⚠ kept with an issue: Cropped top · open hem at the lower chest
+20:05  run 557d2a58  ✗ FAILED · at 3/4 Making the parts · Blender assembly failed
 ```
 
+`production batch --wait` prints the same lines per image, named by letter and
+file name, and a status table every 5 minutes; see `docs/guides/production-batch.md`.
+
 ```sh
 assethub runs watch <run-id> --timeout-ms 7200000 --download --out-dir ./character
 assethub runs get <run-id>                                   # JSON receipt, progress included

package/dist/hooks/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/hooks/command.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IAChB,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5D,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC,CAAA;AA8CD,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,EAAE,EACd,OAAM,gBAAqB,KAC1B,OAAO,CAAC,MAAM,CAkIhB,CAAA"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/hooks/command.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IAChB,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5D,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC,CAAA;AA+CD,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,EAAE,EACd,OAAM,gBAAqB,KAC1B,OAAO,CAAC,MAAM,CAiIhB,CAAA"}

package/dist/hooks/command.js

@@ -1,11 +1,12 @@
 // `assethub hooks <subcommand>` — the registration in src/index.ts just calls
 // runHooksCommand(argv).
-import { installHooks, SESSION_SAVE_DISCLOSURE, uninstallHooks } from './install.js';
+import { installHooks, sessionSaveDisclosure, uninstallHooks } from './install.js';
 import { listSessionDirs, readMeta } from './paths.js';
 import { saveSession } from './save.js';
 import { canUploadSessions, resolveUploadAuth, uploadPending, uploadSession } from './upload.js';
 const USAGE = 'Usage: assethub hooks <install|uninstall|save|upload|list|status> [--client claude|codex] [--json]\n' +
-    '  save [--transcript <path> --session-id <id>]   (reads hook JSON from stdin without flags)\n' +
+    '  install|uninstall [--global]   (the current folder by default; --global for every project)\n' +
+    '  save [--client codex] [--transcript <path> --session-id <id>]   (reads hook JSON from stdin without flags)\n' +
     '  upload [--session <dir> [--auto] [--sweep <n>]|--pending [--force] [--limit <n>]]\n' +
     '         --auto and --pending wait out earlier failures (1h, 2h, 4h … up to a day); --force retries now';
 const parseFlags = (args) => {
@@ -68,31 +69,32 @@ export const runHooksCommand = async (argv, deps = {}) => {
                     write('--client claude|codex is required\n');
                     return 2;
                 }
+                // Sessions are saved only where the hooks are: this folder, unless --global.
+                const scope = flags.global === true ? {} : { projectDir: deps.cwd ?? process.cwd() };
+                const paths = { home: deps.home, codexHome: (deps.env ?? process.env).CODEX_HOME?.trim() || undefined };
                 if (sub === 'install') {
                     // Only accounts that may upload sessions (internal for now) can turn
                     // session saving on; for anyone else the hooks would only pile up.
-                    if (client === 'claude') {
-                        const auth = await resolveUploadAuth(uploadOptions);
-                        if (!auth || !(await canUploadSessions(auth, deps.fetchImpl))) {
-                            write('Session saving is not available for this account.\n');
-                            return 1;
-                        }
+                    const auth = await resolveUploadAuth(uploadOptions);
+                    if (!auth || !(await canUploadSessions(auth, deps.fetchImpl))) {
+                        write('Session saving is not available for this account.\n');
+                        return 1;
                     }
-                    const result = await installHooks({
-                        client: client,
-                        home: deps.home,
-                        cliPath: deps.cliPath,
-                    });
-                    out(result.installed && client === 'claude'
-                        ? `${result.detail}\n${SESSION_SAVE_DISCLOSURE}`
-                        : result.detail, result);
-                    return result.installed || client === 'codex' ? 0 : 1;
+                    const result = await installHooks({ ...scope, ...paths, client, cliPath: deps.cliPath });
+                    out(result.installed ? `${result.detail}\n${sessionSaveDisclosure(scope, client)}` : result.detail, result);
+                    return result.installed ? 0 : 1;
                 }
-                const result = await uninstallHooks({ client: client, home: deps.home });
+                const result = await uninstallHooks({ ...scope, ...paths, client });
                 out(result.detail, result);
                 return 0;
             }
             case 'save': {
+                // A misspelt client must not be saved as Claude. Exit 1, not 2: a
+                // hook's exit 2 can block the agent.
+                if (flags.client !== undefined && flags.client !== 'claude' && flags.client !== 'codex') {
+                    write('Nothing saved: use --client claude or --client codex.\n');
+                    return 1;
+                }
                 let stdin;
                 let input;
                 if (typeof flags.transcript === 'string') {
@@ -109,6 +111,7 @@ export const runHooksCommand = async (argv, deps = {}) => {
                 const result = await saveSession({
                     stdin,
                     input,
+                    client: flags.client === 'codex' ? 'codex' : 'claude',
                     home: deps.home,
                     env: deps.env,
                     now: deps.now,

package/dist/hooks/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/hooks/graph.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,oBAAoB,iBAAiB,CAAA;AAClD,eAAO,MAAM,iBAAiB,4BAA4B,CAAA;AAC1D,eAAO,MAAM,oBAAoB,yBAAyB,CAAA;AAC1D,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,QAAkB,CAAA;AAIrD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,QAAoB,CAAA;AAIvD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAGlC,KAAK,MAAM,GAAG;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAC,CAAA;AAC9F,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAQ7C,CAAA;AA4BD,eAAO,MAAM,cAAc,GAAI,gBAAgB,MAAM,KAAG,MAMvD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,YAA4B,KAAG,MAAM,EAanF,CAAA;AAED,eAAO,MAAM,uBAAuB,GAClC,YAAY,MAAM,EAClB,UAAS;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAM,KACpC,OAAO,CAAC,MAAM,CAiLhB,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,IAAI,CAE9E,CAAA"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/hooks/graph.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,oBAAoB,iBAAiB,CAAA;AAClD,eAAO,MAAM,iBAAiB,4BAA4B,CAAA;AAC1D,eAAO,MAAM,oBAAoB,yBAAyB,CAAA;AAC1D,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,QAAkB,CAAA;AAIrD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,QAAoB,CAAA;AAIvD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAGlC,KAAK,MAAM,GAAG;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAC,CAAA;AAC9F,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAQ7C,CAAA;AA4BD,eAAO,MAAM,cAAc,GAAI,gBAAgB,MAAM,KAAG,MAMvD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,YAA4B,KAAG,MAAM,EAanF,CAAA;AAED,eAAO,MAAM,uBAAuB,GAClC,YAAY,MAAM,EAClB,UAAS;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAM,KACpC,OAAO,CAAC,MAAM,CAmLhB,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,IAAI,CAE9E,CAAA"}

package/dist/hooks/graph.js

@@ -103,6 +103,8 @@ export const buildSessionGraphFolder = async (sessionDir, options = {}) => {
     if (!meta)
         throw new Error(`No meta.json in ${sessionDir}`);
     const limits = compactLimits(options.compactLevel ?? 0);
+    // A session an older CLI saved has no client: it came from Claude Code.
+    const agentTag = `agent:${meta.client ?? 'claude'}`;
     const transcriptBytes = await readFile(join(sessionDir, 'transcript.jsonl'));
     const transcript = parseTranscript(transcriptBytes.toString('utf8'));
     await resetSessionGraphFolder(sessionDir);
@@ -134,7 +136,7 @@ export const buildSessionGraphFolder = async (sessionDir, options = {}) => {
         const id = `transcript_${pad(index)}`;
         const blobRef = await addBlob(part, TRANSCRIPT_BLOB_MIME, `transcript-${pad(index)}.jsonl`);
         nodes.push({
-            id, artifactKind: 'file', semanticType: 'transcript', tags: ['session', 'agent:claude'],
+            id, artifactKind: 'file', semanticType: 'transcript', tags: ['session', agentTag],
             metadata: { part: index, parts: transcriptParts.length },
             payload: { blobRef },
         });
@@ -155,12 +157,12 @@ export const buildSessionGraphFolder = async (sessionDir, options = {}) => {
             }
             : item.kind === 'assistant'
                 ? {
-                    id, artifactKind: 'text', tags: ['session', 'agent:claude'],
+                    id, artifactKind: 'text', tags: ['session', agentTag],
                     metadata: { role: 'assistant', timestamp: createdAt },
                     payload: clip(redactText(item.text), limits.textChars),
                 }
                 : {
-                    id, artifactKind: 'run', tags: ['session', 'agent:claude', `tool:${item.toolName}`],
+                    id, artifactKind: 'run', tags: ['session', agentTag, `tool:${item.toolName}`],
                     metadata: { toolUseId: item.toolUseId, timestamp: createdAt },
                     payload: { toolName: item.toolName, input: redactedInput(item.input, limits.toolInputBytes) },
                 };
@@ -207,7 +209,7 @@ export const buildSessionGraphFolder = async (sessionDir, options = {}) => {
         const blobRef = await addBlob(bytes, image.mime, image.file.slice(0, 200));
         const id = `image_${pad(index)}`;
         nodes.push({
-            id, artifactKind: 'image', tags: ['session', 'agent:claude'],
+            id, artifactKind: 'image', tags: ['session', agentTag],
             metadata: { sourcePath: redactText(image.original) },
             payload: { blobRef },
         });
@@ -215,7 +217,7 @@ export const buildSessionGraphFolder = async (sessionDir, options = {}) => {
     }
     nodes.push({
         id: sessionNodeId, artifactKind: 'console', semanticType: 'agent-session',
-        tags: ['session', 'agent:claude'],
+        tags: ['session', agentTag],
         metadata: {
             sessionId: meta.sessionId, client: meta.client, lastEvent: meta.lastEvent,
             messageCount: messageNodes.length, skippedImages,

package/dist/hooks/install.d.ts

@@ -7,10 +7,26 @@ export declare const HOOK_TIMEOUT_SECONDS = 30;
  */
 export declare const SESSION_END_TIMEOUT_SECONDS = 10;
 export declare const MAX_SETTINGS_BACKUPS = 3;
+/** Where the hooks go: one project folder, or every project when omitted (--global). */
+export type HookScope = {
+    projectDir?: string;
+};
+/** Where each client keeps its config, per project and for the user. */
+type ClientPaths = {
+    home?: string;
+    codexHome?: string;
+};
 /** What `hooks install` and `setup` must tell the user before recording starts. */
-export declare const SESSION_SAVE_DISCLOSURE: string;
+export declare const sessionSaveDisclosure: (scope: HookScope, client?: HookClient) => string;
 export declare const isOurCommand: (command: unknown) => boolean;
-export declare const hookCommand: (cliPath?: string) => string;
+/** Codex hooks name their client, so the saved session is recorded as Codex. */
+export declare const hookCommand: (cliPath?: string, client?: HookClient) => string;
+/**
+ * A project install in the home folder would land in ~/.claude (or ~/.codex),
+ * which the client also reads for every project, so it is refused rather than
+ * silently global.
+ */
+export declare const hookScopeError: (home: string | undefined, scope: HookScope, client?: HookClient, codexHome?: string) => Promise<string | undefined>;
 type HookEntry = {
     type: 'command';
     command: string;
@@ -19,22 +35,21 @@ type HookEntry = {
 };
 /**
  * SessionStart (sweep and retry), Stop (every turn) and PreCompact only mark or
- * spawn work, and run in the background so they never delay the agent.
+ * spawn work, and run in the background so they never delay Claude Code.
  * SessionEnd stays synchronous, because Claude Code is exiting and a
- * background hook could be cut off.
+ * background hook could be cut off. Codex hooks all run synchronously; the
+ * work is the same few local file writes.
  */
-export declare const hookEntry: (event: (typeof HOOK_EVENTS)[number], command: string) => HookEntry;
-export declare const installHooks: (options: {
+export declare const hookEntry: (event: (typeof HOOK_EVENTS)[number], command: string, client?: HookClient) => HookEntry;
+export declare const installHooks: (options: HookScope & ClientPaths & {
     client: HookClient;
-    home?: string;
     cliPath?: string;
 }) => Promise<{
     installed: boolean;
     detail: string;
 }>;
-export declare const uninstallHooks: (options: {
+export declare const uninstallHooks: (options: HookScope & ClientPaths & {
     client: HookClient;
-    home?: string;
 }) => Promise<{
     removed: boolean;
     detail: string;

package/dist/hooks/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/hooks/install.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAE1C,eAAO,MAAM,WAAW,+DAAgE,CAAA;AACxF,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC;;;GAGG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAA;AAC7C,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,QAQ0B,CAAA;AAa9D,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,KAAG,OACa,CAAA;AAI7D,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,KAAG,MACO,CAAA;AAiDtD,KAAK,SAAS,GAAG;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,IAAI,CAAA;CAAC,CAAA;AAElF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,CAAC,OAAO,WAAW,EAAE,MAAM,CAAC,EAAE,SAAS,MAAM,KAAG,SAGL,CAAA;AAE5E,eAAO,MAAM,YAAY,GAAU,SAAS;IAC1C,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,KAAG,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAuC/C,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,SAAS;IAC5C,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,KAAG,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAwC7C,CAAA"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/hooks/install.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAE1C,eAAO,MAAM,WAAW,+DAAgE,CAAA;AACxF,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC;;;GAGG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAA;AAC7C,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAC,CAAA;AAE7C,wEAAwE;AACxE,KAAK,WAAW,GAAG;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,CAAA;AAkBtD,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,GAAI,OAAO,SAAS,EAAE,SAAQ,UAAqB,KAAG,MAmBvF,CAAA;AAWD,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,KAAG,OACa,CAAA;AAI7D,gFAAgF;AAChF,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,EAAE,SAAQ,UAAqB,KAAG,MACsB,CAAA;AAMpG;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,GAAG,SAAS,EACxB,OAAO,SAAS,EAChB,SAAQ,UAAqB,EAC7B,YAAY,MAAM,KACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAY5B,CAAA;AA6GD,KAAK,SAAS,GAAG;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,IAAI,CAAA;CAAC,CAAA;AAElF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO,CAAC,OAAO,WAAW,EAAE,MAAM,CAAC,EACnC,SAAS,MAAM,EACf,SAAQ,UAAqB,KAC5B,SAK2E,CAAA;AAE9E,eAAO,MAAM,YAAY,GAAU,SAAS,SAAS,GAAG,WAAW,GAAG;IACpE,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,KAAG,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CA8C/C,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,SAAS,SAAS,GAAG,WAAW,GAAG;IACtE,MAAM,EAAE,UAAU,CAAA;CACnB,KAAG,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAqC7C,CAAA"}

package/dist/hooks/install.js

@@ -1,10 +1,18 @@
-// Register / remove our Claude Code hooks in the user's settings.json.
+// Register / remove our session hooks.
+//
+// Claude Code: one project's .claude/settings.local.json (the default for
+// `hooks install`), or with --global the user's ~/.claude/settings.json.
+// Codex: one project's .codex/hooks.json, or with --global
+// $CODEX_HOME/hooks.json. Codex has no personal per-project file, so the
+// project file is kept out of git (info/exclude) and a tracked one is refused.
 //
 // Merge rules: keep every existing key and hook, identify our entry by its
 // command string (`<assethub> hooks save`), never duplicate it, and back the
 // original file up before any change.
-import { copyFile, mkdir, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';
-import { basename, dirname, join } from 'node:path';
+import { execFile } from 'node:child_process';
+import { appendFile, copyFile, mkdir, readFile, readdir, realpath, rename, rm, writeFile } from 'node:fs/promises';
+import { basename, dirname, join, relative, resolve, sep } from 'node:path';
+import { promisify } from 'node:util';
 import { resolveHome } from './paths.js';
 export const HOOK_EVENTS = ['SessionStart', 'Stop', 'SessionEnd', 'PreCompact'];
 export const HOOK_TIMEOUT_SECONDS = 30;
@@ -14,26 +22,121 @@ export const HOOK_TIMEOUT_SECONDS = 30;
  */
 export const SESSION_END_TIMEOUT_SECONDS = 10;
 export const MAX_SETTINGS_BACKUPS = 3;
+const CLIENT_NAME = { claude: 'Claude Code', codex: 'Codex' };
+const PROJECT_DIR = { claude: '.claude', codex: '.codex' };
+const PROJECT_FILE = { claude: 'settings.local.json', codex: 'hooks.json' };
+const projectSettingsPath = (projectDir, client = 'claude') => join(resolve(projectDir), PROJECT_DIR[client], PROJECT_FILE[client]);
+/** The client's user-level folder: ~/.claude, or $CODEX_HOME (default ~/.codex). */
+const userConfigDir = (client, paths) => client === 'codex' ? (paths.codexHome ?? join(resolveHome(paths.home), '.codex')) : join(resolveHome(paths.home), '.claude');
+const settingsPath = (client, paths, scope) => scope.projectDir
+    ? projectSettingsPath(scope.projectDir, client)
+    : join(userConfigDir(client, paths), client === 'codex' ? 'hooks.json' : 'settings.json');
 /** What `hooks install` and `setup` must tell the user before recording starts. */
-export const SESSION_SAVE_DISCLOSURE = 'Session saving adds SessionStart, Stop, PreCompact and SessionEnd hooks to ~/.claude/settings.json. ' +
-    'Every Claude Code session on this machine, in any project, is then copied to ~/.assethub/sessions/ when it ends ' +
-    '(the conversation only: your prompts, the agent\'s replies and tool calls, with recognised secrets masked, readable only by you; copies older than 30 days are deleted), ' +
-    'and uploaded to AssetHub as a coding-agent session only you can read (internal accounts only for now): the masked transcript, ' +
-    'your prompts, the agent\'s replies, its tool calls and images from the project. Uploads that fail are retried in the background ' +
-    'when a later session starts or ends. Secret masking is best effort. ' +
-    'Opt a project out with .assethub/no-session-save, or turn it off with ASSETHUB_SESSION_SAVE=off / ASSETHUB_SESSION_UPLOAD=off; ' +
-    'remove it with `assethub hooks uninstall --client claude`.';
-const CODEX_DETAIL = 'Codex: run `assethub hooks save --transcript <path>` manually for now';
+export const sessionSaveDisclosure = (scope, client = 'claude') => {
+    const name = CLIENT_NAME[client];
+    const where = scope.projectDir
+        ? `${projectSettingsPath(scope.projectDir, client)}. ` +
+            `Every ${name} session opened in ${resolve(scope.projectDir)} (and only there)`
+        : `${client === 'codex' ? '$CODEX_HOME/hooks.json' : '~/.claude/settings.json'} (--global). Every ${name} session on this machine, in any project,`;
+    const remove = scope.projectDir
+        ? `\`assethub hooks uninstall --client ${client}\` from that folder`
+        : `\`assethub hooks uninstall --client ${client} --global\``;
+    return (`Session saving adds SessionStart, Stop, PreCompact and SessionEnd hooks to ${where} ` +
+        'is then copied to ~/.assethub/sessions/ when it ends ' +
+        '(the conversation only: your prompts, the agent\'s replies and tool calls, with recognised secrets masked, readable only by you; copies older than 30 days are deleted), ' +
+        'and uploaded to AssetHub as a coding-agent session only you can read (internal accounts only for now): the masked transcript, ' +
+        'your prompts, the agent\'s replies, its tool calls and images from the project. Uploads that fail are retried in the background ' +
+        'when a later session starts or ends. Secret masking is best effort. ' +
+        'Opt a project out with .assethub/no-session-save, or turn it off with ASSETHUB_SESSION_SAVE=off / ASSETHUB_SESSION_UPLOAD=off; ' +
+        `remove it with ${remove}.`);
+};
 const isObject = (value) => value != null && typeof value === 'object' && !Array.isArray(value);
 // Only a command that runs the CLI itself: `assethub hooks save`, optionally a
 // (quoted) path to it. `echo assethub hooks save` is somebody else's hook.
 const OUR_COMMAND_RE = /^\s*(?:"(?:[^"]*[/\\])?assethub(?:\.js)?"|'(?:[^']*[/\\])?assethub(?:\.js)?'|(?:[^\s"']*[/\\])?assethub(?:\.js)?)\s+hooks\s+save(?:\s|$)/;
 export const isOurCommand = (command) => typeof command === 'string' && OUR_COMMAND_RE.test(command);
 const quoteIfNeeded = (value) => (/\s/.test(value) ? JSON.stringify(value) : value);
-export const hookCommand = (cliPath) => `${quoteIfNeeded(cliPath ?? 'assethub')} hooks save`;
-const settingsPath = (home) => join(resolveHome(home), '.claude', 'settings.json');
-const load = async (home) => {
-    const path = settingsPath(home);
+/** Codex hooks name their client, so the saved session is recorded as Codex. */
+export const hookCommand = (cliPath, client = 'claude') => `${quoteIfNeeded(cliPath ?? 'assethub')} hooks save${client === 'codex' ? ' --client codex' : ''}`;
+// Symlinks are followed: a project path or a client folder that leads to the
+// home folder is the home folder. A path that does not exist yet is taken as is.
+const realOrResolved = async (path) => realpath(path).catch(() => resolve(path));
+/**
+ * A project install in the home folder would land in ~/.claude (or ~/.codex),
+ * which the client also reads for every project, so it is refused rather than
+ * silently global.
+ */
+export const hookScopeError = async (home, scope, client = 'claude', codexHome) => {
+    if (!scope.projectDir)
+        return undefined;
+    const homeDir = resolveHome(home);
+    const [project, projectConfig, realHome, userConfig] = await Promise.all([
+        realOrResolved(scope.projectDir),
+        realOrResolved(join(scope.projectDir, PROJECT_DIR[client])),
+        realOrResolved(homeDir),
+        realOrResolved(userConfigDir(client, { home, codexHome })),
+    ]);
+    return project === realHome || projectConfig === userConfig
+        ? 'Run this inside a project folder: in your home folder the hooks would apply to every project. Use --global if that is what you want.'
+        : undefined;
+};
+const run = promisify(execFile);
+const git = async (cwd, ...args) => run('git', ['-C', cwd, ...args]).then(({ stdout }) => stdout, () => undefined);
+/**
+ * Codex reads hooks only from .codex/hooks.json, which a repository may share.
+ * Ours stay personal: a tracked file is refused, an untracked one goes into
+ * the repository's info/exclude (never the shared .gitignore).
+ */
+const keepCodexHooksOutOfGit = async (path) => {
+    const dir = dirname(dirname(path));
+    const found = await git(dir, 'rev-parse', '--show-toplevel', '--git-path', 'info/exclude');
+    if (!found)
+        return undefined; // not a repository, or no git
+    const [top, excludePath] = found.trim().split('\n');
+    const file = relative(await realOrResolved(top), join(await realOrResolved(dir), PROJECT_DIR.codex, PROJECT_FILE.codex));
+    if (file.startsWith('..'))
+        return undefined;
+    if ((await git(top, 'ls-files', '--', file))?.trim())
+        return `${path} is tracked by git, so the hooks would be shared with everyone using the repository; left untouched.`;
+    const exclude = resolve(dir, excludePath);
+    // The file and the backups an install leaves next to it.
+    const pattern = `/${file.split(sep).join('/')}*`;
+    const current = await readFile(exclude, 'utf8').catch(() => '');
+    if (!current.split('\n').includes(pattern)) {
+        await mkdir(dirname(exclude), { recursive: true });
+        await appendFile(exclude, `${current && !current.endsWith('\n') ? '\n' : ''}${pattern}\n`);
+    }
+    return undefined;
+};
+/** `[projects."<path>"]` sections with `trust_level = "trusted"` in Codex's config.toml. */
+const codexTrustedProjects = async (codexDir) => {
+    const toml = await readFile(join(codexDir, 'config.toml'), 'utf8').catch(() => '');
+    const trusted = new Set();
+    const sections = toml.split(/^(?=\[)/m);
+    for (const section of sections) {
+        const header = /^\[projects\."((?:[^"\\]|\\.)*)"\]/.exec(section);
+        if (header && /^\s*trust_level\s*=\s*"trusted"/m.test(section))
+            trusted.add(header[1].replace(/\\(.)/g, '$1'));
+    }
+    return trusted;
+};
+/** What Codex still needs before the hooks run. */
+const codexNotes = async (codexDir, scope) => {
+    const review = ' Codex runs a new or changed hook only after you approve it: open /hooks in Codex.';
+    if (!scope.projectDir)
+        return review;
+    const dir = scope.projectDir;
+    const top = (await git(dir, 'rev-parse', '--show-toplevel'))?.trim();
+    const candidates = [resolve(dir), await realOrResolved(dir), ...(top ? [top, await realOrResolved(top)] : [])];
+    const trusted = await codexTrustedProjects(codexDir);
+    if (candidates.some(path => trusted.has(path)))
+        return review;
+    return (` Codex loads a project's hooks only when the project is trusted: add [projects."${resolve(dir)}"] ` +
+        `with trust_level = "trusted" to ${join(codexDir, 'config.toml')}, or trust the folder when Codex asks.` +
+        review);
+};
+const load = async (client, paths, scope) => {
+    const path = settingsPath(client, paths, scope);
     let raw;
     try {
         raw = await readFile(path, 'utf8');
@@ -56,10 +159,11 @@ const load = async (home) => {
         return { path, error: `${path} is not valid JSON; left untouched.` };
     }
 };
-const BACKUP_RE = /^settings\.json\.bak-\d+$/;
+const escapeRe = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 const pruneBackups = async (path) => {
     const dir = dirname(path);
-    const ours = (await readdir(dir)).filter(name => BACKUP_RE.test(name));
+    const backupRe = new RegExp(`^${escapeRe(basename(path))}\\.bak-\\d+$`);
+    const ours = (await readdir(dir)).filter(name => backupRe.test(name));
     const byAge = ours.sort((a, b) => Number(b.split('-').pop()) - Number(a.split('-').pop()));
     for (const name of byAge.slice(MAX_SETTINGS_BACKUPS))
         await rm(join(dir, name), { force: true });
@@ -78,26 +182,37 @@ const backupAndWrite = async (loaded, next) => {
 };
 /**
  * SessionStart (sweep and retry), Stop (every turn) and PreCompact only mark or
- * spawn work, and run in the background so they never delay the agent.
+ * spawn work, and run in the background so they never delay Claude Code.
  * SessionEnd stays synchronous, because Claude Code is exiting and a
- * background hook could be cut off.
+ * background hook could be cut off. Codex hooks all run synchronously; the
+ * work is the same few local file writes.
  */
-export const hookEntry = (event, command) => event === 'SessionEnd'
+export const hookEntry = (event, command, client = 'claude') => event === 'SessionEnd'
     ? { type: 'command', command, timeout: SESSION_END_TIMEOUT_SECONDS }
-    : { type: 'command', command, timeout: HOOK_TIMEOUT_SECONDS, async: true };
+    : client === 'codex'
+        ? { type: 'command', command, timeout: HOOK_TIMEOUT_SECONDS }
+        : { type: 'command', command, timeout: HOOK_TIMEOUT_SECONDS, async: true };
 export const installHooks = async (options) => {
-    if (options.client === 'codex')
-        return { installed: false, detail: CODEX_DETAIL };
-    const loaded = await load(options.home);
+    const { client } = options;
+    const refused = await hookScopeError(options.home, options, client, options.codexHome);
+    if (refused)
+        return { installed: false, detail: refused };
+    const loaded = await load(client, options, options);
     if ('error' in loaded)
         return { installed: false, detail: loaded.error };
-    const command = hookCommand(options.cliPath);
+    if (client === 'codex' && options.projectDir) {
+        const shared = await keepCodexHooksOutOfGit(loaded.path);
+        if (shared)
+            return { installed: false, detail: shared };
+    }
+    const notes = client === 'codex' ? await codexNotes(userConfigDir(client, options), options) : '';
+    const command = hookCommand(options.cliPath, client);
     const settings = structuredClone(loaded.settings);
     const hooks = isObject(settings.hooks) ? settings.hooks : {};
     let changed = false;
     for (const event of HOOK_EVENTS) {
         const groups = Array.isArray(hooks[event]) ? hooks[event] : [];
-        const wanted = hookEntry(event, command);
+        const wanted = hookEntry(event, command, client);
         let found = false;
         for (const group of groups) {
             if (!isObject(group) || !Array.isArray(group.hooks))
@@ -121,20 +236,17 @@ export const installHooks = async (options) => {
     }
     settings.hooks = hooks;
     if (!changed) {
-        return { installed: true, detail: `Hooks already installed in ${loaded.path}` };
+        return { installed: true, detail: `Hooks already installed in ${loaded.path}.${notes}` };
     }
     await backupAndWrite(loaded, settings);
-    return { installed: true, detail: `Installed ${HOOK_EVENTS.join(', ')} hooks in ${loaded.path}` };
+    return { installed: true, detail: `Installed ${HOOK_EVENTS.join(', ')} hooks in ${loaded.path}.${notes}` };
 };
 export const uninstallHooks = async (options) => {
-    if (options.client === 'codex') {
-        return { removed: false, detail: 'Codex: no hooks were installed by assethub.' };
-    }
-    const loaded = await load(options.home);
+    const loaded = await load(options.client, options, options);
     if ('error' in loaded)
         return { removed: false, detail: loaded.error };
     if (!loaded.exists || !isObject(loaded.settings.hooks)) {
-        return { removed: false, detail: 'No assethub hooks found.' };
+        return { removed: false, detail: `No assethub hooks found in ${loaded.path}.` };
     }
     const settings = structuredClone(loaded.settings);
     const hooks = settings.hooks;
@@ -166,7 +278,7 @@ export const uninstallHooks = async (options) => {
             delete hooks[event];
     }
     if (!changed)
-        return { removed: false, detail: 'No assethub hooks found.' };
+        return { removed: false, detail: `No assethub hooks found in ${loaded.path}.` };
     if (Object.keys(hooks).length === 0)
         delete settings.hooks;
     await backupAndWrite(loaded, settings);

package/dist/hooks/save.d.ts

@@ -1,4 +1,4 @@
-import type { HookInput, SessionMeta } from './types.js';
+import type { HookClient, HookInput, SessionMeta } from './types.js';
 import type { UploadOptions } from './upload.js';
 export declare const MAX_IMAGES = 50;
 export declare const MAX_IMAGE_BYTES: number;
@@ -8,6 +8,8 @@ export type SaveSessionOptions = {
     stdin?: string;
     /** Or the already-parsed fields. */
     input?: HookInput;
+    /** The agent the hook runs in; its hook command says so (`--client codex`). */
+    client?: HookClient;
     home?: string;
     now?: () => Date;
     env?: NodeJS.ProcessEnv;

package/dist/hooks/save.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/hooks/save.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAC,SAAS,EAAgB,WAAW,EAAC,MAAM,YAAY,CAAA;AACpE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,UAAU,KAAK,CAAA;AAC5B,eAAO,MAAM,eAAe,QAAmB,CAAA;AAC/C,eAAO,MAAM,sBAAsB,KAAK,CAAA;AASxC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5D,uEAAuE;IACvE,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;CACjC,CAAA;AAYD,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,EAAE,UAAU,MAAM,KAAG,IACgC,CAAA;AAE3G,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,IAC+B,CAAA;AAErF,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,CAAC,UAAU,KAAG,MAAM,GAAG,IAM/D,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,KAAK,IAAI,EACT,MAAM,MAAM,EACZ,MAAM,MAAM,KACX,OAAO,CAAC,MAAM,CAwBhB,CAAA;AAgFD,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,QAAqB,CAAA;AACpD,wEAAwE;AACxE,eAAO,MAAM,WAAW,IAAI,CAAA;AAK5B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAClB,UAAS;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAM,KAC/D,OAAO,CAAC,WAAW,GAAG,IAAI,CA6C5B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,KAAK,IAAI,EACT,mBAAmB,MAAM,KACxB,OAAO,CAAC,MAAM,CAmBhB,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,UAAS,kBAAuB,KAAG,OAAO,CAAC,iBAAiB,CAiF7F,CAAA"}
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/hooks/save.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAC,UAAU,EAAE,SAAS,EAAgB,WAAW,EAAC,MAAM,YAAY,CAAA;AAChF,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,UAAU,KAAK,CAAA;AAC5B,eAAO,MAAM,eAAe,QAAmB,CAAA;AAC/C,eAAO,MAAM,sBAAsB,KAAK,CAAA;AASxC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5D,uEAAuE;IACvE,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;CACjC,CAAA;AAYD,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,EAAE,UAAU,MAAM,KAAG,IACgC,CAAA;AAE3G,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,IAC+B,CAAA;AAErF,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,CAAC,UAAU,KAAG,MAAM,GAAG,IAM/D,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,KAAK,IAAI,EACT,MAAM,MAAM,EACZ,MAAM,MAAM,KACX,OAAO,CAAC,MAAM,CAwBhB,CAAA;AAgFD,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,QAAqB,CAAA;AACpD,wEAAwE;AACxE,eAAO,MAAM,WAAW,IAAI,CAAA;AAK5B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAClB,UAAS;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAM,KAC/D,OAAO,CAAC,WAAW,GAAG,IAAI,CA6C5B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,KAAK,IAAI,EACT,mBAAmB,MAAM,KACxB,OAAO,CAAC,MAAM,CAmBhB,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,UAAS,kBAAuB,KAAG,OAAO,CAAC,iBAAiB,CAkF7F,CAAA"}

package/dist/hooks/save.js

@@ -281,11 +281,12 @@ export const saveSession = async (options = {}) => {
         const canvasId = await readCanvasId(cwd, env);
         const sessionId = input.session_id;
         const transcriptPath = input.transcript_path;
+        const client = options.client ?? 'claude';
         const full = FULL_SAVE_EVENTS.has(event);
         const fresh = {
             sessionId,
             cwd,
-            client: 'claude',
+            client,
             lastEvent: event,
             savedAt: now.toISOString(),
             status: 'saved',
@@ -297,7 +298,7 @@ export const saveSession = async (options = {}) => {
             ...latest,
             sessionId,
             cwd,
-            client: 'claude',
+            client,
             transcriptPath,
             lastEvent: event,
             savedAt: now.toISOString(),

package/dist/hooks/transcript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/hooks/transcript.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GACtB;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,GAClD;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,GACrD;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,CAAA;AAE3F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,mEAAmE;IACnE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACpC,CAAA;AAID,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MAAM,EAGtD,CAAA;AAgBD,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,gBAiD7C,CAAA"}
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/hooks/transcript.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GACtB;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,GAClD;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,GACrD;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,CAAA;AAE3F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,mEAAmE;IACnE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACpC,CAAA;AAQD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MAAM,EAGtD,CAAA;AAgBD,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,gBAiD7C,CAAA"}

package/dist/hooks/transcript.js

@@ -1,6 +1,10 @@
 // Parse a Claude Code transcript (JSONL) into the flat sequence the session
 // graph is built from.
-const IMAGE_PATH_RE = /(?<![\w.~-])(?:\/[^\s"'\\<>|:*?`()[\]{}]+)+\.(?:png|jpe?g|webp)\b/gi;
+// One run of path characters (they include `/`), capped at Linux's PATH_MAX
+// (4096) so a long line with no spaces, such as base64, is scanned in linear
+// time. A nested `(?:/…+)+` backtracks exponentially there and hung the save
+// on a Codex rollout.
+const IMAGE_PATH_RE = /(?<![\w.~-])\/[^\s"'\\<>|:*?`()[\]{}]{0,4096}?\.(?:png|jpe?g|webp)\b/gi;
 export const extractImagePaths = (text) => {
     const found = text.match(IMAGE_PATH_RE) ?? [];
     return [...new Set(found)];

package/dist/hooks/trim.d.ts

@@ -7,8 +7,18 @@ type Json = Record<string, unknown>;
 /** One transcript entry reduced to what the conversation needs, or undefined to drop it. */
 export declare const trimTranscriptEntry: (entry: unknown) => Json | undefined;
 /**
- * Trim a JSONL transcript. A file that is not a Claude Code transcript (for
- * example a Codex rollout saved by hand) is returned unchanged.
+ * One Codex rollout record as a conversation entry in the same shape as a
+ * trimmed Claude Code transcript, or undefined to drop it. Kept: the artist's
+ * prompts, the agent's replies, its tool calls and their output, and compaction
+ * summaries. Dropped: session metadata (base instructions, git, cwd), developer
+ * and context messages, reasoning, turn settings and the event stream, which
+ * repeats the messages.
+ */
+export declare const codexEntry: (entry: unknown) => Json | undefined;
+/**
+ * Trim a JSONL transcript: a Claude Code transcript, or a Codex rollout turned
+ * into the same conversation shape. A file in any other format is returned
+ * unchanged.
  */
 export declare const trimTranscript: (raw: string) => string;
 export {};

package/dist/hooks/trim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trim.d.ts","sourceRoot":"","sources":["../../src/hooks/trim.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,oBAAoB,CAAA;AAElD,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAuDnC,4FAA4F;AAC5F,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,IAAI,GAAG,SAqB3D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAc5C,CAAA"}
+{"version":3,"file":"trim.d.ts","sourceRoot":"","sources":["../../src/hooks/trim.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,oBAAoB,CAAA;AAElD,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAuDnC,4FAA4F;AAC5F,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,IAAI,GAAG,SAqB3D,CAAA;AA8DD;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,IAAI,GAAG,SAuClD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAgB5C,CAAA"}