common-memory-core 0.2.0

package/dist/cli/host-launch.d.ts

@@ -0,0 +1,28 @@
+export declare const shellQuote: (value: string) => string;
+export interface LaunchOptions {
+    wsl: boolean;
+    distro?: string | undefined;
+    user?: string | undefined;
+    wslExe?: string | undefined;
+    workspaces?: string[];
+}
+export declare function runtimeLaunch(options: LaunchOptions, env?: NodeJS.ProcessEnv): {
+    node: string;
+    cli: string;
+    home: string;
+    distro: string | undefined;
+    user: string;
+    wslExe: string;
+    command(args: string[]): {
+        command: string;
+        args: string[];
+        env?: never;
+    } | {
+        command: string;
+        args: string[];
+        env: {
+            COMMON_MEMORY_HOME: string;
+        };
+    };
+};
+//# sourceMappingURL=host-launch.d.ts.map

package/dist/cli/host-launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-launch.d.ts","sourceRoot":"","sources":["../../src/cli/host-launch.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,GAAE,OAAM,MAAM,WAA0C,CAAC;AAChF,MAAM,WAAW,aAAa;IAAG,GAAG,EAAC,OAAO,CAAC;IAAC,MAAM,CAAC,EAAC,MAAM,GAAC,SAAS,CAAC;IAAC,IAAI,CAAC,EAAC,MAAM,GAAC,SAAS,CAAC;IAAC,MAAM,CAAC,EAAC,MAAM,GAAC,SAAS,CAAC;IAAC,UAAU,CAAC,EAAC,MAAM,EAAE,CAAA;CAAE;AAChJ,wBAAgB,aAAa,CAAC,OAAO,EAAC,aAAa,EAAC,GAAG,GAAC,MAAM,CAAC,UAAsB;;;;;;;kBAM7B,MAAM,EAAE;;;;;;;;;;;EAC/D"}

package/dist/cli/host-launch.js

@@ -0,0 +1,16 @@
+import { realpathSync } from 'node:fs';
+import { userInfo } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { configDirectory } from '../config/config.js';
+export const shellQuote = (value) => "'" + value.replaceAll("'", "'\"'\"'") + "'";
+export function runtimeLaunch(options, env = process.env) {
+    const node = realpathSync(process.execPath), cli = realpathSync(process.argv[1] ?? fileURLToPath(new URL('./main.js', import.meta.url))), home = configDirectory(env);
+    const distro = options.distro ?? env.WSL_DISTRO_NAME, user = options.user ?? userInfo().username;
+    if (options.wsl && (process.platform !== 'linux' || !distro))
+        throw new Error('--wsl requires a Linux runtime and a fixed --distro');
+    const wslExe = options.wslExe ?? 'C:\\Windows\\System32\\wsl.exe';
+    if (options.wsl && !/^[A-Za-z]:\\/.test(wslExe))
+        throw new Error('wsl.exe must be an absolute Windows path');
+    return { node, cli, home, distro, user, wslExe, command(args) { return options.wsl ? { command: wslExe, args: ['-d', distro, '-u', user, '-e', '/usr/bin/env', `COMMON_MEMORY_HOME=${home}`, node, cli, ...args] } : { command: node, args: [cli, ...args], env: { COMMON_MEMORY_HOME: home } }; } };
+}
+//# sourceMappingURL=host-launch.js.map

