@agimon-ai/doompi-core 0.0.1-alpha.100

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

@@ -0,0 +1 @@
+{"version":3,"file":"footer.mjs","names":[],"sources":["../../../src/schemas/footer.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const FooterTextColorSchema = Type.Union([\n  Type.Literal('accent'),\n  Type.Literal('mdCode'),\n  Type.Literal('toolDiffAdded'),\n  Type.Literal('warning'),\n  Type.Literal('mdHeading'),\n  Type.Literal('syntaxNumber'),\n  Type.Literal('muted'),\n  Type.Literal('dim'),\n]);\nexport type FooterTextColor = Static<typeof FooterTextColorSchema>;\n\nexport const FooterStatusPlacementSchema = Type.Union([Type.Literal('modeline'), Type.Literal('beforeModel')]);\nexport type FooterStatusPlacement = Static<typeof FooterStatusPlacementSchema>;\n\nexport const FooterTextSegmentSchema = Type.Object(\n  {\n    text: Type.String({ minLength: 1, maxLength: 80 }),\n    color: Type.Optional(FooterTextColorSchema),\n  },\n  { additionalProperties: false },\n);\nexport type FooterTextSegment = Static<typeof FooterTextSegmentSchema>;\n\nexport const FooterStatusItemSchema = Type.Object(\n  {\n    id: Type.String({ minLength: 1, maxLength: 128 }),\n    fullText: Type.String({ minLength: 1, maxLength: 80 }),\n    compactText: Type.String({ minLength: 1, maxLength: 24 }),\n    fullSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 80 })),\n    compactSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 24 })),\n    placement: Type.Optional(FooterStatusPlacementSchema),\n    order: Type.Integer({ minimum: 0, maximum: 1000 }),\n  },\n  { additionalProperties: false },\n);\nexport type FooterStatusItem = Static<typeof FooterStatusItemSchema>;\n\nexport interface DoomFooterContributionDefinition {\n  source: string;\n  id: string;\n  order: number;\n  placement?: FooterStatusPlacement;\n}\n\nexport interface DoomFooterContributionValue {\n  fullText: string;\n  compactText: string;\n  fullSegments?: FooterTextSegment[];\n  compactSegments?: FooterTextSegment[];\n}\n\nexport interface DoomFooterContributionHandle {\n  update(value: DoomFooterContributionValue | undefined): void;\n  dispose(): void;\n}\n\nexport interface DoomFooterStatus extends FooterStatusItem {\n  source: string;\n}\n"],"mappings":";;AAEA,MAAa,wBAAwB,KAAK,MAAM;CAC9C,KAAK,QAAQ,QAAQ;CACrB,KAAK,QAAQ,QAAQ;CACrB,KAAK,QAAQ,eAAe;CAC5B,KAAK,QAAQ,SAAS;CACtB,KAAK,QAAQ,WAAW;CACxB,KAAK,QAAQ,cAAc;CAC3B,KAAK,QAAQ,OAAO;CACpB,KAAK,QAAQ,KAAK;AACpB,CAAC;AAGD,MAAa,8BAA8B,KAAK,MAAM,CAAC,KAAK,QAAQ,UAAU,GAAG,KAAK,QAAQ,aAAa,CAAC,CAAC;AAG7G,MAAa,0BAA0B,KAAK,OAC1C;CACE,MAAM,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACjD,OAAO,KAAK,SAAS,qBAAqB;AAC5C,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,yBAAyB,KAAK,OACzC;CACE,IAAI,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAI,CAAC;CAChD,UAAU,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACrD,aAAa,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACxD,cAAc,KAAK,SAAS,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACjF,iBAAiB,KAAK,SAAS,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACpF,WAAW,KAAK,SAAS,2BAA2B;CACpD,OAAO,KAAK,QAAQ;EAAE,SAAS;EAAG,SAAS;CAAK,CAAC;AACnD,GACA,EAAE,sBAAsB,MAAM,CAChC"}

package/dist/src/schemas/headless.cjs

