@code-yeongyu/senpi 2026.6.21 → 2026.6.28-4

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

@@ -0,0 +1 @@
+{"version":3,"file":"item-stream-projector.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/item-stream-projector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,MAAM,yBAAyB,GAClC,SAAS,GACT,MAAM,GACN,MAAM,GACN,KAAK,GACL,MAAM,GACN,SAAS,GACT,cAAc,GACd,WAAW,GACX,mBAAmB,GACnB,MAAM,GACN,MAAM,CAAC;AAEV,MAAM,MAAM,sBAAsB,GAC/B,WAAW,GACX,OAAO,GACP,gBAAgB,GAChB,cAAc,GACd,YAAY,GACZ,UAAU,GACV,gBAAgB,GAChB,cAAc,CAAC;AAElB,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CACjC;AAqCD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,sBAAsB,GAAG,4BAA4B,GAAG,SAAS,CAqCrH"}

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

@@ -0,0 +1,105 @@
+const itemProjectionShapes = {
+    "item/started": { channel: "item", semanticType: "item-started", streamClass: "lossless" },
+    "item/completed": { channel: "item", semanticType: "item-completed", streamClass: "lossless" },
+    "rawResponseItem/completed": { channel: "raw-response", semanticType: "completed", streamClass: "lossless" },
+    "item/agentMessage/delta": { channel: "text", semanticType: "delta", streamClass: "lossless" },
+    "item/plan/delta": { channel: "plan", semanticType: "delta", streamClass: "lossless" },
+    "item/reasoning/summaryTextDelta": { channel: "reasoning-summary", semanticType: "delta", streamClass: "lossless" },
+    "item/reasoning/summaryPartAdded": {
+        channel: "reasoning-summary",
+        semanticType: "part-added",
+        streamClass: "lossless",
+    },
+    "item/reasoning/textDelta": { channel: "reasoning", semanticType: "delta", streamClass: "lossless" },
+    "command/exec/outputDelta": { channel: "command", semanticType: "progress", streamClass: "best-effort" },
+    "item/commandExecution/outputDelta": { channel: "command", semanticType: "progress", streamClass: "best-effort" },
+    "item/commandExecution/terminalInteraction": {
+        channel: "command",
+        semanticType: "progress",
+        streamClass: "best-effort",
+    },
+    "process/outputDelta": { channel: "process", semanticType: "progress", streamClass: "best-effort" },
+    "process/exited": { channel: "process", semanticType: "completed", streamClass: "lossless" },
+    "item/fileChange/outputDelta": { channel: "file", semanticType: "progress", streamClass: "best-effort" },
+    "item/fileChange/patchUpdated": { channel: "file", semanticType: "progress", streamClass: "best-effort" },
+    "item/mcpToolCall/progress": { channel: "mcp", semanticType: "progress", streamClass: "best-effort" },
+    "turn/started": { channel: "turn", semanticType: "turn-started", streamClass: "lossless" },
+    "turn/completed": { channel: "turn", semanticType: "turn-completed", streamClass: "lossless" },
+};
+export function projectItemStreamNotification(input) {
+    const shape = itemProjectionShapes[input.method];
+    if (!shape)
+        return undefined;
+    const params = isRecord(input.params) ? input.params : {};
+    const appThreadId = readAppThreadId(params);
+    const appTurnId = readAppTurnId(params);
+    const completedItem = readCompletedItem(input.method, params);
+    const appItemId = readItemId(params, completedItem);
+    const delta = readString(params, "delta");
+    const index = readNumber(params, "index");
+    if (input.method === "item/started" && appThreadId && appTurnId && appItemId) {
+        registerItemIfNeeded(input.idMapper, {
+            appThreadId,
+            appTurnId,
+            appItemId,
+            itemKind: readItemKind(completedItem),
+        });
+    }
+    return {
+        kind: "semantic",
+        method: input.method,
+        sequence: input.sequence,
+        channel: shape.channel,
+        semanticType: shape.semanticType,
+        streamClass: shape.streamClass,
+        externalSessionId: input.externalSessionId,
+        appThreadId,
+        appTurnId,
+        appItemId,
+        delta,
+        index,
+        completedItem,
+        originalParams: input.params,
+    };
+}
+function registerItemIfNeeded(idMapper, input) {
+    if (idMapper.getItem(input.appItemId))
+        return;
+    idMapper.registerItem(input);
+}
+function readCompletedItem(method, params) {
+    if (method !== "item/started" && method !== "item/completed")
+        return undefined;
+    return params.item;
+}
+function readAppThreadId(params) {
+    return readString(params, "threadId") ?? readString(params, "thread_id");
+}
+function readAppTurnId(params) {
+    return readString(params, "turnId") ?? readString(params, "turn_id");
+}
+function readItemId(params, completedItem) {
+    const itemId = readString(params, "itemId") ?? readString(params, "item_id");
+    if (itemId)
+        return itemId;
+    if (!isRecord(completedItem))
+        return undefined;
+    return readString(completedItem, "id");
+}
+function readItemKind(item) {
+    if (!isRecord(item))
+        return "unknown";
+    return readString(item, "type") ?? readString(item, "kind") ?? "unknown";
+}
+function readString(input, key) {
+    const value = input[key];
+    return typeof value === "string" ? value : undefined;
+}
+function readNumber(input, key) {
+    const value = input[key];
+    return typeof value === "number" ? value : undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=item-stream-projector.js.map

package/dist/core/extensions/builtin/pi-codex-app-server/item-stream-projector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-stream-projector.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/item-stream-projector.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IdMapper } from \"./id-mapper.ts\";\nimport type { StreamClass } from \"./protocol-core.ts\";\n\nexport type SemanticProjectionChannel =\n\t| \"command\"\n\t| \"file\"\n\t| \"item\"\n\t| \"mcp\"\n\t| \"plan\"\n\t| \"process\"\n\t| \"raw-response\"\n\t| \"reasoning\"\n\t| \"reasoning-summary\"\n\t| \"text\"\n\t| \"turn\";\n\nexport type SemanticProjectionType =\n\t| \"completed\"\n\t| \"delta\"\n\t| \"item-completed\"\n\t| \"item-started\"\n\t| \"part-added\"\n\t| \"progress\"\n\t| \"turn-completed\"\n\t| \"turn-started\";\n\nexport interface ProjectItemStreamInput {\n\treadonly method: string;\n\treadonly params: unknown;\n\treadonly sequence: number;\n\treadonly externalSessionId: string | undefined;\n\treadonly idMapper: IdMapper;\n}\n\nexport interface SemanticItemStreamProjection {\n\treadonly kind: \"semantic\";\n\treadonly method: string;\n\treadonly sequence: number;\n\treadonly channel: SemanticProjectionChannel;\n\treadonly semanticType: SemanticProjectionType;\n\treadonly streamClass: StreamClass;\n\treadonly externalSessionId: string | undefined;\n\treadonly appThreadId: string | undefined;\n\treadonly appTurnId: string | undefined;\n\treadonly appItemId: string | undefined;\n\treadonly delta: string | undefined;\n\treadonly index: number | undefined;\n\treadonly completedItem: unknown;\n\treadonly originalParams: unknown;\n}\n\ninterface ItemProjectionShape {\n\treadonly channel: SemanticProjectionChannel;\n\treadonly semanticType: SemanticProjectionType;\n\treadonly streamClass: StreamClass;\n}\n\nconst itemProjectionShapes: Readonly<Record<string, ItemProjectionShape>> = {\n\t\"item/started\": { channel: \"item\", semanticType: \"item-started\", streamClass: \"lossless\" },\n\t\"item/completed\": { channel: \"item\", semanticType: \"item-completed\", streamClass: \"lossless\" },\n\t\"rawResponseItem/completed\": { channel: \"raw-response\", semanticType: \"completed\", streamClass: \"lossless\" },\n\t\"item/agentMessage/delta\": { channel: \"text\", semanticType: \"delta\", streamClass: \"lossless\" },\n\t\"item/plan/delta\": { channel: \"plan\", semanticType: \"delta\", streamClass: \"lossless\" },\n\t\"item/reasoning/summaryTextDelta\": { channel: \"reasoning-summary\", semanticType: \"delta\", streamClass: \"lossless\" },\n\t\"item/reasoning/summaryPartAdded\": {\n\t\tchannel: \"reasoning-summary\",\n\t\tsemanticType: \"part-added\",\n\t\tstreamClass: \"lossless\",\n\t},\n\t\"item/reasoning/textDelta\": { channel: \"reasoning\", semanticType: \"delta\", streamClass: \"lossless\" },\n\t\"command/exec/outputDelta\": { channel: \"command\", semanticType: \"progress\", streamClass: \"best-effort\" },\n\t\"item/commandExecution/outputDelta\": { channel: \"command\", semanticType: \"progress\", streamClass: \"best-effort\" },\n\t\"item/commandExecution/terminalInteraction\": {\n\t\tchannel: \"command\",\n\t\tsemanticType: \"progress\",\n\t\tstreamClass: \"best-effort\",\n\t},\n\t\"process/outputDelta\": { channel: \"process\", semanticType: \"progress\", streamClass: \"best-effort\" },\n\t\"process/exited\": { channel: \"process\", semanticType: \"completed\", streamClass: \"lossless\" },\n\t\"item/fileChange/outputDelta\": { channel: \"file\", semanticType: \"progress\", streamClass: \"best-effort\" },\n\t\"item/fileChange/patchUpdated\": { channel: \"file\", semanticType: \"progress\", streamClass: \"best-effort\" },\n\t\"item/mcpToolCall/progress\": { channel: \"mcp\", semanticType: \"progress\", streamClass: \"best-effort\" },\n\t\"turn/started\": { channel: \"turn\", semanticType: \"turn-started\", streamClass: \"lossless\" },\n\t\"turn/completed\": { channel: \"turn\", semanticType: \"turn-completed\", streamClass: \"lossless\" },\n};\n\nexport function projectItemStreamNotification(input: ProjectItemStreamInput): SemanticItemStreamProjection | undefined {\n\tconst shape = itemProjectionShapes[input.method];\n\tif (!shape) return undefined;\n\n\tconst params = isRecord(input.params) ? input.params : {};\n\tconst appThreadId = readAppThreadId(params);\n\tconst appTurnId = readAppTurnId(params);\n\tconst completedItem = readCompletedItem(input.method, params);\n\tconst appItemId = readItemId(params, completedItem);\n\tconst delta = readString(params, \"delta\");\n\tconst index = readNumber(params, \"index\");\n\n\tif (input.method === \"item/started\" && appThreadId && appTurnId && appItemId) {\n\t\tregisterItemIfNeeded(input.idMapper, {\n\t\t\tappThreadId,\n\t\t\tappTurnId,\n\t\t\tappItemId,\n\t\t\titemKind: readItemKind(completedItem),\n\t\t});\n\t}\n\n\treturn {\n\t\tkind: \"semantic\",\n\t\tmethod: input.method,\n\t\tsequence: input.sequence,\n\t\tchannel: shape.channel,\n\t\tsemanticType: shape.semanticType,\n\t\tstreamClass: shape.streamClass,\n\t\texternalSessionId: input.externalSessionId,\n\t\tappThreadId,\n\t\tappTurnId,\n\t\tappItemId,\n\t\tdelta,\n\t\tindex,\n\t\tcompletedItem,\n\t\toriginalParams: input.params,\n\t};\n}\n\ninterface RegisterItemInput {\n\treadonly appThreadId: string;\n\treadonly appTurnId: string;\n\treadonly appItemId: string;\n\treadonly itemKind: string;\n}\n\nfunction registerItemIfNeeded(idMapper: IdMapper, input: RegisterItemInput): void {\n\tif (idMapper.getItem(input.appItemId)) return;\n\tidMapper.registerItem(input);\n}\n\nfunction readCompletedItem(method: string, params: Readonly<Record<string, unknown>>): unknown {\n\tif (method !== \"item/started\" && method !== \"item/completed\") return undefined;\n\treturn params.item;\n}\n\nfunction readAppThreadId(params: Readonly<Record<string, unknown>>): string | undefined {\n\treturn readString(params, \"threadId\") ?? readString(params, \"thread_id\");\n}\n\nfunction readAppTurnId(params: Readonly<Record<string, unknown>>): string | undefined {\n\treturn readString(params, \"turnId\") ?? readString(params, \"turn_id\");\n}\n\nfunction readItemId(params: Readonly<Record<string, unknown>>, completedItem: unknown): string | undefined {\n\tconst itemId = readString(params, \"itemId\") ?? readString(params, \"item_id\");\n\tif (itemId) return itemId;\n\tif (!isRecord(completedItem)) return undefined;\n\treturn readString(completedItem, \"id\");\n}\n\nfunction readItemKind(item: unknown): string {\n\tif (!isRecord(item)) return \"unknown\";\n\treturn readString(item, \"type\") ?? readString(item, \"kind\") ?? \"unknown\";\n}\n\nfunction readString(input: Readonly<Record<string, unknown>>, key: string): string | undefined {\n\tconst value = input[key];\n\treturn typeof value === \"string\" ? value : undefined;\n}\n\nfunction readNumber(input: Readonly<Record<string, unknown>>, key: string): number | undefined {\n\tconst value = input[key];\n\treturn typeof value === \"number\" ? value : undefined;\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/notification-projector.d.ts

