codex-task 0.2.3 → 0.2.5

package/dist/server.js

@@ -0,0 +1,503 @@
+import { randomUUID, timingSafeEqual } from "node:crypto";
+import { createReadStream, existsSync, lstatSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { createServer } from "node:http";
+import { basename, join } from "node:path";
+import { dispatch } from "./api.js";
+import { asCodexTaskError } from "./errors.js";
+import { ensureDir } from "./fs-utils.js";
+import { appPaths } from "./paths.js";
+function backendForRequest(request) {
+    if (request.kind === "task" || request.kind === "resume")
+        return "sdk";
+    return request.options.backend ?? "direct";
+}
+function writeJson(response, status, value) {
+    response.writeHead(status, {
+        "content-type": "application/json; charset=utf-8",
+        "cache-control": "no-store",
+    });
+    response.end(`${JSON.stringify(value)}\n`);
+}
+function authorized(request, token) {
+    if (!token)
+        return true;
+    const header = request.headers.authorization;
+    if (!header?.startsWith("Bearer "))
+        return false;
+    const supplied = Buffer.from(header.slice("Bearer ".length));
+    const expected = Buffer.from(token);
+    return supplied.length === expected.length && timingSafeEqual(supplied, expected);
+}
+function isLoopbackHost(host) {
+    const normalized = host.toLowerCase().replace(/^\[|\]$/g, "");
+    return normalized === "localhost" || normalized === "::1" || /^127(?:\.\d{1,3}){3}$/.test(normalized);
+}
+async function readJson(request, maxBodyBytes) {
+    const chunks = [];
+    let bytes = 0;
+    for await (const chunk of request) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        bytes += buffer.length;
+        if (bytes > maxBodyBytes)
+            throw new Error("REQUEST_TOO_LARGE");
+        chunks.push(buffer);
+    }
+    const text = Buffer.concat(chunks).toString("utf8");
+    const value = JSON.parse(text);
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("INVALID_JSON_BODY");
+    return value;
+}
+function remotePrompt(body) {
+    const parts = [];
+    if (typeof body["prompt"] === "string" && body["prompt"].trim())
+        parts.push(body["prompt"].trim());
+    const promptFiles = body["promptFiles"];
+    if (promptFiles !== undefined) {
+        if (!Array.isArray(promptFiles) || promptFiles.length > 20)
+            throw new Error("INVALID_PROMPT_FILES");
+        for (const item of promptFiles) {
+            if (!item || typeof item !== "object" || Array.isArray(item))
+                throw new Error("INVALID_PROMPT_FILES");
+            const record = item;
+            const name = typeof record["name"] === "string" ? basename(record["name"]).trim() : "";
+            const content = typeof record["content"] === "string" ? record["content"].trim() : "";
+            if (!name || !content || name.length > 200)
+                throw new Error("INVALID_PROMPT_FILES");
+            parts.push(`--- BEGIN PROMPT FILE: ${name} ---\n${content}\n--- END PROMPT FILE ---`);
+        }
+    }
+    if (parts.length === 0)
+        throw new Error("MISSING_PROMPT");
+    return parts.join("\n\n");
+}
+const REASONING_EFFORTS = new Set(["none", "low", "medium", "high", "xhigh", "max", "ultra"]);
+function remoteCommonOptions(body) {
+    const reasoning = typeof body["reasoning"] === "string" && REASONING_EFFORTS.has(body["reasoning"])
+        ? body["reasoning"]
+        : undefined;
+    const timeoutMs = typeof body["timeoutMs"] === "number" && Number.isFinite(body["timeoutMs"]) && body["timeoutMs"] > 0
+        ? body["timeoutMs"]
+        : undefined;
+    const retries = typeof body["retries"] === "number" && Number.isInteger(body["retries"]) && body["retries"] >= 0 && body["retries"] <= 10
+        ? body["retries"]
+        : undefined;
+    const schema = body["schema"];
+    const outputSchema = schema && typeof schema === "object" && !Array.isArray(schema)
+        ? schema
+        : undefined;
+    return {
+        ...(typeof body["model"] === "string" && body["model"].trim() ? { model: body["model"].trim() } : {}),
+        ...(reasoning ? { reasoning } : {}),
+        ...(typeof body["instructions"] === "string" && body["instructions"].trim() ? { instructions: body["instructions"].trim() } : {}),
+        ...(outputSchema ? { outputSchema } : {}),
+        ...(timeoutMs ? { timeoutMs } : {}),
+        ...(retries !== undefined ? { retries } : {}),
+    };
+}
+const IMAGE_EXTENSION = {
+    "image/png": ".png",
+    "image/jpeg": ".jpg",
+    "image/webp": ".webp",
+    "image/gif": ".gif",
+};
+function decodeBase64(value) {
+    const compact = value.replace(/\s/g, "");
+    if (!compact || !/^[A-Za-z0-9+/]*={0,2}$/.test(compact) || compact.length % 4 !== 0) {
+        throw new Error("INVALID_IMAGE_DATA");
+    }
+    return Buffer.from(compact, "base64");
+}
+function materializeImages(jobId, body) {
+    const images = body["images"];
+    if (images === undefined)
+        return { paths: [] };
+    if (!Array.isArray(images) || images.length > 5)
+        throw new Error("INVALID_IMAGES");
+    const uploadDir = join(appPaths().tempDir, "server", jobId);
+    const inputDir = join(uploadDir, "inputs");
+    const decoded = [];
+    let totalBytes = 0;
+    for (const item of images) {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            throw new Error("INVALID_IMAGES");
+        const record = item;
+        const mimeType = typeof record["mimeType"] === "string" ? record["mimeType"].toLowerCase() : "";
+        const extension = IMAGE_EXTENSION[mimeType];
+        if (!extension || typeof record["dataBase64"] !== "string")
+            throw new Error("INVALID_IMAGES");
+        const bytes = decodeBase64(record["dataBase64"]);
+        if (bytes.length > 20 * 1024 * 1024)
+            throw new Error("IMAGE_TOO_LARGE");
+        totalBytes += bytes.length;
+        decoded.push({ bytes, extension });
+    }
+    if (totalBytes > 50 * 1024 * 1024)
+        throw new Error("IMAGES_TOO_LARGE");
+    ensureDir(inputDir);
+    const paths = decoded.map((image, index) => {
+        const path = join(inputDir, `image-${index + 1}${image.extension}`);
+        writeFileSync(path, image.bytes, { mode: 0o600 });
+        return path;
+    });
+    return { paths, uploadDir };
+}
+function removeExpiredUploadDirectories(ttlMs) {
+    const root = join(appPaths().tempDir, "server");
+    if (!existsSync(root))
+        return;
+    const cutoff = Date.now() - ttlMs;
+    for (const entry of readdirSync(root, { withFileTypes: true })) {
+        if (!entry.isDirectory() || !/^[0-9a-f]{8}-[0-9a-f-]{27}$/i.test(entry.name))
+            continue;
+        const path = join(root, entry.name);
+        try {
+            if (lstatSync(path).mtimeMs < cutoff)
+                rmSync(path, { recursive: true, force: true });
+        }
+        catch {
+            // A concurrent cleanup or permissions issue must not prevent service startup.
+        }
+    }
+}
+function publicResult(job, result) {
+    return {
+        ...result,
+        artifacts: result.artifacts.map(({ path: _path, ...artifact }, index) => ({
+            ...artifact,
+            downloadUrl: `/v1/jobs/${job.jobId}/artifacts/${index}`,
+        })),
+    };
+}
+function jobSnapshot(job) {
+    return {
+        jobId: job.jobId,
+        kind: job.kind,
+        status: job.status,
+        createdAt: job.createdAt,
+        updatedAt: job.updatedAt,
+        ...(job.result ? { result: publicResult(job, job.result) } : {}),
+    };
+}
+export async function startCodexTaskServer(options = {}) {
+    const host = options.host ?? "127.0.0.1";
+    const port = options.port ?? 7777;
+    if (!isLoopbackHost(host) && !options.token?.trim()) {
+        throw new Error("A non-loopback listener requires a Service Token");
+    }
+    const run = options.run ?? dispatch;
+    const maxBodyBytes = options.maxBodyBytes ?? 72 * 1024 * 1024;
+    const jobTtlMs = options.jobTtlMs ?? 24 * 60 * 60 * 1000;
+    if (!Number.isFinite(jobTtlMs) || jobTtlMs < 1)
+        throw new Error("jobTtlMs must be positive");
+    removeExpiredUploadDirectories(jobTtlMs);
+    const maxConcurrency = options.maxConcurrency ?? 2;
+    if (!Number.isInteger(maxConcurrency) || maxConcurrency < 1 || maxConcurrency > 16) {
+        throw new Error("maxConcurrency must be an integer from 1 to 16");
+    }
+    const jobs = new Map();
+    const pending = [];
+    let active = 0;
+    const drain = () => {
+        while (active < maxConcurrency && pending.length > 0) {
+            const next = pending.shift();
+            if (!next)
+                return;
+            const { job, request: taskRequest } = next;
+            active += 1;
+            job.status = "running";
+            job.updatedAt = new Date().toISOString();
+            void run(taskRequest)
+                .then((result) => {
+                job.status = result.status;
+                job.result = result;
+                job.updatedAt = new Date().toISOString();
+            })
+                .catch((error) => {
+                const normalized = asCodexTaskError(error);
+                job.status = "failed";
+                job.result = {
+                    status: "failed",
+                    taskId: randomUUID(),
+                    backend: backendForRequest(taskRequest),
+                    artifacts: [],
+                    error: {
+                        code: normalized.code,
+                        message: normalized.message,
+                        retryable: normalized.retryable,
+                    },
+                };
+                job.updatedAt = new Date().toISOString();
+            })
+                .finally(() => {
+                if (job.uploadDir)
+                    rmSync(job.uploadDir, { recursive: true, force: true });
+                active -= 1;
+                const expiry = setTimeout(() => jobs.delete(job.jobId), jobTtlMs);
+                expiry.unref();
+                drain();
+            });
+        }
+    };
+    const execute = (job, taskRequest) => {
+        pending.push({ job, request: taskRequest });
+        queueMicrotask(drain);
+    };
+    const server = createServer((request, response) => {
+        void (async () => {
+            const url = new URL(request.url ?? "/", `http://${request.headers.host ?? "localhost"}`);
+            if (request.method === "GET" && url.pathname === "/healthz") {
+                writeJson(response, 200, { ok: true, service: "codex-task" });
+                return;
+            }
+            if (url.pathname.startsWith("/v1/") && !authorized(request, options.token)) {
+                writeJson(response, 401, {
+                    error: { code: "UNAUTHORIZED", message: "A valid Bearer token is required" },
+                });
+                return;
+            }
+            if (request.method === "POST" && url.pathname === "/v1/text") {
+                let body;
+                let uploadDir;
+                try {
+                    body = await readJson(request, maxBodyBytes);
+                }
+                catch (error) {
+                    const tooLarge = error instanceof Error && error.message === "REQUEST_TOO_LARGE";
+                    writeJson(response, tooLarge ? 413 : 400, {
+                        error: {
+                            code: tooLarge ? "REQUEST_TOO_LARGE" : "INVALID_REQUEST",
+                            message: tooLarge ? "Request body exceeds the configured limit" : "Request body must be valid JSON",
+                        },
+                    });
+                    return;
+                }
+                try {
+                    const now = new Date().toISOString();
+                    const job = {
+                        jobId: randomUUID(),
+                        kind: "text",
+                        status: "queued",
+                        createdAt: now,
+                        updatedAt: now,
+                    };
+                    const uploaded = materializeImages(job.jobId, body);
+                    uploadDir = uploaded.uploadDir;
+                    job.uploadDir = uploadDir;
+                    const backend = body["backend"] === "sdk" ? "sdk" : "direct";
+                    const taskRequest = {
+                        kind: "text",
+                        options: {
+                            ...remoteCommonOptions(body),
+                            prompt: remotePrompt(body),
+                            imagePaths: uploaded.paths,
+                            backend,
+                            ...(typeof body["workingDirectory"] === "string" ? { workingDirectory: body["workingDirectory"] } : {}),
+                        },
+                    };
+                    jobs.set(job.jobId, job);
+                    execute(job, taskRequest);
+                    writeJson(response, 202, {
+                        jobId: job.jobId,
+                        status: "queued",
+                        statusUrl: `/v1/jobs/${job.jobId}`,
+                    });
+                }
+                catch (error) {
+                    if (uploadDir)
+                        rmSync(uploadDir, { recursive: true, force: true });
+                    const message = error instanceof Error ? error.message : "INVALID_REQUEST";
+                    writeJson(response, 400, {
+                        error: { code: message, message: "Text request is invalid" },
+                    });
+                }
+                return;
+            }
+            if (request.method === "POST" && url.pathname === "/v1/image") {
+                let body;
+                try {
+                    body = await readJson(request, maxBodyBytes);
+                    const now = new Date().toISOString();
+                    const job = {
+                        jobId: randomUUID(),
+                        kind: "image",
+                        status: "queued",
+                        createdAt: now,
+                        updatedAt: now,
+                    };
+                    const uploaded = materializeImages(job.jobId, body);
+                    job.uploadDir = uploaded.uploadDir;
+                    const taskRequest = {
+                        kind: "image",
+                        options: {
+                            ...remoteCommonOptions(body),
+                            prompt: remotePrompt(body),
+                            imagePaths: uploaded.paths,
+                            backend: body["backend"] === "sdk" ? "sdk" : "direct",
+                            temporary: true,
+                            ...(typeof body["workingDirectory"] === "string" ? { workingDirectory: body["workingDirectory"] } : {}),
+                            ...(typeof body["count"] === "number" ? { count: body["count"] } : {}),
+                            ...(typeof body["concurrency"] === "number" ? { concurrency: body["concurrency"] } : {}),
+                            ...(typeof body["size"] === "string" ? { size: body["size"] } : {}),
+                            ...(typeof body["quality"] === "string" ? { quality: body["quality"] } : {}),
+                            ...(typeof body["background"] === "string" ? { background: body["background"] } : {}),
+                        },
+                    };
+                    jobs.set(job.jobId, job);
+                    execute(job, taskRequest);
+                    writeJson(response, 202, {
+                        jobId: job.jobId,
+                        status: "queued",
+                        statusUrl: `/v1/jobs/${job.jobId}`,
+                    });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : "INVALID_REQUEST";
+                    writeJson(response, message === "REQUEST_TOO_LARGE" ? 413 : 400, {
+                        error: { code: message, message: "Image request is invalid" },
+                    });
+                }
+                return;
+            }
+            if (request.method === "POST" && url.pathname === "/v1/task") {
+                try {
+                    const body = await readJson(request, maxBodyBytes);
+                    const now = new Date().toISOString();
+                    const job = {
+                        jobId: randomUUID(),
+                        kind: "task",
+                        status: "queued",
+                        createdAt: now,
+                        updatedAt: now,
+                    };
+                    const uploaded = materializeImages(job.jobId, body);
+                    job.uploadDir = uploaded.uploadDir;
+                    const sandbox = body["sandboxMode"];
+                    const sandboxMode = sandbox === "read-only" || sandbox === "workspace-write" || sandbox === "danger-full-access"
+                        ? sandbox
+                        : undefined;
+                    const taskRequest = {
+                        kind: "task",
+                        options: {
+                            ...remoteCommonOptions(body),
+                            prompt: remotePrompt(body),
+                            imagePaths: uploaded.paths,
+                            backend: "sdk",
+                            ...(typeof body["workingDirectory"] === "string" ? { workingDirectory: body["workingDirectory"] } : {}),
+                            ...(sandboxMode ? { sandboxMode } : {}),
+                            ...(typeof body["networkAccess"] === "boolean" ? { networkAccess: body["networkAccess"] } : {}),
+                            ...(typeof body["noFollowup"] === "boolean" ? { noFollowup: body["noFollowup"] } : {}),
+                        },
+                    };
+                    jobs.set(job.jobId, job);
+                    execute(job, taskRequest);
+                    writeJson(response, 202, {
+                        jobId: job.jobId,
+                        status: "queued",
+                        statusUrl: `/v1/jobs/${job.jobId}`,
+                    });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : "INVALID_REQUEST";
+                    writeJson(response, message === "REQUEST_TOO_LARGE" ? 413 : 400, {
+                        error: { code: message, message: "Workspace task request is invalid" },
+                    });
+                }
+                return;
+            }
+            const resumeMatch = request.method === "POST"
+                ? url.pathname.match(/^\/v1\/tasks\/([0-9a-f-]{36})\/resume$/i)
+                : null;
+            if (resumeMatch) {
+                try {
+                    const body = await readJson(request, maxBodyBytes);
+                    const now = new Date().toISOString();
+                    const job = {
+                        jobId: randomUUID(),
+                        kind: "resume",
+                        status: "queued",
+                        createdAt: now,
+                        updatedAt: now,
+                    };
+                    const uploaded = materializeImages(job.jobId, body);
+                    job.uploadDir = uploaded.uploadDir;
+                    const taskRequest = {
+                        kind: "resume",
+                        options: {
+                            ...remoteCommonOptions(body),
+                            taskId: resumeMatch[1] ?? "",
+                            answer: remotePrompt(body),
+                            imagePaths: uploaded.paths,
+                            ...(typeof body["noFollowup"] === "boolean" ? { noFollowup: body["noFollowup"] } : {}),
+                        },
+                    };
+                    jobs.set(job.jobId, job);
+                    execute(job, taskRequest);
+                    writeJson(response, 202, {
+                        jobId: job.jobId,
+                        status: "queued",
+                        statusUrl: `/v1/jobs/${job.jobId}`,
+                    });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : "INVALID_REQUEST";
+                    writeJson(response, message === "REQUEST_TOO_LARGE" ? 413 : 400, {
+                        error: { code: message, message: "Resume request is invalid" },
+                    });
+                }
+                return;
+            }
+            const jobMatch = request.method === "GET" ? url.pathname.match(/^\/v1\/jobs\/([0-9a-f-]{36})$/i) : null;
+            if (jobMatch) {
+                const job = jobs.get(jobMatch[1] ?? "");
+                if (!job) {
+                    writeJson(response, 404, { error: { code: "JOB_NOT_FOUND", message: "Remote job not found" } });
+                    return;
+                }
+                writeJson(response, 200, jobSnapshot(job));
+                return;
+            }
+            const artifactMatch = request.method === "GET"
+                ? url.pathname.match(/^\/v1\/jobs\/([0-9a-f-]{36})\/artifacts\/(\d+)$/i)
+                : null;
+            if (artifactMatch) {
+                const job = jobs.get(artifactMatch[1] ?? "");
+                const index = Number(artifactMatch[2]);
+                const artifact = job?.result?.artifacts[index];
+                if (!artifact || !existsSync(artifact.path)) {
+                    writeJson(response, 404, { error: { code: "ARTIFACT_NOT_FOUND", message: "Artifact not found" } });
+                    return;
+                }
+                const stat = statSync(artifact.path);
+                response.writeHead(200, {
+                    "content-type": artifact.mimeType ?? "application/octet-stream",
+                    "content-length": stat.size,
+                    "content-disposition": `attachment; filename="${basename(artifact.path).replace(/[^a-zA-Z0-9._-]/g, "-")}"`,
+                    "cache-control": "private, no-store",
+                });
+                createReadStream(artifact.path).pipe(response);
+                return;
+            }
+            writeJson(response, 404, { error: { code: "NOT_FOUND", message: "Route not found" } });
+        })().catch((error) => {
+            const normalized = asCodexTaskError(error);
+            writeJson(response, 500, { error: { code: normalized.code, message: normalized.message } });
+        });
+    });
+    await new Promise((resolve, reject) => {
+        const onError = (error) => reject(error);
+        server.once("error", onError);
+        server.listen(port, host, () => {
+            server.off("error", onError);
+            resolve();
+        });
+    });
+    const address = server.address();
+    return {
+        host,
+        port: address.port,
+        url: `http://${host.includes(":") ? `[${host}]` : host}:${address.port}`,
+        close: () => new Promise((resolve, reject) => server.close((error) => (error ? reject(error) : resolve()))),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/examples/mobile/README.md

@@ -0,0 +1,69 @@
+# CodexTask 手机端示例
+
+这里的 Android Kotlin 和 iOS Swift 客户端调用已经运行的 `codex-task serve`。推荐连接可信局域网、Tailscale/WireGuard，或带 HTTPS 的反向代理。
+
+不要把生产 Service Token 提交到 Git，也不要硬编码到公开 App。示例构造器接收 token，私有 App 可以从 Android Keystore、iOS Keychain、受管配置或用户输入中读取。
+
+## 完整示例流程
+
+两个 `MealWorkflow` 都会实际串起四类任务：
+
+1. `POST /v1/image`：根据文字和 `style.md` 生成健身营养餐。
+2. 轮询 job，读取 `result.artifacts[0].downloadUrl`，携带同一 token 下载图片。
+3. `POST /v1/text`：把图片和 JSON Schema 一起上传，做图生文营养分析。
+4. `POST /v1/task`：把营养 JSON、参考图片和服务器上的项目目录交给 Codex SDK 修改。
+5. 如果返回 `needs_input`，使用 `result.taskId` 调用 `POST /v1/tasks/:taskId/resume`。
+
+所有提交先返回 `202`、`jobId` 和 `statusUrl`。客户端轮询 `GET statusUrl`，直到 `completed`、`needs_input`、`failed` 或 `cancelled`。这种设计不会让手机保持一个可能持续数十分钟的 HTTP 请求。
+
+命名 prompt 文档格式为 `{name, content}`；图片格式为 `{name, mimeType, dataBase64}`。text、image、task 和 resume 都能组合文本、多份文档与多张图片。
+
+## Android
+
+文件：
+
+- [`android/CodexTaskClient.kt`](./android/CodexTaskClient.kt)：OkHttp + coroutines 客户端，包含四类提交、轮询与 artifact 下载。
+- [`android/MealWorkflow.kt`](./android/MealWorkflow.kt)：完整营养餐流程。
+
+Gradle 依赖：
+
+```kotlin
+implementation("com.squareup.okhttp3:okhttp:4.12.0")
+implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.10.2")
+```
+
+从 ViewModel 或协程中调用：
+
+```kotlin
+val client = CodexTaskClient("http://192.168.1.50:7777", tokenFromKeystore)
+val result = runMealWorkflow(client, "/absolute/server/path/to/meal-app")
+```
+
+Android 默认阻止明文 HTTP。生产环境应使用 HTTPS 或 VPN；仅在可信局域网开发时，才通过范围收窄的 Network Security Config 放行指定主机，不要全局允许明文流量。
+
+## iOS
+
+文件：
+
+- [`ios/CodexTaskClient.swift`](./ios/CodexTaskClient.swift)：Foundation `URLSession` async/await 客户端。
+- [`ios/MealWorkflow.swift`](./ios/MealWorkflow.swift)：与 Android 相同的完整流程。
+
+调用示例：
+
+```swift
+let client = CodexTaskClient(baseURL: URL(string: "http://192.168.1.50:7777")!, token: tokenFromKeychain)
+let result = try await runMealWorkflow(client: client, serverProjectPath: "/absolute/server/path/to/meal-app")
+```
+
+iOS App Transport Security 默认阻止明文 HTTP。生产环境应使用 HTTPS 或 VPN；局域网调试时只为目标域名配置 ATS 开发例外。
+
+## 服务地址
+
+`0.0.0.0` 是电脑的监听地址，不是手机可以访问的目标地址。App 应配置电脑可达的地址，例如：
+
+```text
+http://192.168.1.50:7777
+https://codex-task.example.internal
+```
+
+平台安装脚本打印的 token 通过 `Authorization: Bearer <token>` 发送。持有 token 的手机可以触发服务器上该用户权限范围内的 CodexTask；尤其要谨慎开放 `/v1/task`。