@code-yeongyu/senpi 2026.6.21 → 2026.6.28-4

package/dist/core/extensions/builtin/pi-codex-app-server/capability-negotiator.d.ts

@@ -0,0 +1,42 @@
+import { type AdapterJsonRpcError } from "./error-mapper.ts";
+import { PI_CODEX_APP_SERVER_PROTOCOL_VERSION } from "./protocol-core.ts";
+export type NegotiatedCapabilityFlag = "semantic-events" | "opaque-notifications" | "opaque-callbacks" | "realtime" | "filesystem" | "app-plugin-config" | "app-server-experimental-api" | "app-server-attestation" | "app-server-mcp-form-elicitation";
+export interface ExternalInitializeCapabilities {
+    readonly protocolVersion: typeof PI_CODEX_APP_SERVER_PROTOCOL_VERSION;
+    readonly semanticEvents: boolean;
+    readonly opaqueNotifications: boolean;
+    readonly opaqueCallbacks: boolean;
+    readonly realtime: boolean;
+    readonly filesystem: boolean;
+    readonly appPluginConfig: boolean;
+    readonly notificationOptOuts: readonly string[];
+}
+export interface AppServerInitializeCapabilities {
+    readonly experimentalApi?: boolean;
+    readonly requestAttestation?: boolean;
+    readonly mcpServerOpenaiFormElicitation?: boolean;
+    readonly optOutNotificationMethods?: readonly string[] | null;
+}
+export interface CapabilityNegotiationInput {
+    readonly external: ExternalInitializeCapabilities;
+    readonly appServer?: AppServerInitializeCapabilities;
+}
+export type CapabilityNegotiationResult = CapabilityNegotiationAccepted | CapabilityNegotiationRejected;
+export interface CapabilityNegotiationAccepted {
+    readonly kind: "accepted";
+    readonly protocolVersion: typeof PI_CODEX_APP_SERVER_PROTOCOL_VERSION;
+    readonly capabilityFlags: readonly NegotiatedCapabilityFlag[];
+    readonly notificationOptOuts: readonly string[];
+    readonly error?: undefined;
+}
+export interface CapabilityNegotiationRejected {
+    readonly kind: "rejected";
+    readonly error: AdapterJsonRpcError;
+}
+export declare class ExternalInitializeCapabilitiesError extends Error {
+    readonly adapterCode: "malformed-message" | "unsupported-protocol-version" | "unsupported-notification-opt-out";
+    constructor(message: string, adapterCode: "malformed-message" | "unsupported-protocol-version" | "unsupported-notification-opt-out");
+}
+export declare function parseExternalInitializeCapabilities(input: unknown): ExternalInitializeCapabilities;
+export declare function negotiatePiCodexAppServerCapabilities(input: CapabilityNegotiationInput): CapabilityNegotiationResult;
+//# sourceMappingURL=capability-negotiator.d.ts.map

package/dist/core/extensions/builtin/pi-codex-app-server/capability-negotiator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-negotiator.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/capability-negotiator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAA6B,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,oCAAoC,EAAE,MAAM,oBAAoB,CAAC;AAG1E,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,UAAU,GACV,YAAY,GACZ,mBAAmB,GACnB,6BAA6B,GAC7B,wBAAwB,GACxB,iCAAiC,CAAC;AAErC,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,eAAe,EAAE,OAAO,oCAAoC,CAAC;IACtE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,OAAO,CAAC;IAClD,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,+BAA+B,CAAC;CACrD;AAED,MAAM,MAAM,2BAA2B,GAAG,6BAA6B,GAAG,6BAA6B,CAAC;AAExG,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,OAAO,oCAAoC,CAAC;IACtE,QAAQ,CAAC,eAAe,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC9D,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CACpC;AAID,qBAAa,mCAAoC,SAAQ,KAAK;IAC7D,QAAQ,CAAC,WAAW,EAAE,mBAAmB,GAAG,8BAA8B,GAAG,kCAAkC,CAAC;IAEhH,YACC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,mBAAmB,GAAG,8BAA8B,GAAG,kCAAkC,EAKtG;CACD;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,CA4BlG;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,0BAA0B,GAAG,2BAA2B,CAmBpH"}

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