package/dist/cli/host-launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-launch.js","sourceRoot":"","sources":["../../src/cli/host-launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,MAAM,CAAC,MAAM,UAAU,GAAC,CAAC,KAAY,EAAC,EAAE,CAAA,GAAG,GAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAC,SAAS,CAAC,GAAC,GAAG,CAAC;AAEhF,MAAM,UAAU,aAAa,CAAC,OAAqB,EAAC,MAAsB,OAAO,CAAC,GAAG;IACnF,MAAM,IAAI,GAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAC,GAAG,GAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAE,aAAa,CAAC,IAAI,GAAG,CAAC,WAAW,EAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAC,IAAI,GAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC3J,MAAM,MAAM,GAAC,OAAO,CAAC,MAAM,IAAE,GAAG,CAAC,eAAe,EAAC,IAAI,GAAC,OAAO,CAAC,IAAI,IAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACxF,IAAG,OAAO,CAAC,GAAG,IAAE,CAAC,OAAO,CAAC,QAAQ,KAAG,OAAO,IAAE,CAAC,MAAM,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC7H,MAAM,MAAM,GAAC,OAAO,CAAC,MAAM,IAAE,gCAAgC,CAAC;IAC9D,IAAG,OAAO,CAAC,GAAG,IAAE,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACzG,OAAO,EAAC,IAAI,EAAC,GAAG,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,MAAM,EAAC,OAAO,CAAC,IAAa,IAAE,OAAO,OAAO,CAAC,GAAG,CAAA,CAAC,CAAA,EAAC,OAAO,EAAC,MAAM,EAAC,IAAI,EAAC,CAAC,IAAI,EAAC,MAAO,EAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,cAAc,EAAC,sBAAsB,IAAI,EAAE,EAAC,IAAI,EAAC,GAAG,EAAC,GAAG,IAAI,CAAC,EAAC,CAAA,CAAC,CAAA,EAAC,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,CAAC,GAAG,EAAC,GAAG,IAAI,CAAC,EAAC,GAAG,EAAC,EAAC,kBAAkB,EAAC,IAAI,EAAC,EAAC,CAAC,CAAA,CAAC,EAAC,CAAC;AACzQ,CAAC"}

package/dist/cli/host-process.d.ts

@@ -0,0 +1,3 @@
+/** A bridge supplies the native host's PID and creation time, never its own PID. */
+export declare function hostProcessInstance(): string;
+//# sourceMappingURL=host-process.d.ts.map

package/dist/cli/host-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-process.d.ts","sourceRoot":"","sources":["../../src/cli/host-process.ts"],"names":[],"mappings":"AAIA,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,MAAM,CAmB5C"}

package/dist/cli/host-process.js

@@ -0,0 +1,35 @@
+import { readFileSync, readlinkSync } from 'node:fs';
+import { basename } from 'node:path';
+import { execFileSync } from 'node:child_process';
+/** A bridge supplies the native host's PID and creation time, never its own PID. */
+export function hostProcessInstance() {
+    const bridge = process.env.COMMON_MEMORY_HOST_INSTANCE;
+    if (bridge) {
+        if (!/^windows:\d+:\d+$/.test(bridge))
+            throw new Error('INVALID_HOST_INSTANCE');
+        return bridge;
+    }
+    let pid = process.ppid;
+    for (let depth = 0; pid > 1 && depth < 32; depth++) {
+        if (process.platform === 'linux') {
+            const stat = readFileSync(`/proc/${pid}/stat`, 'utf8'), fields = stat.slice(stat.lastIndexOf(')') + 2).split(' ');
+            const exe = basename(readlinkSync(`/proc/${pid}/exe`));
+            if (/^codex(?:-|$)/.test(exe))
+                return `${readFileSync('/proc/sys/kernel/random/boot_id', 'utf8').trim()}:${pid}:${fields[19]}`;
+            pid = Number(fields[1]);
+        }
+        else if (process.platform === 'darwin') {
+            const output = execFileSync('/bin/ps', ['-p', String(pid), '-o', 'ppid=,lstart=,comm='], { encoding: 'utf8' }).trim();
+            const match = /^(\d+)\s+(.{24})\s+(.+)$/.exec(output);
+            if (!match)
+                throw new Error('CODEX_HOST_PROCESS_UNCONFIRMED');
+            if (/^codex(?:-|$)/.test(basename(match[3])))
+                return `darwin:${pid}:${match[2]}`;
+            pid = Number(match[1]);
+        }
+        else
+            throw new Error('CODEX_PROCESS_IDENTITY_UNSUPPORTED');
+    }
+    throw new Error('CODEX_HOST_PROCESS_UNCONFIRMED');
+}
+//# sourceMappingURL=host-process.js.map

