@parall/codex-agent 1.18.0

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@parall/codex-agent",
+  "version": "1.18.0",
+  "description": "Codex CLI bridge runtime for self-hosted Parall agents",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/parall-hq/parall-mono",
+    "directory": "ts/codex-agent"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "parall-codex-agent": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@parall/agent-core": "1.18.0",
+    "@parall/cli": "1.18.0",
+    "@parall/sdk": "1.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "start": "node dist/index.js",
+    "test": "pnpm run build && node --test test/*.test.mjs"
+  }
+}

package/src/config.ts

@@ -0,0 +1,118 @@
+import * as os from "node:os";
+import * as path from "node:path";
+
+export type CodexAgentConfig = {
+  apiUrl: string;
+  apiKey: string;
+  orgId: string;
+  wsUrl?: string;
+  swimlaneName?: string;
+  codexBin: string;
+  codexHome: string;
+  stateDir: string;
+  workspaceDir: string;
+  model?: string;
+  reasoningEffort?: string;
+  sandbox: string;
+  approvalPolicy: string;
+  runtimeKey?: string;
+};
+
+function requireEnv(env: NodeJS.ProcessEnv, name: string): string {
+  const value = env[name]?.trim();
+  if (!value) {
+    throw new Error(`Missing required env var: ${name}`);
+  }
+  return value;
+}
+
+function resolvePath(value: string): string {
+  return path.isAbsolute(value) ? value : path.resolve(process.cwd(), value);
+}
+
+export function resolveCodexAgentConfig(env: NodeJS.ProcessEnv = process.env): CodexAgentConfig {
+  const apiUrl = requireEnv(env, "PRLL_API_URL");
+  const apiKey = requireEnv(env, "PRLL_API_KEY");
+  const orgId = requireEnv(env, "PRLL_ORG_ID");
+  const codexHome = resolvePath(
+    env.PRLL_CODEX_HOME?.trim()
+      || env.CODEX_HOME?.trim()
+      || env.HOME
+      || os.homedir(),
+  );
+  const stateDir = resolvePath(env.PRLL_CODEX_STATE_DIR?.trim() || path.join(codexHome, ".parall-agent"));
+  const workspaceDir = resolvePath(env.PRLL_CODEX_WORKSPACE_DIR?.trim() || path.join(stateDir, "workspace"));
+
+  return {
+    apiUrl,
+    apiKey,
+    orgId,
+    wsUrl: env.PRLL_WS_URL?.trim() || undefined,
+    swimlaneName: env.PRLL_SWIMLANE_NAME?.trim() || undefined,
+    codexBin: env.PRLL_CODEX_BIN?.trim() || "codex",
+    codexHome,
+    stateDir,
+    workspaceDir,
+    model: env.PRLL_CODEX_MODEL?.trim() || undefined,
+    reasoningEffort: env.PRLL_CODEX_REASONING_EFFORT?.trim() || undefined,
+    sandbox: env.PRLL_CODEX_SANDBOX?.trim() || "workspace-write",
+    approvalPolicy: env.PRLL_CODEX_APPROVAL?.trim() || "never",
+    runtimeKey: env.PRLL_CODEX_RUNTIME_KEY?.trim() || undefined,
+  };
+}
+
+/**
+ * Normalise a sandbox value (CLI docs use kebab-case like `workspace-write`,
+ * but the app-server JSON-RPC protocol uses camelCase like `workspaceWrite`).
+ * Accept both forms and emit the canonical protocol form.
+ */
+export function normalizeSandbox(value: string): string {
+  const map: Record<string, string> = {
+    "workspace-write": "workspaceWrite",
+    "workspacewrite": "workspaceWrite",
+    "danger-full-access": "dangerFullAccess",
+    "dangerfullaccess": "dangerFullAccess",
+    "read-only": "readOnly",
+    "readonly": "readOnly",
+  };
+  return map[value.toLowerCase()] ?? value;
+}
+
+/**
+ * Normalise an approval policy string to the camelCase form the app-server
+ * JSON-RPC protocol uses (`never` / `onRequest` / `unlessTrusted`).
+ */
+export function normalizeApprovalPolicy(value: string): string {
+  const map: Record<string, string> = {
+    "never": "never",
+    "on-request": "onRequest",
+    "onrequest": "onRequest",
+    "unless-trusted": "unlessTrusted",
+    "unlesstrusted": "unlessTrusted",
+    "on-failure": "onFailure",
+    "onfailure": "onFailure",
+  };
+  return map[value.toLowerCase()] ?? value;
+}
+
+export function resolveWsUrl(apiUrl: string, explicitWsUrl?: string, swimlaneName?: string): string {
+  const base = explicitWsUrl || `${apiUrl.replace(/\/$/, "").replace(/^http/, "ws")}/ws`;
+  if (!swimlaneName) return base;
+  const url = new URL(base);
+  url.searchParams.set("swimlane", swimlaneName);
+  return url.toString();
+}
+
+export function buildCodexRuntimeKey(agentUserId: string): string {
+  return `agent:main:codex:${agentUserId}:orchestrator`;
+}
+
+export function sessionStateFilePathForRuntime(stateDir: string, runtimeKey: string): string {
+  const fileName = Buffer.from(runtimeKey).toString("base64url");
+  return path.join(stateDir, "threads", `${fileName}.json`);
+}
+
+export function stepIdFilePathForSession(stateDir: string, sessionKey: string): string {
+  const fileName = Buffer.from(sessionKey).toString("base64url");
+  return path.join(stateDir, "step-ids", `${fileName}.txt`);
+}