@agimon-ai/po-core 0.0.0-alpha.0

package/dist/src/systems/main/adapters/headlessHost.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"headlessHost.cjs","names":["Service","createDoomKernel","DOOM_HEADLESS_HOST_SERVICE","isDoomHeadlessToolModelVisible","readDoomMcpStatus","formatSkillsForSystemPrompt","isDoomHeadlessPromptAdmissionError","readDoomHeadlessOwner"],"sources":["../../../../../src/systems/main/adapters/headlessHost.ts"],"sourcesContent":["import { Context, Service } from '@deepseek-ai/cordis';\nimport type { TSchema } from 'typebox';\n\nimport {\n  DOOM_HEADLESS_HOST_SERVICE,\n  DOOM_LOAD_SKILL_TOOL,\n  readDoomHeadlessOwner,\n  isDoomHeadlessPromptAdmissionError,\n  type DoomHeadlessActivity,\n  type DoomHeadlessCommand,\n  type DoomHeadlessEventName,\n  type DoomHeadlessExecutionContext,\n  type DoomHeadlessHook,\n  type DoomHeadlessHostService,\n  isDoomHeadlessToolModelVisible,\n  type DoomHeadlessRegistration,\n  type DoomHeadlessResource,\n  type DoomHeadlessSelection,\n  type DoomHeadlessSelectionChange,\n  type DoomHeadlessTool,\n  type DoomHeadlessCondition,\n  type DoomHeadlessToolRestriction,\n} from '../../../exports/headless';\nimport { createDoomKernel } from '../../../exports/kernel';\nimport { readDoomMcpStatus } from '../../../exports/mcpStatus';\nimport type { DoomServerBundleEntry } from '../../../exports/serverFacet';\nimport type { PackageAttribution } from '../../../services/contextProjection';\nimport type {\n  ContextConditionalAttribution,\n  ContextToolInventory,\n  ContextToolSource,\n} from '../../../services/contextProjection';\nimport { formatSkillsForSystemPrompt } from '../../../services/piExtensionHost';\nimport type { CountTokens } from '../../../services/toolInventory';\nimport type {\n  HeadlessContextInventory,\n  HeadlessHostOptions,\n  HeadlessSelectionStatus,\n  ResolvedHeadlessResource,\n} from '../types/headlessHost';\n\ntype Owned<T> = { source: string; value: T };\ntype StopActivity = () => void | Promise<void>;\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction sameValues(left: readonly unknown[], right: readonly unknown[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction sameSelection(left: DoomHeadlessSelection, right: DoomHeadlessSelection): boolean {\n  return (\n    left.majorMode === right.majorMode &&\n    left.profile === right.profile &&\n    sameStrings(left.activeLayers, right.activeLayers) &&\n    sameStrings(left.domains, right.domains) &&\n    JSON.stringify(left.state ?? {}) === JSON.stringify(right.state ?? {})\n  );\n}\n\n/**\n * Maps one typed headless resource to the exact skill shape installed in AgentHarness.\n *\n * Prefers the resource's own `description` and `path`. The fallbacks below are what\n * every skill used to get, and they are only good enough for explicit invocation,\n * which matches on name: `doom-headless://` is not a path any tool can open, and\n * \"Headless skill from <source>\" gives the model nothing to select on. A skill is\n * only advertised in the prompt once it carries a real path.\n */\nexport function headlessHarnessSkill(resource: ResolvedHeadlessResource) {\n  return {\n    name: resource.name,\n    description: resource.description ?? `Headless skill from ${resource.source}`,\n    content: resource.text,\n    filePath: resource.path ?? `doom-headless://${resource.source}/${resource.name}`,\n  };\n}\n\nfunction escapeXml(value: string): string {\n  return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/\"/g, '&quot;');\n}\n\n/**\n * The load tool's description with the session's skills appended, so the agent sees what it can\n * load where it decides to call the tool. Rebuilt whenever the applied skills change.\n */\nexport function describeLoadSkillTool(base: string, skills: readonly ResolvedHeadlessResource[]): string {\n  const listed = skills.filter(\n    (skill, index, all) => skill.kind === 'skill' && all.findIndex((entry) => entry.name === skill.name) === index,\n  );\n  if (listed.length === 0) return base;\n  return [\n    base,\n    '',\n    '<available_skills>',\n    ...listed.flatMap((skill) => [\n      '  <skill>',\n      `    <name>${escapeXml(skill.name)}</name>`,\n      `    <description>${escapeXml(headlessHarnessSkill(skill).description)}</description>`,\n      '  </skill>',\n    ]),\n    '</available_skills>',\n  ].join('\\n');\n}\n\n/** Retains facets and their state; only kernel-computed active contributions change. */\nexport class HeadlessHost extends Service<DoomHeadlessHostService> implements DoomHeadlessHostService {\n  private readonly kernel = createDoomKernel();\n  private readonly selectionListeners = new Set<(selection: DoomHeadlessSelection) => void | Promise<void>>();\n  private restrictions: readonly DoomHeadlessToolRestriction[] = [];\n  private restrictionsChanged = false;\n  private contributionsChanged = false;\n  private readonly options: HeadlessHostOptions;\n  private readonly selectionOverrides: Set<string>;\n  private applied: DoomHeadlessSelection;\n  private requested: DoomHeadlessSelection;\n  private applying: DoomHeadlessSelection;\n  private refreshing = false;\n  private requestedRevision = 0;\n  private appliedRevision = 0;\n  private recoveryRevision = 0;\n  private ready = false;\n  private disposed = false;\n  private failure: unknown;\n  private tail: Promise<void> = Promise.resolve();\n  private activeSources = new Set<string>();\n  private availableSources = new Set<string>();\n  private tools = new Map<string, Owned<DoomHeadlessTool>>();\n  private resources: readonly Owned<DoomHeadlessResource>[] = [];\n  private resolvedResources: readonly ResolvedHeadlessResource[] = [];\n  private commands = new Map<string, Owned<DoomHeadlessCommand>>();\n  private hooks: readonly Owned<DoomHeadlessHook>[] = [];\n  private readonly activities = new Map<Owned<DoomHeadlessActivity>, StopActivity>();\n\n  constructor(context: Context, options: HeadlessHostOptions) {\n    super(context, DOOM_HEADLESS_HOST_SERVICE);\n    this.options = options;\n    this.selectionOverrides = new Set(options.selectionOverrides);\n    this.applied = structuredClone(options.selection);\n    this.requested = this.applied;\n    this.applying = this.applied;\n    context.effect(() => () => this.close(), 'headless host lifetime');\n    this.kernel.defineSlot<Owned<DoomHeadlessToolRestriction>>('restrictions', (entries) => {\n      this.restrictionsChanged = true;\n      this.restrictions = entries.map((entry) => entry.value).filter((restriction) => this.matches(restriction.when));\n    });\n    this.kernel.defineSlot<Owned<DoomHeadlessTool>>('tools', async (entries) => {\n      const next = new Map<string, Owned<DoomHeadlessTool>>();\n      for (const entry of this.selected(entries)) {\n        if (!this.allowsTool(entry.value.name)) continue;\n        if (!next.has(entry.value.name)) next.set(entry.value.name, entry);\n      }\n      const tools = [...next.values()].map((entry): DoomHeadlessTool => ({\n        ...entry.value,\n        execute: async (id, parameters, signal, onUpdate) => {\n          this.assertReady();\n          if (this.tools.get(entry.value.name) !== entry || !this.activeSources.has(entry.source)) {\n            throw new Error(`Tool '${entry.value.name}' is no longer active`);\n          }\n          return entry.value.execute(id, parameters, signal, onUpdate, this.context);\n        },\n      }));\n      await this.options.applyTools(tools);\n      this.tools = next;\n    });\n    this.kernel.defineSlot<Owned<DoomHeadlessResource>>('resources', async (entries) => {\n      this.resources = this.selected(entries);\n      this.resolvedResources = await this.resolveResources(this.applying);\n      await this.options.applyResources(this.resolvedResources);\n    });\n    this.kernel.defineSlot<Owned<DoomHeadlessCommand>>('commands', (entries) => {\n      const next = new Map<string, Owned<DoomHeadlessCommand>>();\n      for (const entry of this.selected(entries)) if (!next.has(entry.value.name)) next.set(entry.value.name, entry);\n      this.commands = next;\n    });\n    this.kernel.defineSlot<Owned<DoomHeadlessHook>>('hooks', (entries) => {\n      this.hooks = this.selected(entries);\n    });\n    this.kernel.defineSlot<Owned<DoomHeadlessActivity>>('activities', async (entries) => {\n      const desired = new Set(this.selected(entries));\n      for (const [entry, stop] of [...this.activities].reverse()) {\n        if (desired.has(entry)) continue;\n        await stop();\n        this.activities.delete(entry);\n      }\n      for (const entry of desired) {\n        if (this.activities.has(entry)) continue;\n        try {\n          const stop = await entry.value.start(this.options.context(this.applying));\n          this.activities.set(entry, stop);\n        } catch (error) {\n          if (this.options.candidates.some((candidate) => candidate.packageName === entry.source && candidate.required))\n            throw error;\n          this.options.onError?.(error);\n        }\n      }\n    });\n  }\n\n  get context(): DoomHeadlessExecutionContext {\n    return this.options.context(this.applied);\n  }\n\n  get status(): HeadlessSelectionStatus {\n    return {\n      requestedRevision: this.requestedRevision,\n      appliedRevision: this.appliedRevision,\n      ready: this.ready,\n      ...(this.failure === undefined\n        ? {}\n        : {\n            error:\n              this.failure instanceof Error\n                ? this.failure.message\n                : typeof this.failure === 'string'\n                  ? this.failure\n                  : 'Headless selection failed',\n          }),\n    };\n  }\n\n  /**\n   * The resources the last applied selection resolved to.\n   *\n   * `readResources` re-reads them for a live request and refuses while a\n   * selection is mid-apply. A reader describing the applied composition wants\n   * the same snapshot `getContextInventory` reports against, and wants it at\n   * the same moments, so it reads this instead of dispatching.\n   */\n  get appliedResources(): readonly ResolvedHeadlessResource[] {\n    return this.resolvedResources;\n  }\n\n  get toolSurface(): DoomHeadlessHostService['toolSurface'] {\n    return this.options.toolSurface?.();\n  }\n\n  readSkill(name: string): string | undefined {\n    // The last declaration of a name is the one the session uses.\n    return this.resolvedResources.findLast((entry) => entry.kind === 'skill' && entry.name === name)?.text;\n  }\n\n  inspectCapabilities(): ReturnType<DoomHeadlessHostService['inspectCapabilities']> {\n    const ready = this.ready && !this.disposed;\n    const capabilities: ReturnType<DoomHeadlessHostService['inspectCapabilities']>['capabilities'][number][] = [];\n    if (ready) {\n      for (const entry of this.kernel.activeValues<Owned<DoomHeadlessTool>>('tools')) {\n        const active = this.tools.get(entry.value.name) === entry;\n        const discoverable = active && isDoomHeadlessToolModelVisible(entry.value);\n        const reason = active\n          ? discoverable\n            ? undefined\n            : 'not-discoverable'\n          : !this.matches(entry.value.when)\n            ? 'inactive'\n            : !this.allowsTool(entry.value.name)\n              ? 'restricted'\n              : 'shadowed';\n        capabilities.push({\n          source: entry.source,\n          name: entry.value.name,\n          kind: 'tool',\n          when: structuredClone(entry.value.when),\n          active,\n          discoverable,\n          ...(reason ? { reason } : {}),\n        });\n      }\n      // The session skill surface uses the last resolved declaration for a name.\n      const resolved = new Map(\n        this.resolvedResources.filter((entry) => entry.kind === 'skill').map((entry) => [entry.name, entry]),\n      );\n      for (const entry of this.kernel.activeValues<Owned<DoomHeadlessResource>>('resources')) {\n        if (entry.value.kind !== 'skill') continue;\n        const current = resolved.get(entry.value.name);\n        const selected = this.matches(entry.value.when);\n        const active =\n          selected &&\n          current?.source === entry.source &&\n          current.path === entry.value.path &&\n          current.text.trim().length > 0;\n        const discoverable = active && !!current?.path && !!current.description?.trim();\n        const reason = !selected\n          ? 'inactive'\n          : current && current.source !== entry.source\n            ? 'shadowed'\n            : !active\n              ? 'unavailable'\n              : !discoverable\n                ? 'not-discoverable'\n                : undefined;\n        capabilities.push({\n          source: entry.source,\n          name: entry.value.name,\n          kind: 'skill',\n          when: structuredClone(entry.value.when),\n          active,\n          discoverable,\n          ...(reason ? { reason } : {}),\n        });\n      }\n    }\n    return { revision: this.appliedRevision, ready, capabilities };\n  }\n  /**\n   * Every tool name this composition's eligible owners declare, including the\n   * ones a condition or a restriction currently gates out.\n   *\n   * `appliedTools` answers what runs now. A merge that places another surface's\n   * tools beside these needs what is spoken for, so a name a facet deliberately\n   * withheld is not handed to an unreconciled surface instead. Owner\n   * eligibility stays the outer gate: a package the selection excluded declares\n   * nothing here.\n   */\n  get declaredToolNames(): ReadonlySet<string> {\n    return new Set(this.kernel.activeValues<Owned<DoomHeadlessTool>>('tools').map((entry) => entry.value.name));\n  }\n  getContextInventory(\n    selection: DoomHeadlessSelection = this.applied,\n    countTokens?: CountTokens,\n  ): HeadlessContextInventory {\n    const currentSources = new Set(\n      this.options.candidates\n        .filter(\n          (candidate) =>\n            candidate.scopes.includes('session') &&\n            candidate.owners.some((owner) => owner.majorMode === selection.majorMode),\n        )\n        .map((candidate) => candidate.packageName),\n    );\n    const conditionAttribution = (when?: DoomHeadlessCondition): ContextConditionalAttribution | undefined =>\n      when?.attribution ?? (when?.domain === undefined ? undefined : { kind: 'domain', mode: when.domain });\n    const mcpOwners = new Map<string, string>();\n    for (const server of readDoomMcpStatus(this.ctx)?.getSnapshot().servers ?? []) {\n      for (const name of server.tools) mcpOwners.set(name, server.name);\n    }\n    const mcpPackages = new Map<string, string>();\n    const toolsBySource = new Map<string, ContextToolInventory[]>();\n    for (const contribution of this.kernel.contributions<Owned<DoomHeadlessTool>>('tools')) {\n      if (!currentSources.has(contribution.source)) continue;\n      const tool = contribution.value.value;\n      if (!isDoomHeadlessToolModelVisible(tool)) continue;\n      const contextAttribution = conditionAttribution(tool.when);\n      const entry: ContextToolInventory = {\n        name: tool.name,\n        // Priced as sent: the load tool carries the skill list in its description.\n        description:\n          tool.name === DOOM_LOAD_SKILL_TOOL\n            ? describeLoadSkillTool(tool.description, this.resolvedResources)\n            : tool.description,\n        parameters: tool.parameters,\n        ...(tool.promptSnippet === undefined ? {} : { promptSnippet: tool.promptSnippet }),\n        ...(tool.promptGuidelines === undefined ? {} : { promptGuidelines: tool.promptGuidelines }),\n        active: this.tools.get(tool.name) === contribution.value,\n        ...(contextAttribution === undefined ? {} : { contextAttribution }),\n      };\n      const server = mcpOwners.get(tool.name);\n      const source = server === undefined ? contribution.source : `mcp:${server}`;\n      if (server !== undefined) mcpPackages.set(server, contribution.source);\n      const tools = toolsBySource.get(source);\n      if (tools) tools.push(entry);\n      else toolsBySource.set(source, [entry]);\n    }\n\n    const sources: ContextToolSource[] = [...toolsBySource].map(([source, tools]) => ({\n      key: source,\n      label: mcpPackages.has(source.slice(4)) ? `${source.slice(4)} · mcp` : `${source} · extension`,\n      kind: mcpPackages.has(source.slice(4)) ? 'mcp' : 'extension',\n      packageName: mcpPackages.get(source.slice(4)) ?? source,\n      tools,\n    }));\n    const framingTokens = countTokens === undefined ? 0 : countTokens(formatSkillsForSystemPrompt([]));\n    const skills = this.resolvedResources.flatMap((resource, index) => {\n      if (resource.kind !== 'skill') return [];\n      const skill = headlessHarnessSkill(resource);\n      const contextAttribution = conditionAttribution(this.resources[index]?.value.when);\n      return [\n        {\n          name: skill.name,\n          description: skill.description,\n          group: 'extensions' as const,\n          owner: resource.source,\n          modelInvocable: true,\n          body: skill.content,\n          ...(countTokens === undefined\n            ? {}\n            : { promptTokens: Math.max(0, countTokens(formatSkillsForSystemPrompt([skill])) - framingTokens) }),\n          ...(contextAttribution === undefined ? {} : { contextAttribution }),\n        },\n      ];\n    });\n    const attribution: Record<string, PackageAttribution> = {};\n    for (const candidate of this.options.candidates) {\n      const owner =\n        candidate.owners.find(\n          (entry) =>\n            entry.majorMode === selection.majorMode &&\n            (entry.layer === 'default' || selection.activeLayers.includes(entry.layer)),\n        ) ?? candidate.owners.find((entry) => entry.majorMode === selection.majorMode);\n      if (owner && attribution[candidate.packageName] === undefined) {\n        attribution[candidate.packageName] = { kind: 'major', mode: selection.majorMode, layer: owner.layer };\n      }\n    }\n    for (const [server, source] of mcpPackages) {\n      if (attribution[source]) attribution[server] = attribution[source];\n    }\n    return { sources, skills, attribution };\n  }\n\n  setAvailableSources(sources: readonly string[]): void {\n    this.availableSources = new Set(sources);\n  }\n  private matches(when?: DoomHeadlessCondition): boolean {\n    return (\n      Object.entries(when?.state ?? {}).every(([key, value]) => this.applying.state?.[key]?.includes(value)) &&\n      (when?.domain === undefined || this.applying.domains.includes(when.domain))\n    );\n  }\n  private selected<T extends { when?: DoomHeadlessCondition }>(entries: readonly Owned<T>[]): readonly Owned<T>[] {\n    return entries.filter(({ value }) => this.matches(value.when));\n  }\n\n  assertActive(source?: string): void {\n    this.assertReady();\n    if (source !== undefined && !this.activeSources.has(source))\n      throw new Error(`Contribution owner '${source}' is inactive`);\n  }\n\n  subscribeSelection(listener: (selection: DoomHeadlessSelection) => void | Promise<void>): () => void {\n    this.selectionListeners.add(listener);\n    return () => {\n      this.selectionListeners.delete(listener);\n    };\n  }\n\n  /** Shared by facet reconciliation and the final Pi/facet merge. */\n  allowsTool(name: string): boolean {\n    const allowed = this.options.allowedTools?.(this.applying);\n    return (\n      (allowed === undefined || allowed.includes(name)) &&\n      this.restrictions.every(\n        (restriction) =>\n          (restriction.allowedTools === undefined || restriction.allowedTools.includes(name)) &&\n          !restriction.excludedTools?.includes(name),\n      )\n    );\n  }\n\n  registerToolRestriction(restriction: DoomHeadlessToolRestriction): DoomHeadlessRegistration {\n    return this.add('restrictions', restriction);\n  }\n\n  private eligible(entry: DoomServerBundleEntry, selection: DoomHeadlessSelection): boolean {\n    return (\n      entry.scopes.includes('session') &&\n      entry.owners.some(\n        (owner) =>\n          owner.majorMode === selection.majorMode &&\n          (owner.layer === 'default' || selection.activeLayers.includes(owner.layer)),\n      )\n    );\n  }\n\n  changeSelection(change: DoomHeadlessSelectionChange): Promise<void> {\n    this.selectionOverrides.add(change.axis);\n    if (change.axis === 'majorMode') return this.select({ majorMode: change.majorMode });\n    if (change.axis === 'domains') return this.select({ domains: change.domains });\n    if (change.axis === 'profile') return this.select({ profile: change.profile });\n    return this.select({ state: { ...this.requested.state, [change.key]: [...change.values] } });\n  }\n\n  private async refreshChangedSelection(\n    previous: DoomHeadlessSelection,\n    selection: DoomHeadlessSelection,\n    previousValues: ReadonlyMap<string, readonly unknown[]>,\n  ): Promise<void> {\n    const majorChanged =\n      previous.majorMode !== selection.majorMode || !sameStrings(previous.activeLayers, selection.activeLayers);\n    const domainsChanged = !sameStrings(previous.domains, selection.domains);\n    const profileChanged = previous.profile !== selection.profile;\n    const stateChanged = JSON.stringify(previous.state ?? {}) !== JSON.stringify(selection.state ?? {});\n    if (this.appliedRevision === 0) return;\n\n    const refresh = async (slot: string): Promise<void> => {\n      const before = previousValues.get(slot) ?? [];\n      if (sameValues(before, this.kernel.activeValues(slot))) await this.kernel.refresh(slot);\n    };\n    if (stateChanged) await refresh('restrictions');\n    if (majorChanged || domainsChanged || stateChanged || this.restrictionsChanged) await refresh('tools');\n    if (majorChanged || domainsChanged || profileChanged || stateChanged) await refresh('resources');\n    if (domainsChanged || stateChanged) {\n      await refresh('commands');\n      await refresh('hooks');\n      await refresh('activities');\n    }\n  }\n\n  /** Refresh inherited defaults only at turn admission, keeping explicit session axes. */\n  async inheritSelection(selection: Partial<DoomHeadlessSelection>): Promise<void> {\n    const patch: Partial<DoomHeadlessSelection> = {\n      ...(!this.selectionOverrides.has('majorMode') && selection.majorMode !== undefined\n        ? { majorMode: selection.majorMode }\n        : {}),\n      ...(!this.selectionOverrides.has('domains') && selection.domains !== undefined\n        ? { domains: selection.domains }\n        : {}),\n      ...(!this.selectionOverrides.has('profile') && Object.hasOwn(selection, 'profile')\n        ? { profile: selection.profile }\n        : {}),\n    };\n    if (\n      (patch.majorMode === undefined || patch.majorMode === this.requested.majorMode) &&\n      (patch.domains === undefined || sameStrings(patch.domains, this.requested.domains)) &&\n      (!Object.hasOwn(patch, 'profile') || patch.profile === this.requested.profile)\n    )\n      return;\n    await this.select(patch);\n  }\n\n  async select(patch: Partial<DoomHeadlessSelection>): Promise<void> {\n    if (this.disposed) throw new Error('The headless host is disposed');\n    const requested = structuredClone({ ...this.requested, ...patch });\n    this.requested = requested;\n    const revision = ++this.requestedRevision;\n    this.ready = false;\n    const apply = async (): Promise<void> => {\n      if (this.disposed) throw new Error('The headless host is disposed');\n      const selection = structuredClone((await this.options.resolveSelection?.(requested)) ?? requested);\n      await this.options.validateSelection?.(selection);\n      if (revision === this.requestedRevision) this.requested = selection;\n      const eligible = this.options.candidates.filter((entry) => this.eligible(entry, selection));\n      const missing = eligible.find((entry) => entry.required && !this.availableSources.has(entry.packageName));\n      if (missing) throw new Error(`Required headless package '${missing.packageName}' is unavailable`);\n      // The kernel's layer key here is the precomputed package eligibility key.\n      // Minor tool restrictions run in the tools sink only after this owner gate.\n      this.applying = selection;\n      this.refreshing = true;\n      let compositionChanged = false;\n      try {\n        const previousValues = new Map(\n          this.kernel.slots.map((slot) => [slot, this.kernel.activeValues(slot)] as const),\n        );\n        await this.kernel.setActiveLayers(eligible.map((entry) => entry.packageName));\n        await this.refreshChangedSelection(this.applied, selection, previousValues);\n        compositionChanged =\n          this.failure !== undefined ||\n          this.appliedRevision === 0 ||\n          !sameSelection(this.applied, selection) ||\n          this.restrictionsChanged ||\n          this.contributionsChanged ||\n          !sameValues(previousValues.get('tools') ?? [], this.kernel.activeValues('tools')) ||\n          !sameValues(previousValues.get('resources') ?? [], this.kernel.activeValues('resources'));\n        this.restrictionsChanged = false;\n        this.contributionsChanged = false;\n      } finally {\n        this.refreshing = false;\n      }\n      if (this.disposed) throw new Error('The headless host is disposed');\n      this.activeSources = new Set(eligible.map((entry) => entry.packageName));\n      this.applied = selection;\n      this.appliedRevision = revision;\n      this.failure = undefined;\n      this.ready = revision === this.requestedRevision;\n      try {\n        for (const listener of this.selectionListeners) await listener(selection);\n      } catch (error) {\n        if (isDoomHeadlessPromptAdmissionError(error)) this.recoveryRevision = revision;\n        throw error;\n      }\n      if (compositionChanged) await this.options.onApplied?.(selection, revision);\n    };\n    const result = this.tail.catch(() => undefined).then(apply);\n    this.tail = result.catch((error: unknown) => {\n      this.failure = error;\n      this.ready = false;\n      // close() marks the host disposed before draining this tail, so every selection still\n      // queued at that point rejects by design. Those rejections are teardown artifacts, not\n      // actionable failures, and reporting them surfaces one notice per queued contribution.\n      if (!this.disposed) this.options.onError?.(error);\n    });\n    await result;\n    await this.settled();\n    if (this.failure !== undefined) throw this.failure;\n    this.assertReady();\n  }\n\n  /** Drain selections, including ones queued by selection listeners. */\n  async settled(): Promise<void> {\n    let pending: Promise<void>;\n    do {\n      pending = this.tail;\n      await pending;\n    } while (pending !== this.tail);\n  }\n\n  private assertReady(): void {\n    if (this.disposed || !this.ready)\n      throw new Error('Headless dispatch is blocked until selection is coherently applied');\n  }\n\n  private add<T>(slot: string, value: T): DoomHeadlessRegistration {\n    const owner = readDoomHeadlessOwner(this.ctx);\n    if (!owner) throw new Error('A headless contribution must have descriptor-owned package identity');\n    this.ready = false;\n    this.contributionsChanged = true;\n    const registration = this.kernel.contribute(slot, {\n      source: owner.packageName,\n      layer: owner.packageName,\n      value: { source: owner.packageName, value } satisfies Owned<T>,\n    });\n    let disposed = false;\n    const dispose = (): void => {\n      if (disposed) return;\n      disposed = true;\n      this.ready = false;\n      this.contributionsChanged = true;\n      registration.dispose();\n      // Reconciled on the same terms as the registration below: before the first applied\n      // selection the caller's own select() computes the whole composition, and the sources\n      // that selection gates on are not known yet.\n      if (this.appliedRevision > 0 && !this.disposed && !this.refreshing) void this.select({}).catch(() => undefined);\n    };\n    this.ctx.effect(() => dispose, `headless ${slot} contribution`);\n    // Initial registration is reconciled once the caller has installed all facets.\n    if (this.appliedRevision > 0 && !this.refreshing) void this.select({}).catch(() => undefined);\n    return { dispose };\n  }\n\n  registerTool<TParameters extends TSchema>(tool: DoomHeadlessTool<TParameters>): DoomHeadlessRegistration {\n    return this.add('tools', tool);\n  }\n  registerResource(resource: DoomHeadlessResource): DoomHeadlessRegistration {\n    return this.add('resources', resource);\n  }\n  registerCommand(command: DoomHeadlessCommand): DoomHeadlessRegistration {\n    return this.add('commands', command);\n  }\n  registerHook(hook: DoomHeadlessHook): DoomHeadlessRegistration {\n    return this.add('hooks', hook);\n  }\n  registerActivity(activity: DoomHeadlessActivity): DoomHeadlessRegistration {\n    return this.add('activities', activity);\n  }\n\n  private canRecoverSelection(): boolean {\n    return (\n      !this.disposed &&\n      !this.ready &&\n      !this.refreshing &&\n      !this.contributionsChanged &&\n      !this.restrictionsChanged &&\n      this.recoveryRevision === this.requestedRevision &&\n      this.appliedRevision === this.requestedRevision &&\n      isDoomHeadlessPromptAdmissionError(this.failure)\n    );\n  }\n\n  listCommands(): Array<Pick<DoomHeadlessCommand, 'name' | 'description'>> {\n    const recovering = this.canRecoverSelection();\n    if (!recovering) this.assertReady();\n    return [...this.commands.values()]\n      .filter(\n        ({ source, value }) =>\n          !recovering ||\n          (value.selectionRecovery === true && this.activeSources.has(source) && this.availableSources.has(source)),\n      )\n      .map(({ value }) => ({ name: value.name, description: value.description }));\n  }\n\n  async dispatchCommand(name: string, args: string): Promise<void> {\n    const command = this.commands.get(name);\n    if (!this.canRecoverSelection() || command?.value.selectionRecovery !== true) this.assertReady();\n    if (!command || !this.activeSources.has(command.source) || !this.availableSources.has(command.source))\n      throw new Error(`Command '${name}' is inactive or unknown`);\n    await command.value.execute(args, this.context);\n  }\n\n  async dispatchHook(\n    event: DoomHeadlessEventName,\n    payload: Readonly<Record<string, unknown>>,\n    signal?: AbortSignal,\n  ): Promise<unknown[]> {\n    this.assertReady();\n    signal?.throwIfAborted();\n    const results: unknown[] = [];\n    const revision = this.appliedRevision;\n    let current = payload;\n    for (const hook of this.hooks.filter((entry) => entry.value.event === event)) {\n      this.assertReady();\n      signal?.throwIfAborted();\n      if (!this.hooks.includes(hook)) continue;\n      let result: unknown;\n      try {\n        result = await hook.value.handle(current as never, signal ? { ...this.context, signal } : this.context);\n        signal?.throwIfAborted();\n      } catch (error) {\n        if (isDoomHeadlessPromptAdmissionError(error)) throw error;\n        signal?.throwIfAborted();\n        this.options.onError?.(error);\n        continue;\n      }\n      if (event === 'session_start') {\n        // Startup hooks may register retained contributions. Finish their queued reconciliation\n        // before the next hook, without relaxing dispatch guards during the transition.\n        await this.tail;\n        this.assertReady();\n      }\n      results.push(result);\n      if (result && typeof result === 'object' && !Array.isArray(result)) {\n        const patch = result as Record<string, unknown>;\n        // Execution hooks compose in registration order, just like the public harness hooks.\n        const fields =\n          event === 'context'\n            ? ['messages', 'systemPrompt']\n            : event === 'tool_call'\n              ? ['args']\n              : event === 'tool_result'\n                ? ['content', 'details', 'isError', 'usage']\n                : event === 'before_agent_start'\n                  ? ['systemPrompt']\n                  : event === 'before_provider_request'\n                    ? ['payload']\n                    : [];\n        for (const field of fields) {\n          if (event === 'before_agent_start' && typeof patch[field] !== 'string') continue;\n          if (patch[field] !== undefined) current = { ...current, [field]: patch[field] };\n        }\n        // Denials and structural decisions use upstream first-result semantics.\n        if (event === 'tool_call' && patch.block !== undefined) break;\n        if (\n          event === 'session_before_compact' &&\n          (patch.cancel !== undefined || patch.decline !== undefined || patch.compaction !== undefined)\n        )\n          break;\n      }\n    }\n    if (event === 'before_agent_start' || event === 'context' || event === 'tool_call') {\n      this.assertReady();\n      if (revision !== this.appliedRevision) {\n        throw new Error(\n          event === 'before_agent_start'\n            ? 'Selection changed while preparing the system prompt'\n            : `Selection changed while dispatching ${event}`,\n        );\n      }\n    }\n    return results;\n  }\n\n  private async resolveResources(selection: DoomHeadlessSelection): Promise<readonly ResolvedHeadlessResource[]> {\n    const context = this.options.context(selection);\n    const result: ResolvedHeadlessResource[] = [];\n    for (const resource of this.resources) {\n      let value: string;\n      try {\n        value = await resource.value.read(context);\n      } catch (error) {\n        // Report and skip, never rethrow. This runs on every prompt build, and a\n        // throw here reaches the systemPrompt callback, sets promptPreparationFailed\n        // and denies every model request for the rest of the session. One package\n        // missing one shipped file must not take the session down with it.\n        this.options.onError?.(\n          new Error(`Could not read headless resource '${resource.source}/${resource.value.name}'`, { cause: error }),\n        );\n        continue;\n      }\n      result.push({\n        source: resource.source,\n        name: resource.value.name,\n        kind: resource.value.kind,\n        ...(resource.value.description === undefined ? {} : { description: resource.value.description }),\n        ...(resource.value.path === undefined ? {} : { path: resource.value.path }),\n        text: value,\n      });\n    }\n    return result;\n  }\n\n  async readResources(): Promise<readonly ResolvedHeadlessResource[]> {\n    this.assertReady();\n    const revision = this.appliedRevision;\n    const result = await this.resolveResources(this.applied);\n    this.assertReady();\n    if (revision !== this.appliedRevision) throw new Error('Selection changed while reading resources');\n    return result;\n  }\n\n  async close(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.ready = false;\n    this.selectionListeners.clear();\n    await this.tail.catch(() => undefined);\n    const failures: unknown[] = [];\n    for (const stop of [...this.activities.values()].reverse()) {\n      try {\n        await stop();\n      } catch (error) {\n        failures.push(error);\n      }\n    }\n    this.activities.clear();\n    this.kernel.dispose();\n    if (failures.length) throw new AggregateError(failures, 'Headless activities failed to stop');\n  }\n}\n"],"mappings":"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"}

