@mclawnet/codex-adapter 0.1.0

package/dist/permission-mapper.d.ts

@@ -0,0 +1,52 @@
+import type { PermissionDecision, PermissionRequest } from "@mclawnet/backend-types";
+/**
+ * Three coexisting decision-wire families codex app-server speaks:
+ *  - "legacy"  → ReviewDecision  (approved/approved_for_session/denied/abort)
+ *  - "v2"     → CommandExecutionApprovalDecision / FileChangeApprovalDecision
+ *               (accept/acceptForSession/decline/cancel)
+ *  - "mcp"    → McpServerElicitationAction
+ *               ({ action: "accept" | "decline" | "cancel" })
+ *
+ * `parseApprovalRequest` returns the family so `respondToPermission` can pick
+ * the right wire without re-deriving it from a brittle method-name prefix.
+ */
+export type ApprovalWireFamily = "legacy" | "v2" | "mcp";
+export type ReviewDecisionWire = "approved" | "approved_for_session" | "denied" | "abort";
+export declare function decisionToWire(d: PermissionDecision["decision"]): ReviewDecisionWire;
+/**
+ * v2 CommandExecutionApprovalDecision / FileChangeApprovalDecision wire enum.
+ * Used by codex app-server >= 0.134 for `item/.../requestApproval` flows.
+ */
+export type V2DecisionWire = "accept" | "acceptForSession" | "decline" | "cancel";
+export declare function decisionToV2Wire(d: PermissionDecision["decision"]): V2DecisionWire;
+/**
+ * MCP elicitation action enum (RMCP CreateElicitationResult). Note: "session"
+ * scope isn't part of the MCP spec — `allow_session` degrades to "accept".
+ */
+export type McpElicitationAction = "accept" | "decline" | "cancel";
+export declare function decisionToMcpAction(d: PermissionDecision["decision"]): McpElicitationAction;
+/** @deprecated kept only for back-compat with M3.S5 test seam; prefer the
+ * wire family returned by `parseApprovalRequest`. */
+export declare function isV2ApprovalMethod(method: string): boolean;
+/**
+ * Build the wire-shaped reply body for a given decision + family.
+ *  - legacy → `{ decision: "approved" | ... }`
+ *  - v2     → `{ decision: "accept" | ... }`
+ *  - mcp    → `{ action: "accept" | ... }`
+ */
+export declare function buildApprovalReply(family: ApprovalWireFamily, decision: PermissionDecision["decision"]): Record<string, string>;
+export interface ParsedApprovalRequest {
+    req: PermissionRequest;
+    wireFamily: ApprovalWireFamily;
+}
+/**
+ * Map a codex JSON-RPC approval request to our backend-neutral
+ * PermissionRequest. Covers both legacy (`execCommandApproval`,
+ * `applyPatchApproval`) and v2 (`item/commandExecution/requestApproval`,
+ * `item/fileChange/requestApproval`) shapes, plus MCP elicitation.
+ *
+ * Returns null when the method is not a recognized approval channel — the
+ * adapter forwards such frames as raw output instead.
+ */
+export declare function parseApprovalRequest(method: string, params: unknown): ParsedApprovalRequest | null;
+//# sourceMappingURL=permission-mapper.d.ts.map

package/dist/permission-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-mapper.d.ts","sourceRoot":"","sources":["../src/permission-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAErF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,sBAAsB,GACtB,QAAQ,GACR,OAAO,CAAC;AAEZ,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,kBAAkB,CAepF;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,cAAc,CAelF;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,oBAAoB,CAc3F;AAED;qDACqD;AACrD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,iBAAiB,CAAC;IACvB,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GACd,qBAAqB,GAAG,IAAI,CA+D9B"}

package/dist/permission-mapper.js

