@code-yeongyu/senpi 2026.6.21 → 2026.6.30

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

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

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

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

package/dist/core/extensions/builtin/pi-codex-app-server/reconnect-resume-token.d.ts

@@ -0,0 +1,18 @@
+import { type AdapterJsonRpcError } from "./error-mapper.ts";
+import type { ReplayCursor, SessionBinding, SessionBindingInput } from "./session-registry.ts";
+declare const RESUME_TOKEN_VERSION = "2026-06-24.pr-010";
+export interface ResumeTokenPayload extends SessionBindingInput {
+    readonly version: typeof RESUME_TOKEN_VERSION;
+    readonly replayCursor: ReplayCursor;
+}
+export type ResumeTokenParseResult = {
+    readonly kind: "parsed";
+    readonly payload: ResumeTokenPayload;
+} | {
+    readonly kind: "adapter-error";
+    readonly error: AdapterJsonRpcError;
+};
+export declare function createResumeToken(binding: SessionBinding): string;
+export declare function parseResumeToken(token: string): ResumeTokenParseResult;
+export {};
+//# sourceMappingURL=reconnect-resume-token.d.ts.map

package/dist/core/extensions/builtin/pi-codex-app-server/reconnect-resume-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-resume-token.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/reconnect-resume-token.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,mBAAmB,EAA6B,MAAM,mBAAmB,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE/F,QAAA,MAAM,oBAAoB,sBAAsB,CAAC;AAEjD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACpC;AAED,MAAM,MAAM,sBAAsB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE3E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CASjE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAUtE"}

package/dist/core/extensions/builtin/pi-codex-app-server/reconnect-resume-token.js

@@ -0,0 +1,77 @@
+import { Buffer } from "node:buffer";
+import { createAdapterJsonRpcError } from "./error-mapper.js";
+const RESUME_TOKEN_VERSION = "2026-06-24.pr-010";
+export function createResumeToken(binding) {
+    const payload = {
+        version: RESUME_TOKEN_VERSION,
+        externalSessionId: binding.externalSessionId,
+        appThreadId: binding.appThreadId,
+        appSessionId: binding.appSessionId,
+        replayCursor: binding.replayCursor,
+    };
+    return Buffer.from(JSON.stringify(payload), "utf8").toString("base64url");
+}
+export function parseResumeToken(token) {
+    try {
+        const parsed = JSON.parse(Buffer.from(token, "base64url").toString("utf8"));
+        const payload = readResumeTokenPayload(parsed);
+        if (!payload)
+            return malformedToken("Resume token payload is malformed.");
+        return { kind: "parsed", payload };
+    }
+    catch (error) {
+        if (error instanceof Error)
+            return malformedToken(error.message);
+        throw error;
+    }
+}
+function readResumeTokenPayload(input) {
+    const record = readRecord(input);
+    if (!record)
+        return undefined;
+    const version = readString(record, "version");
+    const externalSessionId = readString(record, "externalSessionId");
+    const appThreadId = readString(record, "appThreadId");
+    const appSessionId = readString(record, "appSessionId");
+    const replayCursor = readReplayCursor(record.replayCursor);
+    if (version !== RESUME_TOKEN_VERSION || !externalSessionId || !appThreadId || !appSessionId || !replayCursor) {
+        return undefined;
+    }
+    return { version, externalSessionId, appThreadId, appSessionId, replayCursor };
+}
+function readReplayCursor(input) {
+    const record = readRecord(input);
+    if (!record)
+        return undefined;
+    const lastCompletedTurnId = readString(record, "lastCompletedTurnId");
+    const lastProjectedItemId = readString(record, "lastProjectedItemId");
+    const lastLosslessSequence = readNumber(record, "lastLosslessSequence");
+    return {
+        ...(lastCompletedTurnId ? { lastCompletedTurnId } : {}),
+        ...(lastProjectedItemId ? { lastProjectedItemId } : {}),
+        ...(lastLosslessSequence === undefined ? {} : { lastLosslessSequence }),
+    };
+}
+function malformedToken(message) {
+    return {
+        kind: "adapter-error",
+        error: createAdapterJsonRpcError({
+            adapterCode: "malformed-message",
+            message: `Invalid resume token: ${message}`,
+        }),
+    };
+}
+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 readRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return undefined;
+    return Object.fromEntries(Object.entries(value));
+}
+//# sourceMappingURL=reconnect-resume-token.js.map

