@code-yeongyu/senpi 2026.6.21 → 2026.6.30-2

package/dist/core/extensions/builtin/permission-system/settings.js

@@ -1,23 +1,43 @@
-import { fromConfig, merge } from "./config.js";
+import { parsePermissionPresetName } from "./cli.js";
+import { DEFAULT_PERMISSION_PRESET, fromConfig, merge, rulesForPreset } from "./config.js";
 import { loadApproved } from "./storage.js";
 /**
  * Load permission settings from global and project settings.json files.
  *
  * Merge order (highest precedence last):
- *   1. Global settings (~/.senpi/agent/settings.json)
- *   2. Project settings (.senpi/settings.json)
- *   3. CLI override (passed directly to this function)
+ *   1. Default preset
+ *   2. Global preset and rules (~/.senpi/agent/settings.json)
+ *   3. Project preset and rules (.senpi/settings.json)
+ *   4. CLI preset and rules
  *
  * Runtime approvals are stored separately in .senpi/permissions-approved.jsonl
  * and loaded via loadApproved() from storage.ts.
  */
-export function loadPermissionSettings(settingsManager, cliOverride, projectDir) {
+export function loadPermissionSettings(settingsManager, cliOverride, projectDir, cliPresetOverride) {
     const globalSettings = settingsManager.getGlobalSettings();
+    const globalPreset = parseSettingsPreset(globalSettings.permissionPreset, "global");
+    const globalPresetRuleset = globalPreset ? rulesForPreset(globalPreset) : [];
     const globalRuleset = globalSettings.permission ? fromConfig(globalSettings.permission) : [];
     const projectSettings = settingsManager.getProjectSettings();
+    const projectPreset = parseSettingsPreset(projectSettings.permissionPreset, "project");
+    const projectPresetRuleset = projectPreset ? rulesForPreset(projectPreset) : [];
     const projectRuleset = projectSettings.permission ? fromConfig(projectSettings.permission) : [];
-    const staticRuleset = merge(globalRuleset, projectRuleset, cliOverride);
+    const cliPresetRuleset = cliPresetOverride ? rulesForPreset(cliPresetOverride) : [];
+    const staticRuleset = merge(rulesForPreset(DEFAULT_PERMISSION_PRESET), globalPresetRuleset, globalRuleset, projectPresetRuleset, projectRuleset, cliPresetRuleset, cliOverride);
     const approved = loadApproved(projectDir);
     return { staticRuleset, approved };
 }
+function parseSettingsPreset(value, scope) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new Error(`Invalid ${scope} permissionPreset ${JSON.stringify(value)}. Expected a string.`);
+    }
+    const preset = parsePermissionPresetName(value);
+    if (!preset) {
+        throw new Error(`Invalid ${scope} permissionPreset "${value}". Expected one of: full-access, workspace, read-only, ask.`);
+    }
+    return preset;
+}
 //# sourceMappingURL=settings.js.map

