@oatelauser/crosschat 1.0.0

package/dist/codex/queue.js

@@ -0,0 +1,71 @@
+import { spawn } from 'node:child_process';
+import process from 'node:process';
+import { MultichatError } from '../errors.js';
+import { resolveCodexExecutable } from './transport.js';
+const DEFAULT_QUEUE_TIMEOUT_MS = 30_000;
+const STDERR_EXCERPT_CHARS = 300;
+const STDERR_CAPTURE_LIMIT = 4_096;
+/**
+ * The message travels as a single argv element (`--message <content>`), so
+ * there is no shell quoting involved. Windows caps the command line at ~32K
+ * characters; multichat's 16KiB body limit (enforced in commands/send.ts)
+ * plus the envelope overhead keeps argv safely below that ceiling.
+ */
+export async function queueToCodexThread(threadId, content, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_QUEUE_TIMEOUT_MS;
+    const command = options.executable ?? resolveCodexExecutable();
+    const doSpawn = options.spawnProcess ??
+        ((cmd, args) => spawn(cmd, [...args], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: false,
+            windowsHide: true,
+            env: process.env,
+        }));
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = doSpawn(command, ['queue', '--thread', threadId, '--message', content]);
+        }
+        catch (err) {
+            reject(queueFailed(threadId, command, 'process could not be spawned', err));
+            return;
+        }
+        let stderrText = '';
+        let settled = false;
+        const finish = (settle) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            settle();
+        };
+        const timer = setTimeout(() => {
+            finish(() => {
+                try {
+                    child.kill();
+                }
+                catch {
+                    // already dead
+                }
+                reject(queueFailed(threadId, command, `timed out after ${timeoutMs}ms`));
+            });
+        }, timeoutMs);
+        child.stderr?.on('data', (chunk) => {
+            if (stderrText.length < STDERR_CAPTURE_LIMIT)
+                stderrText += chunk.toString('utf8');
+        });
+        child.on('error', (err) => finish(() => reject(queueFailed(threadId, command, 'process error', err, stderrText))));
+        // 'close' (not 'exit'): fires after the stdio pipes drained, so stderr is in.
+        child.on('close', (code) => finish(() => {
+            if (code === 0)
+                resolve({ status: 'queued' });
+            else
+                reject(queueFailed(threadId, command, `exited with code ${code}`, undefined, stderrText));
+        }));
+    });
+}
+function queueFailed(threadId, command, reason, cause, stderrText = '') {
+    const excerpt = stderrText === '' ? '' : ` stderr: ${stderrText.replace(/\s+/g, ' ').trim().slice(0, STDERR_EXCERPT_CHARS)}`;
+    return new MultichatError('CODEX_QUEUE_FAILED', `codex queue for thread ${threadId} failed (${command}): ${reason}.${excerpt}`, { cause, stderrText: stderrText === '' ? undefined : stderrText });
+}
+//# sourceMappingURL=queue.js.map

package/dist/codex/queue.js.map

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

package/dist/codex/rollout-meta.js

