@agimon-ai/doompi-help 0.0.1-alpha.6 → 0.0.1-alpha.7

package/README.md

@@ -15,17 +15,18 @@ Help keeps extension documentation out of the default model context. Packages co
 
 ## Install
 
-DoomPi includes Help as a core parent capability. To load the package directly in Pi:
+DoomPi includes Help in every parent and detached-child composition. No layer declaration is
+required. To load the package directly in Pi:
 
 ```bash
 pi install npm:@agimon-ai/doompi-help
 ```
 
-The Pi entrypoint is `@agimon-ai/doompi-help/extensions/doom`.
+The sole Pi entrypoint is `@agimon-ai/doompi-help/extensions/pi`; DoomPi and vanilla Pi execute the same factory.
 
 ## Activate and deactivate
 
-In an interactive DoomPi session, use `SPC h e`. Headless clients use the existing `minor_mode` protocol action.
+In an interactive DoomPi session, use `SPC h e`. Headless DoomPi clients use the existing `minor_mode` protocol action. In vanilla Pi, run `/doom-help`; the command does not require Doom config or Leader Space.
 
 Activation resolves each contributor in this order:
 
@@ -39,12 +40,12 @@ The package contributes `doompi-help`. Other packages, including Workflow and Co
 
 ## Parent and child behavior
 
-The DoomPi distribution assembles the Help host only in parent sessions and starts it inactive. Child sessions do not assemble the Help runtime. A custom plain-Pi host can load the extension directly, but must supply the lifecycle expected by its integration.
+Parent and child sessions receive the same distribution-default factory. Each factory call owns a fresh package-local Cordis root, recreates session state on `session_start`, and disposes its resources during `session_shutdown`.
 
 ## Public API
 
 ```ts
-import { activateHelpExtension, registerHelpExtension } from '@agimon-ai/doompi-help';
+import { helpExtension, installHelpRuntime } from '@agimon-ai/doompi-help';
 ```
 
 The root export is intended for hosts and tests; ordinary users activate Help through the extension and mode protocol.

package/dist/adapters/pi/extension.cjs

@@ -0,0 +1,2 @@
+const e=require("./helpCommand.cjs"),t=require("./helpMode.cjs"),n=require("../../container/helpHost.cjs");let r=require("@deepseek-ai/cordis");function i(r,i,a={}){r.effect(()=>{let r=n.activateHelpHost(i,a),o;try{o=t.registerHelpModeIntegration(i,r.activation),e.registerHelpCommand(i,r.activation)}catch(e){throw o?.dispose(),r.dispose(),e}return()=>{o.dispose(),r.dispose()}},`@agimon-ai/doompi-help`)}async function a(e){let t=new r.Context,n,a=()=>(n??=t.fiber.dispose(),n);try{i(t,e)}catch(e){throw await a(),e}e.on(`session_shutdown`,a)}exports.default=a,exports.helpExtension=a,exports.installHelpRuntime=i;
+//# sourceMappingURL=extension.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.cjs","names":["activateHelpHost","registerHelpModeIntegration","Context"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { registerHelpCommand } from '../../adapters/pi/helpCommand.ts';\nimport { registerHelpModeIntegration } from '../../adapters/pi/helpMode.ts';\nimport { activateHelpHost } from '../../container/helpHost.ts';\nimport type { HelpRuntimeOptions } from '../../container/index.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-help';\nconst SESSION_SHUTDOWN_EVENT = 'session_shutdown';\n\n/** Install Help resources into one package-local Cordis root. */\nexport function installHelpRuntime(cordis: Context, pi: ExtensionAPI, options: HelpRuntimeOptions = {}): void {\n  cordis.effect(() => {\n    const runtime = activateHelpHost(pi, options);\n    let mode: ReturnType<typeof registerHelpModeIntegration> | undefined;\n    try {\n      mode = registerHelpModeIntegration(pi, runtime.activation);\n      registerHelpCommand(pi, runtime.activation);\n    } catch (error) {\n      mode?.dispose();\n      runtime.dispose();\n      throw error;\n    }\n    return () => {\n      mode.dispose();\n      runtime.dispose();\n    };\n  }, PACKAGE_SOURCE);\n}\n\n/** The package's single standard Pi factory, including optional typed Doom integrations. */\nexport async function helpExtension(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    installHelpRuntime(cordis, pi);\n  } catch (error) {\n    await dispose();\n    throw error;\n  }\n\n  pi.on(SESSION_SHUTDOWN_EVENT, dispose);\n}\n\nexport default helpExtension;\n"],"mappings":"gJAWA,SAAgB,EAAmB,EAAiB,EAAkB,EAA8B,CAAC,EAAS,CAC5G,EAAO,WAAa,CAClB,IAAM,EAAUA,EAAAA,iBAAiB,EAAI,CAAO,EACxC,EACJ,GAAI,CACF,EAAOC,EAAAA,4BAA4B,EAAI,EAAQ,UAAU,EACzD,EAAA,oBAAoB,EAAI,EAAQ,UAAU,CAC5C,OAAS,EAAO,CAGd,MAFA,GAAM,QAAQ,EACd,EAAQ,QAAQ,EACV,CACR,CACA,UAAa,CACX,EAAK,QAAQ,EACb,EAAQ,QAAQ,CAClB,CACF,EAAG,wBAAc,CACnB,CAGA,eAAsB,EAAc,EAAiC,CACnE,IAAM,EAAS,IAAIC,EAAAA,QACf,EACE,OACJ,IAAa,EAAO,MAAM,QAAQ,EAC3B,GAGT,GAAI,CACF,EAAmB,EAAQ,CAAE,CAC/B,OAAS,EAAO,CAEd,MADA,MAAM,EAAQ,EACR,CACR,CAEA,EAAG,GAAG,mBAAwB,CAAO,CACvC"}

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