@@ -0,0 +1,49 @@
+import type { IdMapper } from "./id-mapper.ts";
+import { type SemanticItemStreamProjection } from "./item-stream-projector.ts";
+import { PI_CODEX_APP_SERVER_PROTOCOL_VERSION, type StreamClass } from "./protocol-core.ts";
+import type { SessionRegistry } from "./session-registry.ts";
+export interface NotificationProjectorOptions {
+    readonly connectionId: string;
+    readonly capabilityFlags: readonly string[];
+    readonly notificationOptOuts: readonly string[];
+    readonly idMapper: IdMapper;
+    readonly sessionRegistry: SessionRegistry;
+}
+export interface AppServerNotificationInput {
+    readonly method: string;
+    readonly params: unknown;
+}
+export interface OpaqueAppServerEnvelope {
+    readonly protocolVersion: typeof PI_CODEX_APP_SERVER_PROTOCOL_VERSION;
+    readonly connectionId: string;
+    readonly externalSessionId: string | undefined;
+    readonly externalRequestId: string | undefined;
+    readonly externalMessageId: string | undefined;
+    readonly externalCallbackId: string | undefined;
+    readonly appThreadId: string | undefined;
+    readonly appSessionId: string | undefined;
+    readonly appTurnId: string | undefined;
+    readonly appItemId: string | undefined;
+    readonly appRequestId: string | undefined;
+    readonly sequence: number;
+    readonly streamClass: StreamClass;
+    readonly capabilityFlags: readonly string[];
+    readonly originalMethod: string;
+    readonly originalParams: unknown;
+    readonly redactionClass: "public-contract" | "secret-bearing";
+}
+export interface OpaqueNotificationProjection {
+    readonly kind: "opaque";
+    readonly method: "appServer/event";
+    readonly envelope: OpaqueAppServerEnvelope;
+}
+export interface SkippedNotificationProjection {
+    readonly kind: "skipped";
+    readonly reason: "notification-opt-out";
+}
+export type NotificationProjection = OpaqueNotificationProjection | SemanticItemStreamProjection | SkippedNotificationProjection;
+export interface NotificationProjector {
+    project(input: AppServerNotificationInput): NotificationProjection;
+}
+export declare function createNotificationProjector(options: NotificationProjectorOptions): NotificationProjector;
+//# sourceMappingURL=notification-projector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification-projector.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/notification-projector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAiC,KAAK,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC9G,OAAO,EAA4B,oCAAoC,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,eAAe,EAAE,OAAO,oCAAoC,CAAC;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;CAC9D;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;CAC3C;AAED,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACxC;AAED,MAAM,MAAM,sBAAsB,GAC/B,4BAA4B,GAC5B,4BAA4B,GAC5B,6BAA6B,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,sBAAsB,CAAC;CACnE;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,qBAAqB,CAExG"}

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