package/dist/src/systems/main/adapters/headlessHost.d.mts

@@ -0,0 +1,116 @@
+import { CountTokens } from "../../../services/toolCost/index.mjs";
+import "../../../../toolInventory.mjs";
+import { DoomHeadlessActivity, DoomHeadlessCommand, DoomHeadlessEventName, DoomHeadlessExecutionContext, DoomHeadlessHook, DoomHeadlessHostService, DoomHeadlessRegistration, DoomHeadlessResource, DoomHeadlessSelection, DoomHeadlessSelectionChange, DoomHeadlessTool, DoomHeadlessToolRestriction } from "../../../schemas/headless.mjs";
+import "../../../../headless.mjs";
+import { HeadlessContextInventory, HeadlessHostOptions, HeadlessSelectionStatus, ResolvedHeadlessResource } from "../types/headlessHost.mjs";
+import { TSchema } from "typebox";
+import { Context, Service } from "@deepseek-ai/cordis";
+//#region src/systems/main/adapters/headlessHost.d.ts
+/**
+ * Maps one typed headless resource to the exact skill shape installed in AgentHarness.
+ *
+ * Prefers the resource's own `description` and `path`. The fallbacks below are what
+ * every skill used to get, and they are only good enough for explicit invocation,
+ * which matches on name: `doom-headless://` is not a path any tool can open, and
+ * "Headless skill from <source>" gives the model nothing to select on. A skill is
+ * only advertised in the prompt once it carries a real path.
+ */
+export declare function headlessHarnessSkill(resource: ResolvedHeadlessResource): {
+  name: string;
+  description: string;
+  content: string;
+  filePath: string;
+};
+/**
+ * The load tool's description with the session's skills appended, so the agent sees what it can
+ * load where it decides to call the tool. Rebuilt whenever the applied skills change.
+ */
+export declare function describeLoadSkillTool(base: string, skills: readonly ResolvedHeadlessResource[]): string;
+/** Retains facets and their state; only kernel-computed active contributions change. */
+export declare class HeadlessHost extends Service<DoomHeadlessHostService> implements DoomHeadlessHostService {
+  private readonly kernel;
+  private readonly selectionListeners;
+  private restrictions;
+  private restrictionsChanged;
+  private contributionsChanged;
+  private readonly options;
+  private readonly selectionOverrides;
+  private applied;
+  private requested;
+  private applying;
+  private refreshing;
+  private requestedRevision;
+  private appliedRevision;
+  private recoveryRevision;
+  private ready;
+  private disposed;
+  private failure;
+  private tail;
+  private activeSources;
+  private availableSources;
+  private tools;
+  private resources;
+  private resolvedResources;
+  private commands;
+  private hooks;
+  private readonly activities;
+  constructor(context: Context, options: HeadlessHostOptions);
+  get context(): DoomHeadlessExecutionContext;
+  get status(): HeadlessSelectionStatus;
+  /**
+   * The resources the last applied selection resolved to.
+   *
+   * `readResources` re-reads them for a live request and refuses while a
+   * selection is mid-apply. A reader describing the applied composition wants
+   * the same snapshot `getContextInventory` reports against, and wants it at
+   * the same moments, so it reads this instead of dispatching.
+   */
+  get appliedResources(): readonly ResolvedHeadlessResource[];
+  get toolSurface(): DoomHeadlessHostService['toolSurface'];
+  readSkill(name: string): string | undefined;
+  inspectCapabilities(): ReturnType<DoomHeadlessHostService['inspectCapabilities']>;
+  /**
+   * Every tool name this composition's eligible owners declare, including the
+   * ones a condition or a restriction currently gates out.
+   *
+   * `appliedTools` answers what runs now. A merge that places another surface's
+   * tools beside these needs what is spoken for, so a name a facet deliberately
+   * withheld is not handed to an unreconciled surface instead. Owner
+   * eligibility stays the outer gate: a package the selection excluded declares
+   * nothing here.
+   */
+  get declaredToolNames(): ReadonlySet<string>;
+  getContextInventory(selection?: DoomHeadlessSelection, countTokens?: CountTokens): HeadlessContextInventory;
+  setAvailableSources(sources: readonly string[]): void;
+  private matches;
+  private selected;
+  assertActive(source?: string): void;
+  subscribeSelection(listener: (selection: DoomHeadlessSelection) => void | Promise<void>): () => void;
+  /** Shared by facet reconciliation and the final Pi/facet merge. */
+  allowsTool(name: string): boolean;
+  registerToolRestriction(restriction: DoomHeadlessToolRestriction): DoomHeadlessRegistration;
+  private eligible;
+  changeSelection(change: DoomHeadlessSelectionChange): Promise<void>;
+  private refreshChangedSelection;
+  /** Refresh inherited defaults only at turn admission, keeping explicit session axes. */
+  inheritSelection(selection: Partial<DoomHeadlessSelection>): Promise<void>;
+  select(patch: Partial<DoomHeadlessSelection>): Promise<void>;
+  /** Drain selections, including ones queued by selection listeners. */
+  settled(): Promise<void>;
+  private assertReady;
+  private add;
+  registerTool<TParameters extends TSchema>(tool: DoomHeadlessTool<TParameters>): DoomHeadlessRegistration;
+  registerResource(resource: DoomHeadlessResource): DoomHeadlessRegistration;
+  registerCommand(command: DoomHeadlessCommand): DoomHeadlessRegistration;
+  registerHook(hook: DoomHeadlessHook): DoomHeadlessRegistration;
+  registerActivity(activity: DoomHeadlessActivity): DoomHeadlessRegistration;
+  private canRecoverSelection;
+  listCommands(): Array<Pick<DoomHeadlessCommand, 'name' | 'description'>>;
+  dispatchCommand(name: string, args: string): Promise<void>;
+  dispatchHook(event: DoomHeadlessEventName, payload: Readonly<Record<string, unknown>>, signal?: AbortSignal): Promise<unknown[]>;
+  private resolveResources;
+  readResources(): Promise<readonly ResolvedHeadlessResource[]>;
+  close(): Promise<void>;
+}
+//#endregion
+//# sourceMappingURL=headlessHost.d.mts.map