@@ -0,0 +1,44 @@
+//#region src/schemas/headless.ts
+/** Session-only contributions. This is not a Pi ExtensionAPI or a TUI adapter. */
+const DOOM_HEADLESS_HOST_SERVICE = "doom/headless-host";
+const DOOM_HEADLESS_OWNER = Symbol.for("doom/headless-owner");
+function readDoomHeadlessOwner(context) {
+	return context[DOOM_HEADLESS_OWNER];
+}
+/**
+* Narrows a Pi tool result to the headless contract. Pi types `structuredContent` as any JSON
+* value, while MCP only accepts an object, so anything else is dropped rather than forwarded.
+*/
+function toDoomHeadlessToolResult(result) {
+	const { structuredContent } = result;
+	return {
+		content: result.content,
+		details: result.details,
+		...typeof structuredContent === "object" && structuredContent !== null && !Array.isArray(structuredContent) ? { structuredContent } : {},
+		...result.isError === void 0 ? {} : { isError: result.isError }
+	};
+}
+/** Registrations inherit package ownership from the caller's Cordis facet. */
+/**
+* The tool a server session loads skills through. When a session carries it, the prompt lists
+* every skill by name and points here, so a skill needs no file the agent could read.
+*/
+const DOOM_LOAD_SKILL_TOOL = "load_skill";
+function readDoomHeadlessHost(context) {
+	return context.get(DOOM_HEADLESS_HOST_SERVICE);
+}
+function requireDoomHeadlessHost(context) {
+	const host = readDoomHeadlessHost(context);
+	if (!host) throw new Error("This contribution requires the Doom headless session host.");
+	return host;
+}
+//#endregion
+exports.DOOM_HEADLESS_HOST_SERVICE = DOOM_HEADLESS_HOST_SERVICE;
+exports.DOOM_HEADLESS_OWNER = DOOM_HEADLESS_OWNER;
+exports.DOOM_LOAD_SKILL_TOOL = DOOM_LOAD_SKILL_TOOL;
+exports.readDoomHeadlessHost = readDoomHeadlessHost;
+exports.readDoomHeadlessOwner = readDoomHeadlessOwner;
+exports.requireDoomHeadlessHost = requireDoomHeadlessHost;
+exports.toDoomHeadlessToolResult = toDoomHeadlessToolResult;
+
+//# sourceMappingURL=headless.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"headless.cjs","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 { 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\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  | { readonly axis: 'state'; readonly key: string; readonly values: readonly string[] };\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 isError?: boolean;\n}): DoomHeadlessToolResult {\n  const { structuredContent } = result;\n  return {\n    content: result.content,\n    details: result.details,\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  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  /**\n   * Delivers and awaits the turn. 'steer' and 'followUp' only enqueue into a running turn; they do\n   * NOT wake an idle agent.\n   */\n  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;\n  /**\n   * Resolves when accepted by the session, before the agent turn settles. Here 'steer' describes\n   * how to deliver IF a turn is already running; an idle agent is woken either way, matching Pi's\n   * ExtensionAPI.sendMessage({ triggerTurn: true, deliverAs: 'steer' }).\n   */\n  admitPrompt?(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): 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<{ kind: 'v4-fork'; sessionFile: string; branch: string; entryId?: string }>;\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\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?: { provider: string; id: string };\n  readonly textCompletion?: {\n    available(reference: string): boolean;\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  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?: {\n      resourceUri?: string;\n      visibility?: ('model' | 'app')[];\n    };\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  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_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  ? { lane: string; runId: string; model: { provider: string; id: string }; payload: unknown }\n  : E extends 'session_before_compact'\n    ? { reason: string; preparation: unknown; instructions?: string; customInstructions?: string }\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    ? { cancel?: boolean; decline?: boolean; compaction?: DoomHeadlessCompactionResult } | 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          ? { args?: Record<string, unknown>; block?: { reason: string; terminate?: boolean } } | 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\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  /** 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":";;AAUA,MAAa,6BAA6B;AAC1C,MAAa,sBAAsB,OAAO,IAAI,qBAAqB;AAkBnE,SAAgB,sBAAsB,SAAqD;CACzF,OAAQ,QAAwE;AAClF;;;;;AAsBA,SAAgB,yBAAyB,QAKd;CACzB,MAAM,EAAE,sBAAsB;CAC9B,OAAO;EACL,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,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;;;;;;AAiSA,MAAa,uBAAuB;AAyBpC,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"}

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