@@ -0,0 +1,130 @@
+import { createAdapterJsonRpcError } from "./error-mapper.js";
+import { PI_CODEX_APP_SERVER_PROTOCOL_VERSION } from "./protocol-core.js";
+import { PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES } from "./protocol-required-surfaces.js";
+const notificationSurfaceNames = new Set(PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES);
+export class ExternalInitializeCapabilitiesError extends Error {
+    constructor(message, adapterCode) {
+        super(message);
+        this.name = "ExternalInitializeCapabilitiesError";
+        this.adapterCode = adapterCode;
+    }
+}
+export function parseExternalInitializeCapabilities(input) {
+    if (!isRecord(input)) {
+        throw new ExternalInitializeCapabilitiesError("Initialize params must be an object.", "malformed-message");
+    }
+    const protocolVersion = input.protocolVersion;
+    if (protocolVersion !== PI_CODEX_APP_SERVER_PROTOCOL_VERSION) {
+        throw new ExternalInitializeCapabilitiesError(`Unsupported pi-codex-app-server protocol version: ${String(protocolVersion)}`, "unsupported-protocol-version");
+    }
+    const capabilities = input.capabilities;
+    if (!isRecord(capabilities)) {
+        throw new ExternalInitializeCapabilitiesError("Initialize capabilities must be an object.", "malformed-message");
+    }
+    const notificationOptOuts = parseNotificationOptOuts(capabilities.notificationOptOuts);
+    return {
+        protocolVersion,
+        semanticEvents: readRequiredBoolean(capabilities, "semanticEvents"),
+        opaqueNotifications: readRequiredBoolean(capabilities, "opaqueNotifications"),
+        opaqueCallbacks: readRequiredBoolean(capabilities, "opaqueCallbacks"),
+        realtime: readOptionalBoolean(capabilities, "realtime"),
+        filesystem: readOptionalBoolean(capabilities, "filesystem"),
+        appPluginConfig: readOptionalBoolean(capabilities, "appPluginConfig"),
+        notificationOptOuts,
+    };
+}
+export function negotiatePiCodexAppServerCapabilities(input) {
+    const missingRequiredCapabilities = findMissingRequiredCapabilities(input.external);
+    if (missingRequiredCapabilities.length > 0) {
+        return {
+            kind: "rejected",
+            error: createAdapterJsonRpcError({
+                adapterCode: "incompatible-capabilities",
+                message: "External client is incompatible with pi-codex-app-server.",
+                details: missingRequiredCapabilities,
+            }),
+        };
+    }
+    return {
+        kind: "accepted",
+        protocolVersion: input.external.protocolVersion,
+        capabilityFlags: buildCapabilityFlags(input.external, input.appServer),
+        notificationOptOuts: mapNotificationOptOuts(input.external, input.appServer),
+    };
+}
+function findMissingRequiredCapabilities(external) {
+    const missing = [];
+    if (!external.opaqueNotifications) {
+        missing.push("opaqueNotifications is required so app-server notifications are never silently dropped");
+    }
+    if (!external.opaqueCallbacks) {
+        missing.push("opaqueCallbacks is required because app-server server requests are control flow");
+    }
+    return missing;
+}
+function buildCapabilityFlags(external, appServer) {
+    const flags = [];
+    if (external.semanticEvents)
+        flags.push("semantic-events");
+    if (external.opaqueNotifications)
+        flags.push("opaque-notifications");
+    if (external.opaqueCallbacks)
+        flags.push("opaque-callbacks");
+    if (external.realtime)
+        flags.push("realtime");
+    if (external.filesystem)
+        flags.push("filesystem");
+    if (external.appPluginConfig)
+        flags.push("app-plugin-config");
+    if (appServer?.experimentalApi)
+        flags.push("app-server-experimental-api");
+    if (appServer?.requestAttestation)
+        flags.push("app-server-attestation");
+    if (appServer?.mcpServerOpenaiFormElicitation)
+        flags.push("app-server-mcp-form-elicitation");
+    return flags;
+}
+function mapNotificationOptOuts(external, appServer) {
+    const appServerOptOuts = new Set(appServer?.optOutNotificationMethods ?? []);
+    if (appServerOptOuts.size === 0)
+        return [];
+    return external.notificationOptOuts.filter((method) => appServerOptOuts.has(method));
+}
+function parseNotificationOptOuts(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        throw new ExternalInitializeCapabilitiesError("notificationOptOuts must be an array.", "malformed-message");
+    }
+    const optOuts = [];
+    for (const method of value) {
+        if (typeof method !== "string") {
+            throw new ExternalInitializeCapabilitiesError("notificationOptOuts entries must be strings.", "malformed-message");
+        }
+        if (!notificationSurfaceNames.has(method)) {
+            throw new ExternalInitializeCapabilitiesError(`Unknown app-server notification opt-out: ${method}`, "unsupported-notification-opt-out");
+        }
+        optOuts.push(method);
+    }
+    return optOuts;
+}
+function readRequiredBoolean(input, key) {
+    const value = input[key];
+    if (typeof value !== "boolean") {
+        throw new ExternalInitializeCapabilitiesError(`${key} must be a boolean.`, "malformed-message");
+    }
+    return value;
+}
+function readOptionalBoolean(input, key) {
+    const value = input[key];
+    if (value === undefined)
+        return false;
+    if (typeof value !== "boolean") {
+        throw new ExternalInitializeCapabilitiesError(`${key} must be a boolean.`, "malformed-message");
+    }
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=capability-negotiator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-negotiator.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/capability-negotiator.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AdapterJsonRpcError, createAdapterJsonRpcError } from \"./error-mapper.ts\";\nimport { PI_CODEX_APP_SERVER_PROTOCOL_VERSION } from \"./protocol-core.ts\";\nimport { PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES } from \"./protocol-required-surfaces.ts\";\n\nexport type NegotiatedCapabilityFlag =\n\t| \"semantic-events\"\n\t| \"opaque-notifications\"\n\t| \"opaque-callbacks\"\n\t| \"realtime\"\n\t| \"filesystem\"\n\t| \"app-plugin-config\"\n\t| \"app-server-experimental-api\"\n\t| \"app-server-attestation\"\n\t| \"app-server-mcp-form-elicitation\";\n\nexport interface ExternalInitializeCapabilities {\n\treadonly protocolVersion: typeof PI_CODEX_APP_SERVER_PROTOCOL_VERSION;\n\treadonly semanticEvents: boolean;\n\treadonly opaqueNotifications: boolean;\n\treadonly opaqueCallbacks: boolean;\n\treadonly realtime: boolean;\n\treadonly filesystem: boolean;\n\treadonly appPluginConfig: boolean;\n\treadonly notificationOptOuts: readonly string[];\n}\n\nexport interface AppServerInitializeCapabilities {\n\treadonly experimentalApi?: boolean;\n\treadonly requestAttestation?: boolean;\n\treadonly mcpServerOpenaiFormElicitation?: boolean;\n\treadonly optOutNotificationMethods?: readonly string[] | null;\n}\n\nexport interface CapabilityNegotiationInput {\n\treadonly external: ExternalInitializeCapabilities;\n\treadonly appServer?: AppServerInitializeCapabilities;\n}\n\nexport type CapabilityNegotiationResult = CapabilityNegotiationAccepted | CapabilityNegotiationRejected;\n\nexport interface CapabilityNegotiationAccepted {\n\treadonly kind: \"accepted\";\n\treadonly protocolVersion: typeof PI_CODEX_APP_SERVER_PROTOCOL_VERSION;\n\treadonly capabilityFlags: readonly NegotiatedCapabilityFlag[];\n\treadonly notificationOptOuts: readonly string[];\n\treadonly error?: undefined;\n}\n\nexport interface CapabilityNegotiationRejected {\n\treadonly kind: \"rejected\";\n\treadonly error: AdapterJsonRpcError;\n}\n\nconst notificationSurfaceNames = new Set<string>(PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES);\n\nexport class ExternalInitializeCapabilitiesError extends Error {\n\treadonly adapterCode: \"malformed-message\" | \"unsupported-protocol-version\" | \"unsupported-notification-opt-out\";\n\n\tconstructor(\n\t\tmessage: string,\n\t\tadapterCode: \"malformed-message\" | \"unsupported-protocol-version\" | \"unsupported-notification-opt-out\",\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"ExternalInitializeCapabilitiesError\";\n\t\tthis.adapterCode = adapterCode;\n\t}\n}\n\nexport function parseExternalInitializeCapabilities(input: unknown): ExternalInitializeCapabilities {\n\tif (!isRecord(input)) {\n\t\tthrow new ExternalInitializeCapabilitiesError(\"Initialize params must be an object.\", \"malformed-message\");\n\t}\n\tconst protocolVersion = input.protocolVersion;\n\tif (protocolVersion !== PI_CODEX_APP_SERVER_PROTOCOL_VERSION) {\n\t\tthrow new ExternalInitializeCapabilitiesError(\n\t\t\t`Unsupported pi-codex-app-server protocol version: ${String(protocolVersion)}`,\n\t\t\t\"unsupported-protocol-version\",\n\t\t);\n\t}\n\n\tconst capabilities = input.capabilities;\n\tif (!isRecord(capabilities)) {\n\t\tthrow new ExternalInitializeCapabilitiesError(\"Initialize capabilities must be an object.\", \"malformed-message\");\n\t}\n\n\tconst notificationOptOuts = parseNotificationOptOuts(capabilities.notificationOptOuts);\n\treturn {\n\t\tprotocolVersion,\n\t\tsemanticEvents: readRequiredBoolean(capabilities, \"semanticEvents\"),\n\t\topaqueNotifications: readRequiredBoolean(capabilities, \"opaqueNotifications\"),\n\t\topaqueCallbacks: readRequiredBoolean(capabilities, \"opaqueCallbacks\"),\n\t\trealtime: readOptionalBoolean(capabilities, \"realtime\"),\n\t\tfilesystem: readOptionalBoolean(capabilities, \"filesystem\"),\n\t\tappPluginConfig: readOptionalBoolean(capabilities, \"appPluginConfig\"),\n\t\tnotificationOptOuts,\n\t};\n}\n\nexport function negotiatePiCodexAppServerCapabilities(input: CapabilityNegotiationInput): CapabilityNegotiationResult {\n\tconst missingRequiredCapabilities = findMissingRequiredCapabilities(input.external);\n\tif (missingRequiredCapabilities.length > 0) {\n\t\treturn {\n\t\t\tkind: \"rejected\",\n\t\t\terror: createAdapterJsonRpcError({\n\t\t\t\tadapterCode: \"incompatible-capabilities\",\n\t\t\t\tmessage: \"External client is incompatible with pi-codex-app-server.\",\n\t\t\t\tdetails: missingRequiredCapabilities,\n\t\t\t}),\n\t\t};\n\t}\n\n\treturn {\n\t\tkind: \"accepted\",\n\t\tprotocolVersion: input.external.protocolVersion,\n\t\tcapabilityFlags: buildCapabilityFlags(input.external, input.appServer),\n\t\tnotificationOptOuts: mapNotificationOptOuts(input.external, input.appServer),\n\t};\n}\n\nfunction findMissingRequiredCapabilities(external: ExternalInitializeCapabilities): readonly string[] {\n\tconst missing: string[] = [];\n\tif (!external.opaqueNotifications) {\n\t\tmissing.push(\"opaqueNotifications is required so app-server notifications are never silently dropped\");\n\t}\n\tif (!external.opaqueCallbacks) {\n\t\tmissing.push(\"opaqueCallbacks is required because app-server server requests are control flow\");\n\t}\n\treturn missing;\n}\n\nfunction buildCapabilityFlags(\n\texternal: ExternalInitializeCapabilities,\n\tappServer: AppServerInitializeCapabilities | undefined,\n): readonly NegotiatedCapabilityFlag[] {\n\tconst flags: NegotiatedCapabilityFlag[] = [];\n\tif (external.semanticEvents) flags.push(\"semantic-events\");\n\tif (external.opaqueNotifications) flags.push(\"opaque-notifications\");\n\tif (external.opaqueCallbacks) flags.push(\"opaque-callbacks\");\n\tif (external.realtime) flags.push(\"realtime\");\n\tif (external.filesystem) flags.push(\"filesystem\");\n\tif (external.appPluginConfig) flags.push(\"app-plugin-config\");\n\tif (appServer?.experimentalApi) flags.push(\"app-server-experimental-api\");\n\tif (appServer?.requestAttestation) flags.push(\"app-server-attestation\");\n\tif (appServer?.mcpServerOpenaiFormElicitation) flags.push(\"app-server-mcp-form-elicitation\");\n\treturn flags;\n}\n\nfunction mapNotificationOptOuts(\n\texternal: ExternalInitializeCapabilities,\n\tappServer: AppServerInitializeCapabilities | undefined,\n): readonly string[] {\n\tconst appServerOptOuts = new Set<string>(appServer?.optOutNotificationMethods ?? []);\n\tif (appServerOptOuts.size === 0) return [];\n\treturn external.notificationOptOuts.filter((method) => appServerOptOuts.has(method));\n}\n\nfunction parseNotificationOptOuts(value: unknown): readonly string[] {\n\tif (value === undefined) return [];\n\tif (!Array.isArray(value)) {\n\t\tthrow new ExternalInitializeCapabilitiesError(\"notificationOptOuts must be an array.\", \"malformed-message\");\n\t}\n\tconst optOuts: string[] = [];\n\tfor (const method of value) {\n\t\tif (typeof method !== \"string\") {\n\t\t\tthrow new ExternalInitializeCapabilitiesError(\n\t\t\t\t\"notificationOptOuts entries must be strings.\",\n\t\t\t\t\"malformed-message\",\n\t\t\t);\n\t\t}\n\t\tif (!notificationSurfaceNames.has(method)) {\n\t\t\tthrow new ExternalInitializeCapabilitiesError(\n\t\t\t\t`Unknown app-server notification opt-out: ${method}`,\n\t\t\t\t\"unsupported-notification-opt-out\",\n\t\t\t);\n\t\t}\n\t\toptOuts.push(method);\n\t}\n\treturn optOuts;\n}\n\nfunction readRequiredBoolean(input: Readonly<Record<string, unknown>>, key: string): boolean {\n\tconst value = input[key];\n\tif (typeof value !== \"boolean\") {\n\t\tthrow new ExternalInitializeCapabilitiesError(`${key} must be a boolean.`, \"malformed-message\");\n\t}\n\treturn value;\n}\n\nfunction readOptionalBoolean(input: Readonly<Record<string, unknown>>, key: string): boolean {\n\tconst value = input[key];\n\tif (value === undefined) return false;\n\tif (typeof value !== \"boolean\") {\n\t\tthrow new ExternalInitializeCapabilitiesError(`${key} must be a boolean.`, \"malformed-message\");\n\t}\n\treturn value;\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/core/extensions/builtin/pi-codex-app-server/error-mapper.d.ts