package/dist/src/systems/main/adapters/headlessHost.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headlessHost.d.mts","names":[],"sources":["../../../../../src/systems/main/adapters/headlessHost.ts"],"mappings":";;;;;;;;;;;;;;;;;wBAuEgB,qBAAqB,UAAU;EAE3C;EACA;EACA;EACA;;;;;;wBAYY,sBAAsB,cAAc,iBAAiB;;qBAoBxD,qBAAqB,QAAQ,oCAAoC;mBAC3D;mBACA;UACT;UACA;UACA;mBACS;mBACA;UACT;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;mBACS;EAEjB,YAAY,SAAS,SAAS,SAAS;MAiEnC,WAAW;MAIX,UAAU;;;;;;;;;MA0BV,6BAA6B;MAI7B,eAAe;EAInB,UAAU;EAKV,uBAAuB,WAAW;;;;;;;;;;;MAwE9B,qBAAqB;EAGzB,oBACE,YAAW,uBACX,cAAc,cACb;EAyFH,oBAAoB;UAGZ;UAMA;EAIR,aAAa;EAMb,mBAAmB,WAAW,WAAW,iCAAiC;;EAQ1E,WAAW;EAYX,wBAAwB,aAAa,8BAA8B;UAI3D;EAWR,gBAAgB,QAAQ,8BAA8B;UAQxC;;EA2BR,iBAAiB,WAAW,QAAQ,yBAAyB;EAqB7D,OAAO,OAAO,QAAQ,yBAAyB;;EAoE/C,WAAW;UAQT;UAKA;EA4BR,aAAa,oBAAoB,SAAS,MAAM,iBAAiB,eAAe;EAGhF,iBAAiB,UAAU,uBAAuB;EAGlD,gBAAgB,SAAS,sBAAsB;EAG/C,aAAa,MAAM,mBAAmB;EAGtC,iBAAiB,UAAU,uBAAuB;UAI1C;EAaR,gBAAgB,MAAM,KAAK;EAYrB,gBAAgB,cAAc,eAAe;EAQ7C,aACJ,OAAO,uBACP,SAAS,SAAS,0BAClB,SAAS,cACR;UAoEW;EA6BR,iBAAiB,iBAAiB;EASlC,SAAS"}