@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/schemas/headless.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"headless.mjs","names":[],"sources":["../../../src/schemas/headless.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport type { ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { CallToolResult, Tool } from '@modelcontextprotocol/server';\nimport type { Static, TSchema } from 'typebox';\n\nimport type { SessionToolSurface } from '../types/server/sessionToolSurface';\nimport type { DoomSessionContext } from './hubChannel';\nimport type { DoomNotificationRequest } from './notification';\nimport type { DoomServerBundleEntry } from './serverBundle';\n\n/** Session-only contributions. This is not a Pi ExtensionAPI or a TUI adapter. */\nexport const DOOM_HEADLESS_HOST_SERVICE = 'doom/headless-host';\nexport const DOOM_HEADLESS_OWNER = Symbol.for('doom/headless-owner');\n\nconst PROMPT_ADMISSION_ERROR = 'DoomHeadlessPromptAdmissionError';\n\n/** Admission is a host boundary, not an advisory facet-hook failure. */\nexport class DoomHeadlessPromptAdmissionError extends Error {\n  constructor(cause: unknown) {\n    super(cause instanceof Error ? cause.message : String(cause), { cause });\n    this.name = PROMPT_ADMISSION_ERROR;\n  }\n}\n\nconst SESSION_SETUP_ERROR = 'DoomSessionSetupError';\n\n/**\n * A session cannot start until the user fixes their setup, such as configuring a model.\n *\n * Its message is written for the user and says what to do, so a server returns it as is\n * rather than hiding it behind a generic internal error.\n */\nexport class DoomSessionSetupError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = SESSION_SETUP_ERROR;\n  }\n}\n\n/** Error identity must survive independently bundled server and extension graphs. */\nexport function isDoomSessionSetupError(error: unknown): error is Error {\n  return error instanceof Error && error.name === SESSION_SETUP_ERROR;\n}\n\n/** Error identity must survive independently bundled server and extension graphs. */\nexport function isDoomHeadlessPromptAdmissionError(error: unknown): boolean {\n  return error instanceof Error && error.name === PROMPT_ADMISSION_ERROR;\n}\nconst TOOL_BUSY_ERROR = 'DoomHeadlessToolBusyError';\n\n/** The tool and its hooks have not started. */\nexport class DoomHeadlessToolBusyError extends Error {\n  constructor() {\n    super('An operation is already running');\n    this.name = TOOL_BUSY_ERROR;\n  }\n}\n\nexport function isDoomHeadlessToolBusyError(error: unknown): boolean {\n  return error instanceof Error && error.name === TOOL_BUSY_ERROR;\n}\n\nexport interface DoomHeadlessSelection {\n  readonly majorMode: string;\n  readonly activeLayers: readonly string[];\n  readonly domains: readonly string[];\n  readonly profile?: string;\n  /** Feature-owned activation sets, keyed by the contributing capability. */\n  readonly state?: Readonly<Record<string, readonly string[]>>;\n}\n\n/** One package-owned selection transition. Server facets change exactly one axis per operation. */\nexport type DoomHeadlessSelectionChange =\n  | { readonly axis: 'majorMode'; readonly majorMode: string }\n  | { readonly axis: 'domains'; readonly domains: readonly string[] }\n  | { readonly axis: 'profile'; readonly profile?: string }\n  | {\n      readonly axis: 'state';\n      readonly key: string;\n      readonly values: readonly string[];\n    };\n\nexport function readDoomHeadlessOwner(context: Context): DoomServerBundleEntry | undefined {\n  return (context as Context & { [DOOM_HEADLESS_OWNER]?: DoomServerBundleEntry })[DOOM_HEADLESS_OWNER];\n}\n\nexport interface DoomHeadlessRegistration {\n  dispose(): void;\n}\n\nexport type DoomHeadlessContent = { type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string };\n\nexport interface DoomHeadlessToolResult {\n  content: DoomHeadlessContent[];\n  /** Public MCP result data. Internal renderer details are not a remote result contract. */\n  structuredContent?: Record<string, unknown>;\n  /** Component-only MCP metadata, never inferred from internal renderer details. */\n  _meta?: CallToolResult['_meta'];\n  details?: unknown;\n  isError?: boolean;\n}\n\n/**\n * Narrows a Pi tool result to the headless contract. Pi types `structuredContent` as any JSON\n * value, while MCP only accepts an object, so anything else is dropped rather than forwarded.\n */\nexport function toDoomHeadlessToolResult(result: {\n  readonly content: DoomHeadlessContent[];\n  readonly details?: unknown;\n  readonly structuredContent?: unknown;\n  readonly _meta?: CallToolResult['_meta'];\n  readonly isError?: boolean;\n}): DoomHeadlessToolResult {\n  const { structuredContent } = result;\n  return {\n    content: result.content,\n    details: result.details,\n    ...(result._meta === undefined ? {} : { _meta: result._meta }),\n    ...(typeof structuredContent === 'object' && structuredContent !== null && !Array.isArray(structuredContent)\n      ? { structuredContent: structuredContent as Record<string, unknown> }\n      : {}),\n    ...(result.isError === undefined ? {} : { isError: result.isError }),\n  };\n}\n\nexport interface DoomHeadlessClientRequest {\n  kind: 'confirm' | 'select' | 'input';\n  title: string;\n  message?: string;\n  options?: readonly { label: string; description?: string; value: string }[];\n  initialValue?: string;\n  multiline?: boolean;\n}\n\nexport interface DoomHeadlessClient {\n  /**\n   * Operator-facing surface only: the body is flattened to one line and capped at 4096 characters\n   * by schemas/notification.ts:73-83, and the model never sees it. Use session.admitPrompt to\n   * reach the model.\n   */\n  notify(request: DoomNotificationRequest): void | Promise<void>;\n  request(request: DoomHeadlessClientRequest, signal?: AbortSignal): Promise<unknown>;\n  setStatus(source: string, text: string | undefined): void;\n  appendComposerText?(text: string): void;\n}\n\nexport interface DoomHeadlessModelSettings {\n  model?: { provider: string; id: string };\n  thinkingLevel: ThinkingLevel;\n}\n\nexport interface DoomHeadlessSession {\n  readModelSettings?(): Promise<DoomHeadlessModelSettings>;\n  setFastMode?(enabled: boolean): Promise<void>;\n  setModelSettings?(settings: Partial<DoomHeadlessModelSettings>): Promise<void>;\n  /** Query durable history on demand; hosts do not retain the entire transcript. */\n  entries(query?: {\n    type?: 'custom' | 'message';\n    customType?: string;\n    limit?: number;\n  }): readonly Record<string, unknown>[] | Promise<readonly Record<string, unknown>[]>;\n  appendCustomEntry(type: string, data: unknown): Promise<void>;\n  /** Append a displayable informational message to history and model context, without admitting input or starting a turn. */\n  appendMessage?(message: { type: string; text: string; display?: boolean; details?: unknown }): Promise<string | void>;\n  /**\n   * Admit one custom message without awaiting its turn, using environmental input policy.\n   * Defaults to followUp. Reusing requestId deduplicates normal Durable admission retries;\n   * locked-agent appends and deferred operator admission do not provide that guarantee.\n   */\n  admitMessage?(\n    message: {\n      type: string;\n      text: string;\n      display?: boolean;\n      details?: unknown;\n    },\n    delivery?: 'steer' | 'followUp',\n    requestId?: string,\n  ): Promise<void>;\n  /** Register a checkpoint flush before the next tool-turn request. Idle writes return undefined instead of queueing when busy. */\n  registerCheckpointBoundary?(\n    callback: (boundary: {\n      signal?: AbortSignal;\n      appendMessage(message: {\n        type: string;\n        text: string;\n        display?: boolean;\n        details?: unknown;\n      }): Promise<string | undefined>;\n    }) => Promise<void>,\n  ): {\n    appendMessage(message: {\n      type: string;\n      text: string;\n      display?: boolean;\n      details?: unknown;\n    }): Promise<string | undefined>;\n    dispose(): void;\n  };\n  /** Detached canonical model context before facet transformations, with context edits applied and no system message. */\n  contextMessages?(): Promise<readonly Record<string, unknown>[]>;\n  /** The latest measured assistant usage and the selected model's context window. */\n  contextUsage?(): Promise<{ tokens: number | null; contextWindow: number } | undefined>;\n  /** Label a durable entry without admitting input or starting a turn. */\n  setLabel?(entryId: string, label: string | undefined): Promise<void>;\n  /**\n   * Delivers operator input through prompt preflight and awaits its turn.\n   * Environmental input uses admitPrompt with origin omitted instead.\n   * An idle agent is woken; busy delivery uses Durable steering or follow-up.\n   */\n  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;\n  /**\n   * Admits input without awaiting its turn. Environmental input omits origin and never\n   * changes the operator queue. Operator origin uses prompt preflight, including voice\n   * capture; 'interrupt' cancels the active run and admits operator input while preserving\n   * retained queued work. Environmental callers may reuse requestId when retrying the same input.\n   */\n  admitPrompt?(\n    text: string,\n    delivery?: 'prompt' | 'steer' | 'followUp' | 'interrupt',\n    origin?: 'operator',\n    requestId?: string,\n  ): Promise<void>;\n  abort(): Promise<void>;\n  compact(instructions?: string): Promise<void>;\n  activity(): Promise<{ hasPendingMessages: boolean; isIdle: boolean }>;\n  /** Renames the durable session and publishes the updated title to presentation clients. */\n  setName?(name: string): Promise<void>;\n  /** Capture the current persisted branch for an in-process child fork. */\n  forkSource?(): Promise<{\n    kind: 'v4-fork';\n    sessionFile: string;\n    branch: string;\n    entryId?: string;\n  }>;\n}\n\n/** A grant-filtered skill view available only during one remote MCP tool invocation. */\nexport interface DoomMcpSkillAccess {\n  list(): Promise<readonly { name: string; description: string }[]>;\n  read(name: string): Promise<string>;\n}\n\n/** A stateless auxiliary request. These tools are private to this request, never registered on the agent. */\nexport interface DoomHeadlessToolCompletionRequest {\n  systemPrompt: string;\n  input: string;\n  maxTokens: number;\n  cacheRetention?: 'none' | 'short' | 'long';\n  signal?: AbortSignal;\n  tools: readonly Pick<DoomHeadlessTool, 'name' | 'description' | 'parameters'>[];\n}\n\nexport interface DoomHeadlessToolCompletionResult {\n  toolCalls: readonly { id: string; name: string; arguments: unknown }[];\n  usage: { totalTokens: number };\n}\n\n/** Credential-free catalog metadata. Facets cannot obtain auth, headers, or a mutable registry. */\nexport interface DoomHeadlessModelMetadata {\n  readonly provider: string;\n  readonly id: string;\n  readonly api?: string;\n  readonly baseUrl?: string;\n  readonly name?: string;\n  readonly compat?: Readonly<Record<string, boolean | string>>;\n}\n\nexport interface DoomHeadlessExecutionContext {\n  readonly cwd: string;\n  /** The checkout the session runs in, distinct from the tool execution directory. */\n  readonly repoRoot: string;\n  readonly sessionId: string;\n  /** The session's baseline context, when its host knows its workspace. */\n  readonly sessionContext?: DoomSessionContext;\n  /** Immutable session configuration. Facets must not read or mutate process.env. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n  readonly client: DoomHeadlessClient;\n  readonly session: DoomHeadlessSession;\n  readonly model?: DoomHeadlessModelMetadata;\n  /** Lookup in this session's catalog, including physical models named by finalized messages. */\n  readonly getModel?: (provider: string, id: string) => DoomHeadlessModelMetadata | undefined;\n  /** Detached credential-free authenticated chat catalog snapshot, without refreshing providers. */\n  readonly getAvailableModels?: () => readonly {\n    readonly provider: string;\n    readonly id: string;\n  }[];\n  /** Operation cancellation, supplied only for an active invocation. */\n  readonly signal?: AbortSignal;\n  readonly textCompletion?: {\n    available(reference: string): boolean;\n    /** Tool-less conversation summary through the host's guarded session provider. */\n    summarize?(\n      reference: string,\n      request: {\n        messages: readonly Record<string, unknown>[];\n        instructions: string;\n        previousSummary?: string;\n        thinkingLevel?: ThinkingLevel;\n        signal?: AbortSignal;\n      },\n    ): Promise<string>;\n    complete(\n      reference: string,\n      request: {\n        systemPrompt: string;\n        input: string;\n        maxTokens: number;\n        cacheRetention?: 'none' | 'short' | 'long';\n        signal?: AbortSignal;\n      },\n    ): Promise<string>;\n  };\n  readonly toolCompletion?: {\n    complete(reference: string, request: DoomHeadlessToolCompletionRequest): Promise<DoomHeadlessToolCompletionResult>;\n  };\n  /** Guarded image operation. Credentials and transport configuration remain host-owned. */\n  readonly imageGeneration?: {\n    available(): boolean;\n    generate(request: {\n      prompt: string;\n      transparentBackground?: boolean;\n      images?: readonly { data: string; mimeType: string }[];\n      correlationId: string;\n      signal?: AbortSignal;\n    }): Promise<{ data: string; mimeType: 'image/png'; requestId?: string; generationId?: string }>;\n  };\n  /**\n   * Guarded web search. Credentials, endpoint, model choice, session identity and transport remain host-owned.\n   * `commands` follows a schema owned by the calling package; the host only bounds it.\n   */\n  readonly webSearch?: {\n    available(): boolean;\n    search(request: {\n      commands: Readonly<Record<string, unknown>>;\n      /** Optional plain-text excerpt, oldest first. Omit to send no conversation content. */\n      conversation?: readonly { role: 'user' | 'assistant'; text: string }[];\n      access: 'cached' | 'indexed' | 'live';\n      signal?: AbortSignal;\n    }): Promise<{ output: string; results?: readonly Record<string, unknown>[] }>;\n  };\n  readonly selection: DoomHeadlessSelection;\n  /** Present only while an authenticated remote MCP tool is running. */\n  readonly mcpSkills?: DoomMcpSkillAccess;\n  shutdown(): void;\n}\n\n/** Conditions narrow an eligible owner's contributions; they can never restore a disabled owner. */\nexport interface DoomHeadlessCondition {\n  state?: Readonly<Record<string, string>>;\n  attribution?: { kind: 'minor' | 'domain'; mode: string; label?: string };\n  domain?: string;\n}\n\nexport interface DoomHeadlessToolRestriction {\n  when?: DoomHeadlessCondition;\n  /** Optional capability ceiling. An empty list disables every tool. */\n  allowedTools?: readonly string[];\n  /**\n   * Narrow exclusions without disabling unrelated tools. Exclude a tool your package owns, or a\n   * specific foreign tool the mode exists to withdraw. Never enumerate an allowlist here.\n   */\n  excludedTools?: readonly string[];\n}\n\nexport interface DoomHeadlessTool<TParameters extends TSchema = TSchema> {\n  when?: DoomHeadlessCondition;\n  name: string;\n  label?: string;\n  description: string;\n  parameters: TParameters;\n  annotations?: Tool['annotations'];\n  outputSchema?: Tool['outputSchema'];\n  /** Remote presentation only. Component tool access must be explicitly opted into. */\n  _meta?: Tool['_meta'] & {\n    ui?: { resourceUri?: string; visibility?: ('model' | 'app')[] };\n  };\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  executionMode?: 'parallel' | 'serial';\n  execute(\n    toolCallId: string,\n    parameters: Static<TParameters>,\n    signal: AbortSignal | undefined,\n    onUpdate: ((result: DoomHeadlessToolResult) => void) | undefined,\n    context: DoomHeadlessExecutionContext,\n  ): Promise<DoomHeadlessToolResult>;\n}\n\n/**\n * One package contribution to the session's resource surface.\n *\n * `kind` decides what the model is billed for, and the difference is large:\n * - `context` is EAGER. `read()` runs on every prompt build and the text is pasted\n *   into the system prompt verbatim. Reserve it for small live session state that\n *   exists nowhere on disk. Never use it for a file the package ships: a README\n *   registered this way costs its full length on every single turn.\n * - `skill` is LAZY. Only `name`, `description` and `path` reach the prompt; the\n *   agent reads the file itself when the description matches the task.\n * - `prompt` is inert until the user invokes it by name.\n *\n * The rule in one line: if it is a file the package ships, it is a `skill`.\n */\nexport interface DoomHeadlessResource {\n  when?: DoomHeadlessCondition;\n  name: string;\n  /** Model-visible selection signal. A `skill` without one tells the agent nothing. */\n  description?: string;\n  /** Absolute path of the file `read()` returns, so an advertised skill is one the agent can open. */\n  path?: string;\n  kind: 'prompt' | 'skill' | 'context';\n  read(context: DoomHeadlessExecutionContext): string | Promise<string>;\n}\n\nexport interface DoomHeadlessCommand {\n  when?: DoomHeadlessCondition;\n  name: string;\n  description: string;\n  /** Selection-only control allowed after a coherent selection fails admission. */\n  selectionRecovery?: boolean;\n  execute(args: string, context: DoomHeadlessExecutionContext): void | Promise<void>;\n}\n\nexport type DoomHeadlessEventName =\n  | 'session_start'\n  | 'session_shutdown'\n  | 'session_tree'\n  | 'before_agent_start'\n  | 'agent_start'\n  | 'agent_end'\n  | 'agent_settled'\n  | 'turn_start'\n  | 'turn_end'\n  | 'context'\n  | 'before_provider_request'\n  | 'message_start'\n  | 'message_update'\n  | 'message_end'\n  | 'tool_call'\n  | 'tool_execution_start'\n  | 'tool_execution_update'\n  | 'tool_execution_end'\n  | 'tool_result'\n  | 'model_select'\n  | 'session_before_compact'\n  | 'session_compact';\n\nexport type DoomHeadlessHookEvent<E extends DoomHeadlessEventName> = E extends 'before_provider_request'\n  ? {\n      lane: string;\n      runId: string;\n      model: { provider: string; id: string; api?: string };\n      payload: unknown;\n    }\n  : E extends 'session_before_compact'\n    ? {\n        reason: string;\n        preparation: unknown;\n        instructions?: string;\n        customInstructions?: string;\n      }\n    : E extends 'model_select'\n      ? { model: { provider: string; id: string } }\n      : Readonly<Record<string, unknown>>;\n\nexport interface DoomHeadlessCompactionResult {\n  summary: string;\n  tokensBefore: number;\n  retainedTail: Record<string, unknown>[];\n  usage?: Record<string, unknown>;\n  details?: unknown;\n}\n\nexport type DoomHeadlessHookResult<E extends DoomHeadlessEventName> = E extends 'before_provider_request'\n  ? { payload: unknown } | void\n  : E extends 'session_before_compact'\n    ? {\n        cancel?: boolean;\n        decline?: boolean;\n        compaction?: DoomHeadlessCompactionResult;\n      } | void\n    : E extends 'context'\n      ? { messages?: unknown[]; systemPrompt?: string } | void\n      : E extends 'before_agent_start'\n        ? { systemPrompt?: string } | void\n        : E extends 'tool_call'\n          ? {\n              args?: Record<string, unknown>;\n              block?: { reason: string; terminate?: boolean };\n            } | void\n          : E extends 'tool_result'\n            ? {\n                content?: DoomHeadlessContent[];\n                details?: unknown;\n                isError?: boolean;\n                usage?: Record<string, unknown>;\n                terminate?: boolean;\n              } | void\n            : unknown;\n\nexport type DoomHeadlessHook<E extends DoomHeadlessEventName = DoomHeadlessEventName> = E extends DoomHeadlessEventName\n  ? {\n      when?: DoomHeadlessCondition;\n      event: E;\n      handle(\n        event: Readonly<DoomHeadlessHookEvent<E>>,\n        context: DoomHeadlessExecutionContext,\n      ): DoomHeadlessHookResult<E> | Promise<DoomHeadlessHookResult<E>>;\n    }\n  : never;\n\n/** A retained facet can register activity without starting disabled watchers or services. */\nexport interface DoomHeadlessActivity {\n  when?: DoomHeadlessCondition;\n  name: string;\n  start(context: DoomHeadlessExecutionContext): (() => void | Promise<void>) | Promise<() => void | Promise<void>>;\n}\n\n/** Read-only metadata for the currently applied session, never executable declarations or resource bodies. */\nexport interface DoomHeadlessCapability {\n  readonly source: string;\n  readonly name: string;\n  readonly kind: 'tool' | 'skill';\n  readonly when?: DoomHeadlessCondition;\n  readonly active: boolean;\n  readonly discoverable: boolean;\n  readonly reason?: 'inactive' | 'restricted' | 'shadowed' | 'unavailable' | 'not-discoverable';\n}\n\n/** Visibility controls model discovery only, never admission for external execution. */\nexport function isDoomHeadlessToolModelVisible(tool: Pick<DoomHeadlessTool, '_meta'>): boolean {\n  const visibility = tool._meta?.ui?.visibility;\n  return visibility === undefined || visibility.includes('model');\n}\n\nexport interface DoomHeadlessCapabilitySnapshot {\n  readonly revision: number;\n  readonly ready: boolean;\n  readonly capabilities: readonly DoomHeadlessCapability[];\n}\n\n/** Registrations inherit package ownership from the caller's Cordis facet. */\n/**\n * The tool a server session loads skills through. When a session carries it, the prompt lists\n * every skill by name and points here, so a skill needs no file the agent could read.\n */\nexport const DOOM_LOAD_SKILL_TOOL = 'load_skill';\n\nexport interface DoomHeadlessHostService {\n  readonly context: DoomHeadlessExecutionContext;\n  /** Admitted external execution, sharing native hooks, restrictions and session lifetime. */\n  readonly toolSurface?: Pick<SessionToolSurface, 'readSurface' | 'invokeTool'>;\n  /** The instructions of an applied skill by exact name, or undefined when none is applied. */\n  readSkill(name: string): string | undefined;\n  changeSelection(change: DoomHeadlessSelectionChange): Promise<void>;\n  assertActive(source?: string): void;\n  subscribeSelection(listener: (selection: DoomHeadlessSelection) => void | Promise<void>): () => void;\n  /** Inspect only a coherently applied generation. A transition returns ready=false and no partial inventory. */\n  inspectCapabilities(): DoomHeadlessCapabilitySnapshot;\n  registerToolRestriction(restriction: DoomHeadlessToolRestriction): DoomHeadlessRegistration;\n  registerTool<TParameters extends TSchema>(tool: DoomHeadlessTool<TParameters>): DoomHeadlessRegistration;\n  registerResource(resource: DoomHeadlessResource): DoomHeadlessRegistration;\n  registerCommand(command: DoomHeadlessCommand): DoomHeadlessRegistration;\n  registerHook(hook: DoomHeadlessHook): DoomHeadlessRegistration;\n  registerActivity(activity: DoomHeadlessActivity): DoomHeadlessRegistration;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/headless-host': DoomHeadlessHostService;\n  }\n}\n\nexport function readDoomHeadlessHost(context: Context): DoomHeadlessHostService | undefined {\n  return context.get(DOOM_HEADLESS_HOST_SERVICE) as DoomHeadlessHostService | undefined;\n}\n\nexport function requireDoomHeadlessHost(context: Context): DoomHeadlessHostService {\n  const host = readDoomHeadlessHost(context);\n  if (!host) throw new Error('This contribution requires the Doom headless session host.');\n  return host;\n}\n"],"mappings":";;AAWA,MAAa,6BAA6B;AAC1C,MAAa,sBAAsB,OAAO,IAAI,qBAAqB;AAEnE,MAAM,yBAAyB;;AAG/B,IAAa,mCAAb,cAAsD,MAAM;CAC1D,YAAY,OAAgB;EAC1B,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,EAAE,MAAM,CAAC;EACvE,KAAK,OAAO;CACd;AACF;AAEA,MAAM,sBAAsB;;;;;;;AAQ5B,IAAa,wBAAb,cAA2C,MAAM;CAC/C,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;;AAGA,SAAgB,wBAAwB,OAAgC;CACtE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;;AAGA,SAAgB,mCAAmC,OAAyB;CAC1E,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;AACA,MAAM,kBAAkB;;AAGxB,IAAa,4BAAb,cAA+C,MAAM;CACnD,cAAc;EACZ,MAAM,iCAAiC;EACvC,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,4BAA4B,OAAyB;CACnE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;AAsBA,SAAgB,sBAAsB,SAAqD;CACzF,OAAQ,QAAwE;AAClF;;;;;AAsBA,SAAgB,yBAAyB,QAMd;CACzB,MAAM,EAAE,sBAAsB;CAC9B,OAAO;EACL,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,GAAI,OAAO,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,OAAO,MAAM;EAC5D,GAAI,OAAO,sBAAsB,YAAY,sBAAsB,QAAQ,CAAC,MAAM,QAAQ,iBAAiB,IACvG,EAAqB,kBAA6C,IAClE,CAAC;EACL,GAAI,OAAO,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,OAAO,QAAQ;CACpE;AACF;;AAuZA,SAAgB,+BAA+B,MAAgD;CAC7F,MAAM,aAAa,KAAK,OAAO,IAAI;CACnC,OAAO,eAAe,KAAA,KAAa,WAAW,SAAS,OAAO;AAChE;;;;;;AAaA,MAAa,uBAAuB;AA2BpC,SAAgB,qBAAqB,SAAuD;CAC1F,OAAO,QAAQ,IAAI,0BAA0B;AAC/C;AAEA,SAAgB,wBAAwB,SAA2C;CACjF,MAAM,OAAO,qBAAqB,OAAO;CACzC,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,4DAA4D;CACvF,OAAO;AACT"}
+{"version":3,"file":"headless.mjs","names":[],"sources":["../../../src/schemas/headless.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport type { ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { CallToolResult, Tool } from '@modelcontextprotocol/server';\nimport type { Static, TSchema } from 'typebox';\n\nimport type { SessionToolSurface } from '../types/server/sessionToolSurface';\nimport type { PoSessionContext } from './hubChannel';\nimport type { PoNotificationRequest } from './notification';\nimport type { PoServerBundleEntry } from './serverBundle';\n\n/** Session-only contributions. This is not a Pi ExtensionAPI or a TUI adapter. */\nexport const PO_HEADLESS_HOST_SERVICE = 'po/headless-host';\nexport const PO_HEADLESS_OWNER = Symbol.for('po/headless-owner');\n\nconst PROMPT_ADMISSION_ERROR = 'PoHeadlessPromptAdmissionError';\n\n/** Admission is a host boundary, not an advisory package-hook failure. */\nexport class PoHeadlessPromptAdmissionError extends Error {\n  constructor(cause: unknown) {\n    super(cause instanceof Error ? cause.message : String(cause), { cause });\n    this.name = PROMPT_ADMISSION_ERROR;\n  }\n}\n\nconst SESSION_SETUP_ERROR = 'PoSessionSetupError';\n\n/**\n * A session cannot start until the user fixes their setup, such as configuring a model.\n *\n * Its message is written for the user and says what to do, so a server returns it as is\n * rather than hiding it behind a generic internal error.\n */\nexport class PoSessionSetupError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = SESSION_SETUP_ERROR;\n  }\n}\n\n/** Error identity must survive independently bundled server and extension graphs. */\nexport function isPoSessionSetupError(error: unknown): error is Error {\n  return error instanceof Error && error.name === SESSION_SETUP_ERROR;\n}\n\n/** Error identity must survive independently bundled server and extension graphs. */\nexport function isPoHeadlessPromptAdmissionError(error: unknown): boolean {\n  return error instanceof Error && error.name === PROMPT_ADMISSION_ERROR;\n}\nconst TOOL_BUSY_ERROR = 'PoHeadlessToolBusyError';\n\n/** The tool and its hooks have not started. */\nexport class PoHeadlessToolBusyError extends Error {\n  constructor() {\n    super('An operation is already running');\n    this.name = TOOL_BUSY_ERROR;\n  }\n}\n\nexport function isPoHeadlessToolBusyError(error: unknown): boolean {\n  return error instanceof Error && error.name === TOOL_BUSY_ERROR;\n}\n\nexport interface PoHeadlessSelection {\n  readonly majorMode: string;\n  readonly activeLayers: readonly string[];\n  readonly domains: readonly string[];\n  readonly profile?: string;\n  /** Feature-owned activation sets, keyed by the contributing capability. */\n  readonly state?: Readonly<Record<string, readonly string[]>>;\n}\n\n/** One package-owned selection transition. Server packages change exactly one axis per operation. */\nexport type PoHeadlessSelectionChange =\n  | { readonly axis: 'majorMode'; readonly majorMode: string }\n  | { readonly axis: 'domains'; readonly domains: readonly string[] }\n  | { readonly axis: 'profile'; readonly profile?: string }\n  | {\n      readonly axis: 'state';\n      readonly key: string;\n      readonly values: readonly string[];\n    };\n\nexport function readPoHeadlessOwner(context: Context): PoServerBundleEntry | undefined {\n  return (context as Context & { [PO_HEADLESS_OWNER]?: PoServerBundleEntry })[PO_HEADLESS_OWNER];\n}\n\nexport interface PoHeadlessRegistration {\n  dispose(): void;\n}\n\nexport type PoHeadlessContent = { type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string };\n\nexport interface PoHeadlessToolResult {\n  content: PoHeadlessContent[];\n  /** Public MCP result data. Internal renderer details are not a remote result contract. */\n  structuredContent?: Record<string, unknown>;\n  /** Component-only MCP metadata, never inferred from internal renderer details. */\n  _meta?: CallToolResult['_meta'];\n  details?: unknown;\n  isError?: boolean;\n}\n\n/**\n * Narrows a Pi tool result to the headless contract. Pi types `structuredContent` as any JSON\n * value, while MCP only accepts an object, so anything else is dropped rather than forwarded.\n */\nexport function toPoHeadlessToolResult(result: {\n  readonly content: PoHeadlessContent[];\n  readonly details?: unknown;\n  readonly structuredContent?: unknown;\n  readonly _meta?: CallToolResult['_meta'];\n  readonly isError?: boolean;\n}): PoHeadlessToolResult {\n  const { structuredContent } = result;\n  return {\n    content: result.content,\n    details: result.details,\n    ...(result._meta === undefined ? {} : { _meta: result._meta }),\n    ...(typeof structuredContent === 'object' && structuredContent !== null && !Array.isArray(structuredContent)\n      ? { structuredContent: structuredContent as Record<string, unknown> }\n      : {}),\n    ...(result.isError === undefined ? {} : { isError: result.isError }),\n  };\n}\n\nexport interface PoHeadlessClientRequest {\n  kind: 'confirm' | 'select' | 'input';\n  title: string;\n  message?: string;\n  options?: readonly { label: string; description?: string; value: string }[];\n  initialValue?: string;\n  multiline?: boolean;\n}\n\nexport interface PoHeadlessClient {\n  /**\n   * Operator-facing surface only: the body is flattened to one line and capped at 4096 characters\n   * by schemas/notification.ts:73-83, and the model never sees it. Use session.admitPrompt to\n   * reach the model.\n   */\n  notify(request: PoNotificationRequest): void | Promise<void>;\n  request(request: PoHeadlessClientRequest, signal?: AbortSignal): Promise<unknown>;\n  /** Ignored once the session has closed, so a package can clear its status while it unwinds. */\n  setStatus(source: string, text: string | undefined): void;\n  appendComposerText?(text: string): void;\n}\n\nexport interface PoHeadlessModelSettings {\n  model?: { provider: string; id: string };\n  thinkingLevel: ThinkingLevel;\n}\n\nexport interface PoHeadlessSession {\n  readModelSettings?(): Promise<PoHeadlessModelSettings>;\n  setFastMode?(enabled: boolean): Promise<void>;\n  setModelSettings?(settings: Partial<PoHeadlessModelSettings>): Promise<void>;\n  /** Query durable history on demand; hosts do not retain the entire transcript. */\n  entries(query?: {\n    type?: 'custom' | 'message';\n    customType?: string;\n    limit?: number;\n  }): readonly Record<string, unknown>[] | Promise<readonly Record<string, unknown>[]>;\n  appendCustomEntry(type: string, data: unknown): Promise<void>;\n  /** Append a displayable informational message to history and model context, without admitting input or starting a turn. */\n  appendMessage?(message: { type: string; text: string; display?: boolean; details?: unknown }): Promise<string | void>;\n  /**\n   * Admit one custom message without awaiting its turn, using environmental input policy.\n   * Defaults to followUp. Reusing requestId deduplicates normal Durable admission retries;\n   * locked-agent appends and deferred operator admission do not provide that guarantee.\n   */\n  admitMessage?(\n    message: {\n      type: string;\n      text: string;\n      display?: boolean;\n      details?: unknown;\n    },\n    delivery?: 'steer' | 'followUp',\n    requestId?: string,\n  ): Promise<void>;\n  /** Register a checkpoint flush before the next tool-turn request. Idle writes return undefined instead of queueing when busy. */\n  registerCheckpointBoundary?(\n    callback: (boundary: {\n      signal?: AbortSignal;\n      appendMessage(message: {\n        type: string;\n        text: string;\n        display?: boolean;\n        details?: unknown;\n      }): Promise<string | undefined>;\n    }) => Promise<void>,\n  ): {\n    appendMessage(message: {\n      type: string;\n      text: string;\n      display?: boolean;\n      details?: unknown;\n    }): Promise<string | undefined>;\n    dispose(): void;\n  };\n  /** Detached canonical model context before package transformations, with context edits applied and no system message. */\n  contextMessages?(): Promise<readonly Record<string, unknown>[]>;\n  /** The latest measured assistant usage and the selected model's context window. */\n  contextUsage?(): Promise<{ tokens: number | null; contextWindow: number } | undefined>;\n  /** Label a durable entry without admitting input or starting a turn. */\n  setLabel?(entryId: string, label: string | undefined): Promise<void>;\n  /**\n   * Delivers operator input through prompt preflight and awaits its turn.\n   * Environmental input uses admitPrompt with origin omitted instead.\n   * An idle agent is woken; busy delivery uses Durable steering or follow-up.\n   */\n  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;\n  /**\n   * Admits input without awaiting its turn. Environmental input omits origin and never\n   * changes the operator queue. Operator origin uses prompt preflight, including voice\n   * capture; 'interrupt' cancels the active run and admits operator input while preserving\n   * retained queued work. Environmental callers may reuse requestId when retrying the same input.\n   */\n  admitPrompt?(\n    text: string,\n    delivery?: 'prompt' | 'steer' | 'followUp' | 'interrupt',\n    origin?: 'operator',\n    requestId?: string,\n  ): Promise<void>;\n  abort(): Promise<void>;\n  compact(instructions?: string): Promise<void>;\n  activity(): Promise<{ hasPendingMessages: boolean; isIdle: boolean }>;\n  /** Renames the durable session and publishes the updated title to presentation clients. */\n  setName?(name: string): Promise<void>;\n  /** The current branch's newest entry, for a child that starts from this session's history. */\n  forkSource?(): Promise<{\n    kind: 'fork';\n    entryId?: string;\n  }>;\n}\n\n/** A grant-filtered skill view available only during one remote MCP tool invocation. */\nexport interface PoMcpSkillAccess {\n  list(): Promise<readonly { name: string; description: string }[]>;\n  read(name: string): Promise<string>;\n}\n\n/** A stateless auxiliary request. These tools are private to this request, never registered on the agent. */\nexport interface PoHeadlessToolCompletionRequest {\n  systemPrompt: string;\n  input: string;\n  maxTokens: number;\n  cacheRetention?: 'none' | 'short' | 'long';\n  signal?: AbortSignal;\n  tools: readonly Pick<PoHeadlessTool, 'name' | 'description' | 'parameters'>[];\n}\n\nexport interface PoHeadlessToolCompletionResult {\n  toolCalls: readonly { id: string; name: string; arguments: unknown }[];\n  usage: { totalTokens: number };\n}\n\n/** Credential-free catalog metadata. Packages cannot obtain auth, headers, or a mutable registry. */\nexport interface PoHeadlessModelMetadata {\n  readonly provider: string;\n  readonly id: string;\n  readonly api?: string;\n  readonly baseUrl?: string;\n  readonly name?: string;\n  readonly compat?: Readonly<Record<string, boolean | string>>;\n}\n\nexport interface PoHeadlessExecutionContext {\n  readonly cwd: string;\n  /** The checkout the session runs in, distinct from the tool execution directory. */\n  readonly repoRoot: string;\n  readonly sessionId: string;\n  /** The session's baseline context, when its host knows its workspace. */\n  readonly sessionContext?: PoSessionContext;\n  /** Immutable session configuration. Packages must not read or mutate process.env. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n  readonly client: PoHeadlessClient;\n  readonly session: PoHeadlessSession;\n  readonly model?: PoHeadlessModelMetadata;\n  /** Lookup in this session's catalog, including physical models named by finalized messages. */\n  readonly getModel?: (provider: string, id: string) => PoHeadlessModelMetadata | undefined;\n  /** Detached credential-free authenticated chat catalog, read after refreshing provider availability. */\n  readonly getAvailableModels?: () => Promise<\n    readonly {\n      readonly provider: string;\n      readonly id: string;\n    }[]\n  >;\n  /** Operation cancellation, supplied only for an active invocation. */\n  readonly signal?: AbortSignal;\n  readonly textCompletion?: {\n    available(reference: string): boolean;\n    /** Tool-less conversation summary through the host's guarded session provider. */\n    summarize?(\n      reference: string,\n      request: {\n        messages: readonly Record<string, unknown>[];\n        instructions: string;\n        previousSummary?: string;\n        thinkingLevel?: ThinkingLevel;\n        signal?: AbortSignal;\n      },\n    ): Promise<string>;\n    complete(\n      reference: string,\n      request: {\n        systemPrompt: string;\n        input: string;\n        maxTokens: number;\n        cacheRetention?: 'none' | 'short' | 'long';\n        signal?: AbortSignal;\n      },\n    ): Promise<string>;\n  };\n  readonly toolCompletion?: {\n    complete(reference: string, request: PoHeadlessToolCompletionRequest): Promise<PoHeadlessToolCompletionResult>;\n  };\n  /** Guarded image operation. Credentials and transport configuration remain host-owned. */\n  readonly imageGeneration?: {\n    available(): boolean;\n    generate(request: {\n      prompt: string;\n      transparentBackground?: boolean;\n      images?: readonly { data: string; mimeType: string }[];\n      correlationId: string;\n      signal?: AbortSignal;\n    }): Promise<{ data: string; mimeType: 'image/png'; requestId?: string; generationId?: string }>;\n  };\n  /**\n   * Guarded web search. Credentials, endpoint, model choice, session identity and transport remain host-owned.\n   * `commands` follows a schema owned by the calling package; the host only bounds it.\n   */\n  readonly webSearch?: {\n    available(): boolean;\n    search(request: {\n      commands: Readonly<Record<string, unknown>>;\n      /** Optional plain-text excerpt, oldest first. Omit to send no conversation content. */\n      conversation?: readonly { role: 'user' | 'assistant'; text: string }[];\n      access: 'cached' | 'indexed' | 'live';\n      signal?: AbortSignal;\n    }): Promise<{ output: string; results?: readonly Record<string, unknown>[] }>;\n  };\n  readonly selection: PoHeadlessSelection;\n  /** Present only while an authenticated remote MCP tool is running. */\n  readonly mcpSkills?: PoMcpSkillAccess;\n  shutdown(): void;\n}\n\n/** Conditions narrow an eligible owner's contributions; they can never restore a disabled owner. */\nexport interface PoHeadlessCondition {\n  state?: Readonly<Record<string, string>>;\n  attribution?: { kind: 'minor' | 'domain'; mode: string; label?: string };\n  domain?: string;\n}\n\nexport interface PoHeadlessToolRestriction {\n  when?: PoHeadlessCondition;\n  /** Optional capability ceiling. An empty list disables every tool. */\n  allowedTools?: readonly string[];\n  /**\n   * Narrow exclusions without disabling unrelated tools. Exclude a tool your package owns, or a\n   * specific foreign tool the mode exists to withdraw. Never enumerate an allowlist here.\n   */\n  excludedTools?: readonly string[];\n}\n\nexport interface PoHeadlessTool<TParameters extends TSchema = TSchema> {\n  when?: PoHeadlessCondition;\n  name: string;\n  label?: string;\n  description: string;\n  parameters: TParameters;\n  annotations?: Tool['annotations'];\n  outputSchema?: Tool['outputSchema'];\n  /** Remote presentation only. Component tool access must be explicitly opted into. */\n  _meta?: Tool['_meta'] & {\n    ui?: { resourceUri?: string; visibility?: ('model' | 'app')[] };\n  };\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  executionMode?: 'parallel' | 'serial';\n  execute(\n    toolCallId: string,\n    parameters: Static<TParameters>,\n    signal: AbortSignal | undefined,\n    onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n    context: PoHeadlessExecutionContext,\n  ): Promise<PoHeadlessToolResult>;\n}\n\n/**\n * One package contribution to the session's resource surface.\n *\n * `kind` decides what the model is billed for, and the difference is large:\n * - `context` is EAGER. `read()` runs on every prompt build and the text is pasted\n *   into the system prompt verbatim. Reserve it for small live session state that\n *   exists nowhere on disk. Never use it for a file the package ships: a README\n *   registered this way costs its full length on every single turn.\n * - `skill` is LAZY. Only `name`, `description` and `path` reach the prompt; the\n *   agent reads the file itself when the description matches the task.\n * - `prompt` is inert until the user invokes it by name.\n *\n * The rule in one line: if it is a file the package ships, it is a `skill`.\n */\nexport interface PoHeadlessResource {\n  when?: PoHeadlessCondition;\n  name: string;\n  /** Model-visible selection signal. A `skill` without one tells the agent nothing. */\n  description?: string;\n  /** Absolute path of the file `read()` returns, so an advertised skill is one the agent can open. */\n  path?: string;\n  kind: 'prompt' | 'skill' | 'context';\n  read(context: PoHeadlessExecutionContext): string | Promise<string>;\n}\n\nexport interface PoHeadlessCommand {\n  when?: PoHeadlessCondition;\n  name: string;\n  description: string;\n  /** Selection-only control allowed after a coherent selection fails admission. */\n  selectionRecovery?: boolean;\n  execute(args: string, context: PoHeadlessExecutionContext): void | Promise<void>;\n}\n\nexport type PoHeadlessEventName =\n  | 'session_start'\n  | 'session_shutdown'\n  | 'session_tree'\n  | 'before_agent_start'\n  | 'agent_start'\n  | 'agent_end'\n  | 'agent_settled'\n  | 'turn_start'\n  | 'turn_end'\n  | 'context'\n  | 'before_provider_request'\n  | 'message_start'\n  | 'message_update'\n  | 'message_end'\n  | 'tool_call'\n  | 'tool_execution_start'\n  | 'tool_execution_update'\n  | 'tool_execution_end'\n  | 'tool_result'\n  | 'model_select'\n  | 'session_before_compact'\n  | 'session_compact';\n\nexport type PoHeadlessHookEvent<E extends PoHeadlessEventName> = E extends 'before_provider_request'\n  ? {\n      lane: string;\n      runId: string;\n      model: { provider: string; id: string; api?: string };\n      payload: unknown;\n    }\n  : E extends 'session_before_compact'\n    ? {\n        reason: string;\n        preparation: unknown;\n        instructions?: string;\n        customInstructions?: string;\n      }\n    : E extends 'model_select'\n      ? { model: { provider: string; id: string } }\n      : Readonly<Record<string, unknown>>;\n\nexport interface PoHeadlessCompactionResult {\n  summary: string;\n  tokensBefore: number;\n  retainedTail: Record<string, unknown>[];\n  usage?: Record<string, unknown>;\n  details?: unknown;\n}\n\nexport type PoHeadlessHookResult<E extends PoHeadlessEventName> = E extends 'before_provider_request'\n  ? { payload: unknown } | void\n  : E extends 'session_before_compact'\n    ? {\n        cancel?: boolean;\n        decline?: boolean;\n        compaction?: PoHeadlessCompactionResult;\n      } | void\n    : E extends 'context'\n      ? { messages?: unknown[]; systemPrompt?: string } | void\n      : E extends 'before_agent_start'\n        ? { systemPrompt?: string } | void\n        : E extends 'tool_call'\n          ? {\n              args?: Record<string, unknown>;\n              block?: { reason: string; terminate?: boolean };\n            } | void\n          : E extends 'tool_result'\n            ? {\n                content?: PoHeadlessContent[];\n                details?: unknown;\n                isError?: boolean;\n                usage?: Record<string, unknown>;\n                terminate?: boolean;\n              } | void\n            : unknown;\n\nexport type PoHeadlessHook<E extends PoHeadlessEventName = PoHeadlessEventName> = E extends PoHeadlessEventName\n  ? {\n      when?: PoHeadlessCondition;\n      event: E;\n      handle(\n        event: Readonly<PoHeadlessHookEvent<E>>,\n        context: PoHeadlessExecutionContext,\n      ): PoHeadlessHookResult<E> | Promise<PoHeadlessHookResult<E>>;\n    }\n  : never;\n\n/** A retained package can register activity without starting disabled watchers or services. */\nexport interface PoHeadlessActivity {\n  when?: PoHeadlessCondition;\n  name: string;\n  start(context: PoHeadlessExecutionContext): (() => void | Promise<void>) | Promise<() => void | Promise<void>>;\n}\n\n/** Read-only metadata for the currently applied session, never executable declarations or resource bodies. */\nexport interface PoHeadlessCapability {\n  readonly source: string;\n  readonly name: string;\n  readonly kind: 'tool' | 'skill';\n  readonly when?: PoHeadlessCondition;\n  readonly active: boolean;\n  readonly discoverable: boolean;\n  readonly reason?: 'inactive' | 'restricted' | 'shadowed' | 'unavailable' | 'not-discoverable';\n}\n\n/** Visibility controls model discovery only, never admission for external execution. */\nexport function isPoHeadlessToolModelVisible(tool: Pick<PoHeadlessTool, '_meta'>): boolean {\n  const visibility = tool._meta?.ui?.visibility;\n  return visibility === undefined || visibility.includes('model');\n}\n\nexport interface PoHeadlessCapabilitySnapshot {\n  readonly revision: number;\n  readonly ready: boolean;\n  readonly capabilities: readonly PoHeadlessCapability[];\n}\n\n/** Registrations inherit package ownership from the caller's Cordis fiber. */\n/**\n * The tool a server session loads skills through. When a session carries it, the prompt lists\n * every skill by name and points here, so a skill needs no file the agent could read.\n */\nexport const PO_LOAD_SKILL_TOOL = 'load_skill';\n\nexport interface PoHeadlessHostService {\n  readonly context: PoHeadlessExecutionContext;\n  /** Admitted external execution, sharing native hooks, restrictions and session lifetime. */\n  readonly toolSurface?: Pick<SessionToolSurface, 'readSurface' | 'invokeTool'>;\n  /** The instructions of an applied skill by exact name, or undefined when none is applied. */\n  readSkill(name: string): string | undefined;\n  changeSelection(change: PoHeadlessSelectionChange): Promise<void>;\n  assertActive(source?: string): void;\n  subscribeSelection(listener: (selection: PoHeadlessSelection) => void | Promise<void>): () => void;\n  /** Inspect only a coherently applied generation. A transition returns ready=false and no partial inventory. */\n  inspectCapabilities(): PoHeadlessCapabilitySnapshot;\n  registerToolRestriction(restriction: PoHeadlessToolRestriction): PoHeadlessRegistration;\n  registerTool<TParameters extends TSchema>(tool: PoHeadlessTool<TParameters>): PoHeadlessRegistration;\n  registerResource(resource: PoHeadlessResource): PoHeadlessRegistration;\n  registerCommand(command: PoHeadlessCommand): PoHeadlessRegistration;\n  registerHook(hook: PoHeadlessHook): PoHeadlessRegistration;\n  registerActivity(activity: PoHeadlessActivity): PoHeadlessRegistration;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/headless-host': PoHeadlessHostService;\n  }\n}\n\nexport function readPoHeadlessHost(context: Context): PoHeadlessHostService | undefined {\n  return context.get(PO_HEADLESS_HOST_SERVICE) as PoHeadlessHostService | undefined;\n}\n\nexport function requirePoHeadlessHost(context: Context): PoHeadlessHostService {\n  const host = readPoHeadlessHost(context);\n  if (!host) throw new Error('This contribution requires the Po headless session host.');\n  return host;\n}\n"],"mappings":";;AAWA,MAAa,2BAA2B;AACxC,MAAa,oBAAoB,OAAO,IAAI,mBAAmB;AAE/D,MAAM,yBAAyB;;AAG/B,IAAa,iCAAb,cAAoD,MAAM;CACxD,YAAY,OAAgB;EAC1B,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,EAAE,MAAM,CAAC;EACvE,KAAK,OAAO;CACd;AACF;AAEA,MAAM,sBAAsB;;;;;;;AAQ5B,IAAa,sBAAb,cAAyC,MAAM;CAC7C,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;;AAGA,SAAgB,sBAAsB,OAAgC;CACpE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;;AAGA,SAAgB,iCAAiC,OAAyB;CACxE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;AACA,MAAM,kBAAkB;;AAGxB,IAAa,0BAAb,cAA6C,MAAM;CACjD,cAAc;EACZ,MAAM,iCAAiC;EACvC,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,0BAA0B,OAAyB;CACjE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;AAsBA,SAAgB,oBAAoB,SAAmD;CACrF,OAAQ,QAAoE;AAC9E;;;;;AAsBA,SAAgB,uBAAuB,QAMd;CACvB,MAAM,EAAE,sBAAsB;CAC9B,OAAO;EACL,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,GAAI,OAAO,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,OAAO,MAAM;EAC5D,GAAI,OAAO,sBAAsB,YAAY,sBAAsB,QAAQ,CAAC,MAAM,QAAQ,iBAAiB,IACvG,EAAqB,kBAA6C,IAClE,CAAC;EACL,GAAI,OAAO,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,OAAO,QAAQ;CACpE;AACF;;AAwZA,SAAgB,6BAA6B,MAA8C;CACzF,MAAM,aAAa,KAAK,OAAO,IAAI;CACnC,OAAO,eAAe,KAAA,KAAa,WAAW,SAAS,OAAO;AAChE;;;;;;AAaA,MAAa,qBAAqB;AA2BlC,SAAgB,mBAAmB,SAAqD;CACtF,OAAO,QAAQ,IAAI,wBAAwB;AAC7C;AAEA,SAAgB,sBAAsB,SAAyC;CAC7E,MAAM,OAAO,mBAAmB,OAAO;CACvC,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,0DAA0D;CACrF,OAAO;AACT"}

