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

package/dist/chunk-YJYVA7CY.js

@@ -0,0 +1,99 @@
+// src/index.ts
+var type = "codex_remote";
+var label = "Codex (remote)";
+var SANDBOX_INSTALL_COMMAND = "npm install -g @openai/codex";
+var DEFAULT_CODEX_REMOTE_MODEL = "gpt-5.3-codex";
+var DEFAULT_CODEX_REMOTE_BYPASS_APPROVALS_AND_SANDBOX = true;
+var CODEX_REMOTE_FAST_MODE_SUPPORTED_MODELS = ["gpt-5.4"];
+function normalizeModelId(model) {
+  return typeof model === "string" ? model.trim() : "";
+}
+function isCodexRemoteKnownModel(model) {
+  const normalizedModel = normalizeModelId(model);
+  if (!normalizedModel) return false;
+  return models.some((entry) => entry.id === normalizedModel);
+}
+function isCodexRemoteManualModel(model) {
+  const normalizedModel = normalizeModelId(model);
+  return Boolean(normalizedModel) && !isCodexRemoteKnownModel(normalizedModel);
+}
+function isCodexRemoteFastModeSupported(model) {
+  if (isCodexRemoteManualModel(model)) return true;
+  const normalizedModel = typeof model === "string" ? model.trim() : "";
+  return CODEX_REMOTE_FAST_MODE_SUPPORTED_MODELS.includes(
+    normalizedModel
+  );
+}
+var 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" }
+];
+var 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"
+  }
+];
+var 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.
+`;
+
+export {
+  type,
+  label,
+  SANDBOX_INSTALL_COMMAND,
+  DEFAULT_CODEX_REMOTE_MODEL,
+  DEFAULT_CODEX_REMOTE_BYPASS_APPROVALS_AND_SANDBOX,
+  CODEX_REMOTE_FAST_MODE_SUPPORTED_MODELS,
+  isCodexRemoteKnownModel,
+  isCodexRemoteManualModel,
+  isCodexRemoteFastModeSupported,
+  models,
+  modelProfiles,
+  agentConfigurationDoc
+};