@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-mcp-adapter/elicitation-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation-handler.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/elicitation-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EAClB,MAAM,oCAAoC,CAAC;AAK5C,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAGhF,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEtD,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,oBAAoB,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,yBAAyB,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;AAEtG,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAGnG;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAIvB;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAoCvB;AA4GD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAuEtD;AAuCD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAoCvB","sourcesContent":["// @ts-nocheck\nimport type { ExtensionUIContext } from \"@earendil-works/pi-coding-agent\";\nimport type { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport {\n  ElicitRequestSchema,\n  ErrorCode,\n  McpError,\n  type ElicitRequest,\n  type ElicitRequestFormParams,\n  type ElicitRequestURLParams,\n  type ElicitResult,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { AjvJsonSchemaValidator } from \"@modelcontextprotocol/sdk/validation/ajv\";\nimport type { JsonSchemaType } from \"@modelcontextprotocol/sdk/validation/types.js\";\nimport open from \"open\";\n\nexport type ElicitationValue = string | number | boolean | string[] | undefined;\ntype FormProperty = ElicitRequestFormParams[\"requestedSchema\"][\"properties\"][string];\n\nexport type ElicitationUIContext = ExtensionUIContext;\n\nexport interface ElicitationHandlerOptions {\n  serverName: string;\n  ui: ElicitationUIContext;\n  allowUrl: boolean;\n  onUrlAccepted?: (elicitationId: string) => void;\n}\n\nexport type ServerElicitationConfig = Omit<ElicitationHandlerOptions, \"serverName\" | \"onUrlAccepted\">;\n\nexport function registerElicitationHandler(client: Client, options: ElicitationHandlerOptions): void {\n  client.setRequestHandler(ElicitRequestSchema, (request) =>\n    handleElicitationRequest(options, request));\n}\n\nexport async function handleElicitationRequest(\n  options: ElicitationHandlerOptions,\n  request: ElicitRequest,\n): Promise<ElicitResult> {\n  return request.params.mode === \"url\"\n    ? handleUrlElicitation(options, request.params)\n    : handleFormElicitation(options, request.params);\n}\n\nexport async function handleFormElicitation(\n  options: ElicitationHandlerOptions,\n  params: ElicitRequestFormParams,\n): Promise<ElicitResult> {\n  const decision = await options.ui.select(\n    `MCP Input Request\\nServer: ${options.serverName}\\n\\n${params.message}`,\n    [\"Continue\", \"Decline\"],\n  );\n  if (decision === undefined) return { action: \"cancel\" };\n  if (decision === \"Decline\") return { action: \"decline\" };\n\n  const values: Record<string, ElicitationValue> = {};\n  const properties = Object.entries(params.requestedSchema.properties);\n  for (const [name, schema] of properties) {\n    const value = await collectValidField(options.ui, params, name, schema);\n    if (!(\"value\" in value)) return { action: \"cancel\" };\n    values[name] = value.value;\n  }\n\n  while (true) {\n    const content = coerceAndValidateFormValues(params, values);\n    const action = await options.ui.select(\n      formatReview(options.serverName, properties, content),\n      properties.length > 0 ? [\"Submit\", \"Edit\", \"Decline\"] : [\"Submit\", \"Decline\"],\n    );\n    if (action === undefined) return { action: \"cancel\" };\n    if (action === \"Decline\") return { action: \"decline\" };\n    if (action === \"Submit\") return { action: \"accept\", content };\n\n    const labels = properties.map(([name, schema]) => `${schema.title ?? humanizeName(name)} (${name})`);\n    const selected = await options.ui.select(\"Choose a field to edit\", labels);\n    if (selected === undefined) return { action: \"cancel\" };\n    const property = properties[labels.indexOf(selected)];\n    if (!property) continue;\n    const [name, schema] = property;\n    const value = await collectValidField(options.ui, params, name, schema, values[name]);\n    if (!(\"value\" in value)) return { action: \"cancel\" };\n    values[name] = value.value;\n  }\n}\n\nasync function collectValidField(\n  ui: ElicitationUIContext,\n  params: ElicitRequestFormParams,\n  name: string,\n  schema: FormProperty,\n  current?: ElicitationValue,\n): Promise<{ cancelled: true } | { cancelled: false; value: ElicitationValue }> {\n  const required = params.requestedSchema.required?.includes(name) === true;\n  while (true) {\n    const result = await collectField(ui, params, name, schema, current);\n    if (!(\"value\" in result)) return result;\n    try {\n      coerceAndValidateFormValues({\n        ...params,\n        requestedSchema: {\n          type: \"object\",\n          properties: { [name]: schema },\n          ...(required ? { required: [name] } : {}),\n        },\n      }, { [name]: result.value });\n      return result;\n    } catch (error) {\n      ui.notify(error instanceof Error ? error.message : String(error), \"error\");\n      current = result.value;\n    }\n  }\n}\n\nasync function collectField(\n  ui: ElicitationUIContext,\n  params: ElicitRequestFormParams,\n  name: string,\n  schema: FormProperty,\n  current?: ElicitationValue,\n): Promise<{ cancelled: true } | { cancelled: false; value: ElicitationValue }> {\n  const required = params.requestedSchema.required?.includes(name) === true;\n  const title = [schema.title ?? humanizeName(name), required ? \"(required)\" : \"\", schema.description]\n    .filter(Boolean)\n    .join(\" \");\n\n  if (schema.type === \"string\" && (\"enum\" in schema || \"oneOf\" in schema)) {\n    const choices = \"oneOf\" in schema\n      ? schema.oneOf.map(option => ({ value: option.const, display: formatChoice(option.const, option.title) }))\n      : schema.enum.map((value, index) => ({\n          value,\n          display: formatChoice(value, \"enumNames\" in schema ? schema.enumNames?.[index] : undefined),\n        }));\n    const displays = uniqueLabels(choices.map(choice => choice.display));\n    const actions = [...displays];\n    const useDefault = schema.default === undefined ? undefined : uniqueAction(\"Use default\", actions);\n    if (useDefault) actions.push(useDefault);\n    const omit = required ? undefined : uniqueAction(\"Omit\", actions);\n    if (omit) actions.push(omit);\n    const action = await ui.select(title, actions);\n    if (action === undefined) return { cancelled: true };\n    if (action === useDefault) return { cancelled: false, value: schema.default };\n    if (action === omit) return { cancelled: false, value: undefined };\n    return { cancelled: false, value: choices[displays.indexOf(action)]?.value };\n  }\n\n  if (schema.type === \"boolean\") {\n    const actions = [\"Yes\", \"No\"];\n    if (schema.default !== undefined) actions.push(\"Use default\");\n    if (!required) actions.push(\"Omit\");\n    const action = await ui.select(title, actions);\n    if (action === undefined) return { cancelled: true };\n    if (action === \"Use default\") return { cancelled: false, value: schema.default };\n    if (action === \"Omit\") return { cancelled: false, value: undefined };\n    return { cancelled: false, value: action === \"Yes\" };\n  }\n\n  if (schema.type === \"array\") {\n    const actions = [\"Choose values\"];\n    if (schema.default !== undefined) actions.push(\"Use default\");\n    if (!required) actions.push(\"Omit\");\n    const action = await ui.select(title, actions);\n    if (action === undefined) return { cancelled: true };\n    if (action === \"Use default\") return { cancelled: false, value: schema.default };\n    if (action === \"Omit\") return { cancelled: false, value: undefined };\n\n    const choices = extractMultiSelectOptions(schema);\n    const selected = new Set(Array.isArray(current) ? current : []);\n    while (true) {\n      const displays = uniqueLabels(choices.map(choice => selected.has(choice.value) ? `✓ ${choice.display}` : choice.display));\n      const done = uniqueAction(\"Done\", displays);\n      const picked = await ui.select(title, [...displays, done]);\n      if (picked === undefined) return { cancelled: true };\n      if (picked === done) return { cancelled: false, value: [...selected] };\n      const choice = choices[displays.indexOf(picked)];\n      if (!choice) continue;\n      if (selected.has(choice.value)) selected.delete(choice.value);\n      else selected.add(choice.value);\n    }\n  }\n\n  const actions = [\"Enter value\"];\n  if (schema.default !== undefined) actions.push(\"Use default\");\n  if (!required) actions.push(\"Omit\");\n  const action = await ui.select(title, actions);\n  if (action === undefined) return { cancelled: true };\n  if (action === \"Use default\") return { cancelled: false, value: schema.default };\n  if (action === \"Omit\") return { cancelled: false, value: undefined };\n  const entered = await ui.input(title, current === undefined ? undefined : String(current));\n  return entered === undefined ? { cancelled: true } : { cancelled: false, value: entered };\n}\n\nexport function coerceAndValidateFormValues(\n  params: ElicitRequestFormParams,\n  values: Record<string, ElicitationValue>,\n): Record<string, string | number | boolean | string[]> {\n  const output: Record<string, string | number | boolean | string[]> = {};\n  const required = new Set(params.requestedSchema.required ?? []);\n  for (const [name, schema] of Object.entries(params.requestedSchema.properties)) {\n    const value = values[name];\n    if (value === undefined) {\n      if (required.has(name)) throw new Error(`Missing required elicitation field: ${name}`);\n      continue;\n    }\n    if (schema.type === \"string\") {\n      const stringValue = String(value);\n      const limits = schema as typeof schema & { minLength?: number; maxLength?: number };\n      if (limits.minLength !== undefined && stringValue.length < limits.minLength) {\n        throw new Error(`Elicitation field ${name} is shorter than minimum length ${limits.minLength}`);\n      }\n      if (limits.maxLength !== undefined && stringValue.length > limits.maxLength) {\n        throw new Error(`Elicitation field ${name} is longer than maximum length ${limits.maxLength}`);\n      }\n      if (\"enum\" in schema && !schema.enum.includes(stringValue)) {\n        throw new Error(`Elicitation field ${name} is not an allowed value`);\n      }\n      if (\"oneOf\" in schema && !schema.oneOf.some(option => option.const === stringValue)) {\n        throw new Error(`Elicitation field ${name} is not an allowed value`);\n      }\n      output[name] = stringValue;\n      continue;\n    }\n    if (schema.type === \"number\" || schema.type === \"integer\") {\n      if (typeof value === \"string\" && value.trim() === \"\") {\n        throw new Error(`Elicitation field ${name} must be a number`);\n      }\n      const numberValue = typeof value === \"number\" ? value : Number(value);\n      if (!Number.isFinite(numberValue)) throw new Error(`Elicitation field ${name} must be a number`);\n      if (schema.type === \"integer\" && !Number.isInteger(numberValue)) {\n        throw new Error(`Elicitation field ${name} must be an integer`);\n      }\n      if (schema.minimum !== undefined && numberValue < schema.minimum) {\n        throw new Error(`Elicitation field ${name} is below minimum ${schema.minimum}`);\n      }\n      if (schema.maximum !== undefined && numberValue > schema.maximum) {\n        throw new Error(`Elicitation field ${name} is above maximum ${schema.maximum}`);\n      }\n      output[name] = numberValue;\n      continue;\n    }\n    if (schema.type === \"boolean\") {\n      output[name] = typeof value === \"boolean\" ? value : value === \"true\";\n      continue;\n    }\n    if (schema.type === \"array\") {\n      if (!Array.isArray(value)) throw new Error(`Elicitation field ${name} must be a list`);\n      const allowed = new Set(extractMultiSelectOptions(schema).map(option => option.value));\n      const arrayValue = value.map(String);\n      if (schema.minItems !== undefined && arrayValue.length < schema.minItems) {\n        throw new Error(`Elicitation field ${name} has fewer than ${schema.minItems} selections`);\n      }\n      if (schema.maxItems !== undefined && arrayValue.length > schema.maxItems) {\n        throw new Error(`Elicitation field ${name} has more than ${schema.maxItems} selections`);\n      }\n      if (arrayValue.some(item => !allowed.has(item))) {\n        throw new Error(`Elicitation field ${name} contains an invalid selection`);\n      }\n      output[name] = arrayValue;\n    }\n  }\n  const validation = new AjvJsonSchemaValidator()\n    .getValidator(params.requestedSchema as JsonSchemaType)(output);\n  if (!validation.valid) {\n    throw new Error(`Invalid elicitation response: ${validation.errorMessage}`);\n  }\n  return output;\n}\n\nfunction formatChoice(value: string, title?: string): string {\n  return title && title !== value ? `${title} (${value})` : value;\n}\n\nfunction uniqueLabels(labels: string[]): string[] {\n  const used = new Set<string>();\n  return labels.map(label => {\n    let unique = label;\n    while (used.has(unique)) unique += \"…\";\n    used.add(unique);\n    return unique;\n  });\n}\n\nfunction uniqueAction(label: string, choices: string[]): string {\n  let unique = label;\n  while (choices.includes(unique)) unique += \"…\";\n  return unique;\n}\n\nfunction extractMultiSelectOptions(schema: Extract<FormProperty, { type: \"array\" }>): Array<{ value: string; display: string }> {\n  const items = schema.items as { enum?: string[]; anyOf?: Array<{ const: string; title: string }> };\n  return items.anyOf\n    ? items.anyOf.map(option => ({ value: option.const, display: formatChoice(option.const, option.title) }))\n    : (items.enum ?? []).map(value => ({ value, display: value }));\n}\n\nfunction formatReview(\n  serverName: string,\n  properties: Array<[string, FormProperty]>,\n  content: Record<string, string | number | boolean | string[]>,\n): string {\n  const rows = properties.map(([name, schema]) =>\n    `${schema.title ?? humanizeName(name)}: ${content[name] === undefined ? \"(omitted)\" : String(content[name])}`);\n  return [`Review input for ${serverName}`, \"\", ...rows].join(\"\\n\");\n}\n\nexport async function handleUrlElicitation(\n  options: ElicitationHandlerOptions,\n  params: ElicitRequestURLParams,\n): Promise<ElicitResult> {\n  if (!options.allowUrl) throw new McpError(ErrorCode.InvalidParams, \"URL elicitation is not supported\");\n\n  let parsed: URL;\n  try {\n    parsed = new URL(params.url);\n  } catch {\n    throw new McpError(ErrorCode.InvalidParams, \"URL elicitation supplied an invalid URL\");\n  }\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new McpError(ErrorCode.InvalidParams, \"URL elicitation only supports HTTP and HTTPS URLs\");\n  }\n\n  const decision = await options.ui.select([\n    \"MCP Browser Request\",\n    `Server: ${options.serverName}`,\n    \"\",\n    params.message,\n    \"\",\n    `Host: ${parsed.host}`,\n    `Full URL: ${params.url}`,\n    \"\",\n    \"Open this URL in your browser?\",\n  ].join(\"\\n\"), [\"Open\", \"Decline\"]);\n  if (decision === undefined) return { action: \"cancel\" };\n  if (decision === \"Decline\") return { action: \"decline\" };\n\n  try {\n    await open(params.url);\n  } catch (error) {\n    options.ui.notify(`Could not open MCP elicitation URL: ${error instanceof Error ? error.message : String(error)}`, \"error\");\n    return { action: \"cancel\" };\n  }\n  options.onUrlAccepted?.(params.elicitationId);\n  options.ui.notify(\"Opened browser for MCP elicitation.\", \"info\");\n  return { action: \"accept\" };\n}\n\nfunction humanizeName(name: string): string {\n  return name.replace(/[_-]+/g, \" \").replace(/([a-z0-9])([A-Z])/g, \"$1 $2\").replace(/^./, char => char.toUpperCase());\n}\n"]}