@@ -0,0 +1,11 @@
+import { HelpRuntimeOptions } from "../../container/index.cjs";
+import { Context } from "@deepseek-ai/cordis";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/adapters/pi/extension.d.ts
+/** Install Help resources into one package-local Cordis root. */
+declare function installHelpRuntime(cordis: Context, pi: ExtensionAPI, options?: HelpRuntimeOptions): void;
+/** The package's single standard Pi factory, including optional typed Doom integrations. */
+declare function helpExtension(pi: ExtensionAPI): Promise<void>;
+//#endregion
+export { helpExtension as default, helpExtension, installHelpRuntime };
+//# sourceMappingURL=extension.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;;iBAWgB,mBAAmB,QAAQ,SAAS,IAAI,cAAc,UAAS;;iBAoBzD,cAAc,IAAI,eAAe"}

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

@@ -0,0 +1,11 @@
+import { HelpRuntimeOptions } from "../../container/index.mjs";
+import { Context } from "@deepseek-ai/cordis";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/adapters/pi/extension.d.ts
+/** Install Help resources into one package-local Cordis root. */
+declare function installHelpRuntime(cordis: Context, pi: ExtensionAPI, options?: HelpRuntimeOptions): void;
+/** The package's single standard Pi factory, including optional typed Doom integrations. */
+declare function helpExtension(pi: ExtensionAPI): Promise<void>;
+//#endregion
+export { helpExtension as default, helpExtension, installHelpRuntime };
+//# sourceMappingURL=extension.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;;iBAWgB,mBAAmB,QAAQ,SAAS,IAAI,cAAc,UAAS;;iBAoBzD,cAAc,IAAI,eAAe"}

package/dist/adapters/pi/extension.mjs

@@ -0,0 +1,2 @@
+import{registerHelpCommand as e}from"./helpCommand.mjs";import{registerHelpModeIntegration as t}from"./helpMode.mjs";import{activateHelpHost as n}from"../../container/helpHost.mjs";import{Context as r}from"@deepseek-ai/cordis";function i(r,i,a={}){r.effect(()=>{let r=n(i,a),o;try{o=t(i,r.activation),e(i,r.activation)}catch(e){throw o?.dispose(),r.dispose(),e}return()=>{o.dispose(),r.dispose()}},`@agimon-ai/doompi-help`)}async function a(e){let t=new r,n,a=()=>(n??=t.fiber.dispose(),n);try{i(t,e)}catch(e){throw await a(),e}e.on(`session_shutdown`,a)}export{a as default,a as helpExtension,i as installHelpRuntime};
+//# sourceMappingURL=extension.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { registerHelpCommand } from '../../adapters/pi/helpCommand.ts';\nimport { registerHelpModeIntegration } from '../../adapters/pi/helpMode.ts';\nimport { activateHelpHost } from '../../container/helpHost.ts';\nimport type { HelpRuntimeOptions } from '../../container/index.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-help';\nconst SESSION_SHUTDOWN_EVENT = 'session_shutdown';\n\n/** Install Help resources into one package-local Cordis root. */\nexport function installHelpRuntime(cordis: Context, pi: ExtensionAPI, options: HelpRuntimeOptions = {}): void {\n  cordis.effect(() => {\n    const runtime = activateHelpHost(pi, options);\n    let mode: ReturnType<typeof registerHelpModeIntegration> | undefined;\n    try {\n      mode = registerHelpModeIntegration(pi, runtime.activation);\n      registerHelpCommand(pi, runtime.activation);\n    } catch (error) {\n      mode?.dispose();\n      runtime.dispose();\n      throw error;\n    }\n    return () => {\n      mode.dispose();\n      runtime.dispose();\n    };\n  }, PACKAGE_SOURCE);\n}\n\n/** The package's single standard Pi factory, including optional typed Doom integrations. */\nexport async function helpExtension(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    installHelpRuntime(cordis, pi);\n  } catch (error) {\n    await dispose();\n    throw error;\n  }\n\n  pi.on(SESSION_SHUTDOWN_EVENT, dispose);\n}\n\nexport default helpExtension;\n"],"mappings":"mOAWA,SAAgB,EAAmB,EAAiB,EAAkB,EAA8B,CAAC,EAAS,CAC5G,EAAO,WAAa,CAClB,IAAM,EAAU,EAAiB,EAAI,CAAO,EACxC,EACJ,GAAI,CACF,EAAO,EAA4B,EAAI,EAAQ,UAAU,EACzD,EAAoB,EAAI,EAAQ,UAAU,CAC5C,OAAS,EAAO,CAGd,MAFA,GAAM,QAAQ,EACd,EAAQ,QAAQ,EACV,CACR,CACA,UAAa,CACX,EAAK,QAAQ,EACb,EAAQ,QAAQ,CAClB,CACF,EAAG,wBAAc,CACnB,CAGA,eAAsB,EAAc,EAAiC,CACnE,IAAM,EAAS,IAAI,EACf,EACE,OACJ,IAAa,EAAO,MAAM,QAAQ,EAC3B,GAGT,GAAI,CACF,EAAmB,EAAQ,CAAE,CAC/B,OAAS,EAAO,CAEd,MADA,MAAM,EAAQ,EACR,CACR,CAEA,EAAG,GAAG,mBAAwB,CAAO,CACvC"}