package/dist/cli/host-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-process.js","sourceRoot":"","sources":["../../src/cli/host-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,oFAAoF;AACpF,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;IACrD,IAAG,MAAM,EAAC,CAAC;QAAA,IAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAAA,OAAO,MAAM,CAAC;IAAA,CAAC;IACxG,IAAI,GAAG,GAAC,OAAO,CAAC,IAAI,CAAC;IACrB,KAAI,IAAI,KAAK,GAAC,CAAC,EAAC,GAAG,GAAC,CAAC,IAAE,KAAK,GAAC,EAAE,EAAC,KAAK,EAAE,EAAE,CAAC;QACxC,IAAG,OAAO,CAAC,QAAQ,KAAG,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAC,YAAY,CAAC,SAAS,GAAG,OAAO,EAAC,MAAM,CAAC,EAAC,MAAM,GAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1G,MAAM,GAAG,GAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;YACrD,IAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAC,OAAO,GAAG,YAAY,CAAC,iCAAiC,EAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5H,GAAG,GAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;aAAM,IAAG,OAAO,CAAC,QAAQ,KAAG,QAAQ,EAAE,CAAC;YACtC,MAAM,MAAM,GAAC,YAAY,CAAC,SAAS,EAAC,CAAC,IAAI,EAAC,MAAM,CAAC,GAAG,CAAC,EAAC,IAAI,EAAC,qBAAqB,CAAC,EAAC,EAAC,QAAQ,EAAC,MAAM,EAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5G,MAAM,KAAK,GAAC,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpD,IAAG,CAAC,KAAK;gBAAC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC5D,IAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;gBAAC,OAAO,UAAU,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,GAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;;YAAM,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACpD,CAAC"}

package/dist/cli/host-session.d.ts

@@ -0,0 +1,22 @@
+import { hostProcessInstance } from './host-process.js';
+import type { CommonMemoryConfig } from '../config/config.js';
+import { RuntimeStore } from '../v2/runtime.js';
+export interface CodexEvent {
+    hook_event_name: 'SessionStart' | 'UserPromptSubmit' | 'Stop' | 'SessionEnd' | 'Interrupt' | 'PostToolUse';
+    cwd: string;
+    session_id: string;
+    transcript_path: string;
+    source?: string;
+    turn_id?: string;
+    prompt?: string;
+}
+export declare function setupHostAdapter(store: RuntimeStore): void;
+export declare const codexProcessInstance: typeof hostProcessInstance;
+/** SQLite WAL + synchronous=FULL is the atomic, fsynced inbox. No remote work in a hook. */
+export declare function enqueueCodexEvent(config: CommonMemoryConfig, event: CodexEvent, instance?: string, client?: HostClient): {
+    key: string;
+    initial: boolean;
+};
+export declare function consumeCodexInbox(config: CommonMemoryConfig, progressCallback?: () => Promise<void>): Promise<void>;
+export type HostClient = 'codex' | 'chatgpt-work';
+//# sourceMappingURL=host-session.d.ts.map

package/dist/cli/host-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-session.d.ts","sourceRoot":"","sources":["../../src/cli/host-session.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIhD,MAAM,WAAW,UAAU;IAAG,eAAe,EAAC,cAAc,GAAC,kBAAkB,GAAC,MAAM,GAAC,YAAY,GAAC,WAAW,GAAC,aAAa,CAAC;IAAA,GAAG,EAAC,MAAM,CAAC;IAAA,UAAU,EAAC,MAAM,CAAC;IAAA,eAAe,EAAC,MAAM,CAAC;IAAA,MAAM,CAAC,EAAC,MAAM,CAAC;IAAA,OAAO,CAAC,EAAC,MAAM,CAAC;IAAA,MAAM,CAAC,EAAC,MAAM,CAAA;CAAE;AACjO,wBAAgB,gBAAgB,CAAC,KAAK,EAAC,YAAY,GAAE,IAAI,CAQxD;AACD,eAAO,MAAM,oBAAoB,4BAAsB,CAAC;AAmBxD,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAC,kBAAkB,EAAC,KAAK,EAAC,UAAU,EAAC,QAAQ,SAAuB,EAAC,MAAM,GAAC,UAAkB,GAAE;IAAC,GAAG,EAAC,MAAM,CAAC;IAAA,OAAO,EAAC,OAAO,CAAA;CAAC,CAoCnK;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAC,kBAAkB,EAAE,gBAAgB,CAAC,EAAC,MAAI,OAAO,CAAC,IAAI,CAAC,GAAE,OAAO,CAAC,IAAI,CAAC,CA+CpH;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC"}

package/dist/cli/host-session.js