package/dist/builtin-extensions/pi-mcp-adapter/elicitation-handler.js

@@ -0,0 +1,309 @@
+import { ElicitRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { AjvJsonSchemaValidator } from "@modelcontextprotocol/sdk/validation/ajv";
+import open from "open";
+export function registerElicitationHandler(client, options) {
+    client.setRequestHandler(ElicitRequestSchema, (request) => handleElicitationRequest(options, request));
+}
+export async function handleElicitationRequest(options, request) {
+    return request.params.mode === "url"
+        ? handleUrlElicitation(options, request.params)
+        : handleFormElicitation(options, request.params);
+}
+export async function handleFormElicitation(options, params) {
+    const decision = await options.ui.select(`MCP Input Request\nServer: ${options.serverName}\n\n${params.message}`, ["Continue", "Decline"]);
+    if (decision === undefined)
+        return { action: "cancel" };
+    if (decision === "Decline")
+        return { action: "decline" };
+    const values = {};
+    const properties = Object.entries(params.requestedSchema.properties);
+    for (const [name, schema] of properties) {
+        const value = await collectValidField(options.ui, params, name, schema);
+        if (!("value" in value))
+            return { action: "cancel" };
+        values[name] = value.value;
+    }
+    while (true) {
+        const content = coerceAndValidateFormValues(params, values);
+        const action = await options.ui.select(formatReview(options.serverName, properties, content), properties.length > 0 ? ["Submit", "Edit", "Decline"] : ["Submit", "Decline"]);
+        if (action === undefined)
+            return { action: "cancel" };
+        if (action === "Decline")
+            return { action: "decline" };
+        if (action === "Submit")
+            return { action: "accept", content };
+        const labels = properties.map(([name, schema]) => `${schema.title ?? humanizeName(name)} (${name})`);
+        const selected = await options.ui.select("Choose a field to edit", labels);
+        if (selected === undefined)
+            return { action: "cancel" };
+        const property = properties[labels.indexOf(selected)];
+        if (!property)
+            continue;
+        const [name, schema] = property;
+        const value = await collectValidField(options.ui, params, name, schema, values[name]);
+        if (!("value" in value))
+            return { action: "cancel" };
+        values[name] = value.value;
+    }
+}
+async function collectValidField(ui, params, name, schema, current) {
+    const required = params.requestedSchema.required?.includes(name) === true;
+    while (true) {
+        const result = await collectField(ui, params, name, schema, current);
+        if (!("value" in result))
+            return result;
+        try {
+            coerceAndValidateFormValues({
+                ...params,
+                requestedSchema: {
+                    type: "object",
+                    properties: { [name]: schema },
+                    ...(required ? { required: [name] } : {}),
+                },
+            }, { [name]: result.value });
+            return result;
+        }
+        catch (error) {
+            ui.notify(error instanceof Error ? error.message : String(error), "error");
+            current = result.value;
+        }
+    }
+}
+async function collectField(ui, params, name, schema, current) {
+    const required = params.requestedSchema.required?.includes(name) === true;
+    const title = [schema.title ?? humanizeName(name), required ? "(required)" : "", schema.description]
+        .filter(Boolean)
+        .join(" ");
+    if (schema.type === "string" && ("enum" in schema || "oneOf" in schema)) {
+        const choices = "oneOf" in schema
+            ? schema.oneOf.map(option => ({ value: option.const, display: formatChoice(option.const, option.title) }))
+            : schema.enum.map((value, index) => ({
+                value,
+                display: formatChoice(value, "enumNames" in schema ? schema.enumNames?.[index] : undefined),
+            }));
+        const displays = uniqueLabels(choices.map(choice => choice.display));
+        const actions = [...displays];
+        const useDefault = schema.default === undefined ? undefined : uniqueAction("Use default", actions);
+        if (useDefault)
+            actions.push(useDefault);
+        const omit = required ? undefined : uniqueAction("Omit", actions);
+        if (omit)
+            actions.push(omit);
+        const action = await ui.select(title, actions);
+        if (action === undefined)
+            return { cancelled: true };
+        if (action === useDefault)
+            return { cancelled: false, value: schema.default };
+        if (action === omit)
+            return { cancelled: false, value: undefined };
+        return { cancelled: false, value: choices[displays.indexOf(action)]?.value };
+    }
+    if (schema.type === "boolean") {
+        const actions = ["Yes", "No"];
+        if (schema.default !== undefined)
+            actions.push("Use default");
+        if (!required)
+            actions.push("Omit");
+        const action = await ui.select(title, actions);
+        if (action === undefined)
+            return { cancelled: true };
+        if (action === "Use default")
+            return { cancelled: false, value: schema.default };
+        if (action === "Omit")
+            return { cancelled: false, value: undefined };
+        return { cancelled: false, value: action === "Yes" };
+    }
+    if (schema.type === "array") {
+        const actions = ["Choose values"];
+        if (schema.default !== undefined)
+            actions.push("Use default");
+        if (!required)
+            actions.push("Omit");
+        const action = await ui.select(title, actions);
+        if (action === undefined)
+            return { cancelled: true };
+        if (action === "Use default")
+            return { cancelled: false, value: schema.default };
+        if (action === "Omit")
+            return { cancelled: false, value: undefined };
+        const choices = extractMultiSelectOptions(schema);
+        const selected = new Set(Array.isArray(current) ? current : []);
+        while (true) {
+            const displays = uniqueLabels(choices.map(choice => selected.has(choice.value) ? `✓ ${choice.display}` : choice.display));
+            const done = uniqueAction("Done", displays);
+            const picked = await ui.select(title, [...displays, done]);
+            if (picked === undefined)
+                return { cancelled: true };
+            if (picked === done)
+                return { cancelled: false, value: [...selected] };
+            const choice = choices[displays.indexOf(picked)];
+            if (!choice)
+                continue;
+            if (selected.has(choice.value))
+                selected.delete(choice.value);
+            else
+                selected.add(choice.value);
+        }
+    }
+    const actions = ["Enter value"];
+    if (schema.default !== undefined)
+        actions.push("Use default");
+    if (!required)
+        actions.push("Omit");
+    const action = await ui.select(title, actions);
+    if (action === undefined)
+        return { cancelled: true };
+    if (action === "Use default")
+        return { cancelled: false, value: schema.default };
+    if (action === "Omit")
+        return { cancelled: false, value: undefined };
+    const entered = await ui.input(title, current === undefined ? undefined : String(current));
+    return entered === undefined ? { cancelled: true } : { cancelled: false, value: entered };
+}
+export function coerceAndValidateFormValues(params, values) {
+    const output = {};
+    const required = new Set(params.requestedSchema.required ?? []);
+    for (const [name, schema] of Object.entries(params.requestedSchema.properties)) {
+        const value = values[name];
+        if (value === undefined) {
+            if (required.has(name))
+                throw new Error(`Missing required elicitation field: ${name}`);
+            continue;
+        }
+        if (schema.type === "string") {
+            const stringValue = String(value);
+            const limits = schema;
+            if (limits.minLength !== undefined && stringValue.length < limits.minLength) {
+                throw new Error(`Elicitation field ${name} is shorter than minimum length ${limits.minLength}`);
+            }
+            if (limits.maxLength !== undefined && stringValue.length > limits.maxLength) {
+                throw new Error(`Elicitation field ${name} is longer than maximum length ${limits.maxLength}`);
+            }
+            if ("enum" in schema && !schema.enum.includes(stringValue)) {
+                throw new Error(`Elicitation field ${name} is not an allowed value`);
+            }
+            if ("oneOf" in schema && !schema.oneOf.some(option => option.const === stringValue)) {
+                throw new Error(`Elicitation field ${name} is not an allowed value`);
+            }
+            output[name] = stringValue;
+            continue;
+        }
+        if (schema.type === "number" || schema.type === "integer") {
+            if (typeof value === "string" && value.trim() === "") {
+                throw new Error(`Elicitation field ${name} must be a number`);
+            }
+            const numberValue = typeof value === "number" ? value : Number(value);
+            if (!Number.isFinite(numberValue))
+                throw new Error(`Elicitation field ${name} must be a number`);
+            if (schema.type === "integer" && !Number.isInteger(numberValue)) {
+                throw new Error(`Elicitation field ${name} must be an integer`);
+            }
+            if (schema.minimum !== undefined && numberValue < schema.minimum) {
+                throw new Error(`Elicitation field ${name} is below minimum ${schema.minimum}`);
+            }
+            if (schema.maximum !== undefined && numberValue > schema.maximum) {
+                throw new Error(`Elicitation field ${name} is above maximum ${schema.maximum}`);
+            }
+            output[name] = numberValue;
+            continue;
+        }
+        if (schema.type === "boolean") {
+            output[name] = typeof value === "boolean" ? value : value === "true";
+            continue;
+        }
+        if (schema.type === "array") {
+            if (!Array.isArray(value))
+                throw new Error(`Elicitation field ${name} must be a list`);
+            const allowed = new Set(extractMultiSelectOptions(schema).map(option => option.value));
+            const arrayValue = value.map(String);
+            if (schema.minItems !== undefined && arrayValue.length < schema.minItems) {
+                throw new Error(`Elicitation field ${name} has fewer than ${schema.minItems} selections`);
+            }
+            if (schema.maxItems !== undefined && arrayValue.length > schema.maxItems) {
+                throw new Error(`Elicitation field ${name} has more than ${schema.maxItems} selections`);
+            }
+            if (arrayValue.some(item => !allowed.has(item))) {
+                throw new Error(`Elicitation field ${name} contains an invalid selection`);
+            }
+            output[name] = arrayValue;
+        }
+    }
+    const validation = new AjvJsonSchemaValidator()
+        .getValidator(params.requestedSchema)(output);
+    if (!validation.valid) {
+        throw new Error(`Invalid elicitation response: ${validation.errorMessage}`);
+    }
+    return output;
+}
+function formatChoice(value, title) {
+    return title && title !== value ? `${title} (${value})` : value;
+}
+function uniqueLabels(labels) {
+    const used = new Set();
+    return labels.map(label => {
+        let unique = label;
+        while (used.has(unique))
+            unique += "…";
+        used.add(unique);
+        return unique;
+    });
+}
+function uniqueAction(label, choices) {
+    let unique = label;
+    while (choices.includes(unique))
+        unique += "…";
+    return unique;
+}
+function extractMultiSelectOptions(schema) {
+    const items = schema.items;
+    return items.anyOf
+        ? items.anyOf.map(option => ({ value: option.const, display: formatChoice(option.const, option.title) }))
+        : (items.enum ?? []).map(value => ({ value, display: value }));
+}
+function formatReview(serverName, properties, content) {
+    const rows = properties.map(([name, schema]) => `${schema.title ?? humanizeName(name)}: ${content[name] === undefined ? "(omitted)" : String(content[name])}`);
+    return [`Review input for ${serverName}`, "", ...rows].join("\n");
+}
+export async function handleUrlElicitation(options, params) {
+    if (!options.allowUrl)
+        throw new McpError(ErrorCode.InvalidParams, "URL elicitation is not supported");
+    let parsed;
+    try {
+        parsed = new URL(params.url);
+    }
+    catch {
+        throw new McpError(ErrorCode.InvalidParams, "URL elicitation supplied an invalid URL");
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new McpError(ErrorCode.InvalidParams, "URL elicitation only supports HTTP and HTTPS URLs");
+    }
+    const decision = await options.ui.select([
+        "MCP Browser Request",
+        `Server: ${options.serverName}`,
+        "",
+        params.message,
+        "",
+        `Host: ${parsed.host}`,
+        `Full URL: ${params.url}`,
+        "",
+        "Open this URL in your browser?",
+    ].join("\n"), ["Open", "Decline"]);
+    if (decision === undefined)
+        return { action: "cancel" };
+    if (decision === "Decline")
+        return { action: "decline" };
+    try {
+        await open(params.url);
+    }
+    catch (error) {
+        options.ui.notify(`Could not open MCP elicitation URL: ${error instanceof Error ? error.message : String(error)}`, "error");
+        return { action: "cancel" };
+    }
+    options.onUrlAccepted?.(params.elicitationId);
+    options.ui.notify("Opened browser for MCP elicitation.", "info");
+    return { action: "accept" };
+}
+function humanizeName(name) {
+    return name.replace(/[_-]+/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/^./, char => char.toUpperCase());
+}
+//# sourceMappingURL=elicitation-handler.js.map

package/dist/builtin-extensions/pi-mcp-adapter/elicitation-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation-handler.js","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/elicitation-handler.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport type { ExtensionUIContext } from \"@earendil-works/pi-coding-agent\";\nimport type { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport {\n  ElicitRequestSchema,\n  ErrorCode,\n  McpError,\n  type ElicitRequest,\n  type ElicitRequestFormParams,\n  type ElicitRequestURLParams,\n  type ElicitResult,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { AjvJsonSchemaValidator } from \"@modelcontextprotocol/sdk/validation/ajv\";\nimport type { JsonSchemaType } from \"@modelcontextprotocol/sdk/validation/types.js\";\nimport open from \"open\";\n\nexport type ElicitationValue = string | number | boolean | string[] | undefined;\ntype FormProperty = ElicitRequestFormParams[\"requestedSchema\"][\"properties\"][string];\n\nexport type ElicitationUIContext = ExtensionUIContext;\n\nexport interface ElicitationHandlerOptions {\n  serverName: string;\n  ui: ElicitationUIContext;\n  allowUrl: boolean;\n  onUrlAccepted?: (elicitationId: string) => void;\n}\n\nexport type ServerElicitationConfig = Omit<ElicitationHandlerOptions, \"serverName\" | \"onUrlAccepted\">;\n\nexport function registerElicitationHandler(client: Client, options: ElicitationHandlerOptions): void {\n  client.setRequestHandler(ElicitRequestSchema, (request) =>\n    handleElicitationRequest(options, request));\n}\n\nexport async function handleElicitationRequest(\n  options: ElicitationHandlerOptions,\n  request: ElicitRequest,\n): Promise<ElicitResult> {\n  return request.params.mode === \"url\"\n    ? handleUrlElicitation(options, request.params)\n    : handleFormElicitation(options, request.params);\n}\n\nexport async function handleFormElicitation(\n  options: ElicitationHandlerOptions,\n  params: ElicitRequestFormParams,\n): Promise<ElicitResult> {\n  const decision = await options.ui.select(\n    `MCP Input Request\\nServer: ${options.serverName}\\n\\n${params.message}`,\n    [\"Continue\", \"Decline\"],\n  );\n  if (decision === undefined) return { action: \"cancel\" };\n  if (decision === \"Decline\") return { action: \"decline\" };\n\n  const values: Record<string, ElicitationValue> = {};\n  const properties = Object.entries(params.requestedSchema.properties);\n  for (const [name, schema] of properties) {\n    const value = await collectValidField(options.ui, params, name, schema);\n    if (!(\"value\" in value)) return { action: \"cancel\" };\n    values[name] = value.value;\n  }\n\n  while (true) {\n    const content = coerceAndValidateFormValues(params, values);\n    const action = await options.ui.select(\n      formatReview(options.serverName, properties, content),\n      properties.length > 0 ? [\"Submit\", \"Edit\", \"Decline\"] : [\"Submit\", \"Decline\"],\n    );\n    if (action === undefined) return { action: \"cancel\" };\n    if (action === \"Decline\") return { action: \"decline\" };\n    if (action === \"Submit\") return { action: \"accept\", content };\n\n    const labels = properties.map(([name, schema]) => `${schema.title ?? humanizeName(name)} (${name})`);\n    const selected = await options.ui.select(\"Choose a field to edit\", labels);\n    if (selected === undefined) return { action: \"cancel\" };\n    const property = properties[labels.indexOf(selected)];\n    if (!property) continue;\n    const [name, schema] = property;\n    const value = await collectValidField(options.ui, params, name, schema, values[name]);\n    if (!(\"value\" in value)) return { action: \"cancel\" };\n    values[name] = value.value;\n  }\n}\n\nasync function collectValidField(\n  ui: ElicitationUIContext,\n  params: ElicitRequestFormParams,\n  name: string,\n  schema: FormProperty,\n  current?: ElicitationValue,\n): Promise<{ cancelled: true } | { cancelled: false; value: ElicitationValue }> {\n  const required = params.requestedSchema.required?.includes(name) === true;\n  while (true) {\n    const result = await collectField(ui, params, name, schema, current);\n    if (!(\"value\" in result)) return result;\n    try {\n      coerceAndValidateFormValues({\n        ...params,\n        requestedSchema: {\n          type: \"object\",\n          properties: { [name]: schema },\n          ...(required ? { required: [name] } : {}),\n        },\n      }, { [name]: result.value });\n      return result;\n    } catch (error) {\n      ui.notify(error instanceof Error ? error.message : String(error), \"error\");\n      current = result.value;\n    }\n  }\n}\n\nasync function collectField(\n  ui: ElicitationUIContext,\n  params: ElicitRequestFormParams,\n  name: string,\n  schema: FormProperty,\n  current?: ElicitationValue,\n): Promise<{ cancelled: true } | { cancelled: false; value: ElicitationValue }> {\n  const required = params.requestedSchema.required?.includes(name) === true;\n  const title = [schema.title ?? humanizeName(name), required ? \"(required)\" : \"\", schema.description]\n    .filter(Boolean)\n    .join(\" \");\n\n  if (schema.type === \"string\" && (\"enum\" in schema || \"oneOf\" in schema)) {\n    const choices = \"oneOf\" in schema\n      ? schema.oneOf.map(option => ({ value: option.const, display: formatChoice(option.const, option.title) }))\n      : schema.enum.map((value, index) => ({\n          value,\n          display: formatChoice(value, \"enumNames\" in schema ? schema.enumNames?.[index] : undefined),\n        }));\n    const displays = uniqueLabels(choices.map(choice => choice.display));\n    const actions = [...displays];\n    const useDefault = schema.default === undefined ? undefined : uniqueAction(\"Use default\", actions);\n    if (useDefault) actions.push(useDefault);\n    const omit = required ? undefined : uniqueAction(\"Omit\", actions);\n    if (omit) actions.push(omit);\n    const action = await ui.select(title, actions);\n    if (action === undefined) return { cancelled: true };\n    if (action === useDefault) return { cancelled: false, value: schema.default };\n    if (action === omit) return { cancelled: false, value: undefined };\n    return { cancelled: false, value: choices[displays.indexOf(action)]?.value };\n  }\n\n  if (schema.type === \"boolean\") {\n    const actions = [\"Yes\", \"No\"];\n    if (schema.default !== undefined) actions.push(\"Use default\");\n    if (!required) actions.push(\"Omit\");\n    const action = await ui.select(title, actions);\n    if (action === undefined) return { cancelled: true };\n    if (action === \"Use default\") return { cancelled: false, value: schema.default };\n    if (action === \"Omit\") return { cancelled: false, value: undefined };\n    return { cancelled: false, value: action === \"Yes\" };\n  }\n\n  if (schema.type === \"array\") {\n    const actions = [\"Choose values\"];\n    if (schema.default !== undefined) actions.push(\"Use default\");\n    if (!required) actions.push(\"Omit\");\n    const action = await ui.select(title, actions);\n    if (action === undefined) return { cancelled: true };\n    if (action === \"Use default\") return { cancelled: false, value: schema.default };\n    if (action === \"Omit\") return { cancelled: false, value: undefined };\n\n    const choices = extractMultiSelectOptions(schema);\n    const selected = new Set(Array.isArray(current) ? current : []);\n    while (true) {\n      const displays = uniqueLabels(choices.map(choice => selected.has(choice.value) ? `✓ ${choice.display}` : choice.display));\n      const done = uniqueAction(\"Done\", displays);\n      const picked = await ui.select(title, [...displays, done]);\n      if (picked === undefined) return { cancelled: true };\n      if (picked === done) return { cancelled: false, value: [...selected] };\n      const choice = choices[displays.indexOf(picked)];\n      if (!choice) continue;\n      if (selected.has(choice.value)) selected.delete(choice.value);\n      else selected.add(choice.value);\n    }\n  }\n\n  const actions = [\"Enter value\"];\n  if (schema.default !== undefined) actions.push(\"Use default\");\n  if (!required) actions.push(\"Omit\");\n  const action = await ui.select(title, actions);\n  if (action === undefined) return { cancelled: true };\n  if (action === \"Use default\") return { cancelled: false, value: schema.default };\n  if (action === \"Omit\") return { cancelled: false, value: undefined };\n  const entered = await ui.input(title, current === undefined ? undefined : String(current));\n  return entered === undefined ? { cancelled: true } : { cancelled: false, value: entered };\n}\n\nexport function coerceAndValidateFormValues(\n  params: ElicitRequestFormParams,\n  values: Record<string, ElicitationValue>,\n): Record<string, string | number | boolean | string[]> {\n  const output: Record<string, string | number | boolean | string[]> = {};\n  const required = new Set(params.requestedSchema.required ?? []);\n  for (const [name, schema] of Object.entries(params.requestedSchema.properties)) {\n    const value = values[name];\n    if (value === undefined) {\n      if (required.has(name)) throw new Error(`Missing required elicitation field: ${name}`);\n      continue;\n    }\n    if (schema.type === \"string\") {\n      const stringValue = String(value);\n      const limits = schema as typeof schema & { minLength?: number; maxLength?: number };\n      if (limits.minLength !== undefined && stringValue.length < limits.minLength) {\n        throw new Error(`Elicitation field ${name} is shorter than minimum length ${limits.minLength}`);\n      }\n      if (limits.maxLength !== undefined && stringValue.length > limits.maxLength) {\n        throw new Error(`Elicitation field ${name} is longer than maximum length ${limits.maxLength}`);\n      }\n      if (\"enum\" in schema && !schema.enum.includes(stringValue)) {\n        throw new Error(`Elicitation field ${name} is not an allowed value`);\n      }\n      if (\"oneOf\" in schema && !schema.oneOf.some(option => option.const === stringValue)) {\n        throw new Error(`Elicitation field ${name} is not an allowed value`);\n      }\n      output[name] = stringValue;\n      continue;\n    }\n    if (schema.type === \"number\" || schema.type === \"integer\") {\n      if (typeof value === \"string\" && value.trim() === \"\") {\n        throw new Error(`Elicitation field ${name} must be a number`);\n      }\n      const numberValue = typeof value === \"number\" ? value : Number(value);\n      if (!Number.isFinite(numberValue)) throw new Error(`Elicitation field ${name} must be a number`);\n      if (schema.type === \"integer\" && !Number.isInteger(numberValue)) {\n        throw new Error(`Elicitation field ${name} must be an integer`);\n      }\n      if (schema.minimum !== undefined && numberValue < schema.minimum) {\n        throw new Error(`Elicitation field ${name} is below minimum ${schema.minimum}`);\n      }\n      if (schema.maximum !== undefined && numberValue > schema.maximum) {\n        throw new Error(`Elicitation field ${name} is above maximum ${schema.maximum}`);\n      }\n      output[name] = numberValue;\n      continue;\n    }\n    if (schema.type === \"boolean\") {\n      output[name] = typeof value === \"boolean\" ? value : value === \"true\";\n      continue;\n    }\n    if (schema.type === \"array\") {\n      if (!Array.isArray(value)) throw new Error(`Elicitation field ${name} must be a list`);\n      const allowed = new Set(extractMultiSelectOptions(schema).map(option => option.value));\n      const arrayValue = value.map(String);\n      if (schema.minItems !== undefined && arrayValue.length < schema.minItems) {\n        throw new Error(`Elicitation field ${name} has fewer than ${schema.minItems} selections`);\n      }\n      if (schema.maxItems !== undefined && arrayValue.length > schema.maxItems) {\n        throw new Error(`Elicitation field ${name} has more than ${schema.maxItems} selections`);\n      }\n      if (arrayValue.some(item => !allowed.has(item))) {\n        throw new Error(`Elicitation field ${name} contains an invalid selection`);\n      }\n      output[name] = arrayValue;\n    }\n  }\n  const validation = new AjvJsonSchemaValidator()\n    .getValidator(params.requestedSchema as JsonSchemaType)(output);\n  if (!validation.valid) {\n    throw new Error(`Invalid elicitation response: ${validation.errorMessage}`);\n  }\n  return output;\n}\n\nfunction formatChoice(value: string, title?: string): string {\n  return title && title !== value ? `${title} (${value})` : value;\n}\n\nfunction uniqueLabels(labels: string[]): string[] {\n  const used = new Set<string>();\n  return labels.map(label => {\n    let unique = label;\n    while (used.has(unique)) unique += \"…\";\n    used.add(unique);\n    return unique;\n  });\n}\n\nfunction uniqueAction(label: string, choices: string[]): string {\n  let unique = label;\n  while (choices.includes(unique)) unique += \"…\";\n  return unique;\n}\n\nfunction extractMultiSelectOptions(schema: Extract<FormProperty, { type: \"array\" }>): Array<{ value: string; display: string }> {\n  const items = schema.items as { enum?: string[]; anyOf?: Array<{ const: string; title: string }> };\n  return items.anyOf\n    ? items.anyOf.map(option => ({ value: option.const, display: formatChoice(option.const, option.title) }))\n    : (items.enum ?? []).map(value => ({ value, display: value }));\n}\n\nfunction formatReview(\n  serverName: string,\n  properties: Array<[string, FormProperty]>,\n  content: Record<string, string | number | boolean | string[]>,\n): string {\n  const rows = properties.map(([name, schema]) =>\n    `${schema.title ?? humanizeName(name)}: ${content[name] === undefined ? \"(omitted)\" : String(content[name])}`);\n  return [`Review input for ${serverName}`, \"\", ...rows].join(\"\\n\");\n}\n\nexport async function handleUrlElicitation(\n  options: ElicitationHandlerOptions,\n  params: ElicitRequestURLParams,\n): Promise<ElicitResult> {\n  if (!options.allowUrl) throw new McpError(ErrorCode.InvalidParams, \"URL elicitation is not supported\");\n\n  let parsed: URL;\n  try {\n    parsed = new URL(params.url);\n  } catch {\n    throw new McpError(ErrorCode.InvalidParams, \"URL elicitation supplied an invalid URL\");\n  }\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new McpError(ErrorCode.InvalidParams, \"URL elicitation only supports HTTP and HTTPS URLs\");\n  }\n\n  const decision = await options.ui.select([\n    \"MCP Browser Request\",\n    `Server: ${options.serverName}`,\n    \"\",\n    params.message,\n    \"\",\n    `Host: ${parsed.host}`,\n    `Full URL: ${params.url}`,\n    \"\",\n    \"Open this URL in your browser?\",\n  ].join(\"\\n\"), [\"Open\", \"Decline\"]);\n  if (decision === undefined) return { action: \"cancel\" };\n  if (decision === \"Decline\") return { action: \"decline\" };\n\n  try {\n    await open(params.url);\n  } catch (error) {\n    options.ui.notify(`Could not open MCP elicitation URL: ${error instanceof Error ? error.message : String(error)}`, \"error\");\n    return { action: \"cancel\" };\n  }\n  options.onUrlAccepted?.(params.elicitationId);\n  options.ui.notify(\"Opened browser for MCP elicitation.\", \"info\");\n  return { action: \"accept\" };\n}\n\nfunction humanizeName(name: string): string {\n  return name.replace(/[_-]+/g, \" \").replace(/([a-z0-9])([A-Z])/g, \"$1 $2\").replace(/^./, char => char.toUpperCase());\n}\n"]}