@@ -0,0 +1,27 @@
+export declare const ADAPTER_ERROR_SOURCE = "pi-codex-app-server";
+export declare const ADAPTER_JSON_RPC_ERROR_CODE = -32080;
+export type AdapterErrorCode = "duplicate-routing-id" | "invalid-callback-state" | "incompatible-capabilities" | "invalid-session-state" | "malformed-message" | "unsupported-routing-method" | "unsupported-protocol-version" | "unsupported-notification-opt-out";
+export interface AdapterJsonRpcError {
+    readonly code: typeof ADAPTER_JSON_RPC_ERROR_CODE;
+    readonly message: string;
+    readonly data: {
+        readonly source: typeof ADAPTER_ERROR_SOURCE;
+        readonly adapterCode: AdapterErrorCode;
+        readonly details: readonly string[];
+        readonly retryable: boolean;
+    };
+}
+export interface AppServerJsonRpcError {
+    readonly code: number;
+    readonly message: string;
+    readonly data?: unknown;
+}
+export interface AdapterJsonRpcErrorInput {
+    readonly adapterCode: AdapterErrorCode;
+    readonly message: string;
+    readonly details?: readonly string[];
+    readonly retryable?: boolean;
+}
+export declare function createAdapterJsonRpcError(input: AdapterJsonRpcErrorInput): AdapterJsonRpcError;
+export declare function preserveAppServerJsonRpcError(error: AppServerJsonRpcError): AppServerJsonRpcError;
+//# sourceMappingURL=error-mapper.d.ts.map

package/dist/core/extensions/builtin/pi-codex-app-server/error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/error-mapper.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,MAAM,MAAM,gBAAgB,GACzB,sBAAsB,GACtB,wBAAwB,GACxB,2BAA2B,GAC3B,uBAAuB,GACvB,mBAAmB,GACnB,4BAA4B,GAC5B,8BAA8B,GAC9B,kCAAkC,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,2BAA2B,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE;QACd,QAAQ,CAAC,MAAM,EAAE,OAAO,oBAAoB,CAAC;QAC7C,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;QACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;KAC5B,CAAC;CACF;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB,GAAG,mBAAmB,CAW9F;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB,CAEjG"}

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

