@code-yeongyu/senpi 2026.6.21 → 2026.6.30

package/dist/core/extensions/builtin/pi-codex-app-server/protocol-core.js

@@ -0,0 +1,191 @@
+import { APP_SERVER_SURFACE_INVENTORY } from "./protocol-inventory.js";
+export { APP_SERVER_SURFACE_INVENTORY } from "./protocol-inventory.js";
+export const PI_CODEX_APP_SERVER_PROTOCOL_VERSION = "2026-06-24.pr-001";
+export const EXTERNAL_PROTOCOL_METHODS = [
+    {
+        name: "initialize",
+        direction: "external-to-app",
+        streamClass: "control",
+        capabilityGate: "opaque notifications and opaque callbacks",
+        errorBehavior: "Reject incompatible clients before any app-server request is routed.",
+    },
+    {
+        name: "initialized",
+        direction: "external-to-app",
+        streamClass: "control",
+        capabilityGate: "initialize accepted",
+        errorBehavior: "Return method-order error if sent before initialize succeeds.",
+    },
+    {
+        name: "session/new",
+        direction: "external-to-app",
+        streamClass: "snapshot-authoritative",
+        capabilityGate: "thread lifecycle",
+        errorBehavior: "Pass through app-server validation errors with source metadata.",
+    },
+    {
+        name: "session/resume",
+        direction: "external-to-app",
+        streamClass: "snapshot-authoritative",
+        capabilityGate: "thread lifecycle",
+        errorBehavior: "Return explicit resume failure; never invent missing app-server IDs.",
+    },
+    {
+        name: "session/fork",
+        direction: "external-to-app",
+        streamClass: "snapshot-authoritative",
+        capabilityGate: "thread lifecycle",
+        errorBehavior: "Reject when source mapping is missing or app-server fork fails.",
+    },
+    {
+        name: "session/list",
+        direction: "external-to-app",
+        streamClass: "snapshot-authoritative",
+        capabilityGate: "thread inventory",
+        errorBehavior: "Preserve app-server cursor and error payloads.",
+    },
+    {
+        name: "session/read",
+        direction: "external-to-app",
+        streamClass: "snapshot-authoritative",
+        capabilityGate: "thread inventory",
+        errorBehavior: "Preserve app-server read errors and tombstone state.",
+    },
+    {
+        name: "session/archive",
+        direction: "external-to-app",
+        streamClass: "control",
+        capabilityGate: "thread lifecycle",
+        errorBehavior: "Pass through archive errors and tombstone only after app-server success.",
+    },
+    {
+        name: "session/delete",
+        direction: "external-to-app",
+        streamClass: "control",
+        capabilityGate: "thread lifecycle",
+        errorBehavior: "Pass through delete errors and tombstone only after app-server success.",
+    },
+    {
+        name: "session/unsubscribe",
+        direction: "external-to-app",
+        streamClass: "control",
+        capabilityGate: "thread lifecycle",
+        errorBehavior: "Propagate unsubscribe failure without deleting the thread mapping.",
+    },
+    {
+        name: "turn/start",
+        direction: "external-to-app",
+        streamClass: "lossless",
+        capabilityGate: "turn lifecycle",
+        errorBehavior: "Reject if no bound app-server thread exists.",
+    },
+    {
+        name: "turn/steer",
+        direction: "external-to-app",
+        streamClass: "lossless",
+        capabilityGate: "turn lifecycle",
+        errorBehavior: "Preserve expected app-server turn guard errors.",
+    },
+    {
+        name: "turn/interrupt",
+        direction: "external-to-app",
+        streamClass: "control",
+        capabilityGate: "turn lifecycle",
+        errorBehavior: "Completion is proven only by app-server turn/completed interrupted status.",
+    },
+    {
+        name: "callback/respond",
+        direction: "external-to-app",
+        streamClass: "lossless",
+        capabilityGate: "opaque callbacks",
+        errorBehavior: "Reject unknown, duplicate, or timed-out callback IDs explicitly.",
+    },
+    {
+        name: "callback/reject",
+        direction: "external-to-app",
+        streamClass: "lossless",
+        capabilityGate: "opaque callbacks",
+        errorBehavior: "Pass structured rejection to app-server; never auto-approve.",
+    },
+    {
+        name: "appServer/event",
+        direction: "app-to-external",
+        streamClass: "lossless",
+        capabilityGate: "opaque notifications",
+        errorBehavior: "Connection is incompatible if opaque notifications are refused.",
+    },
+    {
+        name: "appServer/request",
+        direction: "app-to-external",
+        streamClass: "lossless",
+        capabilityGate: "opaque callbacks",
+        errorBehavior: "Reject app-server callback if it cannot be delivered externally.",
+    },
+    {
+        name: "appServer/response",
+        direction: "app-to-external",
+        streamClass: "lossless",
+        capabilityGate: "opaque responses",
+        errorBehavior: "Preserve original app-server JSON-RPC code, message, and data.",
+    },
+    {
+        name: "lag",
+        direction: "app-to-external",
+        streamClass: "control",
+        capabilityGate: "stream health",
+        errorBehavior: "Emit before the next lossless event after best-effort drops.",
+    },
+    {
+        name: "disconnect",
+        direction: "app-to-external",
+        streamClass: "control",
+        capabilityGate: "transport health",
+        errorBehavior: "Surface disconnect without claiming lost deltas were replayed.",
+    },
+    {
+        name: "resume",
+        direction: "bidirectional",
+        streamClass: "snapshot-authoritative",
+        capabilityGate: "resume",
+        errorBehavior: "Rebuild from app-server snapshot plus new stream, or return explicit resume error.",
+    },
+];
+export const OPAQUE_APP_SERVER_ENVELOPE_FIELDS = [
+    { name: "protocolVersion", required: true, description: "pi-codex-app-server protocol version." },
+    { name: "connectionId", required: true, description: "External connection correlation ID." },
+    { name: "externalSessionId", required: false, description: "External session correlation ID." },
+    { name: "externalRequestId", required: false, description: "External JSON-RPC request correlation ID." },
+    { name: "externalMessageId", required: false, description: "External message correlation ID." },
+    { name: "externalCallbackId", required: false, description: "External callback correlation ID." },
+    { name: "appThreadId", required: false, description: "Authoritative app-server thread_id." },
+    { name: "appSessionId", required: false, description: "Authoritative app-server session_id." },
+    { name: "appTurnId", required: false, description: "Authoritative app-server turn_id." },
+    { name: "appItemId", required: false, description: "Authoritative app-server item_id." },
+    { name: "appRequestId", required: false, description: "Authoritative app-server RequestId or JSON-RPC id." },
+    { name: "sequence", required: true, description: "Adapter-owned per-connection ordering sequence." },
+    { name: "streamClass", required: true, description: "Lossless, best-effort, snapshot, or control classification." },
+    { name: "capabilityFlags", required: true, description: "Negotiated capability flags that allowed this relay." },
+    { name: "originalMethod", required: true, description: "Original app-server method name." },
+    { name: "originalParams", required: true, description: "Original app-server params object." },
+    { name: "redactionClass", required: true, description: "Evidence redaction class for the original payload." },
+];
+export function classifyAppServerSurface(method) {
+    const exactMatch = APP_SERVER_SURFACE_INVENTORY.find((entry) => entry.method === method);
+    if (exactMatch)
+        return exactMatch;
+    if (method.startsWith("appServer/")) {
+        return APP_SERVER_SURFACE_INVENTORY.find((entry) => entry.method === "appServer/futureMethod");
+    }
+    return undefined;
+}
+export function createReviewerEvidencePacketTemplate() {
+    return {
+        summaryFile: "summary.md records user-facing change, before/after behavior, observed result, and residual risk.",
+        commandsFile: "commands.txt records exact commands, cwd, sanitized environment choices, and exit codes.",
+        inventoryDiff: "inventory-diff.json records expected vs classified app-server surfaces and must be empty.",
+        cleanupReceipt: "cleanup-receipt.txt states: No runtime process, socket, port, tmux session, or temp dir was created by PR-001.",
+        secretSafety: "No raw secret-bearing logs, auth headers, tokens, cookies, or private credentials are allowed.",
+        residualRisks: "residual-risks.md maps deferred runtime behavior to the later PR that owns it.",
+    };
+}
+//# sourceMappingURL=protocol-core.js.map

