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

package/dist/src/schemas/help.mjs

@@ -0,0 +1,262 @@
+import { Type } from "typebox";
+import { Check, Errors } from "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 = Type.String({
+	minLength: 1,
+	maxLength: MAX_SOURCE_LENGTH,
+	pattern: "^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$"
+});
+const DoomHelpSkillNameSchema = Type.String({
+	minLength: 1,
+	maxLength: MAX_SKILL_NAME_LENGTH,
+	pattern: "^[a-z0-9][a-z0-9-]*$"
+});
+const DoomHelpSkillDescriptorSchema = Type.Object({
+	name: DoomHelpSkillNameSchema,
+	description: Type.String({
+		minLength: 1,
+		maxLength: 512
+	})
+}, { additionalProperties: false });
+const DoomHelpContributionSchema = Type.Object({
+	source: DoomHelpSourceSchema,
+	moduleUrl: Type.String({
+		minLength: 1,
+		maxLength: MAX_MODULE_URL_LENGTH
+	}),
+	skills: Type.Array(DoomHelpSkillDescriptorSchema, {
+		minItems: 1,
+		maxItems: 64
+	})
+}, { additionalProperties: false });
+const GenerationSchema = Type.String({
+	minLength: 1,
+	maxLength: MAX_IDENTIFIER_LENGTH
+});
+const DoomHelpActivationSchema = Type.Union([
+	Type.Literal("inactive"),
+	Type.Literal("activating"),
+	Type.Literal("active"),
+	Type.Literal("degraded")
+]);
+const DoomHelpSkillSchema = Type.Object({
+	source: DoomHelpSourceSchema,
+	name: DoomHelpSkillNameSchema,
+	description: Type.String({
+		minLength: 1,
+		maxLength: 512
+	}),
+	filePath: Type.String({
+		minLength: 1,
+		maxLength: MAX_MODULE_URL_LENGTH
+	}),
+	baseDir: Type.String({
+		minLength: 1,
+		maxLength: MAX_MODULE_URL_LENGTH
+	})
+}, { additionalProperties: false });
+const DoomHelpDiagnosticSchema = Type.Object({
+	source: Type.Optional(DoomHelpSourceSchema),
+	code: Type.String({
+		minLength: 1,
+		maxLength: 64,
+		pattern: "^[A-Z0-9_]+$"
+	}),
+	message: Type.String({
+		minLength: 1,
+		maxLength: 512
+	})
+}, { additionalProperties: false });
+const DoomHelpSnapshotSchema = Type.Object({
+	hostGeneration: GenerationSchema,
+	revision: Type.Integer({ minimum: 0 }),
+	activation: DoomHelpActivationSchema,
+	skills: Type.Array(DoomHelpSkillSchema, { maxItems: 64 }),
+	diagnostics: Type.Array(DoomHelpDiagnosticSchema, { maxItems: 64 })
+}, { additionalProperties: false });
+function schemaFailure(schema, value) {
+	const [first] = 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 (!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 (!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 (!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
+export { DOOM_HELP_ERROR_CODE, DOOM_HELP_MAX_CONTRIBUTORS, DOOM_HELP_MAX_DESCRIPTION_LENGTH, DOOM_HELP_MAX_DIAGNOSTICS, DOOM_HELP_MAX_DIAGNOSTIC_LENGTH, DOOM_HELP_MAX_SKILLS, DOOM_HELP_SERVICE, DOOM_HELP_WHEN, DoomHelpActivationSchema, DoomHelpContributionSchema, DoomHelpDiagnosticSchema, DoomHelpError, DoomHelpSkillDescriptorSchema, DoomHelpSkillNameSchema, DoomHelpSkillSchema, DoomHelpSnapshotSchema, DoomHelpSourceSchema, createDoomHelpService, readDoomHelpService, requireDoomHelpService };
+
+//# sourceMappingURL=help.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.mjs","names":[],"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/hubChannel.cjs

@@ -0,0 +1,20 @@
+//#region src/schemas/hubChannel.ts
+/**
+* Provenance of a session a workflow step opened.
+*
+* The step's conversation belongs to the workflow that ran it and is read in
+* that workflow's view, so the session rail leaves such sessions out.
+*/
+const WORKFLOW_STEP_SESSION_PROVENANCE = "workflow";
+/**
+* Provenance of a session opened to launch workflows for its parent.
+*
+* It picks and starts work, then closes; the runs it started belong to its
+* parent. Like a detached helper, it takes no row in the session rail.
+*/
+const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = "workflow-dispatcher";
+//#endregion
+exports.WORKFLOW_DISPATCHER_SESSION_PROVENANCE = WORKFLOW_DISPATCHER_SESSION_PROVENANCE;
+exports.WORKFLOW_STEP_SESSION_PROVENANCE = WORKFLOW_STEP_SESSION_PROVENANCE;
+
+//# sourceMappingURL=hubChannel.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hubChannel.cjs","names":[],"sources":["../../../src/schemas/hubChannel.ts"],"sourcesContent":["export interface DoomHubChannelFrame {\n  type: string;\n  sessionId: string;\n  payload: unknown;\n}\n\n/** Same-process lifecycle bus shared by a host's session APIs and hub channels. */\nexport interface DoomDirectEventSubscriptionOptions {\n  /** Replay the most recent value published for this frame and session, when one exists. */\n  readonly replayLatest?: boolean;\n}\n\nexport interface DoomDirectEventBus {\n  publish(frameType: string, sessionId: string, payload: unknown): void;\n  subscribe(\n    frameType: string,\n    sessionId: string,\n    listener: (payload: unknown) => void,\n    options?: DoomDirectEventSubscriptionOptions,\n  ): () => void;\n  /** Drop retained state for a session after its lifecycle ends. */\n  clearSession?(sessionId: string): void;\n  close(): void;\n}\n\n/**\n * The extension-agnostic baseline every surface gets for one session, computed once by the\n * session host. Extensions build on it instead of re-deriving roots and relations from cwd.\n */\nexport interface DoomSessionContext {\n  readonly sessionId: string;\n  /** Persisted workspace id, shared by every session and member checkout of the workspace. */\n  readonly workspaceId: string;\n  /** The admitted workspace root. It owns configuration, composition and settings. */\n  readonly workspaceRoot: string;\n  /**\n   * The checkout the session executes in. Equals workspaceRoot unless the session runs in a\n   * member checkout, such as a worktree, which may live outside the workspace folder.\n   */\n  readonly checkoutRoot: string;\n  readonly cwd: string;\n  readonly parentSessionId?: string;\n  /** The spawner's label for the session. Opaque: hosts never interpret it. */\n  readonly provenance?: string;\n}\n\nexport interface DoomHubSessionScope {\n  sessionId: string;\n  workspaceId?: string;\n  cwd: string;\n  /** Environment admitted for this session, when supplied by the host. */\n  environment?: Readonly<Record<string, string | undefined>>;\n  /** The session's baseline context, when its host knows its workspace. */\n  sessionContext?: DoomSessionContext;\n}\n\nexport interface DoomHubReservedWorktreeRequest {\n  readonly reservationId: string;\n  readonly parentSessionId: string;\n  readonly signal?: AbortSignal;\n}\n\nexport type DoomHubReservedWorktreeProvisioner = (\n  request: DoomHubReservedWorktreeRequest,\n) => Promise<DoomHubSessionScope>;\n\n/** Selection axes a caller pins for a new session instead of the workspace defaults. */\nexport interface DoomHubSessionSelection {\n  readonly majorMode?: string;\n  readonly minorModes?: readonly string[];\n  readonly profile?: string;\n  /** An empty list starts the session with no domains. */\n  readonly domains?: readonly string[];\n}\n\n/**\n * Provenance of a session a workflow step opened.\n *\n * The step's conversation belongs to the workflow that ran it and is read in\n * that workflow's view, so the session rail leaves such sessions out.\n */\nexport const WORKFLOW_STEP_SESSION_PROVENANCE = 'workflow';\n\n/**\n * Provenance of a session opened to launch workflows for its parent.\n *\n * It picks and starts work, then closes; the runs it started belong to its\n * parent. Like a detached helper, it takes no row in the session rail.\n */\nexport const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = 'workflow-dispatcher';\n\nexport interface DoomHubSessionCreateRequest {\n  readonly cwd: string;\n  readonly name: string;\n  readonly parentSessionId?: string;\n  readonly sessionProvenance?: string;\n  readonly signal?: AbortSignal;\n  /** Host-issued reservation, not a caller-chosen target session id. */\n  readonly reservationId?: string;\n  /** Pinned axes stay put when the workspace defaults change between turns. */\n  readonly selection?: DoomHubSessionSelection;\n  /** Pi model selector, `provider/id`, validated like `--model`. */\n  readonly model?: string;\n  /** Pi thinking level, validated like `--thinking`. */\n  readonly thinking?: string;\n  /** Text appended to the session's system prompt, like `--append-system-prompt`. */\n  readonly appendSystemPrompt?: string;\n  /** Variables layered over the host environment for the new session and the tools it runs. */\n  readonly environment?: Readonly<Record<string, string>>;\n  /** The only tools the new session's agent may see or call, like a Team agent's `tools:` list. */\n  readonly tools?: readonly string[];\n}\n\nexport interface DoomHubSessionPromptOptions {\n  readonly signal?: AbortSignal;\n  /** Refuses the prompt unless the target is a direct child of this session. */\n  readonly parentSessionId?: string;\n}\n\n/** A prompt the session admitted. `settled` resolves once the agent settles and rejects on a harness fault. */\nexport interface DoomHubSessionPromptReceipt {\n  readonly settled: Promise<void>;\n}\n\n/** Host-bound inter-session events. The source identity is attached by the hub, never by payload data. */\nexport interface DoomSessionCommunicationEndpoint {\n  readonly sessionId: string;\n  publish(targetSessionId: string, type: string, payload: unknown): boolean;\n  subscribe(type: string, listener: (sourceSessionId: string, payload: unknown) => void): () => void;\n  onPeerReady(listener: (peerSessionId: string) => void): () => void;\n  close(): void;\n}\nexport interface DoomPendingSessionSetup {\n  readonly id: string;\n  readonly name: string;\n  readonly createdAt: string;\n  readonly cwd?: string;\n  readonly setupKind?: 'managed-worktree' | 'existing-directory';\n  readonly status?: 'provisioning' | 'failed' | 'interrupted';\n  readonly errorCode?: 'SESSION_WORKTREE_PROVISION_FAILED' | 'SESSION_UNAVAILABLE';\n}\n\n/** A host-owned setup can be fulfilled by any execution-directory provider. */\nexport interface DoomHubSessionReservations {\n  read(id: string, parentSessionId: string): { sessionId: string; cwd?: string };\n  prepare(id: string, parentSessionId: string, cwd: string): Promise<{ sessionId: string; cwd: string }>;\n  complete(id: string, parentSessionId: string): Promise<DoomHubSessionScope>;\n}\n\n/** Direct lifecycle owned by the canonical headless hub, never by a package transport. */\nexport interface DoomHubSessionService {\n  create(request: DoomHubSessionCreateRequest): Promise<DoomHubSessionScope>;\n  close(sessionId: string): Promise<void>;\n  isLive(sessionId: string): boolean;\n  /** Starts a turn in a live session, as if its user had submitted `text`. */\n  prompt?(sessionId: string, text: string, options?: DoomHubSessionPromptOptions): Promise<DoomHubSessionPromptReceipt>;\n  /** Aborts the live session's current turn. The session stays open. */\n  abort?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  /**\n   * Adds guidance to a live session's running turn. A session with no turn in\n   * progress takes it as its next message instead.\n   */\n  steer?(\n    sessionId: string,\n    message: string,\n    options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<void>;\n  /**\n   * Stops a live session's runtime and keeps it dormant: its history stays\n   * readable where it is shown, and it can be woken later. A session that has\n   * done its work no longer holds a model, tools and extensions in the host.\n   */\n  release?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  readonly reservations?: DoomHubSessionReservations;\n  /** Provisions a host-reserved Git worktree child. This is not exposed to remote MCP clients. */\n  provisionReservedWorktree?(request: DoomHubReservedWorktreeRequest): Promise<DoomHubSessionScope>;\n  /** Core host hook. A Git provider registers its implementation while its channel is mounted. */\n  registerReservedWorktreeProvisioner?(provisioner: DoomHubReservedWorktreeProvisioner): () => void;\n  /** True only when both live sessions have a direct parent-child relationship. */\n  canCommunicate?(sourceSessionId: string, targetSessionId: string): boolean;\n  /** Core host hook. Session API construction removes this method before exposing the service to extensions. */\n  bindCommunication?(sessionId: string): DoomSessionCommunicationEndpoint;\n}\n\nexport interface DoomHubSessionApiRequest {\n  basePath: string;\n  path: string;\n  method: string;\n  body?: string | Uint8Array<ArrayBuffer> | null;\n  signal?: AbortSignal;\n  /** Forwarded by the authenticated host, including content type and trace context. */\n  headers?: RequestInit['headers'];\n}\n\nexport type DoomComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';\n\nexport interface DoomComputerUseHostRequest {\n  readonly operation: DoomComputerUseHostOperation;\n  readonly payload?: unknown;\n  readonly signal?: AbortSignal;\n}\n\nexport interface DoomComputerUseHostBinding {\n  readonly available: boolean;\n  /** Global opt-in, separate from the presence of a native host. */\n  readonly enabled?: boolean;\n  request(scope: DoomHubSessionScope, request: DoomComputerUseHostRequest): Promise<unknown>;\n  /** Checks a proof injected by the owning Desktop process, never a renderer marker. */\n  authorize?(headers: Headers): boolean;\n  /** Pins a session to Desktop before asking for a native grant. Ownership is not persisted. */\n  claimSession?(sessionId: string): void;\n  ownsSession?(sessionId: string): boolean;\n  forgetSession?(sessionId: string): void;\n  subscribe?(listener: () => void): () => void;\n  close?(): void;\n}\n\n/** Narrow, host-bound access. An extension cannot select another session's identity. */\nexport interface DoomComputerUseSessionAccess {\n  readonly available: boolean;\n  readonly enabled?: boolean;\n  authorize(headers: Headers): boolean;\n  claim(): void;\n  subscribe(listener: () => void): () => void;\n}\n\nexport interface DoomHubChannelConnection {\n  connectionId: string;\n  /** Host-verified native renderer proof, never copied from a channel payload. */\n  desktopAuthorized?: boolean;\n}\n\nexport interface DoomHubChannelHost {\n  sessions(): readonly DoomHubSessionScope[];\n  /** Canonical hub lifecycle for sessions created by channel commands. */\n  sessionService?: DoomHubSessionService;\n  /** Same-process events emitted by session facets. */\n  readonly directEvents: DoomDirectEventBus;\n  publish(sessionId: string, payload: unknown): void;\n  publishToConnection?(connectionId: string, sessionId: string, payload: unknown): boolean;\n  requestSessionApi(scope: DoomHubSessionScope, request: DoomHubSessionApiRequest): Promise<Response>;\n  computerUse?: DoomComputerUseHostBinding;\n  onNotice(message: string): void;\n}\n\nexport interface DoomHubChannelSource {\n  payloadFor(scope: DoomHubSessionScope): unknown;\n  sessionAdded?(scope: DoomHubSessionScope): void;\n  sessionRemoved?(sessionId: string): void;\n  threadJournal?(scope: DoomHubSessionScope, threadId: string): string | undefined;\n  close(): void;\n}\n\nexport type DoomHubChannelLifecycle = 'session' | 'hub';\n\nexport interface DoomHubChannel {\n  frameType: string;\n  lifecycle?: DoomHubChannelLifecycle;\n  start(host: DoomHubChannelHost): DoomHubChannelSource;\n  receiveWithoutSubscription?: boolean;\n  receive?(scope: DoomHubSessionScope, payload: unknown, connection: DoomHubChannelConnection): void;\n  disconnected?(connection: DoomHubChannelConnection): void;\n}\n"],"mappings":";;;;;;;AAiFA,MAAa,mCAAmC;;;;;;;AAQhD,MAAa,yCAAyC"}

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

@@ -0,0 +1,236 @@
+//#region src/schemas/hubChannel.d.ts
+export interface DoomHubChannelFrame {
+  type: string;
+  sessionId: string;
+  payload: unknown;
+}
+/** Same-process lifecycle bus shared by a host's session APIs and hub channels. */
+export interface DoomDirectEventSubscriptionOptions {
+  /** Replay the most recent value published for this frame and session, when one exists. */
+  readonly replayLatest?: boolean;
+}
+export interface DoomDirectEventBus {
+  publish(frameType: string, sessionId: string, payload: unknown): void;
+  subscribe(frameType: string, sessionId: string, listener: (payload: unknown) => void, options?: DoomDirectEventSubscriptionOptions): () => void;
+  /** Drop retained state for a session after its lifecycle ends. */
+  clearSession?(sessionId: string): void;
+  close(): void;
+}
+/**
+ * The extension-agnostic baseline every surface gets for one session, computed once by the
+ * session host. Extensions build on it instead of re-deriving roots and relations from cwd.
+ */
+export interface DoomSessionContext {
+  readonly sessionId: string;
+  /** Persisted workspace id, shared by every session and member checkout of the workspace. */
+  readonly workspaceId: string;
+  /** The admitted workspace root. It owns configuration, composition and settings. */
+  readonly workspaceRoot: string;
+  /**
+   * The checkout the session executes in. Equals workspaceRoot unless the session runs in a
+   * member checkout, such as a worktree, which may live outside the workspace folder.
+   */
+  readonly checkoutRoot: string;
+  readonly cwd: string;
+  readonly parentSessionId?: string;
+  /** The spawner's label for the session. Opaque: hosts never interpret it. */
+  readonly provenance?: string;
+}
+export interface DoomHubSessionScope {
+  sessionId: string;
+  workspaceId?: string;
+  cwd: string;
+  /** Environment admitted for this session, when supplied by the host. */
+  environment?: Readonly<Record<string, string | undefined>>;
+  /** The session's baseline context, when its host knows its workspace. */
+  sessionContext?: DoomSessionContext;
+}
+export interface DoomHubReservedWorktreeRequest {
+  readonly reservationId: string;
+  readonly parentSessionId: string;
+  readonly signal?: AbortSignal;
+}
+export type DoomHubReservedWorktreeProvisioner = (request: DoomHubReservedWorktreeRequest) => Promise<DoomHubSessionScope>;
+/** Selection axes a caller pins for a new session instead of the workspace defaults. */
+export interface DoomHubSessionSelection {
+  readonly majorMode?: string;
+  readonly minorModes?: readonly string[];
+  readonly profile?: string;
+  /** An empty list starts the session with no domains. */
+  readonly domains?: readonly string[];
+}
+/**
+ * Provenance of a session a workflow step opened.
+ *
+ * The step's conversation belongs to the workflow that ran it and is read in
+ * that workflow's view, so the session rail leaves such sessions out.
+ */
+export declare const WORKFLOW_STEP_SESSION_PROVENANCE = "workflow";
+/**
+ * Provenance of a session opened to launch workflows for its parent.
+ *
+ * It picks and starts work, then closes; the runs it started belong to its
+ * parent. Like a detached helper, it takes no row in the session rail.
+ */
+export declare const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = "workflow-dispatcher";
+export interface DoomHubSessionCreateRequest {
+  readonly cwd: string;
+  readonly name: string;
+  readonly parentSessionId?: string;
+  readonly sessionProvenance?: string;
+  readonly signal?: AbortSignal;
+  /** Host-issued reservation, not a caller-chosen target session id. */
+  readonly reservationId?: string;
+  /** Pinned axes stay put when the workspace defaults change between turns. */
+  readonly selection?: DoomHubSessionSelection;
+  /** Pi model selector, `provider/id`, validated like `--model`. */
+  readonly model?: string;
+  /** Pi thinking level, validated like `--thinking`. */
+  readonly thinking?: string;
+  /** Text appended to the session's system prompt, like `--append-system-prompt`. */
+  readonly appendSystemPrompt?: string;
+  /** Variables layered over the host environment for the new session and the tools it runs. */
+  readonly environment?: Readonly<Record<string, string>>;
+  /** The only tools the new session's agent may see or call, like a Team agent's `tools:` list. */
+  readonly tools?: readonly string[];
+}
+export interface DoomHubSessionPromptOptions {
+  readonly signal?: AbortSignal;
+  /** Refuses the prompt unless the target is a direct child of this session. */
+  readonly parentSessionId?: string;
+}
+/** A prompt the session admitted. `settled` resolves once the agent settles and rejects on a harness fault. */
+export interface DoomHubSessionPromptReceipt {
+  readonly settled: Promise<void>;
+}
+/** Host-bound inter-session events. The source identity is attached by the hub, never by payload data. */
+export interface DoomSessionCommunicationEndpoint {
+  readonly sessionId: string;
+  publish(targetSessionId: string, type: string, payload: unknown): boolean;
+  subscribe(type: string, listener: (sourceSessionId: string, payload: unknown) => void): () => void;
+  onPeerReady(listener: (peerSessionId: string) => void): () => void;
+  close(): void;
+}
+export interface DoomPendingSessionSetup {
+  readonly id: string;
+  readonly name: string;
+  readonly createdAt: string;
+  readonly cwd?: string;
+  readonly setupKind?: 'managed-worktree' | 'existing-directory';
+  readonly status?: 'provisioning' | 'failed' | 'interrupted';
+  readonly errorCode?: 'SESSION_WORKTREE_PROVISION_FAILED' | 'SESSION_UNAVAILABLE';
+}
+/** A host-owned setup can be fulfilled by any execution-directory provider. */
+export interface DoomHubSessionReservations {
+  read(id: string, parentSessionId: string): {
+    sessionId: string;
+    cwd?: string;
+  };
+  prepare(id: string, parentSessionId: string, cwd: string): Promise<{
+    sessionId: string;
+    cwd: string;
+  }>;
+  complete(id: string, parentSessionId: string): Promise<DoomHubSessionScope>;
+}
+/** Direct lifecycle owned by the canonical headless hub, never by a package transport. */
+export interface DoomHubSessionService {
+  create(request: DoomHubSessionCreateRequest): Promise<DoomHubSessionScope>;
+  close(sessionId: string): Promise<void>;
+  isLive(sessionId: string): boolean;
+  /** Starts a turn in a live session, as if its user had submitted `text`. */
+  prompt?(sessionId: string, text: string, options?: DoomHubSessionPromptOptions): Promise<DoomHubSessionPromptReceipt>;
+  /** Aborts the live session's current turn. The session stays open. */
+  abort?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;
+  /**
+   * Adds guidance to a live session's running turn. A session with no turn in
+   * progress takes it as its next message instead.
+   */
+  steer?(sessionId: string, message: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;
+  /**
+   * Stops a live session's runtime and keeps it dormant: its history stays
+   * readable where it is shown, and it can be woken later. A session that has
+   * done its work no longer holds a model, tools and extensions in the host.
+   */
+  release?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;
+  readonly reservations?: DoomHubSessionReservations;
+  /** Provisions a host-reserved Git worktree child. This is not exposed to remote MCP clients. */
+  provisionReservedWorktree?(request: DoomHubReservedWorktreeRequest): Promise<DoomHubSessionScope>;
+  /** Core host hook. A Git provider registers its implementation while its channel is mounted. */
+  registerReservedWorktreeProvisioner?(provisioner: DoomHubReservedWorktreeProvisioner): () => void;
+  /** True only when both live sessions have a direct parent-child relationship. */
+  canCommunicate?(sourceSessionId: string, targetSessionId: string): boolean;
+  /** Core host hook. Session API construction removes this method before exposing the service to extensions. */
+  bindCommunication?(sessionId: string): DoomSessionCommunicationEndpoint;
+}
+export interface DoomHubSessionApiRequest {
+  basePath: string;
+  path: string;
+  method: string;
+  body?: string | Uint8Array<ArrayBuffer> | null;
+  signal?: AbortSignal;
+  /** Forwarded by the authenticated host, including content type and trace context. */
+  headers?: RequestInit['headers'];
+}
+export type DoomComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';
+export interface DoomComputerUseHostRequest {
+  readonly operation: DoomComputerUseHostOperation;
+  readonly payload?: unknown;
+  readonly signal?: AbortSignal;
+}
+export interface DoomComputerUseHostBinding {
+  readonly available: boolean;
+  /** Global opt-in, separate from the presence of a native host. */
+  readonly enabled?: boolean;
+  request(scope: DoomHubSessionScope, request: DoomComputerUseHostRequest): Promise<unknown>;
+  /** Checks a proof injected by the owning Desktop process, never a renderer marker. */
+  authorize?(headers: Headers): boolean;
+  /** Pins a session to Desktop before asking for a native grant. Ownership is not persisted. */
+  claimSession?(sessionId: string): void;
+  ownsSession?(sessionId: string): boolean;
+  forgetSession?(sessionId: string): void;
+  subscribe?(listener: () => void): () => void;
+  close?(): void;
+}
+/** Narrow, host-bound access. An extension cannot select another session's identity. */
+export interface DoomComputerUseSessionAccess {
+  readonly available: boolean;
+  readonly enabled?: boolean;
+  authorize(headers: Headers): boolean;
+  claim(): void;
+  subscribe(listener: () => void): () => void;
+}
+export interface DoomHubChannelConnection {
+  connectionId: string;
+  /** Host-verified native renderer proof, never copied from a channel payload. */
+  desktopAuthorized?: boolean;
+}
+export interface DoomHubChannelHost {
+  sessions(): readonly DoomHubSessionScope[];
+  /** Canonical hub lifecycle for sessions created by channel commands. */
+  sessionService?: DoomHubSessionService;
+  /** Same-process events emitted by session facets. */
+  readonly directEvents: DoomDirectEventBus;
+  publish(sessionId: string, payload: unknown): void;
+  publishToConnection?(connectionId: string, sessionId: string, payload: unknown): boolean;
+  requestSessionApi(scope: DoomHubSessionScope, request: DoomHubSessionApiRequest): Promise<Response>;
+  computerUse?: DoomComputerUseHostBinding;
+  onNotice(message: string): void;
+}
+export interface DoomHubChannelSource {
+  payloadFor(scope: DoomHubSessionScope): unknown;
+  sessionAdded?(scope: DoomHubSessionScope): void;
+  sessionRemoved?(sessionId: string): void;
+  threadJournal?(scope: DoomHubSessionScope, threadId: string): string | undefined;
+  close(): void;
+}
+export type DoomHubChannelLifecycle = 'session' | 'hub';
+export interface DoomHubChannel {
+  frameType: string;
+  lifecycle?: DoomHubChannelLifecycle;
+  start(host: DoomHubChannelHost): DoomHubChannelSource;
+  receiveWithoutSubscription?: boolean;
+  receive?(scope: DoomHubSessionScope, payload: unknown, connection: DoomHubChannelConnection): void;
+  disconnected?(connection: DoomHubChannelConnection): void;
+}
+//#endregion
+//# sourceMappingURL=hubChannel.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hubChannel.d.mts","names":[],"sources":["../../../src/schemas/hubChannel.ts"],"mappings":";iBAAiB;EACf;EACA;EACA;;;iBAIe;;WAEN;;iBAGM;EACf,QAAQ,mBAAmB,mBAAmB;EAC9C,UACE,mBACA,mBACA,WAAW,2BACX,UAAU;;EAGZ,cAAc;EACd;;;;;;iBAOe;WACN;;WAEA;;WAEA;;;;;WAKA;WACA;WACA;;WAEA;;iBAGM;EACf;EACA;EACA;;EAEA,cAAc,SAAS;;EAEvB,iBAAiB;;iBAGF;WACN;WACA;WACA,SAAS;;YAGR,sCACV,SAAS,mCACN,QAAQ;;iBAGI;WACN;WACA;WACA;;WAEA;;;;;;;;qBASE;;;;;;;qBAQA;iBAEI;WACN;WACA;WACA;WACA;WACA,SAAS;;WAET;;WAEA,YAAY;;WAEZ;;WAEA;;WAEA;;WAEA,cAAc,SAAS;;WAEvB;;iBAGM;WACN,SAAS;;WAET;;;iBAIM;WACN,SAAS;;;iBAIH;WACN;EACT,QAAQ,yBAAyB,cAAc;EAC/C,UAAU,cAAc,WAAW,yBAAyB;EAC5D,YAAY,WAAW;EACvB;;iBAEe;WACN;WACA;WACA;WACA;WACA;WACA;WACA;;;iBAIM;EACf,KAAK,YAAY;IAA4B;IAAmB;;EAChE,QAAQ,YAAY,yBAAyB,cAAc;IAAU;IAAmB;;EACxF,SAAS,YAAY,0BAA0B,QAAQ;;;iBAIxC;EACf,OAAO,SAAS,8BAA8B,QAAQ;EACtD,MAAM,oBAAoB;EAC1B,OAAO;;EAEP,QAAQ,mBAAmB,cAAc,UAAU,8BAA8B,QAAQ;;EAEzF,OAAO,mBAAmB,UAAU,KAAK,kDAAkD;;;;;EAK3F,OACE,mBACA,iBACA,UAAU,KAAK,kDACd;;;;;;EAMH,SAAS,mBAAmB,UAAU,KAAK,kDAAkD;WACpF,eAAe;;EAExB,2BAA2B,SAAS,iCAAiC,QAAQ;;EAE7E,qCAAqC,aAAa;;EAElD,gBAAgB,yBAAyB;;EAEzC,mBAAmB,oBAAoB;;iBAGxB;EACf;EACA;EACA;EACA,gBAAgB,WAAW;EAC3B,SAAS;;EAET,UAAU;;YAGA;iBAEK;WACN,WAAW;WACX;WACA,SAAS;;iBAGH;WACN;;WAEA;EACT,QAAQ,OAAO,qBAAqB,SAAS,6BAA6B;;EAE1E,WAAW,SAAS;;EAEpB,cAAc;EACd,aAAa;EACb,eAAe;EACf,WAAW;EACX;;;iBAIe;WACN;WACA;EACT,UAAU,SAAS;EACnB;EACA,UAAU;;iBAGK;EACf;;EAEA;;iBAGe;EACf,qBAAqB;;EAErB,iBAAiB;;WAER,cAAc;EACvB,QAAQ,mBAAmB;EAC3B,qBAAqB,sBAAsB,mBAAmB;EAC9D,kBAAkB,OAAO,qBAAqB,SAAS,2BAA2B,QAAQ;EAC1F,cAAc;EACd,SAAS;;iBAGM;EACf,WAAW,OAAO;EAClB,cAAc,OAAO;EACrB,gBAAgB;EAChB,eAAe,OAAO,qBAAqB;EAC3C;;YAGU;iBAEK;EACf;EACA,YAAY;EACZ,MAAM,MAAM,qBAAqB;EACjC;EACA,SAAS,OAAO,qBAAqB,kBAAkB,YAAY;EACnE,cAAc,YAAY"}

package/dist/src/schemas/hubChannel.mjs

@@ -0,0 +1,19 @@
+//#region src/schemas/hubChannel.ts
+/**
+* Provenance of a session a workflow step opened.
+*
+* The step's conversation belongs to the workflow that ran it and is read in
+* that workflow's view, so the session rail leaves such sessions out.
+*/
+const WORKFLOW_STEP_SESSION_PROVENANCE = "workflow";
+/**
+* Provenance of a session opened to launch workflows for its parent.
+*
+* It picks and starts work, then closes; the runs it started belong to its
+* parent. Like a detached helper, it takes no row in the session rail.
+*/
+const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = "workflow-dispatcher";
+//#endregion
+export { WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE };
+
+//# sourceMappingURL=hubChannel.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hubChannel.mjs","names":[],"sources":["../../../src/schemas/hubChannel.ts"],"sourcesContent":["export interface DoomHubChannelFrame {\n  type: string;\n  sessionId: string;\n  payload: unknown;\n}\n\n/** Same-process lifecycle bus shared by a host's session APIs and hub channels. */\nexport interface DoomDirectEventSubscriptionOptions {\n  /** Replay the most recent value published for this frame and session, when one exists. */\n  readonly replayLatest?: boolean;\n}\n\nexport interface DoomDirectEventBus {\n  publish(frameType: string, sessionId: string, payload: unknown): void;\n  subscribe(\n    frameType: string,\n    sessionId: string,\n    listener: (payload: unknown) => void,\n    options?: DoomDirectEventSubscriptionOptions,\n  ): () => void;\n  /** Drop retained state for a session after its lifecycle ends. */\n  clearSession?(sessionId: string): void;\n  close(): void;\n}\n\n/**\n * The extension-agnostic baseline every surface gets for one session, computed once by the\n * session host. Extensions build on it instead of re-deriving roots and relations from cwd.\n */\nexport interface DoomSessionContext {\n  readonly sessionId: string;\n  /** Persisted workspace id, shared by every session and member checkout of the workspace. */\n  readonly workspaceId: string;\n  /** The admitted workspace root. It owns configuration, composition and settings. */\n  readonly workspaceRoot: string;\n  /**\n   * The checkout the session executes in. Equals workspaceRoot unless the session runs in a\n   * member checkout, such as a worktree, which may live outside the workspace folder.\n   */\n  readonly checkoutRoot: string;\n  readonly cwd: string;\n  readonly parentSessionId?: string;\n  /** The spawner's label for the session. Opaque: hosts never interpret it. */\n  readonly provenance?: string;\n}\n\nexport interface DoomHubSessionScope {\n  sessionId: string;\n  workspaceId?: string;\n  cwd: string;\n  /** Environment admitted for this session, when supplied by the host. */\n  environment?: Readonly<Record<string, string | undefined>>;\n  /** The session's baseline context, when its host knows its workspace. */\n  sessionContext?: DoomSessionContext;\n}\n\nexport interface DoomHubReservedWorktreeRequest {\n  readonly reservationId: string;\n  readonly parentSessionId: string;\n  readonly signal?: AbortSignal;\n}\n\nexport type DoomHubReservedWorktreeProvisioner = (\n  request: DoomHubReservedWorktreeRequest,\n) => Promise<DoomHubSessionScope>;\n\n/** Selection axes a caller pins for a new session instead of the workspace defaults. */\nexport interface DoomHubSessionSelection {\n  readonly majorMode?: string;\n  readonly minorModes?: readonly string[];\n  readonly profile?: string;\n  /** An empty list starts the session with no domains. */\n  readonly domains?: readonly string[];\n}\n\n/**\n * Provenance of a session a workflow step opened.\n *\n * The step's conversation belongs to the workflow that ran it and is read in\n * that workflow's view, so the session rail leaves such sessions out.\n */\nexport const WORKFLOW_STEP_SESSION_PROVENANCE = 'workflow';\n\n/**\n * Provenance of a session opened to launch workflows for its parent.\n *\n * It picks and starts work, then closes; the runs it started belong to its\n * parent. Like a detached helper, it takes no row in the session rail.\n */\nexport const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = 'workflow-dispatcher';\n\nexport interface DoomHubSessionCreateRequest {\n  readonly cwd: string;\n  readonly name: string;\n  readonly parentSessionId?: string;\n  readonly sessionProvenance?: string;\n  readonly signal?: AbortSignal;\n  /** Host-issued reservation, not a caller-chosen target session id. */\n  readonly reservationId?: string;\n  /** Pinned axes stay put when the workspace defaults change between turns. */\n  readonly selection?: DoomHubSessionSelection;\n  /** Pi model selector, `provider/id`, validated like `--model`. */\n  readonly model?: string;\n  /** Pi thinking level, validated like `--thinking`. */\n  readonly thinking?: string;\n  /** Text appended to the session's system prompt, like `--append-system-prompt`. */\n  readonly appendSystemPrompt?: string;\n  /** Variables layered over the host environment for the new session and the tools it runs. */\n  readonly environment?: Readonly<Record<string, string>>;\n  /** The only tools the new session's agent may see or call, like a Team agent's `tools:` list. */\n  readonly tools?: readonly string[];\n}\n\nexport interface DoomHubSessionPromptOptions {\n  readonly signal?: AbortSignal;\n  /** Refuses the prompt unless the target is a direct child of this session. */\n  readonly parentSessionId?: string;\n}\n\n/** A prompt the session admitted. `settled` resolves once the agent settles and rejects on a harness fault. */\nexport interface DoomHubSessionPromptReceipt {\n  readonly settled: Promise<void>;\n}\n\n/** Host-bound inter-session events. The source identity is attached by the hub, never by payload data. */\nexport interface DoomSessionCommunicationEndpoint {\n  readonly sessionId: string;\n  publish(targetSessionId: string, type: string, payload: unknown): boolean;\n  subscribe(type: string, listener: (sourceSessionId: string, payload: unknown) => void): () => void;\n  onPeerReady(listener: (peerSessionId: string) => void): () => void;\n  close(): void;\n}\nexport interface DoomPendingSessionSetup {\n  readonly id: string;\n  readonly name: string;\n  readonly createdAt: string;\n  readonly cwd?: string;\n  readonly setupKind?: 'managed-worktree' | 'existing-directory';\n  readonly status?: 'provisioning' | 'failed' | 'interrupted';\n  readonly errorCode?: 'SESSION_WORKTREE_PROVISION_FAILED' | 'SESSION_UNAVAILABLE';\n}\n\n/** A host-owned setup can be fulfilled by any execution-directory provider. */\nexport interface DoomHubSessionReservations {\n  read(id: string, parentSessionId: string): { sessionId: string; cwd?: string };\n  prepare(id: string, parentSessionId: string, cwd: string): Promise<{ sessionId: string; cwd: string }>;\n  complete(id: string, parentSessionId: string): Promise<DoomHubSessionScope>;\n}\n\n/** Direct lifecycle owned by the canonical headless hub, never by a package transport. */\nexport interface DoomHubSessionService {\n  create(request: DoomHubSessionCreateRequest): Promise<DoomHubSessionScope>;\n  close(sessionId: string): Promise<void>;\n  isLive(sessionId: string): boolean;\n  /** Starts a turn in a live session, as if its user had submitted `text`. */\n  prompt?(sessionId: string, text: string, options?: DoomHubSessionPromptOptions): Promise<DoomHubSessionPromptReceipt>;\n  /** Aborts the live session's current turn. The session stays open. */\n  abort?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  /**\n   * Adds guidance to a live session's running turn. A session with no turn in\n   * progress takes it as its next message instead.\n   */\n  steer?(\n    sessionId: string,\n    message: string,\n    options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<void>;\n  /**\n   * Stops a live session's runtime and keeps it dormant: its history stays\n   * readable where it is shown, and it can be woken later. A session that has\n   * done its work no longer holds a model, tools and extensions in the host.\n   */\n  release?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  readonly reservations?: DoomHubSessionReservations;\n  /** Provisions a host-reserved Git worktree child. This is not exposed to remote MCP clients. */\n  provisionReservedWorktree?(request: DoomHubReservedWorktreeRequest): Promise<DoomHubSessionScope>;\n  /** Core host hook. A Git provider registers its implementation while its channel is mounted. */\n  registerReservedWorktreeProvisioner?(provisioner: DoomHubReservedWorktreeProvisioner): () => void;\n  /** True only when both live sessions have a direct parent-child relationship. */\n  canCommunicate?(sourceSessionId: string, targetSessionId: string): boolean;\n  /** Core host hook. Session API construction removes this method before exposing the service to extensions. */\n  bindCommunication?(sessionId: string): DoomSessionCommunicationEndpoint;\n}\n\nexport interface DoomHubSessionApiRequest {\n  basePath: string;\n  path: string;\n  method: string;\n  body?: string | Uint8Array<ArrayBuffer> | null;\n  signal?: AbortSignal;\n  /** Forwarded by the authenticated host, including content type and trace context. */\n  headers?: RequestInit['headers'];\n}\n\nexport type DoomComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';\n\nexport interface DoomComputerUseHostRequest {\n  readonly operation: DoomComputerUseHostOperation;\n  readonly payload?: unknown;\n  readonly signal?: AbortSignal;\n}\n\nexport interface DoomComputerUseHostBinding {\n  readonly available: boolean;\n  /** Global opt-in, separate from the presence of a native host. */\n  readonly enabled?: boolean;\n  request(scope: DoomHubSessionScope, request: DoomComputerUseHostRequest): Promise<unknown>;\n  /** Checks a proof injected by the owning Desktop process, never a renderer marker. */\n  authorize?(headers: Headers): boolean;\n  /** Pins a session to Desktop before asking for a native grant. Ownership is not persisted. */\n  claimSession?(sessionId: string): void;\n  ownsSession?(sessionId: string): boolean;\n  forgetSession?(sessionId: string): void;\n  subscribe?(listener: () => void): () => void;\n  close?(): void;\n}\n\n/** Narrow, host-bound access. An extension cannot select another session's identity. */\nexport interface DoomComputerUseSessionAccess {\n  readonly available: boolean;\n  readonly enabled?: boolean;\n  authorize(headers: Headers): boolean;\n  claim(): void;\n  subscribe(listener: () => void): () => void;\n}\n\nexport interface DoomHubChannelConnection {\n  connectionId: string;\n  /** Host-verified native renderer proof, never copied from a channel payload. */\n  desktopAuthorized?: boolean;\n}\n\nexport interface DoomHubChannelHost {\n  sessions(): readonly DoomHubSessionScope[];\n  /** Canonical hub lifecycle for sessions created by channel commands. */\n  sessionService?: DoomHubSessionService;\n  /** Same-process events emitted by session facets. */\n  readonly directEvents: DoomDirectEventBus;\n  publish(sessionId: string, payload: unknown): void;\n  publishToConnection?(connectionId: string, sessionId: string, payload: unknown): boolean;\n  requestSessionApi(scope: DoomHubSessionScope, request: DoomHubSessionApiRequest): Promise<Response>;\n  computerUse?: DoomComputerUseHostBinding;\n  onNotice(message: string): void;\n}\n\nexport interface DoomHubChannelSource {\n  payloadFor(scope: DoomHubSessionScope): unknown;\n  sessionAdded?(scope: DoomHubSessionScope): void;\n  sessionRemoved?(sessionId: string): void;\n  threadJournal?(scope: DoomHubSessionScope, threadId: string): string | undefined;\n  close(): void;\n}\n\nexport type DoomHubChannelLifecycle = 'session' | 'hub';\n\nexport interface DoomHubChannel {\n  frameType: string;\n  lifecycle?: DoomHubChannelLifecycle;\n  start(host: DoomHubChannelHost): DoomHubChannelSource;\n  receiveWithoutSubscription?: boolean;\n  receive?(scope: DoomHubSessionScope, payload: unknown, connection: DoomHubChannelConnection): void;\n  disconnected?(connection: DoomHubChannelConnection): void;\n}\n"],"mappings":";;;;;;;AAiFA,MAAa,mCAAmC;;;;;;;AAQhD,MAAa,yCAAyC"}