@@ -0,0 +1,18 @@
+export const ADAPTER_ERROR_SOURCE = "pi-codex-app-server";
+export const ADAPTER_JSON_RPC_ERROR_CODE = -32080;
+export function createAdapterJsonRpcError(input) {
+    return {
+        code: ADAPTER_JSON_RPC_ERROR_CODE,
+        message: input.message,
+        data: {
+            source: ADAPTER_ERROR_SOURCE,
+            adapterCode: input.adapterCode,
+            details: input.details ?? [],
+            retryable: input.retryable ?? false,
+        },
+    };
+}
+export function preserveAppServerJsonRpcError(error) {
+    return error;
+}
+//# sourceMappingURL=error-mapper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/error-mapper.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,KAAK,CAAC;AAoClD,MAAM,UAAU,yBAAyB,CAAC,KAA+B;IACxE,OAAO;QACN,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE;YACL,MAAM,EAAE,oBAAoB;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK;SACnC;KACD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAA4B;IACzE,OAAO,KAAK,CAAC;AACd,CAAC","sourcesContent":["export const ADAPTER_ERROR_SOURCE = \"pi-codex-app-server\";\nexport const ADAPTER_JSON_RPC_ERROR_CODE = -32080;\n\nexport type AdapterErrorCode =\n\t| \"duplicate-routing-id\"\n\t| \"invalid-callback-state\"\n\t| \"incompatible-capabilities\"\n\t| \"invalid-session-state\"\n\t| \"malformed-message\"\n\t| \"unsupported-routing-method\"\n\t| \"unsupported-protocol-version\"\n\t| \"unsupported-notification-opt-out\";\n\nexport interface AdapterJsonRpcError {\n\treadonly code: typeof ADAPTER_JSON_RPC_ERROR_CODE;\n\treadonly message: string;\n\treadonly data: {\n\t\treadonly source: typeof ADAPTER_ERROR_SOURCE;\n\t\treadonly adapterCode: AdapterErrorCode;\n\t\treadonly details: readonly string[];\n\t\treadonly retryable: boolean;\n\t};\n}\n\nexport interface AppServerJsonRpcError {\n\treadonly code: number;\n\treadonly message: string;\n\treadonly data?: unknown;\n}\n\nexport interface AdapterJsonRpcErrorInput {\n\treadonly adapterCode: AdapterErrorCode;\n\treadonly message: string;\n\treadonly details?: readonly string[];\n\treadonly retryable?: boolean;\n}\n\nexport function createAdapterJsonRpcError(input: AdapterJsonRpcErrorInput): AdapterJsonRpcError {\n\treturn {\n\t\tcode: ADAPTER_JSON_RPC_ERROR_CODE,\n\t\tmessage: input.message,\n\t\tdata: {\n\t\t\tsource: ADAPTER_ERROR_SOURCE,\n\t\t\tadapterCode: input.adapterCode,\n\t\t\tdetails: input.details ?? [],\n\t\t\tretryable: input.retryable ?? false,\n\t\t},\n\t};\n}\n\nexport function preserveAppServerJsonRpcError(error: AppServerJsonRpcError): AppServerJsonRpcError {\n\treturn error;\n}\n"]}

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

@@ -0,0 +1,25 @@
+import type { ExtensionAPI, ExtensionContext, SessionShutdownEvent, SessionStartEvent } from "../../types.ts";
+import { type PiCodexAppServerRuntimeController } from "./transport-runtime.ts";
+export declare const PI_CODEX_APP_SERVER_COMMAND = "pi-codex-app-server";
+export declare const PI_CODEX_APP_SERVER_FLAG_ENABLED = "pi-codex-app-server";
+export declare const PI_CODEX_APP_SERVER_FLAG_MODE = "pi-codex-app-server-mode";
+export declare const PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND = "pi-codex-app-server-command";
+export declare const PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS = "pi-codex-app-server-args";
+export declare const PI_CODEX_APP_SERVER_FLAG_URL = "pi-codex-app-server-url";
+export declare const PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET = "pi-codex-app-server-unix-socket";
+export declare const PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS = "pi-codex-app-server-timeout-ms";
+interface RuntimeExtensionContext {
+    readonly hasUI: boolean;
+    readonly ui: Pick<ExtensionContext["ui"], "notify">;
+}
+type RuntimeLifecycleHandler<E> = (event: E, ctx: RuntimeExtensionContext) => Promise<void> | void;
+export interface PiCodexAppServerExtensionApi {
+    readonly registerCommand: ExtensionAPI["registerCommand"];
+    readonly registerFlag: ExtensionAPI["registerFlag"];
+    readonly getFlag: ExtensionAPI["getFlag"];
+    on(event: "session_start", handler: RuntimeLifecycleHandler<SessionStartEvent>): void;
+    on(event: "session_shutdown", handler: RuntimeLifecycleHandler<SessionShutdownEvent>): void;
+}
+export declare function registerPiCodexAppServerExtension(pi: PiCodexAppServerExtensionApi, createRuntime?: () => PiCodexAppServerRuntimeController): void;
+export {};
+//# sourceMappingURL=extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE9G,OAAO,EAEN,KAAK,iCAAiC,EAGtC,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,gCAAgC,wBAAwB,CAAC;AACtE,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AACxE,eAAO,MAAM,2CAA2C,gCAAgC,CAAC;AACzF,eAAO,MAAM,wCAAwC,6BAA6B,CAAC;AACnF,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,oCAAoC,oCAAoC,CAAC;AACtF,eAAO,MAAM,mCAAmC,mCAAmC,CAAC;AAWpF,UAAU,uBAAuB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;CACpD;AACD,KAAK,uBAAuB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEnG,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAC1D,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1C,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IACtF,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,uBAAuB,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;CAC5F;AAED,wBAAgB,iCAAiC,CAChD,EAAE,EAAE,4BAA4B,EAChC,aAAa,GAAE,MAAM,iCAAiE,GACpF,IAAI,CAoDN"}

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