@@ -0,0 +1,370 @@
+import { DoomNotificationRequest } from "./notification.mjs";
+import { DoomSessionContext } from "./hubChannel.mjs";
+import { DoomServerBundleEntry } from "./serverBundle.mjs";
+import { Static, TSchema } from "typebox";
+import { Context } from "@deepseek-ai/cordis";
+import { ThinkingLevel } from "@earendil-works/pi-agent-core";
+import { CallToolResult, Tool } from "@modelcontextprotocol/server";
+//#region src/schemas/headless.d.ts
+/** Session-only contributions. This is not a Pi ExtensionAPI or a TUI adapter. */
+export declare const DOOM_HEADLESS_HOST_SERVICE = "doom/headless-host";
+export declare const DOOM_HEADLESS_OWNER: unique symbol;
+export interface DoomHeadlessSelection {
+  readonly majorMode: string;
+  readonly activeLayers: readonly string[];
+  readonly domains: readonly string[];
+  readonly profile?: string;
+  /** Feature-owned activation sets, keyed by the contributing capability. */
+  readonly state?: Readonly<Record<string, readonly string[]>>;
+}
+/** One package-owned selection transition. Server facets change exactly one axis per operation. */
+export type DoomHeadlessSelectionChange = {
+  readonly axis: 'majorMode';
+  readonly majorMode: string;
+} | {
+  readonly axis: 'domains';
+  readonly domains: readonly string[];
+} | {
+  readonly axis: 'profile';
+  readonly profile?: string;
+} | {
+  readonly axis: 'state';
+  readonly key: string;
+  readonly values: readonly string[];
+};
+export declare function readDoomHeadlessOwner(context: Context): DoomServerBundleEntry | undefined;
+export interface DoomHeadlessRegistration {
+  dispose(): void;
+}
+export type DoomHeadlessContent = {
+  type: 'text';
+  text: string;
+} | {
+  type: 'image';
+  data: string;
+  mimeType: string;
+};
+export interface DoomHeadlessToolResult {
+  content: DoomHeadlessContent[];
+  /** Public MCP result data. Internal renderer details are not a remote result contract. */
+  structuredContent?: Record<string, unknown>;
+  /** Component-only MCP metadata, never inferred from internal renderer details. */
+  _meta?: CallToolResult['_meta'];
+  details?: unknown;
+  isError?: boolean;
+}
+/**
+ * Narrows a Pi tool result to the headless contract. Pi types `structuredContent` as any JSON
+ * value, while MCP only accepts an object, so anything else is dropped rather than forwarded.
+ */
+export declare function toDoomHeadlessToolResult(result: {
+  readonly content: DoomHeadlessContent[];
+  readonly details?: unknown;
+  readonly structuredContent?: unknown;
+  readonly isError?: boolean;
+}): DoomHeadlessToolResult;
+export interface DoomHeadlessClientRequest {
+  kind: 'confirm' | 'select' | 'input';
+  title: string;
+  message?: string;
+  options?: readonly {
+    label: string;
+    description?: string;
+    value: string;
+  }[];
+  initialValue?: string;
+  multiline?: boolean;
+}
+export interface DoomHeadlessClient {
+  /**
+   * Operator-facing surface only: the body is flattened to one line and capped at 4096 characters
+   * by schemas/notification.ts:73-83, and the model never sees it. Use session.admitPrompt to
+   * reach the model.
+   */
+  notify(request: DoomNotificationRequest): void | Promise<void>;
+  request(request: DoomHeadlessClientRequest, signal?: AbortSignal): Promise<unknown>;
+  setStatus(source: string, text: string | undefined): void;
+  appendComposerText?(text: string): void;
+}
+export interface DoomHeadlessModelSettings {
+  model?: {
+    provider: string;
+    id: string;
+  };
+  thinkingLevel: ThinkingLevel;
+}
+export interface DoomHeadlessSession {
+  readModelSettings?(): Promise<DoomHeadlessModelSettings>;
+  setModelSettings?(settings: Partial<DoomHeadlessModelSettings>): Promise<void>;
+  /** Query durable history on demand; hosts do not retain the entire transcript. */
+  entries(query?: {
+    type?: 'custom' | 'message';
+    customType?: string;
+    limit?: number;
+  }): readonly Record<string, unknown>[] | Promise<readonly Record<string, unknown>[]>;
+  appendCustomEntry(type: string, data: unknown): Promise<void>;
+  /**
+   * Delivers and awaits the turn. 'steer' and 'followUp' only enqueue into a running turn; they do
+   * NOT wake an idle agent.
+   */
+  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;
+  /**
+   * Resolves when accepted by the session, before the agent turn settles. Here 'steer' describes
+   * how to deliver IF a turn is already running; an idle agent is woken either way, matching Pi's
+   * ExtensionAPI.sendMessage({ triggerTurn: true, deliverAs: 'steer' }).
+   */
+  admitPrompt?(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;
+  abort(): Promise<void>;
+  compact(instructions?: string): Promise<void>;
+  activity(): Promise<{
+    hasPendingMessages: boolean;
+    isIdle: boolean;
+  }>;
+  /** Renames the durable session and publishes the updated title to presentation clients. */
+  setName?(name: string): Promise<void>;
+  /** Capture the current persisted branch for an in-process child fork. */
+  forkSource?(): Promise<{
+    kind: 'v4-fork';
+    sessionFile: string;
+    branch: string;
+    entryId?: string;
+  }>;
+}
+/** A grant-filtered skill view available only during one remote MCP tool invocation. */
+export interface DoomMcpSkillAccess {
+  list(): Promise<readonly {
+    name: string;
+    description: string;
+  }[]>;
+  read(name: string): Promise<string>;
+}
+/** A stateless auxiliary request. These tools are private to this request, never registered on the agent. */
+export interface DoomHeadlessToolCompletionRequest {
+  systemPrompt: string;
+  input: string;
+  maxTokens: number;
+  cacheRetention?: 'none' | 'short' | 'long';
+  signal?: AbortSignal;
+  tools: readonly Pick<DoomHeadlessTool, 'name' | 'description' | 'parameters'>[];
+}
+export interface DoomHeadlessToolCompletionResult {
+  toolCalls: readonly {
+    id: string;
+    name: string;
+    arguments: unknown;
+  }[];
+  usage: {
+    totalTokens: number;
+  };
+}
+export interface DoomHeadlessExecutionContext {
+  readonly cwd: string;
+  /** The checkout the session runs in, distinct from the tool execution directory. */
+  readonly repoRoot: string;
+  readonly sessionId: string;
+  /** The session's baseline context, when its host knows its workspace. */
+  readonly sessionContext?: DoomSessionContext;
+  /** Immutable session configuration. Facets must not read or mutate process.env. */
+  readonly environment: Readonly<Record<string, string | undefined>>;
+  readonly client: DoomHeadlessClient;
+  readonly session: DoomHeadlessSession;
+  readonly model?: {
+    provider: string;
+    id: string;
+  };
+  readonly textCompletion?: {
+    available(reference: string): boolean;
+    complete(reference: string, request: {
+      systemPrompt: string;
+      input: string;
+      maxTokens: number;
+      cacheRetention?: 'none' | 'short' | 'long';
+      signal?: AbortSignal;
+    }): Promise<string>;
+  };
+  readonly toolCompletion?: {
+    complete(reference: string, request: DoomHeadlessToolCompletionRequest): Promise<DoomHeadlessToolCompletionResult>;
+  };
+  readonly selection: DoomHeadlessSelection;
+  /** Present only while an authenticated remote MCP tool is running. */
+  readonly mcpSkills?: DoomMcpSkillAccess;
+  shutdown(): void;
+}
+/** Conditions narrow an eligible owner's contributions; they can never restore a disabled owner. */
+export interface DoomHeadlessCondition {
+  state?: Readonly<Record<string, string>>;
+  attribution?: {
+    kind: 'minor' | 'domain';
+    mode: string;
+    label?: string;
+  };
+  domain?: string;
+}
+export interface DoomHeadlessToolRestriction {
+  when?: DoomHeadlessCondition;
+  /** Optional capability ceiling. An empty list disables every tool. */
+  allowedTools?: readonly string[];
+  /**
+   * Narrow exclusions without disabling unrelated tools. Exclude a tool your package owns, or a
+   * specific foreign tool the mode exists to withdraw. Never enumerate an allowlist here.
+   */
+  excludedTools?: readonly string[];
+}
+export interface DoomHeadlessTool<TParameters extends TSchema = TSchema> {
+  when?: DoomHeadlessCondition;
+  name: string;
+  label?: string;
+  description: string;
+  parameters: TParameters;
+  annotations?: Tool['annotations'];
+  outputSchema?: Tool['outputSchema'];
+  /** Remote presentation only. Component tool access must be explicitly opted into. */
+  _meta?: Tool['_meta'] & {
+    ui?: {
+      resourceUri?: string;
+      visibility?: ('model' | 'app')[];
+    };
+  };
+  promptSnippet?: string;
+  promptGuidelines?: readonly string[];
+  executionMode?: 'parallel' | 'serial';
+  execute(toolCallId: string, parameters: Static<TParameters>, signal: AbortSignal | undefined, onUpdate: ((result: DoomHeadlessToolResult) => void) | undefined, context: DoomHeadlessExecutionContext): Promise<DoomHeadlessToolResult>;
+}
+/**
+ * One package contribution to the session's resource surface.
+ *
+ * `kind` decides what the model is billed for, and the difference is large:
+ * - `context` is EAGER. `read()` runs on every prompt build and the text is pasted
+ *   into the system prompt verbatim. Reserve it for small live session state that
+ *   exists nowhere on disk. Never use it for a file the package ships: a README
+ *   registered this way costs its full length on every single turn.
+ * - `skill` is LAZY. Only `name`, `description` and `path` reach the prompt; the
+ *   agent reads the file itself when the description matches the task.
+ * - `prompt` is inert until the user invokes it by name.
+ *
+ * The rule in one line: if it is a file the package ships, it is a `skill`.
+ */
+export interface DoomHeadlessResource {
+  when?: DoomHeadlessCondition;
+  name: string;
+  /** Model-visible selection signal. A `skill` without one tells the agent nothing. */
+  description?: string;
+  /** Absolute path of the file `read()` returns, so an advertised skill is one the agent can open. */
+  path?: string;
+  kind: 'prompt' | 'skill' | 'context';
+  read(context: DoomHeadlessExecutionContext): string | Promise<string>;
+}
+export interface DoomHeadlessCommand {
+  when?: DoomHeadlessCondition;
+  name: string;
+  description: string;
+  execute(args: string, context: DoomHeadlessExecutionContext): void | Promise<void>;
+}
+export type DoomHeadlessEventName = 'session_start' | 'session_shutdown' | 'session_tree' | 'before_agent_start' | 'agent_start' | 'agent_settled' | 'turn_start' | 'turn_end' | 'context' | 'before_provider_request' | 'message_start' | 'message_update' | 'message_end' | 'tool_call' | 'tool_execution_start' | 'tool_execution_update' | 'tool_execution_end' | 'tool_result' | 'model_select' | 'session_before_compact' | 'session_compact';
+export type DoomHeadlessHookEvent<E extends DoomHeadlessEventName> = E extends 'before_provider_request' ? {
+  lane: string;
+  runId: string;
+  model: {
+    provider: string;
+    id: string;
+  };
+  payload: unknown;
+} : E extends 'session_before_compact' ? {
+  reason: string;
+  preparation: unknown;
+  instructions?: string;
+  customInstructions?: string;
+} : E extends 'model_select' ? {
+  model: {
+    provider: string;
+    id: string;
+  };
+} : Readonly<Record<string, unknown>>;
+export interface DoomHeadlessCompactionResult {
+  summary: string;
+  tokensBefore: number;
+  retainedTail: Record<string, unknown>[];
+  usage?: Record<string, unknown>;
+  details?: unknown;
+}
+export type DoomHeadlessHookResult<E extends DoomHeadlessEventName> = E extends 'before_provider_request' ? {
+  payload: unknown;
+} | void : E extends 'session_before_compact' ? {
+  cancel?: boolean;
+  decline?: boolean;
+  compaction?: DoomHeadlessCompactionResult;
+} | void : E extends 'context' ? {
+  messages?: unknown[];
+  systemPrompt?: string;
+} | void : E extends 'before_agent_start' ? {
+  systemPrompt?: string;
+} | void : E extends 'tool_call' ? {
+  args?: Record<string, unknown>;
+  block?: {
+    reason: string;
+    terminate?: boolean;
+  };
+} | void : E extends 'tool_result' ? {
+  content?: DoomHeadlessContent[];
+  details?: unknown;
+  isError?: boolean;
+  usage?: Record<string, unknown>;
+  terminate?: boolean;
+} | void : unknown;
+export type DoomHeadlessHook<E extends DoomHeadlessEventName = DoomHeadlessEventName> = E extends DoomHeadlessEventName ? {
+  when?: DoomHeadlessCondition;
+  event: E;
+  handle(event: Readonly<DoomHeadlessHookEvent<E>>, context: DoomHeadlessExecutionContext): DoomHeadlessHookResult<E> | Promise<DoomHeadlessHookResult<E>>;
+} : never;
+/** A retained facet can register activity without starting disabled watchers or services. */
+export interface DoomHeadlessActivity {
+  when?: DoomHeadlessCondition;
+  name: string;
+  start(context: DoomHeadlessExecutionContext): (() => void | Promise<void>) | Promise<() => void | Promise<void>>;
+}
+/** Read-only metadata for the currently applied session, never executable declarations or resource bodies. */
+export interface DoomHeadlessCapability {
+  readonly source: string;
+  readonly name: string;
+  readonly kind: 'tool' | 'skill';
+  readonly when?: DoomHeadlessCondition;
+  readonly active: boolean;
+  readonly discoverable: boolean;
+  readonly reason?: 'inactive' | 'restricted' | 'shadowed' | 'unavailable' | 'not-discoverable';
+}
+export interface DoomHeadlessCapabilitySnapshot {
+  readonly revision: number;
+  readonly ready: boolean;
+  readonly capabilities: readonly DoomHeadlessCapability[];
+}
+/** Registrations inherit package ownership from the caller's Cordis facet. */
+/**
+ * The tool a server session loads skills through. When a session carries it, the prompt lists
+ * every skill by name and points here, so a skill needs no file the agent could read.
+ */
+export declare const DOOM_LOAD_SKILL_TOOL = "load_skill";
+export interface DoomHeadlessHostService {
+  readonly context: DoomHeadlessExecutionContext;
+  /** The instructions of an applied skill by exact name, or undefined when none is applied. */
+  readSkill(name: string): string | undefined;
+  changeSelection(change: DoomHeadlessSelectionChange): Promise<void>;
+  assertActive(source?: string): void;
+  subscribeSelection(listener: (selection: DoomHeadlessSelection) => void | Promise<void>): () => void;
+  /** Inspect only a coherently applied generation. A transition returns ready=false and no partial inventory. */
+  inspectCapabilities(): DoomHeadlessCapabilitySnapshot;
+  registerToolRestriction(restriction: DoomHeadlessToolRestriction): DoomHeadlessRegistration;
+  registerTool<TParameters extends TSchema>(tool: DoomHeadlessTool<TParameters>): DoomHeadlessRegistration;
+  registerResource(resource: DoomHeadlessResource): DoomHeadlessRegistration;
+  registerCommand(command: DoomHeadlessCommand): DoomHeadlessRegistration;
+  registerHook(hook: DoomHeadlessHook): DoomHeadlessRegistration;
+  registerActivity(activity: DoomHeadlessActivity): DoomHeadlessRegistration;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/headless-host': DoomHeadlessHostService;
+  }
+}
+export declare function readDoomHeadlessHost(context: Context): DoomHeadlessHostService | undefined;
+export declare function requireDoomHeadlessHost(context: Context): DoomHeadlessHostService;
+//#endregion
+//# sourceMappingURL=headless.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.mts","names":[],"sources":["../../../src/schemas/headless.ts"],"mappings":"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"}