package/dist/core/extensions/builtin/pi-codex-app-server/reconnect-resume-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-resume-token.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/reconnect-resume-token.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport { type AdapterJsonRpcError, createAdapterJsonRpcError } from \"./error-mapper.ts\";\nimport type { ReplayCursor, SessionBinding, SessionBindingInput } from \"./session-registry.ts\";\n\nconst RESUME_TOKEN_VERSION = \"2026-06-24.pr-010\";\n\nexport interface ResumeTokenPayload extends SessionBindingInput {\n\treadonly version: typeof RESUME_TOKEN_VERSION;\n\treadonly replayCursor: ReplayCursor;\n}\n\nexport type ResumeTokenParseResult =\n\t| { readonly kind: \"parsed\"; readonly payload: ResumeTokenPayload }\n\t| { readonly kind: \"adapter-error\"; readonly error: AdapterJsonRpcError };\n\nexport function createResumeToken(binding: SessionBinding): string {\n\tconst payload: ResumeTokenPayload = {\n\t\tversion: RESUME_TOKEN_VERSION,\n\t\texternalSessionId: binding.externalSessionId,\n\t\tappThreadId: binding.appThreadId,\n\t\tappSessionId: binding.appSessionId,\n\t\treplayCursor: binding.replayCursor,\n\t};\n\treturn Buffer.from(JSON.stringify(payload), \"utf8\").toString(\"base64url\");\n}\n\nexport function parseResumeToken(token: string): ResumeTokenParseResult {\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(Buffer.from(token, \"base64url\").toString(\"utf8\"));\n\t\tconst payload = readResumeTokenPayload(parsed);\n\t\tif (!payload) return malformedToken(\"Resume token payload is malformed.\");\n\t\treturn { kind: \"parsed\", payload };\n\t} catch (error) {\n\t\tif (error instanceof Error) return malformedToken(error.message);\n\t\tthrow error;\n\t}\n}\n\nfunction readResumeTokenPayload(input: unknown): ResumeTokenPayload | undefined {\n\tconst record = readRecord(input);\n\tif (!record) return undefined;\n\tconst version = readString(record, \"version\");\n\tconst externalSessionId = readString(record, \"externalSessionId\");\n\tconst appThreadId = readString(record, \"appThreadId\");\n\tconst appSessionId = readString(record, \"appSessionId\");\n\tconst replayCursor = readReplayCursor(record.replayCursor);\n\tif (version !== RESUME_TOKEN_VERSION || !externalSessionId || !appThreadId || !appSessionId || !replayCursor) {\n\t\treturn undefined;\n\t}\n\treturn { version, externalSessionId, appThreadId, appSessionId, replayCursor };\n}\n\nfunction readReplayCursor(input: unknown): ReplayCursor | undefined {\n\tconst record = readRecord(input);\n\tif (!record) return undefined;\n\tconst lastCompletedTurnId = readString(record, \"lastCompletedTurnId\");\n\tconst lastProjectedItemId = readString(record, \"lastProjectedItemId\");\n\tconst lastLosslessSequence = readNumber(record, \"lastLosslessSequence\");\n\treturn {\n\t\t...(lastCompletedTurnId ? { lastCompletedTurnId } : {}),\n\t\t...(lastProjectedItemId ? { lastProjectedItemId } : {}),\n\t\t...(lastLosslessSequence === undefined ? {} : { lastLosslessSequence }),\n\t};\n}\n\nfunction malformedToken(message: string): { readonly kind: \"adapter-error\"; readonly error: AdapterJsonRpcError } {\n\treturn {\n\t\tkind: \"adapter-error\",\n\t\terror: createAdapterJsonRpcError({\n\t\t\tadapterCode: \"malformed-message\",\n\t\t\tmessage: `Invalid resume token: ${message}`,\n\t\t}),\n\t};\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 readRecord(value: unknown): Readonly<Record<string, unknown>> | undefined {\n\tif (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n\treturn Object.fromEntries(Object.entries(value));\n}\n"]}

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