@@ -0,0 +1,110 @@
+import { PI_CODEX_APP_SERVER_PROTOCOL_VERSION } from "./protocol-core.js";
+import { createPiCodexAppServerRuntime, } from "./transport-runtime.js";
+export const PI_CODEX_APP_SERVER_COMMAND = "pi-codex-app-server";
+export const PI_CODEX_APP_SERVER_FLAG_ENABLED = "pi-codex-app-server";
+export const PI_CODEX_APP_SERVER_FLAG_MODE = "pi-codex-app-server-mode";
+export const PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND = "pi-codex-app-server-command";
+export const PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS = "pi-codex-app-server-args";
+export const PI_CODEX_APP_SERVER_FLAG_URL = "pi-codex-app-server-url";
+export const PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET = "pi-codex-app-server-unix-socket";
+export const PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS = "pi-codex-app-server-timeout-ms";
+const DEFAULT_TRANSPORT_MODE = "stdio";
+const DEFAULT_APP_SERVER_COMMAND = "codex";
+const DEFAULT_APP_SERVER_ARGS = "app-server";
+const DEFAULT_TIMEOUT_MS = "5000";
+const RUNTIME_NOTICE_PREFIX = [
+    "pi-codex-app-server PR-004 runtime",
+    `Protocol contract: ${PI_CODEX_APP_SERVER_PROTOCOL_VERSION}`,
+].join("\n");
+export function registerPiCodexAppServerExtension(pi, createRuntime = createPiCodexAppServerRuntime) {
+    const runtime = createRuntime();
+    pi.registerFlag(PI_CODEX_APP_SERVER_FLAG_ENABLED, {
+        type: "boolean",
+        default: false,
+        description: "Enable pi-codex-app-server runtime transport during session lifecycle.",
+    });
+    pi.registerFlag(PI_CODEX_APP_SERVER_FLAG_MODE, {
+        type: "string",
+        default: DEFAULT_TRANSPORT_MODE,
+        description: "Select the pi-codex-app-server transport mode: stdio, websocket, or unix.",
+    });
+    pi.registerFlag(PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND, {
+        type: "string",
+        default: DEFAULT_APP_SERVER_COMMAND,
+        description: "Codex app-server command for stdio or unix proxy transport.",
+    });
+    pi.registerFlag(PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS, {
+        type: "string",
+        default: DEFAULT_APP_SERVER_ARGS,
+        description: "Codex app-server command arguments for stdio transport.",
+    });
+    pi.registerFlag(PI_CODEX_APP_SERVER_FLAG_URL, {
+        type: "string",
+        default: "",
+        description: "Remote websocket URL for websocket transport.",
+    });
+    pi.registerFlag(PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET, {
+        type: "string",
+        default: "",
+        description: "Unix socket path for app-server proxy transport.",
+    });
+    pi.registerFlag(PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS, {
+        type: "string",
+        default: DEFAULT_TIMEOUT_MS,
+        description: "Runtime transport setup timeout in milliseconds.",
+    });
+    pi.registerCommand(PI_CODEX_APP_SERVER_COMMAND, {
+        description: "Inspect the Codex app-server adapter runtime status",
+        handler: async (_args, ctx) => {
+            notifyIfVisible(ctx, `${RUNTIME_NOTICE_PREFIX}\nStatus: ${runtime.getStatus().kind}`);
+        },
+    });
+    pi.on("session_start", async (_event, ctx) => {
+        const flags = readRuntimeFlags(pi);
+        const status = await runtime.start(flags);
+        notifyIfVisible(ctx, `${RUNTIME_NOTICE_PREFIX}\nStatus: ${status.kind}`);
+    });
+    pi.on("session_shutdown", async (_event, ctx) => {
+        const status = await runtime.stop();
+        notifyIfVisible(ctx, `${RUNTIME_NOTICE_PREFIX}\nStatus: ${status.kind}`);
+    });
+}
+function notifyIfVisible(ctx, message) {
+    if (!ctx.hasUI)
+        return;
+    ctx.ui.notify(message, "info");
+}
+function readRuntimeFlags(pi) {
+    return {
+        enabled: pi.getFlag(PI_CODEX_APP_SERVER_FLAG_ENABLED) === true,
+        mode: readTransportMode(pi),
+        appServerCommand: readStringFlag(pi, PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND, DEFAULT_APP_SERVER_COMMAND),
+        appServerArgs: readArgsFlag(pi, PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS),
+        appServerUrl: readStringFlag(pi, PI_CODEX_APP_SERVER_FLAG_URL, ""),
+        appServerSocketPath: readStringFlag(pi, PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET, ""),
+        connectTimeoutMs: readPositiveIntegerFlag(pi, PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS, Number(DEFAULT_TIMEOUT_MS)),
+    };
+}
+function readTransportMode(pi) {
+    const mode = pi.getFlag(PI_CODEX_APP_SERVER_FLAG_MODE);
+    if (mode === "websocket" || mode === "unix")
+        return mode;
+    return "stdio";
+}
+function readStringFlag(pi, name, fallback) {
+    const value = pi.getFlag(name);
+    return typeof value === "string" ? value : fallback;
+}
+function readArgsFlag(pi, name) {
+    return readStringFlag(pi, name, DEFAULT_APP_SERVER_ARGS)
+        .split(" ")
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+}
+function readPositiveIntegerFlag(pi, name, fallback) {
+    const value = Number(readStringFlag(pi, name, String(fallback)));
+    if (Number.isInteger(value) && value > 0)
+        return value;
+    return fallback;
+}
+//# sourceMappingURL=extension.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/extension.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oCAAoC,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EACN,6BAA6B,GAI7B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AACjE,MAAM,CAAC,MAAM,gCAAgC,GAAG,qBAAqB,CAAC;AACtE,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AACxE,MAAM,CAAC,MAAM,2CAA2C,GAAG,6BAA6B,CAAC;AACzF,MAAM,CAAC,MAAM,wCAAwC,GAAG,0BAA0B,CAAC;AACnF,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,MAAM,CAAC,MAAM,oCAAoC,GAAG,iCAAiC,CAAC;AACtF,MAAM,CAAC,MAAM,mCAAmC,GAAG,gCAAgC,CAAC;AAEpF,MAAM,sBAAsB,GAAG,OAAO,CAAC;AACvC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAC3C,MAAM,uBAAuB,GAAG,YAAY,CAAC;AAC7C,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,qBAAqB,GAAG;IAC7B,oCAAoC;IACpC,sBAAsB,oCAAoC,EAAE;CAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAgBb,MAAM,UAAU,iCAAiC,CAChD,EAAgC,EAChC,aAAa,GAA4C,6BAA6B;IAEtF,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,EAAE,CAAC,YAAY,CAAC,gCAAgC,EAAE;QACjD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,wEAAwE;KACrF,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,6BAA6B,EAAE;QAC9C,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,sBAAsB;QAC/B,WAAW,EAAE,2EAA2E;KACxF,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,2CAA2C,EAAE;QAC5D,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,6DAA6D;KAC1E,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,wCAAwC,EAAE;QACzD,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,uBAAuB;QAChC,WAAW,EAAE,yDAAyD;KACtE,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,4BAA4B,EAAE;QAC7C,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,+CAA+C;KAC5D,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,oCAAoC,EAAE;QACrD,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,kDAAkD;KAC/D,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,mCAAmC,EAAE;QACpD,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,kDAAkD;KAC/D,CAAC,CAAC;IACH,EAAE,CAAC,eAAe,CAAC,2BAA2B,EAAE;QAC/C,WAAW,EAAE,qDAAqD;QAClE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7B,eAAe,CAAC,GAAG,EAAE,GAAG,qBAAqB,aAAa,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACvF,CAAC;KACD,CAAC,CAAC;IACH,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,eAAe,CAAC,GAAG,EAAE,GAAG,qBAAqB,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACpC,eAAe,CAAC,GAAG,EAAE,GAAG,qBAAqB,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAA4B,EAAE,OAAe;IACrE,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,OAAO;IACvB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAgC;IACzD,OAAO;QACN,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,gCAAgC,CAAC,KAAK,IAAI;QAC9D,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAC3B,gBAAgB,EAAE,cAAc,CAAC,EAAE,EAAE,2CAA2C,EAAE,0BAA0B,CAAC;QAC7G,aAAa,EAAE,YAAY,CAAC,EAAE,EAAE,wCAAwC,CAAC;QACzE,YAAY,EAAE,cAAc,CAAC,EAAE,EAAE,4BAA4B,EAAE,EAAE,CAAC;QAClE,mBAAmB,EAAE,cAAc,CAAC,EAAE,EAAE,oCAAoC,EAAE,EAAE,CAAC;QACjF,gBAAgB,EAAE,uBAAuB,CAAC,EAAE,EAAE,mCAAmC,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC;KAC9G,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAgC;IAC1D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACvD,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,EAAgC,EAAE,IAAY,EAAE,QAAgB;IACvF,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CAAC,EAAgC,EAAE,IAAY;IACnE,OAAO,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC;SACtD,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,uBAAuB,CAAC,EAAgC,EAAE,IAAY,EAAE,QAAgB;IAChG,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACvD,OAAO,QAAQ,CAAC;AACjB,CAAC","sourcesContent":["import type { ExtensionAPI, ExtensionContext, SessionShutdownEvent, SessionStartEvent } from \"../../types.ts\";\nimport { PI_CODEX_APP_SERVER_PROTOCOL_VERSION } from \"./protocol-core.ts\";\nimport {\n\tcreatePiCodexAppServerRuntime,\n\ttype PiCodexAppServerRuntimeController,\n\ttype PiCodexAppServerRuntimeFlags,\n\ttype PiCodexAppServerTransportMode,\n} from \"./transport-runtime.ts\";\n\nexport const PI_CODEX_APP_SERVER_COMMAND = \"pi-codex-app-server\";\nexport const PI_CODEX_APP_SERVER_FLAG_ENABLED = \"pi-codex-app-server\";\nexport const PI_CODEX_APP_SERVER_FLAG_MODE = \"pi-codex-app-server-mode\";\nexport const PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND = \"pi-codex-app-server-command\";\nexport const PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS = \"pi-codex-app-server-args\";\nexport const PI_CODEX_APP_SERVER_FLAG_URL = \"pi-codex-app-server-url\";\nexport const PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET = \"pi-codex-app-server-unix-socket\";\nexport const PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS = \"pi-codex-app-server-timeout-ms\";\n\nconst DEFAULT_TRANSPORT_MODE = \"stdio\";\nconst DEFAULT_APP_SERVER_COMMAND = \"codex\";\nconst DEFAULT_APP_SERVER_ARGS = \"app-server\";\nconst DEFAULT_TIMEOUT_MS = \"5000\";\nconst RUNTIME_NOTICE_PREFIX = [\n\t\"pi-codex-app-server PR-004 runtime\",\n\t`Protocol contract: ${PI_CODEX_APP_SERVER_PROTOCOL_VERSION}`,\n].join(\"\\n\");\n\ninterface RuntimeExtensionContext {\n\treadonly hasUI: boolean;\n\treadonly ui: Pick<ExtensionContext[\"ui\"], \"notify\">;\n}\ntype RuntimeLifecycleHandler<E> = (event: E, ctx: RuntimeExtensionContext) => Promise<void> | void;\n\nexport interface PiCodexAppServerExtensionApi {\n\treadonly registerCommand: ExtensionAPI[\"registerCommand\"];\n\treadonly registerFlag: ExtensionAPI[\"registerFlag\"];\n\treadonly getFlag: ExtensionAPI[\"getFlag\"];\n\ton(event: \"session_start\", handler: RuntimeLifecycleHandler<SessionStartEvent>): void;\n\ton(event: \"session_shutdown\", handler: RuntimeLifecycleHandler<SessionShutdownEvent>): void;\n}\n\nexport function registerPiCodexAppServerExtension(\n\tpi: PiCodexAppServerExtensionApi,\n\tcreateRuntime: () => PiCodexAppServerRuntimeController = createPiCodexAppServerRuntime,\n): void {\n\tconst runtime = createRuntime();\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_ENABLED, {\n\t\ttype: \"boolean\",\n\t\tdefault: false,\n\t\tdescription: \"Enable pi-codex-app-server runtime transport during session lifecycle.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_MODE, {\n\t\ttype: \"string\",\n\t\tdefault: DEFAULT_TRANSPORT_MODE,\n\t\tdescription: \"Select the pi-codex-app-server transport mode: stdio, websocket, or unix.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND, {\n\t\ttype: \"string\",\n\t\tdefault: DEFAULT_APP_SERVER_COMMAND,\n\t\tdescription: \"Codex app-server command for stdio or unix proxy transport.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS, {\n\t\ttype: \"string\",\n\t\tdefault: DEFAULT_APP_SERVER_ARGS,\n\t\tdescription: \"Codex app-server command arguments for stdio transport.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_URL, {\n\t\ttype: \"string\",\n\t\tdefault: \"\",\n\t\tdescription: \"Remote websocket URL for websocket transport.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET, {\n\t\ttype: \"string\",\n\t\tdefault: \"\",\n\t\tdescription: \"Unix socket path for app-server proxy transport.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS, {\n\t\ttype: \"string\",\n\t\tdefault: DEFAULT_TIMEOUT_MS,\n\t\tdescription: \"Runtime transport setup timeout in milliseconds.\",\n\t});\n\tpi.registerCommand(PI_CODEX_APP_SERVER_COMMAND, {\n\t\tdescription: \"Inspect the Codex app-server adapter runtime status\",\n\t\thandler: async (_args, ctx) => {\n\t\t\tnotifyIfVisible(ctx, `${RUNTIME_NOTICE_PREFIX}\\nStatus: ${runtime.getStatus().kind}`);\n\t\t},\n\t});\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tconst flags = readRuntimeFlags(pi);\n\t\tconst status = await runtime.start(flags);\n\t\tnotifyIfVisible(ctx, `${RUNTIME_NOTICE_PREFIX}\\nStatus: ${status.kind}`);\n\t});\n\tpi.on(\"session_shutdown\", async (_event, ctx) => {\n\t\tconst status = await runtime.stop();\n\t\tnotifyIfVisible(ctx, `${RUNTIME_NOTICE_PREFIX}\\nStatus: ${status.kind}`);\n\t});\n}\n\nfunction notifyIfVisible(ctx: RuntimeExtensionContext, message: string): void {\n\tif (!ctx.hasUI) return;\n\tctx.ui.notify(message, \"info\");\n}\n\nfunction readRuntimeFlags(pi: PiCodexAppServerExtensionApi): PiCodexAppServerRuntimeFlags {\n\treturn {\n\t\tenabled: pi.getFlag(PI_CODEX_APP_SERVER_FLAG_ENABLED) === true,\n\t\tmode: readTransportMode(pi),\n\t\tappServerCommand: readStringFlag(pi, PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND, DEFAULT_APP_SERVER_COMMAND),\n\t\tappServerArgs: readArgsFlag(pi, PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS),\n\t\tappServerUrl: readStringFlag(pi, PI_CODEX_APP_SERVER_FLAG_URL, \"\"),\n\t\tappServerSocketPath: readStringFlag(pi, PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET, \"\"),\n\t\tconnectTimeoutMs: readPositiveIntegerFlag(pi, PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS, Number(DEFAULT_TIMEOUT_MS)),\n\t};\n}\n\nfunction readTransportMode(pi: PiCodexAppServerExtensionApi): PiCodexAppServerTransportMode {\n\tconst mode = pi.getFlag(PI_CODEX_APP_SERVER_FLAG_MODE);\n\tif (mode === \"websocket\" || mode === \"unix\") return mode;\n\treturn \"stdio\";\n}\n\nfunction readStringFlag(pi: PiCodexAppServerExtensionApi, name: string, fallback: string): string {\n\tconst value = pi.getFlag(name);\n\treturn typeof value === \"string\" ? value : fallback;\n}\n\nfunction readArgsFlag(pi: PiCodexAppServerExtensionApi, name: string): readonly string[] {\n\treturn readStringFlag(pi, name, DEFAULT_APP_SERVER_ARGS)\n\t\t.split(\" \")\n\t\t.map((part) => part.trim())\n\t\t.filter((part) => part.length > 0);\n}\n\nfunction readPositiveIntegerFlag(pi: PiCodexAppServerExtensionApi, name: string, fallback: number): number {\n\tconst value = Number(readStringFlag(pi, name, String(fallback)));\n\tif (Number.isInteger(value) && value > 0) return value;\n\treturn fallback;\n}\n"]}

