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

package/dist/src/schemas/help.cjs

@@ -0,0 +1,281 @@
+let typebox = require("typebox");
+let typebox_value = require("typebox/value");
+//#region src/schemas/help.ts
+/** Provider-owned Cordis service for the live Help catalog. */
+const DOOM_HELP_SERVICE = "doom/help";
+const DOOM_HELP_WHEN = {
+	state: { "minor-mode": "help" },
+	attribution: {
+		kind: "minor",
+		mode: "help"
+	}
+};
+const DOOM_HELP_MAX_CONTRIBUTORS = 32;
+const DOOM_HELP_MAX_SKILLS = 64;
+const DOOM_HELP_MAX_DIAGNOSTICS = 64;
+const DOOM_HELP_MAX_DESCRIPTION_LENGTH = 512;
+const DOOM_HELP_MAX_DIAGNOSTIC_LENGTH = 512;
+const MAX_SOURCE_LENGTH = 128;
+const MAX_SKILL_NAME_LENGTH = 64;
+const MAX_MODULE_URL_LENGTH = 4096;
+const MAX_IDENTIFIER_LENGTH = 256;
+const DOOM_HELP_ERROR_CODE = {
+	contributorLimit: "HELP_CONTRIBUTOR_LIMIT",
+	disposed: "HELP_DISPOSED",
+	duplicateSkill: "HELP_DUPLICATE_SKILL",
+	inactiveSnapshot: "HELP_INACTIVE_SNAPSHOT",
+	invalidContribution: "HELP_INVALID_CONTRIBUTION",
+	invalidGeneration: "HELP_INVALID_GENERATION",
+	invalidSnapshot: "HELP_INVALID_SNAPSHOT"
+};
+var DoomHelpError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "DoomHelpError";
+		this.code = code;
+	}
+};
+const DoomHelpSourceSchema = typebox.Type.String({
+	minLength: 1,
+	maxLength: MAX_SOURCE_LENGTH,
+	pattern: "^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$"
+});
+const DoomHelpSkillNameSchema = typebox.Type.String({
+	minLength: 1,
+	maxLength: MAX_SKILL_NAME_LENGTH,
+	pattern: "^[a-z0-9][a-z0-9-]*$"
+});
+const DoomHelpSkillDescriptorSchema = typebox.Type.Object({
+	name: DoomHelpSkillNameSchema,
+	description: typebox.Type.String({
+		minLength: 1,
+		maxLength: 512
+	})
+}, { additionalProperties: false });
+const DoomHelpContributionSchema = typebox.Type.Object({
+	source: DoomHelpSourceSchema,
+	moduleUrl: typebox.Type.String({
+		minLength: 1,
+		maxLength: MAX_MODULE_URL_LENGTH
+	}),
+	skills: typebox.Type.Array(DoomHelpSkillDescriptorSchema, {
+		minItems: 1,
+		maxItems: 64
+	})
+}, { additionalProperties: false });
+const GenerationSchema = typebox.Type.String({
+	minLength: 1,
+	maxLength: MAX_IDENTIFIER_LENGTH
+});
+const DoomHelpActivationSchema = typebox.Type.Union([
+	typebox.Type.Literal("inactive"),
+	typebox.Type.Literal("activating"),
+	typebox.Type.Literal("active"),
+	typebox.Type.Literal("degraded")
+]);
+const DoomHelpSkillSchema = typebox.Type.Object({
+	source: DoomHelpSourceSchema,
+	name: DoomHelpSkillNameSchema,
+	description: typebox.Type.String({
+		minLength: 1,
+		maxLength: 512
+	}),
+	filePath: typebox.Type.String({
+		minLength: 1,
+		maxLength: MAX_MODULE_URL_LENGTH
+	}),
+	baseDir: typebox.Type.String({
+		minLength: 1,
+		maxLength: MAX_MODULE_URL_LENGTH
+	})
+}, { additionalProperties: false });
+const DoomHelpDiagnosticSchema = typebox.Type.Object({
+	source: typebox.Type.Optional(DoomHelpSourceSchema),
+	code: typebox.Type.String({
+		minLength: 1,
+		maxLength: 64,
+		pattern: "^[A-Z0-9_]+$"
+	}),
+	message: typebox.Type.String({
+		minLength: 1,
+		maxLength: 512
+	})
+}, { additionalProperties: false });
+const DoomHelpSnapshotSchema = typebox.Type.Object({
+	hostGeneration: GenerationSchema,
+	revision: typebox.Type.Integer({ minimum: 0 }),
+	activation: DoomHelpActivationSchema,
+	skills: typebox.Type.Array(DoomHelpSkillSchema, { maxItems: 64 }),
+	diagnostics: typebox.Type.Array(DoomHelpDiagnosticSchema, { maxItems: 64 })
+}, { additionalProperties: false });
+function schemaFailure(schema, value) {
+	const [first] = (0, typebox_value.Errors)(schema, value);
+	return first ? ` at ${first.instancePath || "/"}: ${first.message}` : "";
+}
+function cloneContribution(contribution) {
+	return {
+		source: contribution.source,
+		moduleUrl: contribution.moduleUrl,
+		skills: contribution.skills.map((skill) => ({ ...skill }))
+	};
+}
+function cloneSnapshot(snapshot) {
+	return {
+		...snapshot,
+		skills: snapshot.skills.map((skill) => ({ ...skill })),
+		diagnostics: snapshot.diagnostics.map((diagnostic) => ({ ...diagnostic }))
+	};
+}
+function validateContribution(contribution) {
+	if (!(0, typebox_value.Check)(DoomHelpContributionSchema, contribution)) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.invalidContribution, `Invalid Help contribution${schemaFailure(DoomHelpContributionSchema, contribution)}.`);
+	const names = /* @__PURE__ */ new Set();
+	for (const skill of contribution.skills) {
+		if (names.has(skill.name)) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.duplicateSkill, `Help contribution '${contribution.source}' declares duplicate skill '${skill.name}'.`);
+		names.add(skill.name);
+	}
+	return cloneContribution(contribution);
+}
+/** Creates the provider-owned Help service value for one Cordis session. */
+function createDoomHelpService(generation) {
+	if (!(0, typebox_value.Check)(GenerationSchema, generation)) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.invalidGeneration, "Doom Help requires a valid generation.");
+	const contributions = /* @__PURE__ */ new Map();
+	const contributionListeners = /* @__PURE__ */ new Set();
+	const snapshotListeners = /* @__PURE__ */ new Set();
+	let registrationSequence = 0;
+	let disposed = false;
+	let skillInventory;
+	let snapshot = {
+		hostGeneration: generation,
+		revision: 0,
+		activation: "inactive",
+		skills: [],
+		diagnostics: []
+	};
+	const ensureActive = () => {
+		if (disposed) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.disposed, "The Doom Help service is disposed.");
+	};
+	const list = () => [...contributions.values()].map(({ contribution }) => cloneContribution(contribution)).sort((left, right) => left.source.localeCompare(right.source));
+	const notifyContributions = () => {
+		const value = list();
+		for (const listener of contributionListeners) listener(value);
+	};
+	return Object.freeze({
+		generation,
+		register(contribution) {
+			ensureActive();
+			const validated = validateContribution(contribution);
+			if (!contributions.has(validated.source) && contributions.size >= 32) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.contributorLimit, `Help accepts at most 32 contributors.`);
+			registrationSequence += 1;
+			const token = Symbol(validated.source);
+			const registrationGeneration = `${generation}:help:${registrationSequence}`;
+			contributions.set(validated.source, {
+				token,
+				generation: registrationGeneration,
+				contribution: validated
+			});
+			notifyContributions();
+			let registrationDisposed = false;
+			return Object.freeze({
+				source: validated.source,
+				generation: registrationGeneration,
+				dispose() {
+					if (registrationDisposed) return;
+					registrationDisposed = true;
+					if (contributions.get(validated.source)?.token !== token) return;
+					contributions.delete(validated.source);
+					notifyContributions();
+				}
+			});
+		},
+		listContributions: list,
+		subscribeContributions(listener) {
+			ensureActive();
+			contributionListeners.add(listener);
+			return () => contributionListeners.delete(listener);
+		},
+		getSnapshot: () => cloneSnapshot(snapshot),
+		publish(draft) {
+			ensureActive();
+			if (draft.activation === "inactive" && draft.skills.length > 0) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.inactiveSnapshot, "Inactive Help snapshots cannot expose skills.");
+			const next = {
+				hostGeneration: generation,
+				revision: snapshot.revision + 1,
+				activation: draft.activation,
+				skills: draft.skills.map((skill) => ({ ...skill })),
+				diagnostics: draft.diagnostics.map((diagnostic) => ({ ...diagnostic }))
+			};
+			if (!(0, typebox_value.Check)(DoomHelpSnapshotSchema, next)) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.invalidSnapshot, `Invalid Help snapshot${schemaFailure(DoomHelpSnapshotSchema, next)}.`);
+			snapshot = next;
+			const published = cloneSnapshot(snapshot);
+			for (const listener of snapshotListeners) listener(cloneSnapshot(published));
+			return published;
+		},
+		subscribeSnapshot(listener) {
+			ensureActive();
+			snapshotListeners.add(listener);
+			return () => snapshotListeners.delete(listener);
+		},
+		bindSkillInventory(read) {
+			ensureActive();
+			const token = Symbol("help-skill-inventory");
+			skillInventory = {
+				token,
+				read
+			};
+			return () => {
+				if (skillInventory?.token === token) skillInventory = void 0;
+			};
+		},
+		async inspectSkills() {
+			if (disposed) return void 0;
+			if (snapshot.activation === "inactive") return [];
+			const reader = skillInventory;
+			if (!reader) return void 0;
+			const revision = snapshot.revision;
+			const paths = await reader.read();
+			if (disposed || reader !== skillInventory || revision !== snapshot.revision || paths === void 0) return void 0;
+			const accepted = new Set(paths);
+			return snapshot.skills.filter((skill) => accepted.has(skill.filePath)).map((skill) => ({ ...skill }));
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			skillInventory = void 0;
+			contributions.clear();
+			contributionListeners.clear();
+			snapshotListeners.clear();
+		}
+	});
+}
+function readDoomHelpService(context) {
+	return context.get(DOOM_HELP_SERVICE);
+}
+function requireDoomHelpService(context) {
+	const service = readDoomHelpService(context);
+	if (!service) throw new Error("Doom Help is unavailable. Load @agimon-ai/doompi-help.");
+	return service;
+}
+//#endregion
+exports.DOOM_HELP_ERROR_CODE = DOOM_HELP_ERROR_CODE;
+exports.DOOM_HELP_MAX_CONTRIBUTORS = DOOM_HELP_MAX_CONTRIBUTORS;
+exports.DOOM_HELP_MAX_DESCRIPTION_LENGTH = DOOM_HELP_MAX_DESCRIPTION_LENGTH;
+exports.DOOM_HELP_MAX_DIAGNOSTICS = DOOM_HELP_MAX_DIAGNOSTICS;
+exports.DOOM_HELP_MAX_DIAGNOSTIC_LENGTH = DOOM_HELP_MAX_DIAGNOSTIC_LENGTH;
+exports.DOOM_HELP_MAX_SKILLS = DOOM_HELP_MAX_SKILLS;
+exports.DOOM_HELP_SERVICE = DOOM_HELP_SERVICE;
+exports.DOOM_HELP_WHEN = DOOM_HELP_WHEN;
+exports.DoomHelpActivationSchema = DoomHelpActivationSchema;
+exports.DoomHelpContributionSchema = DoomHelpContributionSchema;
+exports.DoomHelpDiagnosticSchema = DoomHelpDiagnosticSchema;
+exports.DoomHelpError = DoomHelpError;
+exports.DoomHelpSkillDescriptorSchema = DoomHelpSkillDescriptorSchema;
+exports.DoomHelpSkillNameSchema = DoomHelpSkillNameSchema;
+exports.DoomHelpSkillSchema = DoomHelpSkillSchema;
+exports.DoomHelpSnapshotSchema = DoomHelpSnapshotSchema;
+exports.DoomHelpSourceSchema = DoomHelpSourceSchema;
+exports.createDoomHelpService = createDoomHelpService;
+exports.readDoomHelpService = readDoomHelpService;
+exports.requireDoomHelpService = requireDoomHelpService;
+
+//# sourceMappingURL=help.cjs.map

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

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

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

