@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/schemas/help.mjs

@@ -2,24 +2,24 @@ 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 = {
+const PO_HELP_SERVICE = "po/help";
+const PO_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 PO_HELP_MAX_CONTRIBUTORS = 32;
+const PO_HELP_MAX_SKILLS = 64;
+const PO_HELP_MAX_DIAGNOSTICS = 64;
+const PO_HELP_MAX_DESCRIPTION_LENGTH = 512;
+const PO_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 = {
+const PO_HELP_ERROR_CODE = {
 	contributorLimit: "HELP_CONTRIBUTOR_LIMIT",
 	disposed: "HELP_DISPOSED",
 	duplicateSkill: "HELP_DUPLICATE_SKILL",
@@ -28,38 +28,38 @@ const DOOM_HELP_ERROR_CODE = {
 	invalidGeneration: "HELP_INVALID_GENERATION",
 	invalidSnapshot: "HELP_INVALID_SNAPSHOT"
 };
-var DoomHelpError = class extends Error {
+var PoHelpError = class extends Error {
 	code;
 	constructor(code, message) {
 		super(message);
-		this.name = "DoomHelpError";
+		this.name = "PoHelpError";
 		this.code = code;
 	}
 };
-const DoomHelpSourceSchema = Type.String({
+const PoHelpSourceSchema = Type.String({
 	minLength: 1,
 	maxLength: MAX_SOURCE_LENGTH,
 	pattern: "^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$"
 });
-const DoomHelpSkillNameSchema = Type.String({
+const PoHelpSkillNameSchema = Type.String({
 	minLength: 1,
 	maxLength: MAX_SKILL_NAME_LENGTH,
 	pattern: "^[a-z0-9][a-z0-9-]*$"
 });
-const DoomHelpSkillDescriptorSchema = Type.Object({
-	name: DoomHelpSkillNameSchema,
+const PoHelpSkillDescriptorSchema = Type.Object({
+	name: PoHelpSkillNameSchema,
 	description: Type.String({
 		minLength: 1,
 		maxLength: 512
 	})
 }, { additionalProperties: false });
-const DoomHelpContributionSchema = Type.Object({
-	source: DoomHelpSourceSchema,
+const PoHelpContributionSchema = Type.Object({
+	source: PoHelpSourceSchema,
 	moduleUrl: Type.String({
 		minLength: 1,
 		maxLength: MAX_MODULE_URL_LENGTH
 	}),
-	skills: Type.Array(DoomHelpSkillDescriptorSchema, {
+	skills: Type.Array(PoHelpSkillDescriptorSchema, {
 		minItems: 1,
 		maxItems: 64
 	})
@@ -68,15 +68,15 @@ const GenerationSchema = Type.String({
 	minLength: 1,
 	maxLength: MAX_IDENTIFIER_LENGTH
 });
-const DoomHelpActivationSchema = Type.Union([
+const PoHelpActivationSchema = Type.Union([
 	Type.Literal("inactive"),
 	Type.Literal("activating"),
 	Type.Literal("active"),
 	Type.Literal("degraded")
 ]);
-const DoomHelpSkillSchema = Type.Object({
-	source: DoomHelpSourceSchema,
-	name: DoomHelpSkillNameSchema,
+const PoHelpSkillSchema = Type.Object({
+	source: PoHelpSourceSchema,
+	name: PoHelpSkillNameSchema,
 	description: Type.String({
 		minLength: 1,
 		maxLength: 512
@@ -90,8 +90,8 @@ const DoomHelpSkillSchema = Type.Object({
 		maxLength: MAX_MODULE_URL_LENGTH
 	})
 }, { additionalProperties: false });
-const DoomHelpDiagnosticSchema = Type.Object({
-	source: Type.Optional(DoomHelpSourceSchema),
+const PoHelpDiagnosticSchema = Type.Object({
+	source: Type.Optional(PoHelpSourceSchema),
 	code: Type.String({
 		minLength: 1,
 		maxLength: 64,
@@ -102,12 +102,12 @@ const DoomHelpDiagnosticSchema = Type.Object({
 		maxLength: 512
 	})
 }, { additionalProperties: false });
-const DoomHelpSnapshotSchema = Type.Object({
+const PoHelpSnapshotSchema = Type.Object({
 	hostGeneration: GenerationSchema,
 	revision: Type.Integer({ minimum: 0 }),
-	activation: DoomHelpActivationSchema,
-	skills: Type.Array(DoomHelpSkillSchema, { maxItems: 64 }),
-	diagnostics: Type.Array(DoomHelpDiagnosticSchema, { maxItems: 64 })
+	activation: PoHelpActivationSchema,
+	skills: Type.Array(PoHelpSkillSchema, { maxItems: 64 }),
+	diagnostics: Type.Array(PoHelpDiagnosticSchema, { maxItems: 64 })
 }, { additionalProperties: false });
 function schemaFailure(schema, value) {
 	const [first] = Errors(schema, value);
@@ -128,17 +128,17 @@ function cloneSnapshot(snapshot) {
 	};
 }
 function validateContribution(contribution) {
-	if (!Check(DoomHelpContributionSchema, contribution)) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.invalidContribution, `Invalid Help contribution${schemaFailure(DoomHelpContributionSchema, contribution)}.`);
+	if (!Check(PoHelpContributionSchema, contribution)) throw new PoHelpError(PO_HELP_ERROR_CODE.invalidContribution, `Invalid Help contribution${schemaFailure(PoHelpContributionSchema, 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}'.`);
+		if (names.has(skill.name)) throw new PoHelpError(PO_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.");
+function createPoHelpService(generation) {
+	if (!Check(GenerationSchema, generation)) throw new PoHelpError(PO_HELP_ERROR_CODE.invalidGeneration, "Po Help requires a valid generation.");
 	const contributions = /* @__PURE__ */ new Map();
 	const contributionListeners = /* @__PURE__ */ new Set();
 	const snapshotListeners = /* @__PURE__ */ new Set();
@@ -153,7 +153,7 @@ function createDoomHelpService(generation) {
 		diagnostics: []
 	};
 	const ensureActive = () => {
-		if (disposed) throw new DoomHelpError(DOOM_HELP_ERROR_CODE.disposed, "The Doom Help service is disposed.");
+		if (disposed) throw new PoHelpError(PO_HELP_ERROR_CODE.disposed, "The Po Help service is disposed.");
 	};
 	const list = () => [...contributions.values()].map(({ contribution }) => cloneContribution(contribution)).sort((left, right) => left.source.localeCompare(right.source));
 	const notifyContributions = () => {
@@ -165,7 +165,7 @@ function createDoomHelpService(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.`);
+			if (!contributions.has(validated.source) && contributions.size >= 32) throw new PoHelpError(PO_HELP_ERROR_CODE.contributorLimit, `Help accepts at most 32 contributors.`);
 			registrationSequence += 1;
 			const token = Symbol(validated.source);
 			const registrationGeneration = `${generation}:help:${registrationSequence}`;
@@ -197,7 +197,7 @@ function createDoomHelpService(generation) {
 		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.");
+			if (draft.activation === "inactive" && draft.skills.length > 0) throw new PoHelpError(PO_HELP_ERROR_CODE.inactiveSnapshot, "Inactive Help snapshots cannot expose skills.");
 			const next = {
 				hostGeneration: generation,
 				revision: snapshot.revision + 1,
@@ -205,7 +205,7 @@ function createDoomHelpService(generation) {
 				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)}.`);
+			if (!Check(PoHelpSnapshotSchema, next)) throw new PoHelpError(PO_HELP_ERROR_CODE.invalidSnapshot, `Invalid Help snapshot${schemaFailure(PoHelpSnapshotSchema, next)}.`);
 			snapshot = next;
 			const published = cloneSnapshot(snapshot);
 			for (const listener of snapshotListeners) listener(cloneSnapshot(published));
@@ -248,15 +248,15 @@ function createDoomHelpService(generation) {
 		}
 	});
 }
-function readDoomHelpService(context) {
-	return context.get(DOOM_HELP_SERVICE);
+function readPoHelpService(context) {
+	return context.get(PO_HELP_SERVICE);
 }
-function requireDoomHelpService(context) {
-	const service = readDoomHelpService(context);
-	if (!service) throw new Error("Doom Help is unavailable. Load @agimon-ai/po-help.");
+function requirePoHelpService(context) {
+	const service = readPoHelpService(context);
+	if (!service) throw new Error("Po Help is unavailable. Load @agimon-ai/po-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 };
+export { PO_HELP_ERROR_CODE, PO_HELP_MAX_CONTRIBUTORS, PO_HELP_MAX_DESCRIPTION_LENGTH, PO_HELP_MAX_DIAGNOSTICS, PO_HELP_MAX_DIAGNOSTIC_LENGTH, PO_HELP_MAX_SKILLS, PO_HELP_SERVICE, PO_HELP_WHEN, PoHelpActivationSchema, PoHelpContributionSchema, PoHelpDiagnosticSchema, PoHelpError, PoHelpSkillDescriptorSchema, PoHelpSkillNameSchema, PoHelpSkillSchema, PoHelpSnapshotSchema, PoHelpSourceSchema, createPoHelpService, readPoHelpService, requirePoHelpService };
 
 //# sourceMappingURL=help.mjs.map

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

@@ -1 +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 po-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/po-help.');\n  return service;\n}\n"],"mappings":"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"}
+{"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 PO_HELP_SERVICE = 'po/help';\nexport const PO_HELP_WHEN = {\n  state: { 'minor-mode': 'help' },\n  attribution: { kind: 'minor', mode: 'help' },\n} as const;\nexport const PO_HELP_MAX_CONTRIBUTORS = 32;\nexport const PO_HELP_MAX_SKILLS = 64;\nexport const PO_HELP_MAX_DIAGNOSTICS = 64;\nexport const PO_HELP_MAX_DESCRIPTION_LENGTH = 512;\nexport const PO_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 PO_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 PoHelpErrorCode = (typeof PO_HELP_ERROR_CODE)[keyof typeof PO_HELP_ERROR_CODE];\n\nexport class PoHelpError extends Error {\n  readonly code: PoHelpErrorCode;\n\n  constructor(code: PoHelpErrorCode, message: string) {\n    super(message);\n    this.name = 'PoHelpError';\n    this.code = code;\n  }\n}\n\nexport const PoHelpSourceSchema = Type.String({\n  minLength: 1,\n  maxLength: MAX_SOURCE_LENGTH,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const PoHelpSkillNameSchema = Type.String({\n  minLength: 1,\n  maxLength: MAX_SKILL_NAME_LENGTH,\n  pattern: '^[a-z0-9][a-z0-9-]*$',\n});\n\nexport const PoHelpSkillDescriptorSchema = Type.Object(\n  {\n    name: PoHelpSkillNameSchema,\n    description: Type.String({ minLength: 1, maxLength: PO_HELP_MAX_DESCRIPTION_LENGTH }),\n  },\n  { additionalProperties: false },\n);\nexport type PoHelpSkillDescriptor = Static<typeof PoHelpSkillDescriptorSchema>;\n\nexport const PoHelpContributionSchema = Type.Object(\n  {\n    source: PoHelpSourceSchema,\n    moduleUrl: Type.String({ minLength: 1, maxLength: MAX_MODULE_URL_LENGTH }),\n    skills: Type.Array(PoHelpSkillDescriptorSchema, { minItems: 1, maxItems: PO_HELP_MAX_SKILLS }),\n  },\n  { additionalProperties: false },\n);\nexport type PoHelpContribution = Static<typeof PoHelpContributionSchema>;\n\nconst GenerationSchema = Type.String({ minLength: 1, maxLength: MAX_IDENTIFIER_LENGTH });\n\nexport const PoHelpActivationSchema = Type.Union([\n  Type.Literal('inactive'),\n  Type.Literal('activating'),\n  Type.Literal('active'),\n  Type.Literal('degraded'),\n]);\nexport type PoHelpActivation = Static<typeof PoHelpActivationSchema>;\n\nexport const PoHelpSkillSchema = Type.Object(\n  {\n    source: PoHelpSourceSchema,\n    name: PoHelpSkillNameSchema,\n    description: Type.String({ minLength: 1, maxLength: PO_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 PoHelpSkill = Static<typeof PoHelpSkillSchema>;\n\nexport const PoHelpDiagnosticSchema = Type.Object(\n  {\n    source: Type.Optional(PoHelpSourceSchema),\n    code: Type.String({ minLength: 1, maxLength: 64, pattern: '^[A-Z0-9_]+$' }),\n    message: Type.String({ minLength: 1, maxLength: PO_HELP_MAX_DIAGNOSTIC_LENGTH }),\n  },\n  { additionalProperties: false },\n);\nexport type PoHelpDiagnostic = Static<typeof PoHelpDiagnosticSchema>;\n\nexport const PoHelpSnapshotSchema = Type.Object(\n  {\n    hostGeneration: GenerationSchema,\n    revision: Type.Integer({ minimum: 0 }),\n    activation: PoHelpActivationSchema,\n    skills: Type.Array(PoHelpSkillSchema, { maxItems: PO_HELP_MAX_SKILLS }),\n    diagnostics: Type.Array(PoHelpDiagnosticSchema, { maxItems: PO_HELP_MAX_DIAGNOSTICS }),\n  },\n  { additionalProperties: false },\n);\nexport type PoHelpSnapshot = Static<typeof PoHelpSnapshotSchema>;\n\nexport interface PoHelpSnapshotDraft {\n  readonly activation: PoHelpActivation;\n  readonly skills: readonly PoHelpSkill[];\n  readonly diagnostics: readonly PoHelpDiagnostic[];\n}\n\nexport interface PoHelpContributionHandle {\n  readonly source: string;\n  readonly generation: string;\n  dispose(): void;\n}\n\n/** Direct, session-local registrar and query surface owned by po-help. */\nexport interface PoHelpService {\n  readonly generation: string;\n  register(contribution: PoHelpContribution): PoHelpContributionHandle;\n  listContributions(): readonly PoHelpContribution[];\n  subscribeContributions(listener: (contributions: readonly PoHelpContribution[]) => void): () => void;\n  getSnapshot(): PoHelpSnapshot;\n  publish(snapshot: PoHelpSnapshotDraft): PoHelpSnapshot;\n  subscribeSnapshot(listener: (snapshot: PoHelpSnapshot) => 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 PoHelpSkill[] | undefined>;\n  dispose(): void;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/help': PoHelpService;\n  }\n}\n\ninterface RegisteredContribution {\n  readonly token: symbol;\n  readonly generation: string;\n  readonly contribution: PoHelpContribution;\n}\n\nfunction schemaFailure(schema: typeof PoHelpContributionSchema | typeof PoHelpSnapshotSchema, value: unknown): string {\n  const [first] = Errors(schema, value);\n  return first ? ` at ${first.instancePath || '/'}: ${first.message}` : '';\n}\n\nfunction cloneContribution(contribution: PoHelpContribution): PoHelpContribution {\n  return {\n    source: contribution.source,\n    moduleUrl: contribution.moduleUrl,\n    skills: contribution.skills.map((skill) => ({ ...skill })),\n  };\n}\n\nfunction cloneSnapshot(snapshot: PoHelpSnapshot): PoHelpSnapshot {\n  return {\n    ...snapshot,\n    skills: snapshot.skills.map((skill) => ({ ...skill })),\n    diagnostics: snapshot.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction validateContribution(contribution: PoHelpContribution): PoHelpContribution {\n  if (!Check(PoHelpContributionSchema, contribution)) {\n    throw new PoHelpError(\n      PO_HELP_ERROR_CODE.invalidContribution,\n      `Invalid Help contribution${schemaFailure(PoHelpContributionSchema, 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 PoHelpError(\n        PO_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 createPoHelpService(generation: string): PoHelpService {\n  if (!Check(GenerationSchema, generation)) {\n    throw new PoHelpError(PO_HELP_ERROR_CODE.invalidGeneration, 'Po Help requires a valid generation.');\n  }\n\n  const contributions = new Map<string, RegisteredContribution>();\n  const contributionListeners = new Set<(value: readonly PoHelpContribution[]) => void>();\n  const snapshotListeners = new Set<(value: PoHelpSnapshot) => void>();\n  let registrationSequence = 0;\n  let disposed = false;\n  let skillInventory: { token: symbol; read: () => Promise<readonly string[] | undefined> } | undefined;\n  let snapshot: PoHelpSnapshot = {\n    hostGeneration: generation,\n    revision: 0,\n    activation: 'inactive',\n    skills: [],\n    diagnostics: [],\n  };\n\n  const ensureActive = (): void => {\n    if (disposed) throw new PoHelpError(PO_HELP_ERROR_CODE.disposed, 'The Po Help service is disposed.');\n  };\n  const list = (): readonly PoHelpContribution[] =>\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: PoHelpService = {\n    generation,\n    register(contribution) {\n      ensureActive();\n      const validated = validateContribution(contribution);\n      if (!contributions.has(validated.source) && contributions.size >= PO_HELP_MAX_CONTRIBUTORS) {\n        throw new PoHelpError(\n          PO_HELP_ERROR_CODE.contributorLimit,\n          `Help accepts at most ${PO_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 PoHelpError(PO_HELP_ERROR_CODE.inactiveSnapshot, 'Inactive Help snapshots cannot expose skills.');\n      }\n      const next: PoHelpSnapshot = {\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(PoHelpSnapshotSchema, next)) {\n        throw new PoHelpError(\n          PO_HELP_ERROR_CODE.invalidSnapshot,\n          `Invalid Help snapshot${schemaFailure(PoHelpSnapshotSchema, 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 readPoHelpService(context: Context): PoHelpService | undefined {\n  return context.get(PO_HELP_SERVICE) as PoHelpService | undefined;\n}\n\nexport function requirePoHelpService(context: Context): PoHelpService {\n  const service = readPoHelpService(context);\n  if (!service) throw new Error('Po Help is unavailable. Load @agimon-ai/po-help.');\n  return service;\n}\n"],"mappings":"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"}

package/dist/src/schemas/home.cjs

@@ -0,0 +1,127 @@
+//#region src/schemas/home.ts
+const HOME_PAGE_LIMIT = 50;
+const HOME_ENTITY_LIMIT = 1e3;
+const HOME_KINDS = [
+	"decision",
+	"failure",
+	"blocked",
+	"running",
+	"queued",
+	"paused",
+	"completed"
+];
+function record(input) {
+	return input !== null && typeof input === "object" && !Array.isArray(input);
+}
+function text(input, limit = 256) {
+	return typeof input === "string" && input.trim().length > 0 && input.length <= limit;
+}
+function timestamp(input) {
+	return text(input, 64) && Number.isFinite(Date.parse(input));
+}
+function coverage(input) {
+	return input === "ready" || input === "partial" || input === "unavailable";
+}
+function parseHomeContribution(input) {
+	if (!record(input) || input.version !== 1 || !text(input.label, 80) || !text(input.source, 128)) return null;
+	if (input.destination !== void 0 && !text(input.destination, 128)) return null;
+	return {
+		version: 1,
+		label: input.label,
+		source: input.source,
+		...input.destination === void 0 ? {} : { destination: input.destination }
+	};
+}
+function parseHomeEntity(input) {
+	if (!record(input) || !text(input.id, 512) || !text(input.sessionId) || !text(input.title, 160)) return null;
+	if (!HOME_KINDS.includes(input.kind) || !timestamp(input.updatedAt)) return null;
+	if (input.detail !== void 0 && !text(input.detail, 320)) return null;
+	if (input.relatedSessionIds !== void 0 && (!Array.isArray(input.relatedSessionIds) || input.relatedSessionIds.length > 64 || !input.relatedSessionIds.every((id) => text(id)))) return null;
+	return {
+		id: input.id,
+		kind: input.kind,
+		title: input.title,
+		updatedAt: input.updatedAt,
+		sessionId: input.sessionId,
+		...input.detail === void 0 ? {} : { detail: input.detail },
+		...input.relatedSessionIds === void 0 ? {} : { relatedSessionIds: input.relatedSessionIds }
+	};
+}
+/** Reject a malformed source, rather than turning invalid records into a healthy count. */
+function parseHomeProjection(input) {
+	if (!record(input) || !coverage(input.coverage) || !Array.isArray(input.entities) || input.entities.length > 1e3) return null;
+	const entities = [];
+	for (const value of input.entities) {
+		const entity = parseHomeEntity(value);
+		if (entity === null) return null;
+		entities.push(entity);
+	}
+	if (input.coverage === "unavailable" && entities.length > 0) return null;
+	return {
+		coverage: input.coverage,
+		entities
+	};
+}
+function parseHomeCounts(input) {
+	if (!record(input)) return null;
+	const counts = {};
+	for (const kind of HOME_KINDS) {
+		const count = input[kind];
+		if (!Number.isSafeInteger(count) || count < 0) return null;
+		counts[kind] = count;
+	}
+	return counts;
+}
+function parseHomeSnapshot(input) {
+	if (!record(input) || input.version !== 1 || !timestamp(input.observedAt) || !Array.isArray(input.items) || input.items.length > 50 || !Array.isArray(input.sources) || input.sources.length > 5e3 || !Number.isSafeInteger(input.total) || input.total < 0 || !record(input.counts)) return null;
+	const counts = parseHomeCounts(input.counts);
+	if (counts === null || counts.decision + counts.failure + counts.blocked + counts.paused !== input.total || input.items.length > input.total) return null;
+	const items = [];
+	for (const value of input.items) {
+		const entity = parseHomeEntity(value);
+		if (entity === null || ![
+			"decision",
+			"failure",
+			"blocked",
+			"paused"
+		].includes(entity.kind) || !record(value) || !text(value.source, 128) || value.workspaceId !== void 0 && !text(value.workspaceId)) return null;
+		const { relatedSessionIds: _related, ...publicEntity } = entity;
+		items.push({
+			...publicEntity,
+			source: value.source,
+			...value.workspaceId === void 0 ? {} : { workspaceId: value.workspaceId }
+		});
+	}
+	const sources = [];
+	for (const value of input.sources) {
+		if (!record(value) || !text(value.source, 128) || !coverage(value.coverage) || value.workspaceId !== void 0 && !text(value.workspaceId)) return null;
+		const sourceCounts = value.counts === void 0 ? void 0 : parseHomeCounts(value.counts);
+		if (sourceCounts === null) return null;
+		sources.push({
+			source: value.source,
+			coverage: value.coverage,
+			...sourceCounts === void 0 ? {} : { counts: sourceCounts },
+			...value.workspaceId === void 0 ? {} : { workspaceId: value.workspaceId }
+		});
+	}
+	if (input.nextOffset !== void 0 && (!Number.isSafeInteger(input.nextOffset) || input.nextOffset <= 0 || input.nextOffset >= input.total)) return null;
+	return {
+		version: 1,
+		observedAt: input.observedAt,
+		items,
+		sources,
+		total: input.total,
+		counts,
+		...input.nextOffset === void 0 ? {} : { nextOffset: input.nextOffset }
+	};
+}
+//#endregion
+exports.HOME_ENTITY_LIMIT = HOME_ENTITY_LIMIT;
+exports.HOME_KINDS = HOME_KINDS;
+exports.HOME_PAGE_LIMIT = HOME_PAGE_LIMIT;
+exports.parseHomeContribution = parseHomeContribution;
+exports.parseHomeEntity = parseHomeEntity;
+exports.parseHomeProjection = parseHomeProjection;
+exports.parseHomeSnapshot = parseHomeSnapshot;
+
+//# sourceMappingURL=home.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home.cjs","names":[],"sources":["../../../src/schemas/home.ts"],"sourcesContent":["/** Compact, read-only operational summaries. Detailed state stays with its package. */\nexport type HomeKind = 'decision' | 'failure' | 'blocked' | 'running' | 'queued' | 'paused' | 'completed';\nexport type HomeCoverage = 'ready' | 'partial' | 'unavailable';\n\nexport interface HomeContribution {\n  version: 1;\n  label: string;\n  /** The existing channel frame type owned by this package. */\n  source: string;\n  /** Existing session activity group, when the host supports opening it. */\n  destination?: string;\n}\n\nexport interface HomeEntity {\n  /** Canonical within the source and workspace, including run generation or opaque graph identity. */\n  id: string;\n  kind: HomeKind;\n  title: string;\n  detail?: string;\n  updatedAt: string;\n  sessionId: string;\n  /** Every additional session whose information this entity contains. Checked before counting. */\n  relatedSessionIds?: readonly string[];\n}\n\nexport interface HomeProjection {\n  coverage: HomeCoverage;\n  entities: readonly HomeEntity[];\n}\n\nexport interface HomeItem extends Omit<HomeEntity, 'relatedSessionIds'> {\n  source: string;\n  workspaceId?: string;\n}\n\nexport interface HomeSourceStatus {\n  source: string;\n  workspaceId?: string;\n  coverage: HomeCoverage;\n  counts?: Record<HomeKind, number>;\n}\n\nexport interface HomeRequest {\n  offset?: number;\n  limit?: number;\n  source?: string;\n  workspaceId?: string;\n}\n\nexport interface HomeSnapshot {\n  version: 1;\n  observedAt: string;\n  sources: HomeSourceStatus[];\n  /** Attention rows only. Working and finished entities are represented by counts. */\n  items: HomeItem[];\n  total: number;\n  counts: Record<HomeKind, number>;\n  nextOffset?: number;\n}\n\nexport const HOME_PAGE_LIMIT = 50;\nexport const HOME_ENTITY_LIMIT = 1_000;\nexport const HOME_KINDS: readonly HomeKind[] = [\n  'decision',\n  'failure',\n  'blocked',\n  'running',\n  'queued',\n  'paused',\n  'completed',\n];\n\nfunction record(input: unknown): input is Record<string, unknown> {\n  return input !== null && typeof input === 'object' && !Array.isArray(input);\n}\n\nfunction text(input: unknown, limit = 256): input is string {\n  return typeof input === 'string' && input.trim().length > 0 && input.length <= limit;\n}\n\nfunction timestamp(input: unknown): input is string {\n  return text(input, 64) && Number.isFinite(Date.parse(input));\n}\n\nfunction coverage(input: unknown): input is HomeCoverage {\n  return input === 'ready' || input === 'partial' || input === 'unavailable';\n}\n\nexport function parseHomeContribution(input: unknown): HomeContribution | null {\n  if (!record(input) || input.version !== 1 || !text(input.label, 80) || !text(input.source, 128)) return null;\n  if (input.destination !== undefined && !text(input.destination, 128)) return null;\n  return {\n    version: 1,\n    label: input.label,\n    source: input.source,\n    ...(input.destination === undefined ? {} : { destination: input.destination }),\n  };\n}\n\nexport function parseHomeEntity(input: unknown): HomeEntity | null {\n  if (!record(input) || !text(input.id, 512) || !text(input.sessionId) || !text(input.title, 160)) return null;\n  if (!HOME_KINDS.includes(input.kind as HomeKind) || !timestamp(input.updatedAt)) return null;\n  if (input.detail !== undefined && !text(input.detail, 320)) return null;\n  if (\n    input.relatedSessionIds !== undefined &&\n    (!Array.isArray(input.relatedSessionIds) ||\n      input.relatedSessionIds.length > 64 ||\n      !input.relatedSessionIds.every((id) => text(id)))\n  )\n    return null;\n  return {\n    id: input.id,\n    kind: input.kind as HomeKind,\n    title: input.title,\n    updatedAt: input.updatedAt,\n    sessionId: input.sessionId,\n    ...(input.detail === undefined ? {} : { detail: input.detail }),\n    ...(input.relatedSessionIds === undefined ? {} : { relatedSessionIds: input.relatedSessionIds as string[] }),\n  };\n}\n\n/** Reject a malformed source, rather than turning invalid records into a healthy count. */\nexport function parseHomeProjection(input: unknown): HomeProjection | null {\n  if (\n    !record(input) ||\n    !coverage(input.coverage) ||\n    !Array.isArray(input.entities) ||\n    input.entities.length > HOME_ENTITY_LIMIT\n  )\n    return null;\n  const entities: HomeEntity[] = [];\n  for (const value of input.entities) {\n    const entity = parseHomeEntity(value);\n    if (entity === null) return null;\n    entities.push(entity);\n  }\n  if (input.coverage === 'unavailable' && entities.length > 0) return null;\n  return { coverage: input.coverage, entities };\n}\n\nfunction parseHomeCounts(input: unknown): Record<HomeKind, number> | null {\n  if (!record(input)) return null;\n  const counts = {} as Record<HomeKind, number>;\n  for (const kind of HOME_KINDS) {\n    const count = input[kind];\n    if (!Number.isSafeInteger(count) || (count as number) < 0) return null;\n    counts[kind] = count as number;\n  }\n  return counts;\n}\n\nexport function parseHomeSnapshot(input: unknown): HomeSnapshot | null {\n  if (\n    !record(input) ||\n    input.version !== 1 ||\n    !timestamp(input.observedAt) ||\n    !Array.isArray(input.items) ||\n    input.items.length > HOME_PAGE_LIMIT ||\n    !Array.isArray(input.sources) ||\n    input.sources.length > 5_000 ||\n    !Number.isSafeInteger(input.total) ||\n    (input.total as number) < 0 ||\n    !record(input.counts)\n  )\n    return null;\n  const counts = parseHomeCounts(input.counts);\n  if (\n    counts === null ||\n    counts.decision + counts.failure + counts.blocked + counts.paused !== input.total ||\n    input.items.length > input.total\n  )\n    return null;\n  const items: HomeItem[] = [];\n  for (const value of input.items) {\n    const entity = parseHomeEntity(value);\n    if (\n      entity === null ||\n      !['decision', 'failure', 'blocked', 'paused'].includes(entity.kind) ||\n      !record(value) ||\n      !text(value.source, 128) ||\n      (value.workspaceId !== undefined && !text(value.workspaceId))\n    )\n      return null;\n    const { relatedSessionIds: _related, ...publicEntity } = entity;\n    items.push({\n      ...publicEntity,\n      source: value.source,\n      ...(value.workspaceId === undefined ? {} : { workspaceId: value.workspaceId }),\n    });\n  }\n  const sources: HomeSourceStatus[] = [];\n  for (const value of input.sources) {\n    if (\n      !record(value) ||\n      !text(value.source, 128) ||\n      !coverage(value.coverage) ||\n      (value.workspaceId !== undefined && !text(value.workspaceId))\n    )\n      return null;\n    const sourceCounts = value.counts === undefined ? undefined : parseHomeCounts(value.counts);\n    if (sourceCounts === null) return null;\n    sources.push({\n      source: value.source,\n      coverage: value.coverage,\n      ...(sourceCounts === undefined ? {} : { counts: sourceCounts }),\n      ...(value.workspaceId === undefined ? {} : { workspaceId: value.workspaceId }),\n    });\n  }\n  if (\n    input.nextOffset !== undefined &&\n    (!Number.isSafeInteger(input.nextOffset) ||\n      (input.nextOffset as number) <= 0 ||\n      (input.nextOffset as number) >= (input.total as number))\n  )\n    return null;\n  return {\n    version: 1,\n    observedAt: input.observedAt,\n    items,\n    sources,\n    total: input.total as number,\n    counts,\n    ...(input.nextOffset === undefined ? {} : { nextOffset: input.nextOffset as number }),\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,63 @@
+//#region src/schemas/home.d.ts
+/** Compact, read-only operational summaries. Detailed state stays with its package. */
+export type HomeKind = 'decision' | 'failure' | 'blocked' | 'running' | 'queued' | 'paused' | 'completed';
+export type HomeCoverage = 'ready' | 'partial' | 'unavailable';
+export interface HomeContribution {
+  version: 1;
+  label: string;
+  /** The existing channel frame type owned by this package. */
+  source: string;
+  /** Existing session activity group, when the host supports opening it. */
+  destination?: string;
+}
+export interface HomeEntity {
+  /** Canonical within the source and workspace, including run generation or opaque graph identity. */
+  id: string;
+  kind: HomeKind;
+  title: string;
+  detail?: string;
+  updatedAt: string;
+  sessionId: string;
+  /** Every additional session whose information this entity contains. Checked before counting. */
+  relatedSessionIds?: readonly string[];
+}
+export interface HomeProjection {
+  coverage: HomeCoverage;
+  entities: readonly HomeEntity[];
+}
+export interface HomeItem extends Omit<HomeEntity, 'relatedSessionIds'> {
+  source: string;
+  workspaceId?: string;
+}
+export interface HomeSourceStatus {
+  source: string;
+  workspaceId?: string;
+  coverage: HomeCoverage;
+  counts?: Record<HomeKind, number>;
+}
+export interface HomeRequest {
+  offset?: number;
+  limit?: number;
+  source?: string;
+  workspaceId?: string;
+}
+export interface HomeSnapshot {
+  version: 1;
+  observedAt: string;
+  sources: HomeSourceStatus[];
+  /** Attention rows only. Working and finished entities are represented by counts. */
+  items: HomeItem[];
+  total: number;
+  counts: Record<HomeKind, number>;
+  nextOffset?: number;
+}
+export declare const HOME_PAGE_LIMIT = 50;
+export declare const HOME_ENTITY_LIMIT = 1000;
+export declare const HOME_KINDS: readonly HomeKind[];
+export declare function parseHomeContribution(input: unknown): HomeContribution | null;
+export declare function parseHomeEntity(input: unknown): HomeEntity | null;
+/** Reject a malformed source, rather than turning invalid records into a healthy count. */
+export declare function parseHomeProjection(input: unknown): HomeProjection | null;
+export declare function parseHomeSnapshot(input: unknown): HomeSnapshot | null;
+//#endregion
+//# sourceMappingURL=home.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home.d.mts","names":[],"sources":["../../../src/schemas/home.ts"],"mappings":";;YACY;YACA;iBAEK;EACf;EACA;;EAEA;;EAEA;;iBAGe;;EAEf;EACA,MAAM;EACN;EACA;EACA;EACA;;EAEA;;iBAGe;EACf,UAAU;EACV,mBAAmB;;iBAGJ,iBAAiB,KAAK;EACrC;EACA;;iBAGe;EACf;EACA;EACA,UAAU;EACV,SAAS,OAAO;;iBAGD;EACf;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA,SAAS;;EAET,OAAO;EACP;EACA,QAAQ,OAAO;EACf;;qBAGW;qBACA;qBACA,qBAAqB;wBA0BlB,sBAAsB,iBAAiB;wBAWvC,gBAAgB,iBAAiB;;wBAuBjC,oBAAoB,iBAAiB;wBA6BrC,kBAAkB,iBAAiB"}

package/dist/src/schemas/home.mjs

@@ -0,0 +1,121 @@
+//#region src/schemas/home.ts
+const HOME_PAGE_LIMIT = 50;
+const HOME_ENTITY_LIMIT = 1e3;
+const HOME_KINDS = [
+	"decision",
+	"failure",
+	"blocked",
+	"running",
+	"queued",
+	"paused",
+	"completed"
+];
+function record(input) {
+	return input !== null && typeof input === "object" && !Array.isArray(input);
+}
+function text(input, limit = 256) {
+	return typeof input === "string" && input.trim().length > 0 && input.length <= limit;
+}
+function timestamp(input) {
+	return text(input, 64) && Number.isFinite(Date.parse(input));
+}
+function coverage(input) {
+	return input === "ready" || input === "partial" || input === "unavailable";
+}
+function parseHomeContribution(input) {
+	if (!record(input) || input.version !== 1 || !text(input.label, 80) || !text(input.source, 128)) return null;
+	if (input.destination !== void 0 && !text(input.destination, 128)) return null;
+	return {
+		version: 1,
+		label: input.label,
+		source: input.source,
+		...input.destination === void 0 ? {} : { destination: input.destination }
+	};
+}
+function parseHomeEntity(input) {
+	if (!record(input) || !text(input.id, 512) || !text(input.sessionId) || !text(input.title, 160)) return null;
+	if (!HOME_KINDS.includes(input.kind) || !timestamp(input.updatedAt)) return null;
+	if (input.detail !== void 0 && !text(input.detail, 320)) return null;
+	if (input.relatedSessionIds !== void 0 && (!Array.isArray(input.relatedSessionIds) || input.relatedSessionIds.length > 64 || !input.relatedSessionIds.every((id) => text(id)))) return null;
+	return {
+		id: input.id,
+		kind: input.kind,
+		title: input.title,
+		updatedAt: input.updatedAt,
+		sessionId: input.sessionId,
+		...input.detail === void 0 ? {} : { detail: input.detail },
+		...input.relatedSessionIds === void 0 ? {} : { relatedSessionIds: input.relatedSessionIds }
+	};
+}
+/** Reject a malformed source, rather than turning invalid records into a healthy count. */
+function parseHomeProjection(input) {
+	if (!record(input) || !coverage(input.coverage) || !Array.isArray(input.entities) || input.entities.length > 1e3) return null;
+	const entities = [];
+	for (const value of input.entities) {
+		const entity = parseHomeEntity(value);
+		if (entity === null) return null;
+		entities.push(entity);
+	}
+	if (input.coverage === "unavailable" && entities.length > 0) return null;
+	return {
+		coverage: input.coverage,
+		entities
+	};
+}
+function parseHomeCounts(input) {
+	if (!record(input)) return null;
+	const counts = {};
+	for (const kind of HOME_KINDS) {
+		const count = input[kind];
+		if (!Number.isSafeInteger(count) || count < 0) return null;
+		counts[kind] = count;
+	}
+	return counts;
+}
+function parseHomeSnapshot(input) {
+	if (!record(input) || input.version !== 1 || !timestamp(input.observedAt) || !Array.isArray(input.items) || input.items.length > 50 || !Array.isArray(input.sources) || input.sources.length > 5e3 || !Number.isSafeInteger(input.total) || input.total < 0 || !record(input.counts)) return null;
+	const counts = parseHomeCounts(input.counts);
+	if (counts === null || counts.decision + counts.failure + counts.blocked + counts.paused !== input.total || input.items.length > input.total) return null;
+	const items = [];
+	for (const value of input.items) {
+		const entity = parseHomeEntity(value);
+		if (entity === null || ![
+			"decision",
+			"failure",
+			"blocked",
+			"paused"
+		].includes(entity.kind) || !record(value) || !text(value.source, 128) || value.workspaceId !== void 0 && !text(value.workspaceId)) return null;
+		const { relatedSessionIds: _related, ...publicEntity } = entity;
+		items.push({
+			...publicEntity,
+			source: value.source,
+			...value.workspaceId === void 0 ? {} : { workspaceId: value.workspaceId }
+		});
+	}
+	const sources = [];
+	for (const value of input.sources) {
+		if (!record(value) || !text(value.source, 128) || !coverage(value.coverage) || value.workspaceId !== void 0 && !text(value.workspaceId)) return null;
+		const sourceCounts = value.counts === void 0 ? void 0 : parseHomeCounts(value.counts);
+		if (sourceCounts === null) return null;
+		sources.push({
+			source: value.source,
+			coverage: value.coverage,
+			...sourceCounts === void 0 ? {} : { counts: sourceCounts },
+			...value.workspaceId === void 0 ? {} : { workspaceId: value.workspaceId }
+		});
+	}
+	if (input.nextOffset !== void 0 && (!Number.isSafeInteger(input.nextOffset) || input.nextOffset <= 0 || input.nextOffset >= input.total)) return null;
+	return {
+		version: 1,
+		observedAt: input.observedAt,
+		items,
+		sources,
+		total: input.total,
+		counts,
+		...input.nextOffset === void 0 ? {} : { nextOffset: input.nextOffset }
+	};
+}
+//#endregion
+export { HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot };
+
+//# sourceMappingURL=home.mjs.map