package/dist/adapters/pi/helpCommand.cjs

@@ -0,0 +1,2 @@
+const e=`doom-help`,t=`Toggle package Help guidance`;function n(n,r){n.registerCommand(e,{description:t,handler:async(e,t)=>{let n=r.getState().activation===`inactive`?await r.activate():r.deactivate();if(!t.hasUI)return;let i=n.activation===`inactive`?`Package Help deactivated.`:`Package Help activated.`;t.ui.notify(i,n.activation===`degraded`?`warning`:`info`)}})}exports.HELP_COMMAND_DESCRIPTION=t,exports.HELP_COMMAND_NAME=e,exports.registerHelpCommand=n;
+//# sourceMappingURL=helpCommand.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpCommand.cjs","names":[],"sources":["../../../src/adapters/pi/helpCommand.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport type { HelpActivationService } from '../../types/help.ts';\n\nexport const HELP_COMMAND_NAME = 'doom-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle package Help guidance';\n\nexport function registerHelpCommand(\n  pi: Pick<ExtensionAPI, 'registerCommand'>,\n  activation: HelpActivationService,\n): void {\n  pi.registerCommand(HELP_COMMAND_NAME, {\n    description: HELP_COMMAND_DESCRIPTION,\n    handler: async (_arguments, context) => {\n      const current = activation.getState();\n      const next = current.activation === 'inactive' ? await activation.activate() : activation.deactivate();\n      if (!context.hasUI) return;\n      const message = next.activation === 'inactive' ? 'Package Help deactivated.' : 'Package Help activated.';\n      context.ui.notify(message, next.activation === 'degraded' ? 'warning' : 'info');\n    },\n  });\n}\n"],"mappings":"AAGA,MAAa,EAAoB,YACpB,EAA2B,+BAExC,SAAgB,EACd,EACA,EACM,CACN,EAAG,gBAAgB,EAAmB,CACpC,YAAa,EACb,QAAS,MAAO,EAAY,IAAY,CAEtC,IAAM,EADU,EAAW,SACR,CAAC,CAAC,aAAe,WAAa,MAAM,EAAW,SAAS,EAAI,EAAW,WAAW,EACrG,GAAI,CAAC,EAAQ,MAAO,OACpB,IAAM,EAAU,EAAK,aAAe,WAAa,4BAA8B,0BAC/E,EAAQ,GAAG,OAAO,EAAS,EAAK,aAAe,WAAa,UAAY,MAAM,CAChF,CACF,CAAC,CACH"}

package/dist/adapters/pi/helpCommand.mjs