package/dist/src/schemas/headless.mjs

@@ -0,0 +1,38 @@
+//#region src/schemas/headless.ts
+/** Session-only contributions. This is not a Pi ExtensionAPI or a TUI adapter. */
+const DOOM_HEADLESS_HOST_SERVICE = "doom/headless-host";
+const DOOM_HEADLESS_OWNER = Symbol.for("doom/headless-owner");
+function readDoomHeadlessOwner(context) {
+	return context[DOOM_HEADLESS_OWNER];
+}
+/**
+* Narrows a Pi tool result to the headless contract. Pi types `structuredContent` as any JSON
+* value, while MCP only accepts an object, so anything else is dropped rather than forwarded.
+*/
+function toDoomHeadlessToolResult(result) {
+	const { structuredContent } = result;
+	return {
+		content: result.content,
+		details: result.details,
+		...typeof structuredContent === "object" && structuredContent !== null && !Array.isArray(structuredContent) ? { structuredContent } : {},
+		...result.isError === void 0 ? {} : { isError: result.isError }
+	};
+}
+/** Registrations inherit package ownership from the caller's Cordis facet. */
+/**
+* The tool a server session loads skills through. When a session carries it, the prompt lists
+* every skill by name and points here, so a skill needs no file the agent could read.
+*/
+const DOOM_LOAD_SKILL_TOOL = "load_skill";
+function readDoomHeadlessHost(context) {
+	return context.get(DOOM_HEADLESS_HOST_SERVICE);
+}
+function requireDoomHeadlessHost(context) {
+	const host = readDoomHeadlessHost(context);
+	if (!host) throw new Error("This contribution requires the Doom headless session host.");
+	return host;
+}
+//#endregion
+export { DOOM_HEADLESS_HOST_SERVICE, DOOM_HEADLESS_OWNER, DOOM_LOAD_SKILL_TOOL, readDoomHeadlessHost, readDoomHeadlessOwner, requireDoomHeadlessHost, toDoomHeadlessToolResult };
+
+//# sourceMappingURL=headless.mjs.map

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