package/dist/builtin-extensions/pi-mcp-adapter/error-signal.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Decide the `isError` override for a finished tool result in the `tool_result` hook.
+ *
+ * A failed MCP tool call is *returned* (not thrown), tagged `details.error: "tool_error"` (the server
+ * returned an error result) or `"call_failed"` (the call itself threw and was caught). pi never reads a
+ * result-level `isError`, so without this such a call is recorded as a success. Returning
+ * `{ isError: true }` (and nothing else) flips the flag; pi's field-by-field merge keeps the original
+ * `content` and `details` intact.
+ *
+ * Limited to those two codes: the adapter's other `details.error` values (`auth_required`, connection
+ * states, search/validation feedback, ...) are not failed tool calls, so they get no override.
+ */
+export declare function toolErrorOverride(details: unknown): {
+    isError: true;
+} | undefined;
+//# sourceMappingURL=error-signal.d.ts.map

package/dist/builtin-extensions/pi-mcp-adapter/error-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-signal.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/error-signal.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG,SAAS,CAQjF","sourcesContent":["// @ts-nocheck\n/**\n * Decide the `isError` override for a finished tool result in the `tool_result` hook.\n *\n * A failed MCP tool call is *returned* (not thrown), tagged `details.error: \"tool_error\"` (the server\n * returned an error result) or `\"call_failed\"` (the call itself threw and was caught). pi never reads a\n * result-level `isError`, so without this such a call is recorded as a success. Returning\n * `{ isError: true }` (and nothing else) flips the flag; pi's field-by-field merge keeps the original\n * `content` and `details` intact.\n *\n * Limited to those two codes: the adapter's other `details.error` values (`auth_required`, connection\n * states, search/validation feedback, ...) are not failed tool calls, so they get no override.\n */\nexport function toolErrorOverride(details: unknown): { isError: true } | undefined {\n  if (details && typeof details === \"object\" && \"error\" in details) {\n    const code = (details as { error?: unknown }).error;\n    if (code === \"tool_error\" || code === \"call_failed\") {\n      return { isError: true };\n    }\n  }\n  return undefined;\n}\n"]}