@@ -0,0 +1,2 @@
+const e=`doom-help`,t=`Toggle package Help guidance`;function n(n,r){n.registerCommand(e,{description:t,handler:async(e,t)=>{let n=r.getState().activation===`inactive`?await r.activate():r.deactivate();if(!t.hasUI)return;let i=n.activation===`inactive`?`Package Help deactivated.`:`Package Help activated.`;t.ui.notify(i,n.activation===`degraded`?`warning`:`info`)}})}export{t as HELP_COMMAND_DESCRIPTION,e as HELP_COMMAND_NAME,n as registerHelpCommand};
+//# sourceMappingURL=helpCommand.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpCommand.mjs","names":[],"sources":["../../../src/adapters/pi/helpCommand.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport type { HelpActivationService } from '../../types/help.ts';\n\nexport const HELP_COMMAND_NAME = 'doom-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle package Help guidance';\n\nexport function registerHelpCommand(\n  pi: Pick<ExtensionAPI, 'registerCommand'>,\n  activation: HelpActivationService,\n): void {\n  pi.registerCommand(HELP_COMMAND_NAME, {\n    description: HELP_COMMAND_DESCRIPTION,\n    handler: async (_arguments, context) => {\n      const current = activation.getState();\n      const next = current.activation === 'inactive' ? await activation.activate() : activation.deactivate();\n      if (!context.hasUI) return;\n      const message = next.activation === 'inactive' ? 'Package Help deactivated.' : 'Package Help activated.';\n      context.ui.notify(message, next.activation === 'degraded' ? 'warning' : 'info');\n    },\n  });\n}\n"],"mappings":"AAGA,MAAa,EAAoB,YACpB,EAA2B,+BAExC,SAAgB,EACd,EACA,EACM,CACN,EAAG,gBAAgB,EAAmB,CACpC,YAAa,EACb,QAAS,MAAO,EAAY,IAAY,CAEtC,IAAM,EADU,EAAW,SACR,CAAC,CAAC,aAAe,WAAa,MAAM,EAAW,SAAS,EAAI,EAAW,WAAW,EACrG,GAAI,CAAC,EAAQ,MAAO,OACpB,IAAM,EAAU,EAAK,aAAe,WAAa,4BAA8B,0BAC/E,EAAQ,GAAG,OAAO,EAAS,EAAK,aAAe,WAAa,UAAY,MAAM,CAChF,CACF,CAAC,CACH"}

package/dist/container/helpHost.cjs

@@ -0,0 +1,2 @@
+const e=require("./index.cjs");let t=require("@agimon-ai/doompi-extension-contracts/help");function n(n,r={}){let i=n,a=(0,t.provideDoomHelpHost)(i),o=e.createHelpRuntime(a,r),s=(0,t.registerDoomHelpContribution)(i,{source:`@agimon-ai/doompi-help`,moduleUrl:require("url").pathToFileURL(__filename).href,skills:[{name:`doompi-help`,description:`Use Doom Pi package Help safely, including activation, exact-version retrieval, and diagnostics.`}]}),c=!1;return n.on(`session_start`,()=>{c||o.activation.deactivate()}),{activation:o.activation,dispose(){c||(c=!0,s.dispose(),o.dispose(),a.dispose())}}}exports.activateHelpHost=n;
+//# sourceMappingURL=helpHost.cjs.map

package/dist/container/helpHost.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpHost.cjs","names":["provideDoomHelpHost","createHelpRuntime","registerDoomHelpContribution"],"sources":["../../src/container/helpHost.ts"],"sourcesContent":["import type { DoomExtensionHost } from '@agimon-ai/doompi-extension-contracts/config';\nimport { provideDoomHelpHost, registerDoomHelpContribution } from '@agimon-ai/doompi-extension-contracts/help';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { createHelpRuntime, type HelpRuntimeOptions } from './index.ts';\nimport type { HelpActivationService } from '../types/help.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-help';\n\nexport interface HelpHostRuntime {\n  activation: HelpActivationService;\n  dispose(): void;\n}\n\nexport function activateHelpHost(pi: ExtensionAPI, options: HelpRuntimeOptions = {}): HelpHostRuntime {\n  const protocolHost = pi as unknown as DoomExtensionHost;\n  const host = provideDoomHelpHost(protocolHost);\n  const runtime = createHelpRuntime(host, options);\n  const selfContribution = registerDoomHelpContribution(protocolHost, {\n    source: PACKAGE_SOURCE,\n    moduleUrl: import.meta.url,\n    skills: [\n      {\n        name: 'doompi-help',\n        description: 'Use Doom Pi package Help safely, including activation, exact-version retrieval, and diagnostics.',\n      },\n    ],\n  });\n  let disposed = false;\n  pi.on('session_start', () => {\n    if (disposed) return;\n    runtime.activation.deactivate();\n  });\n  return {\n    activation: runtime.activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      selfContribution.dispose();\n      runtime.dispose();\n      host.dispose();\n    },\n  };\n}\n"],"mappings":"2FAaA,SAAgB,EAAiB,EAAkB,EAA8B,CAAC,EAAoB,CACpG,IAAM,EAAe,EACf,GAAA,EAAOA,EAAAA,oBAAAA,CAAoB,CAAY,EACvC,EAAUC,EAAAA,kBAAkB,EAAM,CAAO,EACzC,GAAA,EAAmBC,EAAAA,6BAAAA,CAA6B,EAAc,CAClE,OAAQ,yBACR,UAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,KACA,OAAQ,CACN,CACE,KAAM,cACN,YAAa,kGACf,CACF,CACF,CAAC,EACG,EAAW,GAKf,OAJA,EAAG,GAAG,oBAAuB,CACvB,GACJ,EAAQ,WAAW,WAAW,CAChC,CAAC,EACM,CACL,WAAY,EAAQ,WACpB,SAAU,CACJ,IACJ,EAAW,GACX,EAAiB,QAAQ,EACzB,EAAQ,QAAQ,EAChB,EAAK,QAAQ,EACf,CACF,CACF"}

package/dist/container/helpHost.mjs