@@ -0,0 +1,204 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { closeSync, openSync, readSync, fstatSync } from 'node:fs';
+import { hostProcessInstance } from './host-process.js';
+import { constants } from 'node:fs';
+import { setTimeout } from 'node:timers/promises';
+import { RuntimeStore } from '../v2/runtime.js';
+import { SessionIngress, sessionKey } from '../v2/session.js';
+import { ProjectRegistry } from '../v2/registry.js';
+import { parseTranscript } from './codex/transcript-0.153.4.js';
+export function setupHostAdapter(store) {
+    store.db.exec(`CREATE TABLE IF NOT EXISTS host_activations(base TEXT PRIMARY KEY,sessionId TEXT NOT NULL,client TEXT NOT NULL,instance TEXT NOT NULL,thread TEXT NOT NULL,cwd TEXT NOT NULL,active INTEGER NOT NULL DEFAULT 1);
+    CREATE TABLE IF NOT EXISTS host_snapshots(sessionId TEXT PRIMARY KEY,body TEXT NOT NULL,pending INTEGER NOT NULL DEFAULT 0);
+    CREATE TABLE IF NOT EXISTS codex_cursors(sessionId TEXT PRIMARY KEY,path TEXT NOT NULL,offset INTEGER NOT NULL,turnId TEXT);
+    CREATE TABLE IF NOT EXISTS codex_inbox(id INTEGER PRIMARY KEY,sessionId TEXT NOT NULL,event TEXT NOT NULL,turnId TEXT,start INTEGER NOT NULL,body TEXT NOT NULL,scope TEXT NOT NULL);
+    CREATE TABLE IF NOT EXISTS codex_candidates(sessionId TEXT NOT NULL,turnId TEXT NOT NULL,digest TEXT NOT NULL,text TEXT,PRIMARY KEY(sessionId,turnId,digest));
+    CREATE TABLE IF NOT EXISTS codex_watches(sessionId TEXT NOT NULL,turnId TEXT NOT NULL,PRIMARY KEY(sessionId,turnId));`);
+    store.transaction(() => { if (!store.db.prepare('PRAGMA table_info(codex_candidates)').all().some(r => r.name === 'scope'))
+        store.db.exec('ALTER TABLE codex_candidates ADD COLUMN scope TEXT'); });
+}
+export const codexProcessInstance = hostProcessInstance;
+function transcript(path, offset, cap) {
+    const fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        const stat = fstatSync(fd);
+        if (!stat.isFile() || stat.nlink !== 1)
+            throw new Error('CODEX_UNSAFE_TRANSCRIPT');
+        const header = Buffer.alloc(Math.min(stat.size, 65536));
+        readSync(fd, header, 0, header.length, 0);
+        let meta;
+        try {
+            meta = JSON.parse(header.subarray(0, header.indexOf(10)).toString('utf8'));
+        }
+        catch {
+            throw new Error('CODEX_UNKNOWN_TRANSCRIPT');
+        }
+        if (meta.type !== 'session_meta' || meta.payload?.cli_version !== '0.153.4')
+            throw new Error('CODEX_UNSUPPORTED_VERSION');
+        if (offset === null)
+            return { text: '', end: stat.size };
+        if (stat.size < offset)
+            throw new Error('CODEX_TRANSCRIPT_REPLACED');
+        if (stat.size - offset > cap)
+            throw new Error('SESSION_CAPACITY_EXCEEDED');
+        const buffer = Buffer.alloc(stat.size - offset);
+        let read = 0;
+        while (read < buffer.length) {
+            const n = readSync(fd, buffer, read, buffer.length - read, offset + read);
+            if (!n)
+                throw new Error('CODEX_TRANSCRIPT_CHANGED');
+            read += n;
+        }
+        // Never advance over a partial JSONL record. SessionEnd reports it as a failure.
+        const complete = buffer.lastIndexOf(10) + 1;
+        return { text: new TextDecoder('utf-8', { fatal: true }).decode(buffer.subarray(0, complete)), end: offset + complete };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** SQLite WAL + synchronous=FULL is the atomic, fsynced inbox. No remote work in a hook. */
+export function enqueueCodexEvent(config, event, instance = codexProcessInstance(), client = 'codex') {
+    const store = new RuntimeStore(config.dataRoot, { sqliteTimeoutMs: 150 });
+    setupHostAdapter(store);
+    try {
+        return store.transaction(() => {
+            const ingress = new SessionIngress(store, config.sessionCache);
+            let identity = { client, processInstance: instance, sessionId: event.session_id };
+            const base = sessionKey(identity), activation = store.db.prepare('SELECT * FROM host_activations WHERE base=?').get(base);
+            if (activation && !activation.active && (event.hook_event_name !== 'SessionStart' || !['startup', 'resume'].includes(event.source ?? '')))
+                throw new Error('CODEX_SESSION_START_REQUIRED');
+            if (activation && !activation.active)
+                identity = { ...identity, processInstance: instance + ':' + randomUUID() };
+            const key = activation?.active ? String(activation.sessionId) : sessionKey(identity);
+            if (!activation?.active)
+                store.db.prepare('INSERT OR REPLACE INTO host_activations VALUES(?,?,?,?,?,?,1)').run(base, key, client, instance, event.session_id, event.cwd);
+            else
+                store.db.prepare('UPDATE host_activations SET cwd=? WHERE base=?').run(event.cwd, base);
+            const prior = store.db.prepare('SELECT * FROM codex_cursors WHERE sessionId=?').get(key);
+            const initial = !prior;
+            if (!prior) {
+                if (event.hook_event_name !== 'SessionStart')
+                    throw new Error('CODEX_SESSION_START_REQUIRED');
+                const start = transcript(event.transcript_path, null, ingress.limits.maxSessionBytes);
+                ingress.open(identity);
+                store.db.prepare('INSERT INTO codex_cursors(sessionId,path,offset) VALUES(?,?,?)').run(key, event.transcript_path, start.end);
+            }
+            else if (prior.path !== event.transcript_path)
+                throw new Error('CODEX_TRANSCRIPT_REPLACED');
+            const project = new ProjectRegistry(config.dataRoot).resolve(event.cwd), scope = project ? `project:${project.id}` : 'global';
+            if (event.hook_event_name === 'UserPromptSubmit') {
+                if (typeof event.prompt !== 'string' || !event.turn_id)
+                    throw new Error('CODEX_INPUT_IDENTITY_REQUIRED');
+                store.db.prepare('INSERT OR IGNORE INTO codex_candidates(sessionId,turnId,digest,text,scope) VALUES(?,?,?,?,?)').run(key, event.turn_id, createHash('sha256').update(event.prompt).digest('hex'), event.prompt, scope);
+            }
+            const cursor = store.db.prepare('SELECT offset FROM codex_cursors WHERE sessionId=?').get(key);
+            const queued = store.db.prepare('SELECT start,length(CAST(body AS BLOB)) AS bytes FROM codex_inbox WHERE sessionId=? ORDER BY id DESC LIMIT 1').get(key);
+            const offset = queued ? Number(queued.start) + Number(queued.bytes) : Number(cursor.offset);
+            const snapshot = transcript(event.transcript_path, offset, ingress.limits.maxSessionBytes);
+            if (event.hook_event_name === 'SessionEnd' && fstatSize(event.transcript_path) !== snapshot.end)
+                throw new Error('CODEX_PARTIAL_TRANSCRIPT');
+            const bytes = Buffer.byteLength(snapshot.text);
+            ingress.reserve(key, bytes);
+            store.db.prepare('INSERT INTO codex_inbox(sessionId,event,turnId,start,body,scope) VALUES(?,?,?,?,?,?)').run(key, event.hook_event_name, event.turn_id ?? null, offset, snapshot.text, scope);
+            if (event.hook_event_name === 'SessionEnd') {
+                store.db.prepare('UPDATE host_activations SET active=0 WHERE base=?').run(base);
+                store.db.prepare('DELETE FROM host_snapshots WHERE sessionId=?').run(key);
+            }
+            return { key, initial };
+        });
+    }
+    finally {
+        store.close();
+    }
+}
+function fstatSize(path) { const fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW); try {
+    return fstatSync(fd).size;
+}
+finally {
+    closeSync(fd);
+} }
+export async function consumeCodexInbox(config, progressCallback) {
+    const store = new RuntimeStore(config.dataRoot);
+    setupHostAdapter(store);
+    const ingress = new SessionIngress(store, config.sessionCache);
+    const deadline = Date.now() + 60000;
+    try {
+        for (;;) {
+            if (Date.now() > deadline)
+                throw new Error('CODEX_COMPLETION_UNCONFIRMED');
+            const consumed = store.transaction(() => {
+                const row = store.db.prepare('SELECT * FROM codex_inbox ORDER BY id LIMIT 1').get();
+                if (!row)
+                    return false;
+                const key = String(row.sessionId), cursor = store.db.prepare('SELECT * FROM codex_cursors WHERE sessionId=?').get(key);
+                if (row.start !== cursor.offset)
+                    throw new Error('CODEX_CURSOR_CONFLICT');
+                const parsed = parseTranscript(String(row.body), { offset: Number(cursor.offset), turnId: cursor.turnId === null ? null : String(cursor.turnId) }, String(row.scope));
+                // Replacing the inbox body by session rows is one transaction, without duplicate durable bodies.
+                store.db.prepare('DELETE FROM codex_inbox WHERE id=?').run(row.id);
+                for (const action of parsed.actions) {
+                    if (action.kind === 'message') {
+                        if (action.message.role === 'user') {
+                            const digest = createHash('sha256').update(action.message.text).digest('hex');
+                            const candidate = store.db.prepare('SELECT digest,scope,text FROM codex_candidates WHERE sessionId=? AND turnId=? AND digest=?').get(key, action.message.turnId, digest);
+                            if (!candidate || typeof candidate.scope !== 'string')
+                                throw new Error('CODEX_UNCONFIRMED_DELIVERY');
+                            if (candidate.text === null)
+                                continue;
+                            action.message.scope = candidate.scope;
+                            store.db.prepare('UPDATE codex_candidates SET text=NULL WHERE sessionId=? AND turnId=? AND digest=?').run(key, action.message.turnId, digest);
+                        }
+                        ingress.capture(key, action.message);
+                    }
+                    else
+                        ingress.settle(key, action.turnId, action.state);
+                }
+                store.db.prepare('UPDATE codex_cursors SET offset=?,turnId=? WHERE sessionId=?').run(parsed.state.offset, parsed.state.turnId, key);
+                if ((row.event === 'Stop' || row.event === 'Interrupt') && row.turnId)
+                    store.db.prepare('INSERT OR IGNORE INTO codex_watches VALUES(?,?)').run(key, row.turnId);
+                if (row.event === 'SessionEnd') {
+                    ingress.end(key);
+                    store.db.prepare('UPDATE codex_candidates SET text=NULL WHERE sessionId=?').run(key);
+                    store.db.prepare('DELETE FROM codex_watches WHERE sessionId=?').run(key);
+                }
+                return true;
+            });
+            if (consumed) {
+                await progressCallback?.();
+                continue;
+            }
+            const watches = store.db.prepare('SELECT w.*,c.path,c.offset,c.turnId AS activeTurn FROM codex_watches w JOIN codex_cursors c ON c.sessionId=w.sessionId').all();
+            if (!watches.length)
+                return;
+            let progress = false;
+            for (const w of watches)
+                store.transaction(() => {
+                    const state = store.db.prepare('SELECT state FROM session_turns WHERE sessionId=? AND turnId=?').get(w.sessionId, w.turnId);
+                    if (state && state.state !== 'open') {
+                        store.db.prepare('DELETE FROM codex_watches WHERE sessionId=? AND turnId=?').run(w.sessionId, w.turnId);
+                        progress = true;
+                        return;
+                    }
+                    if (store.db.prepare('SELECT 1 FROM codex_inbox WHERE sessionId=?').get(w.sessionId))
+                        return;
+                    const cursor = store.db.prepare('SELECT * FROM codex_cursors WHERE sessionId=?').get(w.sessionId);
+                    const snapshot = transcript(String(cursor.path), Number(cursor.offset), ingress.limits.maxSessionBytes);
+                    if (!snapshot.text)
+                        return;
+                    const scope = String(store.db.prepare('SELECT scope FROM session_messages WHERE sessionId=? ORDER BY id DESC LIMIT 1').get(w.sessionId)?.scope ?? 'global');
+                    ingress.reserve(String(w.sessionId), Buffer.byteLength(snapshot.text));
+                    store.db.prepare("INSERT INTO codex_inbox(sessionId,event,start,body,scope) VALUES(?,'Reconcile',?,?,?)").run(w.sessionId, cursor.offset, snapshot.text, scope);
+                    progress = true;
+                });
+            if (!progress) {
+                await progressCallback?.();
+                await setTimeout(100);
+            }
+        }
+    }
+    finally {
+        store.close();
+    }
+}
+//# sourceMappingURL=host-session.js.map