@@ -0,0 +1,118 @@
+import { closeSync, openSync, readdirSync, readSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import process from 'node:process';
+/** Codex home directory (rollout sessions root lives under `<home>/sessions`). */
+export function codexHomeDir() {
+    return process.env.CODEX_HOME ?? join(homedir(), '.codex');
+}
+/**
+ * Read only the first line of a file. Chunked because a session_meta first
+ * line embeds base instructions and can far exceed one read buffer.
+ */
+function readFirstLine(path) {
+    let fd;
+    try {
+        fd = openSync(path, 'r');
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        const chunks = [];
+        const buf = Buffer.alloc(65536);
+        for (;;) {
+            const n = readSync(fd, buf, 0, buf.length, null);
+            if (n <= 0)
+                break;
+            const newline = buf.subarray(0, n).indexOf(0x0a);
+            if (newline >= 0) {
+                chunks.push(Buffer.from(buf.subarray(0, newline)));
+                return Buffer.concat(chunks).toString('utf8');
+            }
+            // Copy: subarray views the reused read buffer and would be overwritten.
+            chunks.push(Buffer.from(buf.subarray(0, n)));
+        }
+        return Buffer.concat(chunks).toString('utf8');
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/** Extract meta fields with tolerance for missing/malformed payload pieces. */
+function parseMeta(line) {
+    if (!line)
+        return undefined;
+    try {
+        const payload = JSON.parse(line)?.payload;
+        if (typeof payload !== 'object' || payload === null)
+            return undefined;
+        const record = payload;
+        const meta = {
+            cwd: nonEmptyString(record.cwd),
+            originator: nonEmptyString(record.originator),
+            createdAt: nonEmptyString(record.timestamp),
+        };
+        return meta.cwd !== undefined || meta.originator !== undefined || meta.createdAt !== undefined
+            ? meta
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** One recursive walk of the sessions tree; maps each wanted id to its rollout file. */
+function findRolloutFiles(dir, wanted, found = new Map()) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return found;
+    }
+    for (const entry of entries) {
+        if (found.size === wanted.size)
+            break;
+        const path = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            findRolloutFiles(path, wanted, found);
+        }
+        else if (entry.isFile() && entry.name.startsWith('rollout-') && entry.name.endsWith('.jsonl')) {
+            const stem = entry.name.slice(0, -'.jsonl'.length);
+            for (const id of wanted) {
+                if (stem.endsWith(`-${id}`)) {
+                    found.set(id, path);
+                    break;
+                }
+            }
+        }
+    }
+    return found;
+}
+/**
+ * Look up rollout metadata for several thread ids with a single directory
+ * walk (a per-status call must stay well under a couple of seconds).
+ */
+export function lookupRolloutMetas(codexHome, threadIds) {
+    const metas = new Map();
+    const wanted = new Set(threadIds.filter((id) => id.length > 0));
+    if (wanted.size === 0)
+        return metas;
+    for (const [id, path] of findRolloutFiles(join(codexHome, 'sessions'), wanted)) {
+        const meta = parseMeta(readFirstLine(path));
+        if (meta !== undefined)
+            metas.set(id, meta);
+    }
+    return metas;
+}
+/** Single-thread convenience wrapper around {@link lookupRolloutMetas}. */
+export function lookupRolloutMeta(codexHome, threadId) {
+    return lookupRolloutMetas(codexHome, [threadId]).get(threadId);
+}
+//# sourceMappingURL=rollout-meta.js.map

package/dist/codex/rollout-meta.js.map

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

package/dist/codex/rpc.js

@@ -0,0 +1,153 @@
+import { MultichatError } from '../errors.js';
+/**
+ * JSON-RPC client for the codex app-server wire protocol. Wire facts verified
+ * on this machine (docs/research/codex-windows-feasibility.md §1.5): response and
+ * notification frames carry NO `jsonrpc` field (`{id,result}` / `{method,params}`),
+ * so parsing must not require it.
+ */
+/** Whitelist of client methods; anything else is a programming error. */
+const WHITELISTED_METHODS = new Set([
+    'initialize',
+    'thread/list',
+    'thread/resume',
+    'turn/start',
+    'turn/steer',
+    'thread/unsubscribe',
+    // Used only by the isolated live self-test (thread/start creates a fresh
+    // thread owned by crosschat; thread/delete removes it). deliver() and
+    // discovery() never call these on user threads.
+    'thread/start',
+    'thread/delete',
+]);
+/** JSON-RPC error response (the server explicitly rejected the request). */
+export class CodexRpcRejectedError extends MultichatError {
+    rpcCode;
+    constructor(rpcCode, message) {
+        super('CODEX_RPC_REJECTED', message);
+        this.name = 'CodexRpcRejectedError';
+        this.rpcCode = rpcCode;
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export class CodexRpcClient {
+    channel;
+    requestTimeoutMs;
+    nextId = 1;
+    pending = new Map();
+    /** Timed-out request ids: late matching responses are dropped, not faults. */
+    abandoned = new Set();
+    notificationListeners = new Set();
+    closed = false;
+    /** Every notification received, in order (turn/started, item/completed, ...). */
+    notifications = [];
+    /**
+     * Server-initiated requests (approval family etc.), recorded as evidence.
+     * crosschat never answers approvals, so no response is ever sent back.
+     */
+    serverRequests = [];
+    constructor(channel, requestTimeoutMs = 30_000) {
+        this.channel = channel;
+        this.requestTimeoutMs = requestTimeoutMs;
+        channel.onMessage((payload) => this.handlePayload(payload));
+        channel.onClose(() => this.failAll(new MultichatError('CODEX_TRANSPORT_CLOSED', 'codex channel closed.')));
+    }
+    request(method, params) {
+        if (!WHITELISTED_METHODS.has(method)) {
+            throw new MultichatError('CODEX_PROTOCOL_ERROR', `codex rpc method not allowed: ${method}`);
+        }
+        if (this.closed) {
+            throw new MultichatError('CODEX_TRANSPORT_CLOSED', 'codex channel closed.');
+        }
+        const id = this.nextId;
+        this.nextId += 1;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                this.abandoned.add(id);
+                reject(new MultichatError('CODEX_REQUEST_TIMEOUT', `codex request timed out: ${method}`));
+            }, this.requestTimeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            this.channel.send(JSON.stringify({ id, method, params }));
+        });
+    }
+    notify(method, params) {
+        this.channel.send(JSON.stringify({ method, params }));
+    }
+    onNotification(listener) {
+        this.notificationListeners.add(listener);
+        return () => this.notificationListeners.delete(listener);
+    }
+    dispose() {
+        this.closed = true;
+        this.failAll(new MultichatError('CODEX_TRANSPORT_CLOSED', 'codex rpc client disposed.'));
+    }
+    handlePayload(payload) {
+        let parsed;
+        try {
+            parsed = JSON.parse(payload);
+        }
+        catch {
+            this.protocolFailure();
+            return;
+        }
+        if (!isRecord(parsed)) {
+            this.protocolFailure();
+            return;
+        }
+        if (typeof parsed.method === 'string') {
+            const frame = { method: parsed.method, params: parsed.params };
+            if (parsed.id !== undefined) {
+                this.serverRequests.push(frame);
+            }
+            else {
+                this.notifications.push(frame);
+                for (const listener of [...this.notificationListeners])
+                    listener(frame);
+            }
+            return;
+        }
+        if (typeof parsed.id !== 'number' || !Number.isSafeInteger(parsed.id)) {
+            this.protocolFailure();
+            return;
+        }
+        const pending = this.pending.get(parsed.id);
+        if (pending === undefined) {
+            // Responses to requests we already timed out arrive late; drop them.
+            if (!this.abandoned.has(parsed.id))
+                this.protocolFailure();
+            return;
+        }
+        const hasResult = Object.hasOwn(parsed, 'result');
+        const hasError = Object.hasOwn(parsed, 'error');
+        if (hasResult === hasError) {
+            this.protocolFailure();
+            return;
+        }
+        this.pending.delete(parsed.id);
+        clearTimeout(pending.timer);
+        if (hasError) {
+            const err = parsed.error;
+            const rpcCode = isRecord(err) && typeof err.code === 'number' ? err.code : 0;
+            const message = isRecord(err) && typeof err.message === 'string' ? err.message : 'codex rpc error';
+            pending.reject(new CodexRpcRejectedError(rpcCode, message));
+            return;
+        }
+        pending.resolve(parsed.result);
+    }
+    protocolFailure() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.failAll(new MultichatError('CODEX_PROTOCOL_ERROR', 'malformed codex rpc frame.'));
+    }
+    failAll(error) {
+        for (const pending of this.pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/codex/rpc.js.map

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