@@ -0,0 +1,2 @@
+import{createHelpRuntime as e}from"./index.mjs";import{provideDoomHelpHost as t,registerDoomHelpContribution as n}from"@agimon-ai/doompi-extension-contracts/help";function r(r,i={}){let a=r,o=t(a),s=e(o,i),c=n(a,{source:`@agimon-ai/doompi-help`,moduleUrl:import.meta.url,skills:[{name:`doompi-help`,description:`Use Doom Pi package Help safely, including activation, exact-version retrieval, and diagnostics.`}]}),l=!1;return r.on(`session_start`,()=>{l||s.activation.deactivate()}),{activation:s.activation,dispose(){l||(l=!0,c.dispose(),s.dispose(),o.dispose())}}}export{r as activateHelpHost};
+//# sourceMappingURL=helpHost.mjs.map

package/dist/container/helpHost.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpHost.mjs","names":[],"sources":["../../src/container/helpHost.ts"],"sourcesContent":["import type { DoomExtensionHost } from '@agimon-ai/doompi-extension-contracts/config';\nimport { provideDoomHelpHost, registerDoomHelpContribution } from '@agimon-ai/doompi-extension-contracts/help';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { createHelpRuntime, type HelpRuntimeOptions } from './index.ts';\nimport type { HelpActivationService } from '../types/help.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-help';\n\nexport interface HelpHostRuntime {\n  activation: HelpActivationService;\n  dispose(): void;\n}\n\nexport function activateHelpHost(pi: ExtensionAPI, options: HelpRuntimeOptions = {}): HelpHostRuntime {\n  const protocolHost = pi as unknown as DoomExtensionHost;\n  const host = provideDoomHelpHost(protocolHost);\n  const runtime = createHelpRuntime(host, options);\n  const selfContribution = registerDoomHelpContribution(protocolHost, {\n    source: PACKAGE_SOURCE,\n    moduleUrl: import.meta.url,\n    skills: [\n      {\n        name: 'doompi-help',\n        description: 'Use Doom Pi package Help safely, including activation, exact-version retrieval, and diagnostics.',\n      },\n    ],\n  });\n  let disposed = false;\n  pi.on('session_start', () => {\n    if (disposed) return;\n    runtime.activation.deactivate();\n  });\n  return {\n    activation: runtime.activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      selfContribution.dispose();\n      runtime.dispose();\n      host.dispose();\n    },\n  };\n}\n"],"mappings":"mKAaA,SAAgB,EAAiB,EAAkB,EAA8B,CAAC,EAAoB,CACpG,IAAM,EAAe,EACf,EAAO,EAAoB,CAAY,EACvC,EAAU,EAAkB,EAAM,CAAO,EACzC,EAAmB,EAA6B,EAAc,CAClE,OAAQ,yBACR,UAAW,YAAY,IACvB,OAAQ,CACN,CACE,KAAM,cACN,YAAa,kGACf,CACF,CACF,CAAC,EACG,EAAW,GAKf,OAJA,EAAG,GAAG,oBAAuB,CACvB,GACJ,EAAQ,WAAW,WAAW,CAChC,CAAC,EACM,CACL,WAAY,EAAQ,WACpB,SAAU,CACJ,IACJ,EAAW,GACX,EAAiB,QAAQ,EACzB,EAAQ,QAAQ,EAChB,EAAK,QAAQ,EACf,CACF,CACF"}

package/dist/extensions/pi.cjs

@@ -0,0 +1 @@
+const e=require("../adapters/pi/extension.cjs");module.exports=e.default;

package/dist/extensions/pi.d.cts

@@ -0,0 +1,2 @@
+import helpExtension from "../adapters/pi/extension.cjs";
+export = helpExtension;

package/dist/extensions/pi.d.mts

@@ -0,0 +1,2 @@
+import helpExtension from "../adapters/pi/extension.mjs";
+export { helpExtension as default };

package/dist/extensions/pi.mjs

@@ -0,0 +1 @@
+import e from"../adapters/pi/extension.mjs";export{e as default};

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./extensions/doom.cjs");exports.activateHelpExtension=e.activateHelpExtension,exports.registerHelpExtension=e.default;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./adapters/pi/extension.cjs");exports.helpExtension=e.default,exports.installHelpRuntime=e.installHelpRuntime;

package/dist/index.d.cts

@@ -1,2 +1,2 @@
-import registerHelpExtension, { activateHelpExtension } from "./extensions/doom.cjs";
-export { activateHelpExtension, registerHelpExtension };
+import helpExtension, { installHelpRuntime } from "./adapters/pi/extension.cjs";
+export { helpExtension, installHelpRuntime };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import registerHelpExtension, { activateHelpExtension } from "./extensions/doom.mjs";
-export { activateHelpExtension, registerHelpExtension };
+import helpExtension, { installHelpRuntime } from "./adapters/pi/extension.mjs";
+export { helpExtension, installHelpRuntime };

package/dist/index.mjs