@@ -0,0 +1,146 @@
+export function decisionToWire(d) {
+    switch (d) {
+        case "allow":
+            return "approved";
+        case "allow_session":
+            return "approved_for_session";
+        case "deny":
+            return "denied";
+        case "abort":
+            return "abort";
+        default: {
+            const _exhaustive = d;
+            return _exhaustive;
+        }
+    }
+}
+export function decisionToV2Wire(d) {
+    switch (d) {
+        case "allow":
+            return "accept";
+        case "allow_session":
+            return "acceptForSession";
+        case "deny":
+            return "decline";
+        case "abort":
+            return "cancel";
+        default: {
+            const _exhaustive = d;
+            return _exhaustive;
+        }
+    }
+}
+export function decisionToMcpAction(d) {
+    switch (d) {
+        case "allow":
+        case "allow_session":
+            return "accept";
+        case "deny":
+            return "decline";
+        case "abort":
+            return "cancel";
+        default: {
+            const _exhaustive = d;
+            return _exhaustive;
+        }
+    }
+}
+/** @deprecated kept only for back-compat with M3.S5 test seam; prefer the
+ * wire family returned by `parseApprovalRequest`. */
+export function isV2ApprovalMethod(method) {
+    return method.startsWith("item/");
+}
+/**
+ * Build the wire-shaped reply body for a given decision + family.
+ *  - legacy → `{ decision: "approved" | ... }`
+ *  - v2     → `{ decision: "accept" | ... }`
+ *  - mcp    → `{ action: "accept" | ... }`
+ */
+export function buildApprovalReply(family, decision) {
+    switch (family) {
+        case "legacy":
+            return { decision: decisionToWire(decision) };
+        case "v2":
+            return { decision: decisionToV2Wire(decision) };
+        case "mcp":
+            return { action: decisionToMcpAction(decision) };
+        default: {
+            const _exhaustive = family;
+            return _exhaustive;
+        }
+    }
+}
+/**
+ * Map a codex JSON-RPC approval request to our backend-neutral
+ * PermissionRequest. Covers both legacy (`execCommandApproval`,
+ * `applyPatchApproval`) and v2 (`item/commandExecution/requestApproval`,
+ * `item/fileChange/requestApproval`) shapes, plus MCP elicitation.
+ *
+ * Returns null when the method is not a recognized approval channel — the
+ * adapter forwards such frames as raw output instead.
+ */
+export function parseApprovalRequest(method, params) {
+    const p = (params ?? {});
+    const callId = p.callId ?? p.itemId;
+    if (!callId)
+        return null;
+    const reason = p.reason;
+    const cwd = p.cwd;
+    if (method === "execCommandApproval") {
+        return {
+            req: {
+                callId,
+                toolName: "shell",
+                input: { command: p.command, cwd },
+                meta: { backend: "codex", reason, cwd },
+            },
+            wireFamily: "legacy",
+        };
+    }
+    if (method === "item/commandExecution/requestApproval") {
+        return {
+            req: {
+                callId,
+                toolName: "shell",
+                input: { command: p.command, cwd },
+                meta: { backend: "codex", reason, cwd },
+            },
+            wireFamily: "v2",
+        };
+    }
+    if (method === "applyPatchApproval") {
+        return {
+            req: {
+                callId,
+                toolName: "apply_patch",
+                input: { fileChanges: p.fileChanges },
+                meta: { backend: "codex", reason, cwd },
+            },
+            wireFamily: "legacy",
+        };
+    }
+    if (method === "item/fileChange/requestApproval") {
+        return {
+            req: {
+                callId,
+                toolName: "apply_patch",
+                input: { fileChanges: p.fileChanges },
+                meta: { backend: "codex", reason, cwd },
+            },
+            wireFamily: "v2",
+        };
+    }
+    if (method === "mcpServer/elicitation/request") {
+        return {
+            req: {
+                callId,
+                toolName: p.serverName ?? "mcp",
+                input: { message: p.message, meta: p._meta },
+                meta: { backend: "codex", reason },
+            },
+            wireFamily: "mcp",
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=permission-mapper.js.map

package/dist/permission-mapper.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@mclawnet/codex-adapter",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mclawnet/backend-types": "0.1.0",
+    "@mclawnet/shared": "0.1.9",
+    "@mclawnet/logger": "0.1.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}