@@ -0,0 +1,119 @@
+import { Static, Type } from "typebox";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/help.d.ts
+/** Provider-owned Cordis service for the live Help catalog. */
+export declare const DOOM_HELP_SERVICE = "doom/help";
+export declare const DOOM_HELP_WHEN: {
+  readonly state: {
+    readonly 'minor-mode': 'help';
+  };
+  readonly attribution: {
+    readonly kind: 'minor';
+    readonly mode: 'help';
+  };
+};
+export declare const DOOM_HELP_MAX_CONTRIBUTORS = 32;
+export declare const DOOM_HELP_MAX_SKILLS = 64;
+export declare const DOOM_HELP_MAX_DIAGNOSTICS = 64;
+export declare const DOOM_HELP_MAX_DESCRIPTION_LENGTH = 512;
+export declare const DOOM_HELP_MAX_DIAGNOSTIC_LENGTH = 512;
+export declare const DOOM_HELP_ERROR_CODE: {
+  readonly contributorLimit: 'HELP_CONTRIBUTOR_LIMIT';
+  readonly disposed: 'HELP_DISPOSED';
+  readonly duplicateSkill: 'HELP_DUPLICATE_SKILL';
+  readonly inactiveSnapshot: 'HELP_INACTIVE_SNAPSHOT';
+  readonly invalidContribution: 'HELP_INVALID_CONTRIBUTION';
+  readonly invalidGeneration: 'HELP_INVALID_GENERATION';
+  readonly invalidSnapshot: 'HELP_INVALID_SNAPSHOT';
+};
+export type DoomHelpErrorCode = (typeof DOOM_HELP_ERROR_CODE)[keyof typeof DOOM_HELP_ERROR_CODE];
+export declare class DoomHelpError extends Error {
+  readonly code: DoomHelpErrorCode;
+  constructor(code: DoomHelpErrorCode, message: string);
+}
+export declare const DoomHelpSourceSchema: Type.TString;
+export declare const DoomHelpSkillNameSchema: Type.TString;
+export declare const DoomHelpSkillDescriptorSchema: Type.TObject<{
+  name: Type.TString;
+  description: Type.TString;
+}>;
+export type DoomHelpSkillDescriptor = Static<typeof DoomHelpSkillDescriptorSchema>;
+export declare const DoomHelpContributionSchema: Type.TObject<{
+  source: Type.TString;
+  moduleUrl: Type.TString;
+  skills: Type.TArray<Type.TObject<{
+    name: Type.TString;
+    description: Type.TString;
+  }>>;
+}>;
+export type DoomHelpContribution = Static<typeof DoomHelpContributionSchema>;
+export declare const DoomHelpActivationSchema: Type.TUnion<[Type.TLiteral<"inactive">, Type.TLiteral<"activating">, Type.TLiteral<"active">, Type.TLiteral<"degraded">]>;
+export type DoomHelpActivation = Static<typeof DoomHelpActivationSchema>;
+export declare const DoomHelpSkillSchema: Type.TObject<{
+  source: Type.TString;
+  name: Type.TString;
+  description: Type.TString;
+  filePath: Type.TString;
+  baseDir: Type.TString;
+}>;
+export type DoomHelpSkill = Static<typeof DoomHelpSkillSchema>;
+export declare const DoomHelpDiagnosticSchema: Type.TObject<{
+  source: Type.TOptional<Type.TString>;
+  code: Type.TString;
+  message: Type.TString;
+}>;
+export type DoomHelpDiagnostic = Static<typeof DoomHelpDiagnosticSchema>;
+export declare const DoomHelpSnapshotSchema: Type.TObject<{
+  hostGeneration: Type.TString;
+  revision: Type.TInteger;
+  activation: Type.TUnion<[Type.TLiteral<"inactive">, Type.TLiteral<"activating">, Type.TLiteral<"active">, Type.TLiteral<"degraded">]>;
+  skills: Type.TArray<Type.TObject<{
+    source: Type.TString;
+    name: Type.TString;
+    description: Type.TString;
+    filePath: Type.TString;
+    baseDir: Type.TString;
+  }>>;
+  diagnostics: Type.TArray<Type.TObject<{
+    source: Type.TOptional<Type.TString>;
+    code: Type.TString;
+    message: Type.TString;
+  }>>;
+}>;
+export type DoomHelpSnapshot = Static<typeof DoomHelpSnapshotSchema>;
+export interface DoomHelpSnapshotDraft {
+  readonly activation: DoomHelpActivation;
+  readonly skills: readonly DoomHelpSkill[];
+  readonly diagnostics: readonly DoomHelpDiagnostic[];
+}
+export interface DoomHelpContributionHandle {
+  readonly source: string;
+  readonly generation: string;
+  dispose(): void;
+}
+/** Direct, session-local registrar and query surface owned by doompi-help. */
+export interface DoomHelpService {
+  readonly generation: string;
+  register(contribution: DoomHelpContribution): DoomHelpContributionHandle;
+  listContributions(): readonly DoomHelpContribution[];
+  subscribeContributions(listener: (contributions: readonly DoomHelpContribution[]) => void): () => void;
+  getSnapshot(): DoomHelpSnapshot;
+  publish(snapshot: DoomHelpSnapshotDraft): DoomHelpSnapshot;
+  subscribeSnapshot(listener: (snapshot: DoomHelpSnapshot) => void): () => void;
+  /** Bind the skill consumer's accepted file paths, without duplicating its inventory. */
+  bindSkillInventory(read: () => Promise<readonly string[] | undefined>): () => void;
+  /** Accepted Help skills, or undefined while the consumer is absent, discovering, or superseded. */
+  inspectSkills(): Promise<readonly DoomHelpSkill[] | undefined>;
+  dispose(): void;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/help': DoomHelpService;
+  }
+}
+/** Creates the provider-owned Help service value for one Cordis session. */
+export declare function createDoomHelpService(generation: string): DoomHelpService;
+export declare function readDoomHelpService(context: Context): DoomHelpService | undefined;
+export declare function requireDoomHelpService(context: Context): DoomHelpService;
+//#endregion
+//# sourceMappingURL=help.d.mts.map

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

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