@@ -1 +1 @@
-import e,{activateHelpExtension as t}from"./extensions/doom.mjs";export{t as activateHelpExtension,e as registerHelpExtension};
+import e,{installHelpRuntime as t}from"./adapters/pi/extension.mjs";export{e as helpExtension,t as installHelpRuntime};

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@agimon-ai/doompi-help",
-  "version": "0.0.1-alpha.6",
+  "version": "0.0.1-alpha.7",
   "description": "Activation-gated package guidance and help skills for DoomPi and Pi extensions.",
   "keywords": [
     "agent-documentation",
+    "ai",
     "coding-agent",
+    "developer-tools",
     "doompi",
     "help-system",
     "pi-coding-agent",
     "pi-extension",
+    "pi-package",
     "skills"
   ],
   "homepage": "https://agimon.ai",
@@ -31,10 +34,10 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
-    "./extensions/doom": {
-      "types": "./dist/extensions/doom.d.mts",
-      "import": "./dist/extensions/doom.mjs",
-      "require": "./dist/extensions/doom.cjs"
+    "./extensions/pi": {
+      "types": "./dist/extensions/pi.d.mts",
+      "import": "./dist/extensions/pi.mjs",
+      "require": "./dist/extensions/pi.cjs"
     },
     "./package.json": "./package.json"
   },
@@ -42,7 +45,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.23"
+    "@deepseek-ai/cordis": "4.0.1",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.24"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2",
@@ -51,7 +55,7 @@
     "tsdown": "0.22.14",
     "typescript": "6.0.3",
     "vitest": "4.1.10",
-    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.23"
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2"
@@ -66,7 +70,7 @@
   },
   "pi": {
     "extensions": [
-      "./dist/extensions/doom.mjs"
+      "./dist/extensions/pi.mjs"
     ]
   },
   "scripts": {

package/dist/extensions/doom.cjs

@@ -1,2 +0,0 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../adapters/pi/helpMode.cjs"),t=require("../container/index.cjs");let n=require("@agimon-ai/doompi-extension-contracts/help");const r=`@agimon-ai/doompi-help`,i=Symbol.for(`${r}/installed-hosts`);function a(e){let t=globalThis,n=t[i]??new WeakSet;return t[i]=n,!n.has(e)&&(n.add(e),!0)}function o(i,a={}){let o=i,s=(0,n.provideDoomHelpHost)(o),c=t.createHelpRuntime(s,a),l=e.registerHelpModeIntegration(i,c.activation),u=(0,n.registerDoomHelpContribution)(o,{source:r,moduleUrl:require("url").pathToFileURL(__filename).href,skills:[{name:`doompi-help`,description:`Use Doom Pi package Help safely, including activation, exact-version retrieval, and diagnostics.`}]});i.on(`session_start`,()=>{c.activation.deactivate()});let d=!1;return()=>{d||(d=!0,l.dispose(),u.dispose(),c.dispose(),s.dispose())}}function s(e){if(!a(e))return;let t=o(e);e.on(`session_shutdown`,t)}exports.activateHelpExtension=o,exports.default=s,exports.registerHelpExtension=s;
-//# sourceMappingURL=doom.cjs.map

package/dist/extensions/doom.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"doom.cjs","names":["provideDoomHelpHost","createHelpRuntime","registerHelpModeIntegration","registerDoomHelpContribution"],"sources":["../../src/exports/extensions/doom.ts"],"sourcesContent":["import type { DoomExtensionHost } from '@agimon-ai/doompi-extension-contracts/config';\nimport { provideDoomHelpHost, registerDoomHelpContribution } from '@agimon-ai/doompi-extension-contracts/help';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { registerHelpModeIntegration } from '../../adapters/pi/helpMode.ts';\nimport { createHelpRuntime, type HelpRuntimeOptions } from '../../container/index.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-help';\nconst INSTALLATIONS_KEY = Symbol.for(`${PACKAGE_SOURCE}/installed-hosts`);\n\ntype InstallationRegistry = typeof globalThis & {\n  [INSTALLATIONS_KEY]?: WeakSet<object>;\n};\n\nfunction claimHostInstallation(pi: ExtensionAPI): boolean {\n  const registry = globalThis as InstallationRegistry;\n  const installedHosts = registry[INSTALLATIONS_KEY] ?? new WeakSet<object>();\n  registry[INSTALLATIONS_KEY] = installedHosts;\n  if (installedHosts.has(pi)) return false;\n  installedHosts.add(pi);\n  return true;\n}\n\nexport function activateHelpExtension(pi: ExtensionAPI, options: HelpRuntimeOptions = {}): () => void {\n  const protocolHost = pi as unknown as DoomExtensionHost;\n  const host = provideDoomHelpHost(protocolHost);\n  const runtime = createHelpRuntime(host, options);\n  const mode = registerHelpModeIntegration(pi, runtime.activation);\n  const selfContribution = registerDoomHelpContribution(protocolHost, {\n    source: PACKAGE_SOURCE,\n    moduleUrl: import.meta.url,\n    skills: [\n      {\n        name: 'doompi-help',\n        description: 'Use Doom Pi package Help safely, including activation, exact-version retrieval, and diagnostics.',\n      },\n    ],\n  });\n  pi.on('session_start', () => {\n    runtime.activation.deactivate();\n  });\n  let disposed = false;\n  return () => {\n    if (disposed) return;\n    disposed = true;\n    mode.dispose();\n    selfContribution.dispose();\n    runtime.dispose();\n    host.dispose();\n  };\n}\n\nexport function registerHelpExtension(pi: ExtensionAPI): void {\n  if (!claimHostInstallation(pi)) return;\n  const dispose = activateHelpExtension(pi);\n  pi.on('session_shutdown', dispose);\n}\n\nexport default registerHelpExtension;\n"],"mappings":"8OAMA,MAAM,EAAiB,yBACjB,EAAoB,OAAO,IAAI,GAAG,EAAe,iBAAiB,EAMxE,SAAS,EAAsB,EAA2B,CACxD,IAAM,EAAW,WACX,EAAiB,EAAS,IAAsB,IAAI,QAI1D,MAHA,GAAS,GAAqB,EAC9B,CAAI,EAAe,IAAI,CAAE,IACzB,EAAe,IAAI,CAAE,EACd,GACT,CAEA,SAAgB,EAAsB,EAAkB,EAA8B,CAAC,EAAe,CACpG,IAAM,EAAe,EACf,GAAA,EAAOA,EAAAA,oBAAAA,CAAoB,CAAY,EACvC,EAAUC,EAAAA,kBAAkB,EAAM,CAAO,EACzC,EAAOC,EAAAA,4BAA4B,EAAI,EAAQ,UAAU,EACzD,GAAA,EAAmBC,EAAAA,6BAAAA,CAA6B,EAAc,CAClE,OAAQ,EACR,UAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,KACA,OAAQ,CACN,CACE,KAAM,cACN,YAAa,kGACf,CACF,CACF,CAAC,EACD,EAAG,GAAG,oBAAuB,CAC3B,EAAQ,WAAW,WAAW,CAChC,CAAC,EACD,IAAI,EAAW,GACf,UAAa,CACP,IACJ,EAAW,GACX,EAAK,QAAQ,EACb,EAAiB,QAAQ,EACzB,EAAQ,QAAQ,EAChB,EAAK,QAAQ,EACf,CACF,CAEA,SAAgB,EAAsB,EAAwB,CAC5D,GAAI,CAAC,EAAsB,CAAE,EAAG,OAChC,IAAM,EAAU,EAAsB,CAAE,EACxC,EAAG,GAAG,mBAAoB,CAAO,CACnC"}