package/dist/core/extensions/builtin/pi-codex-app-server/protocol-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-core.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/protocol-core.ts"],"names":[],"mappings":"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","sourcesContent":["import { APP_SERVER_SURFACE_INVENTORY } from \"./protocol-inventory.ts\";\nimport type { AppServerClientRequestSurface } from \"./protocol-required-surfaces.ts\";\n\nexport { APP_SERVER_SURFACE_INVENTORY } from \"./protocol-inventory.ts\";\n\nexport const PI_CODEX_APP_SERVER_PROTOCOL_VERSION = \"2026-06-24.pr-001\";\n\nexport type CoreExternalProtocolMethodName =\n\t| \"initialize\"\n\t| \"initialized\"\n\t| \"session/new\"\n\t| \"session/resume\"\n\t| \"session/fork\"\n\t| \"session/list\"\n\t| \"session/read\"\n\t| \"session/archive\"\n\t| \"session/delete\"\n\t| \"session/unsubscribe\"\n\t| \"turn/start\"\n\t| \"turn/steer\"\n\t| \"turn/interrupt\"\n\t| \"callback/respond\"\n\t| \"callback/reject\"\n\t| \"appServer/event\"\n\t| \"appServer/request\"\n\t| \"appServer/response\"\n\t| \"lag\"\n\t| \"disconnect\"\n\t| \"resume\";\nexport type ExternalProtocolMethodName = CoreExternalProtocolMethodName | AppServerClientRequestSurface;\n\nexport type StreamClass = \"lossless\" | \"best-effort\" | \"snapshot-authoritative\" | \"control\";\nexport type RelayClass = \"semantic\" | \"opaque-lossless\" | \"opaque-best-effort\" | \"snapshot-authoritative\";\nexport type SurfaceDirection = \"external-to-app\" | \"app-to-external\" | \"bidirectional\";\n\nexport interface ExternalProtocolMethod {\n\treadonly name: ExternalProtocolMethodName;\n\treadonly direction: SurfaceDirection;\n\treadonly streamClass: StreamClass;\n\treadonly capabilityGate: string;\n\treadonly errorBehavior: string;\n}\n\nexport interface OpaqueEnvelopeField {\n\treadonly name: string;\n\treadonly required: boolean;\n\treadonly description: string;\n}\n\nexport interface AppServerSurfaceInventoryEntry {\n\treadonly method: string;\n\treadonly direction: SurfaceDirection;\n\treadonly relayClass: RelayClass;\n\treadonly streamClass: StreamClass;\n\treadonly surface: string;\n\treadonly idFields: readonly string[];\n\treadonly source: string;\n}\n\nexport interface ReviewerEvidencePacketTemplate {\n\treadonly summaryFile: string;\n\treadonly commandsFile: string;\n\treadonly inventoryDiff: string;\n\treadonly cleanupReceipt: string;\n\treadonly secretSafety: string;\n\treadonly residualRisks: string;\n}\n\nexport const EXTERNAL_PROTOCOL_METHODS: readonly ExternalProtocolMethod[] = [\n\t{\n\t\tname: \"initialize\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"control\",\n\t\tcapabilityGate: \"opaque notifications and opaque callbacks\",\n\t\terrorBehavior: \"Reject incompatible clients before any app-server request is routed.\",\n\t},\n\t{\n\t\tname: \"initialized\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"control\",\n\t\tcapabilityGate: \"initialize accepted\",\n\t\terrorBehavior: \"Return method-order error if sent before initialize succeeds.\",\n\t},\n\t{\n\t\tname: \"session/new\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"snapshot-authoritative\",\n\t\tcapabilityGate: \"thread lifecycle\",\n\t\terrorBehavior: \"Pass through app-server validation errors with source metadata.\",\n\t},\n\t{\n\t\tname: \"session/resume\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"snapshot-authoritative\",\n\t\tcapabilityGate: \"thread lifecycle\",\n\t\terrorBehavior: \"Return explicit resume failure; never invent missing app-server IDs.\",\n\t},\n\t{\n\t\tname: \"session/fork\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"snapshot-authoritative\",\n\t\tcapabilityGate: \"thread lifecycle\",\n\t\terrorBehavior: \"Reject when source mapping is missing or app-server fork fails.\",\n\t},\n\t{\n\t\tname: \"session/list\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"snapshot-authoritative\",\n\t\tcapabilityGate: \"thread inventory\",\n\t\terrorBehavior: \"Preserve app-server cursor and error payloads.\",\n\t},\n\t{\n\t\tname: \"session/read\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"snapshot-authoritative\",\n\t\tcapabilityGate: \"thread inventory\",\n\t\terrorBehavior: \"Preserve app-server read errors and tombstone state.\",\n\t},\n\t{\n\t\tname: \"session/archive\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"control\",\n\t\tcapabilityGate: \"thread lifecycle\",\n\t\terrorBehavior: \"Pass through archive errors and tombstone only after app-server success.\",\n\t},\n\t{\n\t\tname: \"session/delete\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"control\",\n\t\tcapabilityGate: \"thread lifecycle\",\n\t\terrorBehavior: \"Pass through delete errors and tombstone only after app-server success.\",\n\t},\n\t{\n\t\tname: \"session/unsubscribe\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"control\",\n\t\tcapabilityGate: \"thread lifecycle\",\n\t\terrorBehavior: \"Propagate unsubscribe failure without deleting the thread mapping.\",\n\t},\n\t{\n\t\tname: \"turn/start\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"lossless\",\n\t\tcapabilityGate: \"turn lifecycle\",\n\t\terrorBehavior: \"Reject if no bound app-server thread exists.\",\n\t},\n\t{\n\t\tname: \"turn/steer\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"lossless\",\n\t\tcapabilityGate: \"turn lifecycle\",\n\t\terrorBehavior: \"Preserve expected app-server turn guard errors.\",\n\t},\n\t{\n\t\tname: \"turn/interrupt\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"control\",\n\t\tcapabilityGate: \"turn lifecycle\",\n\t\terrorBehavior: \"Completion is proven only by app-server turn/completed interrupted status.\",\n\t},\n\t{\n\t\tname: \"callback/respond\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"lossless\",\n\t\tcapabilityGate: \"opaque callbacks\",\n\t\terrorBehavior: \"Reject unknown, duplicate, or timed-out callback IDs explicitly.\",\n\t},\n\t{\n\t\tname: \"callback/reject\",\n\t\tdirection: \"external-to-app\",\n\t\tstreamClass: \"lossless\",\n\t\tcapabilityGate: \"opaque callbacks\",\n\t\terrorBehavior: \"Pass structured rejection to app-server; never auto-approve.\",\n\t},\n\t{\n\t\tname: \"appServer/event\",\n\t\tdirection: \"app-to-external\",\n\t\tstreamClass: \"lossless\",\n\t\tcapabilityGate: \"opaque notifications\",\n\t\terrorBehavior: \"Connection is incompatible if opaque notifications are refused.\",\n\t},\n\t{\n\t\tname: \"appServer/request\",\n\t\tdirection: \"app-to-external\",\n\t\tstreamClass: \"lossless\",\n\t\tcapabilityGate: \"opaque callbacks\",\n\t\terrorBehavior: \"Reject app-server callback if it cannot be delivered externally.\",\n\t},\n\t{\n\t\tname: \"appServer/response\",\n\t\tdirection: \"app-to-external\",\n\t\tstreamClass: \"lossless\",\n\t\tcapabilityGate: \"opaque responses\",\n\t\terrorBehavior: \"Preserve original app-server JSON-RPC code, message, and data.\",\n\t},\n\t{\n\t\tname: \"lag\",\n\t\tdirection: \"app-to-external\",\n\t\tstreamClass: \"control\",\n\t\tcapabilityGate: \"stream health\",\n\t\terrorBehavior: \"Emit before the next lossless event after best-effort drops.\",\n\t},\n\t{\n\t\tname: \"disconnect\",\n\t\tdirection: \"app-to-external\",\n\t\tstreamClass: \"control\",\n\t\tcapabilityGate: \"transport health\",\n\t\terrorBehavior: \"Surface disconnect without claiming lost deltas were replayed.\",\n\t},\n\t{\n\t\tname: \"resume\",\n\t\tdirection: \"bidirectional\",\n\t\tstreamClass: \"snapshot-authoritative\",\n\t\tcapabilityGate: \"resume\",\n\t\terrorBehavior: \"Rebuild from app-server snapshot plus new stream, or return explicit resume error.\",\n\t},\n];\n\nexport const OPAQUE_APP_SERVER_ENVELOPE_FIELDS: readonly OpaqueEnvelopeField[] = [\n\t{ name: \"protocolVersion\", required: true, description: \"pi-codex-app-server protocol version.\" },\n\t{ name: \"connectionId\", required: true, description: \"External connection correlation ID.\" },\n\t{ name: \"externalSessionId\", required: false, description: \"External session correlation ID.\" },\n\t{ name: \"externalRequestId\", required: false, description: \"External JSON-RPC request correlation ID.\" },\n\t{ name: \"externalMessageId\", required: false, description: \"External message correlation ID.\" },\n\t{ name: \"externalCallbackId\", required: false, description: \"External callback correlation ID.\" },\n\t{ name: \"appThreadId\", required: false, description: \"Authoritative app-server thread_id.\" },\n\t{ name: \"appSessionId\", required: false, description: \"Authoritative app-server session_id.\" },\n\t{ name: \"appTurnId\", required: false, description: \"Authoritative app-server turn_id.\" },\n\t{ name: \"appItemId\", required: false, description: \"Authoritative app-server item_id.\" },\n\t{ name: \"appRequestId\", required: false, description: \"Authoritative app-server RequestId or JSON-RPC id.\" },\n\t{ name: \"sequence\", required: true, description: \"Adapter-owned per-connection ordering sequence.\" },\n\t{ name: \"streamClass\", required: true, description: \"Lossless, best-effort, snapshot, or control classification.\" },\n\t{ name: \"capabilityFlags\", required: true, description: \"Negotiated capability flags that allowed this relay.\" },\n\t{ name: \"originalMethod\", required: true, description: \"Original app-server method name.\" },\n\t{ name: \"originalParams\", required: true, description: \"Original app-server params object.\" },\n\t{ name: \"redactionClass\", required: true, description: \"Evidence redaction class for the original payload.\" },\n];\n\nexport function classifyAppServerSurface(method: string): AppServerSurfaceInventoryEntry | undefined {\n\tconst exactMatch = APP_SERVER_SURFACE_INVENTORY.find((entry) => entry.method === method);\n\tif (exactMatch) return exactMatch;\n\tif (method.startsWith(\"appServer/\")) {\n\t\treturn APP_SERVER_SURFACE_INVENTORY.find((entry) => entry.method === \"appServer/futureMethod\");\n\t}\n\treturn undefined;\n}\n\nexport function createReviewerEvidencePacketTemplate(): ReviewerEvidencePacketTemplate {\n\treturn {\n\t\tsummaryFile: \"summary.md records user-facing change, before/after behavior, observed result, and residual risk.\",\n\t\tcommandsFile: \"commands.txt records exact commands, cwd, sanitized environment choices, and exit codes.\",\n\t\tinventoryDiff: \"inventory-diff.json records expected vs classified app-server surfaces and must be empty.\",\n\t\tcleanupReceipt:\n\t\t\t\"cleanup-receipt.txt states: No runtime process, socket, port, tmux session, or temp dir was created by PR-001.\",\n\t\tsecretSafety: \"No raw secret-bearing logs, auth headers, tokens, cookies, or private credentials are allowed.\",\n\t\tresidualRisks: \"residual-risks.md maps deferred runtime behavior to the later PR that owns it.\",\n\t};\n}\n"]}

