codex-task 0.2.0

package/dist/config.js

@@ -0,0 +1,77 @@
+import { existsSync, readFileSync } from "node:fs";
+import { appPaths, defaultCodexHome, legacyAppPaths } from "./paths.js";
+import { CodexTaskError } from "./errors.js";
+const DEFAULT_CONFIG = {
+    codexHome: defaultCodexHome(),
+    directReasoning: "medium",
+    directTextTimeoutMs: 10 * 60 * 1000,
+    directImageTimeoutMs: 15 * 60 * 1000,
+    sdkTimeoutMs: 30 * 60 * 1000,
+    retries: 3,
+    tempTtlMs: 24 * 60 * 60 * 1000,
+    pendingTaskTtlMs: 7 * 24 * 60 * 60 * 1000,
+    tempMaxBytes: 1024 * 1024 * 1024,
+};
+function readUserConfig() {
+    const path = [appPaths().configPath, legacyAppPaths().configPath].find((candidate) => existsSync(candidate));
+    if (!path)
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw new CodexTaskError("INVALID_CONFIG", `Could not parse ${path}`, {
+            exitCode: 2,
+            cause: error,
+        });
+    }
+}
+function envValue(name, legacyName) {
+    return process.env[name] ?? process.env[legacyName];
+}
+function envNumber(name, legacyName) {
+    const raw = envValue(name, legacyName);
+    if (raw === undefined || raw === "")
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isFinite(value) || value < 0) {
+        throw new CodexTaskError("INVALID_CONFIG", `${name} must be a non-negative number`, {
+            exitCode: 2,
+        });
+    }
+    return value;
+}
+export function loadConfig(overrides = {}) {
+    const user = readUserConfig();
+    const env = {
+        codexHome: envValue("CODEX_TASK_CODEX_HOME", "CODEXERRAND_CODEX_HOME"),
+        directModel: envValue("CODEX_TASK_MODEL", "CODEXERRAND_MODEL"),
+        directReasoning: envValue("CODEX_TASK_REASONING", "CODEXERRAND_REASONING"),
+        directTextTimeoutMs: envNumber("CODEX_TASK_TEXT_TIMEOUT_MS", "CODEXERRAND_TEXT_TIMEOUT_MS"),
+        directImageTimeoutMs: envNumber("CODEX_TASK_IMAGE_TIMEOUT_MS", "CODEXERRAND_IMAGE_TIMEOUT_MS"),
+        sdkTimeoutMs: envNumber("CODEX_TASK_SDK_TIMEOUT_MS", "CODEXERRAND_SDK_TIMEOUT_MS"),
+        retries: envNumber("CODEX_TASK_RETRIES", "CODEXERRAND_RETRIES"),
+        proxy: envValue("CODEX_TASK_PROXY", "CODEXERRAND_PROXY"),
+        tempTtlMs: envNumber("CODEX_TASK_TEMP_TTL_MS", "CODEXERRAND_TEMP_TTL_MS"),
+        pendingTaskTtlMs: envNumber("CODEX_TASK_PENDING_TTL_MS", "CODEXERRAND_PENDING_TTL_MS"),
+        tempMaxBytes: envNumber("CODEX_TASK_TEMP_MAX_BYTES", "CODEXERRAND_TEMP_MAX_BYTES"),
+    };
+    const merged = { ...DEFAULT_CONFIG, ...user, ...stripUndefined(env), ...stripUndefined(overrides) };
+    return {
+        codexHome: merged.codexHome ?? DEFAULT_CONFIG.codexHome,
+        directModel: merged.directModel,
+        directReasoning: merged.directReasoning ?? DEFAULT_CONFIG.directReasoning,
+        directTextTimeoutMs: merged.directTextTimeoutMs ?? DEFAULT_CONFIG.directTextTimeoutMs,
+        directImageTimeoutMs: merged.directImageTimeoutMs ?? DEFAULT_CONFIG.directImageTimeoutMs,
+        sdkTimeoutMs: merged.sdkTimeoutMs ?? DEFAULT_CONFIG.sdkTimeoutMs,
+        retries: merged.retries ?? DEFAULT_CONFIG.retries,
+        proxy: merged.proxy,
+        tempTtlMs: merged.tempTtlMs ?? DEFAULT_CONFIG.tempTtlMs,
+        pendingTaskTtlMs: merged.pendingTaskTtlMs ?? DEFAULT_CONFIG.pendingTaskTtlMs,
+        tempMaxBytes: merged.tempMaxBytes ?? DEFAULT_CONFIG.tempMaxBytes,
+    };
+}
+function stripUndefined(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { DoctorReport } from "./types.js";
+export declare function runDoctor(codexHome?: string): DoctorReport;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAsB5D,wBAAgB,SAAS,CAAC,SAAS,SAAqB,GAAG,YAAY,CAqEtE"}

package/dist/doctor.js

@@ -0,0 +1,94 @@
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { appPaths, defaultCodexHome } from "./paths.js";
+import { directTransportAvailable } from "./backends/direct/http.js";
+import { inspectDirectAuth } from "./backends/direct/auth.js";
+import { resolveDirectImageModel, resolveDirectModel } from "./backends/direct/models.js";
+function codexVersion() {
+    try {
+        return execFileSync("codex", ["--version"], { timeout: 3000, encoding: "utf8" }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+function sdkVersion() {
+    try {
+        const entry = fileURLToPath(import.meta.resolve("@openai/codex-sdk"));
+        const packageJson = JSON.parse(readFileSync(join(dirname(dirname(entry)), "package.json"), "utf8"));
+        return packageJson.version;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function runDoctor(codexHome = defaultCodexHome()) {
+    const paths = appPaths();
+    const checks = [];
+    const transport = directTransportAvailable();
+    checks.push({
+        name: "direct-transport",
+        status: transport ? "ok" : "warning",
+        message: transport
+            ? "Native Direct transport is available"
+            : "Native Direct transport is unavailable; SDK backend can still be used",
+    });
+    const auth = inspectDirectAuth(codexHome);
+    checks.push({
+        name: "codex-oauth",
+        status: auth.found && auth.valid ? "ok" : auth.found ? "warning" : "error",
+        message: auth.message,
+        details: auth.expiresAt ? { expiresAt: new Date(auth.expiresAt).toISOString() } : undefined,
+    });
+    try {
+        const model = resolveDirectModel(codexHome, undefined, "medium");
+        const imageModel = resolveDirectImageModel(codexHome, undefined, "medium");
+        checks.push({
+            name: "direct-model",
+            status: "ok",
+            message: `${model.model} via ${model.useResponsesLite ? "Responses Lite" : "classic Responses"}`,
+            details: {
+                source: model.source,
+                reasoning: model.reasoning,
+                imageModel: imageModel.model.model,
+                imageFallbackFrom: imageModel.replacedLiteModel,
+            },
+        });
+    }
+    catch (error) {
+        checks.push({
+            name: "direct-model",
+            status: "error",
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+    const cliVersion = codexVersion();
+    checks.push({
+        name: "codex-cli",
+        status: cliVersion ? "ok" : "warning",
+        message: cliVersion ?? "codex executable is not on PATH; the bundled SDK binary may still work",
+    });
+    const version = sdkVersion();
+    checks.push({
+        name: "codex-sdk",
+        status: version ? "ok" : "error",
+        message: version ? `@openai/codex-sdk ${version}` : "@openai/codex-sdk is unavailable",
+    });
+    return {
+        ok: checks.every((check) => check.status !== "error"),
+        platform: `${process.platform}/${process.arch}`,
+        nodeVersion: process.version,
+        checks,
+        paths: {
+            codexHome,
+            config: paths.configPath,
+            state: paths.stateDir,
+            cache: paths.cacheDir,
+            temp: paths.tempDir,
+            tasks: paths.tasksDir,
+        },
+    };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class CodexTaskError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly exitCode: number;
+    readonly details?: unknown;
+    constructor(code: string, message: string, options?: {
+        retryable?: boolean;
+        exitCode?: number;
+        details?: unknown;
+        cause?: unknown;
+    });
+}
+export declare function usageError(message: string, details?: unknown): CodexTaskError;
+export declare function asCodexTaskError(error: unknown): CodexTaskError;
+export declare function isAbortError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAGzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAS/F;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,cAAc,CAE7E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAM/D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+export class CodexTaskError extends Error {
+    code;
+    retryable;
+    exitCode;
+    details;
+    constructor(code, message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = "CodexTaskError";
+        this.code = code;
+        this.retryable = options.retryable ?? false;
+        this.exitCode = options.exitCode ?? 1;
+        this.details = options.details;
+    }
+}
+export function usageError(message, details) {
+    return new CodexTaskError("USAGE_ERROR", message, { exitCode: 2, details });
+}
+export function asCodexTaskError(error) {
+    if (error instanceof CodexTaskError)
+        return error;
+    if (error instanceof Error) {
+        return new CodexTaskError("UNEXPECTED_ERROR", error.message, { cause: error });
+    }
+    return new CodexTaskError("UNEXPECTED_ERROR", String(error));
+}
+export function isAbortError(error) {
+    return ((error instanceof Error && error.name === "AbortError") ||
+        (error instanceof CodexTaskError && (error.code === "CANCELLED" || error.code === "TIMEOUT")));
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAS;IACb,SAAS,CAAU;IACnB,QAAQ,CAAS;IACjB,OAAO,CAAW;IAE3B,YACE,IAAY,EACZ,OAAe,EACf,UAA0F,EAAE;QAE5F,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,OAAiB;IAC3D,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,YAAY,cAAc;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,cAAc,CAAC,kBAAkB,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,cAAc,CAAC,kBAAkB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CACL,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;QACvD,CAAC,KAAK,YAAY,cAAc,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAC9F,CAAC;AACJ,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,10 @@
+import type { TaskEvent } from "./types.js";
+export declare class EventQueue implements AsyncIterable<TaskEvent> {
+    private readonly values;
+    private readonly waiters;
+    private done;
+    push(event: TaskEvent): void;
+    close(): void;
+    [Symbol.asyncIterator](): AsyncIterator<TaskEvent>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,UAAW,YAAW,aAAa,CAAC,SAAS,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0D;IAClF,OAAO,CAAC,IAAI,CAAS;IAErB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAM5B,KAAK,IAAI,IAAI;IAKb,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC;CAUnD"}

package/dist/events.js

@@ -0,0 +1,30 @@
+export class EventQueue {
+    values = [];
+    waiters = [];
+    done = false;
+    push(event) {
+        const waiter = this.waiters.shift();
+        if (waiter)
+            waiter({ value: event, done: false });
+        else
+            this.values.push(event);
+    }
+    close() {
+        this.done = true;
+        for (const waiter of this.waiters.splice(0))
+            waiter({ value: undefined, done: true });
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: async () => {
+                const value = this.values.shift();
+                if (value)
+                    return { value, done: false };
+                if (this.done)
+                    return { value: undefined, done: true };
+                return new Promise((resolve) => this.waiters.push(resolve));
+            },
+        };
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAU;IACJ,MAAM,GAAgB,EAAE,CAAC;IACzB,OAAO,GAAuD,EAAE,CAAC;IAC1E,IAAI,GAAG,KAAK,CAAC;IAErB,IAAI,CAAC,KAAgB;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,MAAM;YAAE,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;;YAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClC,IAAI,KAAK;oBAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;gBACzC,IAAI,IAAI,CAAC,IAAI;oBAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBACvD,OAAO,IAAI,OAAO,CAA4B,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACzF,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/fs-utils.d.ts

@@ -0,0 +1,7 @@
+export declare function ensureDir(path: string): void;
+export declare function atomicWrite(path: string, data: string | Buffer, mode?: number): void;
+export declare function withFileLock<T>(lockPath: string, action: () => Promise<T>, options?: {
+    timeoutMs?: number;
+    staleMs?: number;
+}): Promise<T>;
+//# sourceMappingURL=fs-utils.d.ts.map

package/dist/fs-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,SAAQ,GAAG,IAAI,CAKnF;AAED,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACrD,OAAO,CAAC,CAAC,CAAC,CAqCZ"}

package/dist/fs-utils.js

@@ -0,0 +1,56 @@
+import { mkdirSync, openSync, closeSync, unlinkSync, writeFileSync, renameSync, statSync } from "node:fs";
+import { dirname } from "node:path";
+import { randomUUID } from "node:crypto";
+import { CodexTaskError } from "./errors.js";
+export function ensureDir(path) {
+    mkdirSync(path, { recursive: true, mode: 0o700 });
+}
+export function atomicWrite(path, data, mode = 0o600) {
+    ensureDir(dirname(path));
+    const tempPath = `${path}.${process.pid}.${randomUUID()}.tmp`;
+    writeFileSync(tempPath, data, { mode });
+    renameSync(tempPath, path);
+}
+export async function withFileLock(lockPath, action, options = {}) {
+    ensureDir(dirname(lockPath));
+    const timeoutMs = options.timeoutMs ?? 10_000;
+    const staleMs = options.staleMs ?? 30_000;
+    const startedAt = Date.now();
+    let descriptor;
+    while (descriptor === undefined) {
+        try {
+            descriptor = openSync(lockPath, "wx", 0o600);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== "EEXIST")
+                throw error;
+            try {
+                if (Date.now() - statSync(lockPath).mtimeMs > staleMs)
+                    unlinkSync(lockPath);
+            }
+            catch {
+                // Another process may have released it.
+            }
+            if (Date.now() - startedAt > timeoutMs) {
+                throw new CodexTaskError("LOCK_TIMEOUT", `Timed out waiting for ${lockPath}`, {
+                    retryable: true,
+                });
+            }
+            await new Promise((resolve) => setTimeout(resolve, 75));
+        }
+    }
+    try {
+        return await action();
+    }
+    finally {
+        closeSync(descriptor);
+        try {
+            unlinkSync(lockPath);
+        }
+        catch {
+            // Best effort.
+        }
+    }
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1G,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAqB,EAAE,IAAI,GAAG,KAAK;IAC3E,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CAAC;IAC9D,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,MAAwB,EACxB,UAAoD,EAAE;IAEtD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,UAA8B,CAAC;IAEnC,OAAO,UAAU,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;YACnD,IAAI,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACnC,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,GAAG,OAAO;oBAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC9E,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;gBACvC,MAAM,IAAI,cAAc,CAAC,cAAc,EAAE,yBAAyB,QAAQ,EAAE,EAAE;oBAC5E,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,UAAU,CAAC,CAAC;QACtB,IAAI,CAAC;YACH,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/images.d.ts

@@ -0,0 +1,18 @@
+import type { Artifact, ImageOptions } from "./types.js";
+export interface ValidatedImageOptions {
+    count: number;
+    concurrency: number;
+    size: string;
+    quality: "auto" | "low" | "medium" | "high";
+    background: "auto" | "opaque" | "transparent";
+    imagePaths: string[];
+    overwrite: boolean;
+}
+export declare function validateImageOptions(options: ImageOptions): ValidatedImageOptions;
+export declare function imageMimeType(path: string): string;
+export declare function outputPathForImage(taskId: string, output: string | undefined, index: number, count: number): {
+    path: string;
+    temporary: boolean;
+};
+export declare function writePngArtifact(taskId: string, buffer: Buffer, output: string | undefined, index: number, count: number, overwrite: boolean): Artifact;
+//# sourceMappingURL=images.d.ts.map

package/dist/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAazD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC9C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB,CAiDjF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CActC;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,GACjB,QAAQ,CAcV"}

package/dist/images.js

@@ -0,0 +1,102 @@
+import { existsSync, statSync } from "node:fs";
+import { basename, dirname, extname, join, resolve } from "node:path";
+import { appPaths } from "./paths.js";
+import { atomicWrite, ensureDir } from "./fs-utils.js";
+import { usageError } from "./errors.js";
+const MIME_BY_EXTENSION = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+};
+const MAX_IMAGE_BYTES = 20 * 1024 * 1024;
+const MAX_TOTAL_IMAGE_BYTES = 50 * 1024 * 1024;
+export function validateImageOptions(options) {
+    const count = options.count ?? 1;
+    const concurrency = options.concurrency ?? 1;
+    const size = options.size ?? "auto";
+    const quality = options.quality ?? "auto";
+    const background = options.background ?? "auto";
+    const imagePaths = options.imagePaths ?? [];
+    if (!Number.isInteger(count) || count < 1 || count > 10) {
+        throw usageError("count must be an integer from 1 to 10");
+    }
+    if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > 3) {
+        throw usageError("concurrency must be an integer from 1 to 3");
+    }
+    if (imagePaths.length > 5)
+        throw usageError("at most 5 reference images are supported");
+    if (!/^(auto|[1-9]\d{0,3}x[1-9]\d{0,3})$/.test(size)) {
+        throw usageError("size must be auto or WIDTHxHEIGHT");
+    }
+    if (size !== "auto") {
+        const [width, height] = size.split("x").map(Number);
+        if (!width || !height || Math.max(width, height) > 3840) {
+            throw usageError("image width and height must be at most 3840");
+        }
+    }
+    let totalBytes = 0;
+    for (const path of imagePaths) {
+        if (!existsSync(path))
+            throw usageError(`reference image does not exist: ${path}`);
+        const extension = extname(path).toLowerCase();
+        if (!MIME_BY_EXTENSION[extension]) {
+            throw usageError(`unsupported image type for ${path}; use png, jpg, jpeg, webp, or gif`);
+        }
+        const bytes = statSync(path).size;
+        if (bytes > MAX_IMAGE_BYTES)
+            throw usageError(`reference image exceeds 20 MiB: ${path}`);
+        totalBytes += bytes;
+    }
+    if (totalBytes > MAX_TOTAL_IMAGE_BYTES) {
+        throw usageError("reference images exceed the 50 MiB total limit");
+    }
+    return {
+        count,
+        concurrency,
+        size,
+        quality,
+        background,
+        imagePaths: imagePaths.map((path) => resolve(path)),
+        overwrite: options.overwrite ?? false,
+    };
+}
+export function imageMimeType(path) {
+    const mime = MIME_BY_EXTENSION[extname(path).toLowerCase()];
+    if (!mime)
+        throw usageError(`unsupported image type: ${path}`);
+    return mime;
+}
+export function outputPathForImage(taskId, output, index, count) {
+    if (!output) {
+        return { path: join(appPaths().tempDir, taskId, `image-${index + 1}.png`), temporary: true };
+    }
+    const absolute = resolve(output);
+    const extension = extname(absolute).toLowerCase();
+    if (extension === ".png") {
+        if (count === 1)
+            return { path: absolute, temporary: false };
+        return {
+            path: join(dirname(absolute), `${basename(absolute, extension)}-${index + 1}.png`),
+            temporary: false,
+        };
+    }
+    return { path: join(absolute, `image-${index + 1}.png`), temporary: false };
+}
+export function writePngArtifact(taskId, buffer, output, index, count, overwrite) {
+    const target = outputPathForImage(taskId, output, index, count);
+    if (existsSync(target.path) && !overwrite) {
+        throw usageError(`output already exists: ${target.path}; pass --overwrite to replace it`);
+    }
+    ensureDir(dirname(target.path));
+    atomicWrite(target.path, buffer, 0o600);
+    return {
+        path: target.path,
+        kind: "image",
+        mimeType: "image/png",
+        sizeBytes: buffer.byteLength,
+        expiresAt: target.temporary ? new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString() : undefined,
+    };
+}
+//# sourceMappingURL=images.js.map

package/dist/images.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { dispatch, generateImage, generateText, resumeTask, runTask, streamTaskEvents, } from "./api.js";
+export { loadConfig, type ResolvedConfig, type UserConfig } from "./config.js";
+export { runDoctor } from "./doctor.js";
+export { runGarbageCollection } from "./state.js";
+export { CodexTaskError } from "./errors.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,UAAU,EACV,OAAO,EACP,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { dispatch, generateImage, generateText, resumeTask, runTask, streamTaskEvents, } from "./api.js";
+export { loadConfig } from "./config.js";
+export { runDoctor } from "./doctor.js";
+export { runGarbageCollection } from "./state.js";
+export { CodexTaskError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,UAAU,EACV,OAAO,EACP,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAwC,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,14 @@
+export interface AppPaths {
+    configDir: string;
+    stateDir: string;
+    cacheDir: string;
+    tempDir: string;
+    tasksDir: string;
+    identityPath: string;
+    configPath: string;
+}
+export declare function defaultCodexHome(): string;
+export declare function appPaths(env?: NodeJS.ProcessEnv): AppPaths;
+/** Read-only compatibility paths for users migrating from CodexErrand. */
+export declare function legacyAppPaths(env?: NodeJS.ProcessEnv): AppPaths;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAmDD,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,QAAQ,CAEvE;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,QAAQ,CAE7E"}

package/dist/paths.js

@@ -0,0 +1,61 @@
+import { homedir, platform, tmpdir } from "node:os";
+import { join } from "node:path";
+export function defaultCodexHome() {
+    return process.env["CODEX_HOME"] ?? join(homedir(), ".codex");
+}
+function namedAppPaths(name, override, env) {
+    if (override) {
+        const configDir = join(override, "config");
+        const stateDir = join(override, "state");
+        const cacheDir = join(override, "cache");
+        const tempDir = join(override, "temp");
+        return {
+            configDir,
+            stateDir,
+            cacheDir,
+            tempDir,
+            tasksDir: join(stateDir, "tasks"),
+            identityPath: join(stateDir, "identity.json"),
+            configPath: join(configDir, "config.json"),
+        };
+    }
+    const home = homedir();
+    let configDir;
+    let stateDir;
+    let cacheDir;
+    if (platform() === "darwin") {
+        configDir = join(home, "Library", "Application Support", name);
+        stateDir = configDir;
+        cacheDir = join(home, "Library", "Caches", name);
+    }
+    else if (platform() === "win32") {
+        const appData = env["APPDATA"] ?? join(home, "AppData", "Roaming");
+        const localAppData = env["LOCALAPPDATA"] ?? join(home, "AppData", "Local");
+        configDir = join(appData, name);
+        stateDir = join(localAppData, name, "state");
+        cacheDir = join(localAppData, name, "cache");
+    }
+    else {
+        configDir = join(env["XDG_CONFIG_HOME"] ?? join(home, ".config"), name);
+        stateDir = join(env["XDG_STATE_HOME"] ?? join(home, ".local", "state"), name);
+        cacheDir = join(env["XDG_CACHE_HOME"] ?? join(home, ".cache"), name);
+    }
+    const tempDir = join(tmpdir(), name);
+    return {
+        configDir,
+        stateDir,
+        cacheDir,
+        tempDir,
+        tasksDir: join(stateDir, "tasks"),
+        identityPath: join(stateDir, "identity.json"),
+        configPath: join(configDir, "config.json"),
+    };
+}
+export function appPaths(env = process.env) {
+    return namedAppPaths("codex-task", env["CODEX_TASK_HOME"], env);
+}
+/** Read-only compatibility paths for users migrating from CodexErrand. */
+export function legacyAppPaths(env = process.env) {
+    return namedAppPaths("codexerrand", env["CODEXERRAND_HOME"], env);
+}
+//# 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/skill.d.ts

@@ -0,0 +1,2 @@
+export declare function companionSkillPath(): string;
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}