@@ -0,0 +1,99 @@
+import { projectItemStreamNotification } from "./item-stream-projector.js";
+import { classifyAppServerSurface, PI_CODEX_APP_SERVER_PROTOCOL_VERSION } from "./protocol-core.js";
+export function createNotificationProjector(options) {
+    return new DefaultNotificationProjector(options);
+}
+class DefaultNotificationProjector {
+    constructor(options) {
+        this.sequence = 0;
+        this.connectionId = options.connectionId;
+        this.capabilityFlags = options.capabilityFlags;
+        this.notificationOptOuts = new Set(options.notificationOptOuts);
+        this.idMapper = options.idMapper;
+        this.sessionRegistry = options.sessionRegistry;
+    }
+    project(input) {
+        if (this.notificationOptOuts.has(input.method)) {
+            return { kind: "skipped", reason: "notification-opt-out" };
+        }
+        const sequence = this.nextSequence();
+        const appThreadId = readAppThreadId(input.params);
+        const externalSessionId = this.readExternalSessionId(appThreadId);
+        const semantic = projectItemStreamNotification({
+            method: input.method,
+            params: input.params,
+            sequence,
+            externalSessionId,
+            idMapper: this.idMapper,
+        });
+        if (semantic)
+            return semantic;
+        return {
+            kind: "opaque",
+            method: "appServer/event",
+            envelope: this.createOpaqueEnvelope(input, sequence, appThreadId, externalSessionId),
+        };
+    }
+    nextSequence() {
+        this.sequence += 1;
+        return this.sequence;
+    }
+    readExternalSessionId(appThreadId) {
+        if (!appThreadId)
+            return undefined;
+        return this.sessionRegistry.getByAppThreadId(appThreadId)?.externalSessionId;
+    }
+    createOpaqueEnvelope(input, sequence, appThreadId, externalSessionId) {
+        const params = isRecord(input.params) ? input.params : {};
+        const binding = appThreadId ? this.sessionRegistry.getByAppThreadId(appThreadId) : undefined;
+        return {
+            protocolVersion: PI_CODEX_APP_SERVER_PROTOCOL_VERSION,
+            connectionId: this.connectionId,
+            externalSessionId,
+            externalRequestId: undefined,
+            externalMessageId: undefined,
+            externalCallbackId: undefined,
+            appThreadId,
+            appSessionId: binding?.appSessionId,
+            appTurnId: readAppTurnId(params),
+            appItemId: readAppItemId(input.params),
+            appRequestId: readAppRequestId(params),
+            sequence,
+            streamClass: classifyAppServerSurface(input.method)?.streamClass ?? "lossless",
+            capabilityFlags: this.capabilityFlags,
+            originalMethod: input.method,
+            originalParams: input.params,
+            redactionClass: "public-contract",
+        };
+    }
+}
+function readAppThreadId(params) {
+    if (!isRecord(params))
+        return undefined;
+    return readString(params, "threadId") ?? readString(params, "thread_id");
+}
+function readAppTurnId(params) {
+    return readString(params, "turnId") ?? readString(params, "turn_id");
+}
+function readAppItemId(params) {
+    if (!isRecord(params))
+        return undefined;
+    const itemId = readString(params, "itemId") ?? readString(params, "item_id");
+    if (itemId)
+        return itemId;
+    const item = params.item;
+    if (!isRecord(item))
+        return undefined;
+    return readString(item, "id");
+}
+function readAppRequestId(params) {
+    return readString(params, "requestId") ?? readString(params, "request_id") ?? readString(params, "id");
+}
+function readString(input, key) {
+    const value = input[key];
+    return typeof value === "string" ? value : undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=notification-projector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification-projector.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/notification-projector.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IdMapper } from \"./id-mapper.ts\";\nimport { projectItemStreamNotification, type SemanticItemStreamProjection } from \"./item-stream-projector.ts\";\nimport { classifyAppServerSurface, PI_CODEX_APP_SERVER_PROTOCOL_VERSION, type StreamClass } from \"./protocol-core.ts\";\nimport type { SessionRegistry } from \"./session-registry.ts\";\n\nexport interface NotificationProjectorOptions {\n\treadonly connectionId: string;\n\treadonly capabilityFlags: readonly string[];\n\treadonly notificationOptOuts: readonly string[];\n\treadonly idMapper: IdMapper;\n\treadonly sessionRegistry: SessionRegistry;\n}\n\nexport interface AppServerNotificationInput {\n\treadonly method: string;\n\treadonly params: unknown;\n}\n\nexport interface OpaqueAppServerEnvelope {\n\treadonly protocolVersion: typeof PI_CODEX_APP_SERVER_PROTOCOL_VERSION;\n\treadonly connectionId: string;\n\treadonly externalSessionId: string | undefined;\n\treadonly externalRequestId: string | undefined;\n\treadonly externalMessageId: string | undefined;\n\treadonly externalCallbackId: string | undefined;\n\treadonly appThreadId: string | undefined;\n\treadonly appSessionId: string | undefined;\n\treadonly appTurnId: string | undefined;\n\treadonly appItemId: string | undefined;\n\treadonly appRequestId: string | undefined;\n\treadonly sequence: number;\n\treadonly streamClass: StreamClass;\n\treadonly capabilityFlags: readonly string[];\n\treadonly originalMethod: string;\n\treadonly originalParams: unknown;\n\treadonly redactionClass: \"public-contract\" | \"secret-bearing\";\n}\n\nexport interface OpaqueNotificationProjection {\n\treadonly kind: \"opaque\";\n\treadonly method: \"appServer/event\";\n\treadonly envelope: OpaqueAppServerEnvelope;\n}\n\nexport interface SkippedNotificationProjection {\n\treadonly kind: \"skipped\";\n\treadonly reason: \"notification-opt-out\";\n}\n\nexport type NotificationProjection =\n\t| OpaqueNotificationProjection\n\t| SemanticItemStreamProjection\n\t| SkippedNotificationProjection;\n\nexport interface NotificationProjector {\n\tproject(input: AppServerNotificationInput): NotificationProjection;\n}\n\nexport function createNotificationProjector(options: NotificationProjectorOptions): NotificationProjector {\n\treturn new DefaultNotificationProjector(options);\n}\n\nclass DefaultNotificationProjector implements NotificationProjector {\n\tprivate readonly connectionId: string;\n\tprivate readonly capabilityFlags: readonly string[];\n\tprivate readonly notificationOptOuts: ReadonlySet<string>;\n\tprivate readonly idMapper: IdMapper;\n\tprivate readonly sessionRegistry: SessionRegistry;\n\tprivate sequence = 0;\n\n\tconstructor(options: NotificationProjectorOptions) {\n\t\tthis.connectionId = options.connectionId;\n\t\tthis.capabilityFlags = options.capabilityFlags;\n\t\tthis.notificationOptOuts = new Set(options.notificationOptOuts);\n\t\tthis.idMapper = options.idMapper;\n\t\tthis.sessionRegistry = options.sessionRegistry;\n\t}\n\n\tproject(input: AppServerNotificationInput): NotificationProjection {\n\t\tif (this.notificationOptOuts.has(input.method)) {\n\t\t\treturn { kind: \"skipped\", reason: \"notification-opt-out\" };\n\t\t}\n\n\t\tconst sequence = this.nextSequence();\n\t\tconst appThreadId = readAppThreadId(input.params);\n\t\tconst externalSessionId = this.readExternalSessionId(appThreadId);\n\t\tconst semantic = projectItemStreamNotification({\n\t\t\tmethod: input.method,\n\t\t\tparams: input.params,\n\t\t\tsequence,\n\t\t\texternalSessionId,\n\t\t\tidMapper: this.idMapper,\n\t\t});\n\t\tif (semantic) return semantic;\n\n\t\treturn {\n\t\t\tkind: \"opaque\",\n\t\t\tmethod: \"appServer/event\",\n\t\t\tenvelope: this.createOpaqueEnvelope(input, sequence, appThreadId, externalSessionId),\n\t\t};\n\t}\n\n\tprivate nextSequence(): number {\n\t\tthis.sequence += 1;\n\t\treturn this.sequence;\n\t}\n\n\tprivate readExternalSessionId(appThreadId: string | undefined): string | undefined {\n\t\tif (!appThreadId) return undefined;\n\t\treturn this.sessionRegistry.getByAppThreadId(appThreadId)?.externalSessionId;\n\t}\n\n\tprivate createOpaqueEnvelope(\n\t\tinput: AppServerNotificationInput,\n\t\tsequence: number,\n\t\tappThreadId: string | undefined,\n\t\texternalSessionId: string | undefined,\n\t): OpaqueAppServerEnvelope {\n\t\tconst params = isRecord(input.params) ? input.params : {};\n\t\tconst binding = appThreadId ? this.sessionRegistry.getByAppThreadId(appThreadId) : undefined;\n\t\treturn {\n\t\t\tprotocolVersion: PI_CODEX_APP_SERVER_PROTOCOL_VERSION,\n\t\t\tconnectionId: this.connectionId,\n\t\t\texternalSessionId,\n\t\t\texternalRequestId: undefined,\n\t\t\texternalMessageId: undefined,\n\t\t\texternalCallbackId: undefined,\n\t\t\tappThreadId,\n\t\t\tappSessionId: binding?.appSessionId,\n\t\t\tappTurnId: readAppTurnId(params),\n\t\t\tappItemId: readAppItemId(input.params),\n\t\t\tappRequestId: readAppRequestId(params),\n\t\t\tsequence,\n\t\t\tstreamClass: classifyAppServerSurface(input.method)?.streamClass ?? \"lossless\",\n\t\t\tcapabilityFlags: this.capabilityFlags,\n\t\t\toriginalMethod: input.method,\n\t\t\toriginalParams: input.params,\n\t\t\tredactionClass: \"public-contract\",\n\t\t};\n\t}\n}\n\nfunction readAppThreadId(params: unknown): string | undefined {\n\tif (!isRecord(params)) return undefined;\n\treturn readString(params, \"threadId\") ?? readString(params, \"thread_id\");\n}\n\nfunction readAppTurnId(params: Readonly<Record<string, unknown>>): string | undefined {\n\treturn readString(params, \"turnId\") ?? readString(params, \"turn_id\");\n}\n\nfunction readAppItemId(params: unknown): string | undefined {\n\tif (!isRecord(params)) return undefined;\n\tconst itemId = readString(params, \"itemId\") ?? readString(params, \"item_id\");\n\tif (itemId) return itemId;\n\tconst item = params.item;\n\tif (!isRecord(item)) return undefined;\n\treturn readString(item, \"id\");\n}\n\nfunction readAppRequestId(params: Readonly<Record<string, unknown>>): string | undefined {\n\treturn readString(params, \"requestId\") ?? readString(params, \"request_id\") ?? readString(params, \"id\");\n}\n\nfunction readString(input: Readonly<Record<string, unknown>>, key: string): string | undefined {\n\tconst value = input[key];\n\treturn typeof value === \"string\" ? value : undefined;\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/protocol-core.d.ts