package/dist/cli/host-session.js.map

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

package/dist/cli/import-command.d.ts

@@ -0,0 +1,20 @@
+import type { CommonMemoryConfig } from "../config/config.js";
+import { type DocumentAuthor, type DocumentImportOutcome } from "../v2/document-import.js";
+export interface ImportOptions {
+    file: string;
+    workspace?: string | undefined;
+    author?: DocumentAuthor | undefined;
+    label?: string | undefined;
+    wait: boolean;
+}
+export declare function parseImportArgs(args: string[]): ImportOptions;
+/**
+ * `common-memory import <file.md>`: preprocess one local Markdown file, queue it as document_import
+ * observations, then (by default) run the same Writer loop as `flush` and report each part. Nothing
+ * here writes canonical Markdown directly; the Writer decides and the executor validates.
+ */
+export declare function runImport(config: CommonMemoryConfig, args: string[], log?: (line: string) => void): Promise<{
+    exitCode: number;
+    outcome: DocumentImportOutcome | null;
+}>;
+//# sourceMappingURL=import-command.d.ts.map

package/dist/cli/import-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-command.d.ts","sourceRoot":"","sources":["../../src/cli/import-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAuF,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGhL,MAAM,WAAW,aAAa;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE;AAE/J,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAiB7D;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAAE,CAAC,CAiC3L"}