@@ -0,0 +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 { 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\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  | { readonly axis: 'state'; readonly key: string; readonly values: readonly string[] };\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 isError?: boolean;\n}): DoomHeadlessToolResult {\n  const { structuredContent } = result;\n  return {\n    content: result.content,\n    details: result.details,\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  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  /**\n   * Delivers and awaits the turn. 'steer' and 'followUp' only enqueue into a running turn; they do\n   * NOT wake an idle agent.\n   */\n  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;\n  /**\n   * Resolves when accepted by the session, before the agent turn settles. Here 'steer' describes\n   * how to deliver IF a turn is already running; an idle agent is woken either way, matching Pi's\n   * ExtensionAPI.sendMessage({ triggerTurn: true, deliverAs: 'steer' }).\n   */\n  admitPrompt?(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): 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<{ kind: 'v4-fork'; sessionFile: string; branch: string; entryId?: string }>;\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\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?: { provider: string; id: string };\n  readonly textCompletion?: {\n    available(reference: string): boolean;\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  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?: {\n      resourceUri?: string;\n      visibility?: ('model' | 'app')[];\n    };\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  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_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  ? { lane: string; runId: string; model: { provider: string; id: string }; payload: unknown }\n  : E extends 'session_before_compact'\n    ? { reason: string; preparation: unknown; instructions?: string; customInstructions?: string }\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    ? { cancel?: boolean; decline?: boolean; compaction?: DoomHeadlessCompactionResult } | 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          ? { args?: Record<string, unknown>; block?: { reason: string; terminate?: boolean } } | 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\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  /** 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":";;AAUA,MAAa,6BAA6B;AAC1C,MAAa,sBAAsB,OAAO,IAAI,qBAAqB;AAkBnE,SAAgB,sBAAsB,SAAqD;CACzF,OAAQ,QAAwE;AAClF;;;;;AAsBA,SAAgB,yBAAyB,QAKd;CACzB,MAAM,EAAE,sBAAsB;CAC9B,OAAO;EACL,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,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;;;;;;AAiSA,MAAa,uBAAuB;AAyBpC,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"}