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

package/dist/schemas/headless.cjs

@@ -0,0 +1,23 @@
+//#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];
+}
+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.readDoomHeadlessHost = readDoomHeadlessHost;
+exports.readDoomHeadlessOwner = readDoomHeadlessOwner;
+exports.requireDoomHeadlessHost = requireDoomHeadlessHost;
+
+//# sourceMappingURL=headless.cjs.map

package/dist/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 { Static, TSchema } from 'typebox';\n\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  details?: unknown;\n  isError?: boolean;\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  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 DoomHeadlessSession {\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  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;\n  /** Resolves when accepted by the session, before the agent turn settles. */\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  /** 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\nexport interface DoomHeadlessExecutionContext {\n  readonly cwd: string;\n  /** Admitted configuration root, distinct from the tool execution directory. */\n  readonly repoRoot: string;\n  readonly sessionId: string;\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 selection: DoomHeadlessSelection;\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  allowedTools: 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  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\nexport interface DoomHeadlessResource {\n  when?: DoomHeadlessCondition;\n  name: 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/** Registrations inherit package ownership from the caller's Cordis facet. */\nexport interface DoomHeadlessHostService {\n  readonly context: DoomHeadlessExecutionContext;\n  changeSelection(change: DoomHeadlessSelectionChange): Promise<void>;\n  assertActive(source?: string): void;\n  subscribeSelection(listener: (selection: DoomHeadlessSelection) => void | Promise<void>): () => void;\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":";;AAOA,MAAa,6BAA6B;AAC1C,MAAa,sBAAsB,OAAO,IAAI,qBAAqB;AAkBnE,SAAgB,sBAAsB,SAAqD;CACzF,OAAQ,QAAwE;AAClF;AAwNA,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/schemas/headless.d.cts

@@ -0,0 +1,238 @@
+import { DoomServerBundleEntry } from "./serverBundle.cjs";
+import { DoomNotificationRequest } from "./notification.cjs";
+import { Static, TSchema } from "typebox";
+import { Context } from "@deepseek-ai/cordis";
+//#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[];
+  details?: unknown;
+  isError?: boolean;
+}
+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 {
+  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 DoomHeadlessSession {
+  /** 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>;
+  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;
+  /** Resolves when accepted by the session, before the agent turn settles. */
+  admitPrompt?(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;
+  abort(): Promise<void>;
+  compact(instructions?: string): Promise<void>;
+  activity(): Promise<{
+    hasPendingMessages: boolean;
+    isIdle: boolean;
+  }>;
+  /** Capture the current persisted branch for an in-process child fork. */
+  forkSource?(): Promise<{
+    kind: 'v4-fork';
+    sessionFile: string;
+    branch: string;
+    entryId?: string;
+  }>;
+}
+export interface DoomHeadlessExecutionContext {
+  readonly cwd: string;
+  /** Admitted configuration root, distinct from the tool execution directory. */
+  readonly repoRoot: string;
+  readonly sessionId: string;
+  /** 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 selection: DoomHeadlessSelection;
+  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;
+  allowedTools: readonly string[];
+}
+export interface DoomHeadlessTool<TParameters extends TSchema = TSchema> {
+  when?: DoomHeadlessCondition;
+  name: string;
+  label?: string;
+  description: string;
+  parameters: TParameters;
+  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>;
+}
+export interface DoomHeadlessResource {
+  when?: DoomHeadlessCondition;
+  name: 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>>;
+}
+/** Registrations inherit package ownership from the caller's Cordis facet. */
+export interface DoomHeadlessHostService {
+  readonly context: DoomHeadlessExecutionContext;
+  changeSelection(change: DoomHeadlessSelectionChange): Promise<void>;
+  assertActive(source?: string): void;
+  subscribeSelection(listener: (selection: DoomHeadlessSelection) => void | Promise<void>): () => void;
+  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.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.cts","names":[],"sources":["../../src/schemas/headless.ts"],"mappings":";;;;;;qBAOa;qBACA;iBAEI;WACN;WACA;WACA;WACA;;WAEA,QAAQ,SAAS;;;YAIhB;WACG;WAA4B;;WAC5B;WAA0B;;WAC1B;WAA0B;;WAC1B;WAAwB;WAAsB;;wBAE7C,sBAAsB,SAAS,UAAU;iBAIxC;EACf;;YAGU;EAAwB;EAAc;;EAAmB;EAAe;EAAc;;iBAEjF;EACf,SAAS;EACT;EACA;;iBAGe;EACf;EACA;EACA;EACA;IAAqB;IAAe;IAAsB;;EAC1D;EACA;;iBAGe;EACf,OAAO,SAAS,iCAAiC;EACjD,QAAQ,SAAS,2BAA2B,SAAS,cAAc;EACnE,UAAU,gBAAgB;EAC1B,oBAAoB;;iBAGL;;EAEf,QAAQ;IACN;IACA;IACA;eACW,4BAA4B,iBAAiB;EAC1D,kBAAkB,cAAc,gBAAgB;EAChD,OAAO,cAAc,6CAA6C;;EAElE,aAAa,cAAc,6CAA6C;EACxE,SAAS;EACT,QAAQ,wBAAwB;EAChC,YAAY;IAAU;IAA6B;;;EAEnD,eAAe;IAAU;IAAiB;IAAqB;IAAgB;;;iBAGhE;WACN;;WAEA;WACA;;WAEA,aAAa,SAAS;WACtB,QAAQ;WACR,SAAS;WACT;IAAU;IAAkB;;WAC5B;IACP,UAAU;IACV,SACE,mBACA;MACE;MACA;MACA;MACA;MACA,SAAS;QAEV;;WAEI,WAAW;EACpB;;;iBAIe;EACf,QAAQ,SAAS;EACjB;IAAgB;IAA0B;IAAc;;EACxD;;iBAGe;EACf,OAAO;EACP;;iBAGe,iBAAiB,oBAAoB,UAAU;EAC9D,OAAO;EACP;EACA;EACA;EACA,YAAY;EACZ;EACA;EACA;EACA,QACE,oBACA,YAAY,OAAO,cACnB,QAAQ,yBACR,YAAY,QAAQ,8CACpB,SAAS,+BACR,QAAQ;;iBAGI;EACf,OAAO;EACP;EACA;EACA,KAAK,SAAS,wCAAwC;;iBAGvC;EACf,OAAO;EACP;EACA;EACA,QAAQ,cAAc,SAAS,sCAAsC;;YAG3D;YAuBA,sBAAsB,UAAU,yBAAyB;EAC/D;EAAc;EAAe;IAAS;IAAkB;;EAAc;IACxE;EACI;EAAgB;EAAsB;EAAuB;IAC/D;EACI;IAAS;IAAkB;;IAC7B,SAAS;iBAEA;EACf;EACA;EACA,cAAc;EACd,QAAQ;EACR;;YAGU,uBAAuB,UAAU,yBAAyB;EAChE;WACF;EACI;EAAkB;EAAmB,aAAa;WACpD;EACI;EAAsB;WACxB;EACI;WACF;EACI,OAAO;EAAyB;IAAU;IAAgB;;WAC5D;EAEI,UAAU;EACV;EACA;EACA,QAAQ;EACR;;YAIJ,iBAAiB,UAAU,wBAAwB,yBAAyB,UAAU;EAE5F,OAAO;EACP,OAAO;EACP,OACE,OAAO,SAAS,sBAAsB,KACtC,SAAS,+BACR,uBAAuB,KAAK,QAAQ,uBAAuB;;;iBAKnD;EACf,OAAO;EACP;EACA,MAAM,SAAS,6CAA6C,iBAAiB,qBAAqB;;;iBAInF;WACN,SAAS;EAClB,gBAAgB,QAAQ,8BAA8B;EACtD,aAAa;EACb,mBAAmB,WAAW,WAAW,iCAAiC;EAC1E,wBAAwB,aAAa,8BAA8B;EACnE,aAAa,oBAAoB,SAAS,MAAM,iBAAiB,eAAe;EAChF,iBAAiB,UAAU,uBAAuB;EAClD,gBAAgB,SAAS,sBAAsB;EAC/C,aAAa,MAAM,mBAAmB;EACtC,iBAAiB,UAAU,uBAAuB;;;YAIxC;IACR,sBAAsB;;;wBAIV,qBAAqB,SAAS,UAAU;wBAIxC,wBAAwB,SAAS,UAAU"}

package/dist/schemas/headless.d.mts

@@ -0,0 +1,238 @@
+import { DoomServerBundleEntry } from "./serverBundle.mjs";
+import { DoomNotificationRequest } from "./notification.mjs";
+import { Static, TSchema } from "typebox";
+import { Context } from "@deepseek-ai/cordis";
+//#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[];
+  details?: unknown;
+  isError?: boolean;
+}
+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 {
+  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 DoomHeadlessSession {
+  /** 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>;
+  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;
+  /** Resolves when accepted by the session, before the agent turn settles. */
+  admitPrompt?(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;
+  abort(): Promise<void>;
+  compact(instructions?: string): Promise<void>;
+  activity(): Promise<{
+    hasPendingMessages: boolean;
+    isIdle: boolean;
+  }>;
+  /** Capture the current persisted branch for an in-process child fork. */
+  forkSource?(): Promise<{
+    kind: 'v4-fork';
+    sessionFile: string;
+    branch: string;
+    entryId?: string;
+  }>;
+}
+export interface DoomHeadlessExecutionContext {
+  readonly cwd: string;
+  /** Admitted configuration root, distinct from the tool execution directory. */
+  readonly repoRoot: string;
+  readonly sessionId: string;
+  /** 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 selection: DoomHeadlessSelection;
+  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;
+  allowedTools: readonly string[];
+}
+export interface DoomHeadlessTool<TParameters extends TSchema = TSchema> {
+  when?: DoomHeadlessCondition;
+  name: string;
+  label?: string;
+  description: string;
+  parameters: TParameters;
+  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>;
+}
+export interface DoomHeadlessResource {
+  when?: DoomHeadlessCondition;
+  name: 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>>;
+}
+/** Registrations inherit package ownership from the caller's Cordis facet. */
+export interface DoomHeadlessHostService {
+  readonly context: DoomHeadlessExecutionContext;
+  changeSelection(change: DoomHeadlessSelectionChange): Promise<void>;
+  assertActive(source?: string): void;
+  subscribeSelection(listener: (selection: DoomHeadlessSelection) => void | Promise<void>): () => void;
+  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/schemas/headless.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.mts","names":[],"sources":["../../src/schemas/headless.ts"],"mappings":";;;;;;qBAOa;qBACA;iBAEI;WACN;WACA;WACA;WACA;;WAEA,QAAQ,SAAS;;;YAIhB;WACG;WAA4B;;WAC5B;WAA0B;;WAC1B;WAA0B;;WAC1B;WAAwB;WAAsB;;wBAE7C,sBAAsB,SAAS,UAAU;iBAIxC;EACf;;YAGU;EAAwB;EAAc;;EAAmB;EAAe;EAAc;;iBAEjF;EACf,SAAS;EACT;EACA;;iBAGe;EACf;EACA;EACA;EACA;IAAqB;IAAe;IAAsB;;EAC1D;EACA;;iBAGe;EACf,OAAO,SAAS,iCAAiC;EACjD,QAAQ,SAAS,2BAA2B,SAAS,cAAc;EACnE,UAAU,gBAAgB;EAC1B,oBAAoB;;iBAGL;;EAEf,QAAQ;IACN;IACA;IACA;eACW,4BAA4B,iBAAiB;EAC1D,kBAAkB,cAAc,gBAAgB;EAChD,OAAO,cAAc,6CAA6C;;EAElE,aAAa,cAAc,6CAA6C;EACxE,SAAS;EACT,QAAQ,wBAAwB;EAChC,YAAY;IAAU;IAA6B;;;EAEnD,eAAe;IAAU;IAAiB;IAAqB;IAAgB;;;iBAGhE;WACN;;WAEA;WACA;;WAEA,aAAa,SAAS;WACtB,QAAQ;WACR,SAAS;WACT;IAAU;IAAkB;;WAC5B;IACP,UAAU;IACV,SACE,mBACA;MACE;MACA;MACA;MACA;MACA,SAAS;QAEV;;WAEI,WAAW;EACpB;;;iBAIe;EACf,QAAQ,SAAS;EACjB;IAAgB;IAA0B;IAAc;;EACxD;;iBAGe;EACf,OAAO;EACP;;iBAGe,iBAAiB,oBAAoB,UAAU;EAC9D,OAAO;EACP;EACA;EACA;EACA,YAAY;EACZ;EACA;EACA;EACA,QACE,oBACA,YAAY,OAAO,cACnB,QAAQ,yBACR,YAAY,QAAQ,8CACpB,SAAS,+BACR,QAAQ;;iBAGI;EACf,OAAO;EACP;EACA;EACA,KAAK,SAAS,wCAAwC;;iBAGvC;EACf,OAAO;EACP;EACA;EACA,QAAQ,cAAc,SAAS,sCAAsC;;YAG3D;YAuBA,sBAAsB,UAAU,yBAAyB;EAC/D;EAAc;EAAe;IAAS;IAAkB;;EAAc;IACxE;EACI;EAAgB;EAAsB;EAAuB;IAC/D;EACI;IAAS;IAAkB;;IAC7B,SAAS;iBAEA;EACf;EACA;EACA,cAAc;EACd,QAAQ;EACR;;YAGU,uBAAuB,UAAU,yBAAyB;EAChE;WACF;EACI;EAAkB;EAAmB,aAAa;WACpD;EACI;EAAsB;WACxB;EACI;WACF;EACI,OAAO;EAAyB;IAAU;IAAgB;;WAC5D;EAEI,UAAU;EACV;EACA;EACA,QAAQ;EACR;;YAIJ,iBAAiB,UAAU,wBAAwB,yBAAyB,UAAU;EAE5F,OAAO;EACP,OAAO;EACP,OACE,OAAO,SAAS,sBAAsB,KACtC,SAAS,+BACR,uBAAuB,KAAK,QAAQ,uBAAuB;;;iBAKnD;EACf,OAAO;EACP;EACA,MAAM,SAAS,6CAA6C,iBAAiB,qBAAqB;;;iBAInF;WACN,SAAS;EAClB,gBAAgB,QAAQ,8BAA8B;EACtD,aAAa;EACb,mBAAmB,WAAW,WAAW,iCAAiC;EAC1E,wBAAwB,aAAa,8BAA8B;EACnE,aAAa,oBAAoB,SAAS,MAAM,iBAAiB,eAAe;EAChF,iBAAiB,UAAU,uBAAuB;EAClD,gBAAgB,SAAS,sBAAsB;EAC/C,aAAa,MAAM,mBAAmB;EACtC,iBAAiB,UAAU,uBAAuB;;;YAIxC;IACR,sBAAsB;;;wBAIV,qBAAqB,SAAS,UAAU;wBAIxC,wBAAwB,SAAS,UAAU"}

package/dist/schemas/headless.mjs

@@ -0,0 +1,19 @@
+//#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];
+}
+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, readDoomHeadlessHost, readDoomHeadlessOwner, requireDoomHeadlessHost };
+
+//# sourceMappingURL=headless.mjs.map

package/dist/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 { Static, TSchema } from 'typebox';\n\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  details?: unknown;\n  isError?: boolean;\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  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 DoomHeadlessSession {\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  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;\n  /** Resolves when accepted by the session, before the agent turn settles. */\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  /** 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\nexport interface DoomHeadlessExecutionContext {\n  readonly cwd: string;\n  /** Admitted configuration root, distinct from the tool execution directory. */\n  readonly repoRoot: string;\n  readonly sessionId: string;\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 selection: DoomHeadlessSelection;\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  allowedTools: 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  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\nexport interface DoomHeadlessResource {\n  when?: DoomHeadlessCondition;\n  name: 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/** Registrations inherit package ownership from the caller's Cordis facet. */\nexport interface DoomHeadlessHostService {\n  readonly context: DoomHeadlessExecutionContext;\n  changeSelection(change: DoomHeadlessSelectionChange): Promise<void>;\n  assertActive(source?: string): void;\n  subscribeSelection(listener: (selection: DoomHeadlessSelection) => void | Promise<void>): () => void;\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":";;AAOA,MAAa,6BAA6B;AAC1C,MAAa,sBAAsB,OAAO,IAAI,qBAAqB;AAkBnE,SAAgB,sBAAsB,SAAqD;CACzF,OAAQ,QAAwE;AAClF;AAwNA,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"}