@right-link/paperclip-plugin-codex-remote 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Paperclip AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# paperclip-plugin-codex-remote
+
+Runs **Codex inside a remote sandbox** (e.g. the `cloudflare-bridge` sandbox
+provider) and lets the agent talk back to Paperclip through the runtime API
+bridge. The agent owns task work, Git, PR creation, comments, and issue status
+updates; this adapter owns sandbox setup, remote `CODEX_HOME` sync, preflight,
+and clean finalization.
+
+Adapter type: `codex_remote`.
+
+## A standalone external adapter (no upstream changes)
+
+This is a **fork add-on** packaged as an external adapter. Paperclip loads it
+through the adapter-plugin store (`buildExternalAdapters` →
+`createServerAdapter()`), so **nothing in upstream Paperclip is modified** — no
+edits to `server/src/adapters/registry.ts`, `builtin-adapter-types.ts`, or any
+core file. Upstream pulls apply conflict-free.
+
+It is also fully **independent of `codex_local`**: it does not import, extend, or
+fall back to the upstream codex-local adapter (an earlier experiment built it on
+top of codex-local and was unstable). It ships its own `parse`, `skills`,
+`quota`, `codex-home`, `codex-args`, `cli`, `ui`, and model lists, and depends
+only on **published** `@paperclipai/adapter-utils` exports.
+
+## Entry points
+
+- `.` → `createServerAdapter()` — the complete `ServerAdapterModule` the host
+  loads. Folds the sandbox preflight/verify + remote defaults (`timeoutSec`
+  default, `dangerouslyBypassApprovalsAndSandbox`, `remoteWorkspaceSync: false`)
+  over the package's base `execute`/`testEnvironment`.
+- `./server` — raw building blocks (`execute`, `skills`, `quota`, `sessionCodec`, …).
+- `./meta` — isomorphic metadata (`models`, `modelProfiles`, `agentConfigurationDoc`).
+- `./ui` — UI helpers (`parseCodexStdoutLine`, `buildCodexRemoteConfig`).
+- `./cli` — quota probe CLI.
+
+## Install
+
+Build, then register the package with a Paperclip instance through the adapter
+plugin store (Adapters page → install by package name, or a `localPath` record
+pointing at this directory's built output):
+
+```text
+paperclip-plugin-codex-remote
+```
+
+No restart-time wiring is required — the host picks it up via the plugin store
+and registers the `codex_remote` adapter type.
+
+## How a run works (happy path)
+
+1. Acquire/resume a **per-issue** sandbox via the configured sandbox provider.
+2. Verify the workspace (main + bridge session), sync a sanitized `CODEX_HOME`
+   (provider `config.toml`, no `auth.json`), install it at `/root/.codex`.
+3. Start the runtime-API bridge so the agent can call Paperclip from inside the
+   sandbox.
+4. Preflight, then run `codex exec` in the sandbox over the HTTP execution path.
+5. The agent calls Paperclip via the bridge (fetch issue context, post comments,
+   `PATCH` issue status) and finalizes its own work.
+
+## Configuration
+
+See `agentConfigurationDoc` (exported from `./meta`) for the full field list.
+
+## Not yet included
+
+- **Custom UI run-log parser** — external adapters serve a self-contained,
+  zero-dependency worker module at `/api/adapters/:type/ui-parser.js`. The
+  package's `parse-stdout` logic isn't yet bundled into that worker-compatible
+  form, so the run log uses Paperclip's default rendering until a bundled
+  `./ui-parser` export is added. Functionality is unaffected.
+
+## Build / test
+
+```sh
+pnpm --filter paperclip-plugin-codex-remote build
+pnpm --filter paperclip-plugin-codex-remote exec vitest run
+```

package/dist/cli/format-event.d.ts

@@ -0,0 +1,2 @@
+export declare function printCodexStreamEvent(raw: string, _debug: boolean): void;
+//# sourceMappingURL=format-event.d.ts.map

package/dist/cli/format-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-event.d.ts","sourceRoot":"","sources":["../../src/cli/format-event.ts"],"names":[],"mappings":"AA6IA,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAuFxE"}

package/dist/cli/format-event.js

@@ -0,0 +1,213 @@
+import pc from "picocolors";
+function asRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    return value;
+}
+function asString(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}
+function asNumber(value, fallback = 0) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function errorText(value) {
+    if (typeof value === "string")
+        return value;
+    const rec = asRecord(value);
+    if (!rec)
+        return "";
+    const msg = (typeof rec.message === "string" && rec.message) ||
+        (typeof rec.error === "string" && rec.error) ||
+        (typeof rec.code === "string" && rec.code) ||
+        "";
+    if (msg)
+        return msg;
+    try {
+        return JSON.stringify(rec);
+    }
+    catch {
+        return "";
+    }
+}
+function printItemStarted(item) {
+    const itemType = asString(item.type);
+    if (itemType === "command_execution") {
+        const command = asString(item.command);
+        console.log(pc.yellow("tool_call: command_execution"));
+        if (command)
+            console.log(pc.gray(command));
+        return true;
+    }
+    if (itemType === "tool_use") {
+        const name = asString(item.name, "unknown");
+        console.log(pc.yellow(`tool_call: ${name}`));
+        if (item.input !== undefined) {
+            try {
+                console.log(pc.gray(JSON.stringify(item.input, null, 2)));
+            }
+            catch {
+                console.log(pc.gray(String(item.input)));
+            }
+        }
+        return true;
+    }
+    return false;
+}
+function printItemCompleted(item) {
+    const itemType = asString(item.type);
+    if (itemType === "agent_message") {
+        const text = asString(item.text);
+        if (text)
+            console.log(pc.green(`assistant: ${text}`));
+        return true;
+    }
+    if (itemType === "reasoning") {
+        const text = asString(item.text);
+        if (text)
+            console.log(pc.gray(`thinking: ${text}`));
+        return true;
+    }
+    if (itemType === "tool_use") {
+        const name = asString(item.name, "unknown");
+        console.log(pc.yellow(`tool_call: ${name}`));
+        if (item.input !== undefined) {
+            try {
+                console.log(pc.gray(JSON.stringify(item.input, null, 2)));
+            }
+            catch {
+                console.log(pc.gray(String(item.input)));
+            }
+        }
+        return true;
+    }
+    if (itemType === "command_execution") {
+        const command = asString(item.command);
+        const status = asString(item.status);
+        const exitCode = typeof item.exit_code === "number" && Number.isFinite(item.exit_code) ? item.exit_code : null;
+        const output = asString(item.aggregated_output).replace(/\s+$/, "");
+        const isError = (exitCode !== null && exitCode !== 0) ||
+            status === "failed" ||
+            status === "errored" ||
+            status === "error" ||
+            status === "cancelled";
+        const summaryParts = [
+            "tool_result: command_execution",
+            command ? `command="${command}"` : "",
+            status ? `status=${status}` : "",
+            exitCode !== null ? `exit_code=${exitCode}` : "",
+        ].filter(Boolean);
+        console.log((isError ? pc.red : pc.cyan)(summaryParts.join(" ")));
+        if (output)
+            console.log((isError ? pc.red : pc.gray)(output));
+        return true;
+    }
+    if (itemType === "file_change") {
+        const changes = Array.isArray(item.changes) ? item.changes : [];
+        const entries = changes
+            .map((changeRaw) => asRecord(changeRaw))
+            .filter((change) => Boolean(change))
+            .map((change) => {
+            const kind = asString(change.kind, "update");
+            const path = asString(change.path, "unknown");
+            return `${kind} ${path}`;
+        });
+        const preview = entries.length > 0 ? entries.slice(0, 6).join(", ") : "none";
+        const more = entries.length > 6 ? ` (+${entries.length - 6} more)` : "";
+        console.log(pc.cyan(`file_change: ${preview}${more}`));
+        return true;
+    }
+    if (itemType === "error") {
+        const message = errorText(item.message ?? item.error ?? item);
+        if (message)
+            console.log(pc.red(`error: ${message}`));
+        return true;
+    }
+    if (itemType === "tool_result") {
+        const isError = item.is_error === true || asString(item.status) === "error";
+        const text = asString(item.content) || asString(item.result) || asString(item.output);
+        console.log((isError ? pc.red : pc.cyan)(`tool_result${isError ? " (error)" : ""}`));
+        if (text)
+            console.log((isError ? pc.red : pc.gray)(text));
+        return true;
+    }
+    return false;
+}
+export function printCodexStreamEvent(raw, _debug) {
+    const line = raw.trim();
+    if (!line)
+        return;
+    let parsed = null;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        console.log(line);
+        return;
+    }
+    const type = asString(parsed.type);
+    if (type === "thread.started") {
+        const threadId = asString(parsed.thread_id);
+        const model = asString(parsed.model);
+        const details = [threadId ? `session: ${threadId}` : "", model ? `model: ${model}` : ""].filter(Boolean).join(", ");
+        console.log(pc.blue(`Codex thread started${details ? ` (${details})` : ""}`));
+        return;
+    }
+    if (type === "turn.started") {
+        console.log(pc.blue("turn started"));
+        return;
+    }
+    if (type === "item.started" || type === "item.completed") {
+        const item = asRecord(parsed.item);
+        if (item) {
+            const handled = type === "item.started"
+                ? printItemStarted(item)
+                : printItemCompleted(item);
+            if (!handled) {
+                const itemType = asString(item.type, "unknown");
+                const id = asString(item.id);
+                const status = asString(item.status);
+                const meta = [id ? `id=${id}` : "", status ? `status=${status}` : ""].filter(Boolean).join(" ");
+                console.log(pc.gray(`${type}: ${itemType}${meta ? ` (${meta})` : ""}`));
+            }
+        }
+        else {
+            console.log(pc.gray(type));
+        }
+        return;
+    }
+    if (type === "turn.completed") {
+        const usage = asRecord(parsed.usage);
+        const input = asNumber(usage?.input_tokens);
+        const output = asNumber(usage?.output_tokens);
+        const cached = asNumber(usage?.cached_input_tokens, asNumber(usage?.cache_read_input_tokens));
+        const cost = asNumber(parsed.total_cost_usd);
+        const isError = parsed.is_error === true;
+        const subtype = asString(parsed.subtype);
+        const errors = Array.isArray(parsed.errors) ? parsed.errors.map(errorText).filter(Boolean) : [];
+        console.log(pc.blue(`tokens: in=${input} out=${output} cached=${cached} cost=$${cost.toFixed(6)}`));
+        if (subtype || isError || errors.length > 0) {
+            console.log(pc.red(`result: subtype=${subtype || "unknown"} is_error=${isError ? "true" : "false"}`));
+            if (errors.length > 0)
+                console.log(pc.red(`errors: ${errors.join(" | ")}`));
+        }
+        return;
+    }
+    if (type === "turn.failed") {
+        const usage = asRecord(parsed.usage);
+        const input = asNumber(usage?.input_tokens);
+        const output = asNumber(usage?.output_tokens);
+        const cached = asNumber(usage?.cached_input_tokens, asNumber(usage?.cache_read_input_tokens));
+        const message = errorText(parsed.error ?? parsed.message);
+        console.log(pc.red(`turn failed${message ? `: ${message}` : ""}`));
+        console.log(pc.blue(`tokens: in=${input} out=${output} cached=${cached}`));
+        return;
+    }
+    if (type === "error") {
+        const message = errorText(parsed.message ?? parsed.error ?? parsed);
+        if (message)
+            console.log(pc.red(`error: ${message}`));
+        return;
+    }
+    console.log(line);
+}
+//# sourceMappingURL=format-event.js.map