@@ -0,0 +1,70 @@
+import { type AdapterJsonRpcError } from "./error-mapper.ts";
+import type { AppServerRequestClient } from "./request-router.ts";
+import type { ReplayCursor, SessionRegistry } from "./session-registry.ts";
+declare const REPLAY_CLAIM = "snapshot-plus-new-stream";
+export { createResumeToken } from "./reconnect-resume-token.ts";
+export interface ReconnectResumeCoordinatorOptions {
+    readonly connectionId: string;
+    readonly client: AppServerRequestClient;
+    readonly sessionRegistry: SessionRegistry;
+}
+export interface ReconnectResumeCoordinator {
+    resumeFromToken(token: string): Promise<ReconnectResumeResult>;
+    recordTerminalNotification(input: TerminalNotificationInput): TerminalRecordResult;
+    createDisconnectEvent(message: string): DisconnectEvent;
+}
+export interface ResumeEvent {
+    readonly kind: "resume";
+    readonly method: "resume";
+    readonly connectionId: string;
+    readonly externalSessionId: string;
+    readonly appThreadId: string;
+    readonly appSessionId: string;
+    readonly streamClass: "snapshot-authoritative";
+    readonly replayCursor: ReplayCursor;
+    readonly replayClaim: typeof REPLAY_CLAIM;
+    readonly snapshot: ResumeSnapshot;
+}
+export interface ResumeSnapshot {
+    readonly threadResume: unknown;
+    readonly threadRead: unknown;
+    readonly turns: unknown;
+    readonly items: unknown;
+}
+export interface DisconnectEvent {
+    readonly kind: "disconnect";
+    readonly method: "disconnect";
+    readonly connectionId: string;
+    readonly streamClass: "control";
+    readonly message: string;
+    readonly replayClaim: typeof REPLAY_CLAIM;
+}
+export type ReconnectResumeResult = {
+    readonly kind: "resumed";
+    readonly event: ResumeEvent;
+} | {
+    readonly kind: "adapter-error";
+    readonly error: AdapterJsonRpcError;
+};
+export interface TerminalNotificationInput {
+    readonly method: string;
+    readonly params: unknown;
+    readonly sequence: number;
+}
+export type TerminalRecordResult = {
+    readonly kind: "recorded";
+    readonly externalSessionId: string;
+    readonly appTurnId: string;
+    readonly sequence: number;
+} | {
+    readonly kind: "duplicate-terminal";
+    readonly externalSessionId: string;
+    readonly appTurnId: string;
+} | {
+    readonly kind: "ignored";
+} | {
+    readonly kind: "adapter-error";
+    readonly error: AdapterJsonRpcError;
+};
+export declare function createReconnectResumeCoordinator(options: ReconnectResumeCoordinatorOptions): ReconnectResumeCoordinator;
+//# sourceMappingURL=reconnect-resume.d.ts.map

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

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

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

