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

package/dist/schemas/skills.cjs

@@ -0,0 +1,115 @@
+let typebox = require("typebox");
+let typebox_value = require("typebox/value");
+//#region src/schemas/skills.ts
+/** Provider-owned Cordis service for live skill-directory contributions. */
+const DOOM_SKILL_SOURCES_SERVICE = "doom/skill-sources";
+/**
+* The custom session entry journaled once Pi has rebuilt its resource catalog
+* for a reload.
+*
+* A reload is the only thing that changes which skills exist, and Pi publishes
+* nothing for it: the whole wire record of a `/domains` switch is the single
+* `response:prompt` for the command that triggered it. An RPC client therefore
+* has no way to learn that the `get_commands` answer it cached, which is what
+* the web cockpit completes `$` from, now describes the previous domains.
+*
+* This entry is that missing signal. It rides Pi's `entry_appended` frames the
+* way the minor-mode catalog projection does, so it needs no new protocol, and
+* a custom entry with no registered renderer is invisible in the TUI.
+*/
+const DOOM_RESOURCE_CATALOG_ENTRY_TYPE = "doom-resource-catalog";
+const MAX_GENERATION_LENGTH = 256;
+const SkillSourceNameSchema = typebox.Type.String({
+	minLength: 1,
+	maxLength: 128,
+	pattern: "^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$"
+});
+const SkillSourceContributionSchema = typebox.Type.Object({
+	source: SkillSourceNameSchema,
+	/** Absolute directories, the same ones the source hands `resources_discover`. */
+	directories: typebox.Type.Array(typebox.Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+function cloneContribution(contribution) {
+	return {
+		source: contribution.source,
+		directories: [...contribution.directories]
+	};
+}
+function validateContribution(contribution) {
+	if ((0, typebox_value.Check)(SkillSourceContributionSchema, contribution)) return cloneContribution(contribution);
+	const [first] = (0, typebox_value.Errors)(SkillSourceContributionSchema, contribution);
+	throw new TypeError(`Invalid Doom skill-source contribution${first ? ` at ${first.instancePath || "/"}: ${first.message}` : ""}.`);
+}
+/** Creates the provider-owned skill-source registry for one Cordis session. */
+function createDoomSkillSourcesService(generation) {
+	if (generation.length === 0 || generation.length > MAX_GENERATION_LENGTH) throw new TypeError("Doom skill sources require a valid generation.");
+	const registrations = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	let sequence = 0;
+	let disposed = false;
+	const ensureActive = () => {
+		if (disposed) throw new Error("The Doom skill-sources service is disposed.");
+	};
+	const list = () => [...registrations.values()].map(({ contribution }) => cloneContribution(contribution)).sort((left, right) => left.source.localeCompare(right.source));
+	const notify = () => {
+		const contributions = list();
+		for (const listener of listeners) listener(contributions);
+	};
+	return Object.freeze({
+		generation,
+		register(contribution) {
+			ensureActive();
+			const validated = validateContribution(contribution);
+			sequence += 1;
+			const token = Symbol(validated.source);
+			const registrationGeneration = `${generation}:skill-source:${sequence}`;
+			registrations.set(validated.source, {
+				token,
+				contribution: validated
+			});
+			notify();
+			let registrationDisposed = false;
+			return Object.freeze({
+				source: validated.source,
+				generation: registrationGeneration,
+				dispose() {
+					if (registrationDisposed) return;
+					registrationDisposed = true;
+					if (registrations.get(validated.source)?.token !== token) return;
+					registrations.delete(validated.source);
+					notify();
+				}
+			});
+		},
+		list,
+		subscribe(listener) {
+			ensureActive();
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			registrations.clear();
+			listeners.clear();
+		}
+	});
+}
+function readDoomSkillSourcesService(context) {
+	return context.get(DOOM_SKILL_SOURCES_SERVICE);
+}
+function requireDoomSkillSourcesService(context) {
+	const service = readDoomSkillSourcesService(context);
+	if (!service) throw new Error("Doom skill sources are unavailable. Load @agimon-ai/doompi-skill.");
+	return service;
+}
+//#endregion
+exports.DOOM_RESOURCE_CATALOG_ENTRY_TYPE = DOOM_RESOURCE_CATALOG_ENTRY_TYPE;
+exports.DOOM_SKILL_SOURCES_SERVICE = DOOM_SKILL_SOURCES_SERVICE;
+exports.SkillSourceContributionSchema = SkillSourceContributionSchema;
+exports.SkillSourceNameSchema = SkillSourceNameSchema;
+exports.createDoomSkillSourcesService = createDoomSkillSourcesService;
+exports.readDoomSkillSourcesService = readDoomSkillSourcesService;
+exports.requireDoomSkillSourcesService = requireDoomSkillSourcesService;
+
+//# sourceMappingURL=skills.cjs.map

package/dist/schemas/skills.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.cjs","names":["Type","Check","Errors"],"sources":["../../src/schemas/skills.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport { Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\n/** Provider-owned Cordis service for live skill-directory contributions. */\nexport const DOOM_SKILL_SOURCES_SERVICE = 'doom/skill-sources';\n\n/**\n * The custom session entry journaled once Pi has rebuilt its resource catalog\n * for a reload.\n *\n * A reload is the only thing that changes which skills exist, and Pi publishes\n * nothing for it: the whole wire record of a `/domains` switch is the single\n * `response:prompt` for the command that triggered it. An RPC client therefore\n * has no way to learn that the `get_commands` answer it cached, which is what\n * the web cockpit completes `$` from, now describes the previous domains.\n *\n * This entry is that missing signal. It rides Pi's `entry_appended` frames the\n * way the minor-mode catalog projection does, so it needs no new protocol, and\n * a custom entry with no registered renderer is invisible in the TUI.\n */\nexport const DOOM_RESOURCE_CATALOG_ENTRY_TYPE = 'doom-resource-catalog';\n\n/**\n * The payload of a resource-catalog entry.\n *\n * Arrival is the signal; a client re-reads the catalog rather than diffing\n * this. The revision only distinguishes one rebuild from the next in a journal\n * a human is reading.\n */\nexport interface ResourceCatalogProjection {\n  readonly version: 1;\n  readonly revision: number;\n}\n\nconst MAX_GENERATION_LENGTH = 256;\n\nexport const SkillSourceNameSchema = Type.String({\n  minLength: 1,\n  maxLength: 128,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const SkillSourceContributionSchema = Type.Object(\n  {\n    source: SkillSourceNameSchema,\n    /** Absolute directories, the same ones the source hands `resources_discover`. */\n    directories: Type.Array(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\n\nexport interface SkillSourceContribution {\n  readonly source: string;\n  readonly directories: readonly string[];\n}\n\nexport interface SkillSourceContributionHandle {\n  readonly source: string;\n  readonly generation: string;\n  dispose(): void;\n}\n\n/** Direct registrar/query/subscription seam owned by doompi-skill. */\nexport interface DoomSkillSourcesService {\n  readonly generation: string;\n  register(contribution: SkillSourceContribution): SkillSourceContributionHandle;\n  list(): readonly SkillSourceContribution[];\n  subscribe(listener: (contributions: readonly SkillSourceContribution[]) => void): () => void;\n  dispose(): void;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/skill-sources': DoomSkillSourcesService;\n  }\n}\n\ninterface RegisteredSkillSource {\n  readonly token: symbol;\n  readonly contribution: SkillSourceContribution;\n}\n\nfunction cloneContribution(contribution: SkillSourceContribution): SkillSourceContribution {\n  return { source: contribution.source, directories: [...contribution.directories] };\n}\n\nfunction validateContribution(contribution: SkillSourceContribution): SkillSourceContribution {\n  if (Check(SkillSourceContributionSchema, contribution)) return cloneContribution(contribution);\n  const [first] = Errors(SkillSourceContributionSchema, contribution);\n  throw new TypeError(\n    `Invalid Doom skill-source contribution${first ? ` at ${first.instancePath || '/'}: ${first.message}` : ''}.`,\n  );\n}\n\n/** Creates the provider-owned skill-source registry for one Cordis session. */\nexport function createDoomSkillSourcesService(generation: string): DoomSkillSourcesService {\n  if (generation.length === 0 || generation.length > MAX_GENERATION_LENGTH) {\n    throw new TypeError('Doom skill sources require a valid generation.');\n  }\n\n  const registrations = new Map<string, RegisteredSkillSource>();\n  const listeners = new Set<(contributions: readonly SkillSourceContribution[]) => void>();\n  let sequence = 0;\n  let disposed = false;\n\n  const ensureActive = (): void => {\n    if (disposed) throw new Error('The Doom skill-sources service is disposed.');\n  };\n  const list = (): readonly SkillSourceContribution[] =>\n    [...registrations.values()]\n      .map(({ contribution }) => cloneContribution(contribution))\n      .sort((left, right) => left.source.localeCompare(right.source));\n  const notify = (): void => {\n    const contributions = list();\n    for (const listener of listeners) listener(contributions);\n  };\n\n  const service: DoomSkillSourcesService = {\n    generation,\n    register(contribution) {\n      ensureActive();\n      const validated = validateContribution(contribution);\n      sequence += 1;\n      const token = Symbol(validated.source);\n      const registrationGeneration = `${generation}:skill-source:${sequence}`;\n      registrations.set(validated.source, { token, contribution: validated });\n      notify();\n      let registrationDisposed = false;\n      return Object.freeze({\n        source: validated.source,\n        generation: registrationGeneration,\n        dispose() {\n          if (registrationDisposed) return;\n          registrationDisposed = true;\n          if (registrations.get(validated.source)?.token !== token) return;\n          registrations.delete(validated.source);\n          notify();\n        },\n      });\n    },\n    list,\n    subscribe(listener) {\n      ensureActive();\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      registrations.clear();\n      listeners.clear();\n    },\n  };\n  return Object.freeze(service);\n}\n\nexport function readDoomSkillSourcesService(context: Context): DoomSkillSourcesService | undefined {\n  return context.get(DOOM_SKILL_SOURCES_SERVICE) as DoomSkillSourcesService | undefined;\n}\n\nexport function requireDoomSkillSourcesService(context: Context): DoomSkillSourcesService {\n  const service = readDoomSkillSourcesService(context);\n  if (!service) throw new Error('Doom skill sources are unavailable. Load @agimon-ai/doompi-skill.');\n  return service;\n}\n"],"mappings":";;;;AAKA,MAAa,6BAA6B;;;;;;;;;;;;;;;AAgB1C,MAAa,mCAAmC;AAchD,MAAM,wBAAwB;AAE9B,MAAa,wBAAwBA,QAAAA,KAAK,OAAO;CAC/C,WAAW;CACX,WAAW;CACX,SAAS;AACX,CAAC;AAED,MAAa,gCAAgCA,QAAAA,KAAK,OAChD;CACE,QAAQ;;CAER,aAAaA,QAAAA,KAAK,MAAMA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACvD,GACA,EAAE,sBAAsB,MAAM,CAChC;AAiCA,SAAS,kBAAkB,cAAgE;CACzF,OAAO;EAAE,QAAQ,aAAa;EAAQ,aAAa,CAAC,GAAG,aAAa,WAAW;CAAE;AACnF;AAEA,SAAS,qBAAqB,cAAgE;CAC5F,KAAA,GAAIC,cAAAA,MAAAA,CAAM,+BAA+B,YAAY,GAAG,OAAO,kBAAkB,YAAY;CAC7F,MAAM,CAAC,UAAA,GAASC,cAAAA,OAAAA,CAAO,+BAA+B,YAAY;CAClE,MAAM,IAAI,UACR,yCAAyC,QAAQ,OAAO,MAAM,gBAAgB,IAAI,IAAI,MAAM,YAAY,GAAG,EAC7G;AACF;;AAGA,SAAgB,8BAA8B,YAA6C;CACzF,IAAI,WAAW,WAAW,KAAK,WAAW,SAAS,uBACjD,MAAM,IAAI,UAAU,gDAAgD;CAGtE,MAAM,gCAAgB,IAAI,IAAmC;CAC7D,MAAM,4BAAY,IAAI,IAAiE;CACvF,IAAI,WAAW;CACf,IAAI,WAAW;CAEf,MAAM,qBAA2B;EAC/B,IAAI,UAAU,MAAM,IAAI,MAAM,6CAA6C;CAC7E;CACA,MAAM,aACJ,CAAC,GAAG,cAAc,OAAO,CAAC,CAAC,CACxB,KAAK,EAAE,mBAAmB,kBAAkB,YAAY,CAAC,CAAC,CAC1D,MAAM,MAAM,UAAU,KAAK,OAAO,cAAc,MAAM,MAAM,CAAC;CAClE,MAAM,eAAqB;EACzB,MAAM,gBAAgB,KAAK;EAC3B,KAAK,MAAM,YAAY,WAAW,SAAS,aAAa;CAC1D;CAsCA,OAAO,OAAO,OAAO;EAnCnB;EACA,SAAS,cAAc;GACrB,aAAa;GACb,MAAM,YAAY,qBAAqB,YAAY;GACnD,YAAY;GACZ,MAAM,QAAQ,OAAO,UAAU,MAAM;GACrC,MAAM,yBAAyB,GAAG,WAAW,gBAAgB;GAC7D,cAAc,IAAI,UAAU,QAAQ;IAAE;IAAO,cAAc;GAAU,CAAC;GACtE,OAAO;GACP,IAAI,uBAAuB;GAC3B,OAAO,OAAO,OAAO;IACnB,QAAQ,UAAU;IAClB,YAAY;IACZ,UAAU;KACR,IAAI,sBAAsB;KAC1B,uBAAuB;KACvB,IAAI,cAAc,IAAI,UAAU,MAAM,CAAC,EAAE,UAAU,OAAO;KAC1D,cAAc,OAAO,UAAU,MAAM;KACrC,OAAO;IACT;GACF,CAAC;EACH;EACA;EACA,UAAU,UAAU;GAClB,aAAa;GACb,UAAU,IAAI,QAAQ;GACtB,aAAa,UAAU,OAAO,QAAQ;EACxC;EACA,UAAU;GACR,IAAI,UAAU;GACd,WAAW;GACX,cAAc,MAAM;GACpB,UAAU,MAAM;EAClB;CAEyB,CAAC;AAC9B;AAEA,SAAgB,4BAA4B,SAAuD;CACjG,OAAO,QAAQ,IAAI,0BAA0B;AAC/C;AAEA,SAAgB,+BAA+B,SAA2C;CACxF,MAAM,UAAU,4BAA4B,OAAO;CACnD,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,mEAAmE;CACjG,OAAO;AACT"}

package/dist/schemas/skills.d.cts

@@ -0,0 +1,65 @@
+import { Type } from "typebox";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/skills.d.ts
+/** Provider-owned Cordis service for live skill-directory contributions. */
+export declare const DOOM_SKILL_SOURCES_SERVICE = "doom/skill-sources";
+/**
+ * The custom session entry journaled once Pi has rebuilt its resource catalog
+ * for a reload.
+ *
+ * A reload is the only thing that changes which skills exist, and Pi publishes
+ * nothing for it: the whole wire record of a `/domains` switch is the single
+ * `response:prompt` for the command that triggered it. An RPC client therefore
+ * has no way to learn that the `get_commands` answer it cached, which is what
+ * the web cockpit completes `$` from, now describes the previous domains.
+ *
+ * This entry is that missing signal. It rides Pi's `entry_appended` frames the
+ * way the minor-mode catalog projection does, so it needs no new protocol, and
+ * a custom entry with no registered renderer is invisible in the TUI.
+ */
+export declare const DOOM_RESOURCE_CATALOG_ENTRY_TYPE = "doom-resource-catalog";
+/**
+ * The payload of a resource-catalog entry.
+ *
+ * Arrival is the signal; a client re-reads the catalog rather than diffing
+ * this. The revision only distinguishes one rebuild from the next in a journal
+ * a human is reading.
+ */
+export interface ResourceCatalogProjection {
+  readonly version: 1;
+  readonly revision: number;
+}
+export declare const SkillSourceNameSchema: Type.TString;
+export declare const SkillSourceContributionSchema: Type.TObject<{
+  source: Type.TString;
+  /** Absolute directories, the same ones the source hands `resources_discover`. */
+  directories: Type.TArray<Type.TString>;
+}>;
+export interface SkillSourceContribution {
+  readonly source: string;
+  readonly directories: readonly string[];
+}
+export interface SkillSourceContributionHandle {
+  readonly source: string;
+  readonly generation: string;
+  dispose(): void;
+}
+/** Direct registrar/query/subscription seam owned by doompi-skill. */
+export interface DoomSkillSourcesService {
+  readonly generation: string;
+  register(contribution: SkillSourceContribution): SkillSourceContributionHandle;
+  list(): readonly SkillSourceContribution[];
+  subscribe(listener: (contributions: readonly SkillSourceContribution[]) => void): () => void;
+  dispose(): void;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/skill-sources': DoomSkillSourcesService;
+  }
+}
+/** Creates the provider-owned skill-source registry for one Cordis session. */
+export declare function createDoomSkillSourcesService(generation: string): DoomSkillSourcesService;
+export declare function readDoomSkillSourcesService(context: Context): DoomSkillSourcesService | undefined;
+export declare function requireDoomSkillSourcesService(context: Context): DoomSkillSourcesService;
+//#endregion
+//# sourceMappingURL=skills.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.cts","names":[],"sources":["../../src/schemas/skills.ts"],"mappings":";;;;qBAKa;;;;;;;;;;;;;;;qBAgBA;;;;;;;;iBASI;WACN;WACA;;qBAKE,uBAAqB,KAAA;qBAMrB,+BAA6B,KAAA;;;;;iBASzB;WACN;WACA;;iBAGM;WACN;WACA;EACT;;;iBAIe;WACN;EACT,SAAS,cAAc,0BAA0B;EACjD,iBAAiB;EACjB,UAAU,WAAW,wBAAwB;EAC7C;;;YAIU;IACR,sBAAsB;;;;wBAsBV,8BAA8B,qBAAqB;wBA6DnD,4BAA4B,SAAS,UAAU;wBAI/C,+BAA+B,SAAS,UAAU"}

package/dist/schemas/skills.d.mts

@@ -0,0 +1,65 @@
+import { Type } from "typebox";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/skills.d.ts
+/** Provider-owned Cordis service for live skill-directory contributions. */
+export declare const DOOM_SKILL_SOURCES_SERVICE = "doom/skill-sources";
+/**
+ * The custom session entry journaled once Pi has rebuilt its resource catalog
+ * for a reload.
+ *
+ * A reload is the only thing that changes which skills exist, and Pi publishes
+ * nothing for it: the whole wire record of a `/domains` switch is the single
+ * `response:prompt` for the command that triggered it. An RPC client therefore
+ * has no way to learn that the `get_commands` answer it cached, which is what
+ * the web cockpit completes `$` from, now describes the previous domains.
+ *
+ * This entry is that missing signal. It rides Pi's `entry_appended` frames the
+ * way the minor-mode catalog projection does, so it needs no new protocol, and
+ * a custom entry with no registered renderer is invisible in the TUI.
+ */
+export declare const DOOM_RESOURCE_CATALOG_ENTRY_TYPE = "doom-resource-catalog";
+/**
+ * The payload of a resource-catalog entry.
+ *
+ * Arrival is the signal; a client re-reads the catalog rather than diffing
+ * this. The revision only distinguishes one rebuild from the next in a journal
+ * a human is reading.
+ */
+export interface ResourceCatalogProjection {
+  readonly version: 1;
+  readonly revision: number;
+}
+export declare const SkillSourceNameSchema: Type.TString;
+export declare const SkillSourceContributionSchema: Type.TObject<{
+  source: Type.TString;
+  /** Absolute directories, the same ones the source hands `resources_discover`. */
+  directories: Type.TArray<Type.TString>;
+}>;
+export interface SkillSourceContribution {
+  readonly source: string;
+  readonly directories: readonly string[];
+}
+export interface SkillSourceContributionHandle {
+  readonly source: string;
+  readonly generation: string;
+  dispose(): void;
+}
+/** Direct registrar/query/subscription seam owned by doompi-skill. */
+export interface DoomSkillSourcesService {
+  readonly generation: string;
+  register(contribution: SkillSourceContribution): SkillSourceContributionHandle;
+  list(): readonly SkillSourceContribution[];
+  subscribe(listener: (contributions: readonly SkillSourceContribution[]) => void): () => void;
+  dispose(): void;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/skill-sources': DoomSkillSourcesService;
+  }
+}
+/** Creates the provider-owned skill-source registry for one Cordis session. */
+export declare function createDoomSkillSourcesService(generation: string): DoomSkillSourcesService;
+export declare function readDoomSkillSourcesService(context: Context): DoomSkillSourcesService | undefined;
+export declare function requireDoomSkillSourcesService(context: Context): DoomSkillSourcesService;
+//#endregion
+//# sourceMappingURL=skills.d.mts.map

package/dist/schemas/skills.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.mts","names":[],"sources":["../../src/schemas/skills.ts"],"mappings":";;;;qBAKa;;;;;;;;;;;;;;;qBAgBA;;;;;;;;iBASI;WACN;WACA;;qBAKE,uBAAqB,KAAA;qBAMrB,+BAA6B,KAAA;;;;;iBASzB;WACN;WACA;;iBAGM;WACN;WACA;EACT;;;iBAIe;WACN;EACT,SAAS,cAAc,0BAA0B;EACjD,iBAAiB;EACjB,UAAU,WAAW,wBAAwB;EAC7C;;;YAIU;IACR,sBAAsB;;;;wBAsBV,8BAA8B,qBAAqB;wBA6DnD,4BAA4B,SAAS,UAAU;wBAI/C,+BAA+B,SAAS,UAAU"}

package/dist/schemas/skills.mjs

@@ -0,0 +1,109 @@
+import { Type } from "typebox";
+import { Check, Errors } from "typebox/value";
+//#region src/schemas/skills.ts
+/** Provider-owned Cordis service for live skill-directory contributions. */
+const DOOM_SKILL_SOURCES_SERVICE = "doom/skill-sources";
+/**
+* The custom session entry journaled once Pi has rebuilt its resource catalog
+* for a reload.
+*
+* A reload is the only thing that changes which skills exist, and Pi publishes
+* nothing for it: the whole wire record of a `/domains` switch is the single
+* `response:prompt` for the command that triggered it. An RPC client therefore
+* has no way to learn that the `get_commands` answer it cached, which is what
+* the web cockpit completes `$` from, now describes the previous domains.
+*
+* This entry is that missing signal. It rides Pi's `entry_appended` frames the
+* way the minor-mode catalog projection does, so it needs no new protocol, and
+* a custom entry with no registered renderer is invisible in the TUI.
+*/
+const DOOM_RESOURCE_CATALOG_ENTRY_TYPE = "doom-resource-catalog";
+const MAX_GENERATION_LENGTH = 256;
+const SkillSourceNameSchema = Type.String({
+	minLength: 1,
+	maxLength: 128,
+	pattern: "^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$"
+});
+const SkillSourceContributionSchema = Type.Object({
+	source: SkillSourceNameSchema,
+	/** Absolute directories, the same ones the source hands `resources_discover`. */
+	directories: Type.Array(Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+function cloneContribution(contribution) {
+	return {
+		source: contribution.source,
+		directories: [...contribution.directories]
+	};
+}
+function validateContribution(contribution) {
+	if (Check(SkillSourceContributionSchema, contribution)) return cloneContribution(contribution);
+	const [first] = Errors(SkillSourceContributionSchema, contribution);
+	throw new TypeError(`Invalid Doom skill-source contribution${first ? ` at ${first.instancePath || "/"}: ${first.message}` : ""}.`);
+}
+/** Creates the provider-owned skill-source registry for one Cordis session. */
+function createDoomSkillSourcesService(generation) {
+	if (generation.length === 0 || generation.length > MAX_GENERATION_LENGTH) throw new TypeError("Doom skill sources require a valid generation.");
+	const registrations = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	let sequence = 0;
+	let disposed = false;
+	const ensureActive = () => {
+		if (disposed) throw new Error("The Doom skill-sources service is disposed.");
+	};
+	const list = () => [...registrations.values()].map(({ contribution }) => cloneContribution(contribution)).sort((left, right) => left.source.localeCompare(right.source));
+	const notify = () => {
+		const contributions = list();
+		for (const listener of listeners) listener(contributions);
+	};
+	return Object.freeze({
+		generation,
+		register(contribution) {
+			ensureActive();
+			const validated = validateContribution(contribution);
+			sequence += 1;
+			const token = Symbol(validated.source);
+			const registrationGeneration = `${generation}:skill-source:${sequence}`;
+			registrations.set(validated.source, {
+				token,
+				contribution: validated
+			});
+			notify();
+			let registrationDisposed = false;
+			return Object.freeze({
+				source: validated.source,
+				generation: registrationGeneration,
+				dispose() {
+					if (registrationDisposed) return;
+					registrationDisposed = true;
+					if (registrations.get(validated.source)?.token !== token) return;
+					registrations.delete(validated.source);
+					notify();
+				}
+			});
+		},
+		list,
+		subscribe(listener) {
+			ensureActive();
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			registrations.clear();
+			listeners.clear();
+		}
+	});
+}
+function readDoomSkillSourcesService(context) {
+	return context.get(DOOM_SKILL_SOURCES_SERVICE);
+}
+function requireDoomSkillSourcesService(context) {
+	const service = readDoomSkillSourcesService(context);
+	if (!service) throw new Error("Doom skill sources are unavailable. Load @agimon-ai/doompi-skill.");
+	return service;
+}
+//#endregion
+export { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService };
+
+//# sourceMappingURL=skills.mjs.map

package/dist/schemas/skills.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.mjs","names":[],"sources":["../../src/schemas/skills.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport { Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\n/** Provider-owned Cordis service for live skill-directory contributions. */\nexport const DOOM_SKILL_SOURCES_SERVICE = 'doom/skill-sources';\n\n/**\n * The custom session entry journaled once Pi has rebuilt its resource catalog\n * for a reload.\n *\n * A reload is the only thing that changes which skills exist, and Pi publishes\n * nothing for it: the whole wire record of a `/domains` switch is the single\n * `response:prompt` for the command that triggered it. An RPC client therefore\n * has no way to learn that the `get_commands` answer it cached, which is what\n * the web cockpit completes `$` from, now describes the previous domains.\n *\n * This entry is that missing signal. It rides Pi's `entry_appended` frames the\n * way the minor-mode catalog projection does, so it needs no new protocol, and\n * a custom entry with no registered renderer is invisible in the TUI.\n */\nexport const DOOM_RESOURCE_CATALOG_ENTRY_TYPE = 'doom-resource-catalog';\n\n/**\n * The payload of a resource-catalog entry.\n *\n * Arrival is the signal; a client re-reads the catalog rather than diffing\n * this. The revision only distinguishes one rebuild from the next in a journal\n * a human is reading.\n */\nexport interface ResourceCatalogProjection {\n  readonly version: 1;\n  readonly revision: number;\n}\n\nconst MAX_GENERATION_LENGTH = 256;\n\nexport const SkillSourceNameSchema = Type.String({\n  minLength: 1,\n  maxLength: 128,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const SkillSourceContributionSchema = Type.Object(\n  {\n    source: SkillSourceNameSchema,\n    /** Absolute directories, the same ones the source hands `resources_discover`. */\n    directories: Type.Array(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\n\nexport interface SkillSourceContribution {\n  readonly source: string;\n  readonly directories: readonly string[];\n}\n\nexport interface SkillSourceContributionHandle {\n  readonly source: string;\n  readonly generation: string;\n  dispose(): void;\n}\n\n/** Direct registrar/query/subscription seam owned by doompi-skill. */\nexport interface DoomSkillSourcesService {\n  readonly generation: string;\n  register(contribution: SkillSourceContribution): SkillSourceContributionHandle;\n  list(): readonly SkillSourceContribution[];\n  subscribe(listener: (contributions: readonly SkillSourceContribution[]) => void): () => void;\n  dispose(): void;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/skill-sources': DoomSkillSourcesService;\n  }\n}\n\ninterface RegisteredSkillSource {\n  readonly token: symbol;\n  readonly contribution: SkillSourceContribution;\n}\n\nfunction cloneContribution(contribution: SkillSourceContribution): SkillSourceContribution {\n  return { source: contribution.source, directories: [...contribution.directories] };\n}\n\nfunction validateContribution(contribution: SkillSourceContribution): SkillSourceContribution {\n  if (Check(SkillSourceContributionSchema, contribution)) return cloneContribution(contribution);\n  const [first] = Errors(SkillSourceContributionSchema, contribution);\n  throw new TypeError(\n    `Invalid Doom skill-source contribution${first ? ` at ${first.instancePath || '/'}: ${first.message}` : ''}.`,\n  );\n}\n\n/** Creates the provider-owned skill-source registry for one Cordis session. */\nexport function createDoomSkillSourcesService(generation: string): DoomSkillSourcesService {\n  if (generation.length === 0 || generation.length > MAX_GENERATION_LENGTH) {\n    throw new TypeError('Doom skill sources require a valid generation.');\n  }\n\n  const registrations = new Map<string, RegisteredSkillSource>();\n  const listeners = new Set<(contributions: readonly SkillSourceContribution[]) => void>();\n  let sequence = 0;\n  let disposed = false;\n\n  const ensureActive = (): void => {\n    if (disposed) throw new Error('The Doom skill-sources service is disposed.');\n  };\n  const list = (): readonly SkillSourceContribution[] =>\n    [...registrations.values()]\n      .map(({ contribution }) => cloneContribution(contribution))\n      .sort((left, right) => left.source.localeCompare(right.source));\n  const notify = (): void => {\n    const contributions = list();\n    for (const listener of listeners) listener(contributions);\n  };\n\n  const service: DoomSkillSourcesService = {\n    generation,\n    register(contribution) {\n      ensureActive();\n      const validated = validateContribution(contribution);\n      sequence += 1;\n      const token = Symbol(validated.source);\n      const registrationGeneration = `${generation}:skill-source:${sequence}`;\n      registrations.set(validated.source, { token, contribution: validated });\n      notify();\n      let registrationDisposed = false;\n      return Object.freeze({\n        source: validated.source,\n        generation: registrationGeneration,\n        dispose() {\n          if (registrationDisposed) return;\n          registrationDisposed = true;\n          if (registrations.get(validated.source)?.token !== token) return;\n          registrations.delete(validated.source);\n          notify();\n        },\n      });\n    },\n    list,\n    subscribe(listener) {\n      ensureActive();\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      registrations.clear();\n      listeners.clear();\n    },\n  };\n  return Object.freeze(service);\n}\n\nexport function readDoomSkillSourcesService(context: Context): DoomSkillSourcesService | undefined {\n  return context.get(DOOM_SKILL_SOURCES_SERVICE) as DoomSkillSourcesService | undefined;\n}\n\nexport function requireDoomSkillSourcesService(context: Context): DoomSkillSourcesService {\n  const service = readDoomSkillSourcesService(context);\n  if (!service) throw new Error('Doom skill sources are unavailable. Load @agimon-ai/doompi-skill.');\n  return service;\n}\n"],"mappings":";;;;AAKA,MAAa,6BAA6B;;;;;;;;;;;;;;;AAgB1C,MAAa,mCAAmC;AAchD,MAAM,wBAAwB;AAE9B,MAAa,wBAAwB,KAAK,OAAO;CAC/C,WAAW;CACX,WAAW;CACX,SAAS;AACX,CAAC;AAED,MAAa,gCAAgC,KAAK,OAChD;CACE,QAAQ;;CAER,aAAa,KAAK,MAAM,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACvD,GACA,EAAE,sBAAsB,MAAM,CAChC;AAiCA,SAAS,kBAAkB,cAAgE;CACzF,OAAO;EAAE,QAAQ,aAAa;EAAQ,aAAa,CAAC,GAAG,aAAa,WAAW;CAAE;AACnF;AAEA,SAAS,qBAAqB,cAAgE;CAC5F,IAAI,MAAM,+BAA+B,YAAY,GAAG,OAAO,kBAAkB,YAAY;CAC7F,MAAM,CAAC,SAAS,OAAO,+BAA+B,YAAY;CAClE,MAAM,IAAI,UACR,yCAAyC,QAAQ,OAAO,MAAM,gBAAgB,IAAI,IAAI,MAAM,YAAY,GAAG,EAC7G;AACF;;AAGA,SAAgB,8BAA8B,YAA6C;CACzF,IAAI,WAAW,WAAW,KAAK,WAAW,SAAS,uBACjD,MAAM,IAAI,UAAU,gDAAgD;CAGtE,MAAM,gCAAgB,IAAI,IAAmC;CAC7D,MAAM,4BAAY,IAAI,IAAiE;CACvF,IAAI,WAAW;CACf,IAAI,WAAW;CAEf,MAAM,qBAA2B;EAC/B,IAAI,UAAU,MAAM,IAAI,MAAM,6CAA6C;CAC7E;CACA,MAAM,aACJ,CAAC,GAAG,cAAc,OAAO,CAAC,CAAC,CACxB,KAAK,EAAE,mBAAmB,kBAAkB,YAAY,CAAC,CAAC,CAC1D,MAAM,MAAM,UAAU,KAAK,OAAO,cAAc,MAAM,MAAM,CAAC;CAClE,MAAM,eAAqB;EACzB,MAAM,gBAAgB,KAAK;EAC3B,KAAK,MAAM,YAAY,WAAW,SAAS,aAAa;CAC1D;CAsCA,OAAO,OAAO,OAAO;EAnCnB;EACA,SAAS,cAAc;GACrB,aAAa;GACb,MAAM,YAAY,qBAAqB,YAAY;GACnD,YAAY;GACZ,MAAM,QAAQ,OAAO,UAAU,MAAM;GACrC,MAAM,yBAAyB,GAAG,WAAW,gBAAgB;GAC7D,cAAc,IAAI,UAAU,QAAQ;IAAE;IAAO,cAAc;GAAU,CAAC;GACtE,OAAO;GACP,IAAI,uBAAuB;GAC3B,OAAO,OAAO,OAAO;IACnB,QAAQ,UAAU;IAClB,YAAY;IACZ,UAAU;KACR,IAAI,sBAAsB;KAC1B,uBAAuB;KACvB,IAAI,cAAc,IAAI,UAAU,MAAM,CAAC,EAAE,UAAU,OAAO;KAC1D,cAAc,OAAO,UAAU,MAAM;KACrC,OAAO;IACT;GACF,CAAC;EACH;EACA;EACA,UAAU,UAAU;GAClB,aAAa;GACb,UAAU,IAAI,QAAQ;GACtB,aAAa,UAAU,OAAO,QAAQ;EACxC;EACA,UAAU;GACR,IAAI,UAAU;GACd,WAAW;GACX,cAAc,MAAM;GACpB,UAAU,MAAM;EAClB;CAEyB,CAAC;AAC9B;AAEA,SAAgB,4BAA4B,SAAuD;CACjG,OAAO,QAAQ,IAAI,0BAA0B;AAC/C;AAEA,SAAgB,+BAA+B,SAA2C;CACxF,MAAM,UAAU,4BAA4B,OAAO;CACnD,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,mEAAmE;CACjG,OAAO;AACT"}

package/dist/schemas/toolOverrides.cjs

@@ -0,0 +1,17 @@
+//#region src/schemas/toolOverrides.ts
+/** Runtime-scoped ownership registry for Pi tool replacements. */
+const DOOM_TOOL_OVERRIDES_SERVICE = "doom/tool-overrides";
+function readDoomToolOverrides(context) {
+	return context.get(DOOM_TOOL_OVERRIDES_SERVICE);
+}
+function requireDoomToolOverrides(context) {
+	const service = readDoomToolOverrides(context);
+	if (!service) throw new Error("Doom tool overrides are unavailable. Start a Doom runtime first.");
+	return service;
+}
+//#endregion
+exports.DOOM_TOOL_OVERRIDES_SERVICE = DOOM_TOOL_OVERRIDES_SERVICE;
+exports.readDoomToolOverrides = readDoomToolOverrides;
+exports.requireDoomToolOverrides = requireDoomToolOverrides;
+
+//# sourceMappingURL=toolOverrides.cjs.map

package/dist/schemas/toolOverrides.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolOverrides.cjs","names":[],"sources":["../../src/schemas/toolOverrides.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Runtime-scoped ownership registry for Pi tool replacements. */\nexport const DOOM_TOOL_OVERRIDES_SERVICE = 'doom/tool-overrides';\n\nexport interface DoomToolOverrideClaim {\n  readonly source: string;\n  /** One atomic set. The claim is denied when any requested tool is already owned. */\n  readonly tools: readonly string[];\n}\n\nexport interface DoomToolOverrideRegistration {\n  readonly granted: boolean;\n  readonly tools: readonly string[];\n  /** Releases a granted claim. Repeated disposal is a no-op. */\n  dispose(): void;\n}\n\nexport interface DoomToolOverridesService {\n  readonly generation: string;\n  claim(claim: DoomToolOverrideClaim): DoomToolOverrideRegistration;\n  owner(tool: string): string | undefined;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/tool-overrides': DoomToolOverridesService;\n  }\n}\n\nexport function readDoomToolOverrides(context: Context): DoomToolOverridesService | undefined {\n  return context.get(DOOM_TOOL_OVERRIDES_SERVICE) as DoomToolOverridesService | undefined;\n}\n\nexport function requireDoomToolOverrides(context: Context): DoomToolOverridesService {\n  const service = readDoomToolOverrides(context);\n  if (!service) throw new Error('Doom tool overrides are unavailable. Start a Doom runtime first.');\n  return service;\n}\n"],"mappings":";;AAGA,MAAa,8BAA8B;AA2B3C,SAAgB,sBAAsB,SAAwD;CAC5F,OAAO,QAAQ,IAAI,2BAA2B;AAChD;AAEA,SAAgB,yBAAyB,SAA4C;CACnF,MAAM,UAAU,sBAAsB,OAAO;CAC7C,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,kEAAkE;CAChG,OAAO;AACT"}

package/dist/schemas/toolOverrides.d.cts

@@ -0,0 +1,29 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/toolOverrides.d.ts
+/** Runtime-scoped ownership registry for Pi tool replacements. */
+export declare const DOOM_TOOL_OVERRIDES_SERVICE = "doom/tool-overrides";
+export interface DoomToolOverrideClaim {
+  readonly source: string;
+  /** One atomic set. The claim is denied when any requested tool is already owned. */
+  readonly tools: readonly string[];
+}
+export interface DoomToolOverrideRegistration {
+  readonly granted: boolean;
+  readonly tools: readonly string[];
+  /** Releases a granted claim. Repeated disposal is a no-op. */
+  dispose(): void;
+}
+export interface DoomToolOverridesService {
+  readonly generation: string;
+  claim(claim: DoomToolOverrideClaim): DoomToolOverrideRegistration;
+  owner(tool: string): string | undefined;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/tool-overrides': DoomToolOverridesService;
+  }
+}
+export declare function readDoomToolOverrides(context: Context): DoomToolOverridesService | undefined;
+export declare function requireDoomToolOverrides(context: Context): DoomToolOverridesService;
+//#endregion
+//# sourceMappingURL=toolOverrides.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolOverrides.d.cts","names":[],"sources":["../../src/schemas/toolOverrides.ts"],"mappings":";;;qBAGa;iBAEI;WACN;;WAEA;;iBAGM;WACN;WACA;;EAET;;iBAGe;WACN;EACT,MAAM,OAAO,wBAAwB;EACrC,MAAM;;;YAII;IACR,uBAAuB;;;wBAIX,sBAAsB,SAAS,UAAU;wBAIzC,yBAAyB,SAAS,UAAU"}

package/dist/schemas/toolOverrides.d.mts

@@ -0,0 +1,29 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/toolOverrides.d.ts
+/** Runtime-scoped ownership registry for Pi tool replacements. */
+export declare const DOOM_TOOL_OVERRIDES_SERVICE = "doom/tool-overrides";
+export interface DoomToolOverrideClaim {
+  readonly source: string;
+  /** One atomic set. The claim is denied when any requested tool is already owned. */
+  readonly tools: readonly string[];
+}
+export interface DoomToolOverrideRegistration {
+  readonly granted: boolean;
+  readonly tools: readonly string[];
+  /** Releases a granted claim. Repeated disposal is a no-op. */
+  dispose(): void;
+}
+export interface DoomToolOverridesService {
+  readonly generation: string;
+  claim(claim: DoomToolOverrideClaim): DoomToolOverrideRegistration;
+  owner(tool: string): string | undefined;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/tool-overrides': DoomToolOverridesService;
+  }
+}
+export declare function readDoomToolOverrides(context: Context): DoomToolOverridesService | undefined;
+export declare function requireDoomToolOverrides(context: Context): DoomToolOverridesService;
+//#endregion
+//# sourceMappingURL=toolOverrides.d.mts.map

package/dist/schemas/toolOverrides.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolOverrides.d.mts","names":[],"sources":["../../src/schemas/toolOverrides.ts"],"mappings":";;;qBAGa;iBAEI;WACN;;WAEA;;iBAGM;WACN;WACA;;EAET;;iBAGe;WACN;EACT,MAAM,OAAO,wBAAwB;EACrC,MAAM;;;YAII;IACR,uBAAuB;;;wBAIX,sBAAsB,SAAS,UAAU;wBAIzC,yBAAyB,SAAS,UAAU"}

package/dist/schemas/toolOverrides.mjs

@@ -0,0 +1,15 @@
+//#region src/schemas/toolOverrides.ts
+/** Runtime-scoped ownership registry for Pi tool replacements. */
+const DOOM_TOOL_OVERRIDES_SERVICE = "doom/tool-overrides";
+function readDoomToolOverrides(context) {
+	return context.get(DOOM_TOOL_OVERRIDES_SERVICE);
+}
+function requireDoomToolOverrides(context) {
+	const service = readDoomToolOverrides(context);
+	if (!service) throw new Error("Doom tool overrides are unavailable. Start a Doom runtime first.");
+	return service;
+}
+//#endregion
+export { DOOM_TOOL_OVERRIDES_SERVICE, readDoomToolOverrides, requireDoomToolOverrides };
+
+//# sourceMappingURL=toolOverrides.mjs.map

package/dist/schemas/toolOverrides.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolOverrides.mjs","names":[],"sources":["../../src/schemas/toolOverrides.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Runtime-scoped ownership registry for Pi tool replacements. */\nexport const DOOM_TOOL_OVERRIDES_SERVICE = 'doom/tool-overrides';\n\nexport interface DoomToolOverrideClaim {\n  readonly source: string;\n  /** One atomic set. The claim is denied when any requested tool is already owned. */\n  readonly tools: readonly string[];\n}\n\nexport interface DoomToolOverrideRegistration {\n  readonly granted: boolean;\n  readonly tools: readonly string[];\n  /** Releases a granted claim. Repeated disposal is a no-op. */\n  dispose(): void;\n}\n\nexport interface DoomToolOverridesService {\n  readonly generation: string;\n  claim(claim: DoomToolOverrideClaim): DoomToolOverrideRegistration;\n  owner(tool: string): string | undefined;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/tool-overrides': DoomToolOverridesService;\n  }\n}\n\nexport function readDoomToolOverrides(context: Context): DoomToolOverridesService | undefined {\n  return context.get(DOOM_TOOL_OVERRIDES_SERVICE) as DoomToolOverridesService | undefined;\n}\n\nexport function requireDoomToolOverrides(context: Context): DoomToolOverridesService {\n  const service = readDoomToolOverrides(context);\n  if (!service) throw new Error('Doom tool overrides are unavailable. Start a Doom runtime first.');\n  return service;\n}\n"],"mappings":";;AAGA,MAAa,8BAA8B;AA2B3C,SAAgB,sBAAsB,SAAwD;CAC5F,OAAO,QAAQ,IAAI,2BAA2B;AAChD;AAEA,SAAgB,yBAAyB,SAA4C;CACnF,MAAM,UAAU,sBAAsB,OAAO;CAC7C,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,kEAAkE;CAChG,OAAO;AACT"}

package/dist/schemas/toolSurface.cjs

@@ -0,0 +1,17 @@
+//#region src/schemas/toolSurface.ts
+/** Session-scoped arbiter that owns the active Pi tool list. */
+const DOOM_TOOL_SURFACE_SERVICE = "doom/tool-surface";
+function readDoomToolSurface(context) {
+	return context.get(DOOM_TOOL_SURFACE_SERVICE);
+}
+function requireDoomToolSurface(context) {
+	const service = readDoomToolSurface(context);
+	if (!service) throw new Error("The Doom tool surface is unavailable. Start a Doom runtime first.");
+	return service;
+}
+//#endregion
+exports.DOOM_TOOL_SURFACE_SERVICE = DOOM_TOOL_SURFACE_SERVICE;
+exports.readDoomToolSurface = readDoomToolSurface;
+exports.requireDoomToolSurface = requireDoomToolSurface;
+
+//# sourceMappingURL=toolSurface.cjs.map

package/dist/schemas/toolSurface.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSurface.cjs","names":[],"sources":["../../src/schemas/toolSurface.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Session-scoped arbiter that owns the active Pi tool list. */\nexport const DOOM_TOOL_SURFACE_SERVICE = 'doom/tool-surface';\n\n/**\n * Narrows the tool list handed to it.\n *\n * `available` is every tool registered with the host. `incoming` is the list\n * produced by the restrictions registered before this one. Return a new list;\n * returning `incoming` unchanged is the no-op.\n */\nexport type DoomToolRestriction = (incoming: readonly string[], available: readonly string[]) => readonly string[];\n\nexport interface DoomToolRestrictionDefinition<TRestriction = DoomToolRestriction> {\n  /** Package-unique owner label, used for diagnostics and ordering ties. */\n  readonly source: string;\n  /** Layer that owns this restriction, gated by the kernel when set. */\n  readonly layer?: string;\n  readonly restrict: TRestriction;\n  subscribe?(listener: () => void): () => void;\n}\n\nexport interface DoomToolRestrictionHandle {\n  /** Swap the restriction in place and reapply, keeping registration order. */\n  update(restrict: DoomToolRestriction): void;\n  /** Drop the restriction and reapply. The previous surface returns by itself. */\n  dispose(): void;\n}\n\n/**\n * The only writer of the host's active tool list.\n *\n * Owners register a restriction instead of snapshotting and restoring the tool\n * list themselves. Removal is inherent: dropping a restriction recomputes the\n * surface from the full set of registered tools, so no owner has to remember\n * what the list looked like before it started.\n */\nexport interface DoomToolSurfaceService {\n  readonly generation: string;\n  register(definition: DoomToolRestrictionDefinition): DoomToolRestrictionHandle;\n  /** Recompute and push. Call when the registered tool set itself changed. */\n  refresh(): void;\n  /** Layers currently active; restrictions owned by other layers stay dormant. */\n  setActiveLayers(layers: readonly string[]): void;\n  /** The list most recently reconciled with the host. */\n  active(): readonly string[];\n  dispose(): void;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/tool-surface': DoomToolSurfaceService;\n  }\n}\n\nexport function readDoomToolSurface(context: Context): DoomToolSurfaceService | undefined {\n  return context.get(DOOM_TOOL_SURFACE_SERVICE) as DoomToolSurfaceService | undefined;\n}\n\nexport function requireDoomToolSurface(context: Context): DoomToolSurfaceService {\n  const service = readDoomToolSurface(context);\n  if (!service) throw new Error('The Doom tool surface is unavailable. Start a Doom runtime first.');\n  return service;\n}\n"],"mappings":";;AAGA,MAAa,4BAA4B;AAqDzC,SAAgB,oBAAoB,SAAsD;CACxF,OAAO,QAAQ,IAAI,yBAAyB;AAC9C;AAEA,SAAgB,uBAAuB,SAA0C;CAC/E,MAAM,UAAU,oBAAoB,OAAO;CAC3C,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,mEAAmE;CACjG,OAAO;AACT"}

package/dist/schemas/toolSurface.d.cts

@@ -0,0 +1,54 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/toolSurface.d.ts
+/** Session-scoped arbiter that owns the active Pi tool list. */
+export declare const DOOM_TOOL_SURFACE_SERVICE = "doom/tool-surface";
+/**
+ * Narrows the tool list handed to it.
+ *
+ * `available` is every tool registered with the host. `incoming` is the list
+ * produced by the restrictions registered before this one. Return a new list;
+ * returning `incoming` unchanged is the no-op.
+ */
+export type DoomToolRestriction = (incoming: readonly string[], available: readonly string[]) => readonly string[];
+export interface DoomToolRestrictionDefinition<TRestriction = DoomToolRestriction> {
+  /** Package-unique owner label, used for diagnostics and ordering ties. */
+  readonly source: string;
+  /** Layer that owns this restriction, gated by the kernel when set. */
+  readonly layer?: string;
+  readonly restrict: TRestriction;
+  subscribe?(listener: () => void): () => void;
+}
+export interface DoomToolRestrictionHandle {
+  /** Swap the restriction in place and reapply, keeping registration order. */
+  update(restrict: DoomToolRestriction): void;
+  /** Drop the restriction and reapply. The previous surface returns by itself. */
+  dispose(): void;
+}
+/**
+ * The only writer of the host's active tool list.
+ *
+ * Owners register a restriction instead of snapshotting and restoring the tool
+ * list themselves. Removal is inherent: dropping a restriction recomputes the
+ * surface from the full set of registered tools, so no owner has to remember
+ * what the list looked like before it started.
+ */
+export interface DoomToolSurfaceService {
+  readonly generation: string;
+  register(definition: DoomToolRestrictionDefinition): DoomToolRestrictionHandle;
+  /** Recompute and push. Call when the registered tool set itself changed. */
+  refresh(): void;
+  /** Layers currently active; restrictions owned by other layers stay dormant. */
+  setActiveLayers(layers: readonly string[]): void;
+  /** The list most recently reconciled with the host. */
+  active(): readonly string[];
+  dispose(): void;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/tool-surface': DoomToolSurfaceService;
+  }
+}
+export declare function readDoomToolSurface(context: Context): DoomToolSurfaceService | undefined;
+export declare function requireDoomToolSurface(context: Context): DoomToolSurfaceService;
+//#endregion
+//# sourceMappingURL=toolSurface.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolSurface.d.cts","names":[],"sources":["../../src/schemas/toolSurface.ts"],"mappings":";;;qBAGa;;;;;;;;YASD,uBAAuB,6BAA6B;iBAE/C,8BAA8B,eAAe;;WAEnD;;WAEA;WACA,UAAU;EACnB,WAAW;;iBAGI;;EAEf,OAAO,UAAU;;EAEjB;;;;;;;;;;iBAWe;WACN;EACT,SAAS,YAAY,gCAAgC;;EAErD;;EAEA,gBAAgB;;EAEhB;EACA;;;YAIU;IACR,qBAAqB;;;wBAIT,oBAAoB,SAAS,UAAU;wBAIvC,uBAAuB,SAAS,UAAU"}