package/dist/cli/format-event.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export { printCodexStreamEvent } from "./format-event.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,2 @@
+export { printCodexStreamEvent } from "./format-event.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cli/quota-probe.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=quota-probe.d.ts.map

package/dist/cli/quota-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-probe.d.ts","sourceRoot":"","sources":["../../src/cli/quota-probe.ts"],"names":[],"mappings":""}

package/dist/cli/quota-probe.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import { fetchCodexQuota, fetchCodexRpcQuota, getQuotaWindows, readCodexAuthInfo, readCodexToken, } from "../server/quota.js";
+function parseArgs(argv) {
+    return {
+        json: argv.includes("--json"),
+        rpcOnly: argv.includes("--rpc-only"),
+        whamOnly: argv.includes("--wham-only"),
+    };
+}
+function stringifyError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.rpcOnly && args.whamOnly) {
+        throw new Error("Choose either --rpc-only or --wham-only, not both.");
+    }
+    const auth = await readCodexAuthInfo();
+    const token = await readCodexToken();
+    const result = {
+        timestamp: new Date().toISOString(),
+        auth,
+        tokenAvailable: token != null,
+    };
+    if (!args.whamOnly) {
+        try {
+            result.rpc = {
+                ok: true,
+                ...(await fetchCodexRpcQuota()),
+            };
+        }
+        catch (error) {
+            result.rpc = {
+                ok: false,
+                error: stringifyError(error),
+                windows: [],
+            };
+        }
+    }
+    if (!args.rpcOnly) {
+        if (!token) {
+            result.wham = {
+                ok: false,
+                error: "No local Codex auth token found in ~/.codex/auth.json.",
+                windows: [],
+            };
+        }
+        else {
+            try {
+                result.wham = {
+                    ok: true,
+                    windows: await fetchCodexQuota(token.token, token.accountId),
+                };
+            }
+            catch (error) {
+                result.wham = {
+                    ok: false,
+                    error: stringifyError(error),
+                    windows: [],
+                };
+            }
+        }
+    }
+    if (!args.rpcOnly && !args.whamOnly) {
+        try {
+            result.aggregated = await getQuotaWindows();
+        }
+        catch (error) {
+            result.aggregated = {
+                ok: false,
+                error: stringifyError(error),
+            };
+        }
+    }
+    const rpcOk = result.rpc?.ok === true;
+    const whamOk = result.wham?.ok === true;
+    const aggregatedOk = result.aggregated?.ok === true;
+    const ok = rpcOk || whamOk || aggregatedOk;
+    if (args.json || process.stdout.isTTY === false) {
+        console.log(JSON.stringify({ ok, ...result }, null, 2));
+    }
+    else {
+        console.log(`timestamp: ${result.timestamp}`);
+        console.log(`auth: ${JSON.stringify(auth)}`);
+        console.log(`tokenAvailable: ${token != null}`);
+        if (result.rpc)
+            console.log(`rpc: ${JSON.stringify(result.rpc, null, 2)}`);
+        if (result.wham)
+            console.log(`wham: ${JSON.stringify(result.wham, null, 2)}`);
+        if (result.aggregated)
+            console.log(`aggregated: ${JSON.stringify(result.aggregated, null, 2)}`);
+    }
+    if (!ok)
+        process.exitCode = 1;
+}
+await main();
+//# sourceMappingURL=quota-probe.js.map