package/dist/core/extensions/builtin/pi-codex-app-server/id-mapper.d.ts

@@ -0,0 +1,48 @@
+import { type AdapterJsonRpcError } from "./error-mapper.ts";
+export interface RoutedRequest {
+    readonly externalRequestId: string;
+    readonly appMethod: string;
+    readonly startedAtMs: number;
+}
+export interface RoutedTurn {
+    readonly appTurnId: string;
+    readonly appThreadId: string;
+    readonly externalTurnId?: string;
+    readonly externalMessageId?: string;
+}
+export interface RoutedItem {
+    readonly appItemId: string;
+    readonly appTurnId: string;
+    readonly appThreadId: string;
+    readonly externalItemId?: string;
+    readonly itemKind: string;
+}
+export interface RoutedServerRequest {
+    readonly appRequestId: string;
+    readonly externalCallbackId: string;
+    readonly appThreadId?: string;
+    readonly appTurnId?: string;
+    readonly appItemId?: string;
+    readonly method: string;
+}
+export interface RegistrationResult {
+    readonly kind: "registered" | "resolved";
+}
+export type IdMapperResult = RegistrationResult | {
+    readonly kind: "rejected";
+    readonly error: AdapterJsonRpcError;
+};
+export interface IdMapper {
+    registerRequest(input: RoutedRequest): IdMapperResult;
+    resolveRequest(externalRequestId: string): IdMapperResult;
+    getRequest(externalRequestId: string): RoutedRequest | undefined;
+    registerTurn(input: RoutedTurn): IdMapperResult;
+    getTurn(appTurnId: string): RoutedTurn | undefined;
+    registerItem(input: RoutedItem): IdMapperResult;
+    getItem(appItemId: string): RoutedItem | undefined;
+    registerServerRequest(input: RoutedServerRequest): IdMapperResult;
+    resolveServerRequest(appRequestId: string): IdMapperResult;
+    getServerRequest(appRequestId: string): RoutedServerRequest | undefined;
+}
+export declare function createIdMapper(nowMs?: () => number): IdMapper;
+//# sourceMappingURL=id-mapper.d.ts.map