package/dist/cli/import-command.js

@@ -0,0 +1,98 @@
+import { isAbsolute } from "node:path";
+import { createConfiguredWriter } from "../config/runtime.js";
+import { admitDocumentImport, DOCUMENT_AUTHORS, documentImportOutcome, prepareDocumentImport } from "../v2/document-import.js";
+import { ProjectRegistry } from "../v2/registry.js";
+export function parseImportArgs(args) {
+    const options = { file: "", wait: true };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--no-wait")
+            options.wait = false;
+        else if (arg === "--workspace" || arg === "--author" || arg === "--label") {
+            const value = args[++i];
+            if (value === undefined || value.startsWith("--"))
+                throw new TypeError(`${arg} requires a value`);
+            if (arg === "--workspace") {
+                if (!isAbsolute(value))
+                    throw new TypeError("--workspace must be an absolute path");
+                options.workspace = value;
+            }
+            else if (arg === "--author") {
+                if (!DOCUMENT_AUTHORS.includes(value))
+                    throw new TypeError(`--author must be one of ${DOCUMENT_AUTHORS.join("|")}`);
+                options.author = value;
+            }
+            else
+                options.label = value;
+        }
+        else if (arg.startsWith("--"))
+            throw new TypeError(`Unknown import option ${arg}`);
+        else if (options.file)
+            throw new TypeError("import accepts exactly one file");
+        else
+            options.file = arg;
+    }
+    if (!options.file)
+        throw new TypeError("import requires a Markdown file path");
+    return options;
+}
+/**
+ * `common-memory import <file.md>`: preprocess one local Markdown file, queue it as document_import
+ * observations, then (by default) run the same Writer loop as `flush` and report each part. Nothing
+ * here writes canonical Markdown directly; the Writer decides and the executor validates.
+ */
+export async function runImport(config, args, log = console.log) {
+    const options = parseImportArgs(args);
+    if (!config.disclosure.allowedProvenance.includes("document_import"))
+        throw new Error("IMPORT_DISABLED: allow \"Imported Markdown documents\" in common-memory config (disclosure.allowedProvenance: document_import)");
+    let contextId = "global";
+    if (options.workspace) {
+        let project;
+        try {
+            project = new ProjectRegistry(config.dataRoot).resolve(options.workspace);
+        }
+        catch {
+            project = undefined;
+        }
+        if (!project)
+            throw new Error("UNREGISTERED_WORKSPACE: register it with common-memory project register");
+        contextId = `project:${project.id}`;
+    }
+    if (!config.disclosure.allowedScopes.includes(contextId))
+        throw new Error(`CONTEXT_UNAVAILABLE: ${contextId} is not in disclosure.allowedScopes`);
+    const prepared = prepareDocumentImport(options.file, { label: options.label, author: options.author, maxTotalBytes: config.disclosure.maxTotalBytes });
+    log(`file: ${prepared.fileName} (${prepared.bytes} bytes, ${prepared.chunks.length} part${prepared.chunks.length === 1 ? "" : "s"}); label: ${prepared.sourceLabel}; declared author: ${prepared.declaredAuthor}; context: ${contextId}`);
+    if (!config.writableScopes.includes(contextId))
+        log(`note: ${contextId} is not in writableScopes; the Writer can only commit to writable targets`);
+    const writer = createConfiguredWriter(config), controller = new AbortController();
+    const cancel = () => controller.abort();
+    process.once('SIGINT', cancel);
+    process.once('SIGTERM', cancel);
+    try {
+        const admitted = admitDocumentImport(writer.store, prepared, contextId);
+        log(admitted.duplicate ? `duplicate: this exact content was already imported as ${admitted.importId}; no new material was queued` : `accepted: queued as ${admitted.importId} (${admitted.parts} part${admitted.parts === 1 ? "" : "s"}); accepted means durably queued, not remembered`);
+        if (options.wait) {
+            for (;;) {
+                const result = await writer.run({ force: true, signal: controller.signal });
+                log(`maintenance: ${JSON.stringify(result)}`);
+                if (!["committed", "noop", "ignored", "quarantined"].includes(result.outcome))
+                    break;
+            }
+        }
+        const outcome = documentImportOutcome(writer.store, prepared.importId, contextId, prepared.chunks.length);
+        log(JSON.stringify(outcome, null, 2));
+        if (outcome.complete)
+            log(outcome.retainedIn.length ? `complete: retained in ${outcome.retainedIn.join(", ")}; review with common-memory show` : "complete: the Writer kept nothing from this file (ignored or reorganized only)");
+        else if (!options.wait)
+            log("queued: run common-memory flush, or import the same file again, to process and report");
+        else
+            log("incomplete: some parts were not processed. dead jobs: common-memory retry <job-id>; pending/retry: import the same file again or common-memory flush; quarantined parts are final for this content (see their issue above) and need a changed file to be imported again");
+        return { exitCode: options.wait && !outcome.complete ? 1 : 0, outcome };
+    }
+    finally {
+        process.off('SIGINT', cancel);
+        process.off('SIGTERM', cancel);
+        await writer.close();
+    }
+}
+//# sourceMappingURL=import-command.js.map