package/dist/cli/quota-probe.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { AdapterModelProfileDefinition } from "@paperclipai/adapter-utils";
+export declare const type = "codex_remote";
+export declare const label = "Codex (remote)";
+export declare const SANDBOX_INSTALL_COMMAND = "npm install -g @openai/codex";
+export declare const DEFAULT_CODEX_REMOTE_MODEL = "gpt-5.3-codex";
+export declare const DEFAULT_CODEX_REMOTE_BYPASS_APPROVALS_AND_SANDBOX = true;
+export declare const CODEX_REMOTE_FAST_MODE_SUPPORTED_MODELS: readonly ["gpt-5.4"];
+export declare function isCodexRemoteKnownModel(model: string | null | undefined): boolean;
+export declare function isCodexRemoteManualModel(model: string | null | undefined): boolean;
+export declare function isCodexRemoteFastModeSupported(model: string | null | undefined): boolean;
+export declare const models: {
+    id: string;
+    label: string;
+}[];
+export declare const modelProfiles: AdapterModelProfileDefinition[];
+export declare const agentConfigurationDoc = "# codex_remote agent configuration\n\nAdapter: codex_remote\n\nCore fields:\n- cwd (string, optional): default absolute working directory fallback for the agent process (created if missing when possible)\n- instructionsFilePath (string, optional): absolute path to a markdown instructions file prepended to stdin prompt at runtime\n- model (string, optional): Codex model id\n- modelReasoningEffort (string, optional): reasoning effort override (minimal|low|medium|high|xhigh) passed via -c model_reasoning_effort=...\n- promptTemplate (string, optional): run prompt template\n- search (boolean, optional): run codex with --search\n- fastMode (boolean, optional): enable Codex Fast mode; supported on GPT-5.4 and passed through for manual model IDs\n- dangerouslyBypassApprovalsAndSandbox (boolean, optional): run with bypass flag\n- command (string, optional): defaults to \"codex\"\n- extraArgs (string[], optional): additional CLI args\n- env (object, optional): KEY=VALUE environment variables\n- workspaceStrategy (object, optional): execution workspace strategy; currently supports { type: \"git_worktree\", baseRef?, branchTemplate?, worktreeParentDir? }\n- workspaceRuntime (object, optional): reserved for workspace runtime metadata; workspace runtime services are manually controlled from the workspace UI and are not auto-started by heartbeats\n\nOperational fields:\n- timeoutSec (number, optional): run timeout in seconds\n- graceSec (number, optional): SIGTERM grace period in seconds\n\nNotes:\n- Prompts are piped via stdin (Codex receives \"-\" prompt argument).\n- If instructionsFilePath is configured, Paperclip prepends that file's contents to the stdin prompt on every run.\n- Codex exec automatically applies repo-scoped AGENTS.md instructions from the active workspace. Paperclip cannot suppress that discovery in exec mode, so repo AGENTS.md files may still apply even when you only configured an explicit instructionsFilePath.\n- Paperclip injects desired local skills into the effective CODEX_HOME/skills/ directory at execution time so Codex can discover \"$paperclip\" and related skills without polluting the project working directory. In managed-home mode (the default) this is ~/.paperclip/instances/<id>/companies/<companyId>/codex-home/skills/; when CODEX_HOME is explicitly overridden in adapter config, that override is used instead.\n- Unless explicitly overridden in adapter config, Paperclip runs Codex with a per-company managed CODEX_HOME under the active Paperclip instance and seeds auth/config from the shared Codex home (the CODEX_HOME env var, when set, or ~/.codex).\n- Some model/tool combinations reject certain effort levels (for example minimal with web search enabled).\n- Fast mode is supported on GPT-5.4 and manual model IDs. When enabled for those models, Paperclip applies `service_tier=\"fast\"` and `features.fast_mode=true`.\n- When Paperclip realizes a workspace/runtime for a run, it injects PAPERCLIP_WORKSPACE_* and PAPERCLIP_RUNTIME_* env vars for agent-side tooling.\n";
+//# 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,KAAK,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEhF,eAAO,MAAM,IAAI,iBAAiB,CAAC;AACnC,eAAO,MAAM,KAAK,mBAAmB,CAAC;AAEtC,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAEtE,eAAO,MAAM,0BAA0B,kBAAkB,CAAC;AAC1D,eAAO,MAAM,iDAAiD,OAAO,CAAC;AACtE,eAAO,MAAM,uCAAuC,sBAAuB,CAAC;AAM5E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAIjF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGlF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAMxF;AAED,eAAO,MAAM,MAAM;;;GAWlB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,6BAA6B,EAYxD,CAAC;AAEF,eAAO,MAAM,qBAAqB,+9FAgCjC,CAAC"}