package/dist/builtin-extensions/pi-mcp-adapter/error-signal.js

@@ -0,0 +1,23 @@
+// @ts-nocheck
+/**
+ * Decide the `isError` override for a finished tool result in the `tool_result` hook.
+ *
+ * A failed MCP tool call is *returned* (not thrown), tagged `details.error: "tool_error"` (the server
+ * returned an error result) or `"call_failed"` (the call itself threw and was caught). pi never reads a
+ * result-level `isError`, so without this such a call is recorded as a success. Returning
+ * `{ isError: true }` (and nothing else) flips the flag; pi's field-by-field merge keeps the original
+ * `content` and `details` intact.
+ *
+ * Limited to those two codes: the adapter's other `details.error` values (`auth_required`, connection
+ * states, search/validation feedback, ...) are not failed tool calls, so they get no override.
+ */
+export function toolErrorOverride(details) {
+    if (details && typeof details === "object" && "error" in details) {
+        const code = details.error;
+        if (code === "tool_error" || code === "call_failed") {
+            return { isError: true };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=error-signal.js.map

package/dist/builtin-extensions/pi-mcp-adapter/error-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-signal.js","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/error-signal.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAiC;IACjF,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;QACjE,MAAM,IAAI,GAAI,OAA+B,CAAC,KAAK,CAAC;QACpD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CAClB","sourcesContent":["// @ts-nocheck\n/**\n * Decide the `isError` override for a finished tool result in the `tool_result` hook.\n *\n * A failed MCP tool call is *returned* (not thrown), tagged `details.error: \"tool_error\"` (the server\n * returned an error result) or `\"call_failed\"` (the call itself threw and was caught). pi never reads a\n * result-level `isError`, so without this such a call is recorded as a success. Returning\n * `{ isError: true }` (and nothing else) flips the flag; pi's field-by-field merge keeps the original\n * `content` and `details` intact.\n *\n * Limited to those two codes: the adapter's other `details.error` values (`auth_required`, connection\n * states, search/validation feedback, ...) are not failed tool calls, so they get no override.\n */\nexport function toolErrorOverride(details: unknown): { isError: true } | undefined {\n  if (details && typeof details === \"object\" && \"error\" in details) {\n    const code = (details as { error?: unknown }).error;\n    if (code === \"tool_error\" || code === \"call_failed\") {\n      return { isError: true };\n    }\n  }\n  return undefined;\n}\n"]}

package/dist/builtin-extensions/pi-mcp-adapter/errors.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Custom error types for MCP UI operations.
+ * Provides structured errors with context and recovery hints.
+ */
+export interface McpUiErrorContext {
+    server?: string;
+    tool?: string;
+    uri?: string;
+    session?: string;
+    [key: string]: unknown;
+}
+/**
+ * Base error class for MCP UI errors.
+ */
+export declare class McpUiError extends Error {
+    readonly code: string;
+    readonly context: McpUiErrorContext;
+    readonly recoveryHint?: string;
+    readonly cause?: Error;
+    constructor(message: string, options: {
+        code: string;
+        context?: McpUiErrorContext;
+        recoveryHint?: string;
+        cause?: Error;
+    });
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error fetching a UI resource from the MCP server.
+ */
+export declare class ResourceFetchError extends McpUiError {
+    constructor(uri: string, reason: string, options?: {
+        server?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Error parsing or validating UI resource content.
+ */
+export declare class ResourceParseError extends McpUiError {
+    constructor(uri: string, reason: string, options?: {
+        server?: string;
+        mimeType?: string;
+    });
+}
+/**
+ * Error connecting to the AppBridge.
+ */
+export declare class BridgeConnectionError extends McpUiError {
+    constructor(reason: string, options?: {
+        session?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Error related to user consent for tool calls.
+ */
+export declare class ConsentError extends McpUiError {
+    readonly denied: boolean;
+    constructor(server: string, options: {
+        denied?: boolean;
+        requiresApproval?: boolean;
+    });
+}
+/**
+ * Error with UI server session management.
+ */
+export declare class SessionError extends McpUiError {
+    constructor(reason: string, options?: {
+        session?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Error starting or operating the UI server.
+ */
+export declare class ServerError extends McpUiError {
+    constructor(reason: string, options?: {
+        port?: number;
+        cause?: Error;
+    });
+}
+/**
+ * Error communicating with the MCP server.
+ */
+export declare class McpServerError extends McpUiError {
+    constructor(server: string, reason: string, options?: {
+        tool?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Wrap an unknown error into an McpUiError.
+ */
+export declare function wrapError(error: unknown, context?: McpUiErrorContext): McpUiError;
+/**
+ * Check if an error is a specific MCP UI error type.
+ */
+export declare function isErrorCode(error: unknown, code: string): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/builtin-extensions/pi-mcp-adapter/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/errors.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * Custom error types for MCP UI operations.\n * Provides structured errors with context and recovery hints.\n */\n\nexport interface McpUiErrorContext {\n  server?: string;\n  tool?: string;\n  uri?: string;\n  session?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Base error class for MCP UI errors.\n */\nexport class McpUiError extends Error {\n  readonly code: string;\n  readonly context: McpUiErrorContext;\n  readonly recoveryHint?: string;\n  readonly cause?: Error;\n\n  constructor(\n    message: string,\n    options: {\n      code: string;\n      context?: McpUiErrorContext;\n      recoveryHint?: string;\n      cause?: Error;\n    }\n  ) {\n    super(message);\n    this.name = \"McpUiError\";\n    this.code = options.code;\n    this.context = options.context ?? {};\n    this.recoveryHint = options.recoveryHint;\n    this.cause = options.cause;\n\n    // Maintain proper stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      context: this.context,\n      recoveryHint: this.recoveryHint,\n      stack: this.stack,\n    };\n  }\n}\n\n/**\n * Error fetching a UI resource from the MCP server.\n */\nexport class ResourceFetchError extends McpUiError {\n  constructor(\n    uri: string,\n    reason: string,\n    options?: { server?: string; cause?: Error }\n  ) {\n    super(`Failed to fetch UI resource \"${uri}\": ${reason}`, {\n      code: \"RESOURCE_FETCH_ERROR\",\n      context: { uri, server: options?.server },\n      recoveryHint: \"Check that the MCP server is connected and the resource URI is valid.\",\n      cause: options?.cause,\n    });\n    this.name = \"ResourceFetchError\";\n  }\n}\n\n/**\n * Error parsing or validating UI resource content.\n */\nexport class ResourceParseError extends McpUiError {\n  constructor(\n    uri: string,\n    reason: string,\n    options?: { server?: string; mimeType?: string }\n  ) {\n    super(`Invalid UI resource \"${uri}\": ${reason}`, {\n      code: \"RESOURCE_PARSE_ERROR\",\n      context: { uri, server: options?.server, mimeType: options?.mimeType },\n      recoveryHint: \"Ensure the resource returns valid HTML with the correct MIME type.\",\n    });\n    this.name = \"ResourceParseError\";\n  }\n}\n\n/**\n * Error connecting to the AppBridge.\n */\nexport class BridgeConnectionError extends McpUiError {\n  constructor(reason: string, options?: { session?: string; cause?: Error }) {\n    super(`AppBridge connection failed: ${reason}`, {\n      code: \"BRIDGE_CONNECTION_ERROR\",\n      context: { session: options?.session },\n      recoveryHint: \"Check browser console for detailed errors. The iframe may have failed to load.\",\n      cause: options?.cause,\n    });\n    this.name = \"BridgeConnectionError\";\n  }\n}\n\n/**\n * Error related to user consent for tool calls.\n */\nexport class ConsentError extends McpUiError {\n  readonly denied: boolean;\n\n  constructor(\n    server: string,\n    options: { denied?: boolean; requiresApproval?: boolean }\n  ) {\n    const message = options.denied\n      ? `Tool calls for \"${server}\" were denied for this session`\n      : `Tool call approval required for \"${server}\"`;\n\n    super(message, {\n      code: options.denied ? \"CONSENT_DENIED\" : \"CONSENT_REQUIRED\",\n      context: { server },\n      recoveryHint: options.denied\n        ? \"The user denied tool access. Start a new session to try again.\"\n        : \"Prompt the user for consent before calling tools.\",\n    });\n    this.name = \"ConsentError\";\n    this.denied = options.denied ?? false;\n  }\n}\n\n/**\n * Error with UI server session management.\n */\nexport class SessionError extends McpUiError {\n  constructor(\n    reason: string,\n    options?: { session?: string; cause?: Error }\n  ) {\n    super(`Session error: ${reason}`, {\n      code: \"SESSION_ERROR\",\n      context: { session: options?.session },\n      recoveryHint: \"The session may have expired or been closed. Try opening the UI again.\",\n      cause: options?.cause,\n    });\n    this.name = \"SessionError\";\n  }\n}\n\n/**\n * Error starting or operating the UI server.\n */\nexport class ServerError extends McpUiError {\n  constructor(\n    reason: string,\n    options?: { port?: number; cause?: Error }\n  ) {\n    super(`UI server error: ${reason}`, {\n      code: \"SERVER_ERROR\",\n      context: { port: options?.port },\n      recoveryHint: \"Check if the port is available. Another process may be using it.\",\n      cause: options?.cause,\n    });\n    this.name = \"ServerError\";\n  }\n}\n\n/**\n * Error communicating with the MCP server.\n */\nexport class McpServerError extends McpUiError {\n  constructor(\n    server: string,\n    reason: string,\n    options?: { tool?: string; cause?: Error }\n  ) {\n    super(`MCP server \"${server}\" error: ${reason}`, {\n      code: \"MCP_SERVER_ERROR\",\n      context: { server, tool: options?.tool },\n      recoveryHint: \"Check that the MCP server is running and responsive.\",\n      cause: options?.cause,\n    });\n    this.name = \"McpServerError\";\n  }\n}\n\n/**\n * Wrap an unknown error into an McpUiError.\n */\nexport function wrapError(error: unknown, context?: McpUiErrorContext): McpUiError {\n  if (error instanceof McpUiError) {\n    // Merge contexts\n    return new McpUiError(error.message, {\n      code: error.code,\n      context: { ...error.context, ...context },\n      recoveryHint: error.recoveryHint,\n      cause: error.cause,\n    });\n  }\n\n  const cause = error instanceof Error ? error : undefined;\n  const message = error instanceof Error ? error.message : String(error);\n\n  return new McpUiError(message, {\n    code: \"UNKNOWN_ERROR\",\n    context,\n    cause,\n  });\n}\n\n/**\n * Check if an error is a specific MCP UI error type.\n */\nexport function isErrorCode(error: unknown, code: string): boolean {\n  return error instanceof McpUiError && error.code === code;\n}\n"]}