package/dist/core/extensions/builtin/pi-codex-app-server/protocol-inventory.d.ts

@@ -0,0 +1,3 @@
+import type { AppServerSurfaceInventoryEntry } from "./protocol-core.ts";
+export declare const APP_SERVER_SURFACE_INVENTORY: readonly AppServerSurfaceInventoryEntry[];
+//# sourceMappingURL=protocol-inventory.d.ts.map

package/dist/core/extensions/builtin/pi-codex-app-server/protocol-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-inventory.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/protocol-inventory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAA6C,MAAM,oBAAoB,CAAC;AAmFpH,eAAO,MAAM,4BAA4B,EAAE,SAAS,8BAA8B,EAY/E,CAAC"}

package/dist/core/extensions/builtin/pi-codex-app-server/protocol-inventory.js

@@ -0,0 +1,103 @@
+import { PLAN_REQUIRED_APP_SERVER_SURFACES, PLAN_REQUIRED_CLIENT_REQUEST_SURFACES, PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES, PLAN_REQUIRED_SERVER_REQUEST_SURFACES, PLAN_REQUIRED_THREAD_ITEM_VARIANT_SURFACES, } from "./protocol-required-surfaces.js";
+const clientRequests = new Set(PLAN_REQUIRED_CLIENT_REQUEST_SURFACES);
+const serverRequests = new Set(PLAN_REQUIRED_SERVER_REQUEST_SURFACES);
+const serverNotifications = new Set(PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES);
+const threadItemVariants = new Set(PLAN_REQUIRED_THREAD_ITEM_VARIANT_SURFACES);
+function inferDirection(method) {
+    if (serverRequests.has(method) || serverNotifications.has(method) || threadItemVariants.has(method)) {
+        return "app-to-external";
+    }
+    if (method.startsWith("fs/") || method.startsWith("thread/realtime/") || method.startsWith("mcpServer/")) {
+        return "bidirectional";
+    }
+    return clientRequests.has(method) ? "external-to-app" : "bidirectional";
+}
+function inferStreamClass(method) {
+    if (method.includes("outputDelta") || method.includes("progress") || method.includes("appendAudio")) {
+        return "best-effort";
+    }
+    if (method.includes("/list") ||
+        method.includes("/read") ||
+        method.includes("get") ||
+        method.includes("status/read") ||
+        method.startsWith("threadItem/")) {
+        return "snapshot-authoritative";
+    }
+    if (method.includes("changed") || method.includes("updated") || method.includes("completed")) {
+        return "lossless";
+    }
+    return method.includes("start") || method.includes("stop") || method.includes("interrupt") ? "control" : "lossless";
+}
+function inferRelayClass(method, streamClass) {
+    if (method === "appServer/futureMethod")
+        return "opaque-lossless";
+    if (threadItemVariants.has(method))
+        return "snapshot-authoritative";
+    if (method.startsWith("fs/") || method.startsWith("thread/realtime/") || method.startsWith("remoteControl/")) {
+        return streamClass === "best-effort" ? "opaque-best-effort" : "opaque-lossless";
+    }
+    return "semantic";
+}
+function inferSurface(method) {
+    if (threadItemVariants.has(method))
+        return "thread item variant";
+    if (serverRequests.has(method))
+        return "server request";
+    if (serverNotifications.has(method))
+        return "server notification";
+    if (method.startsWith("thread/"))
+        return "thread lifecycle and control";
+    if (method.startsWith("turn/"))
+        return "turn lifecycle";
+    if (method.startsWith("item/") || method.startsWith("rawResponseItem/"))
+        return "item stream";
+    if (method.startsWith("fs/"))
+        return "filesystem";
+    if (method.startsWith("fuzzyFileSearch/"))
+        return "fuzzy file search";
+    if (method.startsWith("windowsSandbox/") || method.startsWith("windows/"))
+        return "windows sandbox";
+    if (method.startsWith("config") || method.startsWith("skills/") || method.startsWith("plugin/"))
+        return "configuration";
+    if (method.startsWith("experimentalFeature/"))
+        return "experimental feature";
+    if (method.startsWith("permissionProfile/"))
+        return "permission profile";
+    if (method.startsWith("collaborationMode/"))
+        return "collaboration mode";
+    if (method.startsWith("environment/"))
+        return "environment";
+    if (method.startsWith("account/"))
+        return "account";
+    if (method.startsWith("model"))
+        return "model";
+    if (method.startsWith("remoteControl/"))
+        return "remote control";
+    if (method.startsWith("mcpServer"))
+        return "mcp";
+    return "app-server compatibility";
+}
+function inferIdFields(method) {
+    if (method.startsWith("threadItem/"))
+        return ["appThreadId", "appTurnId", "appItemId"];
+    if (method.startsWith("item/"))
+        return ["appThreadId", "appTurnId", "appItemId", "appRequestId"];
+    if (method.startsWith("turn/"))
+        return ["appThreadId", "appTurnId"];
+    if (method.startsWith("thread/"))
+        return ["appThreadId", "appSessionId"];
+    return ["appRequestId"];
+}
+export const APP_SERVER_SURFACE_INVENTORY = PLAN_REQUIRED_APP_SERVER_SURFACES.map((method) => {
+    const streamClass = inferStreamClass(method);
+    return {
+        method,
+        direction: inferDirection(method),
+        relayClass: inferRelayClass(method, streamClass),
+        streamClass,
+        surface: inferSurface(method),
+        idFields: inferIdFields(method),
+        source: "codex-rs/app-server-protocol/src/protocol/common.rs current string-named surfaces",
+    };
+});
+//# sourceMappingURL=protocol-inventory.js.map