package/dist/cli/import-command.js.map

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

package/dist/cli/interactive-process.d.ts

@@ -0,0 +1,3 @@
+/** Deliberate native-host handoff, never a shell string. Cancellation returns to the TUI. */
+export declare function runInteractiveProcess(command: string, args: string[], env?: NodeJS.ProcessEnv): Promise<number>;
+//# sourceMappingURL=interactive-process.d.ts.map

package/dist/cli/interactive-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-process.d.ts","sourceRoot":"","sources":["../../src/cli/interactive-process.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAW5H"}

package/dist/cli/interactive-process.js

@@ -0,0 +1,15 @@
+import { spawn } from 'node:child_process';
+/** Deliberate native-host handoff, never a shell string. Cancellation returns to the TUI. */
+export function runInteractiveProcess(command, args, env = process.env) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: 'inherit', env, shell: false });
+        const interrupt = () => { child.kill('SIGINT'); };
+        const terminate = () => { child.kill('SIGTERM'); };
+        const cleanup = () => { process.off('SIGINT', interrupt); process.off('SIGTERM', terminate); };
+        process.on('SIGINT', interrupt);
+        process.on('SIGTERM', terminate);
+        child.once('error', error => { cleanup(); reject(error); });
+        child.once('close', code => { cleanup(); resolve(code ?? 1); });
+    });
+}
+//# sourceMappingURL=interactive-process.js.map

package/dist/cli/interactive-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-process.js","sourceRoot":"","sources":["../../src/cli/interactive-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,6FAA6F;AAC7F,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,IAAc,EAAE,MAAyB,OAAO,CAAC,GAAG;IACzG,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/F,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":""}