package/dist/core/extensions/builtin/pi-codex-app-server/id-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-mapper.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/id-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAA6B,MAAM,mBAAmB,CAAC;AAExF,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;CACzC;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAErH,MAAM,WAAW,QAAQ;IACxB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAAC;IACtD,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,cAAc,CAAC;IAC1D,UAAU,CAAC,iBAAiB,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACjE,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC;IAChD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACnD,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC;IAChD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACnD,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAAC;IAClE,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAAC;IAC3D,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;CACxE;AAED,wBAAgB,cAAc,CAAC,KAAK,GAAE,MAAM,MAAiB,GAAG,QAAQ,CAEvE"}

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

@@ -0,0 +1,74 @@
+import { createAdapterJsonRpcError } from "./error-mapper.js";
+export function createIdMapper(nowMs = Date.now) {
+    return new InMemoryIdMapper(nowMs);
+}
+class InMemoryIdMapper {
+    constructor(nowMs) {
+        this.requests = new Map();
+        this.turns = new Map();
+        this.items = new Map();
+        this.serverRequests = new Map();
+        this.nowMs = nowMs;
+    }
+    registerRequest(input) {
+        if (this.requests.has(input.externalRequestId)) {
+            return rejectDuplicate(`Duplicate external request id: ${input.externalRequestId}`);
+        }
+        this.requests.set(input.externalRequestId, {
+            ...input,
+            startedAtMs: input.startedAtMs || this.nowMs(),
+        });
+        return { kind: "registered" };
+    }
+    resolveRequest(externalRequestId) {
+        this.requests.delete(externalRequestId);
+        return { kind: "resolved" };
+    }
+    getRequest(externalRequestId) {
+        return this.requests.get(externalRequestId);
+    }
+    registerTurn(input) {
+        if (this.turns.has(input.appTurnId)) {
+            return rejectDuplicate(`Duplicate app-server turn id: ${input.appTurnId}`);
+        }
+        this.turns.set(input.appTurnId, input);
+        return { kind: "registered" };
+    }
+    getTurn(appTurnId) {
+        return this.turns.get(appTurnId);
+    }
+    registerItem(input) {
+        if (this.items.has(input.appItemId)) {
+            return rejectDuplicate(`Duplicate app-server item id: ${input.appItemId}`);
+        }
+        this.items.set(input.appItemId, input);
+        return { kind: "registered" };
+    }
+    getItem(appItemId) {
+        return this.items.get(appItemId);
+    }
+    registerServerRequest(input) {
+        if (this.serverRequests.has(input.appRequestId)) {
+            return rejectDuplicate(`Duplicate app-server request id: ${input.appRequestId}`);
+        }
+        this.serverRequests.set(input.appRequestId, input);
+        return { kind: "registered" };
+    }
+    resolveServerRequest(appRequestId) {
+        this.serverRequests.delete(appRequestId);
+        return { kind: "resolved" };
+    }
+    getServerRequest(appRequestId) {
+        return this.serverRequests.get(appRequestId);
+    }
+}
+function rejectDuplicate(message) {
+    return {
+        kind: "rejected",
+        error: createAdapterJsonRpcError({
+            adapterCode: "duplicate-routing-id",
+            message,
+        }),
+    };
+}
+//# sourceMappingURL=id-mapper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id-mapper.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/id-mapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AdapterJsonRpcError, createAdapterJsonRpcError } from \"./error-mapper.ts\";\n\nexport interface RoutedRequest {\n\treadonly externalRequestId: string;\n\treadonly appMethod: string;\n\treadonly startedAtMs: number;\n}\n\nexport interface RoutedTurn {\n\treadonly appTurnId: string;\n\treadonly appThreadId: string;\n\treadonly externalTurnId?: string;\n\treadonly externalMessageId?: string;\n}\n\nexport interface RoutedItem {\n\treadonly appItemId: string;\n\treadonly appTurnId: string;\n\treadonly appThreadId: string;\n\treadonly externalItemId?: string;\n\treadonly itemKind: string;\n}\n\nexport interface RoutedServerRequest {\n\treadonly appRequestId: string;\n\treadonly externalCallbackId: string;\n\treadonly appThreadId?: string;\n\treadonly appTurnId?: string;\n\treadonly appItemId?: string;\n\treadonly method: string;\n}\n\nexport interface RegistrationResult {\n\treadonly kind: \"registered\" | \"resolved\";\n}\n\nexport type IdMapperResult = RegistrationResult | { readonly kind: \"rejected\"; readonly error: AdapterJsonRpcError };\n\nexport interface IdMapper {\n\tregisterRequest(input: RoutedRequest): IdMapperResult;\n\tresolveRequest(externalRequestId: string): IdMapperResult;\n\tgetRequest(externalRequestId: string): RoutedRequest | undefined;\n\tregisterTurn(input: RoutedTurn): IdMapperResult;\n\tgetTurn(appTurnId: string): RoutedTurn | undefined;\n\tregisterItem(input: RoutedItem): IdMapperResult;\n\tgetItem(appItemId: string): RoutedItem | undefined;\n\tregisterServerRequest(input: RoutedServerRequest): IdMapperResult;\n\tresolveServerRequest(appRequestId: string): IdMapperResult;\n\tgetServerRequest(appRequestId: string): RoutedServerRequest | undefined;\n}\n\nexport function createIdMapper(nowMs: () => number = Date.now): IdMapper {\n\treturn new InMemoryIdMapper(nowMs);\n}\n\nclass InMemoryIdMapper implements IdMapper {\n\tprivate readonly requests = new Map<string, RoutedRequest>();\n\tprivate readonly turns = new Map<string, RoutedTurn>();\n\tprivate readonly items = new Map<string, RoutedItem>();\n\tprivate readonly serverRequests = new Map<string, RoutedServerRequest>();\n\tprivate readonly nowMs: () => number;\n\n\tconstructor(nowMs: () => number) {\n\t\tthis.nowMs = nowMs;\n\t}\n\n\tregisterRequest(input: RoutedRequest): IdMapperResult {\n\t\tif (this.requests.has(input.externalRequestId)) {\n\t\t\treturn rejectDuplicate(`Duplicate external request id: ${input.externalRequestId}`);\n\t\t}\n\t\tthis.requests.set(input.externalRequestId, {\n\t\t\t...input,\n\t\t\tstartedAtMs: input.startedAtMs || this.nowMs(),\n\t\t});\n\t\treturn { kind: \"registered\" };\n\t}\n\n\tresolveRequest(externalRequestId: string): IdMapperResult {\n\t\tthis.requests.delete(externalRequestId);\n\t\treturn { kind: \"resolved\" };\n\t}\n\n\tgetRequest(externalRequestId: string): RoutedRequest | undefined {\n\t\treturn this.requests.get(externalRequestId);\n\t}\n\n\tregisterTurn(input: RoutedTurn): IdMapperResult {\n\t\tif (this.turns.has(input.appTurnId)) {\n\t\t\treturn rejectDuplicate(`Duplicate app-server turn id: ${input.appTurnId}`);\n\t\t}\n\t\tthis.turns.set(input.appTurnId, input);\n\t\treturn { kind: \"registered\" };\n\t}\n\n\tgetTurn(appTurnId: string): RoutedTurn | undefined {\n\t\treturn this.turns.get(appTurnId);\n\t}\n\n\tregisterItem(input: RoutedItem): IdMapperResult {\n\t\tif (this.items.has(input.appItemId)) {\n\t\t\treturn rejectDuplicate(`Duplicate app-server item id: ${input.appItemId}`);\n\t\t}\n\t\tthis.items.set(input.appItemId, input);\n\t\treturn { kind: \"registered\" };\n\t}\n\n\tgetItem(appItemId: string): RoutedItem | undefined {\n\t\treturn this.items.get(appItemId);\n\t}\n\n\tregisterServerRequest(input: RoutedServerRequest): IdMapperResult {\n\t\tif (this.serverRequests.has(input.appRequestId)) {\n\t\t\treturn rejectDuplicate(`Duplicate app-server request id: ${input.appRequestId}`);\n\t\t}\n\t\tthis.serverRequests.set(input.appRequestId, input);\n\t\treturn { kind: \"registered\" };\n\t}\n\n\tresolveServerRequest(appRequestId: string): IdMapperResult {\n\t\tthis.serverRequests.delete(appRequestId);\n\t\treturn { kind: \"resolved\" };\n\t}\n\n\tgetServerRequest(appRequestId: string): RoutedServerRequest | undefined {\n\t\treturn this.serverRequests.get(appRequestId);\n\t}\n}\n\nfunction rejectDuplicate(message: string): IdMapperResult {\n\treturn {\n\t\tkind: \"rejected\",\n\t\terror: createAdapterJsonRpcError({\n\t\t\tadapterCode: \"duplicate-routing-id\",\n\t\t\tmessage,\n\t\t}),\n\t};\n}\n"]}

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

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../../types.ts";
+export default function piCodexAppServerExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAExE"}

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

