@agimon-ai/doompi-user-feedback 0.0.1-alpha.13 → 0.0.1-alpha.14

package/README.md

@@ -29,7 +29,7 @@ For standalone Pi:
 pi install npm:@agimon-ai/doompi-user-feedback
 ```
 
-Pi discovers the sole factory through `package.json.pi.extensions`. Each factory invocation owns a fresh package-local Cordis root and disposes it on session shutdown.
+Pi discovers the sole factory through `package.json.pi.extensions`. Each factory invocation joins the runner-scoped Cordis host, mounts one package plugin fiber, and disposes that fiber before releasing its host lease on shutdown.
 
 ## Ask a question
 
@@ -69,27 +69,18 @@ Questionnaires are coordinated one at a time. Cancellation, session replacement,
 
 When autonomous Voice mode is active, the extension formats the questions as plain text, requests narration, and returns `terminate: true`. The current turn ends while waiting; the next spoken answer arrives as a normal user message rather than a synthetic questionnaire selection.
 
-Reusable integrations can create a session-scoped handoff:
-
-```ts
-import { createVoiceQuestionHandoff } from '@agimon-ai/doompi-user-feedback/voice-question-handoff';
-import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
-
-export function installVoiceHandoff(pi: ExtensionAPI, sessionId: string): () => void {
-  const handoff = createVoiceQuestionHandoff({
-    bus: pi.events,
-    source: '@example/review-extension',
-    sessionId,
-  });
-  return () => handoff.dispose();
-}
-```
-
-Always dispose the handle during shutdown.
+The handoff reacts to the shared `doom/minor-mode-catalog` and `doom/narration`
+Cordis services. If either provider unloads, user-feedback immediately falls
+back to its interactive questionnaire without retaining the old provider.
 
 ## Public API
 
-Event constants are available through `/events`, and reusable autonomous-voice handoff helpers are available through `/voice-question-handoff`. The only Pi-loaded factory is the default export of `/extensions/pi`; package installation should use Pi's package metadata rather than calling a registration function.
+Question and result types are available from the package root. Cross-extension
+ask-user events and Voice services are owned by
+`@agimon-ai/doompi-extension-contracts`; consumers should inject or subscribe
+to those Cordis contracts. The only Pi-loaded factory is the default export of
+`/extensions/pi`; package installation should use Pi's package metadata rather
+than calling a registration function.
 
 ## Development
 

package/dist/adapters/doom/voiceQuestionHandoff.cjs

@@ -1,5 +1,5 @@
-const e=require("../../services/voiceQuestionNarration.cjs");let t=require("@agimon-ai/doompi-extension-contracts/mode"),n=require("@agimon-ai/doompi-extension-contracts/narration"),r=require("@agimon-ai/doompi-extension-contracts/protocol");const i=`The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.`;function a(e){return e.descriptor.source===`@agimon-ai/doompi-voice`&&e.descriptor.id===`voice-auto`&&e.state.activation===`active`}function o(e){let t=e.questions.length>1;return e.questions.map((e,n)=>[`${t?`${n+1}. `:``}${e.question}${e.multiSelect?` (Select all that apply.)`:``}`,...e.options.map((e,t)=>`  ${t+1}. ${e.label}`),`  Type something.`].join(`
+const e=require("../../services/voiceQuestionNarration.cjs");let t=require("@agimon-ai/doompi-extension-contracts/narration");const n=`The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.`;function r(e){return e.descriptor.source===t.DOOM_VOICE_SOURCE&&e.descriptor.id===t.DOOM_VOICE_AUTO_MODE_ID&&e.state.activation===`active`}function i(e){let t=e.questions.length>1;return e.questions.map((e,n)=>[`${t?`${n+1}. `:``}${e.question}${e.multiSelect?` (Select all that apply.)`:``}`,...e.options.map((e,t)=>`  ${t+1}. ${e.label}`),`  Type something.`].join(`
 `)).join(`
 
-`)}var s=class{modes;narration;buildNarration;constructor(e,t,n){this.modes=e,this.narration=t,this.buildNarration=n}handoff(e){if(this.modes.list().some(a))return this.narration.narrate(this.buildNarration(e)),{answers:[],cancelled:!1,delivery:`voice`,awaitingResponse:!0,voicePrompt:o(e)}}};function c(i){let a=(0,t.createMinorModeCatalogClient)(),o=a.bind((0,r.createProtocolRuntime)(i)),c=new s(a,(0,n.createNarrationRequester)(i),e.buildVoiceQuestionNarration),l=!1;return{handoff(e){return l?void 0:c.handoff(e)},dispose(){l||(l=!0,o(),a.dispose())}}}function l(e){let t=e.voicePrompt?.trim();return{content:[{type:`text`,text:t?`${t}\n\n${i}`:i}],details:e,terminate:!0}}exports.DOOM_VOICE_AUTO_MODE_ID=`voice-auto`,exports.DOOM_VOICE_SOURCE=`@agimon-ai/doompi-voice`,exports.VOICE_WAIT_MESSAGE=i,exports.VoiceQuestionHandoff=s,exports.buildVoiceToolResult=l,exports.createVoiceQuestionHandoff=c,exports.formatVoiceQuestionPrompt=o;
+`)}var a=class{modes;narration;buildNarration;constructor(t,n,r=e.buildVoiceQuestionNarration){this.modes=t,this.narration=n,this.buildNarration=r}async handoff(e){if(!this.modes.list().some(r))return;let n=(0,t.createNarrationRequest)(this.buildNarration(e));if(n)return await this.narration.request(n),{answers:[],cancelled:!1,delivery:`voice`,awaitingResponse:!0,voicePrompt:i(e)}}};function o(e,t){return new a(e,t)}function s(e){let t=e.voicePrompt?.trim();return{content:[{type:`text`,text:t?`${t}\n\n${n}`:n}],details:e,terminate:!0}}exports.VOICE_WAIT_MESSAGE=n,exports.VoiceQuestionHandoff=a,exports.buildVoiceToolResult=s,exports.createVoiceQuestionHandoff=o,exports.formatVoiceQuestionPrompt=i;
 //# sourceMappingURL=voiceQuestionHandoff.cjs.map

package/dist/adapters/doom/voiceQuestionHandoff.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"voiceQuestionHandoff.cjs","names":["createMinorModeCatalogClient","createProtocolRuntime","createNarrationRequester","buildVoiceQuestionNarration"],"sources":["../../../src/adapters/doom/voiceQuestionHandoff.ts"],"sourcesContent":["import {\n  createMinorModeCatalogClient,\n  type MinorModeCatalogClient,\n  type MinorModeRecord,\n} from '@agimon-ai/doompi-extension-contracts/mode';\nimport { createNarrationRequester, type NarrationRequester } from '@agimon-ai/doompi-extension-contracts/narration';\nimport { createProtocolRuntime, type ProtocolRuntimeOptions } from '@agimon-ai/doompi-extension-contracts/protocol';\nimport type { QuestionParams } from '../../schemas/questionnaire.js';\nimport { buildVoiceQuestionNarration } from '../../services/voiceQuestionNarration.js';\nimport type { QuestionnaireResult, ToolTextResult } from '../../types/questionnaire.js';\n\nexport const DOOM_VOICE_SOURCE = '@agimon-ai/doompi-voice';\nexport const DOOM_VOICE_AUTO_MODE_ID = 'voice-auto';\nexport const VOICE_WAIT_MESSAGE =\n  \"The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.\";\n\nfunction isAutonomousVoice(record: MinorModeRecord): boolean {\n  return (\n    record.descriptor.source === DOOM_VOICE_SOURCE &&\n    record.descriptor.id === DOOM_VOICE_AUTO_MODE_ID &&\n    record.state.activation === 'active'\n  );\n}\n\nexport function formatVoiceQuestionPrompt(params: QuestionParams): string {\n  const numberQuestions = params.questions.length > 1;\n  return params.questions\n    .map((question, questionIndex) => {\n      const heading = `${numberQuestions ? `${questionIndex + 1}. ` : ''}${question.question}${question.multiSelect ? ' (Select all that apply.)' : ''}`;\n      const options = question.options.map((option, optionIndex) => `  ${optionIndex + 1}. ${option.label}`);\n      return [heading, ...options, '  Type something.'].join('\\n');\n    })\n    .join('\\n\\n');\n}\n\nexport class VoiceQuestionHandoff {\n  constructor(\n    private readonly modes: Pick<MinorModeCatalogClient, 'list'>,\n    private readonly narration: NarrationRequester,\n    private readonly buildNarration: (params: QuestionParams) => string,\n  ) {}\n\n  handoff(params: QuestionParams): QuestionnaireResult | undefined {\n    if (!this.modes.list().some(isAutonomousVoice)) return undefined;\n    this.narration.narrate(this.buildNarration(params));\n    return {\n      answers: [],\n      cancelled: false,\n      delivery: 'voice',\n      awaitingResponse: true,\n      voicePrompt: formatVoiceQuestionPrompt(params),\n    };\n  }\n}\n\nexport interface VoiceQuestionHandoffHandle {\n  handoff(params: QuestionParams): QuestionnaireResult | undefined;\n  dispose(): void;\n}\n\n/**\n * Bind one session-scoped autonomous-voice handoff.\n *\n * The returned handle owns the external catalog subscription and must be\n * disposed when its session is replaced or shut down.\n */\nexport function createVoiceQuestionHandoff(options: ProtocolRuntimeOptions): VoiceQuestionHandoffHandle {\n  const modes = createMinorModeCatalogClient();\n  const disposeBinding = modes.bind(createProtocolRuntime(options));\n  const handoff = new VoiceQuestionHandoff(modes, createNarrationRequester(options), buildVoiceQuestionNarration);\n  let disposed = false;\n\n  return {\n    handoff(params) {\n      return disposed ? undefined : handoff.handoff(params);\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      disposeBinding();\n      modes.dispose();\n    },\n  };\n}\n\nexport function buildVoiceToolResult(details: QuestionnaireResult): ToolTextResult {\n  const prompt = details.voicePrompt?.trim();\n  return {\n    content: [{ type: 'text', text: prompt ? `${prompt}\\n\\n${VOICE_WAIT_MESSAGE}` : VOICE_WAIT_MESSAGE }],\n    details,\n    terminate: true,\n  };\n}\n"],"mappings":"kPAWA,MAEa,EACX,iJAEF,SAAS,EAAkB,EAAkC,CAC3D,OACE,EAAO,WAAW,SAAA,2BAClB,EAAO,WAAW,KAAA,cAClB,EAAO,MAAM,aAAe,QAEhC,CAEA,SAAgB,EAA0B,EAAgC,CACxE,IAAM,EAAkB,EAAO,UAAU,OAAS,EAClD,OAAO,EAAO,UACX,KAAK,EAAU,IAGP,CAAC,GAFW,EAAkB,GAAG,EAAgB,EAAE,IAAM,KAAK,EAAS,WAAW,EAAS,YAAc,4BAA8B,KAE7H,GADD,EAAS,QAAQ,KAAK,EAAQ,IAAgB,KAAK,EAAc,EAAE,IAAI,EAAO,OACpE,EAAG,mBAAmB,CAAC,CAAC,KAAK;CAAI,CAC5D,CAAC,CACD,KAAK;;CAAM,CAChB,CAEA,IAAa,EAAb,KAAkC,CAEb,MACA,UACA,eAHnB,YACE,EACA,EACA,EACA,CAHiB,KAAA,MAAA,EACA,KAAA,UAAA,EACA,KAAA,eAAA,CAChB,CAEH,QAAQ,EAAyD,CAC1D,QAAK,MAAM,KAAK,CAAC,CAAC,KAAK,CAAiB,EAE7C,OADA,KAAK,UAAU,QAAQ,KAAK,eAAe,CAAM,CAAC,EAC3C,CACL,QAAS,CAAC,EACV,UAAW,GACX,SAAU,QACV,iBAAkB,GAClB,YAAa,EAA0B,CAAM,CAC/C,CACF,CACF,EAaA,SAAgB,EAA2B,EAA6D,CACtG,IAAM,GAAA,EAAQA,EAAAA,6BAAAA,CAA6B,EACrC,EAAiB,EAAM,MAAA,EAAKC,EAAAA,sBAAAA,CAAsB,CAAO,CAAC,EAC1D,EAAU,IAAI,EAAqB,GAAA,EAAOC,EAAAA,yBAAAA,CAAyB,CAAO,EAAGC,EAAAA,2BAA2B,EAC1G,EAAW,GAEf,MAAO,CACL,QAAQ,EAAQ,CACd,OAAO,EAAW,IAAA,GAAY,EAAQ,QAAQ,CAAM,CACtD,EACA,SAAU,CACJ,IACJ,EAAW,GACX,EAAe,EACf,EAAM,QAAQ,EAChB,CACF,CACF,CAEA,SAAgB,EAAqB,EAA8C,CACjF,IAAM,EAAS,EAAQ,aAAa,KAAK,EACzC,MAAO,CACL,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAM,EAAS,GAAG,EAAO,MAAM,IAAuB,CAAmB,CAAC,EACpG,UACA,UAAW,EACb,CACF"}
+{"version":3,"file":"voiceQuestionHandoff.cjs","names":["DOOM_VOICE_SOURCE","DOOM_VOICE_AUTO_MODE_ID","buildVoiceQuestionNarration","createNarrationRequest"],"sources":["../../../src/adapters/doom/voiceQuestionHandoff.ts"],"sourcesContent":["import type { MinorModeCatalogService, MinorModeRecord } from '@agimon-ai/doompi-extension-contracts/mode';\nimport {\n  createNarrationRequest,\n  type DoomNarrationService,\n  DOOM_VOICE_AUTO_MODE_ID,\n  DOOM_VOICE_SOURCE,\n} from '@agimon-ai/doompi-extension-contracts/narration';\nimport type { QuestionParams } from '../../schemas/questionnaire.js';\nimport { buildVoiceQuestionNarration } from '../../services/voiceQuestionNarration.js';\nimport type { QuestionnaireResult, ToolTextResult } from '../../types/questionnaire.js';\n\nexport const VOICE_WAIT_MESSAGE =\n  \"The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.\";\n\nfunction isAutonomousVoice(record: MinorModeRecord): boolean {\n  return (\n    record.descriptor.source === DOOM_VOICE_SOURCE &&\n    record.descriptor.id === DOOM_VOICE_AUTO_MODE_ID &&\n    record.state.activation === 'active'\n  );\n}\n\nexport function formatVoiceQuestionPrompt(params: QuestionParams): string {\n  const numberQuestions = params.questions.length > 1;\n  return params.questions\n    .map((question, questionIndex) => {\n      const heading = `${numberQuestions ? `${questionIndex + 1}. ` : ''}${question.question}${question.multiSelect ? ' (Select all that apply.)' : ''}`;\n      const options = question.options.map((option, optionIndex) => `  ${optionIndex + 1}. ${option.label}`);\n      return [heading, ...options, '  Type something.'].join('\\n');\n    })\n    .join('\\n\\n');\n}\n\nexport class VoiceQuestionHandoff {\n  constructor(\n    private readonly modes: Pick<MinorModeCatalogService, 'list'>,\n    private readonly narration: Pick<DoomNarrationService, 'request'>,\n    private readonly buildNarration: (params: QuestionParams) => string = buildVoiceQuestionNarration,\n  ) {}\n\n  async handoff(params: QuestionParams): Promise<QuestionnaireResult | undefined> {\n    if (!this.modes.list().some(isAutonomousVoice)) return undefined;\n    const narration = createNarrationRequest(this.buildNarration(params));\n    if (!narration) return undefined;\n    await this.narration.request(narration);\n    return {\n      answers: [],\n      cancelled: false,\n      delivery: 'voice',\n      awaitingResponse: true,\n      voicePrompt: formatVoiceQuestionPrompt(params),\n    };\n  }\n}\n\n/** Create a handoff from services whose lifecycle is owned by a Cordis injection. */\nexport function createVoiceQuestionHandoff(\n  modes: Pick<MinorModeCatalogService, 'list'>,\n  narration: Pick<DoomNarrationService, 'request'>,\n): VoiceQuestionHandoff {\n  return new VoiceQuestionHandoff(modes, narration);\n}\n\nexport function buildVoiceToolResult(details: QuestionnaireResult): ToolTextResult {\n  const prompt = details.voicePrompt?.trim();\n  return {\n    content: [{ type: 'text', text: prompt ? `${prompt}\\n\\n${VOICE_WAIT_MESSAGE}` : VOICE_WAIT_MESSAGE }],\n    details,\n    terminate: true,\n  };\n}\n"],"mappings":"8HAWA,MAAa,EACX,iJAEF,SAAS,EAAkB,EAAkC,CAC3D,OACE,EAAO,WAAW,SAAWA,EAAAA,mBAC7B,EAAO,WAAW,KAAOC,EAAAA,yBACzB,EAAO,MAAM,aAAe,QAEhC,CAEA,SAAgB,EAA0B,EAAgC,CACxE,IAAM,EAAkB,EAAO,UAAU,OAAS,EAClD,OAAO,EAAO,UACX,KAAK,EAAU,IAGP,CAAC,GAFW,EAAkB,GAAG,EAAgB,EAAE,IAAM,KAAK,EAAS,WAAW,EAAS,YAAc,4BAA8B,KAE7H,GADD,EAAS,QAAQ,KAAK,EAAQ,IAAgB,KAAK,EAAc,EAAE,IAAI,EAAO,OACpE,EAAG,mBAAmB,CAAC,CAAC,KAAK;CAAI,CAC5D,CAAC,CACD,KAAK;;CAAM,CAChB,CAEA,IAAa,EAAb,KAAkC,CAEb,MACA,UACA,eAHnB,YACE,EACA,EACA,EAAsEC,EAAAA,4BACtE,CAHiB,KAAA,MAAA,EACA,KAAA,UAAA,EACA,KAAA,eAAA,CAChB,CAEH,MAAM,QAAQ,EAAkE,CAC9E,GAAI,CAAC,KAAK,MAAM,KAAK,CAAC,CAAC,KAAK,CAAiB,EAAG,OAChD,IAAM,GAAA,EAAYC,EAAAA,uBAAAA,CAAuB,KAAK,eAAe,CAAM,CAAC,EAC/D,KAEL,OADA,MAAM,KAAK,UAAU,QAAQ,CAAS,EAC/B,CACL,QAAS,CAAC,EACV,UAAW,GACX,SAAU,QACV,iBAAkB,GAClB,YAAa,EAA0B,CAAM,CAC/C,CACF,CACF,EAGA,SAAgB,EACd,EACA,EACsB,CACtB,OAAO,IAAI,EAAqB,EAAO,CAAS,CAClD,CAEA,SAAgB,EAAqB,EAA8C,CACjF,IAAM,EAAS,EAAQ,aAAa,KAAK,EACzC,MAAO,CACL,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAM,EAAS,GAAG,EAAO,MAAM,IAAuB,CAAmB,CAAC,EACpG,UACA,UAAW,EACb,CACF"}

package/dist/adapters/doom/voiceQuestionHandoff.mjs

@@ -1,5 +1,5 @@
-import{buildVoiceQuestionNarration as e}from"../../services/voiceQuestionNarration.mjs";import{createMinorModeCatalogClient as t}from"@agimon-ai/doompi-extension-contracts/mode";import{createNarrationRequester as n}from"@agimon-ai/doompi-extension-contracts/narration";import{createProtocolRuntime as r}from"@agimon-ai/doompi-extension-contracts/protocol";const i=`@agimon-ai/doompi-voice`,a=`voice-auto`,o=`The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.`;function s(e){return e.descriptor.source===`@agimon-ai/doompi-voice`&&e.descriptor.id===`voice-auto`&&e.state.activation===`active`}function c(e){let t=e.questions.length>1;return e.questions.map((e,n)=>[`${t?`${n+1}. `:``}${e.question}${e.multiSelect?` (Select all that apply.)`:``}`,...e.options.map((e,t)=>`  ${t+1}. ${e.label}`),`  Type something.`].join(`
+import{buildVoiceQuestionNarration as e}from"../../services/voiceQuestionNarration.mjs";import{DOOM_VOICE_AUTO_MODE_ID as t,DOOM_VOICE_SOURCE as n,createNarrationRequest as r}from"@agimon-ai/doompi-extension-contracts/narration";const i=`The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.`;function a(e){return e.descriptor.source===n&&e.descriptor.id===t&&e.state.activation===`active`}function o(e){let t=e.questions.length>1;return e.questions.map((e,n)=>[`${t?`${n+1}. `:``}${e.question}${e.multiSelect?` (Select all that apply.)`:``}`,...e.options.map((e,t)=>`  ${t+1}. ${e.label}`),`  Type something.`].join(`
 `)).join(`
 
-`)}var l=class{modes;narration;buildNarration;constructor(e,t,n){this.modes=e,this.narration=t,this.buildNarration=n}handoff(e){if(this.modes.list().some(s))return this.narration.narrate(this.buildNarration(e)),{answers:[],cancelled:!1,delivery:`voice`,awaitingResponse:!0,voicePrompt:c(e)}}};function u(i){let a=t(),o=a.bind(r(i)),s=new l(a,n(i),e),c=!1;return{handoff(e){return c?void 0:s.handoff(e)},dispose(){c||(c=!0,o(),a.dispose())}}}function d(e){let t=e.voicePrompt?.trim();return{content:[{type:`text`,text:t?`${t}\n\n${o}`:o}],details:e,terminate:!0}}export{a as DOOM_VOICE_AUTO_MODE_ID,i as DOOM_VOICE_SOURCE,o as VOICE_WAIT_MESSAGE,l as VoiceQuestionHandoff,d as buildVoiceToolResult,u as createVoiceQuestionHandoff,c as formatVoiceQuestionPrompt};
+`)}var s=class{modes;narration;buildNarration;constructor(t,n,r=e){this.modes=t,this.narration=n,this.buildNarration=r}async handoff(e){if(!this.modes.list().some(a))return;let t=r(this.buildNarration(e));if(t)return await this.narration.request(t),{answers:[],cancelled:!1,delivery:`voice`,awaitingResponse:!0,voicePrompt:o(e)}}};function c(e,t){return new s(e,t)}function l(e){let t=e.voicePrompt?.trim();return{content:[{type:`text`,text:t?`${t}\n\n${i}`:i}],details:e,terminate:!0}}export{i as VOICE_WAIT_MESSAGE,s as VoiceQuestionHandoff,l as buildVoiceToolResult,c as createVoiceQuestionHandoff,o as formatVoiceQuestionPrompt};
 //# sourceMappingURL=voiceQuestionHandoff.mjs.map

package/dist/adapters/doom/voiceQuestionHandoff.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"voiceQuestionHandoff.mjs","names":[],"sources":["../../../src/adapters/doom/voiceQuestionHandoff.ts"],"sourcesContent":["import {\n  createMinorModeCatalogClient,\n  type MinorModeCatalogClient,\n  type MinorModeRecord,\n} from '@agimon-ai/doompi-extension-contracts/mode';\nimport { createNarrationRequester, type NarrationRequester } from '@agimon-ai/doompi-extension-contracts/narration';\nimport { createProtocolRuntime, type ProtocolRuntimeOptions } from '@agimon-ai/doompi-extension-contracts/protocol';\nimport type { QuestionParams } from '../../schemas/questionnaire.js';\nimport { buildVoiceQuestionNarration } from '../../services/voiceQuestionNarration.js';\nimport type { QuestionnaireResult, ToolTextResult } from '../../types/questionnaire.js';\n\nexport const DOOM_VOICE_SOURCE = '@agimon-ai/doompi-voice';\nexport const DOOM_VOICE_AUTO_MODE_ID = 'voice-auto';\nexport const VOICE_WAIT_MESSAGE =\n  \"The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.\";\n\nfunction isAutonomousVoice(record: MinorModeRecord): boolean {\n  return (\n    record.descriptor.source === DOOM_VOICE_SOURCE &&\n    record.descriptor.id === DOOM_VOICE_AUTO_MODE_ID &&\n    record.state.activation === 'active'\n  );\n}\n\nexport function formatVoiceQuestionPrompt(params: QuestionParams): string {\n  const numberQuestions = params.questions.length > 1;\n  return params.questions\n    .map((question, questionIndex) => {\n      const heading = `${numberQuestions ? `${questionIndex + 1}. ` : ''}${question.question}${question.multiSelect ? ' (Select all that apply.)' : ''}`;\n      const options = question.options.map((option, optionIndex) => `  ${optionIndex + 1}. ${option.label}`);\n      return [heading, ...options, '  Type something.'].join('\\n');\n    })\n    .join('\\n\\n');\n}\n\nexport class VoiceQuestionHandoff {\n  constructor(\n    private readonly modes: Pick<MinorModeCatalogClient, 'list'>,\n    private readonly narration: NarrationRequester,\n    private readonly buildNarration: (params: QuestionParams) => string,\n  ) {}\n\n  handoff(params: QuestionParams): QuestionnaireResult | undefined {\n    if (!this.modes.list().some(isAutonomousVoice)) return undefined;\n    this.narration.narrate(this.buildNarration(params));\n    return {\n      answers: [],\n      cancelled: false,\n      delivery: 'voice',\n      awaitingResponse: true,\n      voicePrompt: formatVoiceQuestionPrompt(params),\n    };\n  }\n}\n\nexport interface VoiceQuestionHandoffHandle {\n  handoff(params: QuestionParams): QuestionnaireResult | undefined;\n  dispose(): void;\n}\n\n/**\n * Bind one session-scoped autonomous-voice handoff.\n *\n * The returned handle owns the external catalog subscription and must be\n * disposed when its session is replaced or shut down.\n */\nexport function createVoiceQuestionHandoff(options: ProtocolRuntimeOptions): VoiceQuestionHandoffHandle {\n  const modes = createMinorModeCatalogClient();\n  const disposeBinding = modes.bind(createProtocolRuntime(options));\n  const handoff = new VoiceQuestionHandoff(modes, createNarrationRequester(options), buildVoiceQuestionNarration);\n  let disposed = false;\n\n  return {\n    handoff(params) {\n      return disposed ? undefined : handoff.handoff(params);\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      disposeBinding();\n      modes.dispose();\n    },\n  };\n}\n\nexport function buildVoiceToolResult(details: QuestionnaireResult): ToolTextResult {\n  const prompt = details.voicePrompt?.trim();\n  return {\n    content: [{ type: 'text', text: prompt ? `${prompt}\\n\\n${VOICE_WAIT_MESSAGE}` : VOICE_WAIT_MESSAGE }],\n    details,\n    terminate: true,\n  };\n}\n"],"mappings":"oWAWA,MAAa,EAAoB,0BACpB,EAA0B,aAC1B,EACX,iJAEF,SAAS,EAAkB,EAAkC,CAC3D,OACE,EAAO,WAAW,SAAA,2BAClB,EAAO,WAAW,KAAA,cAClB,EAAO,MAAM,aAAe,QAEhC,CAEA,SAAgB,EAA0B,EAAgC,CACxE,IAAM,EAAkB,EAAO,UAAU,OAAS,EAClD,OAAO,EAAO,UACX,KAAK,EAAU,IAGP,CAAC,GAFW,EAAkB,GAAG,EAAgB,EAAE,IAAM,KAAK,EAAS,WAAW,EAAS,YAAc,4BAA8B,KAE7H,GADD,EAAS,QAAQ,KAAK,EAAQ,IAAgB,KAAK,EAAc,EAAE,IAAI,EAAO,OACpE,EAAG,mBAAmB,CAAC,CAAC,KAAK;CAAI,CAC5D,CAAC,CACD,KAAK;;CAAM,CAChB,CAEA,IAAa,EAAb,KAAkC,CAEb,MACA,UACA,eAHnB,YACE,EACA,EACA,EACA,CAHiB,KAAA,MAAA,EACA,KAAA,UAAA,EACA,KAAA,eAAA,CAChB,CAEH,QAAQ,EAAyD,CAC1D,QAAK,MAAM,KAAK,CAAC,CAAC,KAAK,CAAiB,EAE7C,OADA,KAAK,UAAU,QAAQ,KAAK,eAAe,CAAM,CAAC,EAC3C,CACL,QAAS,CAAC,EACV,UAAW,GACX,SAAU,QACV,iBAAkB,GAClB,YAAa,EAA0B,CAAM,CAC/C,CACF,CACF,EAaA,SAAgB,EAA2B,EAA6D,CACtG,IAAM,EAAQ,EAA6B,EACrC,EAAiB,EAAM,KAAK,EAAsB,CAAO,CAAC,EAC1D,EAAU,IAAI,EAAqB,EAAO,EAAyB,CAAO,EAAG,CAA2B,EAC1G,EAAW,GAEf,MAAO,CACL,QAAQ,EAAQ,CACd,OAAO,EAAW,IAAA,GAAY,EAAQ,QAAQ,CAAM,CACtD,EACA,SAAU,CACJ,IACJ,EAAW,GACX,EAAe,EACf,EAAM,QAAQ,EAChB,CACF,CACF,CAEA,SAAgB,EAAqB,EAA8C,CACjF,IAAM,EAAS,EAAQ,aAAa,KAAK,EACzC,MAAO,CACL,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAM,EAAS,GAAG,EAAO,MAAM,IAAuB,CAAmB,CAAC,EACpG,UACA,UAAW,EACb,CACF"}
+{"version":3,"file":"voiceQuestionHandoff.mjs","names":[],"sources":["../../../src/adapters/doom/voiceQuestionHandoff.ts"],"sourcesContent":["import type { MinorModeCatalogService, MinorModeRecord } from '@agimon-ai/doompi-extension-contracts/mode';\nimport {\n  createNarrationRequest,\n  type DoomNarrationService,\n  DOOM_VOICE_AUTO_MODE_ID,\n  DOOM_VOICE_SOURCE,\n} from '@agimon-ai/doompi-extension-contracts/narration';\nimport type { QuestionParams } from '../../schemas/questionnaire.js';\nimport { buildVoiceQuestionNarration } from '../../services/voiceQuestionNarration.js';\nimport type { QuestionnaireResult, ToolTextResult } from '../../types/questionnaire.js';\n\nexport const VOICE_WAIT_MESSAGE =\n  \"The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.\";\n\nfunction isAutonomousVoice(record: MinorModeRecord): boolean {\n  return (\n    record.descriptor.source === DOOM_VOICE_SOURCE &&\n    record.descriptor.id === DOOM_VOICE_AUTO_MODE_ID &&\n    record.state.activation === 'active'\n  );\n}\n\nexport function formatVoiceQuestionPrompt(params: QuestionParams): string {\n  const numberQuestions = params.questions.length > 1;\n  return params.questions\n    .map((question, questionIndex) => {\n      const heading = `${numberQuestions ? `${questionIndex + 1}. ` : ''}${question.question}${question.multiSelect ? ' (Select all that apply.)' : ''}`;\n      const options = question.options.map((option, optionIndex) => `  ${optionIndex + 1}. ${option.label}`);\n      return [heading, ...options, '  Type something.'].join('\\n');\n    })\n    .join('\\n\\n');\n}\n\nexport class VoiceQuestionHandoff {\n  constructor(\n    private readonly modes: Pick<MinorModeCatalogService, 'list'>,\n    private readonly narration: Pick<DoomNarrationService, 'request'>,\n    private readonly buildNarration: (params: QuestionParams) => string = buildVoiceQuestionNarration,\n  ) {}\n\n  async handoff(params: QuestionParams): Promise<QuestionnaireResult | undefined> {\n    if (!this.modes.list().some(isAutonomousVoice)) return undefined;\n    const narration = createNarrationRequest(this.buildNarration(params));\n    if (!narration) return undefined;\n    await this.narration.request(narration);\n    return {\n      answers: [],\n      cancelled: false,\n      delivery: 'voice',\n      awaitingResponse: true,\n      voicePrompt: formatVoiceQuestionPrompt(params),\n    };\n  }\n}\n\n/** Create a handoff from services whose lifecycle is owned by a Cordis injection. */\nexport function createVoiceQuestionHandoff(\n  modes: Pick<MinorModeCatalogService, 'list'>,\n  narration: Pick<DoomNarrationService, 'request'>,\n): VoiceQuestionHandoff {\n  return new VoiceQuestionHandoff(modes, narration);\n}\n\nexport function buildVoiceToolResult(details: QuestionnaireResult): ToolTextResult {\n  const prompt = details.voicePrompt?.trim();\n  return {\n    content: [{ type: 'text', text: prompt ? `${prompt}\\n\\n${VOICE_WAIT_MESSAGE}` : VOICE_WAIT_MESSAGE }],\n    details,\n    terminate: true,\n  };\n}\n"],"mappings":"qOAWA,MAAa,EACX,iJAEF,SAAS,EAAkB,EAAkC,CAC3D,OACE,EAAO,WAAW,SAAW,GAC7B,EAAO,WAAW,KAAO,GACzB,EAAO,MAAM,aAAe,QAEhC,CAEA,SAAgB,EAA0B,EAAgC,CACxE,IAAM,EAAkB,EAAO,UAAU,OAAS,EAClD,OAAO,EAAO,UACX,KAAK,EAAU,IAGP,CAAC,GAFW,EAAkB,GAAG,EAAgB,EAAE,IAAM,KAAK,EAAS,WAAW,EAAS,YAAc,4BAA8B,KAE7H,GADD,EAAS,QAAQ,KAAK,EAAQ,IAAgB,KAAK,EAAc,EAAE,IAAI,EAAO,OACpE,EAAG,mBAAmB,CAAC,CAAC,KAAK;CAAI,CAC5D,CAAC,CACD,KAAK;;CAAM,CAChB,CAEA,IAAa,EAAb,KAAkC,CAEb,MACA,UACA,eAHnB,YACE,EACA,EACA,EAAsE,EACtE,CAHiB,KAAA,MAAA,EACA,KAAA,UAAA,EACA,KAAA,eAAA,CAChB,CAEH,MAAM,QAAQ,EAAkE,CAC9E,GAAI,CAAC,KAAK,MAAM,KAAK,CAAC,CAAC,KAAK,CAAiB,EAAG,OAChD,IAAM,EAAY,EAAuB,KAAK,eAAe,CAAM,CAAC,EAC/D,KAEL,OADA,MAAM,KAAK,UAAU,QAAQ,CAAS,EAC/B,CACL,QAAS,CAAC,EACV,UAAW,GACX,SAAU,QACV,iBAAkB,GAClB,YAAa,EAA0B,CAAM,CAC/C,CACF,CACF,EAGA,SAAgB,EACd,EACA,EACsB,CACtB,OAAO,IAAI,EAAqB,EAAO,CAAS,CAClD,CAEA,SAAgB,EAAqB,EAA8C,CACjF,IAAM,EAAS,EAAQ,aAAa,KAAK,EACzC,MAAO,CACL,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAM,EAAS,GAAG,EAAO,MAAM,IAAuB,CAAmB,CAAC,EACpG,UACA,UAAW,EACb,CACF"}

package/dist/adapters/pi/askUserQuestionAdapter.cjs

@@ -1,4 +1,4 @@
-const e=require("../doom/voiceQuestionHandoff.cjs"),t=require("../../schemas/questionnaire.cjs"),n=require("../../services/responseService.cjs"),r=require("../../services/validationService.cjs"),i=require("../config/configAdapter.cjs"),a=require("./rpcQuestionnaireAdapter.cjs");let o=require("@agimon-ai/doompi-extension-contracts"),s=require("@agimon-ai/doompi-ui/toolChrome");const c=`ask_user_question`,l=`Ask the user up to 4 structured questions (2-4 options each) when requirements are ambiguous`,u=[`Use ask_user_question whenever the user's request is underspecified and you cannot proceed without concrete decisions — you can ask up to 4 questions per invocation.`,`Each question MUST have 2-4 options. Every option requires a concise label (1-5 words) and a description explaining what the choice means or its trade-offs. The user can additionally type a custom answer via the automatically appended "Type something." row on every question, or press Esc to abandon the questionnaire. Do NOT author "Other" or "Type something." labels yourself — reserved labels are rejected at runtime.`,`Set multiSelect: true when multiple answers are valid. Provide an options[].preview markdown string when an option benefits from richer side-by-side context (mockups, code snippets, diagrams, configs) — single-select only. If you recommend a specific option, make that the first option and append "(Recommended)" to its label.`,`Do not stack multiple ask_user_question calls back-to-back — group all clarifying questions into one invocation.`];function d(e,t){let n={questions:t.questions.map(e=>({question:e.question,header:e.header,multiSelect:e.multiSelect??!1,options:e.options.map(e=>({label:e.label,description:e.description,hasPreview:!!e.preview}))}))};(0,o.publishAskUserPrompt)(e.events,n)}function f(e,t){let n={active:t};(0,o.publishAskUserBlocked)(e.events,n)}function p(e){let t=e.ui;return typeof t.select==`function`&&typeof t.input==`function`}function m(o,m){let h=i.loadUserFeedbackConfig().guidance;o.registerTool({name:c,label:`Ask User Question`,renderShell:`self`,description:`Ask the user one or more structured questions during execution. Use when you need to:
+const e=require("../doom/voiceQuestionHandoff.cjs"),t=require("../../schemas/questionnaire.cjs"),n=require("../../services/responseService.cjs"),r=require("../../services/validationService.cjs"),i=require("../config/configAdapter.cjs"),a=require("./rpcQuestionnaireAdapter.cjs");let o=require("@agimon-ai/doompi-extension-contracts/ask-user"),s=require("@agimon-ai/doompi-ui/toolChrome");const c=`ask_user_question`,l=`Ask the user up to 4 structured questions (2-4 options each) when requirements are ambiguous`,u=[`Use ask_user_question whenever the user's request is underspecified and you cannot proceed without concrete decisions — you can ask up to 4 questions per invocation.`,`Each question MUST have 2-4 options. Every option requires a concise label (1-5 words) and a description explaining what the choice means or its trade-offs. The user can additionally type a custom answer via the automatically appended "Type something." row on every question, or press Esc to abandon the questionnaire. Do NOT author "Other" or "Type something." labels yourself — reserved labels are rejected at runtime.`,`Set multiSelect: true when multiple answers are valid. Provide an options[].preview markdown string when an option benefits from richer side-by-side context (mockups, code snippets, diagrams, configs) — single-select only. If you recommend a specific option, make that the first option and append "(Recommended)" to its label.`,`Do not stack multiple ask_user_question calls back-to-back — group all clarifying questions into one invocation.`];function d(e,t){let n={questions:t.questions.map(e=>({question:e.question,header:e.header,multiSelect:e.multiSelect??!1,options:e.options.map(e=>({label:e.label,description:e.description,hasPreview:!!e.preview}))}))};e.emit(o.DOOM_ASK_USER_PROMPT_EVENT,n)}function f(e,t){let n={active:t};e.emit(o.DOOM_ASK_USER_BLOCKED_EVENT,n)}function p(e){let t=e.ui;return typeof t.select==`function`&&typeof t.input==`function`}function m(o,m,h){let g=i.loadUserFeedbackConfig().guidance;o.registerTool({name:c,label:`Ask User Question`,renderShell:`self`,description:`Ask the user one or more structured questions during execution. Use when you need to:
 1. Gather user preferences or requirements
 2. Clarify ambiguous instructions
 3. Get decisions on implementation choices as you work
@@ -10,6 +10,6 @@ Usage notes:
 - If you recommend a specific option, make that the first option and add "(Recommended)" at the end of the label.
 
 Preview feature:
-Use the optional preview field for ASCII mockups, code snippets, diagrams, or configuration examples that users should compare visually. Do not use previews for simple preference questions.`,promptSnippet:h?.promptSnippet??l,promptGuidelines:h?.promptGuidelines??u,parameters:t.QuestionParamsSchema,executionMode:`sequential`,async execute(t,s,c,l,u){let h=s,g=e=>m.isActive?.(u,e)??!0,_=()=>({answers:[],cancelled:!0});if(!g(c))return n.buildToolResult(`Error: the questionnaire session is no longer active.`,_());if(!u.hasUI)return n.buildToolResult(`Error: UI not available (running in non-interactive mode)`,{answers:[],cancelled:!0,error:`no_ui`});let v=r.validateQuestionnaire(h);if(!v.ok)return n.buildToolResult(v.message,{answers:[],cancelled:!0,error:v.error});try{let t=await m.enqueue(async({signal:e,reportProgress:t})=>{if(!g(e))return _();d(o,h);let n=m.tryVoice?.(h);if(n)return n;let r=!0,s=()=>{r&&(r=!1,g()&&f(o,!1))};e.addEventListener(`abort`,s,{once:!0}),f(o,!0);try{if(!g(e))return _();if(u.mode===`rpc`&&p(u)){let n=await a.runRpcQuestionnaire(u,h,e,t);return g(e)?n:_()}let n=await m.runTui(u,h,i.resolveCollapseKey(i.loadUserFeedbackConfig()),e,t);if(!g(e))return _();if(n!==void 0)return n;if(p(u)){let n=await a.runRpcQuestionnaire(u,h,e,t);return g(e)?n:_()}return{answers:[],cancelled:!0,error:`no_custom_ui`}}finally{e.removeEventListener(`abort`,s),s()}},c);return t.delivery===`voice`?e.buildVoiceToolResult(t):t.error===`no_custom_ui`?n.buildToolResult(`Error: this client cannot render the questionnaire (custom UI is unavailable). The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead, without using this tool.`,t):n.buildQuestionnaireResponse(t,h)}catch(e){let t=e instanceof Error?e.message:String(e);return n.buildToolResult(`Error: the questionnaire UI failed to load. The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead. (cause: ${t})`,{answers:[],cancelled:!0,error:`session_load_failed`})}},renderCall(e,t){let n=e,r=n.questions.map(e=>e.header).join(`, `),i=`${n.questions.length} question${n.questions.length===1?``:`s`}`,a=(0,s.renderToolHeading)(`ask`,i,t);return new s.DoomToolCall(r?`${a} ${t.fg(`dim`,`(${r})`)}`:a)},renderResult(e,t,n,r){let i=e.details;if(!i){let t=e.content.filter(e=>e.type===`text`).map(e=>e.text).join(`
+Use the optional preview field for ASCII mockups, code snippets, diagrams, or configuration examples that users should compare visually. Do not use previews for simple preference questions.`,promptSnippet:g?.promptSnippet??l,promptGuidelines:g?.promptGuidelines??u,parameters:t.QuestionParamsSchema,executionMode:`sequential`,async execute(t,o,s,c,l){let u=o,g=e=>h.isActive?.(l,e)??!0,_=()=>({answers:[],cancelled:!0});if(!g(s))return n.buildToolResult(`Error: the questionnaire session is no longer active.`,_());if(!l.hasUI)return n.buildToolResult(`Error: UI not available (running in non-interactive mode)`,{answers:[],cancelled:!0,error:`no_ui`});let v=r.validateQuestionnaire(u);if(!v.ok)return n.buildToolResult(v.message,{answers:[],cancelled:!0,error:v.error});try{let t=await h.enqueue(async({signal:e,reportProgress:t})=>{if(!g(e))return _();d(m,u);let n=await h.tryVoice?.(u);if(n)return n;let r=!0,o=()=>{r&&(r=!1,g()&&f(m,!1))};e.addEventListener(`abort`,o,{once:!0}),f(m,!0);try{if(!g(e))return _();if(l.mode===`rpc`&&p(l)){let n=await a.runRpcQuestionnaire(l,u,e,t);return g(e)?n:_()}let n=await h.runTui(l,u,i.resolveCollapseKey(i.loadUserFeedbackConfig()),e,t);if(!g(e))return _();if(n!==void 0)return n;if(p(l)){let n=await a.runRpcQuestionnaire(l,u,e,t);return g(e)?n:_()}return{answers:[],cancelled:!0,error:`no_custom_ui`}}finally{e.removeEventListener(`abort`,o),o()}},s);return t.delivery===`voice`?e.buildVoiceToolResult(t):t.error===`no_custom_ui`?n.buildToolResult(`Error: this client cannot render the questionnaire (custom UI is unavailable). The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead, without using this tool.`,t):n.buildQuestionnaireResponse(t,u)}catch(e){let t=e instanceof Error?e.message:String(e);return n.buildToolResult(`Error: the questionnaire UI failed to load. The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead. (cause: ${t})`,{answers:[],cancelled:!0,error:`session_load_failed`})}},renderCall(e,t){let n=e,r=n.questions.map(e=>e.header).join(`, `),i=`${n.questions.length} question${n.questions.length===1?``:`s`}`,a=(0,s.renderToolHeading)(`ask`,i,t);return new s.DoomToolCall(r?`${a} ${t.fg(`dim`,`(${r})`)}`:a)},renderResult(e,t,n,r){let i=e.details;if(!i){let t=e.content.filter(e=>e.type===`text`).map(e=>e.text).join(`
 `),i=r.isError?`error`:`toolOutput`,a=r.isError?`✗ failed`:`✓ submitted`;return new s.DoomToolResult([n.fg(i,t||a)],n,{wrap:!0})}if(i.cancelled)return new s.DoomToolResult([n.fg(`warning`,`◐`)+n.fg(`dim`,` cancelled`)],n);if(i.delivery===`voice`&&i.voicePrompt)return new s.DoomToolResult([n.fg(`toolOutput`,i.voicePrompt)],n,{wrap:!0});let a=i.answers.map(e=>{let t=e.kind===`multi`?(e.selected??[]).join(`, `):e.answer;return`${n.fg(`success`,`✓`)} ${n.fg(`accent`,e.question)}: ${n.fg(`toolOutput`,t??``)}`});return a.length===0&&a.push(n.fg(`success`,`✓`)+n.fg(`dim`,` submitted`)),new s.DoomToolResult(a,n,{wrap:!0})}})}exports.ASK_USER_QUESTION_TOOL_NAME=c,exports.DEFAULT_PROMPT_GUIDELINES=u,exports.DEFAULT_PROMPT_SNIPPET=l,exports.registerAskUserQuestionTool=m;
 //# sourceMappingURL=askUserQuestionAdapter.cjs.map

package/dist/adapters/pi/askUserQuestionAdapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"askUserQuestionAdapter.cjs","names":["loadUserFeedbackConfig","QuestionParamsSchema","buildToolResult","validateQuestionnaire","runRpcQuestionnaire","resolveCollapseKey","buildVoiceToolResult","buildQuestionnaireResponse","renderToolHeading","DoomToolCall","DoomToolResult"],"sources":["../../../src/adapters/pi/askUserQuestionAdapter.ts"],"sourcesContent":["import { publishAskUserBlocked, publishAskUserPrompt } from '@agimon-ai/doompi-extension-contracts';\nimport { DoomToolCall, DoomToolResult, renderToolHeading } from '@agimon-ai/doompi-ui/toolChrome';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { AskUserBlockedEventPayload, AskUserPromptEventPayload } from '../../schemas/events.js';\nimport {\n  MAX_OPTIONS,\n  MAX_QUESTIONS,\n  MIN_OPTIONS,\n  type QuestionParams,\n  QuestionParamsSchema,\n} from '../../schemas/questionnaire.js';\nimport type { QuestionnaireRunner } from '../../services/questionnaireCoordinator.js';\nimport { buildQuestionnaireResponse, buildToolResult } from '../../services/responseService.js';\nimport { validateQuestionnaire } from '../../services/validationService.js';\nimport type { QuestionnaireResult } from '../../types/questionnaire.js';\nimport { loadUserFeedbackConfig, resolveCollapseKey } from '../config/configAdapter.js';\nimport { buildVoiceToolResult } from '../doom/voiceQuestionHandoff.js';\nimport { runRpcQuestionnaire } from './rpcQuestionnaireAdapter.js';\n\nexport const ASK_USER_QUESTION_TOOL_NAME = 'ask_user_question';\n\nexport const DEFAULT_PROMPT_SNIPPET = `Ask the user up to ${MAX_QUESTIONS} structured questions (${MIN_OPTIONS}-${MAX_OPTIONS} options each) when requirements are ambiguous`;\nexport const DEFAULT_PROMPT_GUIDELINES = [\n  `Use ask_user_question whenever the user's request is underspecified and you cannot proceed without concrete decisions — you can ask up to ${MAX_QUESTIONS} questions per invocation.`,\n  `Each question MUST have ${MIN_OPTIONS}-${MAX_OPTIONS} options. Every option requires a concise label (1-5 words) and a description explaining what the choice means or its trade-offs. The user can additionally type a custom answer via the automatically appended \"Type something.\" row on every question, or press Esc to abandon the questionnaire. Do NOT author \"Other\" or \"Type something.\" labels yourself — reserved labels are rejected at runtime.`,\n  'Set multiSelect: true when multiple answers are valid. Provide an options[].preview markdown string when an option benefits from richer side-by-side context (mockups, code snippets, diagrams, configs) — single-select only. If you recommend a specific option, make that the first option and append \"(Recommended)\" to its label.',\n  'Do not stack multiple ask_user_question calls back-to-back — group all clarifying questions into one invocation.',\n];\n\nconst ERROR_NO_UI = 'Error: UI not available (running in non-interactive mode)';\nconst ERROR_NO_CUSTOM_UI =\n  'Error: this client cannot render the questionnaire (custom UI is unavailable). The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead, without using this tool.';\nconst ERROR_SESSION_LOAD_FAILED =\n  'Error: the questionnaire UI failed to load. The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead.';\nconst ERROR_SESSION_INACTIVE = 'Error: the questionnaire session is no longer active.';\n\nexport interface AskUserQuestionToolDependencies {\n  enqueue: (runner: QuestionnaireRunner, signal?: AbortSignal) => Promise<QuestionnaireResult>;\n  isActive?: (context: ExtensionContext, signal?: AbortSignal) => boolean;\n  tryVoice?: (params: QuestionParams) => QuestionnaireResult | undefined;\n  runTui: (\n    context: ExtensionContext,\n    params: QuestionParams,\n    collapseKey: string,\n    signal?: AbortSignal,\n    reportProgress?: (result: QuestionnaireResult) => void,\n  ) => Promise<QuestionnaireResult | undefined>;\n}\n\nfunction emitPrompt(pi: ExtensionAPI, params: QuestionParams): void {\n  const payload: AskUserPromptEventPayload = {\n    questions: params.questions.map((question) => ({\n      question: question.question,\n      header: question.header,\n      multiSelect: question.multiSelect ?? false,\n      options: question.options.map((option) => ({\n        label: option.label,\n        description: option.description,\n        hasPreview: Boolean(option.preview),\n      })),\n    })),\n  };\n  publishAskUserPrompt(pi.events, payload);\n}\n\nfunction emitBlocked(pi: ExtensionAPI, active: boolean): void {\n  const payload: AskUserBlockedEventPayload = { active };\n  publishAskUserBlocked(pi.events, payload);\n}\n\nfunction hasDialogUI(context: ExtensionContext): boolean {\n  const ui = context.ui as unknown as { select?: unknown; input?: unknown };\n  return typeof ui.select === 'function' && typeof ui.input === 'function';\n}\n\nexport function registerAskUserQuestionTool(pi: ExtensionAPI, dependencies: AskUserQuestionToolDependencies): void {\n  const configuredGuidance = loadUserFeedbackConfig().guidance;\n  pi.registerTool({\n    name: ASK_USER_QUESTION_TOOL_NAME,\n    label: 'Ask User Question',\n    renderShell: 'self',\n    description: `Ask the user one or more structured questions during execution. Use when you need to:\n1. Gather user preferences or requirements\n2. Clarify ambiguous instructions\n3. Get decisions on implementation choices as you work\n4. Offer choices to the user about what direction to take\n\nUsage notes:\n- Users can type a custom answer via the automatically appended \"Type something.\" row on every question or press Esc to abandon the questionnaire. Do NOT author \"Other\" or \"Type something.\" labels yourself — reserved labels are rejected at runtime.\n- Use multiSelect: true when multiple answers are valid.\n- If you recommend a specific option, make that the first option and add \"(Recommended)\" at the end of the label.\n\nPreview feature:\nUse the optional preview field for ASCII mockups, code snippets, diagrams, or configuration examples that users should compare visually. Do not use previews for simple preference questions.`,\n    promptSnippet: configuredGuidance?.promptSnippet ?? DEFAULT_PROMPT_SNIPPET,\n    promptGuidelines: configuredGuidance?.promptGuidelines ?? DEFAULT_PROMPT_GUIDELINES,\n    parameters: QuestionParamsSchema,\n    executionMode: 'sequential',\n\n    async execute(_toolCallId, params, signal, _onUpdate, context) {\n      const typed = params as QuestionParams;\n      const isActive = (activeSignal?: AbortSignal): boolean => dependencies.isActive?.(context, activeSignal) ?? true;\n      const cancelled = (): QuestionnaireResult => ({ answers: [], cancelled: true });\n      if (!isActive(signal)) return buildToolResult(ERROR_SESSION_INACTIVE, cancelled());\n      if (!context.hasUI) {\n        return buildToolResult(ERROR_NO_UI, { answers: [], cancelled: true, error: 'no_ui' });\n      }\n\n      const validation = validateQuestionnaire(typed);\n      if (!validation.ok) {\n        return buildToolResult(validation.message, {\n          answers: [],\n          cancelled: true,\n          error: validation.error,\n        });\n      }\n\n      try {\n        const result = await dependencies.enqueue(async ({ signal: activeSignal, reportProgress }) => {\n          if (!isActive(activeSignal)) return cancelled();\n          emitPrompt(pi, typed);\n          const voiceResult = dependencies.tryVoice?.(typed);\n          if (voiceResult) return voiceResult;\n\n          let blocked = true;\n          const clearBlocked = (): void => {\n            if (!blocked) return;\n            blocked = false;\n            if (isActive()) emitBlocked(pi, false);\n          };\n          activeSignal.addEventListener('abort', clearBlocked, { once: true });\n          emitBlocked(pi, true);\n          try {\n            if (!isActive(activeSignal)) return cancelled();\n            if (context.mode === 'rpc' && hasDialogUI(context)) {\n              const rpcResult = await runRpcQuestionnaire(context, typed, activeSignal, reportProgress);\n              return isActive(activeSignal) ? rpcResult : cancelled();\n            }\n\n            const tuiResult = await dependencies.runTui(\n              context,\n              typed,\n              resolveCollapseKey(loadUserFeedbackConfig()),\n              activeSignal,\n              reportProgress,\n            );\n            if (!isActive(activeSignal)) return cancelled();\n            if (tuiResult !== undefined) return tuiResult;\n            if (hasDialogUI(context)) {\n              const rpcResult = await runRpcQuestionnaire(context, typed, activeSignal, reportProgress);\n              return isActive(activeSignal) ? rpcResult : cancelled();\n            }\n            return { answers: [], cancelled: true, error: 'no_custom_ui' };\n          } finally {\n            activeSignal.removeEventListener('abort', clearBlocked);\n            clearBlocked();\n          }\n        }, signal);\n\n        if (result.delivery === 'voice') return buildVoiceToolResult(result);\n        if (result.error === 'no_custom_ui') return buildToolResult(ERROR_NO_CUSTOM_UI, result);\n        return buildQuestionnaireResponse(result, typed);\n      } catch (error) {\n        const cause = error instanceof Error ? error.message : String(error);\n        return buildToolResult(`${ERROR_SESSION_LOAD_FAILED} (cause: ${cause})`, {\n          answers: [],\n          cancelled: true,\n          error: 'session_load_failed',\n        });\n      }\n    },\n\n    renderCall(args, theme) {\n      const params = args as QuestionParams;\n      const headers = params.questions.map((question) => question.header).join(', ');\n      const count = `${params.questions.length} question${params.questions.length === 1 ? '' : 's'}`;\n      const heading = renderToolHeading('ask', count, theme);\n      return new DoomToolCall(headers ? `${heading} ${theme.fg('dim', `(${headers})`)}` : heading);\n    },\n\n    renderResult(result, _options, theme, context) {\n      const details = result.details as QuestionnaireResult | undefined;\n      if (!details) {\n        const raw = result.content\n          .filter((block) => block.type === 'text')\n          .map((block) => block.text)\n          .join('\\n');\n        const color = context.isError ? 'error' : 'toolOutput';\n        const fallback = context.isError ? '✗ failed' : '✓ submitted';\n        return new DoomToolResult([theme.fg(color, raw || fallback)], theme, { wrap: true });\n      }\n      if (details.cancelled) {\n        return new DoomToolResult([theme.fg('warning', '◐') + theme.fg('dim', ' cancelled')], theme);\n      }\n      if (details.delivery === 'voice' && details.voicePrompt) {\n        return new DoomToolResult([theme.fg('toolOutput', details.voicePrompt)], theme, { wrap: true });\n      }\n      const lines = details.answers.map((answer) => {\n        const scalar = answer.kind === 'multi' ? (answer.selected ?? []).join(', ') : answer.answer;\n        return `${theme.fg('success', '✓')} ${theme.fg('accent', answer.question)}: ${theme.fg(\n          'toolOutput',\n          scalar ?? '',\n        )}`;\n      });\n      if (lines.length === 0) lines.push(theme.fg('success', '✓') + theme.fg('dim', ' submitted'));\n      return new DoomToolResult(lines, theme, { wrap: true });\n    },\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"askUserQuestionAdapter.cjs","names":["DOOM_ASK_USER_PROMPT_EVENT","DOOM_ASK_USER_BLOCKED_EVENT","loadUserFeedbackConfig","QuestionParamsSchema","buildToolResult","validateQuestionnaire","runRpcQuestionnaire","resolveCollapseKey","buildVoiceToolResult","buildQuestionnaireResponse","renderToolHeading","DoomToolCall","DoomToolResult"],"sources":["../../../src/adapters/pi/askUserQuestionAdapter.ts"],"sourcesContent":["import {\n  type AskUserBlockedEvent,\n  type AskUserPromptEvent,\n  DOOM_ASK_USER_BLOCKED_EVENT,\n  DOOM_ASK_USER_PROMPT_EVENT,\n} from '@agimon-ai/doompi-extension-contracts/ask-user';\nimport { DoomToolCall, DoomToolResult, renderToolHeading } from '@agimon-ai/doompi-ui/toolChrome';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport {\n  MAX_OPTIONS,\n  MAX_QUESTIONS,\n  MIN_OPTIONS,\n  type QuestionParams,\n  QuestionParamsSchema,\n} from '../../schemas/questionnaire.js';\nimport type { QuestionnaireRunner } from '../../services/questionnaireCoordinator.js';\nimport { buildQuestionnaireResponse, buildToolResult } from '../../services/responseService.js';\nimport { validateQuestionnaire } from '../../services/validationService.js';\nimport type { QuestionnaireResult } from '../../types/questionnaire.js';\nimport { loadUserFeedbackConfig, resolveCollapseKey } from '../config/configAdapter.js';\nimport { buildVoiceToolResult } from '../doom/voiceQuestionHandoff.js';\nimport { runRpcQuestionnaire } from './rpcQuestionnaireAdapter.js';\n\nexport const ASK_USER_QUESTION_TOOL_NAME = 'ask_user_question';\n\nexport const DEFAULT_PROMPT_SNIPPET = `Ask the user up to ${MAX_QUESTIONS} structured questions (${MIN_OPTIONS}-${MAX_OPTIONS} options each) when requirements are ambiguous`;\nexport const DEFAULT_PROMPT_GUIDELINES = [\n  `Use ask_user_question whenever the user's request is underspecified and you cannot proceed without concrete decisions — you can ask up to ${MAX_QUESTIONS} questions per invocation.`,\n  `Each question MUST have ${MIN_OPTIONS}-${MAX_OPTIONS} options. Every option requires a concise label (1-5 words) and a description explaining what the choice means or its trade-offs. The user can additionally type a custom answer via the automatically appended \"Type something.\" row on every question, or press Esc to abandon the questionnaire. Do NOT author \"Other\" or \"Type something.\" labels yourself — reserved labels are rejected at runtime.`,\n  'Set multiSelect: true when multiple answers are valid. Provide an options[].preview markdown string when an option benefits from richer side-by-side context (mockups, code snippets, diagrams, configs) — single-select only. If you recommend a specific option, make that the first option and append \"(Recommended)\" to its label.',\n  'Do not stack multiple ask_user_question calls back-to-back — group all clarifying questions into one invocation.',\n];\n\nconst ERROR_NO_UI = 'Error: UI not available (running in non-interactive mode)';\nconst ERROR_NO_CUSTOM_UI =\n  'Error: this client cannot render the questionnaire (custom UI is unavailable). The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead, without using this tool.';\nconst ERROR_SESSION_LOAD_FAILED =\n  'Error: the questionnaire UI failed to load. The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead.';\nconst ERROR_SESSION_INACTIVE = 'Error: the questionnaire session is no longer active.';\n\nexport interface AskUserQuestionToolDependencies {\n  enqueue: (runner: QuestionnaireRunner, signal?: AbortSignal) => Promise<QuestionnaireResult>;\n  isActive?: (context: ExtensionContext, signal?: AbortSignal) => boolean;\n  tryVoice?: (params: QuestionParams) => QuestionnaireResult | undefined | Promise<QuestionnaireResult | undefined>;\n  runTui: (\n    context: ExtensionContext,\n    params: QuestionParams,\n    collapseKey: string,\n    signal?: AbortSignal,\n    reportProgress?: (result: QuestionnaireResult) => void,\n  ) => Promise<QuestionnaireResult | undefined>;\n}\n\nfunction emitPrompt(cordis: Context, params: QuestionParams): void {\n  const payload: AskUserPromptEvent = {\n    questions: params.questions.map((question) => ({\n      question: question.question,\n      header: question.header,\n      multiSelect: question.multiSelect ?? false,\n      options: question.options.map((option) => ({\n        label: option.label,\n        description: option.description,\n        hasPreview: Boolean(option.preview),\n      })),\n    })),\n  };\n  cordis.emit(DOOM_ASK_USER_PROMPT_EVENT, payload);\n}\n\nfunction emitBlocked(cordis: Context, active: boolean): void {\n  const payload: AskUserBlockedEvent = { active };\n  cordis.emit(DOOM_ASK_USER_BLOCKED_EVENT, payload);\n}\n\nfunction hasDialogUI(context: ExtensionContext): boolean {\n  const ui = context.ui as unknown as { select?: unknown; input?: unknown };\n  return typeof ui.select === 'function' && typeof ui.input === 'function';\n}\n\nexport function registerAskUserQuestionTool(\n  pi: ExtensionAPI,\n  cordis: Context,\n  dependencies: AskUserQuestionToolDependencies,\n): void {\n  const configuredGuidance = loadUserFeedbackConfig().guidance;\n  pi.registerTool({\n    name: ASK_USER_QUESTION_TOOL_NAME,\n    label: 'Ask User Question',\n    renderShell: 'self',\n    description: `Ask the user one or more structured questions during execution. Use when you need to:\n1. Gather user preferences or requirements\n2. Clarify ambiguous instructions\n3. Get decisions on implementation choices as you work\n4. Offer choices to the user about what direction to take\n\nUsage notes:\n- Users can type a custom answer via the automatically appended \"Type something.\" row on every question or press Esc to abandon the questionnaire. Do NOT author \"Other\" or \"Type something.\" labels yourself — reserved labels are rejected at runtime.\n- Use multiSelect: true when multiple answers are valid.\n- If you recommend a specific option, make that the first option and add \"(Recommended)\" at the end of the label.\n\nPreview feature:\nUse the optional preview field for ASCII mockups, code snippets, diagrams, or configuration examples that users should compare visually. Do not use previews for simple preference questions.`,\n    promptSnippet: configuredGuidance?.promptSnippet ?? DEFAULT_PROMPT_SNIPPET,\n    promptGuidelines: configuredGuidance?.promptGuidelines ?? DEFAULT_PROMPT_GUIDELINES,\n    parameters: QuestionParamsSchema,\n    executionMode: 'sequential',\n\n    async execute(_toolCallId, params, signal, _onUpdate, context) {\n      const typed = params as QuestionParams;\n      const isActive = (activeSignal?: AbortSignal): boolean => dependencies.isActive?.(context, activeSignal) ?? true;\n      const cancelled = (): QuestionnaireResult => ({ answers: [], cancelled: true });\n      if (!isActive(signal)) return buildToolResult(ERROR_SESSION_INACTIVE, cancelled());\n      if (!context.hasUI) {\n        return buildToolResult(ERROR_NO_UI, { answers: [], cancelled: true, error: 'no_ui' });\n      }\n\n      const validation = validateQuestionnaire(typed);\n      if (!validation.ok) {\n        return buildToolResult(validation.message, {\n          answers: [],\n          cancelled: true,\n          error: validation.error,\n        });\n      }\n\n      try {\n        const result = await dependencies.enqueue(async ({ signal: activeSignal, reportProgress }) => {\n          if (!isActive(activeSignal)) return cancelled();\n          emitPrompt(cordis, typed);\n          const voiceResult = await dependencies.tryVoice?.(typed);\n          if (voiceResult) return voiceResult;\n\n          let blocked = true;\n          const clearBlocked = (): void => {\n            if (!blocked) return;\n            blocked = false;\n            if (isActive()) emitBlocked(cordis, false);\n          };\n          activeSignal.addEventListener('abort', clearBlocked, { once: true });\n          emitBlocked(cordis, true);\n          try {\n            if (!isActive(activeSignal)) return cancelled();\n            if (context.mode === 'rpc' && hasDialogUI(context)) {\n              const rpcResult = await runRpcQuestionnaire(context, typed, activeSignal, reportProgress);\n              return isActive(activeSignal) ? rpcResult : cancelled();\n            }\n\n            const tuiResult = await dependencies.runTui(\n              context,\n              typed,\n              resolveCollapseKey(loadUserFeedbackConfig()),\n              activeSignal,\n              reportProgress,\n            );\n            if (!isActive(activeSignal)) return cancelled();\n            if (tuiResult !== undefined) return tuiResult;\n            if (hasDialogUI(context)) {\n              const rpcResult = await runRpcQuestionnaire(context, typed, activeSignal, reportProgress);\n              return isActive(activeSignal) ? rpcResult : cancelled();\n            }\n            return { answers: [], cancelled: true, error: 'no_custom_ui' };\n          } finally {\n            activeSignal.removeEventListener('abort', clearBlocked);\n            clearBlocked();\n          }\n        }, signal);\n\n        if (result.delivery === 'voice') return buildVoiceToolResult(result);\n        if (result.error === 'no_custom_ui') return buildToolResult(ERROR_NO_CUSTOM_UI, result);\n        return buildQuestionnaireResponse(result, typed);\n      } catch (error) {\n        const cause = error instanceof Error ? error.message : String(error);\n        return buildToolResult(`${ERROR_SESSION_LOAD_FAILED} (cause: ${cause})`, {\n          answers: [],\n          cancelled: true,\n          error: 'session_load_failed',\n        });\n      }\n    },\n\n    renderCall(args, theme) {\n      const params = args as QuestionParams;\n      const headers = params.questions.map((question) => question.header).join(', ');\n      const count = `${params.questions.length} question${params.questions.length === 1 ? '' : 's'}`;\n      const heading = renderToolHeading('ask', count, theme);\n      return new DoomToolCall(headers ? `${heading} ${theme.fg('dim', `(${headers})`)}` : heading);\n    },\n\n    renderResult(result, _options, theme, context) {\n      const details = result.details as QuestionnaireResult | undefined;\n      if (!details) {\n        const raw = result.content\n          .filter((block) => block.type === 'text')\n          .map((block) => block.text)\n          .join('\\n');\n        const color = context.isError ? 'error' : 'toolOutput';\n        const fallback = context.isError ? '✗ failed' : '✓ submitted';\n        return new DoomToolResult([theme.fg(color, raw || fallback)], theme, { wrap: true });\n      }\n      if (details.cancelled) {\n        return new DoomToolResult([theme.fg('warning', '◐') + theme.fg('dim', ' cancelled')], theme);\n      }\n      if (details.delivery === 'voice' && details.voicePrompt) {\n        return new DoomToolResult([theme.fg('toolOutput', details.voicePrompt)], theme, { wrap: true });\n      }\n      const lines = details.answers.map((answer) => {\n        const scalar = answer.kind === 'multi' ? (answer.selected ?? []).join(', ') : answer.answer;\n        return `${theme.fg('success', '✓')} ${theme.fg('accent', answer.question)}: ${theme.fg(\n          'toolOutput',\n          scalar ?? '',\n        )}`;\n      });\n      if (lines.length === 0) lines.push(theme.fg('success', '✓') + theme.fg('dim', ' submitted'));\n      return new DoomToolResult(lines, theme, { wrap: true });\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/adapters/pi/askUserQuestionAdapter.mjs

@@ -1,4 +1,4 @@
-import{buildVoiceToolResult as e}from"../doom/voiceQuestionHandoff.mjs";import{QuestionParamsSchema as t}from"../../schemas/questionnaire.mjs";import{buildQuestionnaireResponse as n,buildToolResult as r}from"../../services/responseService.mjs";import{validateQuestionnaire as i}from"../../services/validationService.mjs";import{loadUserFeedbackConfig as a,resolveCollapseKey as o}from"../config/configAdapter.mjs";import{runRpcQuestionnaire as s}from"./rpcQuestionnaireAdapter.mjs";import{publishAskUserBlocked as c,publishAskUserPrompt as l}from"@agimon-ai/doompi-extension-contracts";import{DoomToolCall as u,DoomToolResult as d,renderToolHeading as f}from"@agimon-ai/doompi-ui/toolChrome";const p=`ask_user_question`,m=`Ask the user up to 4 structured questions (2-4 options each) when requirements are ambiguous`,h=[`Use ask_user_question whenever the user's request is underspecified and you cannot proceed without concrete decisions — you can ask up to 4 questions per invocation.`,`Each question MUST have 2-4 options. Every option requires a concise label (1-5 words) and a description explaining what the choice means or its trade-offs. The user can additionally type a custom answer via the automatically appended "Type something." row on every question, or press Esc to abandon the questionnaire. Do NOT author "Other" or "Type something." labels yourself — reserved labels are rejected at runtime.`,`Set multiSelect: true when multiple answers are valid. Provide an options[].preview markdown string when an option benefits from richer side-by-side context (mockups, code snippets, diagrams, configs) — single-select only. If you recommend a specific option, make that the first option and append "(Recommended)" to its label.`,`Do not stack multiple ask_user_question calls back-to-back — group all clarifying questions into one invocation.`];function g(e,t){let n={questions:t.questions.map(e=>({question:e.question,header:e.header,multiSelect:e.multiSelect??!1,options:e.options.map(e=>({label:e.label,description:e.description,hasPreview:!!e.preview}))}))};l(e.events,n)}function _(e,t){let n={active:t};c(e.events,n)}function v(e){let t=e.ui;return typeof t.select==`function`&&typeof t.input==`function`}function y(c,l){let y=a().guidance;c.registerTool({name:p,label:`Ask User Question`,renderShell:`self`,description:`Ask the user one or more structured questions during execution. Use when you need to:
+import{buildVoiceToolResult as e}from"../doom/voiceQuestionHandoff.mjs";import{QuestionParamsSchema as t}from"../../schemas/questionnaire.mjs";import{buildQuestionnaireResponse as n,buildToolResult as r}from"../../services/responseService.mjs";import{validateQuestionnaire as i}from"../../services/validationService.mjs";import{loadUserFeedbackConfig as a,resolveCollapseKey as o}from"../config/configAdapter.mjs";import{runRpcQuestionnaire as s}from"./rpcQuestionnaireAdapter.mjs";import{DOOM_ASK_USER_BLOCKED_EVENT as c,DOOM_ASK_USER_PROMPT_EVENT as l}from"@agimon-ai/doompi-extension-contracts/ask-user";import{DoomToolCall as u,DoomToolResult as d,renderToolHeading as f}from"@agimon-ai/doompi-ui/toolChrome";const p=`ask_user_question`,m=`Ask the user up to 4 structured questions (2-4 options each) when requirements are ambiguous`,h=[`Use ask_user_question whenever the user's request is underspecified and you cannot proceed without concrete decisions — you can ask up to 4 questions per invocation.`,`Each question MUST have 2-4 options. Every option requires a concise label (1-5 words) and a description explaining what the choice means or its trade-offs. The user can additionally type a custom answer via the automatically appended "Type something." row on every question, or press Esc to abandon the questionnaire. Do NOT author "Other" or "Type something." labels yourself — reserved labels are rejected at runtime.`,`Set multiSelect: true when multiple answers are valid. Provide an options[].preview markdown string when an option benefits from richer side-by-side context (mockups, code snippets, diagrams, configs) — single-select only. If you recommend a specific option, make that the first option and append "(Recommended)" to its label.`,`Do not stack multiple ask_user_question calls back-to-back — group all clarifying questions into one invocation.`];function g(e,t){let n={questions:t.questions.map(e=>({question:e.question,header:e.header,multiSelect:e.multiSelect??!1,options:e.options.map(e=>({label:e.label,description:e.description,hasPreview:!!e.preview}))}))};e.emit(l,n)}function _(e,t){let n={active:t};e.emit(c,n)}function v(e){let t=e.ui;return typeof t.select==`function`&&typeof t.input==`function`}function y(c,l,y){let b=a().guidance;c.registerTool({name:p,label:`Ask User Question`,renderShell:`self`,description:`Ask the user one or more structured questions during execution. Use when you need to:
 1. Gather user preferences or requirements
 2. Clarify ambiguous instructions
 3. Get decisions on implementation choices as you work
@@ -10,6 +10,6 @@ Usage notes:
 - If you recommend a specific option, make that the first option and add "(Recommended)" at the end of the label.
 
 Preview feature:
-Use the optional preview field for ASCII mockups, code snippets, diagrams, or configuration examples that users should compare visually. Do not use previews for simple preference questions.`,promptSnippet:y?.promptSnippet??m,promptGuidelines:y?.promptGuidelines??h,parameters:t,executionMode:`sequential`,async execute(t,u,d,f,p){let m=u,h=e=>l.isActive?.(p,e)??!0,y=()=>({answers:[],cancelled:!0});if(!h(d))return r(`Error: the questionnaire session is no longer active.`,y());if(!p.hasUI)return r(`Error: UI not available (running in non-interactive mode)`,{answers:[],cancelled:!0,error:`no_ui`});let b=i(m);if(!b.ok)return r(b.message,{answers:[],cancelled:!0,error:b.error});try{let t=await l.enqueue(async({signal:e,reportProgress:t})=>{if(!h(e))return y();g(c,m);let n=l.tryVoice?.(m);if(n)return n;let r=!0,i=()=>{r&&(r=!1,h()&&_(c,!1))};e.addEventListener(`abort`,i,{once:!0}),_(c,!0);try{if(!h(e))return y();if(p.mode===`rpc`&&v(p)){let n=await s(p,m,e,t);return h(e)?n:y()}let n=await l.runTui(p,m,o(a()),e,t);if(!h(e))return y();if(n!==void 0)return n;if(v(p)){let n=await s(p,m,e,t);return h(e)?n:y()}return{answers:[],cancelled:!0,error:`no_custom_ui`}}finally{e.removeEventListener(`abort`,i),i()}},d);return t.delivery===`voice`?e(t):t.error===`no_custom_ui`?r(`Error: this client cannot render the questionnaire (custom UI is unavailable). The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead, without using this tool.`,t):n(t,m)}catch(e){let t=e instanceof Error?e.message:String(e);return r(`Error: the questionnaire UI failed to load. The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead. (cause: ${t})`,{answers:[],cancelled:!0,error:`session_load_failed`})}},renderCall(e,t){let n=e,r=n.questions.map(e=>e.header).join(`, `),i=`${n.questions.length} question${n.questions.length===1?``:`s`}`,a=f(`ask`,i,t);return new u(r?`${a} ${t.fg(`dim`,`(${r})`)}`:a)},renderResult(e,t,n,r){let i=e.details;if(!i){let t=e.content.filter(e=>e.type===`text`).map(e=>e.text).join(`
+Use the optional preview field for ASCII mockups, code snippets, diagrams, or configuration examples that users should compare visually. Do not use previews for simple preference questions.`,promptSnippet:b?.promptSnippet??m,promptGuidelines:b?.promptGuidelines??h,parameters:t,executionMode:`sequential`,async execute(t,c,u,d,f){let p=c,m=e=>y.isActive?.(f,e)??!0,h=()=>({answers:[],cancelled:!0});if(!m(u))return r(`Error: the questionnaire session is no longer active.`,h());if(!f.hasUI)return r(`Error: UI not available (running in non-interactive mode)`,{answers:[],cancelled:!0,error:`no_ui`});let b=i(p);if(!b.ok)return r(b.message,{answers:[],cancelled:!0,error:b.error});try{let t=await y.enqueue(async({signal:e,reportProgress:t})=>{if(!m(e))return h();g(l,p);let n=await y.tryVoice?.(p);if(n)return n;let r=!0,i=()=>{r&&(r=!1,m()&&_(l,!1))};e.addEventListener(`abort`,i,{once:!0}),_(l,!0);try{if(!m(e))return h();if(f.mode===`rpc`&&v(f)){let n=await s(f,p,e,t);return m(e)?n:h()}let n=await y.runTui(f,p,o(a()),e,t);if(!m(e))return h();if(n!==void 0)return n;if(v(f)){let n=await s(f,p,e,t);return m(e)?n:h()}return{answers:[],cancelled:!0,error:`no_custom_ui`}}finally{e.removeEventListener(`abort`,i),i()}},u);return t.delivery===`voice`?e(t):t.error===`no_custom_ui`?r(`Error: this client cannot render the questionnaire (custom UI is unavailable). The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead, without using this tool.`,t):n(t,p)}catch(e){let t=e instanceof Error?e.message:String(e);return r(`Error: the questionnaire UI failed to load. The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead. (cause: ${t})`,{answers:[],cancelled:!0,error:`session_load_failed`})}},renderCall(e,t){let n=e,r=n.questions.map(e=>e.header).join(`, `),i=`${n.questions.length} question${n.questions.length===1?``:`s`}`,a=f(`ask`,i,t);return new u(r?`${a} ${t.fg(`dim`,`(${r})`)}`:a)},renderResult(e,t,n,r){let i=e.details;if(!i){let t=e.content.filter(e=>e.type===`text`).map(e=>e.text).join(`
 `),i=r.isError?`error`:`toolOutput`,a=r.isError?`✗ failed`:`✓ submitted`;return new d([n.fg(i,t||a)],n,{wrap:!0})}if(i.cancelled)return new d([n.fg(`warning`,`◐`)+n.fg(`dim`,` cancelled`)],n);if(i.delivery===`voice`&&i.voicePrompt)return new d([n.fg(`toolOutput`,i.voicePrompt)],n,{wrap:!0});let a=i.answers.map(e=>{let t=e.kind===`multi`?(e.selected??[]).join(`, `):e.answer;return`${n.fg(`success`,`✓`)} ${n.fg(`accent`,e.question)}: ${n.fg(`toolOutput`,t??``)}`});return a.length===0&&a.push(n.fg(`success`,`✓`)+n.fg(`dim`,` submitted`)),new d(a,n,{wrap:!0})}})}export{p as ASK_USER_QUESTION_TOOL_NAME,h as DEFAULT_PROMPT_GUIDELINES,m as DEFAULT_PROMPT_SNIPPET,y as registerAskUserQuestionTool};
 //# sourceMappingURL=askUserQuestionAdapter.mjs.map

package/dist/adapters/pi/askUserQuestionAdapter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"askUserQuestionAdapter.mjs","names":[],"sources":["../../../src/adapters/pi/askUserQuestionAdapter.ts"],"sourcesContent":["import { publishAskUserBlocked, publishAskUserPrompt } from '@agimon-ai/doompi-extension-contracts';\nimport { DoomToolCall, DoomToolResult, renderToolHeading } from '@agimon-ai/doompi-ui/toolChrome';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { AskUserBlockedEventPayload, AskUserPromptEventPayload } from '../../schemas/events.js';\nimport {\n  MAX_OPTIONS,\n  MAX_QUESTIONS,\n  MIN_OPTIONS,\n  type QuestionParams,\n  QuestionParamsSchema,\n} from '../../schemas/questionnaire.js';\nimport type { QuestionnaireRunner } from '../../services/questionnaireCoordinator.js';\nimport { buildQuestionnaireResponse, buildToolResult } from '../../services/responseService.js';\nimport { validateQuestionnaire } from '../../services/validationService.js';\nimport type { QuestionnaireResult } from '../../types/questionnaire.js';\nimport { loadUserFeedbackConfig, resolveCollapseKey } from '../config/configAdapter.js';\nimport { buildVoiceToolResult } from '../doom/voiceQuestionHandoff.js';\nimport { runRpcQuestionnaire } from './rpcQuestionnaireAdapter.js';\n\nexport const ASK_USER_QUESTION_TOOL_NAME = 'ask_user_question';\n\nexport const DEFAULT_PROMPT_SNIPPET = `Ask the user up to ${MAX_QUESTIONS} structured questions (${MIN_OPTIONS}-${MAX_OPTIONS} options each) when requirements are ambiguous`;\nexport const DEFAULT_PROMPT_GUIDELINES = [\n  `Use ask_user_question whenever the user's request is underspecified and you cannot proceed without concrete decisions — you can ask up to ${MAX_QUESTIONS} questions per invocation.`,\n  `Each question MUST have ${MIN_OPTIONS}-${MAX_OPTIONS} options. Every option requires a concise label (1-5 words) and a description explaining what the choice means or its trade-offs. The user can additionally type a custom answer via the automatically appended \"Type something.\" row on every question, or press Esc to abandon the questionnaire. Do NOT author \"Other\" or \"Type something.\" labels yourself — reserved labels are rejected at runtime.`,\n  'Set multiSelect: true when multiple answers are valid. Provide an options[].preview markdown string when an option benefits from richer side-by-side context (mockups, code snippets, diagrams, configs) — single-select only. If you recommend a specific option, make that the first option and append \"(Recommended)\" to its label.',\n  'Do not stack multiple ask_user_question calls back-to-back — group all clarifying questions into one invocation.',\n];\n\nconst ERROR_NO_UI = 'Error: UI not available (running in non-interactive mode)';\nconst ERROR_NO_CUSTOM_UI =\n  'Error: this client cannot render the questionnaire (custom UI is unavailable). The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead, without using this tool.';\nconst ERROR_SESSION_LOAD_FAILED =\n  'Error: the questionnaire UI failed to load. The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead.';\nconst ERROR_SESSION_INACTIVE = 'Error: the questionnaire session is no longer active.';\n\nexport interface AskUserQuestionToolDependencies {\n  enqueue: (runner: QuestionnaireRunner, signal?: AbortSignal) => Promise<QuestionnaireResult>;\n  isActive?: (context: ExtensionContext, signal?: AbortSignal) => boolean;\n  tryVoice?: (params: QuestionParams) => QuestionnaireResult | undefined;\n  runTui: (\n    context: ExtensionContext,\n    params: QuestionParams,\n    collapseKey: string,\n    signal?: AbortSignal,\n    reportProgress?: (result: QuestionnaireResult) => void,\n  ) => Promise<QuestionnaireResult | undefined>;\n}\n\nfunction emitPrompt(pi: ExtensionAPI, params: QuestionParams): void {\n  const payload: AskUserPromptEventPayload = {\n    questions: params.questions.map((question) => ({\n      question: question.question,\n      header: question.header,\n      multiSelect: question.multiSelect ?? false,\n      options: question.options.map((option) => ({\n        label: option.label,\n        description: option.description,\n        hasPreview: Boolean(option.preview),\n      })),\n    })),\n  };\n  publishAskUserPrompt(pi.events, payload);\n}\n\nfunction emitBlocked(pi: ExtensionAPI, active: boolean): void {\n  const payload: AskUserBlockedEventPayload = { active };\n  publishAskUserBlocked(pi.events, payload);\n}\n\nfunction hasDialogUI(context: ExtensionContext): boolean {\n  const ui = context.ui as unknown as { select?: unknown; input?: unknown };\n  return typeof ui.select === 'function' && typeof ui.input === 'function';\n}\n\nexport function registerAskUserQuestionTool(pi: ExtensionAPI, dependencies: AskUserQuestionToolDependencies): void {\n  const configuredGuidance = loadUserFeedbackConfig().guidance;\n  pi.registerTool({\n    name: ASK_USER_QUESTION_TOOL_NAME,\n    label: 'Ask User Question',\n    renderShell: 'self',\n    description: `Ask the user one or more structured questions during execution. Use when you need to:\n1. Gather user preferences or requirements\n2. Clarify ambiguous instructions\n3. Get decisions on implementation choices as you work\n4. Offer choices to the user about what direction to take\n\nUsage notes:\n- Users can type a custom answer via the automatically appended \"Type something.\" row on every question or press Esc to abandon the questionnaire. Do NOT author \"Other\" or \"Type something.\" labels yourself — reserved labels are rejected at runtime.\n- Use multiSelect: true when multiple answers are valid.\n- If you recommend a specific option, make that the first option and add \"(Recommended)\" at the end of the label.\n\nPreview feature:\nUse the optional preview field for ASCII mockups, code snippets, diagrams, or configuration examples that users should compare visually. Do not use previews for simple preference questions.`,\n    promptSnippet: configuredGuidance?.promptSnippet ?? DEFAULT_PROMPT_SNIPPET,\n    promptGuidelines: configuredGuidance?.promptGuidelines ?? DEFAULT_PROMPT_GUIDELINES,\n    parameters: QuestionParamsSchema,\n    executionMode: 'sequential',\n\n    async execute(_toolCallId, params, signal, _onUpdate, context) {\n      const typed = params as QuestionParams;\n      const isActive = (activeSignal?: AbortSignal): boolean => dependencies.isActive?.(context, activeSignal) ?? true;\n      const cancelled = (): QuestionnaireResult => ({ answers: [], cancelled: true });\n      if (!isActive(signal)) return buildToolResult(ERROR_SESSION_INACTIVE, cancelled());\n      if (!context.hasUI) {\n        return buildToolResult(ERROR_NO_UI, { answers: [], cancelled: true, error: 'no_ui' });\n      }\n\n      const validation = validateQuestionnaire(typed);\n      if (!validation.ok) {\n        return buildToolResult(validation.message, {\n          answers: [],\n          cancelled: true,\n          error: validation.error,\n        });\n      }\n\n      try {\n        const result = await dependencies.enqueue(async ({ signal: activeSignal, reportProgress }) => {\n          if (!isActive(activeSignal)) return cancelled();\n          emitPrompt(pi, typed);\n          const voiceResult = dependencies.tryVoice?.(typed);\n          if (voiceResult) return voiceResult;\n\n          let blocked = true;\n          const clearBlocked = (): void => {\n            if (!blocked) return;\n            blocked = false;\n            if (isActive()) emitBlocked(pi, false);\n          };\n          activeSignal.addEventListener('abort', clearBlocked, { once: true });\n          emitBlocked(pi, true);\n          try {\n            if (!isActive(activeSignal)) return cancelled();\n            if (context.mode === 'rpc' && hasDialogUI(context)) {\n              const rpcResult = await runRpcQuestionnaire(context, typed, activeSignal, reportProgress);\n              return isActive(activeSignal) ? rpcResult : cancelled();\n            }\n\n            const tuiResult = await dependencies.runTui(\n              context,\n              typed,\n              resolveCollapseKey(loadUserFeedbackConfig()),\n              activeSignal,\n              reportProgress,\n            );\n            if (!isActive(activeSignal)) return cancelled();\n            if (tuiResult !== undefined) return tuiResult;\n            if (hasDialogUI(context)) {\n              const rpcResult = await runRpcQuestionnaire(context, typed, activeSignal, reportProgress);\n              return isActive(activeSignal) ? rpcResult : cancelled();\n            }\n            return { answers: [], cancelled: true, error: 'no_custom_ui' };\n          } finally {\n            activeSignal.removeEventListener('abort', clearBlocked);\n            clearBlocked();\n          }\n        }, signal);\n\n        if (result.delivery === 'voice') return buildVoiceToolResult(result);\n        if (result.error === 'no_custom_ui') return buildToolResult(ERROR_NO_CUSTOM_UI, result);\n        return buildQuestionnaireResponse(result, typed);\n      } catch (error) {\n        const cause = error instanceof Error ? error.message : String(error);\n        return buildToolResult(`${ERROR_SESSION_LOAD_FAILED} (cause: ${cause})`, {\n          answers: [],\n          cancelled: true,\n          error: 'session_load_failed',\n        });\n      }\n    },\n\n    renderCall(args, theme) {\n      const params = args as QuestionParams;\n      const headers = params.questions.map((question) => question.header).join(', ');\n      const count = `${params.questions.length} question${params.questions.length === 1 ? '' : 's'}`;\n      const heading = renderToolHeading('ask', count, theme);\n      return new DoomToolCall(headers ? `${heading} ${theme.fg('dim', `(${headers})`)}` : heading);\n    },\n\n    renderResult(result, _options, theme, context) {\n      const details = result.details as QuestionnaireResult | undefined;\n      if (!details) {\n        const raw = result.content\n          .filter((block) => block.type === 'text')\n          .map((block) => block.text)\n          .join('\\n');\n        const color = context.isError ? 'error' : 'toolOutput';\n        const fallback = context.isError ? '✗ failed' : '✓ submitted';\n        return new DoomToolResult([theme.fg(color, raw || fallback)], theme, { wrap: true });\n      }\n      if (details.cancelled) {\n        return new DoomToolResult([theme.fg('warning', '◐') + theme.fg('dim', ' cancelled')], theme);\n      }\n      if (details.delivery === 'voice' && details.voicePrompt) {\n        return new DoomToolResult([theme.fg('toolOutput', details.voicePrompt)], theme, { wrap: true });\n      }\n      const lines = details.answers.map((answer) => {\n        const scalar = answer.kind === 'multi' ? (answer.selected ?? []).join(', ') : answer.answer;\n        return `${theme.fg('success', '✓')} ${theme.fg('accent', answer.question)}: ${theme.fg(\n          'toolOutput',\n          scalar ?? '',\n        )}`;\n      });\n      if (lines.length === 0) lines.push(theme.fg('success', '✓') + theme.fg('dim', ' submitted'));\n      return new DoomToolResult(lines, theme, { wrap: true });\n    },\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"askUserQuestionAdapter.mjs","names":[],"sources":["../../../src/adapters/pi/askUserQuestionAdapter.ts"],"sourcesContent":["import {\n  type AskUserBlockedEvent,\n  type AskUserPromptEvent,\n  DOOM_ASK_USER_BLOCKED_EVENT,\n  DOOM_ASK_USER_PROMPT_EVENT,\n} from '@agimon-ai/doompi-extension-contracts/ask-user';\nimport { DoomToolCall, DoomToolResult, renderToolHeading } from '@agimon-ai/doompi-ui/toolChrome';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport {\n  MAX_OPTIONS,\n  MAX_QUESTIONS,\n  MIN_OPTIONS,\n  type QuestionParams,\n  QuestionParamsSchema,\n} from '../../schemas/questionnaire.js';\nimport type { QuestionnaireRunner } from '../../services/questionnaireCoordinator.js';\nimport { buildQuestionnaireResponse, buildToolResult } from '../../services/responseService.js';\nimport { validateQuestionnaire } from '../../services/validationService.js';\nimport type { QuestionnaireResult } from '../../types/questionnaire.js';\nimport { loadUserFeedbackConfig, resolveCollapseKey } from '../config/configAdapter.js';\nimport { buildVoiceToolResult } from '../doom/voiceQuestionHandoff.js';\nimport { runRpcQuestionnaire } from './rpcQuestionnaireAdapter.js';\n\nexport const ASK_USER_QUESTION_TOOL_NAME = 'ask_user_question';\n\nexport const DEFAULT_PROMPT_SNIPPET = `Ask the user up to ${MAX_QUESTIONS} structured questions (${MIN_OPTIONS}-${MAX_OPTIONS} options each) when requirements are ambiguous`;\nexport const DEFAULT_PROMPT_GUIDELINES = [\n  `Use ask_user_question whenever the user's request is underspecified and you cannot proceed without concrete decisions — you can ask up to ${MAX_QUESTIONS} questions per invocation.`,\n  `Each question MUST have ${MIN_OPTIONS}-${MAX_OPTIONS} options. Every option requires a concise label (1-5 words) and a description explaining what the choice means or its trade-offs. The user can additionally type a custom answer via the automatically appended \"Type something.\" row on every question, or press Esc to abandon the questionnaire. Do NOT author \"Other\" or \"Type something.\" labels yourself — reserved labels are rejected at runtime.`,\n  'Set multiSelect: true when multiple answers are valid. Provide an options[].preview markdown string when an option benefits from richer side-by-side context (mockups, code snippets, diagrams, configs) — single-select only. If you recommend a specific option, make that the first option and append \"(Recommended)\" to its label.',\n  'Do not stack multiple ask_user_question calls back-to-back — group all clarifying questions into one invocation.',\n];\n\nconst ERROR_NO_UI = 'Error: UI not available (running in non-interactive mode)';\nconst ERROR_NO_CUSTOM_UI =\n  'Error: this client cannot render the questionnaire (custom UI is unavailable). The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead, without using this tool.';\nconst ERROR_SESSION_LOAD_FAILED =\n  'Error: the questionnaire UI failed to load. The user never saw the questions — do NOT treat this as a decline. Ask the questions as plain chat text instead.';\nconst ERROR_SESSION_INACTIVE = 'Error: the questionnaire session is no longer active.';\n\nexport interface AskUserQuestionToolDependencies {\n  enqueue: (runner: QuestionnaireRunner, signal?: AbortSignal) => Promise<QuestionnaireResult>;\n  isActive?: (context: ExtensionContext, signal?: AbortSignal) => boolean;\n  tryVoice?: (params: QuestionParams) => QuestionnaireResult | undefined | Promise<QuestionnaireResult | undefined>;\n  runTui: (\n    context: ExtensionContext,\n    params: QuestionParams,\n    collapseKey: string,\n    signal?: AbortSignal,\n    reportProgress?: (result: QuestionnaireResult) => void,\n  ) => Promise<QuestionnaireResult | undefined>;\n}\n\nfunction emitPrompt(cordis: Context, params: QuestionParams): void {\n  const payload: AskUserPromptEvent = {\n    questions: params.questions.map((question) => ({\n      question: question.question,\n      header: question.header,\n      multiSelect: question.multiSelect ?? false,\n      options: question.options.map((option) => ({\n        label: option.label,\n        description: option.description,\n        hasPreview: Boolean(option.preview),\n      })),\n    })),\n  };\n  cordis.emit(DOOM_ASK_USER_PROMPT_EVENT, payload);\n}\n\nfunction emitBlocked(cordis: Context, active: boolean): void {\n  const payload: AskUserBlockedEvent = { active };\n  cordis.emit(DOOM_ASK_USER_BLOCKED_EVENT, payload);\n}\n\nfunction hasDialogUI(context: ExtensionContext): boolean {\n  const ui = context.ui as unknown as { select?: unknown; input?: unknown };\n  return typeof ui.select === 'function' && typeof ui.input === 'function';\n}\n\nexport function registerAskUserQuestionTool(\n  pi: ExtensionAPI,\n  cordis: Context,\n  dependencies: AskUserQuestionToolDependencies,\n): void {\n  const configuredGuidance = loadUserFeedbackConfig().guidance;\n  pi.registerTool({\n    name: ASK_USER_QUESTION_TOOL_NAME,\n    label: 'Ask User Question',\n    renderShell: 'self',\n    description: `Ask the user one or more structured questions during execution. Use when you need to:\n1. Gather user preferences or requirements\n2. Clarify ambiguous instructions\n3. Get decisions on implementation choices as you work\n4. Offer choices to the user about what direction to take\n\nUsage notes:\n- Users can type a custom answer via the automatically appended \"Type something.\" row on every question or press Esc to abandon the questionnaire. Do NOT author \"Other\" or \"Type something.\" labels yourself — reserved labels are rejected at runtime.\n- Use multiSelect: true when multiple answers are valid.\n- If you recommend a specific option, make that the first option and add \"(Recommended)\" at the end of the label.\n\nPreview feature:\nUse the optional preview field for ASCII mockups, code snippets, diagrams, or configuration examples that users should compare visually. Do not use previews for simple preference questions.`,\n    promptSnippet: configuredGuidance?.promptSnippet ?? DEFAULT_PROMPT_SNIPPET,\n    promptGuidelines: configuredGuidance?.promptGuidelines ?? DEFAULT_PROMPT_GUIDELINES,\n    parameters: QuestionParamsSchema,\n    executionMode: 'sequential',\n\n    async execute(_toolCallId, params, signal, _onUpdate, context) {\n      const typed = params as QuestionParams;\n      const isActive = (activeSignal?: AbortSignal): boolean => dependencies.isActive?.(context, activeSignal) ?? true;\n      const cancelled = (): QuestionnaireResult => ({ answers: [], cancelled: true });\n      if (!isActive(signal)) return buildToolResult(ERROR_SESSION_INACTIVE, cancelled());\n      if (!context.hasUI) {\n        return buildToolResult(ERROR_NO_UI, { answers: [], cancelled: true, error: 'no_ui' });\n      }\n\n      const validation = validateQuestionnaire(typed);\n      if (!validation.ok) {\n        return buildToolResult(validation.message, {\n          answers: [],\n          cancelled: true,\n          error: validation.error,\n        });\n      }\n\n      try {\n        const result = await dependencies.enqueue(async ({ signal: activeSignal, reportProgress }) => {\n          if (!isActive(activeSignal)) return cancelled();\n          emitPrompt(cordis, typed);\n          const voiceResult = await dependencies.tryVoice?.(typed);\n          if (voiceResult) return voiceResult;\n\n          let blocked = true;\n          const clearBlocked = (): void => {\n            if (!blocked) return;\n            blocked = false;\n            if (isActive()) emitBlocked(cordis, false);\n          };\n          activeSignal.addEventListener('abort', clearBlocked, { once: true });\n          emitBlocked(cordis, true);\n          try {\n            if (!isActive(activeSignal)) return cancelled();\n            if (context.mode === 'rpc' && hasDialogUI(context)) {\n              const rpcResult = await runRpcQuestionnaire(context, typed, activeSignal, reportProgress);\n              return isActive(activeSignal) ? rpcResult : cancelled();\n            }\n\n            const tuiResult = await dependencies.runTui(\n              context,\n              typed,\n              resolveCollapseKey(loadUserFeedbackConfig()),\n              activeSignal,\n              reportProgress,\n            );\n            if (!isActive(activeSignal)) return cancelled();\n            if (tuiResult !== undefined) return tuiResult;\n            if (hasDialogUI(context)) {\n              const rpcResult = await runRpcQuestionnaire(context, typed, activeSignal, reportProgress);\n              return isActive(activeSignal) ? rpcResult : cancelled();\n            }\n            return { answers: [], cancelled: true, error: 'no_custom_ui' };\n          } finally {\n            activeSignal.removeEventListener('abort', clearBlocked);\n            clearBlocked();\n          }\n        }, signal);\n\n        if (result.delivery === 'voice') return buildVoiceToolResult(result);\n        if (result.error === 'no_custom_ui') return buildToolResult(ERROR_NO_CUSTOM_UI, result);\n        return buildQuestionnaireResponse(result, typed);\n      } catch (error) {\n        const cause = error instanceof Error ? error.message : String(error);\n        return buildToolResult(`${ERROR_SESSION_LOAD_FAILED} (cause: ${cause})`, {\n          answers: [],\n          cancelled: true,\n          error: 'session_load_failed',\n        });\n      }\n    },\n\n    renderCall(args, theme) {\n      const params = args as QuestionParams;\n      const headers = params.questions.map((question) => question.header).join(', ');\n      const count = `${params.questions.length} question${params.questions.length === 1 ? '' : 's'}`;\n      const heading = renderToolHeading('ask', count, theme);\n      return new DoomToolCall(headers ? `${heading} ${theme.fg('dim', `(${headers})`)}` : heading);\n    },\n\n    renderResult(result, _options, theme, context) {\n      const details = result.details as QuestionnaireResult | undefined;\n      if (!details) {\n        const raw = result.content\n          .filter((block) => block.type === 'text')\n          .map((block) => block.text)\n          .join('\\n');\n        const color = context.isError ? 'error' : 'toolOutput';\n        const fallback = context.isError ? '✗ failed' : '✓ submitted';\n        return new DoomToolResult([theme.fg(color, raw || fallback)], theme, { wrap: true });\n      }\n      if (details.cancelled) {\n        return new DoomToolResult([theme.fg('warning', '◐') + theme.fg('dim', ' cancelled')], theme);\n      }\n      if (details.delivery === 'voice' && details.voicePrompt) {\n        return new DoomToolResult([theme.fg('toolOutput', details.voicePrompt)], theme, { wrap: true });\n      }\n      const lines = details.answers.map((answer) => {\n        const scalar = answer.kind === 'multi' ? (answer.selected ?? []).join(', ') : answer.answer;\n        return `${theme.fg('success', '✓')} ${theme.fg('accent', answer.question)}: ${theme.fg(\n          'toolOutput',\n          scalar ?? '',\n        )}`;\n      });\n      if (lines.length === 0) lines.push(theme.fg('success', '✓') + theme.fg('dim', ' submitted'));\n      return new DoomToolResult(lines, theme, { wrap: true });\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/adapters/pi/extension.cjs

@@ -1,2 +1,2 @@
-const e=require("../doom/voiceQuestionHandoff.cjs"),t=require("../../services/questionnaireCoordinator.cjs"),n=require("./askUserQuestionAdapter.cjs"),r=require("./reconcileAdapter.cjs");let i=require("@deepseek-ai/cordis");const a=`@agimon-ai/doompi-user-feedback`;function o(){return{answers:[],cancelled:!0}}function s(e){if(e)try{e.dispose()}catch(e){process.emitWarning(`Could not dispose the user-feedback voice handoff: ${String(e)}`)}}function c(i,c){let l=!0,u=0,d,f=!1,p=new t.QuestionnaireCoordinator,m,h=Promise.resolve(),g=new Set,_=e=>(g.add(e),e.then(()=>g.delete(e),()=>g.delete(e)),e),v=(e,t)=>l&&e===u&&t===d,y=(e,t)=>l&&f&&t?.aborted!==!0&&e.sessionManager.getSessionId()===d,b=async()=>{if(!l)return;let e=p;e.shutdown();let t=m;m=void 0,s(t),l=!1,u+=1,f=!1,d=void 0,await Promise.allSettled(g),await e.waitForIdle()};i.effect(()=>b,`${a}/runtime`),n.registerAskUserQuestionTool(c,{enqueue:(e,t)=>{let n=p,r=u,i=d;return!f||!v(r,i)||t?.aborted?Promise.resolve(o()):n.enqueue(async t=>{if(!f||!v(r,i)||t.signal.aborted)return o();let n=await e({...t,reportProgress:e=>{v(r,i)&&!t.signal.aborted&&t.reportProgress(e)}});return f&&v(r,i)&&!t.signal.aborted?n:o()},t)},isActive:y,runTui:async(e,t,n,r,i)=>{if(!y(e,r))return;let{runTuiQuestionnaire:a}=await Promise.resolve().then(()=>require("../../tui/runQuestionnaire.cjs"));if(!y(e,r))return;let o=await a(e,t,n,r,i);return y(e,r)?o:void 0},tryVoice:e=>l&&f?m?.handoff(e):void 0}),r.registerAskUserQuestionReconciler(c,y),c.on(`session_start`,(n,r)=>{if(!l)return;let i=p;i.shutdown();let o=m;m=void 0,s(o);let g=r.sessionManager.getSessionId(),y=++u;p=new t.QuestionnaireCoordinator,d=g,f=!1;let b=async()=>{if(await i.waitForIdle(),!v(y,g))return;let t=e.createVoiceQuestionHandoff({bus:c.events,source:a,sessionId:g});if(!v(y,g)){s(t);return}m=t,f=!0},x=h.then(b,b);return h=x.catch(()=>void 0),_(x)})}async function l(e){let t=new i.Context,n,r=()=>(n??=t.fiber.dispose(),n);try{c(t,e),e.on(`session_shutdown`,r)}catch(e){throw await r(),e}}exports.default=l,exports.userFeedbackExtension=l,exports.installUserFeedbackRuntime=c;
+const e=require("../../services/questionnaireCoordinator.cjs"),t=require("../doom/voiceQuestionHandoff.cjs"),n=require("./askUserQuestionAdapter.cjs"),r=require("./reconcileAdapter.cjs");let i=require("@agimon-ai/doompi-extension-contracts/cordis-host"),a=require("@agimon-ai/doompi-extension-contracts/mode"),o=require("@agimon-ai/doompi-extension-contracts/narration");const s=`@agimon-ai/doompi-user-feedback`;function c(){return{answers:[],cancelled:!0}}function l(i,l){let u=!0,d=0,f,p=!1,m=new e.QuestionnaireCoordinator,h,g=Promise.resolve(),_=new Set,v=e=>(_.add(e),e.then(()=>_.delete(e),()=>_.delete(e)),e),y=(e,t)=>u&&e===d&&t===f,b=(e,t)=>u&&p&&t?.aborted!==!0&&e.sessionManager.getSessionId()===f,x=async()=>{if(!u)return;let e=m;e.shutdown(),u=!1,d+=1,p=!1,f=void 0,await Promise.allSettled(_),await e.waitForIdle()};i.effect(()=>x,`${s}/runtime`),i.inject([a.DOOM_MINOR_MODE_CATALOG_SERVICE,o.DOOM_NARRATION_SERVICE],e=>{let n=t.createVoiceQuestionHandoff((0,a.requireMinorModeCatalog)(e),(0,o.requireDoomNarrationService)(e));return h=n,()=>{h===n&&(h=void 0)}}),n.registerAskUserQuestionTool(l,i,{enqueue:(e,t)=>{let n=m,r=d,i=f;return!p||!y(r,i)||t?.aborted?Promise.resolve(c()):n.enqueue(async t=>{if(!p||!y(r,i)||t.signal.aborted)return c();let n=await e({...t,reportProgress:e=>{y(r,i)&&!t.signal.aborted&&t.reportProgress(e)}});return p&&y(r,i)&&!t.signal.aborted?n:c()},t)},isActive:b,runTui:async(e,t,n,r,i)=>{if(!b(e,r))return;let{runTuiQuestionnaire:a}=await Promise.resolve().then(()=>require("../../tui/runQuestionnaire.cjs"));if(!b(e,r))return;let o=await a(e,t,n,r,i);return b(e,r)?o:void 0},tryVoice:e=>u&&p?h?.handoff(e):void 0}),r.registerAskUserQuestionReconciler(l,b),l.on(`session_start`,(t,n)=>{if(!u)return;let r=m;r.shutdown();let i=n.sessionManager.getSessionId(),a=++d;m=new e.QuestionnaireCoordinator,f=i,p=!1;let o=async()=>{await r.waitForIdle(),y(a,i)&&(p=!0)},s=g.then(o,o);return g=s.catch(()=>void 0),v(s)})}async function u(e){let t=await(0,i.connectDoomCordisHost)(e,s),n=t.root.plugin(d,{pi:e});try{await n}catch(e){try{await n.dispose()}finally{await t.dispose()}throw e}let r;e.on(`session_shutdown`,()=>r??=(async()=>{try{await n.dispose()}finally{await t.dispose()}})())}function d(e,t){l(e,t.pi)}exports.default=u,exports.userFeedbackExtension=u,exports.installUserFeedbackRuntime=l;
 //# sourceMappingURL=extension.cjs.map

package/dist/adapters/pi/extension.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"extension.cjs","names":["QuestionnaireCoordinator","createVoiceQuestionHandoff","Context"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport { QuestionnaireCoordinator, type QuestionnaireRunner } from '../../services/questionnaireCoordinator.js';\nimport type { QuestionnaireResult } from '../../types/questionnaire.js';\nimport { createVoiceQuestionHandoff, type VoiceQuestionHandoffHandle } from '../doom/voiceQuestionHandoff.js';\nimport { registerAskUserQuestionTool } from './askUserQuestionAdapter.js';\nimport { registerAskUserQuestionReconciler } from './reconcileAdapter.js';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-user-feedback';\nconst SESSION_START_EVENT = 'session_start';\nconst SESSION_SHUTDOWN_EVENT = 'session_shutdown';\n\nfunction cancelledResult(): QuestionnaireResult {\n  return { answers: [], cancelled: true };\n}\n\nfunction disposeVoiceHandoff(handle: VoiceQuestionHandoffHandle | undefined): void {\n  if (!handle) return;\n  try {\n    handle.dispose();\n  } catch (error) {\n    process.emitWarning(`Could not dispose the user-feedback voice handoff: ${String(error)}`);\n  }\n}\n\n/** Install one user-feedback runtime into a package-local Cordis root. */\nexport function installUserFeedbackRuntime(cordis: Context, pi: ExtensionAPI): void {\n  let active = true;\n  let sessionGeneration = 0;\n  let sessionId: string | undefined;\n  let sessionReady = false;\n  let coordinator = new QuestionnaireCoordinator();\n  let voiceHandoff: VoiceQuestionHandoffHandle | undefined;\n  let lifecycleQueue: Promise<void> = Promise.resolve();\n  const pendingOperations = new Set<Promise<unknown>>();\n\n  const trackOperation = <T>(operation: Promise<T>): Promise<T> => {\n    pendingOperations.add(operation);\n    void operation.then(\n      () => pendingOperations.delete(operation),\n      () => pendingOperations.delete(operation),\n    );\n    return operation;\n  };\n  const ownsGeneration = (generation: number, expectedSessionId: string | undefined): boolean =>\n    active && generation === sessionGeneration && expectedSessionId === sessionId;\n  const isContextActive = (context: ExtensionContext, signal?: AbortSignal): boolean =>\n    active && sessionReady && signal?.aborted !== true && context.sessionManager.getSessionId() === sessionId;\n\n  const shutdownRuntime = async (): Promise<void> => {\n    if (!active) return;\n    const ownedCoordinator = coordinator;\n    ownedCoordinator.shutdown();\n    const ownedHandoff = voiceHandoff;\n    voiceHandoff = undefined;\n    disposeVoiceHandoff(ownedHandoff);\n    active = false;\n    sessionGeneration += 1;\n    sessionReady = false;\n    sessionId = undefined;\n    await Promise.allSettled(pendingOperations);\n    await ownedCoordinator.waitForIdle();\n  };\n  cordis.effect(() => shutdownRuntime, `${PACKAGE_SOURCE}/runtime`);\n\n  registerAskUserQuestionTool(pi, {\n    enqueue: (runner: QuestionnaireRunner, signal?: AbortSignal) => {\n      const ownedCoordinator = coordinator;\n      const generation = sessionGeneration;\n      const expectedSessionId = sessionId;\n      if (!sessionReady || !ownsGeneration(generation, expectedSessionId) || signal?.aborted) {\n        return Promise.resolve(cancelledResult());\n      }\n      return ownedCoordinator.enqueue(async (context) => {\n        if (!sessionReady || !ownsGeneration(generation, expectedSessionId) || context.signal.aborted) {\n          return cancelledResult();\n        }\n        const result = await runner({\n          ...context,\n          reportProgress: (progress) => {\n            if (ownsGeneration(generation, expectedSessionId) && !context.signal.aborted) {\n              context.reportProgress(progress);\n            }\n          },\n        });\n        return sessionReady && ownsGeneration(generation, expectedSessionId) && !context.signal.aborted\n          ? result\n          : cancelledResult();\n      }, signal);\n    },\n    isActive: isContextActive,\n    runTui: async (context, params, collapseKey, signal, reportProgress) => {\n      if (!isContextActive(context, signal)) return undefined;\n      const { runTuiQuestionnaire } = await import('../../tui/runQuestionnaire.js');\n      if (!isContextActive(context, signal)) return undefined;\n      const result = await runTuiQuestionnaire(context, params, collapseKey, signal, reportProgress);\n      return isContextActive(context, signal) ? result : undefined;\n    },\n    tryVoice: (params) => (active && sessionReady ? voiceHandoff?.handoff(params) : undefined),\n  });\n  registerAskUserQuestionReconciler(pi, isContextActive);\n\n  pi.on(SESSION_START_EVENT, (_event, context) => {\n    if (!active) return;\n    const previousCoordinator = coordinator;\n    previousCoordinator.shutdown();\n    const previousHandoff = voiceHandoff;\n    voiceHandoff = undefined;\n    disposeVoiceHandoff(previousHandoff);\n\n    const activeSessionId = context.sessionManager.getSessionId();\n    const generation = ++sessionGeneration;\n    const nextCoordinator = new QuestionnaireCoordinator();\n    coordinator = nextCoordinator;\n    sessionId = activeSessionId;\n    sessionReady = false;\n\n    const initializeSession = async (): Promise<void> => {\n      await previousCoordinator.waitForIdle();\n      if (!ownsGeneration(generation, activeSessionId)) return;\n      const nextHandoff = createVoiceQuestionHandoff({\n        bus: pi.events,\n        source: PACKAGE_SOURCE,\n        sessionId: activeSessionId,\n      });\n      if (!ownsGeneration(generation, activeSessionId)) {\n        disposeVoiceHandoff(nextHandoff);\n        return;\n      }\n      voiceHandoff = nextHandoff;\n      sessionReady = true;\n    };\n\n    const operation = lifecycleQueue.then(initializeSession, initializeSession);\n    lifecycleQueue = operation.catch(() => undefined);\n    return trackOperation(operation);\n  });\n}\n\n/** The package's sole Pi factory; Pi reloads it and Cordis owns all package resources. */\nexport async function userFeedbackExtension(pi: ExtensionAPI): Promise<void> {\n  const cordis = new Context();\n  let disposal: Promise<void> | undefined;\n  const dispose = (): Promise<void> => {\n    disposal ??= cordis.fiber.dispose();\n    return disposal;\n  };\n\n  try {\n    installUserFeedbackRuntime(cordis, pi);\n    pi.on(SESSION_SHUTDOWN_EVENT, dispose);\n  } catch (error) {\n    await dispose();\n    throw error;\n  }\n}\n\nexport default userFeedbackExtension;\n"],"mappings":"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"}
+{"version":3,"file":"extension.cjs","names":["QuestionnaireCoordinator","DOOM_MINOR_MODE_CATALOG_SERVICE","DOOM_NARRATION_SERVICE","createVoiceQuestionHandoff","requireMinorModeCatalog","requireDoomNarrationService","connectDoomCordisHost"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_MINOR_MODE_CATALOG_SERVICE, requireMinorModeCatalog } from '@agimon-ai/doompi-extension-contracts/mode';\nimport { DOOM_NARRATION_SERVICE, requireDoomNarrationService } from '@agimon-ai/doompi-extension-contracts/narration';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport { QuestionnaireCoordinator, type QuestionnaireRunner } from '../../services/questionnaireCoordinator.js';\nimport type { QuestionnaireResult } from '../../types/questionnaire.js';\nimport { createVoiceQuestionHandoff, type VoiceQuestionHandoff } from '../doom/voiceQuestionHandoff.js';\nimport { registerAskUserQuestionTool } from './askUserQuestionAdapter.js';\nimport { registerAskUserQuestionReconciler } from './reconcileAdapter.js';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-user-feedback';\nconst SESSION_START_EVENT = 'session_start';\n\nfunction cancelledResult(): QuestionnaireResult {\n  return { answers: [], cancelled: true };\n}\n\n/** Install one user-feedback runtime into its host-owned Cordis plugin fiber. */\nexport function installUserFeedbackRuntime(cordis: Context, pi: ExtensionAPI): void {\n  let active = true;\n  let sessionGeneration = 0;\n  let sessionId: string | undefined;\n  let sessionReady = false;\n  let coordinator = new QuestionnaireCoordinator();\n  let voiceHandoff: VoiceQuestionHandoff | undefined;\n  let lifecycleQueue: Promise<void> = Promise.resolve();\n  const pendingOperations = new Set<Promise<unknown>>();\n\n  const trackOperation = <T>(operation: Promise<T>): Promise<T> => {\n    pendingOperations.add(operation);\n    void operation.then(\n      () => pendingOperations.delete(operation),\n      () => pendingOperations.delete(operation),\n    );\n    return operation;\n  };\n  const ownsGeneration = (generation: number, expectedSessionId: string | undefined): boolean =>\n    active && generation === sessionGeneration && expectedSessionId === sessionId;\n  const isContextActive = (context: ExtensionContext, signal?: AbortSignal): boolean =>\n    active && sessionReady && signal?.aborted !== true && context.sessionManager.getSessionId() === sessionId;\n\n  const shutdownRuntime = async (): Promise<void> => {\n    if (!active) return;\n    const ownedCoordinator = coordinator;\n    ownedCoordinator.shutdown();\n    active = false;\n    sessionGeneration += 1;\n    sessionReady = false;\n    sessionId = undefined;\n    await Promise.allSettled(pendingOperations);\n    await ownedCoordinator.waitForIdle();\n  };\n  cordis.effect(() => shutdownRuntime, `${PACKAGE_SOURCE}/runtime`);\n\n  cordis.inject([DOOM_MINOR_MODE_CATALOG_SERVICE, DOOM_NARRATION_SERVICE], (serviceContext) => {\n    const handoff = createVoiceQuestionHandoff(\n      requireMinorModeCatalog(serviceContext),\n      requireDoomNarrationService(serviceContext),\n    );\n    voiceHandoff = handoff;\n    return () => {\n      if (voiceHandoff === handoff) voiceHandoff = undefined;\n    };\n  });\n\n  registerAskUserQuestionTool(pi, cordis, {\n    enqueue: (runner: QuestionnaireRunner, signal?: AbortSignal) => {\n      const ownedCoordinator = coordinator;\n      const generation = sessionGeneration;\n      const expectedSessionId = sessionId;\n      if (!sessionReady || !ownsGeneration(generation, expectedSessionId) || signal?.aborted) {\n        return Promise.resolve(cancelledResult());\n      }\n      return ownedCoordinator.enqueue(async (context) => {\n        if (!sessionReady || !ownsGeneration(generation, expectedSessionId) || context.signal.aborted) {\n          return cancelledResult();\n        }\n        const result = await runner({\n          ...context,\n          reportProgress: (progress) => {\n            if (ownsGeneration(generation, expectedSessionId) && !context.signal.aborted) {\n              context.reportProgress(progress);\n            }\n          },\n        });\n        return sessionReady && ownsGeneration(generation, expectedSessionId) && !context.signal.aborted\n          ? result\n          : cancelledResult();\n      }, signal);\n    },\n    isActive: isContextActive,\n    runTui: async (context, params, collapseKey, signal, reportProgress) => {\n      if (!isContextActive(context, signal)) return undefined;\n      const { runTuiQuestionnaire } = await import('../../tui/runQuestionnaire.js');\n      if (!isContextActive(context, signal)) return undefined;\n      const result = await runTuiQuestionnaire(context, params, collapseKey, signal, reportProgress);\n      return isContextActive(context, signal) ? result : undefined;\n    },\n    tryVoice: (params) => (active && sessionReady ? voiceHandoff?.handoff(params) : undefined),\n  });\n  registerAskUserQuestionReconciler(pi, isContextActive);\n\n  pi.on(SESSION_START_EVENT, (_event, context) => {\n    if (!active) return;\n    const previousCoordinator = coordinator;\n    previousCoordinator.shutdown();\n    const activeSessionId = context.sessionManager.getSessionId();\n    const generation = ++sessionGeneration;\n    const nextCoordinator = new QuestionnaireCoordinator();\n    coordinator = nextCoordinator;\n    sessionId = activeSessionId;\n    sessionReady = false;\n\n    const initializeSession = async (): Promise<void> => {\n      await previousCoordinator.waitForIdle();\n      if (!ownsGeneration(generation, activeSessionId)) return;\n      sessionReady = true;\n    };\n\n    const operation = lifecycleQueue.then(initializeSession, initializeSession);\n    lifecycleQueue = operation.catch(() => undefined);\n    return trackOperation(operation);\n  });\n}\n\n/** The package's sole Pi factory; Pi reloads it and Cordis owns all package resources. */\nexport async function userFeedbackExtension(pi: ExtensionAPI): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(userFeedbackPlugin, { pi });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface UserFeedbackPluginConfig {\n  readonly pi: ExtensionAPI;\n}\n\nfunction userFeedbackPlugin(cordis: Context, config: UserFeedbackPluginConfig): void {\n  installUserFeedbackRuntime(cordis, config.pi);\n}\n\nexport default userFeedbackExtension;\n"],"mappings":"mXAWA,MAAM,EAAiB,kCAGvB,SAAS,GAAuC,CAC9C,MAAO,CAAE,QAAS,CAAC,EAAG,UAAW,EAAK,CACxC,CAGA,SAAgB,EAA2B,EAAiB,EAAwB,CAClF,IAAI,EAAS,GACT,EAAoB,EACpB,EACA,EAAe,GACf,EAAc,IAAIA,EAAAA,yBAClB,EACA,EAAgC,QAAQ,QAAQ,EAC9C,EAAoB,IAAI,IAExB,EAAqB,IACzB,EAAkB,IAAI,CAAS,EAC/B,EAAe,SACP,EAAkB,OAAO,CAAS,MAClC,EAAkB,OAAO,CAAS,CAC1C,EACO,GAEH,GAAkB,EAAoB,IAC1C,GAAU,IAAe,GAAqB,IAAsB,EAChE,GAAmB,EAA2B,IAClD,GAAU,GAAgB,GAAQ,UAAY,IAAQ,EAAQ,eAAe,aAAa,IAAM,EAE5F,EAAkB,SAA2B,CACjD,GAAI,CAAC,EAAQ,OACb,IAAM,EAAmB,EACzB,EAAiB,SAAS,EAC1B,EAAS,GACT,GAAqB,EACrB,EAAe,GACf,EAAY,IAAA,GACZ,MAAM,QAAQ,WAAW,CAAiB,EAC1C,MAAM,EAAiB,YAAY,CACrC,EACA,EAAO,WAAa,EAAiB,GAAG,EAAe,SAAS,EAEhE,EAAO,OAAO,CAACC,EAAAA,gCAAiCC,EAAAA,sBAAsB,EAAI,GAAmB,CAC3F,IAAM,EAAUC,EAAAA,4BAAAA,EACdC,EAAAA,wBAAAA,CAAwB,CAAc,GAAA,EACtCC,EAAAA,4BAAAA,CAA4B,CAAc,CAC5C,EAEA,MADA,GAAe,MACF,CACP,IAAiB,IAAS,EAAe,IAAA,GAC/C,CACF,CAAC,EAED,EAAA,4BAA4B,EAAI,EAAQ,CACtC,SAAU,EAA6B,IAAyB,CAC9D,IAAM,EAAmB,EACnB,EAAa,EACb,EAAoB,EAI1B,MAHI,CAAC,GAAgB,CAAC,EAAe,EAAY,CAAiB,GAAK,GAAQ,QACtE,QAAQ,QAAQ,EAAgB,CAAC,EAEnC,EAAiB,QAAQ,KAAO,IAAY,CACjD,GAAI,CAAC,GAAgB,CAAC,EAAe,EAAY,CAAiB,GAAK,EAAQ,OAAO,QACpF,OAAO,EAAgB,EAEzB,IAAM,EAAS,MAAM,EAAO,CAC1B,GAAG,EACH,eAAiB,GAAa,CACxB,EAAe,EAAY,CAAiB,GAAK,CAAC,EAAQ,OAAO,SACnE,EAAQ,eAAe,CAAQ,CAEnC,CACF,CAAC,EACD,OAAO,GAAgB,EAAe,EAAY,CAAiB,GAAK,CAAC,EAAQ,OAAO,QACpF,EACA,EAAgB,CACtB,EAAG,CAAM,CACX,EACA,SAAU,EACV,OAAQ,MAAO,EAAS,EAAQ,EAAa,EAAQ,IAAmB,CACtE,GAAI,CAAC,EAAgB,EAAS,CAAM,EAAG,OACvC,GAAM,CAAE,uBAAwB,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAM,gCAAA,CAAA,EACtC,GAAI,CAAC,EAAgB,EAAS,CAAM,EAAG,OACvC,IAAM,EAAS,MAAM,EAAoB,EAAS,EAAQ,EAAa,EAAQ,CAAc,EAC7F,OAAO,EAAgB,EAAS,CAAM,EAAI,EAAS,IAAA,EACrD,EACA,SAAW,GAAY,GAAU,EAAe,GAAc,QAAQ,CAAM,EAAI,IAAA,EAClF,CAAC,EACD,EAAA,kCAAkC,EAAI,CAAe,EAErD,EAAG,GAAG,iBAAsB,EAAQ,IAAY,CAC9C,GAAI,CAAC,EAAQ,OACb,IAAM,EAAsB,EAC5B,EAAoB,SAAS,EAC7B,IAAM,EAAkB,EAAQ,eAAe,aAAa,EACtD,EAAa,EAAE,EAErB,EAAc,IADcL,EAAAA,yBAE5B,EAAY,EACZ,EAAe,GAEf,IAAM,EAAoB,SAA2B,CACnD,MAAM,EAAoB,YAAY,EACjC,EAAe,EAAY,CAAe,IAC/C,EAAe,GACjB,EAEM,EAAY,EAAe,KAAK,EAAmB,CAAiB,EAE1E,MADA,GAAiB,EAAU,UAAY,IAAA,EAAS,EACzC,EAAe,CAAS,CACjC,CAAC,CACH,CAGA,eAAsB,EAAsB,EAAiC,CAC3E,IAAM,EAAa,MAAA,EAAMM,EAAAA,sBAAAA,CAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAoB,CAAE,IAAG,CAAC,EAC/D,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAMA,SAAS,EAAmB,EAAiB,EAAwC,CACnF,EAA2B,EAAQ,EAAO,EAAE,CAC9C"}

package/dist/adapters/pi/extension.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBA4IsB,sBAAsB,IAAI,eAAe"}
+{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBA+HsB,sBAAsB,IAAI,eAAe"}

package/dist/adapters/pi/extension.d.mts

@@ -1,5 +1,5 @@
-import { Context } from "@deepseek-ai/cordis";
 import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import "@deepseek-ai/cordis";
 //#region src/adapters/pi/extension.d.ts
 /** The package's sole Pi factory; Pi reloads it and Cordis owns all package resources. */
 declare function userFeedbackExtension(pi: ExtensionAPI): Promise<void>;

package/dist/adapters/pi/extension.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBA4IsB,sBAAsB,IAAI,eAAe"}
+{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBA+HsB,sBAAsB,IAAI,eAAe"}

package/dist/adapters/pi/extension.mjs

@@ -1,2 +1,2 @@
-import{createVoiceQuestionHandoff as e}from"../doom/voiceQuestionHandoff.mjs";import{QuestionnaireCoordinator as t}from"../../services/questionnaireCoordinator.mjs";import{registerAskUserQuestionTool as n}from"./askUserQuestionAdapter.mjs";import{registerAskUserQuestionReconciler as r}from"./reconcileAdapter.mjs";import{Context as i}from"@deepseek-ai/cordis";const a=`@agimon-ai/doompi-user-feedback`;function o(){return{answers:[],cancelled:!0}}function s(e){if(e)try{e.dispose()}catch(e){process.emitWarning(`Could not dispose the user-feedback voice handoff: ${String(e)}`)}}function c(i,c){let l=!0,u=0,d,f=!1,p=new t,m,h=Promise.resolve(),g=new Set,_=e=>(g.add(e),e.then(()=>g.delete(e),()=>g.delete(e)),e),v=(e,t)=>l&&e===u&&t===d,y=(e,t)=>l&&f&&t?.aborted!==!0&&e.sessionManager.getSessionId()===d,b=async()=>{if(!l)return;let e=p;e.shutdown();let t=m;m=void 0,s(t),l=!1,u+=1,f=!1,d=void 0,await Promise.allSettled(g),await e.waitForIdle()};i.effect(()=>b,`${a}/runtime`),n(c,{enqueue:(e,t)=>{let n=p,r=u,i=d;return!f||!v(r,i)||t?.aborted?Promise.resolve(o()):n.enqueue(async t=>{if(!f||!v(r,i)||t.signal.aborted)return o();let n=await e({...t,reportProgress:e=>{v(r,i)&&!t.signal.aborted&&t.reportProgress(e)}});return f&&v(r,i)&&!t.signal.aborted?n:o()},t)},isActive:y,runTui:async(e,t,n,r,i)=>{if(!y(e,r))return;let{runTuiQuestionnaire:a}=await import(`../../tui/runQuestionnaire.mjs`);if(!y(e,r))return;let o=await a(e,t,n,r,i);return y(e,r)?o:void 0},tryVoice:e=>l&&f?m?.handoff(e):void 0}),r(c,y),c.on(`session_start`,(n,r)=>{if(!l)return;let i=p;i.shutdown();let o=m;m=void 0,s(o);let g=r.sessionManager.getSessionId(),y=++u;p=new t,d=g,f=!1;let b=async()=>{if(await i.waitForIdle(),!v(y,g))return;let t=e({bus:c.events,source:a,sessionId:g});if(!v(y,g)){s(t);return}m=t,f=!0},x=h.then(b,b);return h=x.catch(()=>void 0),_(x)})}async function l(e){let t=new i,n,r=()=>(n??=t.fiber.dispose(),n);try{c(t,e),e.on(`session_shutdown`,r)}catch(e){throw await r(),e}}export{l as default,l as userFeedbackExtension,c as installUserFeedbackRuntime};
+import{QuestionnaireCoordinator as e}from"../../services/questionnaireCoordinator.mjs";import{createVoiceQuestionHandoff as t}from"../doom/voiceQuestionHandoff.mjs";import{registerAskUserQuestionTool as n}from"./askUserQuestionAdapter.mjs";import{registerAskUserQuestionReconciler as r}from"./reconcileAdapter.mjs";import{connectDoomCordisHost as i}from"@agimon-ai/doompi-extension-contracts/cordis-host";import{DOOM_MINOR_MODE_CATALOG_SERVICE as a,requireMinorModeCatalog as o}from"@agimon-ai/doompi-extension-contracts/mode";import{DOOM_NARRATION_SERVICE as s,requireDoomNarrationService as c}from"@agimon-ai/doompi-extension-contracts/narration";const l=`@agimon-ai/doompi-user-feedback`;function u(){return{answers:[],cancelled:!0}}function d(i,d){let f=!0,p=0,m,h=!1,g=new e,_,v=Promise.resolve(),y=new Set,b=e=>(y.add(e),e.then(()=>y.delete(e),()=>y.delete(e)),e),x=(e,t)=>f&&e===p&&t===m,S=(e,t)=>f&&h&&t?.aborted!==!0&&e.sessionManager.getSessionId()===m,C=async()=>{if(!f)return;let e=g;e.shutdown(),f=!1,p+=1,h=!1,m=void 0,await Promise.allSettled(y),await e.waitForIdle()};i.effect(()=>C,`${l}/runtime`),i.inject([a,s],e=>{let n=t(o(e),c(e));return _=n,()=>{_===n&&(_=void 0)}}),n(d,i,{enqueue:(e,t)=>{let n=g,r=p,i=m;return!h||!x(r,i)||t?.aborted?Promise.resolve(u()):n.enqueue(async t=>{if(!h||!x(r,i)||t.signal.aborted)return u();let n=await e({...t,reportProgress:e=>{x(r,i)&&!t.signal.aborted&&t.reportProgress(e)}});return h&&x(r,i)&&!t.signal.aborted?n:u()},t)},isActive:S,runTui:async(e,t,n,r,i)=>{if(!S(e,r))return;let{runTuiQuestionnaire:a}=await import(`../../tui/runQuestionnaire.mjs`);if(!S(e,r))return;let o=await a(e,t,n,r,i);return S(e,r)?o:void 0},tryVoice:e=>f&&h?_?.handoff(e):void 0}),r(d,S),d.on(`session_start`,(t,n)=>{if(!f)return;let r=g;r.shutdown();let i=n.sessionManager.getSessionId(),a=++p;g=new e,m=i,h=!1;let o=async()=>{await r.waitForIdle(),x(a,i)&&(h=!0)},s=v.then(o,o);return v=s.catch(()=>void 0),b(s)})}async function f(e){let t=await i(e,l),n=t.root.plugin(p,{pi:e});try{await n}catch(e){try{await n.dispose()}finally{await t.dispose()}throw e}let r;e.on(`session_shutdown`,()=>r??=(async()=>{try{await n.dispose()}finally{await t.dispose()}})())}function p(e,t){d(e,t.pi)}export{f as default,f as userFeedbackExtension,d as installUserFeedbackRuntime};
 //# sourceMappingURL=extension.mjs.map

package/dist/adapters/pi/extension.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport { QuestionnaireCoordinator, type QuestionnaireRunner } from '../../services/questionnaireCoordinator.js';\nimport type { QuestionnaireResult } from '../../types/questionnaire.js';\nimport { createVoiceQuestionHandoff, type VoiceQuestionHandoffHandle } from '../doom/voiceQuestionHandoff.js';\nimport { registerAskUserQuestionTool } from './askUserQuestionAdapter.js';\nimport { registerAskUserQuestionReconciler } from './reconcileAdapter.js';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-user-feedback';\nconst SESSION_START_EVENT = 'session_start';\nconst SESSION_SHUTDOWN_EVENT = 'session_shutdown';\n\nfunction cancelledResult(): QuestionnaireResult {\n  return { answers: [], cancelled: true };\n}\n\nfunction disposeVoiceHandoff(handle: VoiceQuestionHandoffHandle | undefined): void {\n  if (!handle) return;\n  try {\n    handle.dispose();\n  } catch (error) {\n    process.emitWarning(`Could not dispose the user-feedback voice handoff: ${String(error)}`);\n  }\n}\n\n/** Install one user-feedback runtime into a package-local Cordis root. */\nexport function installUserFeedbackRuntime(cordis: Context, pi: ExtensionAPI): void {\n  let active = true;\n  let sessionGeneration = 0;\n  let sessionId: string | undefined;\n  let sessionReady = false;\n  let coordinator = new QuestionnaireCoordinator();\n  let voiceHandoff: VoiceQuestionHandoffHandle | undefined;\n  let lifecycleQueue: Promise<void> = Promise.resolve();\n  const pendingOperations = new Set<Promise<unknown>>();\n\n  const trackOperation = <T>(operation: Promise<T>): Promise<T> => {\n    pendingOperations.add(operation);\n    void operation.then(\n      () => pendingOperations.delete(operation),\n      () => pendingOperations.delete(operation),\n    );\n    return operation;\n  };\n  const ownsGeneration = (generation: number, expectedSessionId: string | undefined): boolean =>\n    active && generation === sessionGeneration && expectedSessionId === sessionId;\n  const isContextActive = (context: ExtensionContext, signal?: AbortSignal): boolean =>\n    active && sessionReady && signal?.aborted !== true && context.sessionManager.getSessionId() === sessionId;\n\n  const shutdownRuntime = async (): Promise<void> => {\n    if (!active) return;\n    const ownedCoordinator = coordinator;\n    ownedCoordinator.shutdown();\n    const ownedHandoff = voiceHandoff;\n    voiceHandoff = undefined;\n    disposeVoiceHandoff(ownedHandoff);\n    active = false;\n    sessionGeneration += 1;\n    sessionReady = false;\n    sessionId = undefined;\n    await Promise.allSettled(pendingOperations);\n    await ownedCoordinator.waitForIdle();\n  };\n  cordis.effect(() => shutdownRuntime, `${PACKAGE_SOURCE}/runtime`);\n\n  registerAskUserQuestionTool(pi, {\n    enqueue: (runner: QuestionnaireRunner, signal?: AbortSignal) => {\n      const ownedCoordinator = coordinator;\n      const generation = sessionGeneration;\n      const expectedSessionId = sessionId;\n      if (!sessionReady || !ownsGeneration(generation, expectedSessionId) || signal?.aborted) {\n        return Promise.resolve(cancelledResult());\n      }\n      return ownedCoordinator.enqueue(async (context) => {\n        if (!sessionReady || !ownsGeneration(generation, expectedSessionId) || context.signal.aborted) {\n          return cancelledResult();\n        }\n        const result = await runner({\n          ...context,\n          reportProgress: (progress) => {\n            if (ownsGeneration(generation, expectedSessionId) && !context.signal.aborted) {\n              context.reportProgress(progress);\n            }\n          },\n        });\n        return sessionReady && ownsGeneration(generation, expectedSessionId) && !context.signal.aborted\n          ? result\n          : cancelledResult();\n      }, signal);\n    },\n    isActive: isContextActive,\n    runTui: async (context, params, collapseKey, signal, reportProgress) => {\n      if (!isContextActive(context, signal)) return undefined;\n      const { runTuiQuestionnaire } = await import('../../tui/runQuestionnaire.js');\n      if (!isContextActive(context, signal)) return undefined;\n      const result = await runTuiQuestionnaire(context, params, collapseKey, signal, reportProgress);\n      return isContextActive(context, signal) ? result : undefined;\n    },\n    tryVoice: (params) => (active && sessionReady ? voiceHandoff?.handoff(params) : undefined),\n  });\n  registerAskUserQuestionReconciler(pi, isContextActive);\n\n  pi.on(SESSION_START_EVENT, (_event, context) => {\n    if (!active) return;\n    const previousCoordinator = coordinator;\n    previousCoordinator.shutdown();\n    const previousHandoff = voiceHandoff;\n    voiceHandoff = undefined;\n    disposeVoiceHandoff(previousHandoff);\n\n    const activeSessionId = context.sessionManager.getSessionId();\n    const generation = ++sessionGeneration;\n    const nextCoordinator = new QuestionnaireCoordinator();\n    coordinator = nextCoordinator;\n    sessionId = activeSessionId;\n    sessionReady = false;\n\n    const initializeSession = async (): Promise<void> => {\n      await previousCoordinator.waitForIdle();\n      if (!ownsGeneration(generation, activeSessionId)) return;\n      const nextHandoff = createVoiceQuestionHandoff({\n        bus: pi.events,\n        source: PACKAGE_SOURCE,\n        sessionId: activeSessionId,\n      });\n      if (!ownsGeneration(generation, activeSessionId)) {\n        disposeVoiceHandoff(nextHandoff);\n        return;\n      }\n      voiceHandoff = nextHandoff;\n      sessionReady = true;\n    };\n\n    const operation = lifecycleQueue.then(initializeSession, initializeSession);\n    lifecycleQueue = operation.catch(() => undefined);\n    return trackOperation(operation);\n  });\n}\n\n/** The package's sole Pi factory; Pi reloads it and Cordis owns all package resources. */\nexport async function userFeedbackExtension(pi: ExtensionAPI): Promise<void> {\n  const cordis = new Context();\n  let disposal: Promise<void> | undefined;\n  const dispose = (): Promise<void> => {\n    disposal ??= cordis.fiber.dispose();\n    return disposal;\n  };\n\n  try {\n    installUserFeedbackRuntime(cordis, pi);\n    pi.on(SESSION_SHUTDOWN_EVENT, dispose);\n  } catch (error) {\n    await dispose();\n    throw error;\n  }\n}\n\nexport default userFeedbackExtension;\n"],"mappings":"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"}
+{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_MINOR_MODE_CATALOG_SERVICE, requireMinorModeCatalog } from '@agimon-ai/doompi-extension-contracts/mode';\nimport { DOOM_NARRATION_SERVICE, requireDoomNarrationService } from '@agimon-ai/doompi-extension-contracts/narration';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport { QuestionnaireCoordinator, type QuestionnaireRunner } from '../../services/questionnaireCoordinator.js';\nimport type { QuestionnaireResult } from '../../types/questionnaire.js';\nimport { createVoiceQuestionHandoff, type VoiceQuestionHandoff } from '../doom/voiceQuestionHandoff.js';\nimport { registerAskUserQuestionTool } from './askUserQuestionAdapter.js';\nimport { registerAskUserQuestionReconciler } from './reconcileAdapter.js';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-user-feedback';\nconst SESSION_START_EVENT = 'session_start';\n\nfunction cancelledResult(): QuestionnaireResult {\n  return { answers: [], cancelled: true };\n}\n\n/** Install one user-feedback runtime into its host-owned Cordis plugin fiber. */\nexport function installUserFeedbackRuntime(cordis: Context, pi: ExtensionAPI): void {\n  let active = true;\n  let sessionGeneration = 0;\n  let sessionId: string | undefined;\n  let sessionReady = false;\n  let coordinator = new QuestionnaireCoordinator();\n  let voiceHandoff: VoiceQuestionHandoff | undefined;\n  let lifecycleQueue: Promise<void> = Promise.resolve();\n  const pendingOperations = new Set<Promise<unknown>>();\n\n  const trackOperation = <T>(operation: Promise<T>): Promise<T> => {\n    pendingOperations.add(operation);\n    void operation.then(\n      () => pendingOperations.delete(operation),\n      () => pendingOperations.delete(operation),\n    );\n    return operation;\n  };\n  const ownsGeneration = (generation: number, expectedSessionId: string | undefined): boolean =>\n    active && generation === sessionGeneration && expectedSessionId === sessionId;\n  const isContextActive = (context: ExtensionContext, signal?: AbortSignal): boolean =>\n    active && sessionReady && signal?.aborted !== true && context.sessionManager.getSessionId() === sessionId;\n\n  const shutdownRuntime = async (): Promise<void> => {\n    if (!active) return;\n    const ownedCoordinator = coordinator;\n    ownedCoordinator.shutdown();\n    active = false;\n    sessionGeneration += 1;\n    sessionReady = false;\n    sessionId = undefined;\n    await Promise.allSettled(pendingOperations);\n    await ownedCoordinator.waitForIdle();\n  };\n  cordis.effect(() => shutdownRuntime, `${PACKAGE_SOURCE}/runtime`);\n\n  cordis.inject([DOOM_MINOR_MODE_CATALOG_SERVICE, DOOM_NARRATION_SERVICE], (serviceContext) => {\n    const handoff = createVoiceQuestionHandoff(\n      requireMinorModeCatalog(serviceContext),\n      requireDoomNarrationService(serviceContext),\n    );\n    voiceHandoff = handoff;\n    return () => {\n      if (voiceHandoff === handoff) voiceHandoff = undefined;\n    };\n  });\n\n  registerAskUserQuestionTool(pi, cordis, {\n    enqueue: (runner: QuestionnaireRunner, signal?: AbortSignal) => {\n      const ownedCoordinator = coordinator;\n      const generation = sessionGeneration;\n      const expectedSessionId = sessionId;\n      if (!sessionReady || !ownsGeneration(generation, expectedSessionId) || signal?.aborted) {\n        return Promise.resolve(cancelledResult());\n      }\n      return ownedCoordinator.enqueue(async (context) => {\n        if (!sessionReady || !ownsGeneration(generation, expectedSessionId) || context.signal.aborted) {\n          return cancelledResult();\n        }\n        const result = await runner({\n          ...context,\n          reportProgress: (progress) => {\n            if (ownsGeneration(generation, expectedSessionId) && !context.signal.aborted) {\n              context.reportProgress(progress);\n            }\n          },\n        });\n        return sessionReady && ownsGeneration(generation, expectedSessionId) && !context.signal.aborted\n          ? result\n          : cancelledResult();\n      }, signal);\n    },\n    isActive: isContextActive,\n    runTui: async (context, params, collapseKey, signal, reportProgress) => {\n      if (!isContextActive(context, signal)) return undefined;\n      const { runTuiQuestionnaire } = await import('../../tui/runQuestionnaire.js');\n      if (!isContextActive(context, signal)) return undefined;\n      const result = await runTuiQuestionnaire(context, params, collapseKey, signal, reportProgress);\n      return isContextActive(context, signal) ? result : undefined;\n    },\n    tryVoice: (params) => (active && sessionReady ? voiceHandoff?.handoff(params) : undefined),\n  });\n  registerAskUserQuestionReconciler(pi, isContextActive);\n\n  pi.on(SESSION_START_EVENT, (_event, context) => {\n    if (!active) return;\n    const previousCoordinator = coordinator;\n    previousCoordinator.shutdown();\n    const activeSessionId = context.sessionManager.getSessionId();\n    const generation = ++sessionGeneration;\n    const nextCoordinator = new QuestionnaireCoordinator();\n    coordinator = nextCoordinator;\n    sessionId = activeSessionId;\n    sessionReady = false;\n\n    const initializeSession = async (): Promise<void> => {\n      await previousCoordinator.waitForIdle();\n      if (!ownsGeneration(generation, activeSessionId)) return;\n      sessionReady = true;\n    };\n\n    const operation = lifecycleQueue.then(initializeSession, initializeSession);\n    lifecycleQueue = operation.catch(() => undefined);\n    return trackOperation(operation);\n  });\n}\n\n/** The package's sole Pi factory; Pi reloads it and Cordis owns all package resources. */\nexport async function userFeedbackExtension(pi: ExtensionAPI): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(userFeedbackPlugin, { pi });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface UserFeedbackPluginConfig {\n  readonly pi: ExtensionAPI;\n}\n\nfunction userFeedbackPlugin(cordis: Context, config: UserFeedbackPluginConfig): void {\n  installUserFeedbackRuntime(cordis, config.pi);\n}\n\nexport default userFeedbackExtension;\n"],"mappings":"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"}

package/dist/index.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require("./events.cjs");let e=require("@agimon-ai/doompi-extension-contracts");Object.defineProperty(exports,"ASK_USER_BLOCKED_EVENT",{enumerable:!0,get:function(){return e.ASK_USER_BLOCKED_EVENT}}),Object.defineProperty(exports,"ASK_USER_PROMPT_EVENT",{enumerable:!0,get:function(){return e.ASK_USER_PROMPT_EVENT}});

package/dist/index.d.cts

@@ -1,3 +1,3 @@
-import { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, AskUserBlockedEventPayload, AskUserPromptEventPayload, AskUserPromptOption, AskUserPromptQuestion } from "./schemas/events.cjs";
-import "./events.cjs";
-export { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, type AskUserBlockedEventPayload, type AskUserPromptEventPayload, type AskUserPromptOption, type AskUserPromptQuestion };
+import { QuestionParams } from "./schemas/questionnaire.cjs";
+import { QuestionnaireResult, ToolTextResult } from "./types/questionnaire.cjs";
+export type { QuestionParams, QuestionnaireResult, ToolTextResult };

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-import { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, AskUserBlockedEventPayload, AskUserPromptEventPayload, AskUserPromptOption, AskUserPromptQuestion } from "./schemas/events.mjs";
-import "./events.mjs";
-export { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, type AskUserBlockedEventPayload, type AskUserPromptEventPayload, type AskUserPromptOption, type AskUserPromptQuestion };
+import { QuestionParams } from "./schemas/questionnaire.mjs";
+import { QuestionnaireResult, ToolTextResult } from "./types/questionnaire.mjs";
+export type { QuestionParams, QuestionnaireResult, ToolTextResult };

package/dist/index.mjs

@@ -1 +1 @@
-import{ASK_USER_BLOCKED_EVENT as e,ASK_USER_PROMPT_EVENT as t}from"./schemas/events.mjs";import"./events.mjs";export{e as ASK_USER_BLOCKED_EVENT,t as ASK_USER_PROMPT_EVENT};
+export{};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/doompi-user-feedback",
-  "version": "0.0.1-alpha.13",
+  "version": "0.0.1-alpha.14",
   "description": "Structured user questions with interactive and autonomous Voice handoff for Pi agents.",
   "keywords": [
     "ai",
@@ -33,16 +33,6 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
-    "./events": {
-      "types": "./dist/events.d.mts",
-      "import": "./dist/events.mjs",
-      "require": "./dist/events.cjs"
-    },
-    "./voice-question-handoff": {
-      "types": "./dist/voiceQuestionHandoff.d.mts",
-      "import": "./dist/voiceQuestionHandoff.mjs",
-      "require": "./dist/voiceQuestionHandoff.cjs"
-    },
     "./extensions/pi": {
       "types": "./dist/extensions/pi.d.mts",
       "import": "./dist/extensions/pi.mjs",
@@ -56,8 +46,8 @@
   "dependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "typebox": "1.1.38",
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.24",
-    "@agimon-ai/doompi-ui": "0.0.1-alpha.24"
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.25",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.25"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2",

package/dist/adapters/doom/voiceQuestionHandoff.d.cts

@@ -1,32 +0,0 @@
-import { QuestionParams } from "../../schemas/questionnaire.cjs";
-import { QuestionnaireResult, ToolTextResult } from "../../types/questionnaire.cjs";
-import { MinorModeCatalogClient } from "@agimon-ai/doompi-extension-contracts/mode";
-import { NarrationRequester } from "@agimon-ai/doompi-extension-contracts/narration";
-import { ProtocolRuntimeOptions } from "@agimon-ai/doompi-extension-contracts/protocol";
-//#region src/adapters/doom/voiceQuestionHandoff.d.ts
-declare const DOOM_VOICE_SOURCE = "@agimon-ai/doompi-voice";
-declare const DOOM_VOICE_AUTO_MODE_ID = "voice-auto";
-declare const VOICE_WAIT_MESSAGE = "The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.";
-declare function formatVoiceQuestionPrompt(params: QuestionParams): string;
-declare class VoiceQuestionHandoff {
-  private readonly modes;
-  private readonly narration;
-  private readonly buildNarration;
-  constructor(modes: Pick<MinorModeCatalogClient, 'list'>, narration: NarrationRequester, buildNarration: (params: QuestionParams) => string);
-  handoff(params: QuestionParams): QuestionnaireResult | undefined;
-}
-interface VoiceQuestionHandoffHandle {
-  handoff(params: QuestionParams): QuestionnaireResult | undefined;
-  dispose(): void;
-}
-/**
- * Bind one session-scoped autonomous-voice handoff.
- *
- * The returned handle owns the external catalog subscription and must be
- * disposed when its session is replaced or shut down.
- */
-declare function createVoiceQuestionHandoff(options: ProtocolRuntimeOptions): VoiceQuestionHandoffHandle;
-declare function buildVoiceToolResult(details: QuestionnaireResult): ToolTextResult;
-//#endregion
-export { DOOM_VOICE_AUTO_MODE_ID, DOOM_VOICE_SOURCE, VOICE_WAIT_MESSAGE, VoiceQuestionHandoff, VoiceQuestionHandoffHandle, buildVoiceToolResult, createVoiceQuestionHandoff, formatVoiceQuestionPrompt };
-//# sourceMappingURL=voiceQuestionHandoff.d.cts.map

package/dist/adapters/doom/voiceQuestionHandoff.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"voiceQuestionHandoff.d.cts","names":[],"sources":["../../../src/adapters/doom/voiceQuestionHandoff.ts"],"mappings":";;;;;;cAWa;cACA;cACA;iBAWG,0BAA0B,QAAQ;cAWrC;mBAEQ;mBACA;mBACA;EAFA,YAAA,OAAO,KAAK,iCACZ,WAAW,oBACX,iBAAiB,QAAQ;EAG5C,QAAQ,QAAQ,iBAAiB;;UAalB;EACf,QAAQ,QAAQ,iBAAiB;EACjC;;;;;;;;iBASc,2BAA2B,SAAS,yBAAyB;iBAmB7D,qBAAqB,SAAS,sBAAsB"}

package/dist/adapters/doom/voiceQuestionHandoff.d.mts

@@ -1,32 +0,0 @@
-import { QuestionParams } from "../../schemas/questionnaire.mjs";
-import { QuestionnaireResult, ToolTextResult } from "../../types/questionnaire.mjs";
-import { MinorModeCatalogClient } from "@agimon-ai/doompi-extension-contracts/mode";
-import { NarrationRequester } from "@agimon-ai/doompi-extension-contracts/narration";
-import { ProtocolRuntimeOptions } from "@agimon-ai/doompi-extension-contracts/protocol";
-//#region src/adapters/doom/voiceQuestionHandoff.d.ts
-declare const DOOM_VOICE_SOURCE = "@agimon-ai/doompi-voice";
-declare const DOOM_VOICE_AUTO_MODE_ID = "voice-auto";
-declare const VOICE_WAIT_MESSAGE = "The questions were spoken through autonomous voice. Stop now and wait for the user's next message; it will arrive as an ordinary user message.";
-declare function formatVoiceQuestionPrompt(params: QuestionParams): string;
-declare class VoiceQuestionHandoff {
-  private readonly modes;
-  private readonly narration;
-  private readonly buildNarration;
-  constructor(modes: Pick<MinorModeCatalogClient, 'list'>, narration: NarrationRequester, buildNarration: (params: QuestionParams) => string);
-  handoff(params: QuestionParams): QuestionnaireResult | undefined;
-}
-interface VoiceQuestionHandoffHandle {
-  handoff(params: QuestionParams): QuestionnaireResult | undefined;
-  dispose(): void;
-}
-/**
- * Bind one session-scoped autonomous-voice handoff.
- *
- * The returned handle owns the external catalog subscription and must be
- * disposed when its session is replaced or shut down.
- */
-declare function createVoiceQuestionHandoff(options: ProtocolRuntimeOptions): VoiceQuestionHandoffHandle;
-declare function buildVoiceToolResult(details: QuestionnaireResult): ToolTextResult;
-//#endregion
-export { DOOM_VOICE_AUTO_MODE_ID, DOOM_VOICE_SOURCE, VOICE_WAIT_MESSAGE, VoiceQuestionHandoff, VoiceQuestionHandoffHandle, buildVoiceToolResult, createVoiceQuestionHandoff, formatVoiceQuestionPrompt };
-//# sourceMappingURL=voiceQuestionHandoff.d.mts.map

package/dist/adapters/doom/voiceQuestionHandoff.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"voiceQuestionHandoff.d.mts","names":[],"sources":["../../../src/adapters/doom/voiceQuestionHandoff.ts"],"mappings":";;;;;;cAWa;cACA;cACA;iBAWG,0BAA0B,QAAQ;cAWrC;mBAEQ;mBACA;mBACA;EAFA,YAAA,OAAO,KAAK,iCACZ,WAAW,oBACX,iBAAiB,QAAQ;EAG5C,QAAQ,QAAQ,iBAAiB;;UAalB;EACf,QAAQ,QAAQ,iBAAiB;EACjC;;;;;;;;iBASc,2BAA2B,SAAS,yBAAyB;iBAmB7D,qBAAqB,SAAS,sBAAsB"}

package/dist/events.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require("./schemas/events.cjs");let e=require("@agimon-ai/doompi-extension-contracts");Object.defineProperty(exports,"ASK_USER_BLOCKED_EVENT",{enumerable:!0,get:function(){return e.ASK_USER_BLOCKED_EVENT}}),Object.defineProperty(exports,"ASK_USER_PROMPT_EVENT",{enumerable:!0,get:function(){return e.ASK_USER_PROMPT_EVENT}});

package/dist/events.d.cts

@@ -1,2 +0,0 @@
-import { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, AskUserBlockedEventPayload, AskUserPromptEventPayload, AskUserPromptOption, AskUserPromptQuestion } from "./schemas/events.cjs";
-export { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, type AskUserBlockedEventPayload, type AskUserPromptEventPayload, type AskUserPromptOption, type AskUserPromptQuestion };

package/dist/events.d.mts

@@ -1,2 +0,0 @@
-import { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, AskUserBlockedEventPayload, AskUserPromptEventPayload, AskUserPromptOption, AskUserPromptQuestion } from "./schemas/events.mjs";
-export { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, type AskUserBlockedEventPayload, type AskUserPromptEventPayload, type AskUserPromptOption, type AskUserPromptQuestion };

package/dist/events.mjs

@@ -1 +0,0 @@
-import{ASK_USER_BLOCKED_EVENT as e,ASK_USER_PROMPT_EVENT as t}from"./schemas/events.mjs";export{e as ASK_USER_BLOCKED_EVENT,t as ASK_USER_PROMPT_EVENT};

package/dist/schemas/events.cjs

@@ -1 +0,0 @@
-require("@agimon-ai/doompi-extension-contracts");

package/dist/schemas/events.d.cts

@@ -1,22 +0,0 @@
-import { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT } from "@agimon-ai/doompi-extension-contracts";
-//#region src/schemas/events.d.ts
-interface AskUserPromptOption {
-  label: string;
-  description: string;
-  hasPreview: boolean;
-}
-interface AskUserPromptQuestion {
-  question: string;
-  header: string;
-  multiSelect: boolean;
-  options: AskUserPromptOption[];
-}
-interface AskUserPromptEventPayload {
-  questions: AskUserPromptQuestion[];
-}
-interface AskUserBlockedEventPayload {
-  active: boolean;
-}
-//#endregion
-export { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, AskUserBlockedEventPayload, AskUserPromptEventPayload, AskUserPromptOption, AskUserPromptQuestion };
-//# sourceMappingURL=events.d.cts.map

package/dist/schemas/events.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"events.d.cts","names":[],"sources":["../../src/schemas/events.ts"],"mappings":";;UAEiB;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA,SAAS;;UAGM;EACf,WAAW;;UAGI;EACf"}

package/dist/schemas/events.d.mts

@@ -1,22 +0,0 @@
-import { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT } from "@agimon-ai/doompi-extension-contracts";
-//#region src/schemas/events.d.ts
-interface AskUserPromptOption {
-  label: string;
-  description: string;
-  hasPreview: boolean;
-}
-interface AskUserPromptQuestion {
-  question: string;
-  header: string;
-  multiSelect: boolean;
-  options: AskUserPromptOption[];
-}
-interface AskUserPromptEventPayload {
-  questions: AskUserPromptQuestion[];
-}
-interface AskUserBlockedEventPayload {
-  active: boolean;
-}
-//#endregion
-export { ASK_USER_BLOCKED_EVENT, ASK_USER_PROMPT_EVENT, AskUserBlockedEventPayload, AskUserPromptEventPayload, AskUserPromptOption, AskUserPromptQuestion };
-//# sourceMappingURL=events.d.mts.map

package/dist/schemas/events.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"events.d.mts","names":[],"sources":["../../src/schemas/events.ts"],"mappings":";;UAEiB;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA,SAAS;;UAGM;EACf,WAAW;;UAGI;EACf"}

package/dist/schemas/events.mjs

@@ -1 +0,0 @@
-import{ASK_USER_BLOCKED_EVENT as e,ASK_USER_PROMPT_EVENT as t}from"@agimon-ai/doompi-extension-contracts";export{e as ASK_USER_BLOCKED_EVENT,t as ASK_USER_PROMPT_EVENT};

package/dist/voiceQuestionHandoff.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./adapters/doom/voiceQuestionHandoff.cjs");exports.DOOM_VOICE_AUTO_MODE_ID=e.DOOM_VOICE_AUTO_MODE_ID,exports.DOOM_VOICE_SOURCE=e.DOOM_VOICE_SOURCE,exports.VOICE_WAIT_MESSAGE=e.VOICE_WAIT_MESSAGE,exports.VoiceQuestionHandoff=e.VoiceQuestionHandoff,exports.buildVoiceToolResult=e.buildVoiceToolResult,exports.createVoiceQuestionHandoff=e.createVoiceQuestionHandoff,exports.formatVoiceQuestionPrompt=e.formatVoiceQuestionPrompt;

package/dist/voiceQuestionHandoff.d.cts

@@ -1,4 +0,0 @@
-import { QuestionParams } from "./schemas/questionnaire.cjs";
-import { QuestionnaireResult, ToolTextResult } from "./types/questionnaire.cjs";
-import { DOOM_VOICE_AUTO_MODE_ID, DOOM_VOICE_SOURCE, VOICE_WAIT_MESSAGE, VoiceQuestionHandoff, VoiceQuestionHandoffHandle, buildVoiceToolResult, createVoiceQuestionHandoff, formatVoiceQuestionPrompt } from "./adapters/doom/voiceQuestionHandoff.cjs";
-export { DOOM_VOICE_AUTO_MODE_ID, DOOM_VOICE_SOURCE, type QuestionParams, type QuestionnaireResult, type ToolTextResult, VOICE_WAIT_MESSAGE, VoiceQuestionHandoff, type VoiceQuestionHandoffHandle, buildVoiceToolResult, createVoiceQuestionHandoff, formatVoiceQuestionPrompt };

package/dist/voiceQuestionHandoff.d.mts

@@ -1,4 +0,0 @@
-import { QuestionParams } from "./schemas/questionnaire.mjs";
-import { QuestionnaireResult, ToolTextResult } from "./types/questionnaire.mjs";
-import { DOOM_VOICE_AUTO_MODE_ID, DOOM_VOICE_SOURCE, VOICE_WAIT_MESSAGE, VoiceQuestionHandoff, VoiceQuestionHandoffHandle, buildVoiceToolResult, createVoiceQuestionHandoff, formatVoiceQuestionPrompt } from "./adapters/doom/voiceQuestionHandoff.mjs";
-export { DOOM_VOICE_AUTO_MODE_ID, DOOM_VOICE_SOURCE, type QuestionParams, type QuestionnaireResult, type ToolTextResult, VOICE_WAIT_MESSAGE, VoiceQuestionHandoff, type VoiceQuestionHandoffHandle, buildVoiceToolResult, createVoiceQuestionHandoff, formatVoiceQuestionPrompt };

package/dist/voiceQuestionHandoff.mjs

@@ -1 +0,0 @@
-import{DOOM_VOICE_AUTO_MODE_ID as e,DOOM_VOICE_SOURCE as t,VOICE_WAIT_MESSAGE as n,VoiceQuestionHandoff as r,buildVoiceToolResult as i,createVoiceQuestionHandoff as a,formatVoiceQuestionPrompt as o}from"./adapters/doom/voiceQuestionHandoff.mjs";export{e as DOOM_VOICE_AUTO_MODE_ID,t as DOOM_VOICE_SOURCE,n as VOICE_WAIT_MESSAGE,r as VoiceQuestionHandoff,i as buildVoiceToolResult,a as createVoiceQuestionHandoff,o as formatVoiceQuestionPrompt};