package/dist/core/extensions/builtin/permission-system/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/permission-system/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CACrC,eAAgC,EAChC,WAAoB,EACpB,UAAkB;IAElB,MAAM,cAAc,GAAG,eAAe,CAAC,iBAAiB,EAAkD,CAAC;IAC3G,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7F,MAAM,eAAe,GAAG,eAAe,CAAC,kBAAkB,EAAkD,CAAC;IAC7G,MAAM,cAAc,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhG,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAE1C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC","sourcesContent":["import type { Settings, SettingsManager } from \"../../../settings-manager.ts\";\nimport { fromConfig, merge } from \"./config.ts\";\nimport { loadApproved } from \"./storage.ts\";\nimport type { PermissionConfig, Ruleset } from \"./types.ts\";\n\n/**\n * Load permission settings from global and project settings.json files.\n *\n * Merge order (highest precedence last):\n *   1. Global settings (~/.senpi/agent/settings.json)\n *   2. Project settings (.senpi/settings.json)\n *   3. CLI override (passed directly to this function)\n *\n * Runtime approvals are stored separately in .senpi/permissions-approved.jsonl\n * and loaded via loadApproved() from storage.ts.\n */\nexport function loadPermissionSettings(\n\tsettingsManager: SettingsManager,\n\tcliOverride: Ruleset,\n\tprojectDir: string,\n): { staticRuleset: Ruleset; approved: Ruleset } {\n\tconst globalSettings = settingsManager.getGlobalSettings() as Settings & { permission?: PermissionConfig };\n\tconst globalRuleset = globalSettings.permission ? fromConfig(globalSettings.permission) : [];\n\n\tconst projectSettings = settingsManager.getProjectSettings() as Settings & { permission?: PermissionConfig };\n\tconst projectRuleset = projectSettings.permission ? fromConfig(projectSettings.permission) : [];\n\n\tconst staticRuleset = merge(globalRuleset, projectRuleset, cliOverride);\n\tconst approved = loadApproved(projectDir);\n\n\treturn { staticRuleset, approved };\n}\n"]}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/permission-system/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQ5C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACrC,eAAgC,EAChC,WAAoB,EACpB,UAAkB,EAClB,iBAAwC;IAExC,MAAM,cAAc,GAAG,eAAe,CAAC,iBAAiB,EAAmC,CAAC;IAC5F,MAAM,YAAY,GAAG,mBAAmB,CAAC,cAAc,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IACpF,MAAM,mBAAmB,GAAG,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7F,MAAM,eAAe,GAAG,eAAe,CAAC,kBAAkB,EAAmC,CAAC;IAC9F,MAAM,aAAa,GAAG,mBAAmB,CAAC,eAAe,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IACvF,MAAM,oBAAoB,GAAG,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,MAAM,cAAc,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhG,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,MAAM,aAAa,GAAG,KAAK,CAC1B,cAAc,CAAC,yBAAyB,CAAC,EACzC,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,WAAW,CACX,CAAC;IACF,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAE1C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc,EAAE,KAA2B;IACvE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,qBAAqB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,WAAW,KAAK,sBAAsB,KAAK,6DAA6D,CACxG,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC","sourcesContent":["import type { Settings, SettingsManager } from \"../../../settings-manager.ts\";\nimport { parsePermissionPresetName } from \"./cli.ts\";\nimport { DEFAULT_PERMISSION_PRESET, fromConfig, merge, rulesForPreset } from \"./config.ts\";\nimport { loadApproved } from \"./storage.ts\";\nimport type { PermissionConfig, PermissionPresetName, Ruleset } from \"./types.ts\";\n\ntype PermissionSettings = {\n\tpermission?: PermissionConfig;\n\tpermissionPreset?: unknown;\n};\n\n/**\n * Load permission settings from global and project settings.json files.\n *\n * Merge order (highest precedence last):\n *   1. Default preset\n *   2. Global preset and rules (~/.senpi/agent/settings.json)\n *   3. Project preset and rules (.senpi/settings.json)\n *   4. CLI preset and rules\n *\n * Runtime approvals are stored separately in .senpi/permissions-approved.jsonl\n * and loaded via loadApproved() from storage.ts.\n */\nexport function loadPermissionSettings(\n\tsettingsManager: SettingsManager,\n\tcliOverride: Ruleset,\n\tprojectDir: string,\n\tcliPresetOverride?: PermissionPresetName,\n): { staticRuleset: Ruleset; approved: Ruleset } {\n\tconst globalSettings = settingsManager.getGlobalSettings() as Settings & PermissionSettings;\n\tconst globalPreset = parseSettingsPreset(globalSettings.permissionPreset, \"global\");\n\tconst globalPresetRuleset = globalPreset ? rulesForPreset(globalPreset) : [];\n\tconst globalRuleset = globalSettings.permission ? fromConfig(globalSettings.permission) : [];\n\n\tconst projectSettings = settingsManager.getProjectSettings() as Settings & PermissionSettings;\n\tconst projectPreset = parseSettingsPreset(projectSettings.permissionPreset, \"project\");\n\tconst projectPresetRuleset = projectPreset ? rulesForPreset(projectPreset) : [];\n\tconst projectRuleset = projectSettings.permission ? fromConfig(projectSettings.permission) : [];\n\n\tconst cliPresetRuleset = cliPresetOverride ? rulesForPreset(cliPresetOverride) : [];\n\tconst staticRuleset = merge(\n\t\trulesForPreset(DEFAULT_PERMISSION_PRESET),\n\t\tglobalPresetRuleset,\n\t\tglobalRuleset,\n\t\tprojectPresetRuleset,\n\t\tprojectRuleset,\n\t\tcliPresetRuleset,\n\t\tcliOverride,\n\t);\n\tconst approved = loadApproved(projectDir);\n\n\treturn { staticRuleset, approved };\n}\n\nfunction parseSettingsPreset(value: unknown, scope: \"global\" | \"project\"): PermissionPresetName | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(`Invalid ${scope} permissionPreset ${JSON.stringify(value)}. Expected a string.`);\n\t}\n\n\tconst preset = parsePermissionPresetName(value);\n\tif (!preset) {\n\t\tthrow new Error(\n\t\t\t`Invalid ${scope} permissionPreset \"${value}\". Expected one of: full-access, workspace, read-only, ask.`,\n\t\t);\n\t}\n\treturn preset;\n}\n"]}

package/dist/core/extensions/builtin/permission-system/types.d.ts