package/dist/extensions/doom.d.cts

@@ -1,8 +0,0 @@
-import { HelpRuntimeOptions } from "../container/index.cjs";
-import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-//#region src/exports/extensions/doom.d.ts
-declare function activateHelpExtension(pi: ExtensionAPI, options?: HelpRuntimeOptions): () => void;
-declare function registerHelpExtension(pi: ExtensionAPI): void;
-//#endregion
-export { activateHelpExtension, registerHelpExtension as default, registerHelpExtension };
-//# sourceMappingURL=doom.d.cts.map

package/dist/extensions/doom.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doom.d.cts","names":[],"sources":["../../src/exports/extensions/doom.ts"],"mappings":";;;iBAsBgB,sBAAsB,IAAI,cAAc,UAAS;iBA6BjD,sBAAsB,IAAI"}

package/dist/extensions/doom.d.mts

@@ -1,8 +0,0 @@
-import { HelpRuntimeOptions } from "../container/index.mjs";
-import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-//#region src/exports/extensions/doom.d.ts
-declare function activateHelpExtension(pi: ExtensionAPI, options?: HelpRuntimeOptions): () => void;
-declare function registerHelpExtension(pi: ExtensionAPI): void;
-//#endregion
-export { activateHelpExtension, registerHelpExtension as default, registerHelpExtension };
-//# sourceMappingURL=doom.d.mts.map

package/dist/extensions/doom.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doom.d.mts","names":[],"sources":["../../src/exports/extensions/doom.ts"],"mappings":";;;iBAsBgB,sBAAsB,IAAI,cAAc,UAAS;iBA6BjD,sBAAsB,IAAI"}

package/dist/extensions/doom.mjs

