@dhrxv29/autocodex 0.1.0

package/dist/machine.js

@@ -0,0 +1,277 @@
+import { DEFAULT_CONTINUATION_PROMPT } from "./defaults.js";
+import { AutocodexError, MissingResetTimestampError, SameSessionRequiredError, } from "./types.js";
+const TERMINAL = new Set(["completed", "cancelled", "failed"]);
+function cloneState(state) {
+    return {
+        daemon: { ...state.daemon },
+        sessions: new Map([...state.sessions.entries()].map(([id, session]) => [id, { ...session }])),
+    };
+}
+function requireSessionId(sessionId) {
+    const id = sessionId.trim();
+    if (!id) {
+        throw new AutocodexError("sessionId is required");
+    }
+    return id;
+}
+function upsert(sessions, sessionId, nowUnix, patch) {
+    const existing = sessions.get(sessionId);
+    const next = existing
+        ? { ...existing, ...patch, sessionId, updatedAtUnix: nowUnix }
+        : {
+            sessionId,
+            cwd: null,
+            phase: "idle",
+            resetAtUnix: null,
+            limitKind: null,
+            continuationPrompt: DEFAULT_CONTINUATION_PROMPT,
+            continuationSent: false,
+            resumeAttemptId: null,
+            lastError: null,
+            createdAtUnix: nowUnix,
+            updatedAtUnix: nowUnix,
+            ...patch,
+        };
+    sessions.set(sessionId, next);
+    return next;
+}
+export function emptyState(nowUnix) {
+    return {
+        daemon: { enabled: false, updatedAtUnix: nowUnix },
+        sessions: new Map(),
+    };
+}
+/**
+ * Pure state machine. Clock and I/O stay outside so tests can use FakeClock
+ * and a recording provider.
+ */
+export function applyEvent(state, event, nowUnix) {
+    const next = cloneState(state);
+    const logs = [];
+    switch (event.type) {
+        case "enable":
+            next.daemon = { enabled: true, updatedAtUnix: nowUnix };
+            logs.push({ sessionId: null, kind: "enable", message: "autocodex enabled" });
+            break;
+        case "disable":
+            next.daemon = { enabled: false, updatedAtUnix: nowUnix };
+            logs.push({ sessionId: null, kind: "disable", message: "autocodex disabled" });
+            break;
+        case "watch": {
+            const sessionId = requireSessionId(event.sessionId);
+            const current = next.sessions.get(sessionId);
+            if (current && !TERMINAL.has(current.phase) && current.phase !== "idle") {
+                logs.push({
+                    sessionId,
+                    kind: "watch",
+                    message: `already ${current.phase}`,
+                });
+                break;
+            }
+            upsert(next.sessions, sessionId, nowUnix, {
+                phase: "watching",
+                cwd: event.cwd ?? current?.cwd ?? null,
+                lastError: null,
+            });
+            logs.push({ sessionId, kind: "watch", message: "watching session" });
+            break;
+        }
+        case "limitHit": {
+            const sessionId = requireSessionId(event.sessionId);
+            if (!Number.isFinite(event.resetAtUnix)) {
+                throw new MissingResetTimestampError(sessionId);
+            }
+            const current = next.sessions.get(sessionId);
+            if (current &&
+                current.resetAtUnix === event.resetAtUnix &&
+                (current.phase === "waiting" ||
+                    current.phase === "available" ||
+                    current.phase === "resuming" ||
+                    current.phase === "continuing" ||
+                    (current.phase === "completed" && current.continuationSent))) {
+                logs.push({
+                    sessionId,
+                    kind: "limitHit",
+                    message: `idempotent limitHit for reset ${event.resetAtUnix}`,
+                });
+                break;
+            }
+            if (current && (current.phase === "resuming" || current.phase === "continuing")) {
+                logs.push({
+                    sessionId,
+                    kind: "limitHit",
+                    message: `ignored limitHit while ${current.phase}`,
+                });
+                break;
+            }
+            if (current &&
+                current.resetAtUnix !== null &&
+                nowUnix >= current.resetAtUnix &&
+                event.resetAtUnix !== current.resetAtUnix &&
+                (current.phase === "waiting" || current.phase === "available")) {
+                logs.push({
+                    sessionId,
+                    kind: "limitHit",
+                    message: `ignored new reset ${event.resetAtUnix}; finishing elapsed wait ${current.resetAtUnix}`,
+                });
+                break;
+            }
+            upsert(next.sessions, sessionId, nowUnix, {
+                phase: "waiting",
+                resetAtUnix: event.resetAtUnix,
+                limitKind: event.limitKind,
+                continuationSent: false,
+                resumeAttemptId: null,
+                lastError: null,
+                continuationPrompt: current?.continuationPrompt ?? DEFAULT_CONTINUATION_PROMPT,
+                cwd: current?.cwd ?? null,
+            });
+            logs.push({
+                sessionId,
+                kind: "limitHit",
+                message: `waiting until ${event.resetAtUnix}`,
+            });
+            break;
+        }
+        case "tick": {
+            for (const session of next.sessions.values()) {
+                if (session.phase === "waiting" &&
+                    session.resetAtUnix !== null &&
+                    nowUnix >= session.resetAtUnix) {
+                    session.phase = "available";
+                    session.updatedAtUnix = nowUnix;
+                    logs.push({
+                        sessionId: session.sessionId,
+                        kind: "available",
+                        message: "reset timestamp reached",
+                    });
+                }
+            }
+            break;
+        }
+        case "resumeStarted": {
+            const sessionId = requireSessionId(event.sessionId);
+            const current = next.sessions.get(sessionId);
+            if (!current || (current.phase !== "available" && current.phase !== "resuming")) {
+                throw new AutocodexError(`cannot resume session ${sessionId} unless it is available`);
+            }
+            upsert(next.sessions, sessionId, nowUnix, {
+                phase: "resuming",
+                resumeAttemptId: current.resumeAttemptId ?? event.resumeAttemptId,
+                lastError: null,
+            });
+            logs.push({
+                sessionId,
+                kind: "resumeStarted",
+                message: current.phase === "resuming" ? "retry resume same session id" : "resuming same session id",
+            });
+            break;
+        }
+        case "resumeSucceeded": {
+            const sessionId = requireSessionId(event.sessionId);
+            const current = next.sessions.get(sessionId);
+            if (!current || current.phase !== "resuming") {
+                throw new AutocodexError(`resumeSucceeded expected resuming, got ${current?.phase ?? "missing"}`);
+            }
+            if (event.resumedSessionId !== sessionId) {
+                const mismatch = new SameSessionRequiredError(sessionId, event.resumedSessionId);
+                upsert(next.sessions, sessionId, nowUnix, {
+                    phase: "failed",
+                    lastError: mismatch.message,
+                });
+                logs.push({ sessionId, kind: "fail", message: mismatch.message });
+                break;
+            }
+            upsert(next.sessions, sessionId, nowUnix, {
+                phase: "continuing",
+                lastError: null,
+            });
+            logs.push({ sessionId, kind: "resumeSucceeded", message: "resumed same session" });
+            break;
+        }
+        case "resumeRetry": {
+            const sessionId = requireSessionId(event.sessionId);
+            const current = next.sessions.get(sessionId);
+            if (!current || (current.phase !== "resuming" && current.phase !== "available")) {
+                throw new AutocodexError(`resumeRetry expected available or resuming, got ${current?.phase ?? "missing"}`);
+            }
+            upsert(next.sessions, sessionId, nowUnix, {
+                phase: "resuming",
+                lastError: event.error,
+            });
+            logs.push({
+                sessionId,
+                kind: "resumeRetry",
+                message: `${event.error} Same thread.id will be retried on the next step or daemon tick. Autocodex will not fork or use resume --last.`,
+            });
+            break;
+        }
+        case "continueSucceeded": {
+            const sessionId = requireSessionId(event.sessionId);
+            const current = next.sessions.get(sessionId);
+            if (current?.continuationSent && current.phase === "completed") {
+                logs.push({
+                    sessionId,
+                    kind: "continueSucceeded",
+                    message: "already continued once for this reset",
+                });
+                break;
+            }
+            if (!current || current.phase !== "continuing") {
+                throw new AutocodexError(`continueSucceeded expected continuing, got ${current?.phase ?? "missing"}`);
+            }
+            upsert(next.sessions, sessionId, nowUnix, {
+                phase: "completed",
+                continuationSent: true,
+                lastError: null,
+            });
+            logs.push({
+                sessionId,
+                kind: "continueSucceeded",
+                message: "continuation prompt sent once",
+            });
+            break;
+        }
+        case "cancel": {
+            const targets = event.sessionId
+                ? [requireSessionId(event.sessionId)]
+                : [...next.sessions.keys()];
+            for (const sessionId of targets) {
+                const current = next.sessions.get(sessionId);
+                if (!current) {
+                    throw new AutocodexError(`unknown session ${sessionId}`);
+                }
+                if (current.phase === "completed") {
+                    continue;
+                }
+                upsert(next.sessions, sessionId, nowUnix, {
+                    phase: "cancelled",
+                    lastError: null,
+                });
+                logs.push({ sessionId, kind: "cancel", message: "cancelled" });
+            }
+            break;
+        }
+        case "fail": {
+            const sessionId = requireSessionId(event.sessionId);
+            upsert(next.sessions, sessionId, nowUnix, {
+                phase: "failed",
+                lastError: event.error,
+            });
+            logs.push({ sessionId, kind: "fail", message: event.error });
+            break;
+        }
+        default: {
+            const _exhaustive = event;
+            throw new AutocodexError(`unknown event ${JSON.stringify(_exhaustive)}`);
+        }
+    }
+    return { state: next, logs };
+}
+export function sessionsNeedingResume(state) {
+    return [...state.sessions.values()].filter((session) => session.phase === "available" || session.phase === "resuming");
+}
+export function sessionsNeedingContinue(state) {
+    return [...state.sessions.values()].filter((session) => session.phase === "continuing" && !session.continuationSent);
+}
+//# sourceMappingURL=machine.js.map