@@ -10,6 +10,7 @@ export type Rule = {
 export type Ruleset = Rule[];
 /** Configuration format for settings.json */
 export type PermissionConfig = Record<string, Action | Record<string, Action>>;
+export type PermissionPresetName = "full-access" | "workspace" | "read-only" | "ask";
 /** User reply to a permission request */
 export type Reply = "once" | "always" | "reject";
 /** Final permission decision: user reply or auto-grant from rules */

package/dist/core/extensions/builtin/permission-system/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/permission-system/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C,qDAAqD;AACrD,MAAM,MAAM,IAAI,GAAG;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;AAE7B,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/E,yCAAyC;AACzC,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,OAAO,CAAC;AAEjD,mDAAmD;AACnD,MAAM,MAAM,OAAO,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;CACF,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,0DAA0D;AAC1D,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,6BAA6B;IAE1C,cAGC;CACD;AAED,kEAAkE;AAClE,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,MAAM,EAI3B;CACD;AAED,qDAAqD;AACrD,qBAAa,WAAY,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,2BAA2B;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAE5B,YAAY,QAAQ,EAAE,MAAM,EAAE,EAI7B;CACD;AAED,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,cAAc,GAAG,WAAW,CAAC;AAE3E,qCAAqC;AACrC,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,KAAK,IAAI,CAAC;CACtD,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/permission-system/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C,qDAAqD;AACrD,MAAM,MAAM,IAAI,GAAG;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;AAE7B,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/E,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,KAAK,CAAC;AAErF,yCAAyC;AACzC,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,OAAO,CAAC;AAEjD,mDAAmD;AACnD,MAAM,MAAM,OAAO,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;CACF,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,0DAA0D;AAC1D,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,6BAA6B;IAE1C,cAGC;CACD;AAED,kEAAkE;AAClE,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,MAAM,EAI3B;CACD;AAED,qDAAqD;AACrD,qBAAa,WAAY,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,2BAA2B;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAE5B,YAAY,QAAQ,EAAE,MAAM,EAAE,EAI7B;CACD;AAED,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,cAAc,GAAG,WAAW,CAAC;AAE3E,qCAAqC;AACrC,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,KAAK,IAAI,CAAC;CACtD,CAAC"}

package/dist/core/extensions/builtin/permission-system/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/permission-system/types.ts"],"names":[],"mappings":"AA2CA,0DAA0D;AAC1D,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGvC;QACC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAH9D,SAAI,GAAG,yBAAyB,CAAC;QAIzC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD;AAED,kEAAkE;AAClE,MAAM,OAAO,cAAe,SAAQ,KAAK;IAIxC,YAAY,QAAgB;QAC3B,KAAK,CAAC,4FAA4F,QAAQ,EAAE,CAAC,CAAC;QAJtG,SAAI,GAAG,0BAA0B,CAAC;QAK1C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACD;AAED,qDAAqD;AACrD,MAAM,OAAO,WAAY,SAAQ,KAAK;IAIrC,YAAY,QAAkB;QAC7B,KAAK,CAAC,sFAAsF,CAAC,CAAC;QAJtF,SAAI,GAAG,uBAAuB,CAAC;QAKvC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACD","sourcesContent":["/** Permission action: allow (grant), deny (block), or ask (prompt user) */\nexport type Action = \"allow\" | \"deny\" | \"ask\";\n\n/** A single permission rule with pattern matching */\nexport type Rule = {\n\tpermission: string;\n\tpattern: string;\n\taction: Action;\n};\n\n/** Ordered list of rules for evaluation (last match wins) */\nexport type Ruleset = Rule[];\n\n/** Configuration format for settings.json */\nexport type PermissionConfig = Record<string, Action | Record<string, Action>>;\n\n/** User reply to a permission request */\nexport type Reply = \"once\" | \"always\" | \"reject\";\n\n/** Final permission decision: user reply or auto-grant from rules */\nexport type PermissionDecision = Reply | \"allow\";\n\n/** Permission request sent to user for approval */\nexport type Request = {\n\tid: string;\n\tsessionID: string;\n\tpermission: string;\n\tpatterns: string[];\n\talways: string[];\n\tmetadata: Record<string, unknown>;\n\ttool?: {\n\t\tmessageID: string;\n\t\tcallID: string;\n\t};\n};\n\n/** Input for replying to a permission request */\nexport type ReplyInput = {\n\trequestID: string;\n\treply: Reply;\n\tmessage?: string;\n};\n\n/** Error thrown when user rejects a permission request */\nexport class RejectedError extends Error {\n\treadonly _tag = \"PermissionRejectedError\";\n\n\tconstructor() {\n\t\tsuper(\"The user rejected permission to use this specific tool call.\");\n\t\tthis.name = \"RejectedError\";\n\t}\n}\n\n/** Error thrown when user rejects with feedback for correction */\nexport class CorrectedError extends Error {\n\treadonly _tag = \"PermissionCorrectedError\";\n\treadonly feedback: string;\n\n\tconstructor(feedback: string) {\n\t\tsuper(`The user rejected permission to use this specific tool call with the following feedback: ${feedback}`);\n\t\tthis.name = \"CorrectedError\";\n\t\tthis.feedback = feedback;\n\t}\n}\n\n/** Error thrown when a rule denies the permission */\nexport class DeniedError extends Error {\n\treadonly _tag = \"PermissionDeniedError\";\n\treadonly patterns: string[];\n\n\tconstructor(patterns: string[]) {\n\t\tsuper(`The user has specified a rule which prevents you from using this specific tool call.`);\n\t\tthis.name = \"DeniedError\";\n\t\tthis.patterns = patterns;\n\t}\n}\n\n/** Union of all permission-related errors */\nexport type PermissionError = RejectedError | CorrectedError | DeniedError;\n\n/** Internal pending request entry */\nexport type PendingEntry = {\n\tinfo: Request;\n\tresolve: () => void;\n\treject: (err: RejectedError | CorrectedError) => void;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/permission-system/types.ts"],"names":[],"mappings":"AA6CA,0DAA0D;AAC1D,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGvC;QACC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAH9D,SAAI,GAAG,yBAAyB,CAAC;QAIzC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD;AAED,kEAAkE;AAClE,MAAM,OAAO,cAAe,SAAQ,KAAK;IAIxC,YAAY,QAAgB;QAC3B,KAAK,CAAC,4FAA4F,QAAQ,EAAE,CAAC,CAAC;QAJtG,SAAI,GAAG,0BAA0B,CAAC;QAK1C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACD;AAED,qDAAqD;AACrD,MAAM,OAAO,WAAY,SAAQ,KAAK;IAIrC,YAAY,QAAkB;QAC7B,KAAK,CAAC,sFAAsF,CAAC,CAAC;QAJtF,SAAI,GAAG,uBAAuB,CAAC;QAKvC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACD","sourcesContent":["/** Permission action: allow (grant), deny (block), or ask (prompt user) */\nexport type Action = \"allow\" | \"deny\" | \"ask\";\n\n/** A single permission rule with pattern matching */\nexport type Rule = {\n\tpermission: string;\n\tpattern: string;\n\taction: Action;\n};\n\n/** Ordered list of rules for evaluation (last match wins) */\nexport type Ruleset = Rule[];\n\n/** Configuration format for settings.json */\nexport type PermissionConfig = Record<string, Action | Record<string, Action>>;\n\nexport type PermissionPresetName = \"full-access\" | \"workspace\" | \"read-only\" | \"ask\";\n\n/** User reply to a permission request */\nexport type Reply = \"once\" | \"always\" | \"reject\";\n\n/** Final permission decision: user reply or auto-grant from rules */\nexport type PermissionDecision = Reply | \"allow\";\n\n/** Permission request sent to user for approval */\nexport type Request = {\n\tid: string;\n\tsessionID: string;\n\tpermission: string;\n\tpatterns: string[];\n\talways: string[];\n\tmetadata: Record<string, unknown>;\n\ttool?: {\n\t\tmessageID: string;\n\t\tcallID: string;\n\t};\n};\n\n/** Input for replying to a permission request */\nexport type ReplyInput = {\n\trequestID: string;\n\treply: Reply;\n\tmessage?: string;\n};\n\n/** Error thrown when user rejects a permission request */\nexport class RejectedError extends Error {\n\treadonly _tag = \"PermissionRejectedError\";\n\n\tconstructor() {\n\t\tsuper(\"The user rejected permission to use this specific tool call.\");\n\t\tthis.name = \"RejectedError\";\n\t}\n}\n\n/** Error thrown when user rejects with feedback for correction */\nexport class CorrectedError extends Error {\n\treadonly _tag = \"PermissionCorrectedError\";\n\treadonly feedback: string;\n\n\tconstructor(feedback: string) {\n\t\tsuper(`The user rejected permission to use this specific tool call with the following feedback: ${feedback}`);\n\t\tthis.name = \"CorrectedError\";\n\t\tthis.feedback = feedback;\n\t}\n}\n\n/** Error thrown when a rule denies the permission */\nexport class DeniedError extends Error {\n\treadonly _tag = \"PermissionDeniedError\";\n\treadonly patterns: string[];\n\n\tconstructor(patterns: string[]) {\n\t\tsuper(`The user has specified a rule which prevents you from using this specific tool call.`);\n\t\tthis.name = \"DeniedError\";\n\t\tthis.patterns = patterns;\n\t}\n}\n\n/** Union of all permission-related errors */\nexport type PermissionError = RejectedError | CorrectedError | DeniedError;\n\n/** Internal pending request entry */\nexport type PendingEntry = {\n\tinfo: Request;\n\tresolve: () => void;\n\treject: (err: RejectedError | CorrectedError) => void;\n};\n"]}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-negotiator.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/capability-negotiator.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,oCAAoC,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,0CAA0C,EAAE,MAAM,iCAAiC,CAAC;AAmD7F,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAS,0CAA0C,CAAC,CAAC;AAE7F,MAAM,OAAO,mCAAoC,SAAQ,KAAK;IAG7D,YACC,OAAe,EACf,WAAsG;QAEtG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qCAAqC,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;CACD;AAED,MAAM,UAAU,mCAAmC,CAAC,KAAc;IACjE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,mCAAmC,CAAC,sCAAsC,EAAE,mBAAmB,CAAC,CAAC;IAC5G,CAAC;IACD,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC9C,IAAI,eAAe,KAAK,oCAAoC,EAAE,CAAC;QAC9D,MAAM,IAAI,mCAAmC,CAC5C,qDAAqD,MAAM,CAAC,eAAe,CAAC,EAAE,EAC9E,8BAA8B,CAC9B,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,mCAAmC,CAAC,4CAA4C,EAAE,mBAAmB,CAAC,CAAC;IAClH,CAAC;IAED,MAAM,mBAAmB,GAAG,wBAAwB,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACvF,OAAO;QACN,eAAe;QACf,cAAc,EAAE,mBAAmB,CAAC,YAAY,EAAE,gBAAgB,CAAC;QACnE,mBAAmB,EAAE,mBAAmB,CAAC,YAAY,EAAE,qBAAqB,CAAC;QAC7E,eAAe,EAAE,mBAAmB,CAAC,YAAY,EAAE,iBAAiB,CAAC;QACrE,QAAQ,EAAE,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC;QACvD,UAAU,EAAE,mBAAmB,CAAC,YAAY,EAAE,YAAY,CAAC;QAC3D,eAAe,EAAE,mBAAmB,CAAC,YAAY,EAAE,iBAAiB,CAAC;QACrE,mBAAmB;KACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,KAAiC;IACtF,MAAM,2BAA2B,GAAG,+BAA+B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpF,IAAI,2BAA2B,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO;YACN,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,yBAAyB,CAAC;gBAChC,WAAW,EAAE,2BAA2B;gBACxC,OAAO,EAAE,2DAA2D;gBACpE,OAAO,EAAE,2BAA2B;aACpC,CAAC;SACF,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,eAAe;QAC/C,eAAe,EAAE,oBAAoB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;QACtE,mBAAmB,EAAE,sBAAsB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;KAC5E,CAAC;AACH,CAAC;AAED,SAAS,+BAA+B,CAAC,QAAwC;IAChF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAC5B,QAAwC,EACxC,SAAsD;IAEtD,MAAM,KAAK,GAA+B,EAAE,CAAC;IAC7C,IAAI,QAAQ,CAAC,cAAc;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3D,IAAI,QAAQ,CAAC,mBAAmB;QAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACrE,IAAI,QAAQ,CAAC,eAAe;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7D,IAAI,QAAQ,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,eAAe;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9D,IAAI,SAAS,EAAE,eAAe;QAAE,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1E,IAAI,SAAS,EAAE,kBAAkB;QAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxE,IAAI,SAAS,EAAE,8BAA8B;QAAE,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC7F,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,sBAAsB,CAC9B,QAAwC,EACxC,SAAsD;IAEtD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,SAAS,EAAE,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACrF,IAAI,gBAAgB,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC/C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,mCAAmC,CAAC,uCAAuC,EAAE,mBAAmB,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC5B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,mCAAmC,CAC5C,8CAA8C,EAC9C,mBAAmB,CACnB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,mCAAmC,CAC5C,4CAA4C,MAAM,EAAE,EACpD,kCAAkC,CAClC,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAwC,EAAE,GAAW;IACjF,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,mCAAmC,CAAC,GAAG,GAAG,qBAAqB,EAAE,mBAAmB,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAwC,EAAE,GAAW;IACjF,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,mCAAmC,CAAC,GAAG,GAAG,qBAAqB,EAAE,mBAAmB,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC","sourcesContent":["import { type AdapterJsonRpcError, createAdapterJsonRpcError } from \"./error-mapper.ts\";\nimport { PI_CODEX_APP_SERVER_PROTOCOL_VERSION } from \"./protocol-core.ts\";\nimport { PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES } from \"./protocol-required-surfaces.ts\";\n\nexport type NegotiatedCapabilityFlag =\n\t| \"semantic-events\"\n\t| \"opaque-notifications\"\n\t| \"opaque-callbacks\"\n\t| \"realtime\"\n\t| \"filesystem\"\n\t| \"app-plugin-config\"\n\t| \"app-server-experimental-api\"\n\t| \"app-server-attestation\"\n\t| \"app-server-mcp-form-elicitation\";\n\nexport interface ExternalInitializeCapabilities {\n\treadonly protocolVersion: typeof PI_CODEX_APP_SERVER_PROTOCOL_VERSION;\n\treadonly semanticEvents: boolean;\n\treadonly opaqueNotifications: boolean;\n\treadonly opaqueCallbacks: boolean;\n\treadonly realtime: boolean;\n\treadonly filesystem: boolean;\n\treadonly appPluginConfig: boolean;\n\treadonly notificationOptOuts: readonly string[];\n}\n\nexport interface AppServerInitializeCapabilities {\n\treadonly experimentalApi?: boolean;\n\treadonly requestAttestation?: boolean;\n\treadonly mcpServerOpenaiFormElicitation?: boolean;\n\treadonly optOutNotificationMethods?: readonly string[] | null;\n}\n\nexport interface CapabilityNegotiationInput {\n\treadonly external: ExternalInitializeCapabilities;\n\treadonly appServer?: AppServerInitializeCapabilities;\n}\n\nexport type CapabilityNegotiationResult = CapabilityNegotiationAccepted | CapabilityNegotiationRejected;\n\nexport interface CapabilityNegotiationAccepted {\n\treadonly kind: \"accepted\";\n\treadonly protocolVersion: typeof PI_CODEX_APP_SERVER_PROTOCOL_VERSION;\n\treadonly capabilityFlags: readonly NegotiatedCapabilityFlag[];\n\treadonly notificationOptOuts: readonly string[];\n\treadonly error?: undefined;\n}\n\nexport interface CapabilityNegotiationRejected {\n\treadonly kind: \"rejected\";\n\treadonly error: AdapterJsonRpcError;\n}\n\nconst notificationSurfaceNames = new Set<string>(PLAN_REQUIRED_SERVER_NOTIFICATION_SURFACES);\n\nexport class ExternalInitializeCapabilitiesError extends Error {\n\treadonly adapterCode: \"malformed-message\" | \"unsupported-protocol-version\" | \"unsupported-notification-opt-out\";\n\n\tconstructor(\n\t\tmessage: string,\n\t\tadapterCode: \"malformed-message\" | \"unsupported-protocol-version\" | \"unsupported-notification-opt-out\",\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"ExternalInitializeCapabilitiesError\";\n\t\tthis.adapterCode = adapterCode;\n\t}\n}\n\nexport function parseExternalInitializeCapabilities(input: unknown): ExternalInitializeCapabilities {\n\tif (!isRecord(input)) {\n\t\tthrow new ExternalInitializeCapabilitiesError(\"Initialize params must be an object.\", \"malformed-message\");\n\t}\n\tconst protocolVersion = input.protocolVersion;\n\tif (protocolVersion !== PI_CODEX_APP_SERVER_PROTOCOL_VERSION) {\n\t\tthrow new ExternalInitializeCapabilitiesError(\n\t\t\t`Unsupported pi-codex-app-server protocol version: ${String(protocolVersion)}`,\n\t\t\t\"unsupported-protocol-version\",\n\t\t);\n\t}\n\n\tconst capabilities = input.capabilities;\n\tif (!isRecord(capabilities)) {\n\t\tthrow new ExternalInitializeCapabilitiesError(\"Initialize capabilities must be an object.\", \"malformed-message\");\n\t}\n\n\tconst notificationOptOuts = parseNotificationOptOuts(capabilities.notificationOptOuts);\n\treturn {\n\t\tprotocolVersion,\n\t\tsemanticEvents: readRequiredBoolean(capabilities, \"semanticEvents\"),\n\t\topaqueNotifications: readRequiredBoolean(capabilities, \"opaqueNotifications\"),\n\t\topaqueCallbacks: readRequiredBoolean(capabilities, \"opaqueCallbacks\"),\n\t\trealtime: readOptionalBoolean(capabilities, \"realtime\"),\n\t\tfilesystem: readOptionalBoolean(capabilities, \"filesystem\"),\n\t\tappPluginConfig: readOptionalBoolean(capabilities, \"appPluginConfig\"),\n\t\tnotificationOptOuts,\n\t};\n}\n\nexport function negotiatePiCodexAppServerCapabilities(input: CapabilityNegotiationInput): CapabilityNegotiationResult {\n\tconst missingRequiredCapabilities = findMissingRequiredCapabilities(input.external);\n\tif (missingRequiredCapabilities.length > 0) {\n\t\treturn {\n\t\t\tkind: \"rejected\",\n\t\t\terror: createAdapterJsonRpcError({\n\t\t\t\tadapterCode: \"incompatible-capabilities\",\n\t\t\t\tmessage: \"External client is incompatible with pi-codex-app-server.\",\n\t\t\t\tdetails: missingRequiredCapabilities,\n\t\t\t}),\n\t\t};\n\t}\n\n\treturn {\n\t\tkind: \"accepted\",\n\t\tprotocolVersion: input.external.protocolVersion,\n\t\tcapabilityFlags: buildCapabilityFlags(input.external, input.appServer),\n\t\tnotificationOptOuts: mapNotificationOptOuts(input.external, input.appServer),\n\t};\n}\n\nfunction findMissingRequiredCapabilities(external: ExternalInitializeCapabilities): readonly string[] {\n\tconst missing: string[] = [];\n\tif (!external.opaqueNotifications) {\n\t\tmissing.push(\"opaqueNotifications is required so app-server notifications are never silently dropped\");\n\t}\n\tif (!external.opaqueCallbacks) {\n\t\tmissing.push(\"opaqueCallbacks is required because app-server server requests are control flow\");\n\t}\n\treturn missing;\n}\n\nfunction buildCapabilityFlags(\n\texternal: ExternalInitializeCapabilities,\n\tappServer: AppServerInitializeCapabilities | undefined,\n): readonly NegotiatedCapabilityFlag[] {\n\tconst flags: NegotiatedCapabilityFlag[] = [];\n\tif (external.semanticEvents) flags.push(\"semantic-events\");\n\tif (external.opaqueNotifications) flags.push(\"opaque-notifications\");\n\tif (external.opaqueCallbacks) flags.push(\"opaque-callbacks\");\n\tif (external.realtime) flags.push(\"realtime\");\n\tif (external.filesystem) flags.push(\"filesystem\");\n\tif (external.appPluginConfig) flags.push(\"app-plugin-config\");\n\tif (appServer?.experimentalApi) flags.push(\"app-server-experimental-api\");\n\tif (appServer?.requestAttestation) flags.push(\"app-server-attestation\");\n\tif (appServer?.mcpServerOpenaiFormElicitation) flags.push(\"app-server-mcp-form-elicitation\");\n\treturn flags;\n}\n\nfunction mapNotificationOptOuts(\n\texternal: ExternalInitializeCapabilities,\n\tappServer: AppServerInitializeCapabilities | undefined,\n): readonly string[] {\n\tconst appServerOptOuts = new Set<string>(appServer?.optOutNotificationMethods ?? []);\n\tif (appServerOptOuts.size === 0) return [];\n\treturn external.notificationOptOuts.filter((method) => appServerOptOuts.has(method));\n}\n\nfunction parseNotificationOptOuts(value: unknown): readonly string[] {\n\tif (value === undefined) return [];\n\tif (!Array.isArray(value)) {\n\t\tthrow new ExternalInitializeCapabilitiesError(\"notificationOptOuts must be an array.\", \"malformed-message\");\n\t}\n\tconst optOuts: string[] = [];\n\tfor (const method of value) {\n\t\tif (typeof method !== \"string\") {\n\t\t\tthrow new ExternalInitializeCapabilitiesError(\n\t\t\t\t\"notificationOptOuts entries must be strings.\",\n\t\t\t\t\"malformed-message\",\n\t\t\t);\n\t\t}\n\t\tif (!notificationSurfaceNames.has(method)) {\n\t\t\tthrow new ExternalInitializeCapabilitiesError(\n\t\t\t\t`Unknown app-server notification opt-out: ${method}`,\n\t\t\t\t\"unsupported-notification-opt-out\",\n\t\t\t);\n\t\t}\n\t\toptOuts.push(method);\n\t}\n\treturn optOuts;\n}\n\nfunction readRequiredBoolean(input: Readonly<Record<string, unknown>>, key: string): boolean {\n\tconst value = input[key];\n\tif (typeof value !== \"boolean\") {\n\t\tthrow new ExternalInitializeCapabilitiesError(`${key} must be a boolean.`, \"malformed-message\");\n\t}\n\treturn value;\n}\n\nfunction readOptionalBoolean(input: Readonly<Record<string, unknown>>, key: string): boolean {\n\tconst value = input[key];\n\tif (value === undefined) return false;\n\tif (typeof value !== \"boolean\") {\n\t\tthrow new ExternalInitializeCapabilitiesError(`${key} must be a boolean.`, \"malformed-message\");\n\t}\n\treturn value;\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/extension.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionAPI, ExtensionContext, SessionShutdownEvent, SessionStartEvent } from \"../../types.ts\";\nimport { PI_CODEX_APP_SERVER_PROTOCOL_VERSION } from \"./protocol-core.ts\";\nimport {\n\tcreatePiCodexAppServerRuntime,\n\ttype PiCodexAppServerRuntimeController,\n\ttype PiCodexAppServerRuntimeFlags,\n\ttype PiCodexAppServerTransportMode,\n} from \"./transport-runtime.ts\";\n\nexport const PI_CODEX_APP_SERVER_COMMAND = \"pi-codex-app-server\";\nexport const PI_CODEX_APP_SERVER_FLAG_ENABLED = \"pi-codex-app-server\";\nexport const PI_CODEX_APP_SERVER_FLAG_MODE = \"pi-codex-app-server-mode\";\nexport const PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND = \"pi-codex-app-server-command\";\nexport const PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS = \"pi-codex-app-server-args\";\nexport const PI_CODEX_APP_SERVER_FLAG_URL = \"pi-codex-app-server-url\";\nexport const PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET = \"pi-codex-app-server-unix-socket\";\nexport const PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS = \"pi-codex-app-server-timeout-ms\";\n\nconst DEFAULT_TRANSPORT_MODE = \"stdio\";\nconst DEFAULT_APP_SERVER_COMMAND = \"codex\";\nconst DEFAULT_APP_SERVER_ARGS = \"app-server\";\nconst DEFAULT_TIMEOUT_MS = \"5000\";\nconst RUNTIME_NOTICE_PREFIX = [\n\t\"pi-codex-app-server PR-004 runtime\",\n\t`Protocol contract: ${PI_CODEX_APP_SERVER_PROTOCOL_VERSION}`,\n].join(\"\\n\");\n\ninterface RuntimeExtensionContext {\n\treadonly hasUI: boolean;\n\treadonly ui: Pick<ExtensionContext[\"ui\"], \"notify\">;\n}\ntype RuntimeLifecycleHandler<E> = (event: E, ctx: RuntimeExtensionContext) => Promise<void> | void;\n\nexport interface PiCodexAppServerExtensionApi {\n\treadonly registerCommand: ExtensionAPI[\"registerCommand\"];\n\treadonly registerFlag: ExtensionAPI[\"registerFlag\"];\n\treadonly getFlag: ExtensionAPI[\"getFlag\"];\n\ton(event: \"session_start\", handler: RuntimeLifecycleHandler<SessionStartEvent>): void;\n\ton(event: \"session_shutdown\", handler: RuntimeLifecycleHandler<SessionShutdownEvent>): void;\n}\n\nexport function registerPiCodexAppServerExtension(\n\tpi: PiCodexAppServerExtensionApi,\n\tcreateRuntime: () => PiCodexAppServerRuntimeController = createPiCodexAppServerRuntime,\n): void {\n\tconst runtime = createRuntime();\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_ENABLED, {\n\t\ttype: \"boolean\",\n\t\tdefault: false,\n\t\tdescription: \"Enable pi-codex-app-server runtime transport during session lifecycle.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_MODE, {\n\t\ttype: \"string\",\n\t\tdefault: DEFAULT_TRANSPORT_MODE,\n\t\tdescription: \"Select the pi-codex-app-server transport mode: stdio, websocket, or unix.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND, {\n\t\ttype: \"string\",\n\t\tdefault: DEFAULT_APP_SERVER_COMMAND,\n\t\tdescription: \"Codex app-server command for stdio or unix proxy transport.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS, {\n\t\ttype: \"string\",\n\t\tdefault: DEFAULT_APP_SERVER_ARGS,\n\t\tdescription: \"Codex app-server command arguments for stdio transport.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_URL, {\n\t\ttype: \"string\",\n\t\tdefault: \"\",\n\t\tdescription: \"Remote websocket URL for websocket transport.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET, {\n\t\ttype: \"string\",\n\t\tdefault: \"\",\n\t\tdescription: \"Unix socket path for app-server proxy transport.\",\n\t});\n\tpi.registerFlag(PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS, {\n\t\ttype: \"string\",\n\t\tdefault: DEFAULT_TIMEOUT_MS,\n\t\tdescription: \"Runtime transport setup timeout in milliseconds.\",\n\t});\n\tpi.registerCommand(PI_CODEX_APP_SERVER_COMMAND, {\n\t\tdescription: \"Inspect the Codex app-server adapter runtime status\",\n\t\thandler: async (_args, ctx) => {\n\t\t\tnotifyIfVisible(ctx, `${RUNTIME_NOTICE_PREFIX}\\nStatus: ${runtime.getStatus().kind}`);\n\t\t},\n\t});\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tconst flags = readRuntimeFlags(pi);\n\t\tconst status = await runtime.start(flags);\n\t\tnotifyIfVisible(ctx, `${RUNTIME_NOTICE_PREFIX}\\nStatus: ${status.kind}`);\n\t});\n\tpi.on(\"session_shutdown\", async (_event, ctx) => {\n\t\tconst status = await runtime.stop();\n\t\tnotifyIfVisible(ctx, `${RUNTIME_NOTICE_PREFIX}\\nStatus: ${status.kind}`);\n\t});\n}\n\nfunction notifyIfVisible(ctx: RuntimeExtensionContext, message: string): void {\n\tif (!ctx.hasUI) return;\n\tctx.ui.notify(message, \"info\");\n}\n\nfunction readRuntimeFlags(pi: PiCodexAppServerExtensionApi): PiCodexAppServerRuntimeFlags {\n\treturn {\n\t\tenabled: pi.getFlag(PI_CODEX_APP_SERVER_FLAG_ENABLED) === true,\n\t\tmode: readTransportMode(pi),\n\t\tappServerCommand: readStringFlag(pi, PI_CODEX_APP_SERVER_FLAG_APP_SERVER_COMMAND, DEFAULT_APP_SERVER_COMMAND),\n\t\tappServerArgs: readArgsFlag(pi, PI_CODEX_APP_SERVER_FLAG_APP_SERVER_ARGS),\n\t\tappServerUrl: readStringFlag(pi, PI_CODEX_APP_SERVER_FLAG_URL, \"\"),\n\t\tappServerSocketPath: readStringFlag(pi, PI_CODEX_APP_SERVER_FLAG_UNIX_SOCKET, \"\"),\n\t\tconnectTimeoutMs: readPositiveIntegerFlag(pi, PI_CODEX_APP_SERVER_FLAG_TIMEOUT_MS, Number(DEFAULT_TIMEOUT_MS)),\n\t};\n}\n\nfunction readTransportMode(pi: PiCodexAppServerExtensionApi): PiCodexAppServerTransportMode {\n\tconst mode = pi.getFlag(PI_CODEX_APP_SERVER_FLAG_MODE);\n\tif (mode === \"websocket\" || mode === \"unix\") return mode;\n\treturn \"stdio\";\n}\n\nfunction readStringFlag(pi: PiCodexAppServerExtensionApi, name: string, fallback: string): string {\n\tconst value = pi.getFlag(name);\n\treturn typeof value === \"string\" ? value : fallback;\n}\n\nfunction readArgsFlag(pi: PiCodexAppServerExtensionApi, name: string): readonly string[] {\n\treturn readStringFlag(pi, name, DEFAULT_APP_SERVER_ARGS)\n\t\t.split(\" \")\n\t\t.map((part) => part.trim())\n\t\t.filter((part) => part.length > 0);\n}\n\nfunction readPositiveIntegerFlag(pi: PiCodexAppServerExtensionApi, name: string, fallback: number): number {\n\tconst value = Number(readStringFlag(pi, name, String(fallback)));\n\tif (Number.isInteger(value) && value > 0) return value;\n\treturn fallback;\n}\n"]}

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

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

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

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