@@ -0,0 +1,138 @@
+import { createAdapterJsonRpcError } from "./error-mapper.js";
+import { parseResumeToken } from "./reconnect-resume-token.js";
+const REPLAY_CLAIM = "snapshot-plus-new-stream";
+export { createResumeToken } from "./reconnect-resume-token.js";
+export function createReconnectResumeCoordinator(options) {
+    return new DefaultReconnectResumeCoordinator(options);
+}
+class DefaultReconnectResumeCoordinator {
+    constructor(options) {
+        this.completedTurnKeys = new Set();
+        this.connectionId = options.connectionId;
+        this.client = options.client;
+        this.sessionRegistry = options.sessionRegistry;
+    }
+    async resumeFromToken(token) {
+        const payload = parseResumeToken(token);
+        if (payload.kind === "adapter-error")
+            return payload;
+        const binding = this.bindOrReuseSession(payload.payload);
+        if (binding.kind === "adapter-error")
+            return binding;
+        const threadResume = await this.client.request("thread/resume", {
+            thread_id: binding.binding.appThreadId,
+            session_id: binding.binding.appSessionId,
+        });
+        const threadRead = await this.client.request("thread/read", { thread_id: binding.binding.appThreadId });
+        const turns = await this.client.request("thread/turns/list", withOptionalCursor({ thread_id: binding.binding.appThreadId }, "after_turn_id", binding.binding.replayCursor.lastCompletedTurnId));
+        const items = await this.client.request("thread/turns/items/list", withOptionalCursor({ thread_id: binding.binding.appThreadId }, "after_item_id", binding.binding.replayCursor.lastProjectedItemId));
+        return {
+            kind: "resumed",
+            event: {
+                kind: "resume",
+                method: "resume",
+                connectionId: this.connectionId,
+                externalSessionId: binding.binding.externalSessionId,
+                appThreadId: binding.binding.appThreadId,
+                appSessionId: binding.binding.appSessionId,
+                streamClass: "snapshot-authoritative",
+                replayCursor: binding.binding.replayCursor,
+                replayClaim: REPLAY_CLAIM,
+                snapshot: { threadResume, threadRead, turns, items },
+            },
+        };
+    }
+    recordTerminalNotification(input) {
+        if (!isTerminalNotification(input.method))
+            return { kind: "ignored" };
+        const params = readRecord(input.params);
+        if (!params)
+            return invalidSession("Terminal notification params must be an object.");
+        const appThreadId = readString(params, "threadId") ?? readString(params, "thread_id");
+        const appTurnId = readAppTurnId(params);
+        if (!appThreadId || !appTurnId)
+            return invalidSession("Terminal notification requires thread and turn IDs.");
+        const binding = this.sessionRegistry.getByAppThreadId(appThreadId);
+        if (!binding || binding.tombstoned)
+            return invalidSession(`Unknown or tombstoned app-server thread: ${appThreadId}`);
+        const terminalKey = `${appThreadId}:${appTurnId}`;
+        if (this.completedTurnKeys.has(terminalKey)) {
+            return { kind: "duplicate-terminal", externalSessionId: binding.externalSessionId, appTurnId };
+        }
+        this.completedTurnKeys.add(terminalKey);
+        const appItemId = readString(params, "itemId") ?? readString(params, "item_id");
+        this.sessionRegistry.updateReplayCursor(binding.externalSessionId, {
+            ...binding.replayCursor,
+            lastCompletedTurnId: appTurnId,
+            ...(appItemId ? { lastProjectedItemId: appItemId } : {}),
+            lastLosslessSequence: input.sequence,
+        });
+        return {
+            kind: "recorded",
+            externalSessionId: binding.externalSessionId,
+            appTurnId,
+            sequence: input.sequence,
+        };
+    }
+    createDisconnectEvent(message) {
+        return {
+            kind: "disconnect",
+            method: "disconnect",
+            connectionId: this.connectionId,
+            streamClass: "control",
+            message,
+            replayClaim: REPLAY_CLAIM,
+        };
+    }
+    bindOrReuseSession(payload) {
+        const existing = this.sessionRegistry.getByExternalSessionId(payload.externalSessionId);
+        if (existing?.tombstoned)
+            return invalidSession(`External session is tombstoned: ${payload.externalSessionId}`);
+        if (existing) {
+            if (existing.appThreadId !== payload.appThreadId || existing.appSessionId !== payload.appSessionId) {
+                return invalidSession(`Resume token does not match existing session binding: ${payload.externalSessionId}`);
+            }
+            return { kind: "active", binding: existing };
+        }
+        const bindResult = this.sessionRegistry.bindSession(payload);
+        if (bindResult.kind === "rejected")
+            return { kind: "adapter-error", error: bindResult.error };
+        const cursorResult = this.sessionRegistry.updateReplayCursor(payload.externalSessionId, payload.replayCursor);
+        if (cursorResult.kind === "rejected")
+            return { kind: "adapter-error", error: cursorResult.error };
+        return cursorResult;
+    }
+}
+function withOptionalCursor(params, key, value) {
+    return value ? { ...params, [key]: value } : { ...params };
+}
+function isTerminalNotification(method) {
+    return method === "turn/completed" || method === "error";
+}
+function readAppTurnId(params) {
+    const topLevelTurnId = readString(params, "turnId") ?? readString(params, "turn_id") ?? readString(params, "id");
+    if (topLevelTurnId)
+        return topLevelTurnId;
+    const turn = readRecord(params.turn);
+    return turn ? readString(turn, "id") : undefined;
+}
+function invalidSession(message) {
+    return {
+        kind: "adapter-error",
+        error: createAdapterJsonRpcError({
+            adapterCode: "invalid-session-state",
+            message,
+            retryable: true,
+        }),
+    };
+}
+function readString(input, key) {
+    const value = input[key];
+    return typeof value === "string" ? value : undefined;
+}
+function readRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return undefined;
+    return Object.fromEntries(Object.entries(value));
+}
+//# sourceMappingURL=reconnect-resume.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-resume.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/reconnect-resume.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AdapterJsonRpcError, createAdapterJsonRpcError } from \"./error-mapper.ts\";\nimport { parseResumeToken, type ResumeTokenPayload } from \"./reconnect-resume-token.ts\";\nimport type { AppServerRequestClient } from \"./request-router.ts\";\nimport type { ReplayCursor, SessionBinding, SessionRegistry } from \"./session-registry.ts\";\n\nconst REPLAY_CLAIM = \"snapshot-plus-new-stream\";\n\nexport { createResumeToken } from \"./reconnect-resume-token.ts\";\n\nexport interface ReconnectResumeCoordinatorOptions {\n\treadonly connectionId: string;\n\treadonly client: AppServerRequestClient;\n\treadonly sessionRegistry: SessionRegistry;\n}\n\nexport interface ReconnectResumeCoordinator {\n\tresumeFromToken(token: string): Promise<ReconnectResumeResult>;\n\trecordTerminalNotification(input: TerminalNotificationInput): TerminalRecordResult;\n\tcreateDisconnectEvent(message: string): DisconnectEvent;\n}\n\nexport interface ResumeEvent {\n\treadonly kind: \"resume\";\n\treadonly method: \"resume\";\n\treadonly connectionId: string;\n\treadonly externalSessionId: string;\n\treadonly appThreadId: string;\n\treadonly appSessionId: string;\n\treadonly streamClass: \"snapshot-authoritative\";\n\treadonly replayCursor: ReplayCursor;\n\treadonly replayClaim: typeof REPLAY_CLAIM;\n\treadonly snapshot: ResumeSnapshot;\n}\n\nexport interface ResumeSnapshot {\n\treadonly threadResume: unknown;\n\treadonly threadRead: unknown;\n\treadonly turns: unknown;\n\treadonly items: unknown;\n}\n\nexport interface DisconnectEvent {\n\treadonly kind: \"disconnect\";\n\treadonly method: \"disconnect\";\n\treadonly connectionId: string;\n\treadonly streamClass: \"control\";\n\treadonly message: string;\n\treadonly replayClaim: typeof REPLAY_CLAIM;\n}\n\nexport type ReconnectResumeResult =\n\t| { readonly kind: \"resumed\"; readonly event: ResumeEvent }\n\t| { readonly kind: \"adapter-error\"; readonly error: AdapterJsonRpcError };\n\nexport interface TerminalNotificationInput {\n\treadonly method: string;\n\treadonly params: unknown;\n\treadonly sequence: number;\n}\n\nexport type TerminalRecordResult =\n\t| {\n\t\t\treadonly kind: \"recorded\";\n\t\t\treadonly externalSessionId: string;\n\t\t\treadonly appTurnId: string;\n\t\t\treadonly sequence: number;\n\t  }\n\t| { readonly kind: \"duplicate-terminal\"; readonly externalSessionId: string; readonly appTurnId: string }\n\t| { readonly kind: \"ignored\" }\n\t| { readonly kind: \"adapter-error\"; readonly error: AdapterJsonRpcError };\n\nexport function createReconnectResumeCoordinator(\n\toptions: ReconnectResumeCoordinatorOptions,\n): ReconnectResumeCoordinator {\n\treturn new DefaultReconnectResumeCoordinator(options);\n}\n\nclass DefaultReconnectResumeCoordinator implements ReconnectResumeCoordinator {\n\tprivate readonly connectionId: string;\n\tprivate readonly client: AppServerRequestClient;\n\tprivate readonly sessionRegistry: SessionRegistry;\n\tprivate readonly completedTurnKeys = new Set<string>();\n\n\tconstructor(options: ReconnectResumeCoordinatorOptions) {\n\t\tthis.connectionId = options.connectionId;\n\t\tthis.client = options.client;\n\t\tthis.sessionRegistry = options.sessionRegistry;\n\t}\n\n\tasync resumeFromToken(token: string): Promise<ReconnectResumeResult> {\n\t\tconst payload = parseResumeToken(token);\n\t\tif (payload.kind === \"adapter-error\") return payload;\n\t\tconst binding = this.bindOrReuseSession(payload.payload);\n\t\tif (binding.kind === \"adapter-error\") return binding;\n\n\t\tconst threadResume = await this.client.request(\"thread/resume\", {\n\t\t\tthread_id: binding.binding.appThreadId,\n\t\t\tsession_id: binding.binding.appSessionId,\n\t\t});\n\t\tconst threadRead = await this.client.request(\"thread/read\", { thread_id: binding.binding.appThreadId });\n\t\tconst turns = await this.client.request(\n\t\t\t\"thread/turns/list\",\n\t\t\twithOptionalCursor(\n\t\t\t\t{ thread_id: binding.binding.appThreadId },\n\t\t\t\t\"after_turn_id\",\n\t\t\t\tbinding.binding.replayCursor.lastCompletedTurnId,\n\t\t\t),\n\t\t);\n\t\tconst items = await this.client.request(\n\t\t\t\"thread/turns/items/list\",\n\t\t\twithOptionalCursor(\n\t\t\t\t{ thread_id: binding.binding.appThreadId },\n\t\t\t\t\"after_item_id\",\n\t\t\t\tbinding.binding.replayCursor.lastProjectedItemId,\n\t\t\t),\n\t\t);\n\n\t\treturn {\n\t\t\tkind: \"resumed\",\n\t\t\tevent: {\n\t\t\t\tkind: \"resume\",\n\t\t\t\tmethod: \"resume\",\n\t\t\t\tconnectionId: this.connectionId,\n\t\t\t\texternalSessionId: binding.binding.externalSessionId,\n\t\t\t\tappThreadId: binding.binding.appThreadId,\n\t\t\t\tappSessionId: binding.binding.appSessionId,\n\t\t\t\tstreamClass: \"snapshot-authoritative\",\n\t\t\t\treplayCursor: binding.binding.replayCursor,\n\t\t\t\treplayClaim: REPLAY_CLAIM,\n\t\t\t\tsnapshot: { threadResume, threadRead, turns, items },\n\t\t\t},\n\t\t};\n\t}\n\n\trecordTerminalNotification(input: TerminalNotificationInput): TerminalRecordResult {\n\t\tif (!isTerminalNotification(input.method)) return { kind: \"ignored\" };\n\t\tconst params = readRecord(input.params);\n\t\tif (!params) return invalidSession(\"Terminal notification params must be an object.\");\n\t\tconst appThreadId = readString(params, \"threadId\") ?? readString(params, \"thread_id\");\n\t\tconst appTurnId = readAppTurnId(params);\n\t\tif (!appThreadId || !appTurnId) return invalidSession(\"Terminal notification requires thread and turn IDs.\");\n\t\tconst binding = this.sessionRegistry.getByAppThreadId(appThreadId);\n\t\tif (!binding || binding.tombstoned)\n\t\t\treturn invalidSession(`Unknown or tombstoned app-server thread: ${appThreadId}`);\n\t\tconst terminalKey = `${appThreadId}:${appTurnId}`;\n\t\tif (this.completedTurnKeys.has(terminalKey)) {\n\t\t\treturn { kind: \"duplicate-terminal\", externalSessionId: binding.externalSessionId, appTurnId };\n\t\t}\n\t\tthis.completedTurnKeys.add(terminalKey);\n\t\tconst appItemId = readString(params, \"itemId\") ?? readString(params, \"item_id\");\n\t\tthis.sessionRegistry.updateReplayCursor(binding.externalSessionId, {\n\t\t\t...binding.replayCursor,\n\t\t\tlastCompletedTurnId: appTurnId,\n\t\t\t...(appItemId ? { lastProjectedItemId: appItemId } : {}),\n\t\t\tlastLosslessSequence: input.sequence,\n\t\t});\n\t\treturn {\n\t\t\tkind: \"recorded\",\n\t\t\texternalSessionId: binding.externalSessionId,\n\t\t\tappTurnId,\n\t\t\tsequence: input.sequence,\n\t\t};\n\t}\n\n\tcreateDisconnectEvent(message: string): DisconnectEvent {\n\t\treturn {\n\t\t\tkind: \"disconnect\",\n\t\t\tmethod: \"disconnect\",\n\t\t\tconnectionId: this.connectionId,\n\t\t\tstreamClass: \"control\",\n\t\t\tmessage,\n\t\t\treplayClaim: REPLAY_CLAIM,\n\t\t};\n\t}\n\n\tprivate bindOrReuseSession(\n\t\tpayload: ResumeTokenPayload,\n\t):\n\t\t| { readonly kind: \"active\"; readonly binding: SessionBinding }\n\t\t| { readonly kind: \"adapter-error\"; readonly error: AdapterJsonRpcError } {\n\t\tconst existing = this.sessionRegistry.getByExternalSessionId(payload.externalSessionId);\n\t\tif (existing?.tombstoned) return invalidSession(`External session is tombstoned: ${payload.externalSessionId}`);\n\t\tif (existing) {\n\t\t\tif (existing.appThreadId !== payload.appThreadId || existing.appSessionId !== payload.appSessionId) {\n\t\t\t\treturn invalidSession(`Resume token does not match existing session binding: ${payload.externalSessionId}`);\n\t\t\t}\n\t\t\treturn { kind: \"active\", binding: existing };\n\t\t}\n\t\tconst bindResult = this.sessionRegistry.bindSession(payload);\n\t\tif (bindResult.kind === \"rejected\") return { kind: \"adapter-error\", error: bindResult.error };\n\t\tconst cursorResult = this.sessionRegistry.updateReplayCursor(payload.externalSessionId, payload.replayCursor);\n\t\tif (cursorResult.kind === \"rejected\") return { kind: \"adapter-error\", error: cursorResult.error };\n\t\treturn cursorResult;\n\t}\n}\n\nfunction withOptionalCursor(\n\tparams: Readonly<Record<string, unknown>>,\n\tkey: string,\n\tvalue: string | undefined,\n): Record<string, unknown> {\n\treturn value ? { ...params, [key]: value } : { ...params };\n}\n\nfunction isTerminalNotification(method: string): boolean {\n\treturn method === \"turn/completed\" || method === \"error\";\n}\n\nfunction readAppTurnId(params: Readonly<Record<string, unknown>>): string | undefined {\n\tconst topLevelTurnId = readString(params, \"turnId\") ?? readString(params, \"turn_id\") ?? readString(params, \"id\");\n\tif (topLevelTurnId) return topLevelTurnId;\n\tconst turn = readRecord(params.turn);\n\treturn turn ? readString(turn, \"id\") : undefined;\n}\n\nfunction invalidSession(message: string): { readonly kind: \"adapter-error\"; readonly error: AdapterJsonRpcError } {\n\treturn {\n\t\tkind: \"adapter-error\",\n\t\terror: createAdapterJsonRpcError({\n\t\t\tadapterCode: \"invalid-session-state\",\n\t\t\tmessage,\n\t\t\tretryable: true,\n\t\t}),\n\t};\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 readRecord(value: unknown): Readonly<Record<string, unknown>> | undefined {\n\tif (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n\treturn Object.fromEntries(Object.entries(value));\n}\n"]}