package/dist/machine.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,20 @@
+export declare function defaultDataDir(): string;
+export declare function sqlitePath(dataDir: string): string;
+export declare function launchAgentsDir(homeDir?: string): string;
+export declare function launchAgentPlistPath(homeDir?: string): string;
+export declare function daemonLogPaths(dataDir: string): {
+    stdout: string;
+    stderr: string;
+};
+/**
+ * Absolute path written into the launchd plist.
+ * Prefer compiled `dist/cli.js` when the current process is `tsx src/cli.ts`.
+ */
+export declare function resolveAutocodexCliPath(entry?: string): string;
+export declare function runtimeDir(dataDir: string): string;
+export declare function runtimeCliPath(dataDir: string): string;
+/**
+ * Copy the compiled CLI next to SQLite so launchd keeps a stable path
+ * after `npx` cache eviction.
+ */
+export declare function materializeRuntimeCli(dataDir: string, sourceCliPath: string): string;

package/dist/paths.js

@@ -0,0 +1,58 @@
+import { cpSync, existsSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { DAEMON_STDERR_LOG, DAEMON_STDOUT_LOG, DEFAULT_DATA_DIR_NAME, LAUNCHD_LABEL, SQLITE_FILENAME, } from "./defaults.js";
+export function defaultDataDir() {
+    return process.env.AUTOCODEX_DATA_DIR?.trim() || join(homedir(), DEFAULT_DATA_DIR_NAME);
+}
+export function sqlitePath(dataDir) {
+    return join(dataDir, SQLITE_FILENAME);
+}
+export function launchAgentsDir(homeDir = homedir()) {
+    return join(homeDir, "Library", "LaunchAgents");
+}
+export function launchAgentPlistPath(homeDir = homedir()) {
+    return join(launchAgentsDir(homeDir), `${LAUNCHD_LABEL}.plist`);
+}
+export function daemonLogPaths(dataDir) {
+    return {
+        stdout: join(dataDir, DAEMON_STDOUT_LOG),
+        stderr: join(dataDir, DAEMON_STDERR_LOG),
+    };
+}
+/**
+ * Absolute path written into the launchd plist.
+ * Prefer compiled `dist/cli.js` when the current process is `tsx src/cli.ts`.
+ */
+export function resolveAutocodexCliPath(entry = process.argv[1]) {
+    const resolved = entry ? resolve(entry) : resolve(process.cwd(), "dist", "cli.js");
+    if (resolved.endsWith(`${join("src", "cli.ts")}`) || resolved.endsWith("/src/cli.ts")) {
+        const compiled = resolve(dirname(resolved), "..", "dist", "cli.js");
+        if (existsSync(compiled)) {
+            return compiled;
+        }
+    }
+    return resolved;
+}
+export function runtimeDir(dataDir) {
+    return join(dataDir, "runtime");
+}
+export function runtimeCliPath(dataDir) {
+    return join(runtimeDir(dataDir), "cli.js");
+}
+/**
+ * Copy the compiled CLI next to SQLite so launchd keeps a stable path
+ * after `npx` cache eviction.
+ */
+export function materializeRuntimeCli(dataDir, sourceCliPath) {
+    if (!existsSync(sourceCliPath)) {
+        return sourceCliPath;
+    }
+    const destDir = runtimeDir(dataDir);
+    mkdirSync(destDir, { recursive: true });
+    const sourceDir = dirname(sourceCliPath);
+    cpSync(sourceDir, destDir, { recursive: true });
+    const destCli = join(destDir, basename(sourceCliPath) === "cli.ts" ? "cli.js" : basename(sourceCliPath));
+    return existsSync(destCli) ? destCli : sourceCliPath;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

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

package/dist/provider.d.ts

@@ -0,0 +1,20 @@
+import type { LimitKind } from "./types.js";
+export interface UsageLimitEvent {
+    sessionId: string;
+    resetAtUnix: number;
+    kind: LimitKind;
+    source: "app_server_turn" | "account_rate_limits" | "usage_limit_error";
+}
+export interface ResumeResult {
+    sessionId: string;
+}
+/** Codex-only adapter. No other providers in MVP. */
+export interface AgentProvider {
+    readonly name: "codex";
+    detectUsageLimit(event: unknown, hintSessionId?: string): UsageLimitEvent | null;
+    resumeSession(sessionId: string): Promise<ResumeResult>;
+    sendContinuation(sessionId: string, prompt: string): Promise<void>;
+    /** Live snapshot from `account/rateLimits/read`. Recording/fake providers omit this. */
+    readAccountRateLimits?(): Promise<unknown>;
+    close?(): void | Promise<void>;
+}

package/dist/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/providers/app-server.d.ts

@@ -0,0 +1,102 @@
+import { type ChildProcessWithoutNullStreams } from "node:child_process";
+import { AutocodexError } from "../types.js";
+/** Methods autocodex must never send. */
+export declare const FORBIDDEN_APP_SERVER_METHODS: readonly ["thread/fork", "thread/start", "account/rateLimitResetCredit/consume", "account/login/start", "account/logout"];
+export type ForbiddenAppServerMethod = (typeof FORBIDDEN_APP_SERVER_METHODS)[number];
+/**
+ * In-thread approval RPCs Codex may send during `turn/start`.
+ * Autocodex is unattended: it answers `accept` so the continuation can finish.
+ * It does **not** send `approvalPolicy` / `sandboxPolicy` on resume or turn/start —
+ * those stay the thread's Codex-owned settings (omit = reuse). Not a policy engine.
+ */
+export declare const APPROVAL_METHODS: Set<string>;
+/** Official decision payload for the three requestApproval methods above. */
+export declare const UNATTENDED_APPROVAL_DECISION: "accept";
+export interface JsonRpcTransport {
+    send(message: unknown): void;
+    onMessage(handler: (message: unknown) => void): () => void;
+    onClose?(handler: (error?: Error) => void): () => void;
+    close(): void;
+}
+export interface SpawnAppServerOptions {
+    command: string;
+    args?: string[];
+    env?: NodeJS.ProcessEnv;
+}
+export declare function resolveCodexCommand(): string;
+export declare function defaultAppServerSpawn(): SpawnAppServerOptions;
+export declare class AppServerError extends AutocodexError {
+    readonly code: number;
+    constructor(code: number, message: string);
+}
+export declare class ForbiddenAppServerMethodError extends AutocodexError {
+    constructor(method: string);
+}
+/**
+ * In-memory bidirectional JSON-RPC transport for tests.
+ * Writes are delivered on a microtask so request handlers can register waiters.
+ */
+export declare function linkMemoryTransports(): {
+    client: JsonRpcTransport;
+    server: JsonRpcTransport;
+};
+/** Spawn `codex app-server` (stdio JSONL). Does not read $CODEX_HOME auth files. */
+export declare class StdioAppServerTransport implements JsonRpcTransport {
+    private readonly child;
+    private readonly handlers;
+    private readonly closeHandlers;
+    private closed;
+    private spawnError;
+    constructor(child: ChildProcessWithoutNullStreams, command: string);
+    static spawn(options?: SpawnAppServerOptions): StdioAppServerTransport;
+    send(message: unknown): void;
+    onMessage(handler: (message: unknown) => void): () => void;
+    onClose(handler: (error?: Error) => void): () => void;
+    close(): void;
+    private fail;
+}
+export interface AppServerClientInfo {
+    name: string;
+    title?: string;
+    version: string;
+}
+export interface ThreadResumeResult {
+    threadId: string;
+    ephemeral: boolean;
+}
+export interface CodexAppServerClientOptions {
+    clientInfo?: AppServerClientInfo;
+}
+/**
+ * Official `codex app-server` JSON-RPC client.
+ * Wire format is JSONL without a `"jsonrpc":"2.0"` envelope field.
+ */
+export declare class CodexAppServerClient {
+    private readonly transport;
+    private readonly clientInfo;
+    private readonly pending;
+    private readonly turnWaiters;
+    private readonly completedTurns;
+    private readonly loadedThreads;
+    private nextId;
+    private initialized;
+    private closed;
+    private readonly unsubscribe;
+    private readonly unsubscribeClose;
+    constructor(transport: JsonRpcTransport, options?: CodexAppServerClientOptions);
+    get isInitialized(): boolean;
+    isThreadLoaded(threadId: string): boolean;
+    handshake(): Promise<unknown>;
+    threadResume(threadId: string): Promise<ThreadResumeResult>;
+    turnStart(threadId: string, prompt: string): Promise<void>;
+    rateLimitsRead(): Promise<unknown>;
+    request(method: string, params?: unknown): Promise<unknown>;
+    close(): void;
+    private failOpen;
+    private notify;
+    private assertOpen;
+    private expectTurnCompletion;
+    private dispatch;
+    private dispatchNotification;
+    private respondToServerRequest;
+}