@@ -0,0 +1,5 @@
+import { registerPiCodexAppServerExtension } from "./extension.js";
+export default function piCodexAppServerExtension(pi) {
+    registerPiCodexAppServerExtension(pi);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAEnE,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,EAAgB;IACjE,iCAAiC,CAAC,EAAE,CAAC,CAAC;AACvC,CAAC","sourcesContent":["import type { ExtensionAPI } from \"../../types.ts\";\nimport { registerPiCodexAppServerExtension } from \"./extension.ts\";\n\nexport default function piCodexAppServerExtension(pi: ExtensionAPI): void {\n\tregisterPiCodexAppServerExtension(pi);\n}\n"]}

package/dist/core/extensions/builtin/pi-codex-app-server/item-stream-projector.d.ts

@@ -0,0 +1,29 @@
+import type { IdMapper } from "./id-mapper.ts";
+import type { StreamClass } from "./protocol-core.ts";
+export type SemanticProjectionChannel = "command" | "file" | "item" | "mcp" | "plan" | "process" | "raw-response" | "reasoning" | "reasoning-summary" | "text" | "turn";
+export type SemanticProjectionType = "completed" | "delta" | "item-completed" | "item-started" | "part-added" | "progress" | "turn-completed" | "turn-started";
+export interface ProjectItemStreamInput {
+    readonly method: string;
+    readonly params: unknown;
+    readonly sequence: number;
+    readonly externalSessionId: string | undefined;
+    readonly idMapper: IdMapper;
+}
+export interface SemanticItemStreamProjection {
+    readonly kind: "semantic";
+    readonly method: string;
+    readonly sequence: number;
+    readonly channel: SemanticProjectionChannel;
+    readonly semanticType: SemanticProjectionType;
+    readonly streamClass: StreamClass;
+    readonly externalSessionId: string | undefined;
+    readonly appThreadId: string | undefined;
+    readonly appTurnId: string | undefined;
+    readonly appItemId: string | undefined;
+    readonly delta: string | undefined;
+    readonly index: number | undefined;
+    readonly completedItem: unknown;
+    readonly originalParams: unknown;
+}
+export declare function projectItemStreamNotification(input: ProjectItemStreamInput): SemanticItemStreamProjection | undefined;
+//# sourceMappingURL=item-stream-projector.d.ts.map