codex-task 0.2.0

package/dist/skill.js

@@ -0,0 +1,6 @@
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export function companionSkillPath() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), "..", "skills", "codex-task");
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AACxF,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,20 @@
+import type { GcReport, ReasoningEffort, SandboxMode } from "./types.js";
+export interface StoredTask {
+    version: 1;
+    taskId: string;
+    threadId: string;
+    workingDirectory: string;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt: string;
+    sandboxMode: SandboxMode;
+    networkAccess: boolean;
+    model?: string | undefined;
+    reasoning?: ReasoningEffort | undefined;
+    noFollowup: boolean;
+}
+export declare function savePendingTask(task: Omit<StoredTask, "version" | "updatedAt" | "expiresAt">): Promise<void>;
+export declare function loadPendingTask(taskId: string): StoredTask;
+export declare function deletePendingTask(taskId: string): void;
+export declare function runGarbageCollection(now?: number): GcReport;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACxC,UAAU,EAAE,OAAO,CAAC;CACrB;AASD,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlH;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CA4B1D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGtD;AAiCD,wBAAgB,oBAAoB,CAAC,GAAG,SAAa,GAAG,QAAQ,CAmD/D"}

package/dist/state.js

@@ -0,0 +1,134 @@
+import { existsSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
+import { join, resolve, sep } from "node:path";
+import { appPaths, legacyAppPaths } from "./paths.js";
+import { atomicWrite, ensureDir, withFileLock } from "./fs-utils.js";
+import { CodexTaskError } from "./errors.js";
+import { loadConfig } from "./config.js";
+function taskPath(taskId, paths = appPaths()) {
+    if (!/^[0-9a-f-]{36}$/i.test(taskId)) {
+        throw new CodexTaskError("INVALID_TASK_ID", `Invalid task id: ${taskId}`, { exitCode: 2 });
+    }
+    return join(paths.tasksDir, `${taskId}.json`);
+}
+export async function savePendingTask(task) {
+    const config = loadConfig();
+    const now = new Date();
+    const record = {
+        ...task,
+        version: 1,
+        updatedAt: now.toISOString(),
+        expiresAt: new Date(now.getTime() + config.pendingTaskTtlMs).toISOString(),
+    };
+    const path = taskPath(task.taskId);
+    await withFileLock(`${path}.lock`, async () => atomicWrite(path, JSON.stringify(record, null, 2)));
+}
+export function loadPendingTask(taskId) {
+    const currentPath = taskPath(taskId);
+    const legacyPath = taskPath(taskId, legacyAppPaths());
+    const path = existsSync(currentPath) ? currentPath : legacyPath;
+    if (!existsSync(path)) {
+        throw new CodexTaskError("TASK_NOT_FOUND", `No resumable task found for ${taskId}`, {
+            exitCode: 2,
+        });
+    }
+    let record;
+    try {
+        record = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw new CodexTaskError("TASK_STATE_INVALID", `Could not parse task state for ${taskId}`, {
+            exitCode: 2,
+            cause: error,
+        });
+    }
+    if (record.version !== 1 || record.taskId !== taskId || !record.threadId) {
+        throw new CodexTaskError("TASK_STATE_INVALID", `Task state for ${taskId} is invalid`, {
+            exitCode: 2,
+        });
+    }
+    if (Date.parse(record.expiresAt) <= Date.now()) {
+        deletePendingTask(taskId);
+        throw new CodexTaskError("TASK_EXPIRED", `Task ${taskId} has expired`, { exitCode: 2 });
+    }
+    return record;
+}
+export function deletePendingTask(taskId) {
+    rmSync(taskPath(taskId), { force: true });
+    rmSync(taskPath(taskId, legacyAppPaths()), { force: true });
+}
+function directorySize(path) {
+    let total = 0;
+    for (const entry of readdirSync(path, { withFileTypes: true })) {
+        const child = join(path, entry.name);
+        if (entry.isDirectory())
+            total += directorySize(child);
+        else if (entry.isFile())
+            total += statSync(child).size;
+    }
+    return total;
+}
+function isInside(path, root) {
+    const absolute = resolve(path);
+    const absoluteRoot = resolve(root);
+    return absolute === absoluteRoot || absolute.startsWith(`${absoluteRoot}${sep}`);
+}
+function removeManagedPath(path, root) {
+    if (!isInside(path, root) || resolve(path) === resolve(root)) {
+        throw new CodexTaskError("GC_PATH_REJECTED", `Refusing to remove unmanaged path: ${path}`);
+    }
+    const bytes = existsSync(path) ? directorySize(path) : 0;
+    rmSync(path, { recursive: true, force: true });
+    return bytes;
+}
+export function runGarbageCollection(now = Date.now()) {
+    const config = loadConfig();
+    const paths = appPaths();
+    const report = { removedPaths: 0, reclaimedBytes: 0, warnings: [] };
+    ensureDir(paths.tempDir);
+    ensureDir(paths.tasksDir);
+    for (const entry of readdirSync(paths.tasksDir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith(".json"))
+            continue;
+        const path = join(paths.tasksDir, entry.name);
+        try {
+            const record = JSON.parse(readFileSync(path, "utf8"));
+            if (!record.expiresAt || Date.parse(record.expiresAt) <= now) {
+                rmSync(path, { force: true });
+                report.removedPaths += 1;
+            }
+        }
+        catch (error) {
+            report.warnings.push(`Could not inspect ${path}: ${String(error)}`);
+        }
+    }
+    const tempEntries = [];
+    for (const entry of readdirSync(paths.tempDir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const path = join(paths.tempDir, entry.name);
+        try {
+            const stat = statSync(path);
+            tempEntries.push({ path, bytes: directorySize(path), mtimeMs: stat.mtimeMs });
+        }
+        catch (error) {
+            report.warnings.push(`Could not inspect ${path}: ${String(error)}`);
+        }
+    }
+    for (const entry of tempEntries.filter((item) => now - item.mtimeMs > config.tempTtlMs)) {
+        report.reclaimedBytes += removeManagedPath(entry.path, paths.tempDir);
+        report.removedPaths += 1;
+    }
+    const remaining = tempEntries
+        .filter((entry) => existsSync(entry.path))
+        .sort((left, right) => left.mtimeMs - right.mtimeMs);
+    let totalBytes = remaining.reduce((total, entry) => total + entry.bytes, 0);
+    for (const entry of remaining) {
+        if (totalBytes <= config.tempMaxBytes)
+            break;
+        report.reclaimedBytes += removeManagedPath(entry.path, paths.tempDir);
+        report.removedPaths += 1;
+        totalBytes -= entry.bytes;
+    }
+    return report;
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,167 @@
+export type Backend = "direct" | "sdk";
+export type ReasoningEffort = "none" | "low" | "medium" | "high" | "xhigh" | "max" | "ultra";
+export type TaskStatus = "completed" | "needs_input" | "failed" | "cancelled";
+export type SandboxMode = "read-only" | "workspace-write" | "danger-full-access";
+export interface UsageSummary {
+    inputTokens?: number | undefined;
+    cachedInputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+}
+export interface Artifact {
+    path: string;
+    kind: "image" | "file";
+    mimeType?: string | undefined;
+    sizeBytes?: number | undefined;
+    expiresAt?: string | undefined;
+}
+export interface CommandSummary {
+    command: string;
+    exitCode?: number | undefined;
+    status?: string | undefined;
+}
+export interface ResultBase {
+    status: TaskStatus;
+    taskId: string;
+    backend: Backend;
+    threadId?: string | undefined;
+    text?: string | undefined;
+    effectiveModel?: string | undefined;
+    reasoningEffort?: ReasoningEffort | undefined;
+    artifacts: Artifact[];
+    changes?: string[] | undefined;
+    commands?: CommandSummary[] | undefined;
+    usage?: UsageSummary | undefined;
+}
+export interface CompletedResult extends ResultBase {
+    status: "completed";
+}
+export interface NeedsInputResult extends ResultBase {
+    status: "needs_input";
+    questions: string[];
+}
+export interface FailedResult extends ResultBase {
+    status: "failed";
+    error: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        details?: unknown;
+    };
+}
+export interface CancelledResult extends ResultBase {
+    status: "cancelled";
+    error: {
+        code: "CANCELLED" | "TIMEOUT";
+        message: string;
+        retryable: boolean;
+    };
+}
+export type TaskResult = CompletedResult | NeedsInputResult | FailedResult | CancelledResult;
+export type TaskEvent = {
+    type: "started";
+    taskId: string;
+    backend: Backend;
+    kind: TaskRequest["kind"];
+} | {
+    type: "progress";
+    taskId: string;
+    message: string;
+    item?: unknown;
+} | {
+    type: "retrying";
+    taskId: string;
+    attempt: number;
+    delayMs: number;
+    error: string;
+} | {
+    type: "artifact";
+    taskId: string;
+    artifact: Artifact;
+} | {
+    type: "needs_input";
+    taskId: string;
+    result: NeedsInputResult;
+} | {
+    type: "completed";
+    taskId: string;
+    result: CompletedResult;
+} | {
+    type: "failed";
+    taskId: string;
+    result: FailedResult | CancelledResult;
+};
+export interface CommonOptions {
+    backend?: Backend | undefined;
+    model?: string | undefined;
+    reasoning?: ReasoningEffort | undefined;
+    instructions?: string | undefined;
+    outputSchema?: Record<string, unknown> | undefined;
+    timeoutMs?: number | undefined;
+    retries?: number | undefined;
+    codexHome?: string | undefined;
+    signal?: AbortSignal | undefined;
+    onEvent?: ((event: TaskEvent) => void) | undefined;
+}
+export interface TextOptions extends CommonOptions {
+    prompt: string;
+    backend?: Backend | undefined;
+    workingDirectory?: string | undefined;
+}
+export interface ImageOptions extends CommonOptions {
+    prompt: string;
+    backend?: Backend | undefined;
+    imagePaths?: string[] | undefined;
+    output?: string | undefined;
+    count?: number | undefined;
+    concurrency?: number | undefined;
+    size?: string | undefined;
+    quality?: "auto" | "low" | "medium" | "high" | undefined;
+    background?: "auto" | "opaque" | "transparent" | undefined;
+    overwrite?: boolean | undefined;
+    workingDirectory?: string | undefined;
+}
+export interface WorkspaceTaskOptions extends CommonOptions {
+    prompt: string;
+    backend: "sdk";
+    workingDirectory?: string | undefined;
+    sandboxMode?: SandboxMode | undefined;
+    networkAccess?: boolean | undefined;
+    noFollowup?: boolean | undefined;
+}
+export interface ResumeTaskOptions extends Omit<CommonOptions, "backend"> {
+    taskId: string;
+    answer: string;
+    noFollowup?: boolean | undefined;
+}
+export type TaskRequest = {
+    kind: "text";
+    options: TextOptions;
+} | {
+    kind: "image";
+    options: ImageOptions;
+} | {
+    kind: "task";
+    options: WorkspaceTaskOptions;
+} | {
+    kind: "resume";
+    options: ResumeTaskOptions;
+};
+export interface DoctorCheck {
+    name: string;
+    status: "ok" | "warning" | "error";
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}
+export interface DoctorReport {
+    ok: boolean;
+    platform: string;
+    nodeVersion: string;
+    checks: DoctorCheck[];
+    paths: Record<string, string>;
+}
+export interface GcReport {
+    removedPaths: number;
+    reclaimedBytes: number;
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "codex-task",
+  "version": "0.2.0",
+  "description": "Unofficial agent-to-agent text, image, and workspace task runner for Codex",
+  "type": "module",
+  "author": "wang121ye",
+  "license": "MIT",
+  "homepage": "https://github.com/wangyendt/codex-task#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wangyendt/codex-task.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wangyendt/codex-task/issues"
+  },
+  "keywords": [
+    "agent",
+    "codex",
+    "cli",
+    "image-generation",
+    "task-runner",
+    "typescript"
+  ],
+  "bin": {
+    "codex-task": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "skills",
+    ".codex-plugin",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node scripts/clean.mjs",
+    "dev": "tsx src/cli.ts",
+    "lint": "eslint src test scripts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --import tsx --test test/*.test.ts",
+    "test:e2e": "node --import tsx --test test/e2e/*.e2e.test.ts",
+    "pack:check": "node scripts/pack-check.mjs",
+    "smoke:install": "node scripts/install-smoke.mjs",
+    "workflow:check": "node scripts/workflow-check.mjs",
+    "verify": "npm run lint && npm run workflow:check && npm run typecheck && npm test && npm run build && npm run pack:check && npm run smoke:install",
+    "prepublishOnly": "npm run verify"
+  },
+  "dependencies": {
+    "@openai/codex-sdk": "0.147.0",
+    "commander": "^14.0.2"
+  },
+  "optionalDependencies": {
+    "@ossiana/node-libcurl": "1.9.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@types/node": "^20.19.43",
+    "eslint": "^9.39.5",
+    "tsx": "^4.23.12",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.66.0",
+    "yaml": "^2.9.0"
+  }
+}

package/skills/codex-task/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: codex-task
+description: Delegate a focused task to CodexTask and return structured text, generated or edited images, or completed workspace changes. Use when another Agent should call the codex-task CLI for text-to-text, text-to-image, image-to-image, or a bounded Codex workspace task, including resuming a task that needs user input.
+---
+
+# CodexTask
+
+Use the installed `codex-task` CLI as a companion tool. This skill teaches the calling Agent how to invoke the CLI; it is not injected into the Codex worker.
+
+## Resolve the CLI
+
+The skill and the executable are separate. Installing this skill does not install the npm package.
+
+1. Prefer `codex-task` when `command -v codex-task` succeeds.
+2. Otherwise, when npm and network access are available, use `npx --yes codex-task@latest` in place of `codex-task` in every command below.
+3. If neither is available, tell the user to install the unscoped package with `npm install -g codex-task`.
+
+Do not silently perform a global npm installation. The package name is `codex-task`, not `@wang121ye/codex-task`.
+
+## Choose the command
+
+- Need only a text result: run `codex-task text --backend direct`.
+- Need a new or edited image: run `codex-task image --backend direct`.
+- Need shell commands, file edits, repository work, project rules, or local tools: run `codex-task task --backend sdk`.
+- Have a prior `needs_input` result: ask the user the returned questions, then run `codex-task resume`.
+
+Never send workspace work to Direct. Direct cannot run local tools, read a repository, use local MCP, or modify files.
+
+## Invoke safely
+
+Prefer stdin for long or quote-heavy prompts:
+
+```bash
+printf '%s' "$PROMPT" | codex-task text --backend direct
+```
+
+For an image that must survive temporary cleanup, always pass an explicit output directory:
+
+```bash
+codex-task image "A clean technical diagram" \
+  --backend direct \
+  --output ./artifacts
+```
+
+For image-to-image, repeat `--image` up to five times:
+
+```bash
+codex-task image "Keep the subject, change the lighting" \
+  --backend direct \
+  --image ./reference.png \
+  --output ./artifacts
+```
+
+For repository work, pass the intended directory explicitly:
+
+```bash
+codex-task task "Implement the requested change and run focused tests" \
+  --backend sdk \
+  --cwd /absolute/path/to/repo
+```
+
+The SDK task default is `danger-full-access`, network enabled, and approval `never`. Invoke it only when the user's request authorizes the workspace task. Use `--no-followup` when the caller explicitly requires a single caller turn and accepts reasonable assumptions.
+
+## Handle the result
+
+Parse stdout as JSON. Treat these statuses as follows:
+
+- `completed`: return `text`, show or link `artifacts`, and summarize `changes` and `commands` when present.
+- `needs_input`: relay every question to the user. Preserve `taskId`; after the user answers, run `codex-task resume <taskId>` with the answer through stdin or as the argument.
+- `failed`: report `error.code` and `error.message`. Retry only when `error.retryable` is true.
+- `cancelled`: report cancellation or timeout; do not claim the task completed.
+
+Use `--stream` only when progress events are useful. It changes stdout from one JSON object to JSONL events; it is an item/progress stream, not guaranteed token streaming.
+
+## Diagnose
+
+Run `codex-task doctor` when Direct authentication, native transport, model resolution, or SDK availability is uncertain. The command is read-only and does not send a model request.
+
+Run `codex-task gc` only to clean CodexTask-managed temporary artifacts and expired pending-task metadata. Files created under an explicit `--output` path are never managed by this cleanup.

package/skills/codex-task/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "CodexTask"
+  short_description: "Delegate text, image, and Codex workspace tasks"
+  default_prompt: "Use $codex-task to delegate this task to a focused Codex worker."