package/dist/core/extensions/builtin/pi-codex-app-server/protocol-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-inventory.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/protocol-inventory.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AppServerSurfaceInventoryEntry, RelayClass, StreamClass, SurfaceDirection } from \"./protocol-core.ts\";\nimport {\n\tPLAN_REQUIRED_APP_SERVER_SURFACES,\n\tPLAN_REQUIRED_CLIENT_REQUEST_SURFACES,\n\tPLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES,\n\tPLAN_REQUIRED_SERVER_REQUEST_SURFACES,\n\tPLAN_REQUIRED_THREAD_ITEM_VARIANT_SURFACES,\n} from \"./protocol-required-surfaces.ts\";\n\nconst clientRequests = new Set<string>(PLAN_REQUIRED_CLIENT_REQUEST_SURFACES);\nconst serverRequests = new Set<string>(PLAN_REQUIRED_SERVER_REQUEST_SURFACES);\nconst serverNotifications = new Set<string>(PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES);\nconst threadItemVariants = new Set<string>(PLAN_REQUIRED_THREAD_ITEM_VARIANT_SURFACES);\n\nfunction inferDirection(method: string): SurfaceDirection {\n\tif (serverRequests.has(method) || serverNotifications.has(method) || threadItemVariants.has(method)) {\n\t\treturn \"app-to-external\";\n\t}\n\tif (method.startsWith(\"fs/\") || method.startsWith(\"thread/realtime/\") || method.startsWith(\"mcpServer/\")) {\n\t\treturn \"bidirectional\";\n\t}\n\treturn clientRequests.has(method) ? \"external-to-app\" : \"bidirectional\";\n}\n\nfunction inferStreamClass(method: string): StreamClass {\n\tif (method.includes(\"outputDelta\") || method.includes(\"progress\") || method.includes(\"appendAudio\")) {\n\t\treturn \"best-effort\";\n\t}\n\tif (\n\t\tmethod.includes(\"/list\") ||\n\t\tmethod.includes(\"/read\") ||\n\t\tmethod.includes(\"get\") ||\n\t\tmethod.includes(\"status/read\") ||\n\t\tmethod.startsWith(\"threadItem/\")\n\t) {\n\t\treturn \"snapshot-authoritative\";\n\t}\n\tif (method.includes(\"changed\") || method.includes(\"updated\") || method.includes(\"completed\")) {\n\t\treturn \"lossless\";\n\t}\n\treturn method.includes(\"start\") || method.includes(\"stop\") || method.includes(\"interrupt\") ? \"control\" : \"lossless\";\n}\n\nfunction inferRelayClass(method: string, streamClass: StreamClass): RelayClass {\n\tif (method === \"appServer/futureMethod\") return \"opaque-lossless\";\n\tif (threadItemVariants.has(method)) return \"snapshot-authoritative\";\n\tif (method.startsWith(\"fs/\") || method.startsWith(\"thread/realtime/\") || method.startsWith(\"remoteControl/\")) {\n\t\treturn streamClass === \"best-effort\" ? \"opaque-best-effort\" : \"opaque-lossless\";\n\t}\n\treturn \"semantic\";\n}\n\nfunction inferSurface(method: string): string {\n\tif (threadItemVariants.has(method)) return \"thread item variant\";\n\tif (serverRequests.has(method)) return \"server request\";\n\tif (serverNotifications.has(method)) return \"server notification\";\n\tif (method.startsWith(\"thread/\")) return \"thread lifecycle and control\";\n\tif (method.startsWith(\"turn/\")) return \"turn lifecycle\";\n\tif (method.startsWith(\"item/\") || method.startsWith(\"rawResponseItem/\")) return \"item stream\";\n\tif (method.startsWith(\"fs/\")) return \"filesystem\";\n\tif (method.startsWith(\"fuzzyFileSearch/\")) return \"fuzzy file search\";\n\tif (method.startsWith(\"windowsSandbox/\") || method.startsWith(\"windows/\")) return \"windows sandbox\";\n\tif (method.startsWith(\"config\") || method.startsWith(\"skills/\") || method.startsWith(\"plugin/\"))\n\t\treturn \"configuration\";\n\tif (method.startsWith(\"experimentalFeature/\")) return \"experimental feature\";\n\tif (method.startsWith(\"permissionProfile/\")) return \"permission profile\";\n\tif (method.startsWith(\"collaborationMode/\")) return \"collaboration mode\";\n\tif (method.startsWith(\"environment/\")) return \"environment\";\n\tif (method.startsWith(\"account/\")) return \"account\";\n\tif (method.startsWith(\"model\")) return \"model\";\n\tif (method.startsWith(\"remoteControl/\")) return \"remote control\";\n\tif (method.startsWith(\"mcpServer\")) return \"mcp\";\n\treturn \"app-server compatibility\";\n}\n\nfunction inferIdFields(method: string): readonly string[] {\n\tif (method.startsWith(\"threadItem/\")) return [\"appThreadId\", \"appTurnId\", \"appItemId\"];\n\tif (method.startsWith(\"item/\")) return [\"appThreadId\", \"appTurnId\", \"appItemId\", \"appRequestId\"];\n\tif (method.startsWith(\"turn/\")) return [\"appThreadId\", \"appTurnId\"];\n\tif (method.startsWith(\"thread/\")) return [\"appThreadId\", \"appSessionId\"];\n\treturn [\"appRequestId\"];\n}\n\nexport const APP_SERVER_SURFACE_INVENTORY: readonly AppServerSurfaceInventoryEntry[] =\n\tPLAN_REQUIRED_APP_SERVER_SURFACES.map((method) => {\n\t\tconst streamClass = inferStreamClass(method);\n\t\treturn {\n\t\t\tmethod,\n\t\t\tdirection: inferDirection(method),\n\t\t\trelayClass: inferRelayClass(method, streamClass),\n\t\t\tstreamClass,\n\t\t\tsurface: inferSurface(method),\n\t\t\tidFields: inferIdFields(method),\n\t\t\tsource: \"codex-rs/app-server-protocol/src/protocol/common.rs current string-named surfaces\",\n\t\t};\n\t});\n"]}