package/dist/index.js

@@ -0,0 +1,84 @@
+export const type = "codex_remote";
+export const label = "Codex (remote)";
+export const SANDBOX_INSTALL_COMMAND = "npm install -g @openai/codex";
+export const DEFAULT_CODEX_REMOTE_MODEL = "gpt-5.3-codex";
+export const DEFAULT_CODEX_REMOTE_BYPASS_APPROVALS_AND_SANDBOX = true;
+export const CODEX_REMOTE_FAST_MODE_SUPPORTED_MODELS = ["gpt-5.4"];
+function normalizeModelId(model) {
+    return typeof model === "string" ? model.trim() : "";
+}
+export function isCodexRemoteKnownModel(model) {
+    const normalizedModel = normalizeModelId(model);
+    if (!normalizedModel)
+        return false;
+    return models.some((entry) => entry.id === normalizedModel);
+}
+export function isCodexRemoteManualModel(model) {
+    const normalizedModel = normalizeModelId(model);
+    return Boolean(normalizedModel) && !isCodexRemoteKnownModel(normalizedModel);
+}
+export function isCodexRemoteFastModeSupported(model) {
+    if (isCodexRemoteManualModel(model))
+        return true;
+    const normalizedModel = typeof model === "string" ? model.trim() : "";
+    return CODEX_REMOTE_FAST_MODE_SUPPORTED_MODELS.includes(normalizedModel);
+}
+export const models = [
+    { id: "gpt-5.4", label: "gpt-5.4" },
+    { id: DEFAULT_CODEX_REMOTE_MODEL, label: DEFAULT_CODEX_REMOTE_MODEL },
+    { id: "gpt-5.3-codex-spark", label: "gpt-5.3-codex-spark" },
+    { id: "gpt-5", label: "gpt-5" },
+    { id: "o3", label: "o3" },
+    { id: "o4-mini", label: "o4-mini" },
+    { id: "gpt-5-mini", label: "gpt-5-mini" },
+    { id: "gpt-5-nano", label: "gpt-5-nano" },
+    { id: "o3-mini", label: "o3-mini" },
+    { id: "codex-mini-latest", label: "Codex Mini" },
+];
+export const modelProfiles = [
+    {
+        key: "cheap",
+        label: "Cheap",
+        description: "Use the lowest-cost known Codex local model lane without changing the primary model.",
+        adapterConfig: {
+            model: "gpt-5.3-codex-spark",
+            // Spark is the cheap lane by model price; high effort keeps Codex coding behavior usable for delegated work.
+            modelReasoningEffort: "high",
+        },
+        source: "adapter_default",
+    },
+];
+export const agentConfigurationDoc = `# codex_remote agent configuration
+
+Adapter: codex_remote
+
+Core fields:
+- cwd (string, optional): default absolute working directory fallback for the agent process (created if missing when possible)
+- instructionsFilePath (string, optional): absolute path to a markdown instructions file prepended to stdin prompt at runtime
+- model (string, optional): Codex model id
+- modelReasoningEffort (string, optional): reasoning effort override (minimal|low|medium|high|xhigh) passed via -c model_reasoning_effort=...
+- promptTemplate (string, optional): run prompt template
+- search (boolean, optional): run codex with --search
+- fastMode (boolean, optional): enable Codex Fast mode; supported on GPT-5.4 and passed through for manual model IDs
+- dangerouslyBypassApprovalsAndSandbox (boolean, optional): run with bypass flag
+- command (string, optional): defaults to "codex"
+- extraArgs (string[], optional): additional CLI args
+- env (object, optional): KEY=VALUE environment variables
+- workspaceStrategy (object, optional): execution workspace strategy; currently supports { type: "git_worktree", baseRef?, branchTemplate?, worktreeParentDir? }
+- workspaceRuntime (object, optional): reserved for workspace runtime metadata; workspace runtime services are manually controlled from the workspace UI and are not auto-started by heartbeats
+
+Operational fields:
+- timeoutSec (number, optional): run timeout in seconds
+- graceSec (number, optional): SIGTERM grace period in seconds
+
+Notes:
+- Prompts are piped via stdin (Codex receives "-" prompt argument).
+- If instructionsFilePath is configured, Paperclip prepends that file's contents to the stdin prompt on every run.
+- Codex exec automatically applies repo-scoped AGENTS.md instructions from the active workspace. Paperclip cannot suppress that discovery in exec mode, so repo AGENTS.md files may still apply even when you only configured an explicit instructionsFilePath.
+- Paperclip injects desired local skills into the effective CODEX_HOME/skills/ directory at execution time so Codex can discover "$paperclip" and related skills without polluting the project working directory. In managed-home mode (the default) this is ~/.paperclip/instances/<id>/companies/<companyId>/codex-home/skills/; when CODEX_HOME is explicitly overridden in adapter config, that override is used instead.
+- Unless explicitly overridden in adapter config, Paperclip runs Codex with a per-company managed CODEX_HOME under the active Paperclip instance and seeds auth/config from the shared Codex home (the CODEX_HOME env var, when set, or ~/.codex).
+- Some model/tool combinations reject certain effort levels (for example minimal with web search enabled).
+- Fast mode is supported on GPT-5.4 and manual model IDs. When enabled for those models, Paperclip applies \`service_tier="fast"\` and \`features.fast_mode=true\`.
+- When Paperclip realizes a workspace/runtime for a run, it injects PAPERCLIP_WORKSPACE_* and PAPERCLIP_RUNTIME_* env vars for agent-side tooling.
+`;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,IAAI,GAAG,cAAc,CAAC;AACnC,MAAM,CAAC,MAAM,KAAK,GAAG,gBAAgB,CAAC;AAEtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAEtE,MAAM,CAAC,MAAM,0BAA0B,GAAG,eAAe,CAAC;AAC1D,MAAM,CAAC,MAAM,iDAAiD,GAAG,IAAI,CAAC;AACtE,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,SAAS,CAAU,CAAC;AAE5E,SAAS,gBAAgB,CAAC,KAAgC;IACxD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAgC;IACtE,MAAM,eAAe,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAgC;IACvE,MAAM,eAAe,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAgC;IAC7E,IAAI,wBAAwB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,eAAe,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,OAAO,uCAAuC,CAAC,QAAQ,CACrD,eAA2E,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACnC,EAAE,EAAE,EAAE,0BAA0B,EAAE,KAAK,EAAE,0BAA0B,EAAE;IACrE,EAAE,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE;IAC3D,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAC/B,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;IACzB,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACnC,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IACzC,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IACzC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACnC,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,YAAY,EAAE;CACjD,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAoC;IAC5D;QACE,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,sFAAsF;QACnG,aAAa,EAAE;YACb,KAAK,EAAE,qBAAqB;YAC5B,6GAA6G;YAC7G,oBAAoB,EAAE,MAAM;SAC7B;QACD,MAAM,EAAE,iBAAiB;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCpC,CAAC"}

package/dist/server/adapter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * External adapter entry point.
+ *
+ * Paperclip's adapter-plugin store loads an external adapter package by
+ * importing its main entry and calling `createServerAdapter()`, which must
+ * return a complete `ServerAdapterModule`. This module assembles the
+ * standalone codex_remote adapter from the package's own building blocks plus
+ * the sandbox preflight / remote-default behavior that previously lived in a
+ * host-side registry wrapper — so nothing needs to change in upstream
+ * Paperclip to register this adapter.
+ */
+import { type ServerAdapterModule } from "@paperclipai/adapter-utils";
+export declare const CODEX_REMOTE_TYPE = "codex_remote";
+export declare function applyCodexRemoteDefaults(config: Record<string, unknown>): Record<string, unknown>;
+export declare function createServerAdapter(): ServerAdapterModule;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/server/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/server/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AAapC,eAAO,MAAM,iBAAiB,iBAAO,CAAC;AAyCtC,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYjG;AA2FD,wBAAgB,mBAAmB,IAAI,mBAAmB,CAwBzD"}