package/dist/src/schemas/help.cjs

@@ -2,24 +2,24 @@ let typebox = require("typebox");
 let typebox_value = require("typebox/value");
 //#region src/schemas/help.ts
 /** Provider-owned Cordis service for the live Help catalog. */
-const DOOM_HELP_SERVICE = "doom/help";
-const DOOM_HELP_WHEN = {
+const PO_HELP_SERVICE = "po/help";
+const PO_HELP_WHEN = {
 	state: { "minor-mode": "help" },
 	attribution: {
 		kind: "minor",
 		mode: "help"
 	}
 };
-const DOOM_HELP_MAX_CONTRIBUTORS = 32;
-const DOOM_HELP_MAX_SKILLS = 64;
-const DOOM_HELP_MAX_DIAGNOSTICS = 64;
-const DOOM_HELP_MAX_DESCRIPTION_LENGTH = 512;
-const DOOM_HELP_MAX_DIAGNOSTIC_LENGTH = 512;
+const PO_HELP_MAX_CONTRIBUTORS = 32;
+const PO_HELP_MAX_SKILLS = 64;
+const PO_HELP_MAX_DIAGNOSTICS = 64;
+const PO_HELP_MAX_DESCRIPTION_LENGTH = 512;
+const PO_HELP_MAX_DIAGNOSTIC_LENGTH = 512;
 const MAX_SOURCE_LENGTH = 128;
 const MAX_SKILL_NAME_LENGTH = 64;
 const MAX_MODULE_URL_LENGTH = 4096;
 const MAX_IDENTIFIER_LENGTH = 256;
-const DOOM_HELP_ERROR_CODE = {
+const PO_HELP_ERROR_CODE = {
 	contributorLimit: "HELP_CONTRIBUTOR_LIMIT",
 	disposed: "HELP_DISPOSED",
 	duplicateSkill: "HELP_DUPLICATE_SKILL",
@@ -28,38 +28,38 @@ const DOOM_HELP_ERROR_CODE = {
 	invalidGeneration: "HELP_INVALID_GENERATION",
 	invalidSnapshot: "HELP_INVALID_SNAPSHOT"
 };
-var DoomHelpError = class extends Error {
+var PoHelpError = class extends Error {
 	code;
 	constructor(code, message) {
 		super(message);
-		this.name = "DoomHelpError";
+		this.name = "PoHelpError";
 		this.code = code;
 	}
 };
-const DoomHelpSourceSchema = typebox.Type.String({
+const PoHelpSourceSchema = typebox.Type.String({
 	minLength: 1,
 	maxLength: MAX_SOURCE_LENGTH,
 	pattern: "^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$"
 });
-const DoomHelpSkillNameSchema = typebox.Type.String({
+const PoHelpSkillNameSchema = typebox.Type.String({
 	minLength: 1,
 	maxLength: MAX_SKILL_NAME_LENGTH,
 	pattern: "^[a-z0-9][a-z0-9-]*$"
 });
-const DoomHelpSkillDescriptorSchema = typebox.Type.Object({
-	name: DoomHelpSkillNameSchema,
+const PoHelpSkillDescriptorSchema = typebox.Type.Object({
+	name: PoHelpSkillNameSchema,
 	description: typebox.Type.String({
 		minLength: 1,
 		maxLength: 512
 	})
 }, { additionalProperties: false });
-const DoomHelpContributionSchema = typebox.Type.Object({
-	source: DoomHelpSourceSchema,
+const PoHelpContributionSchema = typebox.Type.Object({
+	source: PoHelpSourceSchema,
 	moduleUrl: typebox.Type.String({
 		minLength: 1,
 		maxLength: MAX_MODULE_URL_LENGTH
 	}),
-	skills: typebox.Type.Array(DoomHelpSkillDescriptorSchema, {
+	skills: typebox.Type.Array(PoHelpSkillDescriptorSchema, {
 		minItems: 1,
 		maxItems: 64
 	})
@@ -68,15 +68,15 @@ const GenerationSchema = typebox.Type.String({
 	minLength: 1,
 	maxLength: MAX_IDENTIFIER_LENGTH
 });
-const DoomHelpActivationSchema = typebox.Type.Union([
+const PoHelpActivationSchema = typebox.Type.Union([
 	typebox.Type.Literal("inactive"),
 	typebox.Type.Literal("activating"),
 	typebox.Type.Literal("active"),
 	typebox.Type.Literal("degraded")
 ]);
-const DoomHelpSkillSchema = typebox.Type.Object({
-	source: DoomHelpSourceSchema,
-	name: DoomHelpSkillNameSchema,
+const PoHelpSkillSchema = typebox.Type.Object({
+	source: PoHelpSourceSchema,
+	name: PoHelpSkillNameSchema,
 	description: typebox.Type.String({
 		minLength: 1,
 		maxLength: 512
@@ -90,8 +90,8 @@ const DoomHelpSkillSchema = typebox.Type.Object({
 		maxLength: MAX_MODULE_URL_LENGTH
 	})
 }, { additionalProperties: false });
-const DoomHelpDiagnosticSchema = typebox.Type.Object({
-	source: typebox.Type.Optional(DoomHelpSourceSchema),
+const PoHelpDiagnosticSchema = typebox.Type.Object({
+	source: typebox.Type.Optional(PoHelpSourceSchema),
 	code: typebox.Type.String({
 		minLength: 1,
 		maxLength: 64,
@@ -102,12 +102,12 @@ const DoomHelpDiagnosticSchema = typebox.Type.Object({
 		maxLength: 512
 	})
 }, { additionalProperties: false });
-const DoomHelpSnapshotSchema = typebox.Type.Object({
+const PoHelpSnapshotSchema = typebox.Type.Object({
 	hostGeneration: GenerationSchema,
 	revision: typebox.Type.Integer({ minimum: 0 }),
-	activation: DoomHelpActivationSchema,
-	skills: typebox.Type.Array(DoomHelpSkillSchema, { maxItems: 64 }),
-	diagnostics: typebox.Type.Array(DoomHelpDiagnosticSchema, { maxItems: 64 })
+	activation: PoHelpActivationSchema,
+	skills: typebox.Type.Array(PoHelpSkillSchema, { maxItems: 64 }),
+	diagnostics: typebox.Type.Array(PoHelpDiagnosticSchema, { maxItems: 64 })
 }, { additionalProperties: false });
 function schemaFailure(schema, value) {
 	const [first] = (0, typebox_value.Errors)(schema, value);
@@ -128,17 +128,17 @@ function cloneSnapshot(snapshot) {
 	};
 }
 function validateContribution(contribution) {
-	if (!(0, typebox_value.Check)(DoomHelpContributionSchema, contribution)) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.invalidContribution, `Invalid Help contribution${schemaFailure(DoomHelpContributionSchema, contribution)}.`);
+	if (!(0, typebox_value.Check)(PoHelpContributionSchema, contribution)) throw new PoHelpError(PO_HELP_ERROR_CODE.invalidContribution, `Invalid Help contribution${schemaFailure(PoHelpContributionSchema, contribution)}.`);
 	const names = /* @__PURE__ */ new Set();
 	for (const skill of contribution.skills) {
-		if (names.has(skill.name)) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.duplicateSkill, `Help contribution '${contribution.source}' declares duplicate skill '${skill.name}'.`);
+		if (names.has(skill.name)) throw new PoHelpError(PO_HELP_ERROR_CODE.duplicateSkill, `Help contribution '${contribution.source}' declares duplicate skill '${skill.name}'.`);
 		names.add(skill.name);
 	}
 	return cloneContribution(contribution);
 }
 /** Creates the provider-owned Help service value for one Cordis session. */
-function createDoomHelpService(generation) {
-	if (!(0, typebox_value.Check)(GenerationSchema, generation)) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.invalidGeneration, "Doom Help requires a valid generation.");
+function createPoHelpService(generation) {
+	if (!(0, typebox_value.Check)(GenerationSchema, generation)) throw new PoHelpError(PO_HELP_ERROR_CODE.invalidGeneration, "Po Help requires a valid generation.");
 	const contributions = /* @__PURE__ */ new Map();
 	const contributionListeners = /* @__PURE__ */ new Set();
 	const snapshotListeners = /* @__PURE__ */ new Set();
@@ -153,7 +153,7 @@ function createDoomHelpService(generation) {
 		diagnostics: []
 	};
 	const ensureActive = () => {
-		if (disposed) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.disposed, "The Doom Help service is disposed.");
+		if (disposed) throw new PoHelpError(PO_HELP_ERROR_CODE.disposed, "The Po Help service is disposed.");
 	};
 	const list = () => [...contributions.values()].map(({ contribution }) => cloneContribution(contribution)).sort((left, right) => left.source.localeCompare(right.source));
 	const notifyContributions = () => {
@@ -165,7 +165,7 @@ function createDoomHelpService(generation) {
 		register(contribution) {
 			ensureActive();
 			const validated = validateContribution(contribution);
-			if (!contributions.has(validated.source) && contributions.size >= 32) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.contributorLimit, `Help accepts at most 32 contributors.`);
+			if (!contributions.has(validated.source) && contributions.size >= 32) throw new PoHelpError(PO_HELP_ERROR_CODE.contributorLimit, `Help accepts at most 32 contributors.`);
 			registrationSequence += 1;
 			const token = Symbol(validated.source);
 			const registrationGeneration = `${generation}:help:${registrationSequence}`;
@@ -197,7 +197,7 @@ function createDoomHelpService(generation) {
 		getSnapshot: () => cloneSnapshot(snapshot),
 		publish(draft) {
 			ensureActive();
-			if (draft.activation === "inactive" && draft.skills.length > 0) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.inactiveSnapshot, "Inactive Help snapshots cannot expose skills.");
+			if (draft.activation === "inactive" && draft.skills.length > 0) throw new PoHelpError(PO_HELP_ERROR_CODE.inactiveSnapshot, "Inactive Help snapshots cannot expose skills.");
 			const next = {
 				hostGeneration: generation,
 				revision: snapshot.revision + 1,
@@ -205,7 +205,7 @@ function createDoomHelpService(generation) {
 				skills: draft.skills.map((skill) => ({ ...skill })),
 				diagnostics: draft.diagnostics.map((diagnostic) => ({ ...diagnostic }))
 			};
-			if (!(0, typebox_value.Check)(DoomHelpSnapshotSchema, next)) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.invalidSnapshot, `Invalid Help snapshot${schemaFailure(DoomHelpSnapshotSchema, next)}.`);
+			if (!(0, typebox_value.Check)(PoHelpSnapshotSchema, next)) throw new PoHelpError(PO_HELP_ERROR_CODE.invalidSnapshot, `Invalid Help snapshot${schemaFailure(PoHelpSnapshotSchema, next)}.`);
 			snapshot = next;
 			const published = cloneSnapshot(snapshot);
 			for (const listener of snapshotListeners) listener(cloneSnapshot(published));
@@ -248,34 +248,34 @@ function createDoomHelpService(generation) {
 		}
 	});
 }
-function readDoomHelpService(context) {
-	return context.get(DOOM_HELP_SERVICE);
+function readPoHelpService(context) {
+	return context.get(PO_HELP_SERVICE);
 }
-function requireDoomHelpService(context) {
-	const service = readDoomHelpService(context);
-	if (!service) throw new Error("Doom Help is unavailable. Load @agimon-ai/po-help.");
+function requirePoHelpService(context) {
+	const service = readPoHelpService(context);
+	if (!service) throw new Error("Po Help is unavailable. Load @agimon-ai/po-help.");
 	return service;
 }
 //#endregion
-exports.DOOM_HELP_ERROR_CODE = DOOM_HELP_ERROR_CODE;
-exports.DOOM_HELP_MAX_CONTRIBUTORS = DOOM_HELP_MAX_CONTRIBUTORS;
-exports.DOOM_HELP_MAX_DESCRIPTION_LENGTH = DOOM_HELP_MAX_DESCRIPTION_LENGTH;
-exports.DOOM_HELP_MAX_DIAGNOSTICS = DOOM_HELP_MAX_DIAGNOSTICS;
-exports.DOOM_HELP_MAX_DIAGNOSTIC_LENGTH = DOOM_HELP_MAX_DIAGNOSTIC_LENGTH;
-exports.DOOM_HELP_MAX_SKILLS = DOOM_HELP_MAX_SKILLS;
-exports.DOOM_HELP_SERVICE = DOOM_HELP_SERVICE;
-exports.DOOM_HELP_WHEN = DOOM_HELP_WHEN;
-exports.DoomHelpActivationSchema = DoomHelpActivationSchema;
-exports.DoomHelpContributionSchema = DoomHelpContributionSchema;
-exports.DoomHelpDiagnosticSchema = DoomHelpDiagnosticSchema;
-exports.DoomHelpError = DoomHelpError;
-exports.DoomHelpSkillDescriptorSchema = DoomHelpSkillDescriptorSchema;
-exports.DoomHelpSkillNameSchema = DoomHelpSkillNameSchema;
-exports.DoomHelpSkillSchema = DoomHelpSkillSchema;
-exports.DoomHelpSnapshotSchema = DoomHelpSnapshotSchema;
-exports.DoomHelpSourceSchema = DoomHelpSourceSchema;
-exports.createDoomHelpService = createDoomHelpService;
-exports.readDoomHelpService = readDoomHelpService;
-exports.requireDoomHelpService = requireDoomHelpService;
+exports.PO_HELP_ERROR_CODE = PO_HELP_ERROR_CODE;
+exports.PO_HELP_MAX_CONTRIBUTORS = PO_HELP_MAX_CONTRIBUTORS;
+exports.PO_HELP_MAX_DESCRIPTION_LENGTH = PO_HELP_MAX_DESCRIPTION_LENGTH;
+exports.PO_HELP_MAX_DIAGNOSTICS = PO_HELP_MAX_DIAGNOSTICS;
+exports.PO_HELP_MAX_DIAGNOSTIC_LENGTH = PO_HELP_MAX_DIAGNOSTIC_LENGTH;
+exports.PO_HELP_MAX_SKILLS = PO_HELP_MAX_SKILLS;
+exports.PO_HELP_SERVICE = PO_HELP_SERVICE;
+exports.PO_HELP_WHEN = PO_HELP_WHEN;
+exports.PoHelpActivationSchema = PoHelpActivationSchema;
+exports.PoHelpContributionSchema = PoHelpContributionSchema;
+exports.PoHelpDiagnosticSchema = PoHelpDiagnosticSchema;
+exports.PoHelpError = PoHelpError;
+exports.PoHelpSkillDescriptorSchema = PoHelpSkillDescriptorSchema;
+exports.PoHelpSkillNameSchema = PoHelpSkillNameSchema;
+exports.PoHelpSkillSchema = PoHelpSkillSchema;
+exports.PoHelpSnapshotSchema = PoHelpSnapshotSchema;
+exports.PoHelpSourceSchema = PoHelpSourceSchema;
+exports.createPoHelpService = createPoHelpService;
+exports.readPoHelpService = readPoHelpService;
+exports.requirePoHelpService = requirePoHelpService;
 
 //# sourceMappingURL=help.cjs.map

package/dist/src/schemas/help.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"help.cjs","names":["Type","Errors","Check"],"sources":["../../../src/schemas/help.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport { type Static, Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\n/** Provider-owned Cordis service for the live Help catalog. */\nexport const DOOM_HELP_SERVICE = 'doom/help';\nexport const DOOM_HELP_WHEN = {\n  state: { 'minor-mode': 'help' },\n  attribution: { kind: 'minor', mode: 'help' },\n} as const;\nexport const DOOM_HELP_MAX_CONTRIBUTORS = 32;\nexport const DOOM_HELP_MAX_SKILLS = 64;\nexport const DOOM_HELP_MAX_DIAGNOSTICS = 64;\nexport const DOOM_HELP_MAX_DESCRIPTION_LENGTH = 512;\nexport const DOOM_HELP_MAX_DIAGNOSTIC_LENGTH = 512;\n\nconst MAX_SOURCE_LENGTH = 128;\nconst MAX_SKILL_NAME_LENGTH = 64;\nconst MAX_MODULE_URL_LENGTH = 4_096;\nconst MAX_IDENTIFIER_LENGTH = 256;\n\nexport const DOOM_HELP_ERROR_CODE = {\n  contributorLimit: 'HELP_CONTRIBUTOR_LIMIT',\n  disposed: 'HELP_DISPOSED',\n  duplicateSkill: 'HELP_DUPLICATE_SKILL',\n  inactiveSnapshot: 'HELP_INACTIVE_SNAPSHOT',\n  invalidContribution: 'HELP_INVALID_CONTRIBUTION',\n  invalidGeneration: 'HELP_INVALID_GENERATION',\n  invalidSnapshot: 'HELP_INVALID_SNAPSHOT',\n} as const;\n\nexport type DoomHelpErrorCode = (typeof DOOM_HELP_ERROR_CODE)[keyof typeof DOOM_HELP_ERROR_CODE];\n\nexport class DoomHelpError extends Error {\n  readonly code: DoomHelpErrorCode;\n\n  constructor(code: DoomHelpErrorCode, message: string) {\n    super(message);\n    this.name = 'DoomHelpError';\n    this.code = code;\n  }\n}\n\nexport const DoomHelpSourceSchema = Type.String({\n  minLength: 1,\n  maxLength: MAX_SOURCE_LENGTH,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const DoomHelpSkillNameSchema = Type.String({\n  minLength: 1,\n  maxLength: MAX_SKILL_NAME_LENGTH,\n  pattern: '^[a-z0-9][a-z0-9-]*$',\n});\n\nexport const DoomHelpSkillDescriptorSchema = Type.Object(\n  {\n    name: DoomHelpSkillNameSchema,\n    description: Type.String({ minLength: 1, maxLength: DOOM_HELP_MAX_DESCRIPTION_LENGTH }),\n  },\n  { additionalProperties: false },\n);\nexport type DoomHelpSkillDescriptor = Static<typeof DoomHelpSkillDescriptorSchema>;\n\nexport const DoomHelpContributionSchema = Type.Object(\n  {\n    source: DoomHelpSourceSchema,\n    moduleUrl: Type.String({ minLength: 1, maxLength: MAX_MODULE_URL_LENGTH }),\n    skills: Type.Array(DoomHelpSkillDescriptorSchema, { minItems: 1, maxItems: DOOM_HELP_MAX_SKILLS }),\n  },\n  { additionalProperties: false },\n);\nexport type DoomHelpContribution = Static<typeof DoomHelpContributionSchema>;\n\nconst GenerationSchema = Type.String({ minLength: 1, maxLength: MAX_IDENTIFIER_LENGTH });\n\nexport const DoomHelpActivationSchema = Type.Union([\n  Type.Literal('inactive'),\n  Type.Literal('activating'),\n  Type.Literal('active'),\n  Type.Literal('degraded'),\n]);\nexport type DoomHelpActivation = Static<typeof DoomHelpActivationSchema>;\n\nexport const DoomHelpSkillSchema = Type.Object(\n  {\n    source: DoomHelpSourceSchema,\n    name: DoomHelpSkillNameSchema,\n    description: Type.String({ minLength: 1, maxLength: DOOM_HELP_MAX_DESCRIPTION_LENGTH }),\n    filePath: Type.String({ minLength: 1, maxLength: MAX_MODULE_URL_LENGTH }),\n    baseDir: Type.String({ minLength: 1, maxLength: MAX_MODULE_URL_LENGTH }),\n  },\n  { additionalProperties: false },\n);\nexport type DoomHelpSkill = Static<typeof DoomHelpSkillSchema>;\n\nexport const DoomHelpDiagnosticSchema = Type.Object(\n  {\n    source: Type.Optional(DoomHelpSourceSchema),\n    code: Type.String({ minLength: 1, maxLength: 64, pattern: '^[A-Z0-9_]+$' }),\n    message: Type.String({ minLength: 1, maxLength: DOOM_HELP_MAX_DIAGNOSTIC_LENGTH }),\n  },\n  { additionalProperties: false },\n);\nexport type DoomHelpDiagnostic = Static<typeof DoomHelpDiagnosticSchema>;\n\nexport const DoomHelpSnapshotSchema = Type.Object(\n  {\n    hostGeneration: GenerationSchema,\n    revision: Type.Integer({ minimum: 0 }),\n    activation: DoomHelpActivationSchema,\n    skills: Type.Array(DoomHelpSkillSchema, { maxItems: DOOM_HELP_MAX_SKILLS }),\n    diagnostics: Type.Array(DoomHelpDiagnosticSchema, { maxItems: DOOM_HELP_MAX_DIAGNOSTICS }),\n  },\n  { additionalProperties: false },\n);\nexport type DoomHelpSnapshot = Static<typeof DoomHelpSnapshotSchema>;\n\nexport interface DoomHelpSnapshotDraft {\n  readonly activation: DoomHelpActivation;\n  readonly skills: readonly DoomHelpSkill[];\n  readonly diagnostics: readonly DoomHelpDiagnostic[];\n}\n\nexport interface DoomHelpContributionHandle {\n  readonly source: string;\n  readonly generation: string;\n  dispose(): void;\n}\n\n/** Direct, session-local registrar and query surface owned by po-help. */\nexport interface DoomHelpService {\n  readonly generation: string;\n  register(contribution: DoomHelpContribution): DoomHelpContributionHandle;\n  listContributions(): readonly DoomHelpContribution[];\n  subscribeContributions(listener: (contributions: readonly DoomHelpContribution[]) => void): () => void;\n  getSnapshot(): DoomHelpSnapshot;\n  publish(snapshot: DoomHelpSnapshotDraft): DoomHelpSnapshot;\n  subscribeSnapshot(listener: (snapshot: DoomHelpSnapshot) => void): () => void;\n  /** Bind the skill consumer's accepted file paths, without duplicating its inventory. */\n  bindSkillInventory(read: () => Promise<readonly string[] | undefined>): () => void;\n  /** Accepted Help skills, or undefined while the consumer is absent, discovering, or superseded. */\n  inspectSkills(): Promise<readonly DoomHelpSkill[] | undefined>;\n  dispose(): void;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/help': DoomHelpService;\n  }\n}\n\ninterface RegisteredContribution {\n  readonly token: symbol;\n  readonly generation: string;\n  readonly contribution: DoomHelpContribution;\n}\n\nfunction schemaFailure(\n  schema: typeof DoomHelpContributionSchema | typeof DoomHelpSnapshotSchema,\n  value: unknown,\n): string {\n  const [first] = Errors(schema, value);\n  return first ? ` at ${first.instancePath || '/'}: ${first.message}` : '';\n}\n\nfunction cloneContribution(contribution: DoomHelpContribution): DoomHelpContribution {\n  return {\n    source: contribution.source,\n    moduleUrl: contribution.moduleUrl,\n    skills: contribution.skills.map((skill) => ({ ...skill })),\n  };\n}\n\nfunction cloneSnapshot(snapshot: DoomHelpSnapshot): DoomHelpSnapshot {\n  return {\n    ...snapshot,\n    skills: snapshot.skills.map((skill) => ({ ...skill })),\n    diagnostics: snapshot.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction validateContribution(contribution: DoomHelpContribution): DoomHelpContribution {\n  if (!Check(DoomHelpContributionSchema, contribution)) {\n    throw new DoomHelpError(\n      DOOM_HELP_ERROR_CODE.invalidContribution,\n      `Invalid Help contribution${schemaFailure(DoomHelpContributionSchema, contribution)}.`,\n    );\n  }\n  const names = new Set<string>();\n  for (const skill of contribution.skills) {\n    if (names.has(skill.name)) {\n      throw new DoomHelpError(\n        DOOM_HELP_ERROR_CODE.duplicateSkill,\n        `Help contribution '${contribution.source}' declares duplicate skill '${skill.name}'.`,\n      );\n    }\n    names.add(skill.name);\n  }\n  return cloneContribution(contribution);\n}\n\n/** Creates the provider-owned Help service value for one Cordis session. */\nexport function createDoomHelpService(generation: string): DoomHelpService {\n  if (!Check(GenerationSchema, generation)) {\n    throw new DoomHelpError(DOOM_HELP_ERROR_CODE.invalidGeneration, 'Doom Help requires a valid generation.');\n  }\n\n  const contributions = new Map<string, RegisteredContribution>();\n  const contributionListeners = new Set<(value: readonly DoomHelpContribution[]) => void>();\n  const snapshotListeners = new Set<(value: DoomHelpSnapshot) => void>();\n  let registrationSequence = 0;\n  let disposed = false;\n  let skillInventory: { token: symbol; read: () => Promise<readonly string[] | undefined> } | undefined;\n  let snapshot: DoomHelpSnapshot = {\n    hostGeneration: generation,\n    revision: 0,\n    activation: 'inactive',\n    skills: [],\n    diagnostics: [],\n  };\n\n  const ensureActive = (): void => {\n    if (disposed) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.disposed, 'The Doom Help service is disposed.');\n  };\n  const list = (): readonly DoomHelpContribution[] =>\n    [...contributions.values()]\n      .map(({ contribution }) => cloneContribution(contribution))\n      .sort((left, right) => left.source.localeCompare(right.source));\n  const notifyContributions = (): void => {\n    const value = list();\n    for (const listener of contributionListeners) listener(value);\n  };\n\n  const service: DoomHelpService = {\n    generation,\n    register(contribution) {\n      ensureActive();\n      const validated = validateContribution(contribution);\n      if (!contributions.has(validated.source) && contributions.size >= DOOM_HELP_MAX_CONTRIBUTORS) {\n        throw new DoomHelpError(\n          DOOM_HELP_ERROR_CODE.contributorLimit,\n          `Help accepts at most ${DOOM_HELP_MAX_CONTRIBUTORS} contributors.`,\n        );\n      }\n      registrationSequence += 1;\n      const token = Symbol(validated.source);\n      const registrationGeneration = `${generation}:help:${registrationSequence}`;\n      contributions.set(validated.source, {\n        token,\n        generation: registrationGeneration,\n        contribution: validated,\n      });\n      notifyContributions();\n      let registrationDisposed = false;\n      return Object.freeze({\n        source: validated.source,\n        generation: registrationGeneration,\n        dispose() {\n          if (registrationDisposed) return;\n          registrationDisposed = true;\n          if (contributions.get(validated.source)?.token !== token) return;\n          contributions.delete(validated.source);\n          notifyContributions();\n        },\n      });\n    },\n    listContributions: list,\n    subscribeContributions(listener) {\n      ensureActive();\n      contributionListeners.add(listener);\n      return () => contributionListeners.delete(listener);\n    },\n    getSnapshot: () => cloneSnapshot(snapshot),\n    publish(draft) {\n      ensureActive();\n      if (draft.activation === 'inactive' && draft.skills.length > 0) {\n        throw new DoomHelpError(DOOM_HELP_ERROR_CODE.inactiveSnapshot, 'Inactive Help snapshots cannot expose skills.');\n      }\n      const next: DoomHelpSnapshot = {\n        hostGeneration: generation,\n        revision: snapshot.revision + 1,\n        activation: draft.activation,\n        skills: draft.skills.map((skill) => ({ ...skill })),\n        diagnostics: draft.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n      };\n      if (!Check(DoomHelpSnapshotSchema, next)) {\n        throw new DoomHelpError(\n          DOOM_HELP_ERROR_CODE.invalidSnapshot,\n          `Invalid Help snapshot${schemaFailure(DoomHelpSnapshotSchema, next)}.`,\n        );\n      }\n      snapshot = next;\n      const published = cloneSnapshot(snapshot);\n      for (const listener of snapshotListeners) listener(cloneSnapshot(published));\n      return published;\n    },\n    subscribeSnapshot(listener) {\n      ensureActive();\n      snapshotListeners.add(listener);\n      return () => snapshotListeners.delete(listener);\n    },\n    bindSkillInventory(read) {\n      ensureActive();\n      const token = Symbol('help-skill-inventory');\n      skillInventory = { token, read };\n      return () => {\n        if (skillInventory?.token === token) skillInventory = undefined;\n      };\n    },\n    async inspectSkills() {\n      if (disposed) return undefined;\n      if (snapshot.activation === 'inactive') return [];\n      const reader = skillInventory;\n      if (!reader) return undefined;\n      const revision = snapshot.revision;\n      const paths = await reader.read();\n      if (disposed || reader !== skillInventory || revision !== snapshot.revision || paths === undefined)\n        return undefined;\n      const accepted = new Set(paths);\n      return snapshot.skills.filter((skill) => accepted.has(skill.filePath)).map((skill) => ({ ...skill }));\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      skillInventory = undefined;\n      contributions.clear();\n      contributionListeners.clear();\n      snapshotListeners.clear();\n    },\n  };\n  return Object.freeze(service);\n}\n\nexport function readDoomHelpService(context: Context): DoomHelpService | undefined {\n  return context.get(DOOM_HELP_SERVICE) as DoomHelpService | undefined;\n}\n\nexport function requireDoomHelpService(context: Context): DoomHelpService {\n  const service = readDoomHelpService(context);\n  if (!service) throw new Error('Doom Help is unavailable. Load @agimon-ai/po-help.');\n  return service;\n}\n"],"mappings":"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"}
+{"version":3,"file":"help.cjs","names":["Type","Errors","Check"],"sources":["../../../src/schemas/help.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport { type Static, Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\n/** Provider-owned Cordis service for the live Help catalog. */\nexport const PO_HELP_SERVICE = 'po/help';\nexport const PO_HELP_WHEN = {\n  state: { 'minor-mode': 'help' },\n  attribution: { kind: 'minor', mode: 'help' },\n} as const;\nexport const PO_HELP_MAX_CONTRIBUTORS = 32;\nexport const PO_HELP_MAX_SKILLS = 64;\nexport const PO_HELP_MAX_DIAGNOSTICS = 64;\nexport const PO_HELP_MAX_DESCRIPTION_LENGTH = 512;\nexport const PO_HELP_MAX_DIAGNOSTIC_LENGTH = 512;\n\nconst MAX_SOURCE_LENGTH = 128;\nconst MAX_SKILL_NAME_LENGTH = 64;\nconst MAX_MODULE_URL_LENGTH = 4_096;\nconst MAX_IDENTIFIER_LENGTH = 256;\n\nexport const PO_HELP_ERROR_CODE = {\n  contributorLimit: 'HELP_CONTRIBUTOR_LIMIT',\n  disposed: 'HELP_DISPOSED',\n  duplicateSkill: 'HELP_DUPLICATE_SKILL',\n  inactiveSnapshot: 'HELP_INACTIVE_SNAPSHOT',\n  invalidContribution: 'HELP_INVALID_CONTRIBUTION',\n  invalidGeneration: 'HELP_INVALID_GENERATION',\n  invalidSnapshot: 'HELP_INVALID_SNAPSHOT',\n} as const;\n\nexport type PoHelpErrorCode = (typeof PO_HELP_ERROR_CODE)[keyof typeof PO_HELP_ERROR_CODE];\n\nexport class PoHelpError extends Error {\n  readonly code: PoHelpErrorCode;\n\n  constructor(code: PoHelpErrorCode, message: string) {\n    super(message);\n    this.name = 'PoHelpError';\n    this.code = code;\n  }\n}\n\nexport const PoHelpSourceSchema = Type.String({\n  minLength: 1,\n  maxLength: MAX_SOURCE_LENGTH,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const PoHelpSkillNameSchema = Type.String({\n  minLength: 1,\n  maxLength: MAX_SKILL_NAME_LENGTH,\n  pattern: '^[a-z0-9][a-z0-9-]*$',\n});\n\nexport const PoHelpSkillDescriptorSchema = Type.Object(\n  {\n    name: PoHelpSkillNameSchema,\n    description: Type.String({ minLength: 1, maxLength: PO_HELP_MAX_DESCRIPTION_LENGTH }),\n  },\n  { additionalProperties: false },\n);\nexport type PoHelpSkillDescriptor = Static<typeof PoHelpSkillDescriptorSchema>;\n\nexport const PoHelpContributionSchema = Type.Object(\n  {\n    source: PoHelpSourceSchema,\n    moduleUrl: Type.String({ minLength: 1, maxLength: MAX_MODULE_URL_LENGTH }),\n    skills: Type.Array(PoHelpSkillDescriptorSchema, { minItems: 1, maxItems: PO_HELP_MAX_SKILLS }),\n  },\n  { additionalProperties: false },\n);\nexport type PoHelpContribution = Static<typeof PoHelpContributionSchema>;\n\nconst GenerationSchema = Type.String({ minLength: 1, maxLength: MAX_IDENTIFIER_LENGTH });\n\nexport const PoHelpActivationSchema = Type.Union([\n  Type.Literal('inactive'),\n  Type.Literal('activating'),\n  Type.Literal('active'),\n  Type.Literal('degraded'),\n]);\nexport type PoHelpActivation = Static<typeof PoHelpActivationSchema>;\n\nexport const PoHelpSkillSchema = Type.Object(\n  {\n    source: PoHelpSourceSchema,\n    name: PoHelpSkillNameSchema,\n    description: Type.String({ minLength: 1, maxLength: PO_HELP_MAX_DESCRIPTION_LENGTH }),\n    filePath: Type.String({ minLength: 1, maxLength: MAX_MODULE_URL_LENGTH }),\n    baseDir: Type.String({ minLength: 1, maxLength: MAX_MODULE_URL_LENGTH }),\n  },\n  { additionalProperties: false },\n);\nexport type PoHelpSkill = Static<typeof PoHelpSkillSchema>;\n\nexport const PoHelpDiagnosticSchema = Type.Object(\n  {\n    source: Type.Optional(PoHelpSourceSchema),\n    code: Type.String({ minLength: 1, maxLength: 64, pattern: '^[A-Z0-9_]+$' }),\n    message: Type.String({ minLength: 1, maxLength: PO_HELP_MAX_DIAGNOSTIC_LENGTH }),\n  },\n  { additionalProperties: false },\n);\nexport type PoHelpDiagnostic = Static<typeof PoHelpDiagnosticSchema>;\n\nexport const PoHelpSnapshotSchema = Type.Object(\n  {\n    hostGeneration: GenerationSchema,\n    revision: Type.Integer({ minimum: 0 }),\n    activation: PoHelpActivationSchema,\n    skills: Type.Array(PoHelpSkillSchema, { maxItems: PO_HELP_MAX_SKILLS }),\n    diagnostics: Type.Array(PoHelpDiagnosticSchema, { maxItems: PO_HELP_MAX_DIAGNOSTICS }),\n  },\n  { additionalProperties: false },\n);\nexport type PoHelpSnapshot = Static<typeof PoHelpSnapshotSchema>;\n\nexport interface PoHelpSnapshotDraft {\n  readonly activation: PoHelpActivation;\n  readonly skills: readonly PoHelpSkill[];\n  readonly diagnostics: readonly PoHelpDiagnostic[];\n}\n\nexport interface PoHelpContributionHandle {\n  readonly source: string;\n  readonly generation: string;\n  dispose(): void;\n}\n\n/** Direct, session-local registrar and query surface owned by po-help. */\nexport interface PoHelpService {\n  readonly generation: string;\n  register(contribution: PoHelpContribution): PoHelpContributionHandle;\n  listContributions(): readonly PoHelpContribution[];\n  subscribeContributions(listener: (contributions: readonly PoHelpContribution[]) => void): () => void;\n  getSnapshot(): PoHelpSnapshot;\n  publish(snapshot: PoHelpSnapshotDraft): PoHelpSnapshot;\n  subscribeSnapshot(listener: (snapshot: PoHelpSnapshot) => void): () => void;\n  /** Bind the skill consumer's accepted file paths, without duplicating its inventory. */\n  bindSkillInventory(read: () => Promise<readonly string[] | undefined>): () => void;\n  /** Accepted Help skills, or undefined while the consumer is absent, discovering, or superseded. */\n  inspectSkills(): Promise<readonly PoHelpSkill[] | undefined>;\n  dispose(): void;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/help': PoHelpService;\n  }\n}\n\ninterface RegisteredContribution {\n  readonly token: symbol;\n  readonly generation: string;\n  readonly contribution: PoHelpContribution;\n}\n\nfunction schemaFailure(schema: typeof PoHelpContributionSchema | typeof PoHelpSnapshotSchema, value: unknown): string {\n  const [first] = Errors(schema, value);\n  return first ? ` at ${first.instancePath || '/'}: ${first.message}` : '';\n}\n\nfunction cloneContribution(contribution: PoHelpContribution): PoHelpContribution {\n  return {\n    source: contribution.source,\n    moduleUrl: contribution.moduleUrl,\n    skills: contribution.skills.map((skill) => ({ ...skill })),\n  };\n}\n\nfunction cloneSnapshot(snapshot: PoHelpSnapshot): PoHelpSnapshot {\n  return {\n    ...snapshot,\n    skills: snapshot.skills.map((skill) => ({ ...skill })),\n    diagnostics: snapshot.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction validateContribution(contribution: PoHelpContribution): PoHelpContribution {\n  if (!Check(PoHelpContributionSchema, contribution)) {\n    throw new PoHelpError(\n      PO_HELP_ERROR_CODE.invalidContribution,\n      `Invalid Help contribution${schemaFailure(PoHelpContributionSchema, contribution)}.`,\n    );\n  }\n  const names = new Set<string>();\n  for (const skill of contribution.skills) {\n    if (names.has(skill.name)) {\n      throw new PoHelpError(\n        PO_HELP_ERROR_CODE.duplicateSkill,\n        `Help contribution '${contribution.source}' declares duplicate skill '${skill.name}'.`,\n      );\n    }\n    names.add(skill.name);\n  }\n  return cloneContribution(contribution);\n}\n\n/** Creates the provider-owned Help service value for one Cordis session. */\nexport function createPoHelpService(generation: string): PoHelpService {\n  if (!Check(GenerationSchema, generation)) {\n    throw new PoHelpError(PO_HELP_ERROR_CODE.invalidGeneration, 'Po Help requires a valid generation.');\n  }\n\n  const contributions = new Map<string, RegisteredContribution>();\n  const contributionListeners = new Set<(value: readonly PoHelpContribution[]) => void>();\n  const snapshotListeners = new Set<(value: PoHelpSnapshot) => void>();\n  let registrationSequence = 0;\n  let disposed = false;\n  let skillInventory: { token: symbol; read: () => Promise<readonly string[] | undefined> } | undefined;\n  let snapshot: PoHelpSnapshot = {\n    hostGeneration: generation,\n    revision: 0,\n    activation: 'inactive',\n    skills: [],\n    diagnostics: [],\n  };\n\n  const ensureActive = (): void => {\n    if (disposed) throw new PoHelpError(PO_HELP_ERROR_CODE.disposed, 'The Po Help service is disposed.');\n  };\n  const list = (): readonly PoHelpContribution[] =>\n    [...contributions.values()]\n      .map(({ contribution }) => cloneContribution(contribution))\n      .sort((left, right) => left.source.localeCompare(right.source));\n  const notifyContributions = (): void => {\n    const value = list();\n    for (const listener of contributionListeners) listener(value);\n  };\n\n  const service: PoHelpService = {\n    generation,\n    register(contribution) {\n      ensureActive();\n      const validated = validateContribution(contribution);\n      if (!contributions.has(validated.source) && contributions.size >= PO_HELP_MAX_CONTRIBUTORS) {\n        throw new PoHelpError(\n          PO_HELP_ERROR_CODE.contributorLimit,\n          `Help accepts at most ${PO_HELP_MAX_CONTRIBUTORS} contributors.`,\n        );\n      }\n      registrationSequence += 1;\n      const token = Symbol(validated.source);\n      const registrationGeneration = `${generation}:help:${registrationSequence}`;\n      contributions.set(validated.source, {\n        token,\n        generation: registrationGeneration,\n        contribution: validated,\n      });\n      notifyContributions();\n      let registrationDisposed = false;\n      return Object.freeze({\n        source: validated.source,\n        generation: registrationGeneration,\n        dispose() {\n          if (registrationDisposed) return;\n          registrationDisposed = true;\n          if (contributions.get(validated.source)?.token !== token) return;\n          contributions.delete(validated.source);\n          notifyContributions();\n        },\n      });\n    },\n    listContributions: list,\n    subscribeContributions(listener) {\n      ensureActive();\n      contributionListeners.add(listener);\n      return () => contributionListeners.delete(listener);\n    },\n    getSnapshot: () => cloneSnapshot(snapshot),\n    publish(draft) {\n      ensureActive();\n      if (draft.activation === 'inactive' && draft.skills.length > 0) {\n        throw new PoHelpError(PO_HELP_ERROR_CODE.inactiveSnapshot, 'Inactive Help snapshots cannot expose skills.');\n      }\n      const next: PoHelpSnapshot = {\n        hostGeneration: generation,\n        revision: snapshot.revision + 1,\n        activation: draft.activation,\n        skills: draft.skills.map((skill) => ({ ...skill })),\n        diagnostics: draft.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n      };\n      if (!Check(PoHelpSnapshotSchema, next)) {\n        throw new PoHelpError(\n          PO_HELP_ERROR_CODE.invalidSnapshot,\n          `Invalid Help snapshot${schemaFailure(PoHelpSnapshotSchema, next)}.`,\n        );\n      }\n      snapshot = next;\n      const published = cloneSnapshot(snapshot);\n      for (const listener of snapshotListeners) listener(cloneSnapshot(published));\n      return published;\n    },\n    subscribeSnapshot(listener) {\n      ensureActive();\n      snapshotListeners.add(listener);\n      return () => snapshotListeners.delete(listener);\n    },\n    bindSkillInventory(read) {\n      ensureActive();\n      const token = Symbol('help-skill-inventory');\n      skillInventory = { token, read };\n      return () => {\n        if (skillInventory?.token === token) skillInventory = undefined;\n      };\n    },\n    async inspectSkills() {\n      if (disposed) return undefined;\n      if (snapshot.activation === 'inactive') return [];\n      const reader = skillInventory;\n      if (!reader) return undefined;\n      const revision = snapshot.revision;\n      const paths = await reader.read();\n      if (disposed || reader !== skillInventory || revision !== snapshot.revision || paths === undefined)\n        return undefined;\n      const accepted = new Set(paths);\n      return snapshot.skills.filter((skill) => accepted.has(skill.filePath)).map((skill) => ({ ...skill }));\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      skillInventory = undefined;\n      contributions.clear();\n      contributionListeners.clear();\n      snapshotListeners.clear();\n    },\n  };\n  return Object.freeze(service);\n}\n\nexport function readPoHelpService(context: Context): PoHelpService | undefined {\n  return context.get(PO_HELP_SERVICE) as PoHelpService | undefined;\n}\n\nexport function requirePoHelpService(context: Context): PoHelpService {\n  const service = readPoHelpService(context);\n  if (!service) throw new Error('Po Help is unavailable. Load @agimon-ai/po-help.');\n  return service;\n}\n"],"mappings":"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"}

package/dist/src/schemas/help.d.mts

@@ -2,8 +2,8 @@ import { Static, Type } from "typebox";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/schemas/help.d.ts
 /** Provider-owned Cordis service for the live Help catalog. */
-export declare const DOOM_HELP_SERVICE = "doom/help";
-export declare const DOOM_HELP_WHEN: {
+export declare const PO_HELP_SERVICE = "po/help";
+export declare const PO_HELP_WHEN: {
   readonly state: {
     readonly 'minor-mode': 'help';
   };
@@ -12,12 +12,12 @@ export declare const DOOM_HELP_WHEN: {
     readonly mode: 'help';
   };
 };
-export declare const DOOM_HELP_MAX_CONTRIBUTORS = 32;
-export declare const DOOM_HELP_MAX_SKILLS = 64;
-export declare const DOOM_HELP_MAX_DIAGNOSTICS = 64;
-export declare const DOOM_HELP_MAX_DESCRIPTION_LENGTH = 512;
-export declare const DOOM_HELP_MAX_DIAGNOSTIC_LENGTH = 512;
-export declare const DOOM_HELP_ERROR_CODE: {
+export declare const PO_HELP_MAX_CONTRIBUTORS = 32;
+export declare const PO_HELP_MAX_SKILLS = 64;
+export declare const PO_HELP_MAX_DIAGNOSTICS = 64;
+export declare const PO_HELP_MAX_DESCRIPTION_LENGTH = 512;
+export declare const PO_HELP_MAX_DIAGNOSTIC_LENGTH = 512;
+export declare const PO_HELP_ERROR_CODE: {
   readonly contributorLimit: 'HELP_CONTRIBUTOR_LIMIT';
   readonly disposed: 'HELP_DISPOSED';
   readonly duplicateSkill: 'HELP_DUPLICATE_SKILL';
@@ -26,19 +26,19 @@ export declare const DOOM_HELP_ERROR_CODE: {
   readonly invalidGeneration: 'HELP_INVALID_GENERATION';
   readonly invalidSnapshot: 'HELP_INVALID_SNAPSHOT';
 };
-export type DoomHelpErrorCode = (typeof DOOM_HELP_ERROR_CODE)[keyof typeof DOOM_HELP_ERROR_CODE];
-export declare class DoomHelpError extends Error {
-  readonly code: DoomHelpErrorCode;
-  constructor(code: DoomHelpErrorCode, message: string);
+export type PoHelpErrorCode = (typeof PO_HELP_ERROR_CODE)[keyof typeof PO_HELP_ERROR_CODE];
+export declare class PoHelpError extends Error {
+  readonly code: PoHelpErrorCode;
+  constructor(code: PoHelpErrorCode, message: string);
 }
-export declare const DoomHelpSourceSchema: Type.TString;
-export declare const DoomHelpSkillNameSchema: Type.TString;
-export declare const DoomHelpSkillDescriptorSchema: Type.TObject<{
+export declare const PoHelpSourceSchema: Type.TString;
+export declare const PoHelpSkillNameSchema: Type.TString;
+export declare const PoHelpSkillDescriptorSchema: Type.TObject<{
   name: Type.TString;
   description: Type.TString;
 }>;
-export type DoomHelpSkillDescriptor = Static<typeof DoomHelpSkillDescriptorSchema>;
-export declare const DoomHelpContributionSchema: Type.TObject<{
+export type PoHelpSkillDescriptor = Static<typeof PoHelpSkillDescriptorSchema>;
+export declare const PoHelpContributionSchema: Type.TObject<{
   source: Type.TString;
   moduleUrl: Type.TString;
   skills: Type.TArray<Type.TObject<{
@@ -46,24 +46,24 @@ export declare const DoomHelpContributionSchema: Type.TObject<{
     description: Type.TString;
   }>>;
 }>;
-export type DoomHelpContribution = Static<typeof DoomHelpContributionSchema>;
-export declare const DoomHelpActivationSchema: Type.TUnion<[Type.TLiteral<"inactive">, Type.TLiteral<"activating">, Type.TLiteral<"active">, Type.TLiteral<"degraded">]>;
-export type DoomHelpActivation = Static<typeof DoomHelpActivationSchema>;
-export declare const DoomHelpSkillSchema: Type.TObject<{
+export type PoHelpContribution = Static<typeof PoHelpContributionSchema>;
+export declare const PoHelpActivationSchema: Type.TUnion<[Type.TLiteral<"inactive">, Type.TLiteral<"activating">, Type.TLiteral<"active">, Type.TLiteral<"degraded">]>;
+export type PoHelpActivation = Static<typeof PoHelpActivationSchema>;
+export declare const PoHelpSkillSchema: Type.TObject<{
   source: Type.TString;
   name: Type.TString;
   description: Type.TString;
   filePath: Type.TString;
   baseDir: Type.TString;
 }>;
-export type DoomHelpSkill = Static<typeof DoomHelpSkillSchema>;
-export declare const DoomHelpDiagnosticSchema: Type.TObject<{
+export type PoHelpSkill = Static<typeof PoHelpSkillSchema>;
+export declare const PoHelpDiagnosticSchema: Type.TObject<{
   source: Type.TOptional<Type.TString>;
   code: Type.TString;
   message: Type.TString;
 }>;
-export type DoomHelpDiagnostic = Static<typeof DoomHelpDiagnosticSchema>;
-export declare const DoomHelpSnapshotSchema: Type.TObject<{
+export type PoHelpDiagnostic = Static<typeof PoHelpDiagnosticSchema>;
+export declare const PoHelpSnapshotSchema: Type.TObject<{
   hostGeneration: Type.TString;
   revision: Type.TInteger;
   activation: Type.TUnion<[Type.TLiteral<"inactive">, Type.TLiteral<"activating">, Type.TLiteral<"active">, Type.TLiteral<"degraded">]>;
@@ -80,40 +80,40 @@ export declare const DoomHelpSnapshotSchema: Type.TObject<{
     message: Type.TString;
   }>>;
 }>;
-export type DoomHelpSnapshot = Static<typeof DoomHelpSnapshotSchema>;
-export interface DoomHelpSnapshotDraft {
-  readonly activation: DoomHelpActivation;
-  readonly skills: readonly DoomHelpSkill[];
-  readonly diagnostics: readonly DoomHelpDiagnostic[];
+export type PoHelpSnapshot = Static<typeof PoHelpSnapshotSchema>;
+export interface PoHelpSnapshotDraft {
+  readonly activation: PoHelpActivation;
+  readonly skills: readonly PoHelpSkill[];
+  readonly diagnostics: readonly PoHelpDiagnostic[];
 }
-export interface DoomHelpContributionHandle {
+export interface PoHelpContributionHandle {
   readonly source: string;
   readonly generation: string;
   dispose(): void;
 }
 /** Direct, session-local registrar and query surface owned by po-help. */
-export interface DoomHelpService {
+export interface PoHelpService {
   readonly generation: string;
-  register(contribution: DoomHelpContribution): DoomHelpContributionHandle;
-  listContributions(): readonly DoomHelpContribution[];
-  subscribeContributions(listener: (contributions: readonly DoomHelpContribution[]) => void): () => void;
-  getSnapshot(): DoomHelpSnapshot;
-  publish(snapshot: DoomHelpSnapshotDraft): DoomHelpSnapshot;
-  subscribeSnapshot(listener: (snapshot: DoomHelpSnapshot) => void): () => void;
+  register(contribution: PoHelpContribution): PoHelpContributionHandle;
+  listContributions(): readonly PoHelpContribution[];
+  subscribeContributions(listener: (contributions: readonly PoHelpContribution[]) => void): () => void;
+  getSnapshot(): PoHelpSnapshot;
+  publish(snapshot: PoHelpSnapshotDraft): PoHelpSnapshot;
+  subscribeSnapshot(listener: (snapshot: PoHelpSnapshot) => void): () => void;
   /** Bind the skill consumer's accepted file paths, without duplicating its inventory. */
   bindSkillInventory(read: () => Promise<readonly string[] | undefined>): () => void;
   /** Accepted Help skills, or undefined while the consumer is absent, discovering, or superseded. */
-  inspectSkills(): Promise<readonly DoomHelpSkill[] | undefined>;
+  inspectSkills(): Promise<readonly PoHelpSkill[] | undefined>;
   dispose(): void;
 }
 declare module '@deepseek-ai/cordis' {
   interface Context {
-    'doom/help': DoomHelpService;
+    'po/help': PoHelpService;
   }
 }
 /** Creates the provider-owned Help service value for one Cordis session. */
-export declare function createDoomHelpService(generation: string): DoomHelpService;
-export declare function readDoomHelpService(context: Context): DoomHelpService | undefined;
-export declare function requireDoomHelpService(context: Context): DoomHelpService;
+export declare function createPoHelpService(generation: string): PoHelpService;
+export declare function readPoHelpService(context: Context): PoHelpService | undefined;
+export declare function requirePoHelpService(context: Context): PoHelpService;
 //#endregion
 //# sourceMappingURL=help.d.mts.map

package/dist/src/schemas/help.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.mts","names":[],"sources":["../../../src/schemas/help.ts"],"mappings":";;;;qBAKa;qBACA;WACX;aAAS;;WACT;aAAe;aAAe;;;qBAEnB;qBACA;qBACA;qBACA;qBACA;qBAOA;WACX;WACA;WACA;WACA;WACA;WACA;WACA;;YAGU,4BAA4B,mCAAmC;qBAE9D,sBAAsB;WACxB,MAAM;EAEf,YAAY,MAAM,mBAAmB;;qBAO1B,sBAAoB,KAAA;qBAMpB,yBAAuB,KAAA;qBAMvB,+BAA6B,KAAA;;;;YAO9B,0BAA0B,cAAc;qBAEvC,4BAA0B,KAAA;;;;;;;;YAQ3B,uBAAuB,cAAc;qBAIpC,0BAAwB,KAAA,QAAA,KAAA,sBAAA,KAAA,wBAAA,KAAA,oBAAA,KAAA;YAMzB,qBAAqB,cAAc;qBAElC,qBAAmB,KAAA;;;;;;;YAUpB,gBAAgB,cAAc;qBAE7B,0BAAwB,KAAA;;;;;YAQzB,qBAAqB,cAAc;qBAElC,wBAAsB,KAAA;;;;;;;;;;;;;;;;;YAUvB,mBAAmB,cAAc;iBAE5B;WACN,YAAY;WACZ,iBAAiB;WACjB,sBAAsB;;iBAGhB;WACN;WACA;EACT;;;iBAIe;WACN;EACT,SAAS,cAAc,uBAAuB;EAC9C,8BAA8B;EAC9B,uBAAuB,WAAW,wBAAwB;EAC1D,eAAe;EACf,QAAQ,UAAU,wBAAwB;EAC1C,kBAAkB,WAAW,UAAU;;EAEvC,mBAAmB,YAAY;;EAE/B,iBAAiB,iBAAiB;EAClC;;;YAIU;IACR,aAAa;;;;wBAuDD,sBAAsB,qBAAqB;wBAmI3C,oBAAoB,SAAS,UAAU;wBAIvC,uBAAuB,SAAS,UAAU"}
+{"version":3,"file":"help.d.mts","names":[],"sources":["../../../src/schemas/help.ts"],"mappings":";;;;qBAKa;qBACA;WACX;aAAS;;WACT;aAAe;aAAe;;;qBAEnB;qBACA;qBACA;qBACA;qBACA;qBAOA;WACX;WACA;WACA;WACA;WACA;WACA;WACA;;YAGU,0BAA0B,iCAAiC;qBAE1D,oBAAoB;WACtB,MAAM;EAEf,YAAY,MAAM,iBAAiB;;qBAOxB,oBAAkB,KAAA;qBAMlB,uBAAqB,KAAA;qBAMrB,6BAA2B,KAAA;;;;YAO5B,wBAAwB,cAAc;qBAErC,0BAAwB,KAAA;;;;;;;;YAQzB,qBAAqB,cAAc;qBAIlC,wBAAsB,KAAA,QAAA,KAAA,sBAAA,KAAA,wBAAA,KAAA,oBAAA,KAAA;YAMvB,mBAAmB,cAAc;qBAEhC,mBAAiB,KAAA;;;;;;;YAUlB,cAAc,cAAc;qBAE3B,wBAAsB,KAAA;;;;;YAQvB,mBAAmB,cAAc;qBAEhC,sBAAoB,KAAA;;;;;;;;;;;;;;;;;YAUrB,iBAAiB,cAAc;iBAE1B;WACN,YAAY;WACZ,iBAAiB;WACjB,sBAAsB;;iBAGhB;WACN;WACA;EACT;;;iBAIe;WACN;EACT,SAAS,cAAc,qBAAqB;EAC5C,8BAA8B;EAC9B,uBAAuB,WAAW,wBAAwB;EAC1D,eAAe;EACf,QAAQ,UAAU,sBAAsB;EACxC,kBAAkB,WAAW,UAAU;;EAEvC,mBAAmB,YAAY;;EAE/B,iBAAiB,iBAAiB;EAClC;;;YAIU;IACR,WAAW;;;;wBAoDC,oBAAoB,qBAAqB;wBAmIzC,kBAAkB,SAAS,UAAU;wBAIrC,qBAAqB,SAAS,UAAU"}