@@ -0,0 +1,42 @@
+import type { AppServerClientRequestSurface } from "./protocol-required-surfaces.ts";
+export { APP_SERVER_SURFACE_INVENTORY } from "./protocol-inventory.ts";
+export declare const PI_CODEX_APP_SERVER_PROTOCOL_VERSION = "2026-06-24.pr-001";
+export type CoreExternalProtocolMethodName = "initialize" | "initialized" | "session/new" | "session/resume" | "session/fork" | "session/list" | "session/read" | "session/archive" | "session/delete" | "session/unsubscribe" | "turn/start" | "turn/steer" | "turn/interrupt" | "callback/respond" | "callback/reject" | "appServer/event" | "appServer/request" | "appServer/response" | "lag" | "disconnect" | "resume";
+export type ExternalProtocolMethodName = CoreExternalProtocolMethodName | AppServerClientRequestSurface;
+export type StreamClass = "lossless" | "best-effort" | "snapshot-authoritative" | "control";
+export type RelayClass = "semantic" | "opaque-lossless" | "opaque-best-effort" | "snapshot-authoritative";
+export type SurfaceDirection = "external-to-app" | "app-to-external" | "bidirectional";
+export interface ExternalProtocolMethod {
+    readonly name: ExternalProtocolMethodName;
+    readonly direction: SurfaceDirection;
+    readonly streamClass: StreamClass;
+    readonly capabilityGate: string;
+    readonly errorBehavior: string;
+}
+export interface OpaqueEnvelopeField {
+    readonly name: string;
+    readonly required: boolean;
+    readonly description: string;
+}
+export interface AppServerSurfaceInventoryEntry {
+    readonly method: string;
+    readonly direction: SurfaceDirection;
+    readonly relayClass: RelayClass;
+    readonly streamClass: StreamClass;
+    readonly surface: string;
+    readonly idFields: readonly string[];
+    readonly source: string;
+}
+export interface ReviewerEvidencePacketTemplate {
+    readonly summaryFile: string;
+    readonly commandsFile: string;
+    readonly inventoryDiff: string;
+    readonly cleanupReceipt: string;
+    readonly secretSafety: string;
+    readonly residualRisks: string;
+}
+export declare const EXTERNAL_PROTOCOL_METHODS: readonly ExternalProtocolMethod[];
+export declare const OPAQUE_APP_SERVER_ENVELOPE_FIELDS: readonly OpaqueEnvelopeField[];
+export declare function classifyAppServerSurface(method: string): AppServerSurfaceInventoryEntry | undefined;
+export declare function createReviewerEvidencePacketTemplate(): ReviewerEvidencePacketTemplate;
+//# sourceMappingURL=protocol-core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-core.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/protocol-core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAErF,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAEvE,eAAO,MAAM,oCAAoC,sBAAsB,CAAC;AAExE,MAAM,MAAM,8BAA8B,GACvC,YAAY,GACZ,aAAa,GACb,aAAa,GACb,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GACrB,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,oBAAoB,GACpB,KAAK,GACL,YAAY,GACZ,QAAQ,CAAC;AACZ,MAAM,MAAM,0BAA0B,GAAG,8BAA8B,GAAG,6BAA6B,CAAC;AAExG,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,wBAAwB,GAAG,SAAS,CAAC;AAC5F,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,wBAAwB,CAAC;AAC1G,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAEvF,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,yBAAyB,EAAE,SAAS,sBAAsB,EAoJtE,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,SAAS,mBAAmB,EAkB3E,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,8BAA8B,GAAG,SAAS,CAOnG;AAED,wBAAgB,oCAAoC,IAAI,8BAA8B,CAUrF"}

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"}