@@ -1,2 +0,0 @@
-import{registerHelpModeIntegration as e}from"../adapters/pi/helpMode.mjs";import{createHelpRuntime as t}from"../container/index.mjs";import{provideDoomHelpHost as n,registerDoomHelpContribution as r}from"@agimon-ai/doompi-extension-contracts/help";const i=`@agimon-ai/doompi-help`,a=Symbol.for(`${i}/installed-hosts`);function o(e){let t=globalThis,n=t[a]??new WeakSet;return t[a]=n,!n.has(e)&&(n.add(e),!0)}function s(a,o={}){let s=a,c=n(s),l=t(c,o),u=e(a,l.activation),d=r(s,{source:i,moduleUrl:import.meta.url,skills:[{name:`doompi-help`,description:`Use Doom Pi package Help safely, including activation, exact-version retrieval, and diagnostics.`}]});a.on(`session_start`,()=>{l.activation.deactivate()});let f=!1;return()=>{f||(f=!0,u.dispose(),d.dispose(),l.dispose(),c.dispose())}}function c(e){if(!o(e))return;let t=s(e);e.on(`session_shutdown`,t)}export{s as activateHelpExtension,c as default,c as registerHelpExtension};
-//# sourceMappingURL=doom.mjs.map

package/dist/extensions/doom.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"doom.mjs","names":[],"sources":["../../src/exports/extensions/doom.ts"],"sourcesContent":["import type { DoomExtensionHost } from '@agimon-ai/doompi-extension-contracts/config';\nimport { provideDoomHelpHost, registerDoomHelpContribution } from '@agimon-ai/doompi-extension-contracts/help';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { registerHelpModeIntegration } from '../../adapters/pi/helpMode.ts';\nimport { createHelpRuntime, type HelpRuntimeOptions } from '../../container/index.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-help';\nconst INSTALLATIONS_KEY = Symbol.for(`${PACKAGE_SOURCE}/installed-hosts`);\n\ntype InstallationRegistry = typeof globalThis & {\n  [INSTALLATIONS_KEY]?: WeakSet<object>;\n};\n\nfunction claimHostInstallation(pi: ExtensionAPI): boolean {\n  const registry = globalThis as InstallationRegistry;\n  const installedHosts = registry[INSTALLATIONS_KEY] ?? new WeakSet<object>();\n  registry[INSTALLATIONS_KEY] = installedHosts;\n  if (installedHosts.has(pi)) return false;\n  installedHosts.add(pi);\n  return true;\n}\n\nexport function activateHelpExtension(pi: ExtensionAPI, options: HelpRuntimeOptions = {}): () => void {\n  const protocolHost = pi as unknown as DoomExtensionHost;\n  const host = provideDoomHelpHost(protocolHost);\n  const runtime = createHelpRuntime(host, options);\n  const mode = registerHelpModeIntegration(pi, runtime.activation);\n  const selfContribution = registerDoomHelpContribution(protocolHost, {\n    source: PACKAGE_SOURCE,\n    moduleUrl: import.meta.url,\n    skills: [\n      {\n        name: 'doompi-help',\n        description: 'Use Doom Pi package Help safely, including activation, exact-version retrieval, and diagnostics.',\n      },\n    ],\n  });\n  pi.on('session_start', () => {\n    runtime.activation.deactivate();\n  });\n  let disposed = false;\n  return () => {\n    if (disposed) return;\n    disposed = true;\n    mode.dispose();\n    selfContribution.dispose();\n    runtime.dispose();\n    host.dispose();\n  };\n}\n\nexport function registerHelpExtension(pi: ExtensionAPI): void {\n  if (!claimHostInstallation(pi)) return;\n  const dispose = activateHelpExtension(pi);\n  pi.on('session_shutdown', dispose);\n}\n\nexport default registerHelpExtension;\n"],"mappings":"wPAMA,MAAM,EAAiB,yBACjB,EAAoB,OAAO,IAAI,GAAG,EAAe,iBAAiB,EAMxE,SAAS,EAAsB,EAA2B,CACxD,IAAM,EAAW,WACX,EAAiB,EAAS,IAAsB,IAAI,QAI1D,MAHA,GAAS,GAAqB,EAC9B,CAAI,EAAe,IAAI,CAAE,IACzB,EAAe,IAAI,CAAE,EACd,GACT,CAEA,SAAgB,EAAsB,EAAkB,EAA8B,CAAC,EAAe,CACpG,IAAM,EAAe,EACf,EAAO,EAAoB,CAAY,EACvC,EAAU,EAAkB,EAAM,CAAO,EACzC,EAAO,EAA4B,EAAI,EAAQ,UAAU,EACzD,EAAmB,EAA6B,EAAc,CAClE,OAAQ,EACR,UAAW,YAAY,IACvB,OAAQ,CACN,CACE,KAAM,cACN,YAAa,kGACf,CACF,CACF,CAAC,EACD,EAAG,GAAG,oBAAuB,CAC3B,EAAQ,WAAW,WAAW,CAChC,CAAC,EACD,IAAI,EAAW,GACf,UAAa,CACP,IACJ,EAAW,GACX,EAAK,QAAQ,EACb,EAAiB,QAAQ,EACzB,EAAQ,QAAQ,EAChB,EAAK,QAAQ,EACf,CACF,CAEA,SAAgB,EAAsB,EAAwB,CAC5D,GAAI,CAAC,EAAsB,CAAE,EAAG,OAChC,IAAM,EAAU,EAAsB,CAAE,EACxC,EAAG,GAAG,mBAAoB,CAAO,CACnC"}