package/dist/core/extensions/builtin/pi-codex-app-server/protocol-required-surfaces.d.ts

@@ -0,0 +1,7 @@
+export declare const PLAN_REQUIRED_CLIENT_REQUEST_SURFACES: readonly ["initialize", "initialized", "thread/start", "thread/resume", "thread/fork", "thread/archive", "thread/delete", "thread/unsubscribe", "thread/increment_elicitation", "thread/decrement_elicitation", "thread/name/set", "thread/goal/set", "thread/goal/get", "thread/goal/clear", "thread/metadata/update", "thread/settings/update", "thread/memoryMode/set", "memory/reset", "thread/unarchive", "thread/compact/start", "thread/shellCommand", "thread/approveGuardianDeniedAction", "thread/backgroundTerminals/clean", "thread/backgroundTerminals/list", "thread/backgroundTerminals/terminate", "thread/rollback", "thread/list", "thread/search", "thread/loaded/list", "thread/read", "thread/turns/list", "thread/turns/items/list", "thread/inject_items", "skills/list", "skills/extraRoots/set", "hooks/list", "marketplace/add", "marketplace/remove", "marketplace/upgrade", "plugin/list", "plugin/installed", "plugin/read", "plugin/skill/read", "plugin/share/save", "plugin/share/updateTargets", "plugin/share/list", "plugin/share/checkout", "plugin/share/delete", "app/list", "fs/readFile", "fs/writeFile", "fs/createDirectory", "fs/getMetadata", "fs/readDirectory", "fs/remove", "fs/copy", "fs/watch", "fs/unwatch", "skills/config/write", "plugin/install", "plugin/uninstall", "turn/start", "turn/steer", "turn/interrupt", "thread/realtime/start", "thread/realtime/appendAudio", "thread/realtime/appendText", "thread/realtime/appendSpeech", "thread/realtime/stop", "thread/realtime/listVoices", "review/start", "model/list", "modelProvider/capabilities/read", "experimentalFeature/list", "permissionProfile/list", "experimentalFeature/enablement/set", "remoteControl/enable", "remoteControl/disable", "remoteControl/status/read", "remoteControl/pairing/start", "remoteControl/pairing/status", "remoteControl/client/list", "remoteControl/client/revoke", "collaborationMode/list", "mock/experimentalMethod", "environment/add", "mcpServer/oauth/login", "config/mcpServer/reload", "mcpServerStatus/list", "mcpServer/resource/read", "mcpServer/tool/call", "windowsSandbox/setupStart", "windowsSandbox/readiness", "account/login/start", "account/login/cancel", "account/logout", "account/rateLimits/read", "account/rateLimitResetCredit/consume", "account/usage/read", "account/workspaceMessages/read", "account/sendAddCreditsNudgeEmail", "feedback/upload", "command/exec", "command/exec/write", "command/exec/terminate", "command/exec/resize", "process/spawn", "process/writeStdin", "process/kill", "process/resizePty", "config/read", "externalAgentConfig/detect", "externalAgentConfig/import", "externalAgentConfig/import/readHistories", "config/value/write", "config/batchWrite", "configRequirements/read", "account/read", "fuzzyFileSearch/sessionStart", "fuzzyFileSearch/sessionUpdate", "fuzzyFileSearch/sessionStop"];
+export type AppServerClientRequestSurface = (typeof PLAN_REQUIRED_CLIENT_REQUEST_SURFACES)[number];
+export declare const PLAN_REQUIRED_SERVER_REQUEST_SURFACES: readonly ["item/commandExecution/requestApproval", "item/fileChange/requestApproval", "item/tool/requestUserInput", "mcpServer/elicitation/request", "item/permissions/requestApproval", "item/tool/call", "account/chatgptAuthTokens/refresh", "attestation/generate", "currentTime/read", "serverRequest/legacy/applyPatchApproval", "serverRequest/legacy/execCommandApproval"];
+export declare const PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES: readonly ["error", "thread/started", "thread/status/changed", "thread/archived", "thread/deleted", "thread/unarchived", "thread/closed", "skills/changed", "thread/name/updated", "thread/goal/updated", "thread/goal/cleared", "thread/settings/updated", "thread/tokenUsage/updated", "turn/started", "hook/started", "turn/completed", "hook/completed", "turn/diff/updated", "turn/plan/updated", "item/started", "item/autoApprovalReview/started", "item/autoApprovalReview/completed", "item/completed", "rawResponseItem/completed", "item/agentMessage/delta", "item/plan/delta", "command/exec/outputDelta", "process/outputDelta", "process/exited", "item/commandExecution/outputDelta", "item/commandExecution/terminalInteraction", "item/fileChange/outputDelta", "item/fileChange/patchUpdated", "serverRequest/resolved", "item/mcpToolCall/progress", "mcpServer/oauthLogin/completed", "mcpServer/startupStatus/updated", "account/updated", "account/rateLimits/updated", "app/list/updated", "remoteControl/status/changed", "externalAgentConfig/import/progress", "externalAgentConfig/import/completed", "fs/changed", "item/reasoning/summaryTextDelta", "item/reasoning/summaryPartAdded", "item/reasoning/textDelta", "thread/compacted", "model/rerouted", "model/verification", "turn/moderationMetadata", "model/safetyBuffering/updated", "warning", "guardianWarning", "deprecationNotice", "configWarning", "thread/realtime/started", "thread/realtime/itemAdded", "thread/realtime/transcript/delta", "thread/realtime/transcript/done", "thread/realtime/outputAudio/delta", "thread/realtime/sdp", "thread/realtime/error", "thread/realtime/closed", "fuzzyFileSearch/sessionUpdated", "fuzzyFileSearch/sessionCompleted", "windows/worldWritableWarning", "windowsSandbox/setupCompleted", "account/login/completed"];
+export declare const PLAN_REQUIRED_THREAD_ITEM_VARIANT_SURFACES: readonly ["threadItem/userMessage", "threadItem/hookPrompt", "threadItem/agentMessage", "threadItem/plan", "threadItem/reasoning", "threadItem/commandExecution", "threadItem/fileChange", "threadItem/mcpToolCall", "threadItem/dynamicToolCall", "threadItem/collabAgentToolCall", "threadItem/subAgentActivity", "threadItem/webSearch", "threadItem/imageView", "threadItem/sleep", "threadItem/imageGeneration", "threadItem/reviewMode", "threadItem/contextCompaction"];
+export declare const PLAN_REQUIRED_APP_SERVER_SURFACES: readonly ["initialize", "initialized", "thread/start", "thread/resume", "thread/fork", "thread/archive", "thread/delete", "thread/unsubscribe", "thread/increment_elicitation", "thread/decrement_elicitation", "thread/name/set", "thread/goal/set", "thread/goal/get", "thread/goal/clear", "thread/metadata/update", "thread/settings/update", "thread/memoryMode/set", "memory/reset", "thread/unarchive", "thread/compact/start", "thread/shellCommand", "thread/approveGuardianDeniedAction", "thread/backgroundTerminals/clean", "thread/backgroundTerminals/list", "thread/backgroundTerminals/terminate", "thread/rollback", "thread/list", "thread/search", "thread/loaded/list", "thread/read", "thread/turns/list", "thread/turns/items/list", "thread/inject_items", "skills/list", "skills/extraRoots/set", "hooks/list", "marketplace/add", "marketplace/remove", "marketplace/upgrade", "plugin/list", "plugin/installed", "plugin/read", "plugin/skill/read", "plugin/share/save", "plugin/share/updateTargets", "plugin/share/list", "plugin/share/checkout", "plugin/share/delete", "app/list", "fs/readFile", "fs/writeFile", "fs/createDirectory", "fs/getMetadata", "fs/readDirectory", "fs/remove", "fs/copy", "fs/watch", "fs/unwatch", "skills/config/write", "plugin/install", "plugin/uninstall", "turn/start", "turn/steer", "turn/interrupt", "thread/realtime/start", "thread/realtime/appendAudio", "thread/realtime/appendText", "thread/realtime/appendSpeech", "thread/realtime/stop", "thread/realtime/listVoices", "review/start", "model/list", "modelProvider/capabilities/read", "experimentalFeature/list", "permissionProfile/list", "experimentalFeature/enablement/set", "remoteControl/enable", "remoteControl/disable", "remoteControl/status/read", "remoteControl/pairing/start", "remoteControl/pairing/status", "remoteControl/client/list", "remoteControl/client/revoke", "collaborationMode/list", "mock/experimentalMethod", "environment/add", "mcpServer/oauth/login", "config/mcpServer/reload", "mcpServerStatus/list", "mcpServer/resource/read", "mcpServer/tool/call", "windowsSandbox/setupStart", "windowsSandbox/readiness", "account/login/start", "account/login/cancel", "account/logout", "account/rateLimits/read", "account/rateLimitResetCredit/consume", "account/usage/read", "account/workspaceMessages/read", "account/sendAddCreditsNudgeEmail", "feedback/upload", "command/exec", "command/exec/write", "command/exec/terminate", "command/exec/resize", "process/spawn", "process/writeStdin", "process/kill", "process/resizePty", "config/read", "externalAgentConfig/detect", "externalAgentConfig/import", "externalAgentConfig/import/readHistories", "config/value/write", "config/batchWrite", "configRequirements/read", "account/read", "fuzzyFileSearch/sessionStart", "fuzzyFileSearch/sessionUpdate", "fuzzyFileSearch/sessionStop", "item/commandExecution/requestApproval", "item/fileChange/requestApproval", "item/tool/requestUserInput", "mcpServer/elicitation/request", "item/permissions/requestApproval", "item/tool/call", "account/chatgptAuthTokens/refresh", "attestation/generate", "currentTime/read", "serverRequest/legacy/applyPatchApproval", "serverRequest/legacy/execCommandApproval", "error", "thread/started", "thread/status/changed", "thread/archived", "thread/deleted", "thread/unarchived", "thread/closed", "skills/changed", "thread/name/updated", "thread/goal/updated", "thread/goal/cleared", "thread/settings/updated", "thread/tokenUsage/updated", "turn/started", "hook/started", "turn/completed", "hook/completed", "turn/diff/updated", "turn/plan/updated", "item/started", "item/autoApprovalReview/started", "item/autoApprovalReview/completed", "item/completed", "rawResponseItem/completed", "item/agentMessage/delta", "item/plan/delta", "command/exec/outputDelta", "process/outputDelta", "process/exited", "item/commandExecution/outputDelta", "item/commandExecution/terminalInteraction", "item/fileChange/outputDelta", "item/fileChange/patchUpdated", "serverRequest/resolved", "item/mcpToolCall/progress", "mcpServer/oauthLogin/completed", "mcpServer/startupStatus/updated", "account/updated", "account/rateLimits/updated", "app/list/updated", "remoteControl/status/changed", "externalAgentConfig/import/progress", "externalAgentConfig/import/completed", "fs/changed", "item/reasoning/summaryTextDelta", "item/reasoning/summaryPartAdded", "item/reasoning/textDelta", "thread/compacted", "model/rerouted", "model/verification", "turn/moderationMetadata", "model/safetyBuffering/updated", "warning", "guardianWarning", "deprecationNotice", "configWarning", "thread/realtime/started", "thread/realtime/itemAdded", "thread/realtime/transcript/delta", "thread/realtime/transcript/done", "thread/realtime/outputAudio/delta", "thread/realtime/sdp", "thread/realtime/error", "thread/realtime/closed", "fuzzyFileSearch/sessionUpdated", "fuzzyFileSearch/sessionCompleted", "windows/worldWritableWarning", "windowsSandbox/setupCompleted", "account/login/completed", "threadItem/userMessage", "threadItem/hookPrompt", "threadItem/agentMessage", "threadItem/plan", "threadItem/reasoning", "threadItem/commandExecution", "threadItem/fileChange", "threadItem/mcpToolCall", "threadItem/dynamicToolCall", "threadItem/collabAgentToolCall", "threadItem/subAgentActivity", "threadItem/webSearch", "threadItem/imageView", "threadItem/sleep", "threadItem/imageGeneration", "threadItem/reviewMode", "threadItem/contextCompaction", "appServer/futureMethod"];
+//# sourceMappingURL=protocol-required-surfaces.d.ts.map

package/dist/core/extensions/builtin/pi-codex-app-server/protocol-required-surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-required-surfaces.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/protocol-required-surfaces.ts"],"names":[],"mappings":"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"}