@agimon-ai/po-help 0.0.0-alpha.45 → 0.0.0-alpha.46

package/dist/index.cjs

@@ -23,8 +23,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 //#endregion
 let _agimon_ai_po_core_help = require("@agimon-ai/po-core/help");
 let node_crypto = require("node:crypto");
-let node_fs = require("node:fs");
-node_fs = __toESM(node_fs, 1);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises, 1);
 let node_os = require("node:os");
 node_os = __toESM(node_os, 1);
 let node_path = require("node:path");
@@ -350,37 +350,37 @@ function isContained(root, candidate) {
 	const relative = node_path.default.relative(root, candidate);
 	return relative === "" || !relative.startsWith(`..${node_path.default.sep}`) && relative !== ".." && !node_path.default.isAbsolute(relative);
 }
-function readManifest(filePath) {
+async function readManifest(filePath) {
 	let parsed;
 	try {
-		parsed = JSON.parse(node_fs.default.readFileSync(filePath, "utf8"));
+		parsed = JSON.parse(await node_fs_promises.default.readFile(filePath, "utf8"));
 	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
 		throw new Error(`Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
 	}
 	if (!isRecord$1(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);
 	return parsed;
 }
-function resolveHelpPackageIdentity(moduleUrl, expectedSource) {
+async function resolveHelpPackageIdentity(moduleUrl, expectedSource) {
 	if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);
 	let modulePath;
 	try {
 		const url = new URL(moduleUrl);
 		if (url.protocol !== "file:") throw new Error(`Help module URL must use file:, received ${url.protocol}`);
-		modulePath = node_fs.default.realpathSync((0, node_url.fileURLToPath)(url));
+		modulePath = await node_fs_promises.default.realpath((0, node_url.fileURLToPath)(url));
 	} catch (error) {
 		throw new Error(`Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`);
 	}
-	if (!node_fs.default.lstatSync(modulePath).isFile()) throw new Error(`Help contributor module is not a regular file: ${modulePath}`);
+	if (!(await node_fs_promises.default.lstat(modulePath)).isFile()) throw new Error(`Help contributor module is not a regular file: ${modulePath}`);
 	let directory = node_path.default.dirname(modulePath);
 	while (true) {
-		const manifestPath = node_path.default.join(directory, PACKAGE_MANIFEST);
-		if (node_fs.default.existsSync(manifestPath)) {
-			const manifest = readManifest(manifestPath);
+		const manifest = await readManifest(node_path.default.join(directory, PACKAGE_MANIFEST));
+		if (manifest !== void 0) {
 			const source = manifest.name;
 			const version = manifest.version;
 			if (source !== expectedSource) throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);
 			if (typeof version !== "string" || !EXACT_SEMVER_PATTERN.test(version)) throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);
-			const packageRoot = node_fs.default.realpathSync(directory);
+			const packageRoot = await node_fs_promises.default.realpath(directory);
 			if (!isContained(packageRoot, modulePath)) throw new Error("Help contributor module escapes its resolved package root.");
 			return {
 				source: expectedSource,
@@ -406,9 +406,21 @@ function parseCacheMetadata(value, identity) {
 	if (value.schemaVersion !== CACHE_SCHEMA_VERSION || value.source !== identity.source || value.version !== identity.version || value.path !== HELP_INDEX_PATH$1 || typeof value.integrity !== "string" || typeof value.digest !== "string" || typeof value.referenceBase !== "string") return;
 	return value;
 }
-function regularFile(filePath) {
+const cacheMutations = /* @__PURE__ */ new Map();
+async function mutateCacheEntry(directory, operation) {
+	const key = node_path.default.resolve(directory);
+	const result = (cacheMutations.get(key) ?? Promise.resolve()).then(operation);
+	const settled = result.then(() => {}, () => {});
+	cacheMutations.set(key, settled);
 	try {
-		const metadata = node_fs.default.lstatSync(filePath);
+		return await result;
+	} finally {
+		if (cacheMutations.get(key) === settled) cacheMutations.delete(key);
+	}
+}
+async function regularFile(filePath) {
+	try {
+		const metadata = await node_fs_promises.default.lstat(filePath);
 		return metadata.isFile() && !metadata.isSymbolicLink();
 	} catch {
 		return false;
@@ -423,24 +435,25 @@ var HelpIndexCache = class {
 		const key = sha256Hex(`${identity.source}\0${identity.version}\0${HELP_INDEX_PATH$1}`);
 		return node_path.default.join(this.root, key);
 	}
-	discard(identity) {
-		node_fs.default.rmSync(this.entryDirectory(identity), {
+	async discard(identity) {
+		const directory = this.entryDirectory(identity);
+		await mutateCacheEntry(directory, () => node_fs_promises.default.rm(directory, {
 			recursive: true,
 			force: true
-		});
+		}));
 	}
-	read(identity) {
+	async read(identity) {
 		const directory = this.entryDirectory(identity);
 		const completionPath = node_path.default.join(directory, COMPLETION_FILE);
 		const indexPath = node_path.default.join(directory, HELP_INDEX_PATH$1);
 		const metadataPath = node_path.default.join(directory, CACHE_METADATA_FILE);
-		if (!regularFile(completionPath) || !regularFile(indexPath) || !regularFile(metadataPath)) return void 0;
+		if (!await regularFile(completionPath) || !await regularFile(indexPath) || !await regularFile(metadataPath)) return void 0;
 		try {
-			const metadata = parseCacheMetadata(JSON.parse(node_fs.default.readFileSync(metadataPath, "utf8")), identity);
+			const metadata = parseCacheMetadata(JSON.parse(await node_fs_promises.default.readFile(metadataPath, "utf8")), identity);
 			if (!metadata) return void 0;
-			const bytes = node_fs.default.readFileSync(indexPath);
+			const bytes = await node_fs_promises.default.readFile(indexPath);
 			if (sha256Hex(bytes) !== metadata.digest) return void 0;
-			if (node_fs.default.readFileSync(completionPath, "utf8").trim() !== metadata.digest) return void 0;
+			if ((await node_fs_promises.default.readFile(completionPath, "utf8")).trim() !== metadata.digest) return void 0;
 			return {
 				bytes,
 				filePath: indexPath,
@@ -452,56 +465,58 @@ var HelpIndexCache = class {
 			return;
 		}
 	}
-	publish(identity, bytes, integrity, referenceBase, signal) {
-		assertNotAborted(signal);
-		const existing = this.read(identity);
-		if (existing) return existing;
+	async publish(identity, bytes, integrity, referenceBase, signal) {
 		const directory = this.entryDirectory(identity);
-		node_fs.default.mkdirSync(this.root, {
-			mode: PRIVATE_DIRECTORY_MODE,
-			recursive: true
-		});
-		if (node_fs.default.existsSync(directory)) node_fs.default.rmSync(directory, {
-			recursive: true,
-			force: true
-		});
-		const temporary = `${directory}.${process.pid}.${(0, node_crypto.randomUUID)()}.tmp`;
-		const digest = sha256Hex(bytes);
-		const metadata = {
-			schemaVersion: CACHE_SCHEMA_VERSION,
-			source: identity.source,
-			version: identity.version,
-			path: HELP_INDEX_PATH$1,
-			integrity,
-			digest,
-			referenceBase
-		};
-		try {
-			node_fs.default.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });
-			node_fs.default.writeFileSync(node_path.default.join(temporary, HELP_INDEX_PATH$1), bytes, { mode: PRIVATE_FILE_MODE });
-			node_fs.default.writeFileSync(node_path.default.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\n`, { mode: PRIVATE_FILE_MODE });
+		return mutateCacheEntry(directory, async () => {
 			assertNotAborted(signal);
-			node_fs.default.writeFileSync(node_path.default.join(temporary, COMPLETION_FILE), `${digest}\n`, { mode: PRIVATE_FILE_MODE });
-			try {
-				node_fs.default.renameSync(temporary, directory);
-			} catch (error) {
-				const winner = this.read(identity);
-				if (winner) return winner;
-				throw error;
-			}
-			return {
-				bytes: Uint8Array.from(bytes),
-				filePath: node_path.default.join(directory, HELP_INDEX_PATH$1),
+			const existing = await this.read(identity);
+			if (existing) return existing;
+			await node_fs_promises.default.mkdir(this.root, {
+				mode: PRIVATE_DIRECTORY_MODE,
+				recursive: true
+			});
+			await node_fs_promises.default.rm(directory, {
+				recursive: true,
+				force: true
+			});
+			const temporary = `${directory}.${process.pid}.${(0, node_crypto.randomUUID)()}.tmp`;
+			const digest = sha256Hex(bytes);
+			const metadata = {
+				schemaVersion: CACHE_SCHEMA_VERSION,
+				source: identity.source,
+				version: identity.version,
+				path: HELP_INDEX_PATH$1,
 				integrity,
 				digest,
 				referenceBase
 			};
-		} finally {
-			node_fs.default.rmSync(temporary, {
-				recursive: true,
-				force: true
-			});
-		}
+			try {
+				await node_fs_promises.default.mkdir(temporary, { mode: PRIVATE_DIRECTORY_MODE });
+				await node_fs_promises.default.writeFile(node_path.default.join(temporary, HELP_INDEX_PATH$1), bytes, { mode: PRIVATE_FILE_MODE });
+				await node_fs_promises.default.writeFile(node_path.default.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\n`, { mode: PRIVATE_FILE_MODE });
+				assertNotAborted(signal);
+				await node_fs_promises.default.writeFile(node_path.default.join(temporary, COMPLETION_FILE), `${digest}\n`, { mode: PRIVATE_FILE_MODE });
+				try {
+					await node_fs_promises.default.rename(temporary, directory);
+				} catch (error) {
+					const winner = await this.read(identity);
+					if (winner) return winner;
+					throw error;
+				}
+				return {
+					bytes: Uint8Array.from(bytes),
+					filePath: node_path.default.join(directory, HELP_INDEX_PATH$1),
+					integrity,
+					digest,
+					referenceBase
+				};
+			} finally {
+				await node_fs_promises.default.rm(temporary, {
+					recursive: true,
+					force: true
+				});
+			}
+		});
 	}
 };
 var DefaultHelpSkillMaterializer = class {
@@ -517,27 +532,35 @@ var DefaultHelpSkillMaterializer = class {
 			const directory = node_path.default.join(this.cacheRoot, WRAPPER_DIRECTORY, key);
 			const filePath = node_path.default.join(directory, SKILL_FILE);
 			const content = renderHelpSkillWrapper(descriptor, index);
-			if (!regularFile(filePath) || node_fs.default.readFileSync(filePath, "utf8") !== content) {
-				node_fs.default.mkdirSync(node_path.default.dirname(directory), {
+			const matches = async () => {
+				try {
+					const metadata = await node_fs_promises.default.lstat(filePath);
+					return metadata.isFile() && !metadata.isSymbolicLink() && await node_fs_promises.default.readFile(filePath, "utf8") === content;
+				} catch {
+					return false;
+				}
+			};
+			if (!await matches()) {
+				await node_fs_promises.default.mkdir(node_path.default.dirname(directory), {
 					mode: PRIVATE_DIRECTORY_MODE,
 					recursive: true
 				});
-				if (node_fs.default.existsSync(directory)) node_fs.default.rmSync(directory, {
+				await node_fs_promises.default.rm(directory, {
 					recursive: true,
 					force: true
 				});
 				const temporary = `${directory}.${process.pid}.${(0, node_crypto.randomUUID)()}.tmp`;
 				try {
-					node_fs.default.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });
-					node_fs.default.writeFileSync(node_path.default.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });
+					await node_fs_promises.default.mkdir(temporary, { mode: PRIVATE_DIRECTORY_MODE });
+					await node_fs_promises.default.writeFile(node_path.default.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });
 					assertNotAborted(signal);
 					try {
-						node_fs.default.renameSync(temporary, directory);
+						await node_fs_promises.default.rename(temporary, directory);
 					} catch (error) {
-						if (!regularFile(filePath) || node_fs.default.readFileSync(filePath, "utf8") !== content) throw error;
+						if (!await matches()) throw error;
 					}
 				} finally {
-					node_fs.default.rmSync(temporary, {
+					await node_fs_promises.default.rm(temporary, {
 						recursive: true,
 						force: true
 					});
@@ -568,12 +591,13 @@ function defaultFetch(input, init) {
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function isRegularFile(filePath) {
+async function isRegularFile(filePath) {
 	try {
-		const metadata = node_fs.default.lstatSync(filePath);
+		const metadata = await node_fs_promises.default.lstat(filePath);
 		return metadata.isFile() && !metadata.isSymbolicLink();
-	} catch {
-		return false;
+	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
+		throw error;
 	}
 }
 function unpkgPackagePath(source, version) {
@@ -654,11 +678,12 @@ var DefaultHelpIndexResolver = class {
 	}
 	async resolve(contribution, signal) {
 		if (signal.aborted) throw new Error("Help activation was cancelled.");
-		const identity = resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);
+		const identity = await resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);
 		const localPath = node_path.default.join(identity.packageRoot, HELP_INDEX_PATH);
-		if (node_fs.default.existsSync(localPath)) {
-			if (!isRegularFile(localPath)) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);
-			const bytes = node_fs.default.readFileSync(localPath);
+		const regular = await isRegularFile(localPath);
+		if (regular !== void 0) {
+			if (!regular) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);
+			const bytes = await node_fs_promises.default.readFile(localPath);
 			validateLlmsBytes(bytes);
 			return {
 				identity,
@@ -669,7 +694,7 @@ var DefaultHelpIndexResolver = class {
 				digest: sha256Hex(bytes)
 			};
 		}
-		const cached = this.cache.read(identity);
+		const cached = await this.cache.read(identity);
 		if (cached) try {
 			validateLlmsBytes(cached.bytes);
 			return {
@@ -681,7 +706,7 @@ var DefaultHelpIndexResolver = class {
 				digest: cached.digest
 			};
 		} catch {
-			this.cache.discard(identity);
+			await this.cache.discard(identity);
 		}
 		const timed = timeoutSignal(signal, this.timeoutMs);
 		try {
@@ -700,7 +725,7 @@ var DefaultHelpIndexResolver = class {
 			const bytes = new Uint8Array(await indexResponse.arrayBuffer());
 			validateLlmsBytes(bytes);
 			verifySri(bytes, metadata.integrity);
-			const published = this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);
+			const published = await this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);
 			return {
 				identity,
 				location: "remote",

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["PO_HELP_MAX_DIAGNOSTIC_LENGTH","PO_HELP_MAX_SKILLS","PO_HELP_MAX_DIAGNOSTICS","HELP_INDEX_PATH","isRecord","path","fs","fileURLToPath","os","poHomeDirectory","createHash","randomUUID","fs","createHash","path"],"sources":["../src/services/llmsContent/index.ts","../src/services/helpActivation/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts","../src/services/helpRuntime/index.ts"],"sourcesContent":["import type { PoHelpSkillDescriptor } from '@agimon-ai/po-core/help';\n\nimport type { ResolvedHelpIndex } from '../../types/help';\n\nexport const MAX_LLMS_BYTES = 1024 * 1024;\nexport const MAX_AGGREGATE_LLMS_BYTES = 4 * MAX_LLMS_BYTES;\n\nconst MARKDOWN_LINK_PATTERN = /!?\\[[^\\]]*\\]\\(\\s*<?([^\\s)>]+)>?(?:\\s+[^)]*)?\\)/gu;\nconst MARKDOWN_REFERENCE_LINK_PATTERN = /^\\s{0,3}\\[[^\\]\\r\\n]+\\]:\\s*<?([^\\s>]+)>?/gmu;\nconst MARKDOWN_AUTOLINK_PATTERN = /<((?:\\.{0,2}\\/|[A-Za-z][A-Za-z0-9+.-]*:)[^<>\\s]+)>/gu;\nconst HTML_LINK_PATTERN = /\\b(?:href|src)\\s*=\\s*[\"']([^\"']+)[\"']/giu;\nconst URI_SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:/iu;\nconst NESTED_PATH_ENCODING_PATTERN = /%(?:25|2e|2f|3a|5c)/iu;\nconst SAFE_EXTERNAL_SCHEMES = new Set(['http:', 'https:', 'mailto:']);\n\nfunction externalScheme(target: string): string | undefined {\n  if (!URI_SCHEME_PATTERN.test(target)) return undefined;\n  return target.slice(0, target.indexOf(':') + 1).toLowerCase();\n}\n\nfunction decodeRelativeTarget(rawTarget: string): string {\n  let decoded = rawTarget;\n  try {\n    for (let pass = 0; pass < 2; pass += 1) {\n      const next = decodeURIComponent(decoded);\n      if (next === decoded) break;\n      decoded = next;\n    }\n  } catch {\n    throw new Error(`llms.txt contains an invalid encoded link '${rawTarget}'.`);\n  }\n  if (NESTED_PATH_ENCODING_PATTERN.test(decoded)) {\n    throw new Error(`llms.txt contains an unsafe nested encoding in link '${rawTarget}'.`);\n  }\n  return decoded;\n}\n\nfunction validateRelativeLink(rawTarget: string): void {\n  if (!rawTarget || rawTarget.startsWith('#')) return;\n  const rawScheme = externalScheme(rawTarget);\n  if (rawScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(rawScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${rawScheme}'.`);\n    }\n    return;\n  }\n\n  const decoded = decodeRelativeTarget(rawTarget);\n  const decodedScheme = externalScheme(decoded);\n  if (decodedScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(decodedScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${decodedScheme}'.`);\n    }\n    return;\n  }\n  const withoutSuffix = decoded.split(/[?#]/u, 1)[0]?.replaceAll('\\\\', '/') ?? '';\n  if (withoutSuffix.startsWith('/') || withoutSuffix.split('/').some((segment) => segment === '..')) {\n    throw new Error(`llms.txt link '${rawTarget}' escapes the package root.`);\n  }\n}\n\nfunction containsUnsafeControl(text: string): boolean {\n  for (const character of text) {\n    const code = character.codePointAt(0) ?? 0;\n    if ((code >= 0 && code <= 8) || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function validateLlmsBytes(bytes: Uint8Array): string {\n  if (bytes.byteLength === 0) throw new Error('llms.txt is empty.');\n  if (bytes.byteLength > MAX_LLMS_BYTES) throw new Error(`llms.txt exceeds ${MAX_LLMS_BYTES} bytes.`);\n\n  let text: string;\n  try {\n    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);\n  } catch {\n    throw new Error('llms.txt is not valid UTF-8.');\n  }\n  if (text.startsWith('\\uFEFF')) text = text.slice(1);\n  if (containsUnsafeControl(text)) throw new Error('llms.txt contains unsafe control bytes.');\n\n  const firstContentLine = text\n    .split(/\\r?\\n/u)\n    .find((line) => line.trim().length > 0)\n    ?.trim();\n  if (!firstContentLine || !/^#\\s+\\S/u.test(firstContentLine)) {\n    throw new Error('llms.txt must begin with a Markdown H1 heading.');\n  }\n  for (const pattern of [\n    MARKDOWN_LINK_PATTERN,\n    MARKDOWN_REFERENCE_LINK_PATTERN,\n    MARKDOWN_AUTOLINK_PATTERN,\n    HTML_LINK_PATTERN,\n  ]) {\n    for (const match of text.matchAll(pattern)) validateRelativeLink(match[1] ?? '');\n  }\n  return text;\n}\n\nexport function renderHelpSkillWrapper(descriptor: PoHelpSkillDescriptor, index: ResolvedHelpIndex): string {\n  const name = JSON.stringify(descriptor.name);\n  const description = JSON.stringify(descriptor.description);\n  const indexPath = JSON.stringify(index.filePath);\n  const referenceBase = JSON.stringify(index.referenceBase);\n  return `---\\nname: ${name}\\ndescription: ${description}\\n---\\n\\n# Package Help\\n\\nRead the validated package Help index at ${indexPath}.\\nResolve relative links in that index against ${referenceBase}.\\nOpen only the linked documents relevant to the current request, as needed; do not recursively load the whole reference set.\\n`;\n}\n","import {\n  PO_HELP_MAX_DIAGNOSTIC_LENGTH,\n  PO_HELP_MAX_DIAGNOSTICS,\n  PO_HELP_MAX_SKILLS,\n  type PoHelpContribution,\n  type PoHelpDiagnostic,\n  type PoHelpSkill,\n} from '@agimon-ai/po-core/help';\n\nimport type {\n  HelpActivationDependencies,\n  HelpActivationService,\n  HelpRuntimeState,\n  ResolvedHelpIndex,\n} from '../../types/help';\nimport { MAX_AGGREGATE_LLMS_BYTES } from '../llmsContent';\n\nconst MAX_RESOLUTION_CONCURRENCY = 4;\nconst FAILURE_MESSAGE = 'No package Help source could be activated.';\nconst CANCELLATION_MESSAGE = 'Help activation was cancelled.';\n\ninterface LoadedSource {\n  contribution: PoHelpContribution;\n  index: ResolvedHelpIndex;\n  skills: readonly PoHelpSkill[];\n}\n\ninterface SourceOutcome {\n  source: string;\n  loaded?: LoadedSource;\n  error?: unknown;\n}\n\nexport class HelpActivationError extends Error {\n  constructor(message = FAILURE_MESSAGE) {\n    super(message);\n    this.name = 'HelpActivationError';\n  }\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 cloneState(state: HelpRuntimeState): HelpRuntimeState {\n  return {\n    activation: state.activation,\n    skills: state.skills.map((skill) => ({ ...skill })),\n    diagnostics: state.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction diagnostic(source: string, code: string, error: unknown): PoHelpDiagnostic {\n  const raw = error instanceof Error ? error.message : String(error);\n  const message = (raw || 'Unknown Help activation failure.').slice(0, PO_HELP_MAX_DIAGNOSTIC_LENGTH);\n  return { source, code, message };\n}\n\nfunction contributionFingerprint(contributions: readonly PoHelpContribution[]): string {\n  return JSON.stringify(\n    contributions.map((contribution) => ({\n      source: contribution.source,\n      moduleUrl: contribution.moduleUrl,\n      skills: contribution.skills,\n    })),\n  );\n}\n\nexport class DefaultHelpActivationService implements HelpActivationService {\n  private readonly dependencies: HelpActivationDependencies;\n  private readonly listeners = new Set<(state: HelpRuntimeState) => void>();\n  private contributions: PoHelpContribution[] = [];\n  private fingerprint = '[]';\n  private state: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private settledState: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private generation = 0;\n  private controller: AbortController | undefined;\n  private disposed = false;\n\n  constructor(dependencies: HelpActivationDependencies) {\n    this.dependencies = dependencies;\n  }\n\n  getState(): HelpRuntimeState {\n    return cloneState(this.state);\n  }\n\n  replaceContributions(contributions: readonly PoHelpContribution[]): void {\n    if (this.disposed) return;\n    const next = contributions.map(cloneContribution).sort((left, right) => left.source.localeCompare(right.source));\n    const fingerprint = contributionFingerprint(next);\n    if (fingerprint === this.fingerprint) return;\n    const previous = new Map(this.contributions.map((entry) => [entry.source, contributionFingerprint([entry])]));\n    const retained = new Set(\n      next\n        .filter((entry) => previous.get(entry.source) === contributionFingerprint([entry]))\n        .map((entry) => entry.source),\n    );\n    // A refresh may retain unchanged owners, never withdrawn or replaced ones.\n    // Prune the rollback snapshot too, so cancellation cannot resurrect them.\n    const skills = this.settledState.skills.filter((entry) => retained.has(entry.source));\n    const diagnostics = this.settledState.diagnostics.filter((entry) => !entry.source || retained.has(entry.source));\n    this.settledState = {\n      activation: skills.length === 0 ? 'inactive' : diagnostics.length > 0 ? 'degraded' : 'active',\n      skills,\n      diagnostics,\n    };\n    this.contributions = next;\n    this.fingerprint = fingerprint;\n    if (this.state.activation !== 'inactive') {\n      void this.activate().catch((error: unknown) => {\n        // Activation failures publish a bounded settled state before rejecting.\n        // Only unexpected implementation failures need an out-of-band report.\n        if (error instanceof HelpActivationError) return;\n        this.dependencies.onBackgroundError(error);\n      });\n    }\n  }\n\n  subscribe(listener: (state: HelpRuntimeState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private publish(state: HelpRuntimeState): HelpRuntimeState {\n    this.state = cloneState(state);\n    if (state.activation !== 'activating') this.settledState = cloneState(state);\n    this.dependencies.publisher.publish(this.state);\n    for (const listener of this.listeners) listener(cloneState(this.state));\n    return this.getState();\n  }\n\n  private async loadSources(signal: AbortSignal): Promise<SourceOutcome[]> {\n    const contributions = this.contributions;\n    const outcomes: SourceOutcome[] = Array.from({ length: contributions.length });\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (cursor < contributions.length) {\n        const index = cursor;\n        cursor += 1;\n        const contribution = contributions[index];\n        if (!contribution) return;\n        if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n        try {\n          const resolved = await this.dependencies.resolver.resolve(contribution, signal);\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          const skills = await this.dependencies.materializer.materialize(contribution, resolved, signal);\n          outcomes[index] = { source: contribution.source, loaded: { contribution, index: resolved, skills } };\n        } catch (error) {\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          outcomes[index] = { source: contribution.source, error };\n        }\n      }\n    };\n    const count = Math.min(MAX_RESOLUTION_CONCURRENCY, contributions.length);\n    await Promise.all(Array.from({ length: count }, () => worker()));\n    return outcomes;\n  }\n\n  async activate(externalSignal?: AbortSignal): Promise<HelpRuntimeState> {\n    if (this.disposed) throw new HelpActivationError('Help runtime is disposed.');\n    this.controller?.abort('Help activation generation replaced.');\n    const controller = new AbortController();\n    this.controller = controller;\n    const generation = ++this.generation;\n    const abortFromExternal = () => controller.abort(externalSignal?.reason);\n    externalSignal?.addEventListener('abort', abortFromExternal, { once: true });\n    if (externalSignal?.aborted) abortFromExternal();\n\n    const settledState = cloneState(this.settledState);\n    this.publish({ activation: 'activating', skills: settledState.skills, diagnostics: settledState.diagnostics });\n    try {\n      const outcomes = await this.loadSources(controller.signal);\n      if (controller.signal.aborted || generation !== this.generation) {\n        throw new HelpActivationError(CANCELLATION_MESSAGE);\n      }\n\n      const diagnostics: PoHelpDiagnostic[] = [];\n      const loaded: LoadedSource[] = [];\n      let aggregateBytes = 0;\n      for (const outcome of outcomes) {\n        if (!outcome) continue;\n        if (outcome.error || !outcome.loaded) {\n          diagnostics.push(diagnostic(outcome.source, 'HELP_SOURCE_FAILED', outcome.error));\n          continue;\n        }\n        if (aggregateBytes + outcome.loaded.index.byteLength > MAX_AGGREGATE_LLMS_BYTES) {\n          diagnostics.push(\n            diagnostic(outcome.source, 'HELP_AGGREGATE_LIMIT', 'The aggregate llms.txt byte limit was exceeded.'),\n          );\n          continue;\n        }\n        aggregateBytes += outcome.loaded.index.byteLength;\n        loaded.push(outcome.loaded);\n      }\n\n      const skills: PoHelpSkill[] = [];\n      const names = new Set<string>();\n      for (const source of loaded) {\n        for (const skill of source.skills) {\n          if (skills.length >= PO_HELP_MAX_SKILLS) {\n            diagnostics.push(\n              diagnostic(source.contribution.source, 'HELP_SKILL_LIMIT', 'The Help skill limit was reached.'),\n            );\n            break;\n          }\n          if (names.has(skill.name)) {\n            diagnostics.push(\n              diagnostic(\n                source.contribution.source,\n                'HELP_SKILL_COLLISION',\n                `Help skill '${skill.name}' was already provided by an earlier package source.`,\n              ),\n            );\n            continue;\n          }\n          names.add(skill.name);\n          skills.push({ ...skill });\n        }\n      }\n\n      const boundedDiagnostics = diagnostics.slice(0, PO_HELP_MAX_DIAGNOSTICS);\n      if (skills.length === 0) {\n        this.publish({ activation: 'inactive', skills: [], diagnostics: boundedDiagnostics });\n        throw new HelpActivationError();\n      }\n      return this.publish({\n        activation: boundedDiagnostics.length > 0 ? 'degraded' : 'active',\n        skills,\n        diagnostics: boundedDiagnostics,\n      });\n    } catch (error) {\n      if (generation === this.generation && this.state.activation === 'activating') this.publish(settledState);\n      throw error;\n    } finally {\n      externalSignal?.removeEventListener('abort', abortFromExternal);\n      if (this.controller === controller) this.controller = undefined;\n    }\n  }\n\n  deactivate(): HelpRuntimeState {\n    this.generation += 1;\n    this.controller?.abort('Help deactivated.');\n    this.controller = undefined;\n    return this.publish({ activation: 'inactive', skills: [], diagnostics: [] });\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.deactivate();\n    this.disposed = true;\n    this.listeners.clear();\n  }\n}\n","import { createHash, randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { PoHelpContribution, PoHelpSkill } from '@agimon-ai/po-core/help';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport type { HelpPackageIdentity, HelpSkillMaterializer, ResolvedHelpIndex } from '../../types/help';\nimport { renderHelpSkillWrapper } from '../llmsContent';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst HELP_INDEX_PATH = 'llms.txt';\nconst CACHE_SCHEMA_VERSION = 1;\nconst PRIVATE_FILE_MODE = 0o600;\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst COMPLETION_FILE = '.complete';\nconst CACHE_METADATA_FILE = 'metadata.json';\nconst WRAPPER_DIRECTORY = 'wrappers';\nconst SKILL_FILE = 'SKILL.md';\nconst EXACT_SEMVER_PATTERN =\n  /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u;\nconst NPM_PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\\/)?[a-z0-9][a-z0-9._~-]*$/u;\n\ninterface CacheMetadata {\n  schemaVersion: typeof CACHE_SCHEMA_VERSION;\n  source: string;\n  version: string;\n  path: typeof HELP_INDEX_PATH;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nexport interface CachedHelpIndex {\n  bytes: Uint8Array;\n  filePath: string;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nfunction assertNotAborted(signal: AbortSignal): void {\n  if (signal.aborted) throw new Error('Help activation was cancelled.');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isContained(root: string, candidate: string): boolean {\n  const relative = path.relative(root, candidate);\n  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));\n}\n\nfunction readManifest(filePath: string): Record<string, unknown> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(fs.readFileSync(filePath, 'utf8')) as unknown;\n  } catch (error) {\n    throw new Error(\n      `Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!isRecord(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);\n  return parsed;\n}\n\nexport function resolveHelpPackageIdentity(moduleUrl: string, expectedSource: string): HelpPackageIdentity {\n  if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) {\n    throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);\n  }\n  let modulePath: string;\n  try {\n    const url = new URL(moduleUrl);\n    if (url.protocol !== 'file:') throw new Error(`Help module URL must use file:, received ${url.protocol}`);\n    modulePath = fs.realpathSync(fileURLToPath(url));\n  } catch (error) {\n    throw new Error(\n      `Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!fs.lstatSync(modulePath).isFile())\n    throw new Error(`Help contributor module is not a regular file: ${modulePath}`);\n\n  let directory = path.dirname(modulePath);\n  while (true) {\n    const manifestPath = path.join(directory, PACKAGE_MANIFEST);\n    if (fs.existsSync(manifestPath)) {\n      const manifest = readManifest(manifestPath);\n      const source = manifest.name;\n      const version = manifest.version;\n      if (source !== expectedSource) {\n        throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);\n      }\n      if (typeof version !== 'string' || !EXACT_SEMVER_PATTERN.test(version)) {\n        throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);\n      }\n      const packageRoot = fs.realpathSync(directory);\n      if (!isContained(packageRoot, modulePath))\n        throw new Error('Help contributor module escapes its resolved package root.');\n      return { source: expectedSource, version, packageRoot, modulePath };\n    }\n    const parent = path.dirname(directory);\n    if (parent === directory) break;\n    directory = parent;\n  }\n  throw new Error(`Cannot find a package manifest for Help contributor ${modulePath}.`);\n}\n\nexport function defaultHelpCacheRoot(homeDirectory = os.homedir()): string {\n  return path.join(poHomeDirectory(homeDirectory), 'llms-cache');\n}\n\nexport function sha256Hex(bytes: Uint8Array | string): string {\n  return createHash('sha256').update(bytes).digest('hex');\n}\n\nfunction parseCacheMetadata(value: unknown, identity: HelpPackageIdentity): CacheMetadata | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.schemaVersion !== CACHE_SCHEMA_VERSION ||\n    value.source !== identity.source ||\n    value.version !== identity.version ||\n    value.path !== HELP_INDEX_PATH ||\n    typeof value.integrity !== 'string' ||\n    typeof value.digest !== 'string' ||\n    typeof value.referenceBase !== 'string'\n  ) {\n    return undefined;\n  }\n  return value as unknown as CacheMetadata;\n}\n\nfunction regularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nexport class HelpIndexCache {\n  readonly root: string;\n\n  constructor(root = defaultHelpCacheRoot()) {\n    this.root = root;\n  }\n\n  entryDirectory(identity: HelpPackageIdentity): string {\n    const key = sha256Hex(`${identity.source}\\0${identity.version}\\0${HELP_INDEX_PATH}`);\n    return path.join(this.root, key);\n  }\n\n  discard(identity: HelpPackageIdentity): void {\n    fs.rmSync(this.entryDirectory(identity), { recursive: true, force: true });\n  }\n\n  read(identity: HelpPackageIdentity): CachedHelpIndex | undefined {\n    const directory = this.entryDirectory(identity);\n    const completionPath = path.join(directory, COMPLETION_FILE);\n    const indexPath = path.join(directory, HELP_INDEX_PATH);\n    const metadataPath = path.join(directory, CACHE_METADATA_FILE);\n    if (!regularFile(completionPath) || !regularFile(indexPath) || !regularFile(metadataPath)) return undefined;\n    try {\n      const metadata = parseCacheMetadata(JSON.parse(fs.readFileSync(metadataPath, 'utf8')) as unknown, identity);\n      if (!metadata) return undefined;\n      const bytes = fs.readFileSync(indexPath);\n      if (sha256Hex(bytes) !== metadata.digest) return undefined;\n      if (fs.readFileSync(completionPath, 'utf8').trim() !== metadata.digest) return undefined;\n      return {\n        bytes,\n        filePath: indexPath,\n        integrity: metadata.integrity,\n        digest: metadata.digest,\n        referenceBase: metadata.referenceBase,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  publish(\n    identity: HelpPackageIdentity,\n    bytes: Uint8Array,\n    integrity: string,\n    referenceBase: string,\n    signal: AbortSignal,\n  ): CachedHelpIndex {\n    assertNotAborted(signal);\n    const existing = this.read(identity);\n    if (existing) return existing;\n    const directory = this.entryDirectory(identity);\n    fs.mkdirSync(this.root, { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n    if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n    const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n    const digest = sha256Hex(bytes);\n    const metadata: CacheMetadata = {\n      schemaVersion: CACHE_SCHEMA_VERSION,\n      source: identity.source,\n      version: identity.version,\n      path: HELP_INDEX_PATH,\n      integrity,\n      digest,\n      referenceBase,\n    };\n    try {\n      fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n      fs.writeFileSync(path.join(temporary, HELP_INDEX_PATH), bytes, { mode: PRIVATE_FILE_MODE });\n      fs.writeFileSync(path.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\\n`, {\n        mode: PRIVATE_FILE_MODE,\n      });\n      assertNotAborted(signal);\n      fs.writeFileSync(path.join(temporary, COMPLETION_FILE), `${digest}\\n`, { mode: PRIVATE_FILE_MODE });\n      try {\n        fs.renameSync(temporary, directory);\n      } catch (error) {\n        const winner = this.read(identity);\n        if (winner) return winner;\n        throw error;\n      }\n      return {\n        bytes: Uint8Array.from(bytes),\n        filePath: path.join(directory, HELP_INDEX_PATH),\n        integrity,\n        digest,\n        referenceBase,\n      };\n    } finally {\n      fs.rmSync(temporary, { recursive: true, force: true });\n    }\n  }\n}\n\nexport class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {\n  constructor(private readonly cacheRoot = defaultHelpCacheRoot()) {}\n\n  async materialize(\n    contribution: PoHelpContribution,\n    index: ResolvedHelpIndex,\n    signal: AbortSignal,\n  ): Promise<readonly PoHelpSkill[]> {\n    const skills: PoHelpSkill[] = [];\n    for (const descriptor of contribution.skills) {\n      assertNotAborted(signal);\n      const key = sha256Hex(\n        `${index.identity.source}\\0${index.identity.version}\\0${descriptor.name}\\0${descriptor.description}\\0${index.digest}`,\n      );\n      const directory = path.join(this.cacheRoot, WRAPPER_DIRECTORY, key);\n      const filePath = path.join(directory, SKILL_FILE);\n      const content = renderHelpSkillWrapper(descriptor, index);\n      if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) {\n        fs.mkdirSync(path.dirname(directory), { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n        if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n        const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n        try {\n          fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n          fs.writeFileSync(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });\n          assertNotAborted(signal);\n          try {\n            fs.renameSync(temporary, directory);\n          } catch (error) {\n            if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) throw error;\n          }\n        } finally {\n          fs.rmSync(temporary, { recursive: true, force: true });\n        }\n      }\n      skills.push({\n        source: contribution.source,\n        name: descriptor.name,\n        description: descriptor.description,\n        filePath,\n        baseDir: directory,\n      });\n    }\n    return skills;\n  }\n}\n","import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { PoHelpContribution } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch, HelpFetchResponse, HelpIndexResolver, ResolvedHelpIndex } from '../../types/help';\nimport { HelpIndexCache, resolveHelpPackageIdentity, sha256Hex } from '../helpStorage';\nimport { MAX_LLMS_BYTES, validateLlmsBytes } from '../llmsContent';\n\nconst HELP_INDEX_PATH = 'llms.txt';\nconst UNPKG_ORIGIN = 'https://unpkg.com';\nconst DEFAULT_FETCH_TIMEOUT_MS = 5_000;\nconst MAX_METADATA_BYTES = 512 * 1024;\nconst MAX_REDIRECTS = 3;\nconst SRI_PATTERN = /^sha256-([A-Za-z0-9+/]+={0,2})$/u;\n\ninterface UnpkgMetadataFile {\n  path: string;\n  size?: number;\n  integrity: string;\n}\n\nexport interface DefaultHelpIndexResolverOptions {\n  cache?: HelpIndexCache;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n}\n\nfunction defaultFetch(input: string, init: { signal: AbortSignal; redirect: 'manual' }): Promise<HelpFetchResponse> {\n  return fetch(input, init) as unknown as Promise<HelpFetchResponse>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isRegularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nfunction unpkgPackagePath(source: string, version: string): string {\n  const encoded = source\n    .split('/')\n    .map((segment) =>\n      segment.startsWith('@') ? `@${encodeURIComponent(segment.slice(1))}` : encodeURIComponent(segment),\n    )\n    .join('/');\n  return `${encoded}@${encodeURIComponent(version)}`;\n}\n\nfunction exactUnpkgBase(source: string, version: string): string {\n  return `${UNPKG_ORIGIN}/${unpkgPackagePath(source, version)}/`;\n}\n\nfunction contentLength(response: HelpFetchResponse): number | undefined {\n  const raw = response.headers.get('content-length');\n  if (!raw) return undefined;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;\n}\n\nfunction timeoutSignal(parent: AbortSignal, timeoutMs: number): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abort = () => controller.abort(parent.reason);\n  parent.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(() => controller.abort(new Error('Help download timed out.')), timeoutMs);\n  if (parent.aborted) abort();\n  return {\n    signal: controller.signal,\n    dispose() {\n      clearTimeout(timer);\n      parent.removeEventListener('abort', abort);\n    },\n  };\n}\n\nasync function fetchExact(fetcher: HelpFetch, initialUrl: string, signal: AbortSignal): Promise<HelpFetchResponse> {\n  let url = initialUrl;\n  const expected = new URL(initialUrl);\n  for (let redirect = 0; redirect <= MAX_REDIRECTS; redirect += 1) {\n    const response = await fetcher(url, { signal, redirect: 'manual' });\n    if (response.status < 300 || response.status >= 400) return response;\n    const location = response.headers.get('location');\n    if (!location) throw new Error(`Unpkg redirected ${url} without a location.`);\n    const next = new URL(location, url);\n    if (next.origin !== UNPKG_ORIGIN || next.pathname !== expected.pathname || next.search !== expected.search) {\n      throw new Error(`Unpkg redirect escaped the exact package/version path: ${next.href}`);\n    }\n    url = next.href;\n  }\n  throw new Error(`Unpkg exceeded ${MAX_REDIRECTS} redirects.`);\n}\n\nfunction parseMetadata(text: string): UnpkgMetadataFile {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text) as unknown;\n  } catch {\n    throw new Error('Unpkg metadata is not valid JSON.');\n  }\n  if (!isRecord(parsed) || !Array.isArray(parsed.files)) throw new Error('Unpkg metadata has no files list.');\n  const match = parsed.files.find((entry) => isRecord(entry) && entry.path === `/${HELP_INDEX_PATH}`);\n  if (!isRecord(match) || typeof match.integrity !== 'string') {\n    throw new Error(`Unpkg package does not publish /${HELP_INDEX_PATH}.`);\n  }\n  const size = typeof match.size === 'number' ? match.size : undefined;\n  if (size !== undefined && (!Number.isSafeInteger(size) || size < 0 || size > MAX_LLMS_BYTES)) {\n    throw new Error(`Unpkg /${HELP_INDEX_PATH} exceeds the Help size limit.`);\n  }\n  if (!SRI_PATTERN.test(match.integrity)) throw new Error('Unpkg llms.txt metadata does not contain SHA-256 SRI.');\n  return { path: match.path as string, ...(size === undefined ? {} : { size }), integrity: match.integrity };\n}\n\nfunction verifySri(bytes: Uint8Array, integrity: string): void {\n  const expected = SRI_PATTERN.exec(integrity)?.[1];\n  if (!expected) throw new Error('Invalid llms.txt SRI metadata.');\n  const actual = createHash('sha256').update(bytes).digest('base64');\n  if (actual !== expected) throw new Error('Downloaded llms.txt failed SRI verification.');\n}\n\nexport class DefaultHelpIndexResolver implements HelpIndexResolver {\n  private readonly cache: HelpIndexCache;\n  private readonly fetcher: HelpFetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: DefaultHelpIndexResolverOptions = {}) {\n    this.cache = options.cache ?? new HelpIndexCache();\n    this.fetcher = options.fetch ?? defaultFetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n  }\n\n  async resolve(contribution: PoHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex> {\n    if (signal.aborted) throw new Error('Help activation was cancelled.');\n    const identity = resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);\n    const localPath = path.join(identity.packageRoot, HELP_INDEX_PATH);\n    if (fs.existsSync(localPath)) {\n      if (!isRegularFile(localPath)) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);\n      const bytes = fs.readFileSync(localPath);\n      validateLlmsBytes(bytes);\n      return {\n        identity,\n        location: 'local',\n        filePath: localPath,\n        referenceBase: identity.packageRoot,\n        byteLength: bytes.byteLength,\n        digest: sha256Hex(bytes),\n      };\n    }\n\n    const cached = this.cache.read(identity);\n    if (cached) {\n      try {\n        validateLlmsBytes(cached.bytes);\n        return {\n          identity,\n          location: 'cache',\n          filePath: cached.filePath,\n          referenceBase: cached.referenceBase,\n          byteLength: cached.bytes.byteLength,\n          digest: cached.digest,\n        };\n      } catch {\n        this.cache.discard(identity);\n      }\n    }\n\n    const timed = timeoutSignal(signal, this.timeoutMs);\n    try {\n      const referenceBase = exactUnpkgBase(identity.source, identity.version);\n      const metadataResponse = await fetchExact(this.fetcher, `${referenceBase}?meta`, timed.signal);\n      const metadataLength = contentLength(metadataResponse);\n      if (metadataLength !== undefined && metadataLength > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      if (!metadataResponse.ok) throw new Error(`Unpkg metadata request failed with HTTP ${metadataResponse.status}.`);\n      const metadataText = await metadataResponse.text();\n      if (Buffer.byteLength(metadataText, 'utf8') > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      const metadata = parseMetadata(metadataText);\n      const indexResponse = await fetchExact(this.fetcher, `${referenceBase}${HELP_INDEX_PATH}`, timed.signal);\n      const indexLength = contentLength(indexResponse);\n      if (indexLength !== undefined && indexLength > MAX_LLMS_BYTES) {\n        throw new Error(`Downloaded ${HELP_INDEX_PATH} exceeds ${MAX_LLMS_BYTES} bytes.`);\n      }\n      if (!indexResponse.ok) throw new Error(`Unpkg llms.txt request failed with HTTP ${indexResponse.status}.`);\n      const bytes = new Uint8Array(await indexResponse.arrayBuffer());\n      validateLlmsBytes(bytes);\n      verifySri(bytes, metadata.integrity);\n      const published = this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);\n      return {\n        identity,\n        location: 'remote',\n        filePath: published.filePath,\n        referenceBase: published.referenceBase,\n        byteLength: published.bytes.byteLength,\n        digest: published.digest,\n      };\n    } finally {\n      timed.dispose();\n    }\n  }\n}\n","import type { PoHelpContribution, PoHelpService } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch } from '../../types/help';\nimport { DefaultHelpActivationService } from '../helpActivation';\nimport { DefaultHelpSkillMaterializer, defaultHelpCacheRoot, HelpIndexCache } from '../helpStorage';\nimport { DefaultHelpIndexResolver } from '../llmsResolver';\n\nexport interface HelpRuntimeOptions {\n  cacheRoot?: string;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n  onBackgroundError?(error: unknown): void;\n}\n\nexport interface HelpRuntimeComposition {\n  activation: DefaultHelpActivationService;\n  dispose(): void;\n}\n\nfunction reportAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nexport function createHelpRuntime(service: PoHelpService, options: HelpRuntimeOptions = {}): HelpRuntimeComposition {\n  const cacheRoot = options.cacheRoot ?? defaultHelpCacheRoot();\n  const cache = new HelpIndexCache(cacheRoot);\n  const activation = new DefaultHelpActivationService({\n    resolver: new DefaultHelpIndexResolver({ cache, fetch: options.fetch, timeoutMs: options.timeoutMs }),\n    materializer: new DefaultHelpSkillMaterializer(cacheRoot),\n    publisher: { publish: (snapshot) => service.publish(snapshot) },\n    onBackgroundError(error) {\n      if (options.onBackgroundError) options.onBackgroundError(error);\n      else reportAsync(error);\n    },\n  });\n  const synchronize = (contributions: readonly PoHelpContribution[]): void => {\n    activation.replaceContributions(contributions);\n  };\n  const unsubscribe = service.subscribeContributions((contributions) => synchronize(contributions));\n  synchronize(service.listContributions());\n  let disposed = false;\n  return {\n    activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      unsubscribe();\n      activation.dispose();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["PO_HELP_MAX_DIAGNOSTIC_LENGTH","PO_HELP_MAX_SKILLS","PO_HELP_MAX_DIAGNOSTICS","HELP_INDEX_PATH","isRecord","path","fsPromises","fileURLToPath","os","poHomeDirectory","createHash","randomUUID","fs","createHash","path"],"sources":["../src/services/llmsContent/index.ts","../src/services/helpActivation/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts","../src/services/helpRuntime/index.ts"],"sourcesContent":["import type { PoHelpSkillDescriptor } from '@agimon-ai/po-core/help';\n\nimport type { ResolvedHelpIndex } from '../../types/help';\n\nexport const MAX_LLMS_BYTES = 1024 * 1024;\nexport const MAX_AGGREGATE_LLMS_BYTES = 4 * MAX_LLMS_BYTES;\n\nconst MARKDOWN_LINK_PATTERN = /!?\\[[^\\]]*\\]\\(\\s*<?([^\\s)>]+)>?(?:\\s+[^)]*)?\\)/gu;\nconst MARKDOWN_REFERENCE_LINK_PATTERN = /^\\s{0,3}\\[[^\\]\\r\\n]+\\]:\\s*<?([^\\s>]+)>?/gmu;\nconst MARKDOWN_AUTOLINK_PATTERN = /<((?:\\.{0,2}\\/|[A-Za-z][A-Za-z0-9+.-]*:)[^<>\\s]+)>/gu;\nconst HTML_LINK_PATTERN = /\\b(?:href|src)\\s*=\\s*[\"']([^\"']+)[\"']/giu;\nconst URI_SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:/iu;\nconst NESTED_PATH_ENCODING_PATTERN = /%(?:25|2e|2f|3a|5c)/iu;\nconst SAFE_EXTERNAL_SCHEMES = new Set(['http:', 'https:', 'mailto:']);\n\nfunction externalScheme(target: string): string | undefined {\n  if (!URI_SCHEME_PATTERN.test(target)) return undefined;\n  return target.slice(0, target.indexOf(':') + 1).toLowerCase();\n}\n\nfunction decodeRelativeTarget(rawTarget: string): string {\n  let decoded = rawTarget;\n  try {\n    for (let pass = 0; pass < 2; pass += 1) {\n      const next = decodeURIComponent(decoded);\n      if (next === decoded) break;\n      decoded = next;\n    }\n  } catch {\n    throw new Error(`llms.txt contains an invalid encoded link '${rawTarget}'.`);\n  }\n  if (NESTED_PATH_ENCODING_PATTERN.test(decoded)) {\n    throw new Error(`llms.txt contains an unsafe nested encoding in link '${rawTarget}'.`);\n  }\n  return decoded;\n}\n\nfunction validateRelativeLink(rawTarget: string): void {\n  if (!rawTarget || rawTarget.startsWith('#')) return;\n  const rawScheme = externalScheme(rawTarget);\n  if (rawScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(rawScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${rawScheme}'.`);\n    }\n    return;\n  }\n\n  const decoded = decodeRelativeTarget(rawTarget);\n  const decodedScheme = externalScheme(decoded);\n  if (decodedScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(decodedScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${decodedScheme}'.`);\n    }\n    return;\n  }\n  const withoutSuffix = decoded.split(/[?#]/u, 1)[0]?.replaceAll('\\\\', '/') ?? '';\n  if (withoutSuffix.startsWith('/') || withoutSuffix.split('/').some((segment) => segment === '..')) {\n    throw new Error(`llms.txt link '${rawTarget}' escapes the package root.`);\n  }\n}\n\nfunction containsUnsafeControl(text: string): boolean {\n  for (const character of text) {\n    const code = character.codePointAt(0) ?? 0;\n    if ((code >= 0 && code <= 8) || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function validateLlmsBytes(bytes: Uint8Array): string {\n  if (bytes.byteLength === 0) throw new Error('llms.txt is empty.');\n  if (bytes.byteLength > MAX_LLMS_BYTES) throw new Error(`llms.txt exceeds ${MAX_LLMS_BYTES} bytes.`);\n\n  let text: string;\n  try {\n    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);\n  } catch {\n    throw new Error('llms.txt is not valid UTF-8.');\n  }\n  if (text.startsWith('\\uFEFF')) text = text.slice(1);\n  if (containsUnsafeControl(text)) throw new Error('llms.txt contains unsafe control bytes.');\n\n  const firstContentLine = text\n    .split(/\\r?\\n/u)\n    .find((line) => line.trim().length > 0)\n    ?.trim();\n  if (!firstContentLine || !/^#\\s+\\S/u.test(firstContentLine)) {\n    throw new Error('llms.txt must begin with a Markdown H1 heading.');\n  }\n  for (const pattern of [\n    MARKDOWN_LINK_PATTERN,\n    MARKDOWN_REFERENCE_LINK_PATTERN,\n    MARKDOWN_AUTOLINK_PATTERN,\n    HTML_LINK_PATTERN,\n  ]) {\n    for (const match of text.matchAll(pattern)) validateRelativeLink(match[1] ?? '');\n  }\n  return text;\n}\n\nexport function renderHelpSkillWrapper(descriptor: PoHelpSkillDescriptor, index: ResolvedHelpIndex): string {\n  const name = JSON.stringify(descriptor.name);\n  const description = JSON.stringify(descriptor.description);\n  const indexPath = JSON.stringify(index.filePath);\n  const referenceBase = JSON.stringify(index.referenceBase);\n  return `---\\nname: ${name}\\ndescription: ${description}\\n---\\n\\n# Package Help\\n\\nRead the validated package Help index at ${indexPath}.\\nResolve relative links in that index against ${referenceBase}.\\nOpen only the linked documents relevant to the current request, as needed; do not recursively load the whole reference set.\\n`;\n}\n","import {\n  PO_HELP_MAX_DIAGNOSTIC_LENGTH,\n  PO_HELP_MAX_DIAGNOSTICS,\n  PO_HELP_MAX_SKILLS,\n  type PoHelpContribution,\n  type PoHelpDiagnostic,\n  type PoHelpSkill,\n} from '@agimon-ai/po-core/help';\n\nimport type {\n  HelpActivationDependencies,\n  HelpActivationService,\n  HelpRuntimeState,\n  ResolvedHelpIndex,\n} from '../../types/help';\nimport { MAX_AGGREGATE_LLMS_BYTES } from '../llmsContent';\n\nconst MAX_RESOLUTION_CONCURRENCY = 4;\nconst FAILURE_MESSAGE = 'No package Help source could be activated.';\nconst CANCELLATION_MESSAGE = 'Help activation was cancelled.';\n\ninterface LoadedSource {\n  contribution: PoHelpContribution;\n  index: ResolvedHelpIndex;\n  skills: readonly PoHelpSkill[];\n}\n\ninterface SourceOutcome {\n  source: string;\n  loaded?: LoadedSource;\n  error?: unknown;\n}\n\nexport class HelpActivationError extends Error {\n  constructor(message = FAILURE_MESSAGE) {\n    super(message);\n    this.name = 'HelpActivationError';\n  }\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 cloneState(state: HelpRuntimeState): HelpRuntimeState {\n  return {\n    activation: state.activation,\n    skills: state.skills.map((skill) => ({ ...skill })),\n    diagnostics: state.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction diagnostic(source: string, code: string, error: unknown): PoHelpDiagnostic {\n  const raw = error instanceof Error ? error.message : String(error);\n  const message = (raw || 'Unknown Help activation failure.').slice(0, PO_HELP_MAX_DIAGNOSTIC_LENGTH);\n  return { source, code, message };\n}\n\nfunction contributionFingerprint(contributions: readonly PoHelpContribution[]): string {\n  return JSON.stringify(\n    contributions.map((contribution) => ({\n      source: contribution.source,\n      moduleUrl: contribution.moduleUrl,\n      skills: contribution.skills,\n    })),\n  );\n}\n\nexport class DefaultHelpActivationService implements HelpActivationService {\n  private readonly dependencies: HelpActivationDependencies;\n  private readonly listeners = new Set<(state: HelpRuntimeState) => void>();\n  private contributions: PoHelpContribution[] = [];\n  private fingerprint = '[]';\n  private state: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private settledState: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private generation = 0;\n  private controller: AbortController | undefined;\n  private disposed = false;\n\n  constructor(dependencies: HelpActivationDependencies) {\n    this.dependencies = dependencies;\n  }\n\n  getState(): HelpRuntimeState {\n    return cloneState(this.state);\n  }\n\n  replaceContributions(contributions: readonly PoHelpContribution[]): void {\n    if (this.disposed) return;\n    const next = contributions.map(cloneContribution).sort((left, right) => left.source.localeCompare(right.source));\n    const fingerprint = contributionFingerprint(next);\n    if (fingerprint === this.fingerprint) return;\n    const previous = new Map(this.contributions.map((entry) => [entry.source, contributionFingerprint([entry])]));\n    const retained = new Set(\n      next\n        .filter((entry) => previous.get(entry.source) === contributionFingerprint([entry]))\n        .map((entry) => entry.source),\n    );\n    // A refresh may retain unchanged owners, never withdrawn or replaced ones.\n    // Prune the rollback snapshot too, so cancellation cannot resurrect them.\n    const skills = this.settledState.skills.filter((entry) => retained.has(entry.source));\n    const diagnostics = this.settledState.diagnostics.filter((entry) => !entry.source || retained.has(entry.source));\n    this.settledState = {\n      activation: skills.length === 0 ? 'inactive' : diagnostics.length > 0 ? 'degraded' : 'active',\n      skills,\n      diagnostics,\n    };\n    this.contributions = next;\n    this.fingerprint = fingerprint;\n    if (this.state.activation !== 'inactive') {\n      void this.activate().catch((error: unknown) => {\n        // Activation failures publish a bounded settled state before rejecting.\n        // Only unexpected implementation failures need an out-of-band report.\n        if (error instanceof HelpActivationError) return;\n        this.dependencies.onBackgroundError(error);\n      });\n    }\n  }\n\n  subscribe(listener: (state: HelpRuntimeState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private publish(state: HelpRuntimeState): HelpRuntimeState {\n    this.state = cloneState(state);\n    if (state.activation !== 'activating') this.settledState = cloneState(state);\n    this.dependencies.publisher.publish(this.state);\n    for (const listener of this.listeners) listener(cloneState(this.state));\n    return this.getState();\n  }\n\n  private async loadSources(signal: AbortSignal): Promise<SourceOutcome[]> {\n    const contributions = this.contributions;\n    const outcomes: SourceOutcome[] = Array.from({ length: contributions.length });\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (cursor < contributions.length) {\n        const index = cursor;\n        cursor += 1;\n        const contribution = contributions[index];\n        if (!contribution) return;\n        if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n        try {\n          const resolved = await this.dependencies.resolver.resolve(contribution, signal);\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          const skills = await this.dependencies.materializer.materialize(contribution, resolved, signal);\n          outcomes[index] = { source: contribution.source, loaded: { contribution, index: resolved, skills } };\n        } catch (error) {\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          outcomes[index] = { source: contribution.source, error };\n        }\n      }\n    };\n    const count = Math.min(MAX_RESOLUTION_CONCURRENCY, contributions.length);\n    await Promise.all(Array.from({ length: count }, () => worker()));\n    return outcomes;\n  }\n\n  async activate(externalSignal?: AbortSignal): Promise<HelpRuntimeState> {\n    if (this.disposed) throw new HelpActivationError('Help runtime is disposed.');\n    this.controller?.abort('Help activation generation replaced.');\n    const controller = new AbortController();\n    this.controller = controller;\n    const generation = ++this.generation;\n    const abortFromExternal = () => controller.abort(externalSignal?.reason);\n    externalSignal?.addEventListener('abort', abortFromExternal, { once: true });\n    if (externalSignal?.aborted) abortFromExternal();\n\n    const settledState = cloneState(this.settledState);\n    this.publish({ activation: 'activating', skills: settledState.skills, diagnostics: settledState.diagnostics });\n    try {\n      const outcomes = await this.loadSources(controller.signal);\n      if (controller.signal.aborted || generation !== this.generation) {\n        throw new HelpActivationError(CANCELLATION_MESSAGE);\n      }\n\n      const diagnostics: PoHelpDiagnostic[] = [];\n      const loaded: LoadedSource[] = [];\n      let aggregateBytes = 0;\n      for (const outcome of outcomes) {\n        if (!outcome) continue;\n        if (outcome.error || !outcome.loaded) {\n          diagnostics.push(diagnostic(outcome.source, 'HELP_SOURCE_FAILED', outcome.error));\n          continue;\n        }\n        if (aggregateBytes + outcome.loaded.index.byteLength > MAX_AGGREGATE_LLMS_BYTES) {\n          diagnostics.push(\n            diagnostic(outcome.source, 'HELP_AGGREGATE_LIMIT', 'The aggregate llms.txt byte limit was exceeded.'),\n          );\n          continue;\n        }\n        aggregateBytes += outcome.loaded.index.byteLength;\n        loaded.push(outcome.loaded);\n      }\n\n      const skills: PoHelpSkill[] = [];\n      const names = new Set<string>();\n      for (const source of loaded) {\n        for (const skill of source.skills) {\n          if (skills.length >= PO_HELP_MAX_SKILLS) {\n            diagnostics.push(\n              diagnostic(source.contribution.source, 'HELP_SKILL_LIMIT', 'The Help skill limit was reached.'),\n            );\n            break;\n          }\n          if (names.has(skill.name)) {\n            diagnostics.push(\n              diagnostic(\n                source.contribution.source,\n                'HELP_SKILL_COLLISION',\n                `Help skill '${skill.name}' was already provided by an earlier package source.`,\n              ),\n            );\n            continue;\n          }\n          names.add(skill.name);\n          skills.push({ ...skill });\n        }\n      }\n\n      const boundedDiagnostics = diagnostics.slice(0, PO_HELP_MAX_DIAGNOSTICS);\n      if (skills.length === 0) {\n        this.publish({ activation: 'inactive', skills: [], diagnostics: boundedDiagnostics });\n        throw new HelpActivationError();\n      }\n      return this.publish({\n        activation: boundedDiagnostics.length > 0 ? 'degraded' : 'active',\n        skills,\n        diagnostics: boundedDiagnostics,\n      });\n    } catch (error) {\n      if (generation === this.generation && this.state.activation === 'activating') this.publish(settledState);\n      throw error;\n    } finally {\n      externalSignal?.removeEventListener('abort', abortFromExternal);\n      if (this.controller === controller) this.controller = undefined;\n    }\n  }\n\n  deactivate(): HelpRuntimeState {\n    this.generation += 1;\n    this.controller?.abort('Help deactivated.');\n    this.controller = undefined;\n    return this.publish({ activation: 'inactive', skills: [], diagnostics: [] });\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.deactivate();\n    this.disposed = true;\n    this.listeners.clear();\n  }\n}\n","import { createHash, randomUUID } from 'node:crypto';\nimport fsPromises from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { PoHelpContribution, PoHelpSkill } from '@agimon-ai/po-core/help';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport type { HelpPackageIdentity, HelpSkillMaterializer, ResolvedHelpIndex } from '../../types/help';\nimport { renderHelpSkillWrapper } from '../llmsContent';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst HELP_INDEX_PATH = 'llms.txt';\nconst CACHE_SCHEMA_VERSION = 1;\nconst PRIVATE_FILE_MODE = 0o600;\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst COMPLETION_FILE = '.complete';\nconst CACHE_METADATA_FILE = 'metadata.json';\nconst WRAPPER_DIRECTORY = 'wrappers';\nconst SKILL_FILE = 'SKILL.md';\nconst EXACT_SEMVER_PATTERN =\n  /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u;\nconst NPM_PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\\/)?[a-z0-9][a-z0-9._~-]*$/u;\n\ninterface CacheMetadata {\n  schemaVersion: typeof CACHE_SCHEMA_VERSION;\n  source: string;\n  version: string;\n  path: typeof HELP_INDEX_PATH;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nexport interface CachedHelpIndex {\n  bytes: Uint8Array;\n  filePath: string;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nfunction assertNotAborted(signal: AbortSignal): void {\n  if (signal.aborted) throw new Error('Help activation was cancelled.');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isContained(root: string, candidate: string): boolean {\n  const relative = path.relative(root, candidate);\n  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));\n}\n\nasync function readManifest(filePath: string): Promise<Record<string, unknown> | undefined> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(await fsPromises.readFile(filePath, 'utf8')) as unknown;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw new Error(\n      `Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!isRecord(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);\n  return parsed;\n}\n\nexport async function resolveHelpPackageIdentity(\n  moduleUrl: string,\n  expectedSource: string,\n): Promise<HelpPackageIdentity> {\n  if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) {\n    throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);\n  }\n  let modulePath: string;\n  try {\n    const url = new URL(moduleUrl);\n    if (url.protocol !== 'file:') throw new Error(`Help module URL must use file:, received ${url.protocol}`);\n    modulePath = await fsPromises.realpath(fileURLToPath(url));\n  } catch (error) {\n    throw new Error(\n      `Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!(await fsPromises.lstat(modulePath)).isFile())\n    throw new Error(`Help contributor module is not a regular file: ${modulePath}`);\n\n  let directory = path.dirname(modulePath);\n  while (true) {\n    const manifestPath = path.join(directory, PACKAGE_MANIFEST);\n    const manifest = await readManifest(manifestPath);\n    if (manifest !== undefined) {\n      const source = manifest.name;\n      const version = manifest.version;\n      if (source !== expectedSource) {\n        throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);\n      }\n      if (typeof version !== 'string' || !EXACT_SEMVER_PATTERN.test(version)) {\n        throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);\n      }\n      const packageRoot = await fsPromises.realpath(directory);\n      if (!isContained(packageRoot, modulePath))\n        throw new Error('Help contributor module escapes its resolved package root.');\n      return { source: expectedSource, version, packageRoot, modulePath };\n    }\n    const parent = path.dirname(directory);\n    if (parent === directory) break;\n    directory = parent;\n  }\n  throw new Error(`Cannot find a package manifest for Help contributor ${modulePath}.`);\n}\n\nexport function defaultHelpCacheRoot(homeDirectory = os.homedir()): string {\n  return path.join(poHomeDirectory(homeDirectory), 'llms-cache');\n}\n\nexport function sha256Hex(bytes: Uint8Array | string): string {\n  return createHash('sha256').update(bytes).digest('hex');\n}\n\nfunction parseCacheMetadata(value: unknown, identity: HelpPackageIdentity): CacheMetadata | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.schemaVersion !== CACHE_SCHEMA_VERSION ||\n    value.source !== identity.source ||\n    value.version !== identity.version ||\n    value.path !== HELP_INDEX_PATH ||\n    typeof value.integrity !== 'string' ||\n    typeof value.digest !== 'string' ||\n    typeof value.referenceBase !== 'string'\n  ) {\n    return undefined;\n  }\n  return value as unknown as CacheMetadata;\n}\n\n// Share mutation ordering across cache instances targeting the same entry.\nconst cacheMutations = new Map<string, Promise<void>>();\n\nasync function mutateCacheEntry<T>(directory: string, operation: () => Promise<T>): Promise<T> {\n  const key = path.resolve(directory);\n  const previous = cacheMutations.get(key) ?? Promise.resolve();\n  const result = previous.then(operation);\n  const settled = result.then(\n    () => {},\n    () => {},\n  );\n  cacheMutations.set(key, settled);\n  try {\n    return await result;\n  } finally {\n    if (cacheMutations.get(key) === settled) cacheMutations.delete(key);\n  }\n}\n\nasync function regularFile(filePath: string): Promise<boolean> {\n  try {\n    const metadata = await fsPromises.lstat(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nexport class HelpIndexCache {\n  readonly root: string;\n\n  constructor(root = defaultHelpCacheRoot()) {\n    this.root = root;\n  }\n\n  entryDirectory(identity: HelpPackageIdentity): string {\n    const key = sha256Hex(`${identity.source}\\0${identity.version}\\0${HELP_INDEX_PATH}`);\n    return path.join(this.root, key);\n  }\n\n  async discard(identity: HelpPackageIdentity): Promise<void> {\n    const directory = this.entryDirectory(identity);\n    await mutateCacheEntry(directory, () => fsPromises.rm(directory, { recursive: true, force: true }));\n  }\n\n  async read(identity: HelpPackageIdentity): Promise<CachedHelpIndex | undefined> {\n    const directory = this.entryDirectory(identity);\n    const completionPath = path.join(directory, COMPLETION_FILE);\n    const indexPath = path.join(directory, HELP_INDEX_PATH);\n    const metadataPath = path.join(directory, CACHE_METADATA_FILE);\n    if (!(await regularFile(completionPath)) || !(await regularFile(indexPath)) || !(await regularFile(metadataPath)))\n      return undefined;\n    try {\n      const metadata = parseCacheMetadata(\n        JSON.parse(await fsPromises.readFile(metadataPath, 'utf8')) as unknown,\n        identity,\n      );\n      if (!metadata) return undefined;\n      const bytes = await fsPromises.readFile(indexPath);\n      if (sha256Hex(bytes) !== metadata.digest) return undefined;\n      if ((await fsPromises.readFile(completionPath, 'utf8')).trim() !== metadata.digest) return undefined;\n      return {\n        bytes,\n        filePath: indexPath,\n        integrity: metadata.integrity,\n        digest: metadata.digest,\n        referenceBase: metadata.referenceBase,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  async publish(\n    identity: HelpPackageIdentity,\n    bytes: Uint8Array,\n    integrity: string,\n    referenceBase: string,\n    signal: AbortSignal,\n  ): Promise<CachedHelpIndex> {\n    const directory = this.entryDirectory(identity);\n    return mutateCacheEntry(directory, async () => {\n      assertNotAborted(signal);\n      const existing = await this.read(identity);\n      if (existing) return existing;\n      await fsPromises.mkdir(this.root, { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n      await fsPromises.rm(directory, { recursive: true, force: true });\n      const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n      const digest = sha256Hex(bytes);\n      const metadata: CacheMetadata = {\n        schemaVersion: CACHE_SCHEMA_VERSION,\n        source: identity.source,\n        version: identity.version,\n        path: HELP_INDEX_PATH,\n        integrity,\n        digest,\n        referenceBase,\n      };\n      try {\n        await fsPromises.mkdir(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n        await fsPromises.writeFile(path.join(temporary, HELP_INDEX_PATH), bytes, { mode: PRIVATE_FILE_MODE });\n        await fsPromises.writeFile(\n          path.join(temporary, CACHE_METADATA_FILE),\n          `${JSON.stringify(metadata, null, 2)}\\n`,\n          {\n            mode: PRIVATE_FILE_MODE,\n          },\n        );\n        assertNotAborted(signal);\n        await fsPromises.writeFile(path.join(temporary, COMPLETION_FILE), `${digest}\\n`, { mode: PRIVATE_FILE_MODE });\n        try {\n          await fsPromises.rename(temporary, directory);\n        } catch (error) {\n          const winner = await this.read(identity);\n          if (winner) return winner;\n          throw error;\n        }\n        return {\n          bytes: Uint8Array.from(bytes),\n          filePath: path.join(directory, HELP_INDEX_PATH),\n          integrity,\n          digest,\n          referenceBase,\n        };\n      } finally {\n        await fsPromises.rm(temporary, { recursive: true, force: true });\n      }\n    });\n  }\n}\n\nexport class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {\n  constructor(private readonly cacheRoot = defaultHelpCacheRoot()) {}\n\n  async materialize(\n    contribution: PoHelpContribution,\n    index: ResolvedHelpIndex,\n    signal: AbortSignal,\n  ): Promise<readonly PoHelpSkill[]> {\n    const skills: PoHelpSkill[] = [];\n    for (const descriptor of contribution.skills) {\n      assertNotAborted(signal);\n      const key = sha256Hex(\n        `${index.identity.source}\\0${index.identity.version}\\0${descriptor.name}\\0${descriptor.description}\\0${index.digest}`,\n      );\n      const directory = path.join(this.cacheRoot, WRAPPER_DIRECTORY, key);\n      const filePath = path.join(directory, SKILL_FILE);\n      const content = renderHelpSkillWrapper(descriptor, index);\n      const matches = async (): Promise<boolean> => {\n        try {\n          const metadata = await fsPromises.lstat(filePath);\n          return (\n            metadata.isFile() && !metadata.isSymbolicLink() && (await fsPromises.readFile(filePath, 'utf8')) === content\n          );\n        } catch {\n          return false;\n        }\n      };\n      if (!(await matches())) {\n        await fsPromises.mkdir(path.dirname(directory), { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n        await fsPromises.rm(directory, { recursive: true, force: true });\n        const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n        try {\n          await fsPromises.mkdir(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n          await fsPromises.writeFile(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });\n          assertNotAborted(signal);\n          try {\n            await fsPromises.rename(temporary, directory);\n          } catch (error) {\n            if (!(await matches())) throw error;\n          }\n        } finally {\n          await fsPromises.rm(temporary, { recursive: true, force: true });\n        }\n      }\n      skills.push({\n        source: contribution.source,\n        name: descriptor.name,\n        description: descriptor.description,\n        filePath,\n        baseDir: directory,\n      });\n    }\n    return skills;\n  }\n}\n","import { createHash } from 'node:crypto';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type { PoHelpContribution } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch, HelpFetchResponse, HelpIndexResolver, ResolvedHelpIndex } from '../../types/help';\nimport { HelpIndexCache, resolveHelpPackageIdentity, sha256Hex } from '../helpStorage';\nimport { MAX_LLMS_BYTES, validateLlmsBytes } from '../llmsContent';\n\nconst HELP_INDEX_PATH = 'llms.txt';\nconst UNPKG_ORIGIN = 'https://unpkg.com';\nconst DEFAULT_FETCH_TIMEOUT_MS = 5_000;\nconst MAX_METADATA_BYTES = 512 * 1024;\nconst MAX_REDIRECTS = 3;\nconst SRI_PATTERN = /^sha256-([A-Za-z0-9+/]+={0,2})$/u;\n\ninterface UnpkgMetadataFile {\n  path: string;\n  size?: number;\n  integrity: string;\n}\n\nexport interface DefaultHelpIndexResolverOptions {\n  cache?: HelpIndexCache;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n}\n\nfunction defaultFetch(input: string, init: { signal: AbortSignal; redirect: 'manual' }): Promise<HelpFetchResponse> {\n  return fetch(input, init) as unknown as Promise<HelpFetchResponse>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nasync function isRegularFile(filePath: string): Promise<boolean | undefined> {\n  try {\n    const metadata = await fs.lstat(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\nfunction unpkgPackagePath(source: string, version: string): string {\n  const encoded = source\n    .split('/')\n    .map((segment) =>\n      segment.startsWith('@') ? `@${encodeURIComponent(segment.slice(1))}` : encodeURIComponent(segment),\n    )\n    .join('/');\n  return `${encoded}@${encodeURIComponent(version)}`;\n}\n\nfunction exactUnpkgBase(source: string, version: string): string {\n  return `${UNPKG_ORIGIN}/${unpkgPackagePath(source, version)}/`;\n}\n\nfunction contentLength(response: HelpFetchResponse): number | undefined {\n  const raw = response.headers.get('content-length');\n  if (!raw) return undefined;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;\n}\n\nfunction timeoutSignal(parent: AbortSignal, timeoutMs: number): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abort = () => controller.abort(parent.reason);\n  parent.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(() => controller.abort(new Error('Help download timed out.')), timeoutMs);\n  if (parent.aborted) abort();\n  return {\n    signal: controller.signal,\n    dispose() {\n      clearTimeout(timer);\n      parent.removeEventListener('abort', abort);\n    },\n  };\n}\n\nasync function fetchExact(fetcher: HelpFetch, initialUrl: string, signal: AbortSignal): Promise<HelpFetchResponse> {\n  let url = initialUrl;\n  const expected = new URL(initialUrl);\n  for (let redirect = 0; redirect <= MAX_REDIRECTS; redirect += 1) {\n    const response = await fetcher(url, { signal, redirect: 'manual' });\n    if (response.status < 300 || response.status >= 400) return response;\n    const location = response.headers.get('location');\n    if (!location) throw new Error(`Unpkg redirected ${url} without a location.`);\n    const next = new URL(location, url);\n    if (next.origin !== UNPKG_ORIGIN || next.pathname !== expected.pathname || next.search !== expected.search) {\n      throw new Error(`Unpkg redirect escaped the exact package/version path: ${next.href}`);\n    }\n    url = next.href;\n  }\n  throw new Error(`Unpkg exceeded ${MAX_REDIRECTS} redirects.`);\n}\n\nfunction parseMetadata(text: string): UnpkgMetadataFile {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text) as unknown;\n  } catch {\n    throw new Error('Unpkg metadata is not valid JSON.');\n  }\n  if (!isRecord(parsed) || !Array.isArray(parsed.files)) throw new Error('Unpkg metadata has no files list.');\n  const match = parsed.files.find((entry) => isRecord(entry) && entry.path === `/${HELP_INDEX_PATH}`);\n  if (!isRecord(match) || typeof match.integrity !== 'string') {\n    throw new Error(`Unpkg package does not publish /${HELP_INDEX_PATH}.`);\n  }\n  const size = typeof match.size === 'number' ? match.size : undefined;\n  if (size !== undefined && (!Number.isSafeInteger(size) || size < 0 || size > MAX_LLMS_BYTES)) {\n    throw new Error(`Unpkg /${HELP_INDEX_PATH} exceeds the Help size limit.`);\n  }\n  if (!SRI_PATTERN.test(match.integrity)) throw new Error('Unpkg llms.txt metadata does not contain SHA-256 SRI.');\n  return { path: match.path as string, ...(size === undefined ? {} : { size }), integrity: match.integrity };\n}\n\nfunction verifySri(bytes: Uint8Array, integrity: string): void {\n  const expected = SRI_PATTERN.exec(integrity)?.[1];\n  if (!expected) throw new Error('Invalid llms.txt SRI metadata.');\n  const actual = createHash('sha256').update(bytes).digest('base64');\n  if (actual !== expected) throw new Error('Downloaded llms.txt failed SRI verification.');\n}\n\nexport class DefaultHelpIndexResolver implements HelpIndexResolver {\n  private readonly cache: HelpIndexCache;\n  private readonly fetcher: HelpFetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: DefaultHelpIndexResolverOptions = {}) {\n    this.cache = options.cache ?? new HelpIndexCache();\n    this.fetcher = options.fetch ?? defaultFetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n  }\n\n  async resolve(contribution: PoHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex> {\n    if (signal.aborted) throw new Error('Help activation was cancelled.');\n    const identity = await resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);\n    const localPath = path.join(identity.packageRoot, HELP_INDEX_PATH);\n    const regular = await isRegularFile(localPath);\n    if (regular !== undefined) {\n      if (!regular) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);\n      const bytes = await fs.readFile(localPath);\n      validateLlmsBytes(bytes);\n      return {\n        identity,\n        location: 'local',\n        filePath: localPath,\n        referenceBase: identity.packageRoot,\n        byteLength: bytes.byteLength,\n        digest: sha256Hex(bytes),\n      };\n    }\n\n    const cached = await this.cache.read(identity);\n    if (cached) {\n      try {\n        validateLlmsBytes(cached.bytes);\n        return {\n          identity,\n          location: 'cache',\n          filePath: cached.filePath,\n          referenceBase: cached.referenceBase,\n          byteLength: cached.bytes.byteLength,\n          digest: cached.digest,\n        };\n      } catch {\n        await this.cache.discard(identity);\n      }\n    }\n\n    const timed = timeoutSignal(signal, this.timeoutMs);\n    try {\n      const referenceBase = exactUnpkgBase(identity.source, identity.version);\n      const metadataResponse = await fetchExact(this.fetcher, `${referenceBase}?meta`, timed.signal);\n      const metadataLength = contentLength(metadataResponse);\n      if (metadataLength !== undefined && metadataLength > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      if (!metadataResponse.ok) throw new Error(`Unpkg metadata request failed with HTTP ${metadataResponse.status}.`);\n      const metadataText = await metadataResponse.text();\n      if (Buffer.byteLength(metadataText, 'utf8') > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      const metadata = parseMetadata(metadataText);\n      const indexResponse = await fetchExact(this.fetcher, `${referenceBase}${HELP_INDEX_PATH}`, timed.signal);\n      const indexLength = contentLength(indexResponse);\n      if (indexLength !== undefined && indexLength > MAX_LLMS_BYTES) {\n        throw new Error(`Downloaded ${HELP_INDEX_PATH} exceeds ${MAX_LLMS_BYTES} bytes.`);\n      }\n      if (!indexResponse.ok) throw new Error(`Unpkg llms.txt request failed with HTTP ${indexResponse.status}.`);\n      const bytes = new Uint8Array(await indexResponse.arrayBuffer());\n      validateLlmsBytes(bytes);\n      verifySri(bytes, metadata.integrity);\n      const published = await this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);\n      return {\n        identity,\n        location: 'remote',\n        filePath: published.filePath,\n        referenceBase: published.referenceBase,\n        byteLength: published.bytes.byteLength,\n        digest: published.digest,\n      };\n    } finally {\n      timed.dispose();\n    }\n  }\n}\n","import type { PoHelpContribution, PoHelpService } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch } from '../../types/help';\nimport { DefaultHelpActivationService } from '../helpActivation';\nimport { DefaultHelpSkillMaterializer, defaultHelpCacheRoot, HelpIndexCache } from '../helpStorage';\nimport { DefaultHelpIndexResolver } from '../llmsResolver';\n\nexport interface HelpRuntimeOptions {\n  cacheRoot?: string;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n  onBackgroundError?(error: unknown): void;\n}\n\nexport interface HelpRuntimeComposition {\n  activation: DefaultHelpActivationService;\n  dispose(): void;\n}\n\nfunction reportAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nexport function createHelpRuntime(service: PoHelpService, options: HelpRuntimeOptions = {}): HelpRuntimeComposition {\n  const cacheRoot = options.cacheRoot ?? defaultHelpCacheRoot();\n  const cache = new HelpIndexCache(cacheRoot);\n  const activation = new DefaultHelpActivationService({\n    resolver: new DefaultHelpIndexResolver({ cache, fetch: options.fetch, timeoutMs: options.timeoutMs }),\n    materializer: new DefaultHelpSkillMaterializer(cacheRoot),\n    publisher: { publish: (snapshot) => service.publish(snapshot) },\n    onBackgroundError(error) {\n      if (options.onBackgroundError) options.onBackgroundError(error);\n      else reportAsync(error);\n    },\n  });\n  const synchronize = (contributions: readonly PoHelpContribution[]): void => {\n    activation.replaceContributions(contributions);\n  };\n  const unsubscribe = service.subscribeContributions((contributions) => synchronize(contributions));\n  synchronize(service.listContributions());\n  let disposed = false;\n  return {\n    activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      unsubscribe();\n      activation.dispose();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -105,9 +105,9 @@ export declare class HelpIndexCache {
   readonly root: string;
   constructor(root?: string);
   entryDirectory(identity: HelpPackageIdentity): string;
-  discard(identity: HelpPackageIdentity): void;
-  read(identity: HelpPackageIdentity): CachedHelpIndex | undefined;
-  publish(identity: HelpPackageIdentity, bytes: Uint8Array, integrity: string, referenceBase: string, signal: AbortSignal): CachedHelpIndex;
+  discard(identity: HelpPackageIdentity): Promise<void>;
+  read(identity: HelpPackageIdentity): Promise<CachedHelpIndex | undefined>;
+  publish(identity: HelpPackageIdentity, bytes: Uint8Array, integrity: string, referenceBase: string, signal: AbortSignal): Promise<CachedHelpIndex>;
 }
 export declare class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {
   private readonly cacheRoot;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/help.ts","../src/services/helpActivation/index.ts","../src/services/helpRuntime/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts"],"mappings":";;UAEiB;EACf;EACA;EACA;EACA;;KAGU;UAEK;EACf,UAAU;EACV,UAAU;EACV;EACA;EACA;EACA;;UAGe;EACf,QAAQ,cAAc,oBAAoB,QAAQ,cAAc,QAAQ;;UAGzD;EACf,YACE,cAAc,oBACd,OAAO,mBACP,QAAQ,cACP,iBAAiB;;UAGL;EACf,YAAY;EACZ,iBAAiB;EACjB,sBAAsB;;UAGP;EACf,QAAQ,UAAU;;UAGH;EACf,UAAU;EACV,cAAc;EACd,WAAW;EACX,kBAAkB;;UAGH;EACf,YAAY;EACZ,qBAAqB,wBAAwB;EAC7C,UAAU,WAAW,OAAO;EAC5B,SAAS,SAAS,cAAc,QAAQ;EACxC,cAAc;EACd;;UAGe;EACf;EACA;EACA;IAAW,IAAI;;EACf,QAAQ;EACR,eAAe,QAAQ;;KAGb,aACV,eACA;EAAQ,QAAQ;EAAa;MAC1B,QAAQ;;;qBCGA,wCAAwC;mBAClC;mBACA;UACT;UACA;UACA;UACA;UACA;UACA;UACA;EAER,YAAY,cAAc;EAI1B,YAAY;EAIZ,qBAAqB,wBAAwB;EAgC7C,UAAU,WAAW,OAAO;UAKpB;UAQM;EA2BR,SAAS,iBAAiB,cAAc,QAAQ;EAiFtD,cAAc;EAOd;;;;UCpPe;EACf;EACA,QAAQ;EACR;EACA,mBAAmB;;UAGJ;EACf,YAAY;EACZ;;wBASc,kBAAkB,SAAS,eAAe,UAAS,qBAA0B;;;UCU5E;EACf,OAAO;EACP;EACA;EACA;EACA;;wBAuEc,qBAAqB;qBAiCxB;WACF;EAET,YAAY;EAIZ,eAAe,UAAU;EAKzB,QAAQ,UAAU;EAIlB,KAAK,UAAU,sBAAsB;EAwBrC,QACE,UAAU,qBACV,OAAO,YACP,mBACA,uBACA,QAAQ,cACP;;qBA8CQ,wCAAwC;mBACtB;EAA7B,YAA6B;EAEvB,YACJ,cAAc,oBACd,OAAO,mBACP,QAAQ,cACP,iBAAiB;;;;UC5NL;EACf,QAAQ;EACR,QAAQ;EACR;;qBAoGW,oCAAoC;mBAC9B;mBACA;mBACA;EAEjB,YAAY,UAAS;EAMf,QAAQ,cAAc,oBAAoB,QAAQ,cAAc,QAAQ"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/help.ts","../src/services/helpActivation/index.ts","../src/services/helpRuntime/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts"],"mappings":";;UAEiB;EACf;EACA;EACA;EACA;;KAGU;UAEK;EACf,UAAU;EACV,UAAU;EACV;EACA;EACA;EACA;;UAGe;EACf,QAAQ,cAAc,oBAAoB,QAAQ,cAAc,QAAQ;;UAGzD;EACf,YACE,cAAc,oBACd,OAAO,mBACP,QAAQ,cACP,iBAAiB;;UAGL;EACf,YAAY;EACZ,iBAAiB;EACjB,sBAAsB;;UAGP;EACf,QAAQ,UAAU;;UAGH;EACf,UAAU;EACV,cAAc;EACd,WAAW;EACX,kBAAkB;;UAGH;EACf,YAAY;EACZ,qBAAqB,wBAAwB;EAC7C,UAAU,WAAW,OAAO;EAC5B,SAAS,SAAS,cAAc,QAAQ;EACxC,cAAc;EACd;;UAGe;EACf;EACA;EACA;IAAW,IAAI;;EACf,QAAQ;EACR,eAAe,QAAQ;;KAGb,aACV,eACA;EAAQ,QAAQ;EAAa;MAC1B,QAAQ;;;qBCGA,wCAAwC;mBAClC;mBACA;UACT;UACA;UACA;UACA;UACA;UACA;UACA;EAER,YAAY,cAAc;EAI1B,YAAY;EAIZ,qBAAqB,wBAAwB;EAgC7C,UAAU,WAAW,OAAO;UAKpB;UAQM;EA2BR,SAAS,iBAAiB,cAAc,QAAQ;EAiFtD,cAAc;EAOd;;;;UCpPe;EACf;EACA,QAAQ;EACR;EACA,mBAAmB;;UAGJ;EACf,YAAY;EACZ;;wBASc,kBAAkB,SAAS,eAAe,UAAS,qBAA0B;;;UCU5E;EACf,OAAO;EACP;EACA;EACA;EACA;;wBA2Ec,qBAAqB;qBAoDxB;WACF;EAET,YAAY;EAIZ,eAAe,UAAU;EAKnB,QAAQ,UAAU,sBAAsB;EAKxC,KAAK,UAAU,sBAAsB,QAAQ;EA4B7C,QACJ,UAAU,qBACV,OAAO,YACP,mBACA,uBACA,QAAQ,cACP,QAAQ;;qBAoDA,wCAAwC;mBACtB;EAA7B,YAA6B;EAEvB,YACJ,cAAc,oBACd,OAAO,mBACP,QAAQ,cACP,iBAAiB;;;;UC9PL;EACf,QAAQ;EACR,QAAQ;EACR;;qBAqGW,oCAAoC;mBAC9B;mBACA;mBACA;EAEjB,YAAY,UAAS;EAMf,QAAQ,cAAc,oBAAoB,QAAQ,cAAc,QAAQ"}

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { PO_HELP_MAX_DIAGNOSTICS, PO_HELP_MAX_DIAGNOSTIC_LENGTH, PO_HELP_MAX_SKILLS } from "@agimon-ai/po-core/help";
 import { createHash, randomUUID } from "node:crypto";
-import fs from "node:fs";
+import fsPromises from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -324,37 +324,37 @@ function isContained(root, candidate) {
 	const relative = path.relative(root, candidate);
 	return relative === "" || !relative.startsWith(`..${path.sep}`) && relative !== ".." && !path.isAbsolute(relative);
 }
-function readManifest(filePath) {
+async function readManifest(filePath) {
 	let parsed;
 	try {
-		parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
+		parsed = JSON.parse(await fsPromises.readFile(filePath, "utf8"));
 	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
 		throw new Error(`Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
 	}
 	if (!isRecord$1(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);
 	return parsed;
 }
-function resolveHelpPackageIdentity(moduleUrl, expectedSource) {
+async function resolveHelpPackageIdentity(moduleUrl, expectedSource) {
 	if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);
 	let modulePath;
 	try {
 		const url = new URL(moduleUrl);
 		if (url.protocol !== "file:") throw new Error(`Help module URL must use file:, received ${url.protocol}`);
-		modulePath = fs.realpathSync(fileURLToPath(url));
+		modulePath = await fsPromises.realpath(fileURLToPath(url));
 	} catch (error) {
 		throw new Error(`Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`);
 	}
-	if (!fs.lstatSync(modulePath).isFile()) throw new Error(`Help contributor module is not a regular file: ${modulePath}`);
+	if (!(await fsPromises.lstat(modulePath)).isFile()) throw new Error(`Help contributor module is not a regular file: ${modulePath}`);
 	let directory = path.dirname(modulePath);
 	while (true) {
-		const manifestPath = path.join(directory, PACKAGE_MANIFEST);
-		if (fs.existsSync(manifestPath)) {
-			const manifest = readManifest(manifestPath);
+		const manifest = await readManifest(path.join(directory, PACKAGE_MANIFEST));
+		if (manifest !== void 0) {
 			const source = manifest.name;
 			const version = manifest.version;
 			if (source !== expectedSource) throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);
 			if (typeof version !== "string" || !EXACT_SEMVER_PATTERN.test(version)) throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);
-			const packageRoot = fs.realpathSync(directory);
+			const packageRoot = await fsPromises.realpath(directory);
 			if (!isContained(packageRoot, modulePath)) throw new Error("Help contributor module escapes its resolved package root.");
 			return {
 				source: expectedSource,
@@ -380,9 +380,21 @@ function parseCacheMetadata(value, identity) {
 	if (value.schemaVersion !== CACHE_SCHEMA_VERSION || value.source !== identity.source || value.version !== identity.version || value.path !== HELP_INDEX_PATH$1 || typeof value.integrity !== "string" || typeof value.digest !== "string" || typeof value.referenceBase !== "string") return;
 	return value;
 }
-function regularFile(filePath) {
+const cacheMutations = /* @__PURE__ */ new Map();
+async function mutateCacheEntry(directory, operation) {
+	const key = path.resolve(directory);
+	const result = (cacheMutations.get(key) ?? Promise.resolve()).then(operation);
+	const settled = result.then(() => {}, () => {});
+	cacheMutations.set(key, settled);
 	try {
-		const metadata = fs.lstatSync(filePath);
+		return await result;
+	} finally {
+		if (cacheMutations.get(key) === settled) cacheMutations.delete(key);
+	}
+}
+async function regularFile(filePath) {
+	try {
+		const metadata = await fsPromises.lstat(filePath);
 		return metadata.isFile() && !metadata.isSymbolicLink();
 	} catch {
 		return false;
@@ -397,24 +409,25 @@ var HelpIndexCache = class {
 		const key = sha256Hex(`${identity.source}\0${identity.version}\0${HELP_INDEX_PATH$1}`);
 		return path.join(this.root, key);
 	}
-	discard(identity) {
-		fs.rmSync(this.entryDirectory(identity), {
+	async discard(identity) {
+		const directory = this.entryDirectory(identity);
+		await mutateCacheEntry(directory, () => fsPromises.rm(directory, {
 			recursive: true,
 			force: true
-		});
+		}));
 	}
-	read(identity) {
+	async read(identity) {
 		const directory = this.entryDirectory(identity);
 		const completionPath = path.join(directory, COMPLETION_FILE);
 		const indexPath = path.join(directory, HELP_INDEX_PATH$1);
 		const metadataPath = path.join(directory, CACHE_METADATA_FILE);
-		if (!regularFile(completionPath) || !regularFile(indexPath) || !regularFile(metadataPath)) return void 0;
+		if (!await regularFile(completionPath) || !await regularFile(indexPath) || !await regularFile(metadataPath)) return void 0;
 		try {
-			const metadata = parseCacheMetadata(JSON.parse(fs.readFileSync(metadataPath, "utf8")), identity);
+			const metadata = parseCacheMetadata(JSON.parse(await fsPromises.readFile(metadataPath, "utf8")), identity);
 			if (!metadata) return void 0;
-			const bytes = fs.readFileSync(indexPath);
+			const bytes = await fsPromises.readFile(indexPath);
 			if (sha256Hex(bytes) !== metadata.digest) return void 0;
-			if (fs.readFileSync(completionPath, "utf8").trim() !== metadata.digest) return void 0;
+			if ((await fsPromises.readFile(completionPath, "utf8")).trim() !== metadata.digest) return void 0;
 			return {
 				bytes,
 				filePath: indexPath,
@@ -426,56 +439,58 @@ var HelpIndexCache = class {
 			return;
 		}
 	}
-	publish(identity, bytes, integrity, referenceBase, signal) {
-		assertNotAborted(signal);
-		const existing = this.read(identity);
-		if (existing) return existing;
+	async publish(identity, bytes, integrity, referenceBase, signal) {
 		const directory = this.entryDirectory(identity);
-		fs.mkdirSync(this.root, {
-			mode: PRIVATE_DIRECTORY_MODE,
-			recursive: true
-		});
-		if (fs.existsSync(directory)) fs.rmSync(directory, {
-			recursive: true,
-			force: true
-		});
-		const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;
-		const digest = sha256Hex(bytes);
-		const metadata = {
-			schemaVersion: CACHE_SCHEMA_VERSION,
-			source: identity.source,
-			version: identity.version,
-			path: HELP_INDEX_PATH$1,
-			integrity,
-			digest,
-			referenceBase
-		};
-		try {
-			fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });
-			fs.writeFileSync(path.join(temporary, HELP_INDEX_PATH$1), bytes, { mode: PRIVATE_FILE_MODE });
-			fs.writeFileSync(path.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\n`, { mode: PRIVATE_FILE_MODE });
+		return mutateCacheEntry(directory, async () => {
 			assertNotAborted(signal);
-			fs.writeFileSync(path.join(temporary, COMPLETION_FILE), `${digest}\n`, { mode: PRIVATE_FILE_MODE });
-			try {
-				fs.renameSync(temporary, directory);
-			} catch (error) {
-				const winner = this.read(identity);
-				if (winner) return winner;
-				throw error;
-			}
-			return {
-				bytes: Uint8Array.from(bytes),
-				filePath: path.join(directory, HELP_INDEX_PATH$1),
+			const existing = await this.read(identity);
+			if (existing) return existing;
+			await fsPromises.mkdir(this.root, {
+				mode: PRIVATE_DIRECTORY_MODE,
+				recursive: true
+			});
+			await fsPromises.rm(directory, {
+				recursive: true,
+				force: true
+			});
+			const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;
+			const digest = sha256Hex(bytes);
+			const metadata = {
+				schemaVersion: CACHE_SCHEMA_VERSION,
+				source: identity.source,
+				version: identity.version,
+				path: HELP_INDEX_PATH$1,
 				integrity,
 				digest,
 				referenceBase
 			};
-		} finally {
-			fs.rmSync(temporary, {
-				recursive: true,
-				force: true
-			});
-		}
+			try {
+				await fsPromises.mkdir(temporary, { mode: PRIVATE_DIRECTORY_MODE });
+				await fsPromises.writeFile(path.join(temporary, HELP_INDEX_PATH$1), bytes, { mode: PRIVATE_FILE_MODE });
+				await fsPromises.writeFile(path.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\n`, { mode: PRIVATE_FILE_MODE });
+				assertNotAborted(signal);
+				await fsPromises.writeFile(path.join(temporary, COMPLETION_FILE), `${digest}\n`, { mode: PRIVATE_FILE_MODE });
+				try {
+					await fsPromises.rename(temporary, directory);
+				} catch (error) {
+					const winner = await this.read(identity);
+					if (winner) return winner;
+					throw error;
+				}
+				return {
+					bytes: Uint8Array.from(bytes),
+					filePath: path.join(directory, HELP_INDEX_PATH$1),
+					integrity,
+					digest,
+					referenceBase
+				};
+			} finally {
+				await fsPromises.rm(temporary, {
+					recursive: true,
+					force: true
+				});
+			}
+		});
 	}
 };
 var DefaultHelpSkillMaterializer = class {
@@ -491,27 +506,35 @@ var DefaultHelpSkillMaterializer = class {
 			const directory = path.join(this.cacheRoot, WRAPPER_DIRECTORY, key);
 			const filePath = path.join(directory, SKILL_FILE);
 			const content = renderHelpSkillWrapper(descriptor, index);
-			if (!regularFile(filePath) || fs.readFileSync(filePath, "utf8") !== content) {
-				fs.mkdirSync(path.dirname(directory), {
+			const matches = async () => {
+				try {
+					const metadata = await fsPromises.lstat(filePath);
+					return metadata.isFile() && !metadata.isSymbolicLink() && await fsPromises.readFile(filePath, "utf8") === content;
+				} catch {
+					return false;
+				}
+			};
+			if (!await matches()) {
+				await fsPromises.mkdir(path.dirname(directory), {
 					mode: PRIVATE_DIRECTORY_MODE,
 					recursive: true
 				});
-				if (fs.existsSync(directory)) fs.rmSync(directory, {
+				await fsPromises.rm(directory, {
 					recursive: true,
 					force: true
 				});
 				const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;
 				try {
-					fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });
-					fs.writeFileSync(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });
+					await fsPromises.mkdir(temporary, { mode: PRIVATE_DIRECTORY_MODE });
+					await fsPromises.writeFile(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });
 					assertNotAborted(signal);
 					try {
-						fs.renameSync(temporary, directory);
+						await fsPromises.rename(temporary, directory);
 					} catch (error) {
-						if (!regularFile(filePath) || fs.readFileSync(filePath, "utf8") !== content) throw error;
+						if (!await matches()) throw error;
 					}
 				} finally {
-					fs.rmSync(temporary, {
+					await fsPromises.rm(temporary, {
 						recursive: true,
 						force: true
 					});
@@ -542,12 +565,13 @@ function defaultFetch(input, init) {
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function isRegularFile(filePath) {
+async function isRegularFile(filePath) {
 	try {
-		const metadata = fs.lstatSync(filePath);
+		const metadata = await fsPromises.lstat(filePath);
 		return metadata.isFile() && !metadata.isSymbolicLink();
-	} catch {
-		return false;
+	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
+		throw error;
 	}
 }
 function unpkgPackagePath(source, version) {
@@ -628,11 +652,12 @@ var DefaultHelpIndexResolver = class {
 	}
 	async resolve(contribution, signal) {
 		if (signal.aborted) throw new Error("Help activation was cancelled.");
-		const identity = resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);
+		const identity = await resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);
 		const localPath = path.join(identity.packageRoot, HELP_INDEX_PATH);
-		if (fs.existsSync(localPath)) {
-			if (!isRegularFile(localPath)) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);
-			const bytes = fs.readFileSync(localPath);
+		const regular = await isRegularFile(localPath);
+		if (regular !== void 0) {
+			if (!regular) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);
+			const bytes = await fsPromises.readFile(localPath);
 			validateLlmsBytes(bytes);
 			return {
 				identity,
@@ -643,7 +668,7 @@ var DefaultHelpIndexResolver = class {
 				digest: sha256Hex(bytes)
 			};
 		}
-		const cached = this.cache.read(identity);
+		const cached = await this.cache.read(identity);
 		if (cached) try {
 			validateLlmsBytes(cached.bytes);
 			return {
@@ -655,7 +680,7 @@ var DefaultHelpIndexResolver = class {
 				digest: cached.digest
 			};
 		} catch {
-			this.cache.discard(identity);
+			await this.cache.discard(identity);
 		}
 		const timed = timeoutSignal(signal, this.timeoutMs);
 		try {
@@ -674,7 +699,7 @@ var DefaultHelpIndexResolver = class {
 			const bytes = new Uint8Array(await indexResponse.arrayBuffer());
 			validateLlmsBytes(bytes);
 			verifySri(bytes, metadata.integrity);
-			const published = this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);
+			const published = await this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);
 			return {
 				identity,
 				location: "remote",

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["HELP_INDEX_PATH","isRecord"],"sources":["../src/services/llmsContent/index.ts","../src/services/helpActivation/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts","../src/services/helpRuntime/index.ts"],"sourcesContent":["import type { PoHelpSkillDescriptor } from '@agimon-ai/po-core/help';\n\nimport type { ResolvedHelpIndex } from '../../types/help';\n\nexport const MAX_LLMS_BYTES = 1024 * 1024;\nexport const MAX_AGGREGATE_LLMS_BYTES = 4 * MAX_LLMS_BYTES;\n\nconst MARKDOWN_LINK_PATTERN = /!?\\[[^\\]]*\\]\\(\\s*<?([^\\s)>]+)>?(?:\\s+[^)]*)?\\)/gu;\nconst MARKDOWN_REFERENCE_LINK_PATTERN = /^\\s{0,3}\\[[^\\]\\r\\n]+\\]:\\s*<?([^\\s>]+)>?/gmu;\nconst MARKDOWN_AUTOLINK_PATTERN = /<((?:\\.{0,2}\\/|[A-Za-z][A-Za-z0-9+.-]*:)[^<>\\s]+)>/gu;\nconst HTML_LINK_PATTERN = /\\b(?:href|src)\\s*=\\s*[\"']([^\"']+)[\"']/giu;\nconst URI_SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:/iu;\nconst NESTED_PATH_ENCODING_PATTERN = /%(?:25|2e|2f|3a|5c)/iu;\nconst SAFE_EXTERNAL_SCHEMES = new Set(['http:', 'https:', 'mailto:']);\n\nfunction externalScheme(target: string): string | undefined {\n  if (!URI_SCHEME_PATTERN.test(target)) return undefined;\n  return target.slice(0, target.indexOf(':') + 1).toLowerCase();\n}\n\nfunction decodeRelativeTarget(rawTarget: string): string {\n  let decoded = rawTarget;\n  try {\n    for (let pass = 0; pass < 2; pass += 1) {\n      const next = decodeURIComponent(decoded);\n      if (next === decoded) break;\n      decoded = next;\n    }\n  } catch {\n    throw new Error(`llms.txt contains an invalid encoded link '${rawTarget}'.`);\n  }\n  if (NESTED_PATH_ENCODING_PATTERN.test(decoded)) {\n    throw new Error(`llms.txt contains an unsafe nested encoding in link '${rawTarget}'.`);\n  }\n  return decoded;\n}\n\nfunction validateRelativeLink(rawTarget: string): void {\n  if (!rawTarget || rawTarget.startsWith('#')) return;\n  const rawScheme = externalScheme(rawTarget);\n  if (rawScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(rawScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${rawScheme}'.`);\n    }\n    return;\n  }\n\n  const decoded = decodeRelativeTarget(rawTarget);\n  const decodedScheme = externalScheme(decoded);\n  if (decodedScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(decodedScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${decodedScheme}'.`);\n    }\n    return;\n  }\n  const withoutSuffix = decoded.split(/[?#]/u, 1)[0]?.replaceAll('\\\\', '/') ?? '';\n  if (withoutSuffix.startsWith('/') || withoutSuffix.split('/').some((segment) => segment === '..')) {\n    throw new Error(`llms.txt link '${rawTarget}' escapes the package root.`);\n  }\n}\n\nfunction containsUnsafeControl(text: string): boolean {\n  for (const character of text) {\n    const code = character.codePointAt(0) ?? 0;\n    if ((code >= 0 && code <= 8) || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function validateLlmsBytes(bytes: Uint8Array): string {\n  if (bytes.byteLength === 0) throw new Error('llms.txt is empty.');\n  if (bytes.byteLength > MAX_LLMS_BYTES) throw new Error(`llms.txt exceeds ${MAX_LLMS_BYTES} bytes.`);\n\n  let text: string;\n  try {\n    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);\n  } catch {\n    throw new Error('llms.txt is not valid UTF-8.');\n  }\n  if (text.startsWith('\\uFEFF')) text = text.slice(1);\n  if (containsUnsafeControl(text)) throw new Error('llms.txt contains unsafe control bytes.');\n\n  const firstContentLine = text\n    .split(/\\r?\\n/u)\n    .find((line) => line.trim().length > 0)\n    ?.trim();\n  if (!firstContentLine || !/^#\\s+\\S/u.test(firstContentLine)) {\n    throw new Error('llms.txt must begin with a Markdown H1 heading.');\n  }\n  for (const pattern of [\n    MARKDOWN_LINK_PATTERN,\n    MARKDOWN_REFERENCE_LINK_PATTERN,\n    MARKDOWN_AUTOLINK_PATTERN,\n    HTML_LINK_PATTERN,\n  ]) {\n    for (const match of text.matchAll(pattern)) validateRelativeLink(match[1] ?? '');\n  }\n  return text;\n}\n\nexport function renderHelpSkillWrapper(descriptor: PoHelpSkillDescriptor, index: ResolvedHelpIndex): string {\n  const name = JSON.stringify(descriptor.name);\n  const description = JSON.stringify(descriptor.description);\n  const indexPath = JSON.stringify(index.filePath);\n  const referenceBase = JSON.stringify(index.referenceBase);\n  return `---\\nname: ${name}\\ndescription: ${description}\\n---\\n\\n# Package Help\\n\\nRead the validated package Help index at ${indexPath}.\\nResolve relative links in that index against ${referenceBase}.\\nOpen only the linked documents relevant to the current request, as needed; do not recursively load the whole reference set.\\n`;\n}\n","import {\n  PO_HELP_MAX_DIAGNOSTIC_LENGTH,\n  PO_HELP_MAX_DIAGNOSTICS,\n  PO_HELP_MAX_SKILLS,\n  type PoHelpContribution,\n  type PoHelpDiagnostic,\n  type PoHelpSkill,\n} from '@agimon-ai/po-core/help';\n\nimport type {\n  HelpActivationDependencies,\n  HelpActivationService,\n  HelpRuntimeState,\n  ResolvedHelpIndex,\n} from '../../types/help';\nimport { MAX_AGGREGATE_LLMS_BYTES } from '../llmsContent';\n\nconst MAX_RESOLUTION_CONCURRENCY = 4;\nconst FAILURE_MESSAGE = 'No package Help source could be activated.';\nconst CANCELLATION_MESSAGE = 'Help activation was cancelled.';\n\ninterface LoadedSource {\n  contribution: PoHelpContribution;\n  index: ResolvedHelpIndex;\n  skills: readonly PoHelpSkill[];\n}\n\ninterface SourceOutcome {\n  source: string;\n  loaded?: LoadedSource;\n  error?: unknown;\n}\n\nexport class HelpActivationError extends Error {\n  constructor(message = FAILURE_MESSAGE) {\n    super(message);\n    this.name = 'HelpActivationError';\n  }\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 cloneState(state: HelpRuntimeState): HelpRuntimeState {\n  return {\n    activation: state.activation,\n    skills: state.skills.map((skill) => ({ ...skill })),\n    diagnostics: state.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction diagnostic(source: string, code: string, error: unknown): PoHelpDiagnostic {\n  const raw = error instanceof Error ? error.message : String(error);\n  const message = (raw || 'Unknown Help activation failure.').slice(0, PO_HELP_MAX_DIAGNOSTIC_LENGTH);\n  return { source, code, message };\n}\n\nfunction contributionFingerprint(contributions: readonly PoHelpContribution[]): string {\n  return JSON.stringify(\n    contributions.map((contribution) => ({\n      source: contribution.source,\n      moduleUrl: contribution.moduleUrl,\n      skills: contribution.skills,\n    })),\n  );\n}\n\nexport class DefaultHelpActivationService implements HelpActivationService {\n  private readonly dependencies: HelpActivationDependencies;\n  private readonly listeners = new Set<(state: HelpRuntimeState) => void>();\n  private contributions: PoHelpContribution[] = [];\n  private fingerprint = '[]';\n  private state: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private settledState: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private generation = 0;\n  private controller: AbortController | undefined;\n  private disposed = false;\n\n  constructor(dependencies: HelpActivationDependencies) {\n    this.dependencies = dependencies;\n  }\n\n  getState(): HelpRuntimeState {\n    return cloneState(this.state);\n  }\n\n  replaceContributions(contributions: readonly PoHelpContribution[]): void {\n    if (this.disposed) return;\n    const next = contributions.map(cloneContribution).sort((left, right) => left.source.localeCompare(right.source));\n    const fingerprint = contributionFingerprint(next);\n    if (fingerprint === this.fingerprint) return;\n    const previous = new Map(this.contributions.map((entry) => [entry.source, contributionFingerprint([entry])]));\n    const retained = new Set(\n      next\n        .filter((entry) => previous.get(entry.source) === contributionFingerprint([entry]))\n        .map((entry) => entry.source),\n    );\n    // A refresh may retain unchanged owners, never withdrawn or replaced ones.\n    // Prune the rollback snapshot too, so cancellation cannot resurrect them.\n    const skills = this.settledState.skills.filter((entry) => retained.has(entry.source));\n    const diagnostics = this.settledState.diagnostics.filter((entry) => !entry.source || retained.has(entry.source));\n    this.settledState = {\n      activation: skills.length === 0 ? 'inactive' : diagnostics.length > 0 ? 'degraded' : 'active',\n      skills,\n      diagnostics,\n    };\n    this.contributions = next;\n    this.fingerprint = fingerprint;\n    if (this.state.activation !== 'inactive') {\n      void this.activate().catch((error: unknown) => {\n        // Activation failures publish a bounded settled state before rejecting.\n        // Only unexpected implementation failures need an out-of-band report.\n        if (error instanceof HelpActivationError) return;\n        this.dependencies.onBackgroundError(error);\n      });\n    }\n  }\n\n  subscribe(listener: (state: HelpRuntimeState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private publish(state: HelpRuntimeState): HelpRuntimeState {\n    this.state = cloneState(state);\n    if (state.activation !== 'activating') this.settledState = cloneState(state);\n    this.dependencies.publisher.publish(this.state);\n    for (const listener of this.listeners) listener(cloneState(this.state));\n    return this.getState();\n  }\n\n  private async loadSources(signal: AbortSignal): Promise<SourceOutcome[]> {\n    const contributions = this.contributions;\n    const outcomes: SourceOutcome[] = Array.from({ length: contributions.length });\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (cursor < contributions.length) {\n        const index = cursor;\n        cursor += 1;\n        const contribution = contributions[index];\n        if (!contribution) return;\n        if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n        try {\n          const resolved = await this.dependencies.resolver.resolve(contribution, signal);\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          const skills = await this.dependencies.materializer.materialize(contribution, resolved, signal);\n          outcomes[index] = { source: contribution.source, loaded: { contribution, index: resolved, skills } };\n        } catch (error) {\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          outcomes[index] = { source: contribution.source, error };\n        }\n      }\n    };\n    const count = Math.min(MAX_RESOLUTION_CONCURRENCY, contributions.length);\n    await Promise.all(Array.from({ length: count }, () => worker()));\n    return outcomes;\n  }\n\n  async activate(externalSignal?: AbortSignal): Promise<HelpRuntimeState> {\n    if (this.disposed) throw new HelpActivationError('Help runtime is disposed.');\n    this.controller?.abort('Help activation generation replaced.');\n    const controller = new AbortController();\n    this.controller = controller;\n    const generation = ++this.generation;\n    const abortFromExternal = () => controller.abort(externalSignal?.reason);\n    externalSignal?.addEventListener('abort', abortFromExternal, { once: true });\n    if (externalSignal?.aborted) abortFromExternal();\n\n    const settledState = cloneState(this.settledState);\n    this.publish({ activation: 'activating', skills: settledState.skills, diagnostics: settledState.diagnostics });\n    try {\n      const outcomes = await this.loadSources(controller.signal);\n      if (controller.signal.aborted || generation !== this.generation) {\n        throw new HelpActivationError(CANCELLATION_MESSAGE);\n      }\n\n      const diagnostics: PoHelpDiagnostic[] = [];\n      const loaded: LoadedSource[] = [];\n      let aggregateBytes = 0;\n      for (const outcome of outcomes) {\n        if (!outcome) continue;\n        if (outcome.error || !outcome.loaded) {\n          diagnostics.push(diagnostic(outcome.source, 'HELP_SOURCE_FAILED', outcome.error));\n          continue;\n        }\n        if (aggregateBytes + outcome.loaded.index.byteLength > MAX_AGGREGATE_LLMS_BYTES) {\n          diagnostics.push(\n            diagnostic(outcome.source, 'HELP_AGGREGATE_LIMIT', 'The aggregate llms.txt byte limit was exceeded.'),\n          );\n          continue;\n        }\n        aggregateBytes += outcome.loaded.index.byteLength;\n        loaded.push(outcome.loaded);\n      }\n\n      const skills: PoHelpSkill[] = [];\n      const names = new Set<string>();\n      for (const source of loaded) {\n        for (const skill of source.skills) {\n          if (skills.length >= PO_HELP_MAX_SKILLS) {\n            diagnostics.push(\n              diagnostic(source.contribution.source, 'HELP_SKILL_LIMIT', 'The Help skill limit was reached.'),\n            );\n            break;\n          }\n          if (names.has(skill.name)) {\n            diagnostics.push(\n              diagnostic(\n                source.contribution.source,\n                'HELP_SKILL_COLLISION',\n                `Help skill '${skill.name}' was already provided by an earlier package source.`,\n              ),\n            );\n            continue;\n          }\n          names.add(skill.name);\n          skills.push({ ...skill });\n        }\n      }\n\n      const boundedDiagnostics = diagnostics.slice(0, PO_HELP_MAX_DIAGNOSTICS);\n      if (skills.length === 0) {\n        this.publish({ activation: 'inactive', skills: [], diagnostics: boundedDiagnostics });\n        throw new HelpActivationError();\n      }\n      return this.publish({\n        activation: boundedDiagnostics.length > 0 ? 'degraded' : 'active',\n        skills,\n        diagnostics: boundedDiagnostics,\n      });\n    } catch (error) {\n      if (generation === this.generation && this.state.activation === 'activating') this.publish(settledState);\n      throw error;\n    } finally {\n      externalSignal?.removeEventListener('abort', abortFromExternal);\n      if (this.controller === controller) this.controller = undefined;\n    }\n  }\n\n  deactivate(): HelpRuntimeState {\n    this.generation += 1;\n    this.controller?.abort('Help deactivated.');\n    this.controller = undefined;\n    return this.publish({ activation: 'inactive', skills: [], diagnostics: [] });\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.deactivate();\n    this.disposed = true;\n    this.listeners.clear();\n  }\n}\n","import { createHash, randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { PoHelpContribution, PoHelpSkill } from '@agimon-ai/po-core/help';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport type { HelpPackageIdentity, HelpSkillMaterializer, ResolvedHelpIndex } from '../../types/help';\nimport { renderHelpSkillWrapper } from '../llmsContent';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst HELP_INDEX_PATH = 'llms.txt';\nconst CACHE_SCHEMA_VERSION = 1;\nconst PRIVATE_FILE_MODE = 0o600;\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst COMPLETION_FILE = '.complete';\nconst CACHE_METADATA_FILE = 'metadata.json';\nconst WRAPPER_DIRECTORY = 'wrappers';\nconst SKILL_FILE = 'SKILL.md';\nconst EXACT_SEMVER_PATTERN =\n  /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u;\nconst NPM_PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\\/)?[a-z0-9][a-z0-9._~-]*$/u;\n\ninterface CacheMetadata {\n  schemaVersion: typeof CACHE_SCHEMA_VERSION;\n  source: string;\n  version: string;\n  path: typeof HELP_INDEX_PATH;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nexport interface CachedHelpIndex {\n  bytes: Uint8Array;\n  filePath: string;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nfunction assertNotAborted(signal: AbortSignal): void {\n  if (signal.aborted) throw new Error('Help activation was cancelled.');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isContained(root: string, candidate: string): boolean {\n  const relative = path.relative(root, candidate);\n  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));\n}\n\nfunction readManifest(filePath: string): Record<string, unknown> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(fs.readFileSync(filePath, 'utf8')) as unknown;\n  } catch (error) {\n    throw new Error(\n      `Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!isRecord(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);\n  return parsed;\n}\n\nexport function resolveHelpPackageIdentity(moduleUrl: string, expectedSource: string): HelpPackageIdentity {\n  if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) {\n    throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);\n  }\n  let modulePath: string;\n  try {\n    const url = new URL(moduleUrl);\n    if (url.protocol !== 'file:') throw new Error(`Help module URL must use file:, received ${url.protocol}`);\n    modulePath = fs.realpathSync(fileURLToPath(url));\n  } catch (error) {\n    throw new Error(\n      `Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!fs.lstatSync(modulePath).isFile())\n    throw new Error(`Help contributor module is not a regular file: ${modulePath}`);\n\n  let directory = path.dirname(modulePath);\n  while (true) {\n    const manifestPath = path.join(directory, PACKAGE_MANIFEST);\n    if (fs.existsSync(manifestPath)) {\n      const manifest = readManifest(manifestPath);\n      const source = manifest.name;\n      const version = manifest.version;\n      if (source !== expectedSource) {\n        throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);\n      }\n      if (typeof version !== 'string' || !EXACT_SEMVER_PATTERN.test(version)) {\n        throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);\n      }\n      const packageRoot = fs.realpathSync(directory);\n      if (!isContained(packageRoot, modulePath))\n        throw new Error('Help contributor module escapes its resolved package root.');\n      return { source: expectedSource, version, packageRoot, modulePath };\n    }\n    const parent = path.dirname(directory);\n    if (parent === directory) break;\n    directory = parent;\n  }\n  throw new Error(`Cannot find a package manifest for Help contributor ${modulePath}.`);\n}\n\nexport function defaultHelpCacheRoot(homeDirectory = os.homedir()): string {\n  return path.join(poHomeDirectory(homeDirectory), 'llms-cache');\n}\n\nexport function sha256Hex(bytes: Uint8Array | string): string {\n  return createHash('sha256').update(bytes).digest('hex');\n}\n\nfunction parseCacheMetadata(value: unknown, identity: HelpPackageIdentity): CacheMetadata | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.schemaVersion !== CACHE_SCHEMA_VERSION ||\n    value.source !== identity.source ||\n    value.version !== identity.version ||\n    value.path !== HELP_INDEX_PATH ||\n    typeof value.integrity !== 'string' ||\n    typeof value.digest !== 'string' ||\n    typeof value.referenceBase !== 'string'\n  ) {\n    return undefined;\n  }\n  return value as unknown as CacheMetadata;\n}\n\nfunction regularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nexport class HelpIndexCache {\n  readonly root: string;\n\n  constructor(root = defaultHelpCacheRoot()) {\n    this.root = root;\n  }\n\n  entryDirectory(identity: HelpPackageIdentity): string {\n    const key = sha256Hex(`${identity.source}\\0${identity.version}\\0${HELP_INDEX_PATH}`);\n    return path.join(this.root, key);\n  }\n\n  discard(identity: HelpPackageIdentity): void {\n    fs.rmSync(this.entryDirectory(identity), { recursive: true, force: true });\n  }\n\n  read(identity: HelpPackageIdentity): CachedHelpIndex | undefined {\n    const directory = this.entryDirectory(identity);\n    const completionPath = path.join(directory, COMPLETION_FILE);\n    const indexPath = path.join(directory, HELP_INDEX_PATH);\n    const metadataPath = path.join(directory, CACHE_METADATA_FILE);\n    if (!regularFile(completionPath) || !regularFile(indexPath) || !regularFile(metadataPath)) return undefined;\n    try {\n      const metadata = parseCacheMetadata(JSON.parse(fs.readFileSync(metadataPath, 'utf8')) as unknown, identity);\n      if (!metadata) return undefined;\n      const bytes = fs.readFileSync(indexPath);\n      if (sha256Hex(bytes) !== metadata.digest) return undefined;\n      if (fs.readFileSync(completionPath, 'utf8').trim() !== metadata.digest) return undefined;\n      return {\n        bytes,\n        filePath: indexPath,\n        integrity: metadata.integrity,\n        digest: metadata.digest,\n        referenceBase: metadata.referenceBase,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  publish(\n    identity: HelpPackageIdentity,\n    bytes: Uint8Array,\n    integrity: string,\n    referenceBase: string,\n    signal: AbortSignal,\n  ): CachedHelpIndex {\n    assertNotAborted(signal);\n    const existing = this.read(identity);\n    if (existing) return existing;\n    const directory = this.entryDirectory(identity);\n    fs.mkdirSync(this.root, { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n    if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n    const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n    const digest = sha256Hex(bytes);\n    const metadata: CacheMetadata = {\n      schemaVersion: CACHE_SCHEMA_VERSION,\n      source: identity.source,\n      version: identity.version,\n      path: HELP_INDEX_PATH,\n      integrity,\n      digest,\n      referenceBase,\n    };\n    try {\n      fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n      fs.writeFileSync(path.join(temporary, HELP_INDEX_PATH), bytes, { mode: PRIVATE_FILE_MODE });\n      fs.writeFileSync(path.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\\n`, {\n        mode: PRIVATE_FILE_MODE,\n      });\n      assertNotAborted(signal);\n      fs.writeFileSync(path.join(temporary, COMPLETION_FILE), `${digest}\\n`, { mode: PRIVATE_FILE_MODE });\n      try {\n        fs.renameSync(temporary, directory);\n      } catch (error) {\n        const winner = this.read(identity);\n        if (winner) return winner;\n        throw error;\n      }\n      return {\n        bytes: Uint8Array.from(bytes),\n        filePath: path.join(directory, HELP_INDEX_PATH),\n        integrity,\n        digest,\n        referenceBase,\n      };\n    } finally {\n      fs.rmSync(temporary, { recursive: true, force: true });\n    }\n  }\n}\n\nexport class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {\n  constructor(private readonly cacheRoot = defaultHelpCacheRoot()) {}\n\n  async materialize(\n    contribution: PoHelpContribution,\n    index: ResolvedHelpIndex,\n    signal: AbortSignal,\n  ): Promise<readonly PoHelpSkill[]> {\n    const skills: PoHelpSkill[] = [];\n    for (const descriptor of contribution.skills) {\n      assertNotAborted(signal);\n      const key = sha256Hex(\n        `${index.identity.source}\\0${index.identity.version}\\0${descriptor.name}\\0${descriptor.description}\\0${index.digest}`,\n      );\n      const directory = path.join(this.cacheRoot, WRAPPER_DIRECTORY, key);\n      const filePath = path.join(directory, SKILL_FILE);\n      const content = renderHelpSkillWrapper(descriptor, index);\n      if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) {\n        fs.mkdirSync(path.dirname(directory), { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n        if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n        const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n        try {\n          fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n          fs.writeFileSync(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });\n          assertNotAborted(signal);\n          try {\n            fs.renameSync(temporary, directory);\n          } catch (error) {\n            if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) throw error;\n          }\n        } finally {\n          fs.rmSync(temporary, { recursive: true, force: true });\n        }\n      }\n      skills.push({\n        source: contribution.source,\n        name: descriptor.name,\n        description: descriptor.description,\n        filePath,\n        baseDir: directory,\n      });\n    }\n    return skills;\n  }\n}\n","import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { PoHelpContribution } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch, HelpFetchResponse, HelpIndexResolver, ResolvedHelpIndex } from '../../types/help';\nimport { HelpIndexCache, resolveHelpPackageIdentity, sha256Hex } from '../helpStorage';\nimport { MAX_LLMS_BYTES, validateLlmsBytes } from '../llmsContent';\n\nconst HELP_INDEX_PATH = 'llms.txt';\nconst UNPKG_ORIGIN = 'https://unpkg.com';\nconst DEFAULT_FETCH_TIMEOUT_MS = 5_000;\nconst MAX_METADATA_BYTES = 512 * 1024;\nconst MAX_REDIRECTS = 3;\nconst SRI_PATTERN = /^sha256-([A-Za-z0-9+/]+={0,2})$/u;\n\ninterface UnpkgMetadataFile {\n  path: string;\n  size?: number;\n  integrity: string;\n}\n\nexport interface DefaultHelpIndexResolverOptions {\n  cache?: HelpIndexCache;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n}\n\nfunction defaultFetch(input: string, init: { signal: AbortSignal; redirect: 'manual' }): Promise<HelpFetchResponse> {\n  return fetch(input, init) as unknown as Promise<HelpFetchResponse>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isRegularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nfunction unpkgPackagePath(source: string, version: string): string {\n  const encoded = source\n    .split('/')\n    .map((segment) =>\n      segment.startsWith('@') ? `@${encodeURIComponent(segment.slice(1))}` : encodeURIComponent(segment),\n    )\n    .join('/');\n  return `${encoded}@${encodeURIComponent(version)}`;\n}\n\nfunction exactUnpkgBase(source: string, version: string): string {\n  return `${UNPKG_ORIGIN}/${unpkgPackagePath(source, version)}/`;\n}\n\nfunction contentLength(response: HelpFetchResponse): number | undefined {\n  const raw = response.headers.get('content-length');\n  if (!raw) return undefined;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;\n}\n\nfunction timeoutSignal(parent: AbortSignal, timeoutMs: number): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abort = () => controller.abort(parent.reason);\n  parent.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(() => controller.abort(new Error('Help download timed out.')), timeoutMs);\n  if (parent.aborted) abort();\n  return {\n    signal: controller.signal,\n    dispose() {\n      clearTimeout(timer);\n      parent.removeEventListener('abort', abort);\n    },\n  };\n}\n\nasync function fetchExact(fetcher: HelpFetch, initialUrl: string, signal: AbortSignal): Promise<HelpFetchResponse> {\n  let url = initialUrl;\n  const expected = new URL(initialUrl);\n  for (let redirect = 0; redirect <= MAX_REDIRECTS; redirect += 1) {\n    const response = await fetcher(url, { signal, redirect: 'manual' });\n    if (response.status < 300 || response.status >= 400) return response;\n    const location = response.headers.get('location');\n    if (!location) throw new Error(`Unpkg redirected ${url} without a location.`);\n    const next = new URL(location, url);\n    if (next.origin !== UNPKG_ORIGIN || next.pathname !== expected.pathname || next.search !== expected.search) {\n      throw new Error(`Unpkg redirect escaped the exact package/version path: ${next.href}`);\n    }\n    url = next.href;\n  }\n  throw new Error(`Unpkg exceeded ${MAX_REDIRECTS} redirects.`);\n}\n\nfunction parseMetadata(text: string): UnpkgMetadataFile {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text) as unknown;\n  } catch {\n    throw new Error('Unpkg metadata is not valid JSON.');\n  }\n  if (!isRecord(parsed) || !Array.isArray(parsed.files)) throw new Error('Unpkg metadata has no files list.');\n  const match = parsed.files.find((entry) => isRecord(entry) && entry.path === `/${HELP_INDEX_PATH}`);\n  if (!isRecord(match) || typeof match.integrity !== 'string') {\n    throw new Error(`Unpkg package does not publish /${HELP_INDEX_PATH}.`);\n  }\n  const size = typeof match.size === 'number' ? match.size : undefined;\n  if (size !== undefined && (!Number.isSafeInteger(size) || size < 0 || size > MAX_LLMS_BYTES)) {\n    throw new Error(`Unpkg /${HELP_INDEX_PATH} exceeds the Help size limit.`);\n  }\n  if (!SRI_PATTERN.test(match.integrity)) throw new Error('Unpkg llms.txt metadata does not contain SHA-256 SRI.');\n  return { path: match.path as string, ...(size === undefined ? {} : { size }), integrity: match.integrity };\n}\n\nfunction verifySri(bytes: Uint8Array, integrity: string): void {\n  const expected = SRI_PATTERN.exec(integrity)?.[1];\n  if (!expected) throw new Error('Invalid llms.txt SRI metadata.');\n  const actual = createHash('sha256').update(bytes).digest('base64');\n  if (actual !== expected) throw new Error('Downloaded llms.txt failed SRI verification.');\n}\n\nexport class DefaultHelpIndexResolver implements HelpIndexResolver {\n  private readonly cache: HelpIndexCache;\n  private readonly fetcher: HelpFetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: DefaultHelpIndexResolverOptions = {}) {\n    this.cache = options.cache ?? new HelpIndexCache();\n    this.fetcher = options.fetch ?? defaultFetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n  }\n\n  async resolve(contribution: PoHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex> {\n    if (signal.aborted) throw new Error('Help activation was cancelled.');\n    const identity = resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);\n    const localPath = path.join(identity.packageRoot, HELP_INDEX_PATH);\n    if (fs.existsSync(localPath)) {\n      if (!isRegularFile(localPath)) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);\n      const bytes = fs.readFileSync(localPath);\n      validateLlmsBytes(bytes);\n      return {\n        identity,\n        location: 'local',\n        filePath: localPath,\n        referenceBase: identity.packageRoot,\n        byteLength: bytes.byteLength,\n        digest: sha256Hex(bytes),\n      };\n    }\n\n    const cached = this.cache.read(identity);\n    if (cached) {\n      try {\n        validateLlmsBytes(cached.bytes);\n        return {\n          identity,\n          location: 'cache',\n          filePath: cached.filePath,\n          referenceBase: cached.referenceBase,\n          byteLength: cached.bytes.byteLength,\n          digest: cached.digest,\n        };\n      } catch {\n        this.cache.discard(identity);\n      }\n    }\n\n    const timed = timeoutSignal(signal, this.timeoutMs);\n    try {\n      const referenceBase = exactUnpkgBase(identity.source, identity.version);\n      const metadataResponse = await fetchExact(this.fetcher, `${referenceBase}?meta`, timed.signal);\n      const metadataLength = contentLength(metadataResponse);\n      if (metadataLength !== undefined && metadataLength > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      if (!metadataResponse.ok) throw new Error(`Unpkg metadata request failed with HTTP ${metadataResponse.status}.`);\n      const metadataText = await metadataResponse.text();\n      if (Buffer.byteLength(metadataText, 'utf8') > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      const metadata = parseMetadata(metadataText);\n      const indexResponse = await fetchExact(this.fetcher, `${referenceBase}${HELP_INDEX_PATH}`, timed.signal);\n      const indexLength = contentLength(indexResponse);\n      if (indexLength !== undefined && indexLength > MAX_LLMS_BYTES) {\n        throw new Error(`Downloaded ${HELP_INDEX_PATH} exceeds ${MAX_LLMS_BYTES} bytes.`);\n      }\n      if (!indexResponse.ok) throw new Error(`Unpkg llms.txt request failed with HTTP ${indexResponse.status}.`);\n      const bytes = new Uint8Array(await indexResponse.arrayBuffer());\n      validateLlmsBytes(bytes);\n      verifySri(bytes, metadata.integrity);\n      const published = this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);\n      return {\n        identity,\n        location: 'remote',\n        filePath: published.filePath,\n        referenceBase: published.referenceBase,\n        byteLength: published.bytes.byteLength,\n        digest: published.digest,\n      };\n    } finally {\n      timed.dispose();\n    }\n  }\n}\n","import type { PoHelpContribution, PoHelpService } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch } from '../../types/help';\nimport { DefaultHelpActivationService } from '../helpActivation';\nimport { DefaultHelpSkillMaterializer, defaultHelpCacheRoot, HelpIndexCache } from '../helpStorage';\nimport { DefaultHelpIndexResolver } from '../llmsResolver';\n\nexport interface HelpRuntimeOptions {\n  cacheRoot?: string;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n  onBackgroundError?(error: unknown): void;\n}\n\nexport interface HelpRuntimeComposition {\n  activation: DefaultHelpActivationService;\n  dispose(): void;\n}\n\nfunction reportAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nexport function createHelpRuntime(service: PoHelpService, options: HelpRuntimeOptions = {}): HelpRuntimeComposition {\n  const cacheRoot = options.cacheRoot ?? defaultHelpCacheRoot();\n  const cache = new HelpIndexCache(cacheRoot);\n  const activation = new DefaultHelpActivationService({\n    resolver: new DefaultHelpIndexResolver({ cache, fetch: options.fetch, timeoutMs: options.timeoutMs }),\n    materializer: new DefaultHelpSkillMaterializer(cacheRoot),\n    publisher: { publish: (snapshot) => service.publish(snapshot) },\n    onBackgroundError(error) {\n      if (options.onBackgroundError) options.onBackgroundError(error);\n      else reportAsync(error);\n    },\n  });\n  const synchronize = (contributions: readonly PoHelpContribution[]): void => {\n    activation.replaceContributions(contributions);\n  };\n  const unsubscribe = service.subscribeContributions((contributions) => synchronize(contributions));\n  synchronize(service.listContributions());\n  let disposed = false;\n  return {\n    activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      unsubscribe();\n      activation.dispose();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["HELP_INDEX_PATH","isRecord","fs"],"sources":["../src/services/llmsContent/index.ts","../src/services/helpActivation/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts","../src/services/helpRuntime/index.ts"],"sourcesContent":["import type { PoHelpSkillDescriptor } from '@agimon-ai/po-core/help';\n\nimport type { ResolvedHelpIndex } from '../../types/help';\n\nexport const MAX_LLMS_BYTES = 1024 * 1024;\nexport const MAX_AGGREGATE_LLMS_BYTES = 4 * MAX_LLMS_BYTES;\n\nconst MARKDOWN_LINK_PATTERN = /!?\\[[^\\]]*\\]\\(\\s*<?([^\\s)>]+)>?(?:\\s+[^)]*)?\\)/gu;\nconst MARKDOWN_REFERENCE_LINK_PATTERN = /^\\s{0,3}\\[[^\\]\\r\\n]+\\]:\\s*<?([^\\s>]+)>?/gmu;\nconst MARKDOWN_AUTOLINK_PATTERN = /<((?:\\.{0,2}\\/|[A-Za-z][A-Za-z0-9+.-]*:)[^<>\\s]+)>/gu;\nconst HTML_LINK_PATTERN = /\\b(?:href|src)\\s*=\\s*[\"']([^\"']+)[\"']/giu;\nconst URI_SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:/iu;\nconst NESTED_PATH_ENCODING_PATTERN = /%(?:25|2e|2f|3a|5c)/iu;\nconst SAFE_EXTERNAL_SCHEMES = new Set(['http:', 'https:', 'mailto:']);\n\nfunction externalScheme(target: string): string | undefined {\n  if (!URI_SCHEME_PATTERN.test(target)) return undefined;\n  return target.slice(0, target.indexOf(':') + 1).toLowerCase();\n}\n\nfunction decodeRelativeTarget(rawTarget: string): string {\n  let decoded = rawTarget;\n  try {\n    for (let pass = 0; pass < 2; pass += 1) {\n      const next = decodeURIComponent(decoded);\n      if (next === decoded) break;\n      decoded = next;\n    }\n  } catch {\n    throw new Error(`llms.txt contains an invalid encoded link '${rawTarget}'.`);\n  }\n  if (NESTED_PATH_ENCODING_PATTERN.test(decoded)) {\n    throw new Error(`llms.txt contains an unsafe nested encoding in link '${rawTarget}'.`);\n  }\n  return decoded;\n}\n\nfunction validateRelativeLink(rawTarget: string): void {\n  if (!rawTarget || rawTarget.startsWith('#')) return;\n  const rawScheme = externalScheme(rawTarget);\n  if (rawScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(rawScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${rawScheme}'.`);\n    }\n    return;\n  }\n\n  const decoded = decodeRelativeTarget(rawTarget);\n  const decodedScheme = externalScheme(decoded);\n  if (decodedScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(decodedScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${decodedScheme}'.`);\n    }\n    return;\n  }\n  const withoutSuffix = decoded.split(/[?#]/u, 1)[0]?.replaceAll('\\\\', '/') ?? '';\n  if (withoutSuffix.startsWith('/') || withoutSuffix.split('/').some((segment) => segment === '..')) {\n    throw new Error(`llms.txt link '${rawTarget}' escapes the package root.`);\n  }\n}\n\nfunction containsUnsafeControl(text: string): boolean {\n  for (const character of text) {\n    const code = character.codePointAt(0) ?? 0;\n    if ((code >= 0 && code <= 8) || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function validateLlmsBytes(bytes: Uint8Array): string {\n  if (bytes.byteLength === 0) throw new Error('llms.txt is empty.');\n  if (bytes.byteLength > MAX_LLMS_BYTES) throw new Error(`llms.txt exceeds ${MAX_LLMS_BYTES} bytes.`);\n\n  let text: string;\n  try {\n    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);\n  } catch {\n    throw new Error('llms.txt is not valid UTF-8.');\n  }\n  if (text.startsWith('\\uFEFF')) text = text.slice(1);\n  if (containsUnsafeControl(text)) throw new Error('llms.txt contains unsafe control bytes.');\n\n  const firstContentLine = text\n    .split(/\\r?\\n/u)\n    .find((line) => line.trim().length > 0)\n    ?.trim();\n  if (!firstContentLine || !/^#\\s+\\S/u.test(firstContentLine)) {\n    throw new Error('llms.txt must begin with a Markdown H1 heading.');\n  }\n  for (const pattern of [\n    MARKDOWN_LINK_PATTERN,\n    MARKDOWN_REFERENCE_LINK_PATTERN,\n    MARKDOWN_AUTOLINK_PATTERN,\n    HTML_LINK_PATTERN,\n  ]) {\n    for (const match of text.matchAll(pattern)) validateRelativeLink(match[1] ?? '');\n  }\n  return text;\n}\n\nexport function renderHelpSkillWrapper(descriptor: PoHelpSkillDescriptor, index: ResolvedHelpIndex): string {\n  const name = JSON.stringify(descriptor.name);\n  const description = JSON.stringify(descriptor.description);\n  const indexPath = JSON.stringify(index.filePath);\n  const referenceBase = JSON.stringify(index.referenceBase);\n  return `---\\nname: ${name}\\ndescription: ${description}\\n---\\n\\n# Package Help\\n\\nRead the validated package Help index at ${indexPath}.\\nResolve relative links in that index against ${referenceBase}.\\nOpen only the linked documents relevant to the current request, as needed; do not recursively load the whole reference set.\\n`;\n}\n","import {\n  PO_HELP_MAX_DIAGNOSTIC_LENGTH,\n  PO_HELP_MAX_DIAGNOSTICS,\n  PO_HELP_MAX_SKILLS,\n  type PoHelpContribution,\n  type PoHelpDiagnostic,\n  type PoHelpSkill,\n} from '@agimon-ai/po-core/help';\n\nimport type {\n  HelpActivationDependencies,\n  HelpActivationService,\n  HelpRuntimeState,\n  ResolvedHelpIndex,\n} from '../../types/help';\nimport { MAX_AGGREGATE_LLMS_BYTES } from '../llmsContent';\n\nconst MAX_RESOLUTION_CONCURRENCY = 4;\nconst FAILURE_MESSAGE = 'No package Help source could be activated.';\nconst CANCELLATION_MESSAGE = 'Help activation was cancelled.';\n\ninterface LoadedSource {\n  contribution: PoHelpContribution;\n  index: ResolvedHelpIndex;\n  skills: readonly PoHelpSkill[];\n}\n\ninterface SourceOutcome {\n  source: string;\n  loaded?: LoadedSource;\n  error?: unknown;\n}\n\nexport class HelpActivationError extends Error {\n  constructor(message = FAILURE_MESSAGE) {\n    super(message);\n    this.name = 'HelpActivationError';\n  }\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 cloneState(state: HelpRuntimeState): HelpRuntimeState {\n  return {\n    activation: state.activation,\n    skills: state.skills.map((skill) => ({ ...skill })),\n    diagnostics: state.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction diagnostic(source: string, code: string, error: unknown): PoHelpDiagnostic {\n  const raw = error instanceof Error ? error.message : String(error);\n  const message = (raw || 'Unknown Help activation failure.').slice(0, PO_HELP_MAX_DIAGNOSTIC_LENGTH);\n  return { source, code, message };\n}\n\nfunction contributionFingerprint(contributions: readonly PoHelpContribution[]): string {\n  return JSON.stringify(\n    contributions.map((contribution) => ({\n      source: contribution.source,\n      moduleUrl: contribution.moduleUrl,\n      skills: contribution.skills,\n    })),\n  );\n}\n\nexport class DefaultHelpActivationService implements HelpActivationService {\n  private readonly dependencies: HelpActivationDependencies;\n  private readonly listeners = new Set<(state: HelpRuntimeState) => void>();\n  private contributions: PoHelpContribution[] = [];\n  private fingerprint = '[]';\n  private state: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private settledState: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private generation = 0;\n  private controller: AbortController | undefined;\n  private disposed = false;\n\n  constructor(dependencies: HelpActivationDependencies) {\n    this.dependencies = dependencies;\n  }\n\n  getState(): HelpRuntimeState {\n    return cloneState(this.state);\n  }\n\n  replaceContributions(contributions: readonly PoHelpContribution[]): void {\n    if (this.disposed) return;\n    const next = contributions.map(cloneContribution).sort((left, right) => left.source.localeCompare(right.source));\n    const fingerprint = contributionFingerprint(next);\n    if (fingerprint === this.fingerprint) return;\n    const previous = new Map(this.contributions.map((entry) => [entry.source, contributionFingerprint([entry])]));\n    const retained = new Set(\n      next\n        .filter((entry) => previous.get(entry.source) === contributionFingerprint([entry]))\n        .map((entry) => entry.source),\n    );\n    // A refresh may retain unchanged owners, never withdrawn or replaced ones.\n    // Prune the rollback snapshot too, so cancellation cannot resurrect them.\n    const skills = this.settledState.skills.filter((entry) => retained.has(entry.source));\n    const diagnostics = this.settledState.diagnostics.filter((entry) => !entry.source || retained.has(entry.source));\n    this.settledState = {\n      activation: skills.length === 0 ? 'inactive' : diagnostics.length > 0 ? 'degraded' : 'active',\n      skills,\n      diagnostics,\n    };\n    this.contributions = next;\n    this.fingerprint = fingerprint;\n    if (this.state.activation !== 'inactive') {\n      void this.activate().catch((error: unknown) => {\n        // Activation failures publish a bounded settled state before rejecting.\n        // Only unexpected implementation failures need an out-of-band report.\n        if (error instanceof HelpActivationError) return;\n        this.dependencies.onBackgroundError(error);\n      });\n    }\n  }\n\n  subscribe(listener: (state: HelpRuntimeState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private publish(state: HelpRuntimeState): HelpRuntimeState {\n    this.state = cloneState(state);\n    if (state.activation !== 'activating') this.settledState = cloneState(state);\n    this.dependencies.publisher.publish(this.state);\n    for (const listener of this.listeners) listener(cloneState(this.state));\n    return this.getState();\n  }\n\n  private async loadSources(signal: AbortSignal): Promise<SourceOutcome[]> {\n    const contributions = this.contributions;\n    const outcomes: SourceOutcome[] = Array.from({ length: contributions.length });\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (cursor < contributions.length) {\n        const index = cursor;\n        cursor += 1;\n        const contribution = contributions[index];\n        if (!contribution) return;\n        if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n        try {\n          const resolved = await this.dependencies.resolver.resolve(contribution, signal);\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          const skills = await this.dependencies.materializer.materialize(contribution, resolved, signal);\n          outcomes[index] = { source: contribution.source, loaded: { contribution, index: resolved, skills } };\n        } catch (error) {\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          outcomes[index] = { source: contribution.source, error };\n        }\n      }\n    };\n    const count = Math.min(MAX_RESOLUTION_CONCURRENCY, contributions.length);\n    await Promise.all(Array.from({ length: count }, () => worker()));\n    return outcomes;\n  }\n\n  async activate(externalSignal?: AbortSignal): Promise<HelpRuntimeState> {\n    if (this.disposed) throw new HelpActivationError('Help runtime is disposed.');\n    this.controller?.abort('Help activation generation replaced.');\n    const controller = new AbortController();\n    this.controller = controller;\n    const generation = ++this.generation;\n    const abortFromExternal = () => controller.abort(externalSignal?.reason);\n    externalSignal?.addEventListener('abort', abortFromExternal, { once: true });\n    if (externalSignal?.aborted) abortFromExternal();\n\n    const settledState = cloneState(this.settledState);\n    this.publish({ activation: 'activating', skills: settledState.skills, diagnostics: settledState.diagnostics });\n    try {\n      const outcomes = await this.loadSources(controller.signal);\n      if (controller.signal.aborted || generation !== this.generation) {\n        throw new HelpActivationError(CANCELLATION_MESSAGE);\n      }\n\n      const diagnostics: PoHelpDiagnostic[] = [];\n      const loaded: LoadedSource[] = [];\n      let aggregateBytes = 0;\n      for (const outcome of outcomes) {\n        if (!outcome) continue;\n        if (outcome.error || !outcome.loaded) {\n          diagnostics.push(diagnostic(outcome.source, 'HELP_SOURCE_FAILED', outcome.error));\n          continue;\n        }\n        if (aggregateBytes + outcome.loaded.index.byteLength > MAX_AGGREGATE_LLMS_BYTES) {\n          diagnostics.push(\n            diagnostic(outcome.source, 'HELP_AGGREGATE_LIMIT', 'The aggregate llms.txt byte limit was exceeded.'),\n          );\n          continue;\n        }\n        aggregateBytes += outcome.loaded.index.byteLength;\n        loaded.push(outcome.loaded);\n      }\n\n      const skills: PoHelpSkill[] = [];\n      const names = new Set<string>();\n      for (const source of loaded) {\n        for (const skill of source.skills) {\n          if (skills.length >= PO_HELP_MAX_SKILLS) {\n            diagnostics.push(\n              diagnostic(source.contribution.source, 'HELP_SKILL_LIMIT', 'The Help skill limit was reached.'),\n            );\n            break;\n          }\n          if (names.has(skill.name)) {\n            diagnostics.push(\n              diagnostic(\n                source.contribution.source,\n                'HELP_SKILL_COLLISION',\n                `Help skill '${skill.name}' was already provided by an earlier package source.`,\n              ),\n            );\n            continue;\n          }\n          names.add(skill.name);\n          skills.push({ ...skill });\n        }\n      }\n\n      const boundedDiagnostics = diagnostics.slice(0, PO_HELP_MAX_DIAGNOSTICS);\n      if (skills.length === 0) {\n        this.publish({ activation: 'inactive', skills: [], diagnostics: boundedDiagnostics });\n        throw new HelpActivationError();\n      }\n      return this.publish({\n        activation: boundedDiagnostics.length > 0 ? 'degraded' : 'active',\n        skills,\n        diagnostics: boundedDiagnostics,\n      });\n    } catch (error) {\n      if (generation === this.generation && this.state.activation === 'activating') this.publish(settledState);\n      throw error;\n    } finally {\n      externalSignal?.removeEventListener('abort', abortFromExternal);\n      if (this.controller === controller) this.controller = undefined;\n    }\n  }\n\n  deactivate(): HelpRuntimeState {\n    this.generation += 1;\n    this.controller?.abort('Help deactivated.');\n    this.controller = undefined;\n    return this.publish({ activation: 'inactive', skills: [], diagnostics: [] });\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.deactivate();\n    this.disposed = true;\n    this.listeners.clear();\n  }\n}\n","import { createHash, randomUUID } from 'node:crypto';\nimport fsPromises from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { PoHelpContribution, PoHelpSkill } from '@agimon-ai/po-core/help';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport type { HelpPackageIdentity, HelpSkillMaterializer, ResolvedHelpIndex } from '../../types/help';\nimport { renderHelpSkillWrapper } from '../llmsContent';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst HELP_INDEX_PATH = 'llms.txt';\nconst CACHE_SCHEMA_VERSION = 1;\nconst PRIVATE_FILE_MODE = 0o600;\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst COMPLETION_FILE = '.complete';\nconst CACHE_METADATA_FILE = 'metadata.json';\nconst WRAPPER_DIRECTORY = 'wrappers';\nconst SKILL_FILE = 'SKILL.md';\nconst EXACT_SEMVER_PATTERN =\n  /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u;\nconst NPM_PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\\/)?[a-z0-9][a-z0-9._~-]*$/u;\n\ninterface CacheMetadata {\n  schemaVersion: typeof CACHE_SCHEMA_VERSION;\n  source: string;\n  version: string;\n  path: typeof HELP_INDEX_PATH;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nexport interface CachedHelpIndex {\n  bytes: Uint8Array;\n  filePath: string;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nfunction assertNotAborted(signal: AbortSignal): void {\n  if (signal.aborted) throw new Error('Help activation was cancelled.');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isContained(root: string, candidate: string): boolean {\n  const relative = path.relative(root, candidate);\n  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));\n}\n\nasync function readManifest(filePath: string): Promise<Record<string, unknown> | undefined> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(await fsPromises.readFile(filePath, 'utf8')) as unknown;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw new Error(\n      `Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!isRecord(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);\n  return parsed;\n}\n\nexport async function resolveHelpPackageIdentity(\n  moduleUrl: string,\n  expectedSource: string,\n): Promise<HelpPackageIdentity> {\n  if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) {\n    throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);\n  }\n  let modulePath: string;\n  try {\n    const url = new URL(moduleUrl);\n    if (url.protocol !== 'file:') throw new Error(`Help module URL must use file:, received ${url.protocol}`);\n    modulePath = await fsPromises.realpath(fileURLToPath(url));\n  } catch (error) {\n    throw new Error(\n      `Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!(await fsPromises.lstat(modulePath)).isFile())\n    throw new Error(`Help contributor module is not a regular file: ${modulePath}`);\n\n  let directory = path.dirname(modulePath);\n  while (true) {\n    const manifestPath = path.join(directory, PACKAGE_MANIFEST);\n    const manifest = await readManifest(manifestPath);\n    if (manifest !== undefined) {\n      const source = manifest.name;\n      const version = manifest.version;\n      if (source !== expectedSource) {\n        throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);\n      }\n      if (typeof version !== 'string' || !EXACT_SEMVER_PATTERN.test(version)) {\n        throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);\n      }\n      const packageRoot = await fsPromises.realpath(directory);\n      if (!isContained(packageRoot, modulePath))\n        throw new Error('Help contributor module escapes its resolved package root.');\n      return { source: expectedSource, version, packageRoot, modulePath };\n    }\n    const parent = path.dirname(directory);\n    if (parent === directory) break;\n    directory = parent;\n  }\n  throw new Error(`Cannot find a package manifest for Help contributor ${modulePath}.`);\n}\n\nexport function defaultHelpCacheRoot(homeDirectory = os.homedir()): string {\n  return path.join(poHomeDirectory(homeDirectory), 'llms-cache');\n}\n\nexport function sha256Hex(bytes: Uint8Array | string): string {\n  return createHash('sha256').update(bytes).digest('hex');\n}\n\nfunction parseCacheMetadata(value: unknown, identity: HelpPackageIdentity): CacheMetadata | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.schemaVersion !== CACHE_SCHEMA_VERSION ||\n    value.source !== identity.source ||\n    value.version !== identity.version ||\n    value.path !== HELP_INDEX_PATH ||\n    typeof value.integrity !== 'string' ||\n    typeof value.digest !== 'string' ||\n    typeof value.referenceBase !== 'string'\n  ) {\n    return undefined;\n  }\n  return value as unknown as CacheMetadata;\n}\n\n// Share mutation ordering across cache instances targeting the same entry.\nconst cacheMutations = new Map<string, Promise<void>>();\n\nasync function mutateCacheEntry<T>(directory: string, operation: () => Promise<T>): Promise<T> {\n  const key = path.resolve(directory);\n  const previous = cacheMutations.get(key) ?? Promise.resolve();\n  const result = previous.then(operation);\n  const settled = result.then(\n    () => {},\n    () => {},\n  );\n  cacheMutations.set(key, settled);\n  try {\n    return await result;\n  } finally {\n    if (cacheMutations.get(key) === settled) cacheMutations.delete(key);\n  }\n}\n\nasync function regularFile(filePath: string): Promise<boolean> {\n  try {\n    const metadata = await fsPromises.lstat(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nexport class HelpIndexCache {\n  readonly root: string;\n\n  constructor(root = defaultHelpCacheRoot()) {\n    this.root = root;\n  }\n\n  entryDirectory(identity: HelpPackageIdentity): string {\n    const key = sha256Hex(`${identity.source}\\0${identity.version}\\0${HELP_INDEX_PATH}`);\n    return path.join(this.root, key);\n  }\n\n  async discard(identity: HelpPackageIdentity): Promise<void> {\n    const directory = this.entryDirectory(identity);\n    await mutateCacheEntry(directory, () => fsPromises.rm(directory, { recursive: true, force: true }));\n  }\n\n  async read(identity: HelpPackageIdentity): Promise<CachedHelpIndex | undefined> {\n    const directory = this.entryDirectory(identity);\n    const completionPath = path.join(directory, COMPLETION_FILE);\n    const indexPath = path.join(directory, HELP_INDEX_PATH);\n    const metadataPath = path.join(directory, CACHE_METADATA_FILE);\n    if (!(await regularFile(completionPath)) || !(await regularFile(indexPath)) || !(await regularFile(metadataPath)))\n      return undefined;\n    try {\n      const metadata = parseCacheMetadata(\n        JSON.parse(await fsPromises.readFile(metadataPath, 'utf8')) as unknown,\n        identity,\n      );\n      if (!metadata) return undefined;\n      const bytes = await fsPromises.readFile(indexPath);\n      if (sha256Hex(bytes) !== metadata.digest) return undefined;\n      if ((await fsPromises.readFile(completionPath, 'utf8')).trim() !== metadata.digest) return undefined;\n      return {\n        bytes,\n        filePath: indexPath,\n        integrity: metadata.integrity,\n        digest: metadata.digest,\n        referenceBase: metadata.referenceBase,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  async publish(\n    identity: HelpPackageIdentity,\n    bytes: Uint8Array,\n    integrity: string,\n    referenceBase: string,\n    signal: AbortSignal,\n  ): Promise<CachedHelpIndex> {\n    const directory = this.entryDirectory(identity);\n    return mutateCacheEntry(directory, async () => {\n      assertNotAborted(signal);\n      const existing = await this.read(identity);\n      if (existing) return existing;\n      await fsPromises.mkdir(this.root, { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n      await fsPromises.rm(directory, { recursive: true, force: true });\n      const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n      const digest = sha256Hex(bytes);\n      const metadata: CacheMetadata = {\n        schemaVersion: CACHE_SCHEMA_VERSION,\n        source: identity.source,\n        version: identity.version,\n        path: HELP_INDEX_PATH,\n        integrity,\n        digest,\n        referenceBase,\n      };\n      try {\n        await fsPromises.mkdir(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n        await fsPromises.writeFile(path.join(temporary, HELP_INDEX_PATH), bytes, { mode: PRIVATE_FILE_MODE });\n        await fsPromises.writeFile(\n          path.join(temporary, CACHE_METADATA_FILE),\n          `${JSON.stringify(metadata, null, 2)}\\n`,\n          {\n            mode: PRIVATE_FILE_MODE,\n          },\n        );\n        assertNotAborted(signal);\n        await fsPromises.writeFile(path.join(temporary, COMPLETION_FILE), `${digest}\\n`, { mode: PRIVATE_FILE_MODE });\n        try {\n          await fsPromises.rename(temporary, directory);\n        } catch (error) {\n          const winner = await this.read(identity);\n          if (winner) return winner;\n          throw error;\n        }\n        return {\n          bytes: Uint8Array.from(bytes),\n          filePath: path.join(directory, HELP_INDEX_PATH),\n          integrity,\n          digest,\n          referenceBase,\n        };\n      } finally {\n        await fsPromises.rm(temporary, { recursive: true, force: true });\n      }\n    });\n  }\n}\n\nexport class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {\n  constructor(private readonly cacheRoot = defaultHelpCacheRoot()) {}\n\n  async materialize(\n    contribution: PoHelpContribution,\n    index: ResolvedHelpIndex,\n    signal: AbortSignal,\n  ): Promise<readonly PoHelpSkill[]> {\n    const skills: PoHelpSkill[] = [];\n    for (const descriptor of contribution.skills) {\n      assertNotAborted(signal);\n      const key = sha256Hex(\n        `${index.identity.source}\\0${index.identity.version}\\0${descriptor.name}\\0${descriptor.description}\\0${index.digest}`,\n      );\n      const directory = path.join(this.cacheRoot, WRAPPER_DIRECTORY, key);\n      const filePath = path.join(directory, SKILL_FILE);\n      const content = renderHelpSkillWrapper(descriptor, index);\n      const matches = async (): Promise<boolean> => {\n        try {\n          const metadata = await fsPromises.lstat(filePath);\n          return (\n            metadata.isFile() && !metadata.isSymbolicLink() && (await fsPromises.readFile(filePath, 'utf8')) === content\n          );\n        } catch {\n          return false;\n        }\n      };\n      if (!(await matches())) {\n        await fsPromises.mkdir(path.dirname(directory), { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n        await fsPromises.rm(directory, { recursive: true, force: true });\n        const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n        try {\n          await fsPromises.mkdir(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n          await fsPromises.writeFile(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });\n          assertNotAborted(signal);\n          try {\n            await fsPromises.rename(temporary, directory);\n          } catch (error) {\n            if (!(await matches())) throw error;\n          }\n        } finally {\n          await fsPromises.rm(temporary, { recursive: true, force: true });\n        }\n      }\n      skills.push({\n        source: contribution.source,\n        name: descriptor.name,\n        description: descriptor.description,\n        filePath,\n        baseDir: directory,\n      });\n    }\n    return skills;\n  }\n}\n","import { createHash } from 'node:crypto';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type { PoHelpContribution } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch, HelpFetchResponse, HelpIndexResolver, ResolvedHelpIndex } from '../../types/help';\nimport { HelpIndexCache, resolveHelpPackageIdentity, sha256Hex } from '../helpStorage';\nimport { MAX_LLMS_BYTES, validateLlmsBytes } from '../llmsContent';\n\nconst HELP_INDEX_PATH = 'llms.txt';\nconst UNPKG_ORIGIN = 'https://unpkg.com';\nconst DEFAULT_FETCH_TIMEOUT_MS = 5_000;\nconst MAX_METADATA_BYTES = 512 * 1024;\nconst MAX_REDIRECTS = 3;\nconst SRI_PATTERN = /^sha256-([A-Za-z0-9+/]+={0,2})$/u;\n\ninterface UnpkgMetadataFile {\n  path: string;\n  size?: number;\n  integrity: string;\n}\n\nexport interface DefaultHelpIndexResolverOptions {\n  cache?: HelpIndexCache;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n}\n\nfunction defaultFetch(input: string, init: { signal: AbortSignal; redirect: 'manual' }): Promise<HelpFetchResponse> {\n  return fetch(input, init) as unknown as Promise<HelpFetchResponse>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nasync function isRegularFile(filePath: string): Promise<boolean | undefined> {\n  try {\n    const metadata = await fs.lstat(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\nfunction unpkgPackagePath(source: string, version: string): string {\n  const encoded = source\n    .split('/')\n    .map((segment) =>\n      segment.startsWith('@') ? `@${encodeURIComponent(segment.slice(1))}` : encodeURIComponent(segment),\n    )\n    .join('/');\n  return `${encoded}@${encodeURIComponent(version)}`;\n}\n\nfunction exactUnpkgBase(source: string, version: string): string {\n  return `${UNPKG_ORIGIN}/${unpkgPackagePath(source, version)}/`;\n}\n\nfunction contentLength(response: HelpFetchResponse): number | undefined {\n  const raw = response.headers.get('content-length');\n  if (!raw) return undefined;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;\n}\n\nfunction timeoutSignal(parent: AbortSignal, timeoutMs: number): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abort = () => controller.abort(parent.reason);\n  parent.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(() => controller.abort(new Error('Help download timed out.')), timeoutMs);\n  if (parent.aborted) abort();\n  return {\n    signal: controller.signal,\n    dispose() {\n      clearTimeout(timer);\n      parent.removeEventListener('abort', abort);\n    },\n  };\n}\n\nasync function fetchExact(fetcher: HelpFetch, initialUrl: string, signal: AbortSignal): Promise<HelpFetchResponse> {\n  let url = initialUrl;\n  const expected = new URL(initialUrl);\n  for (let redirect = 0; redirect <= MAX_REDIRECTS; redirect += 1) {\n    const response = await fetcher(url, { signal, redirect: 'manual' });\n    if (response.status < 300 || response.status >= 400) return response;\n    const location = response.headers.get('location');\n    if (!location) throw new Error(`Unpkg redirected ${url} without a location.`);\n    const next = new URL(location, url);\n    if (next.origin !== UNPKG_ORIGIN || next.pathname !== expected.pathname || next.search !== expected.search) {\n      throw new Error(`Unpkg redirect escaped the exact package/version path: ${next.href}`);\n    }\n    url = next.href;\n  }\n  throw new Error(`Unpkg exceeded ${MAX_REDIRECTS} redirects.`);\n}\n\nfunction parseMetadata(text: string): UnpkgMetadataFile {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text) as unknown;\n  } catch {\n    throw new Error('Unpkg metadata is not valid JSON.');\n  }\n  if (!isRecord(parsed) || !Array.isArray(parsed.files)) throw new Error('Unpkg metadata has no files list.');\n  const match = parsed.files.find((entry) => isRecord(entry) && entry.path === `/${HELP_INDEX_PATH}`);\n  if (!isRecord(match) || typeof match.integrity !== 'string') {\n    throw new Error(`Unpkg package does not publish /${HELP_INDEX_PATH}.`);\n  }\n  const size = typeof match.size === 'number' ? match.size : undefined;\n  if (size !== undefined && (!Number.isSafeInteger(size) || size < 0 || size > MAX_LLMS_BYTES)) {\n    throw new Error(`Unpkg /${HELP_INDEX_PATH} exceeds the Help size limit.`);\n  }\n  if (!SRI_PATTERN.test(match.integrity)) throw new Error('Unpkg llms.txt metadata does not contain SHA-256 SRI.');\n  return { path: match.path as string, ...(size === undefined ? {} : { size }), integrity: match.integrity };\n}\n\nfunction verifySri(bytes: Uint8Array, integrity: string): void {\n  const expected = SRI_PATTERN.exec(integrity)?.[1];\n  if (!expected) throw new Error('Invalid llms.txt SRI metadata.');\n  const actual = createHash('sha256').update(bytes).digest('base64');\n  if (actual !== expected) throw new Error('Downloaded llms.txt failed SRI verification.');\n}\n\nexport class DefaultHelpIndexResolver implements HelpIndexResolver {\n  private readonly cache: HelpIndexCache;\n  private readonly fetcher: HelpFetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: DefaultHelpIndexResolverOptions = {}) {\n    this.cache = options.cache ?? new HelpIndexCache();\n    this.fetcher = options.fetch ?? defaultFetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n  }\n\n  async resolve(contribution: PoHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex> {\n    if (signal.aborted) throw new Error('Help activation was cancelled.');\n    const identity = await resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);\n    const localPath = path.join(identity.packageRoot, HELP_INDEX_PATH);\n    const regular = await isRegularFile(localPath);\n    if (regular !== undefined) {\n      if (!regular) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);\n      const bytes = await fs.readFile(localPath);\n      validateLlmsBytes(bytes);\n      return {\n        identity,\n        location: 'local',\n        filePath: localPath,\n        referenceBase: identity.packageRoot,\n        byteLength: bytes.byteLength,\n        digest: sha256Hex(bytes),\n      };\n    }\n\n    const cached = await this.cache.read(identity);\n    if (cached) {\n      try {\n        validateLlmsBytes(cached.bytes);\n        return {\n          identity,\n          location: 'cache',\n          filePath: cached.filePath,\n          referenceBase: cached.referenceBase,\n          byteLength: cached.bytes.byteLength,\n          digest: cached.digest,\n        };\n      } catch {\n        await this.cache.discard(identity);\n      }\n    }\n\n    const timed = timeoutSignal(signal, this.timeoutMs);\n    try {\n      const referenceBase = exactUnpkgBase(identity.source, identity.version);\n      const metadataResponse = await fetchExact(this.fetcher, `${referenceBase}?meta`, timed.signal);\n      const metadataLength = contentLength(metadataResponse);\n      if (metadataLength !== undefined && metadataLength > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      if (!metadataResponse.ok) throw new Error(`Unpkg metadata request failed with HTTP ${metadataResponse.status}.`);\n      const metadataText = await metadataResponse.text();\n      if (Buffer.byteLength(metadataText, 'utf8') > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      const metadata = parseMetadata(metadataText);\n      const indexResponse = await fetchExact(this.fetcher, `${referenceBase}${HELP_INDEX_PATH}`, timed.signal);\n      const indexLength = contentLength(indexResponse);\n      if (indexLength !== undefined && indexLength > MAX_LLMS_BYTES) {\n        throw new Error(`Downloaded ${HELP_INDEX_PATH} exceeds ${MAX_LLMS_BYTES} bytes.`);\n      }\n      if (!indexResponse.ok) throw new Error(`Unpkg llms.txt request failed with HTTP ${indexResponse.status}.`);\n      const bytes = new Uint8Array(await indexResponse.arrayBuffer());\n      validateLlmsBytes(bytes);\n      verifySri(bytes, metadata.integrity);\n      const published = await this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);\n      return {\n        identity,\n        location: 'remote',\n        filePath: published.filePath,\n        referenceBase: published.referenceBase,\n        byteLength: published.bytes.byteLength,\n        digest: published.digest,\n      };\n    } finally {\n      timed.dispose();\n    }\n  }\n}\n","import type { PoHelpContribution, PoHelpService } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch } from '../../types/help';\nimport { DefaultHelpActivationService } from '../helpActivation';\nimport { DefaultHelpSkillMaterializer, defaultHelpCacheRoot, HelpIndexCache } from '../helpStorage';\nimport { DefaultHelpIndexResolver } from '../llmsResolver';\n\nexport interface HelpRuntimeOptions {\n  cacheRoot?: string;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n  onBackgroundError?(error: unknown): void;\n}\n\nexport interface HelpRuntimeComposition {\n  activation: DefaultHelpActivationService;\n  dispose(): void;\n}\n\nfunction reportAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nexport function createHelpRuntime(service: PoHelpService, options: HelpRuntimeOptions = {}): HelpRuntimeComposition {\n  const cacheRoot = options.cacheRoot ?? defaultHelpCacheRoot();\n  const cache = new HelpIndexCache(cacheRoot);\n  const activation = new DefaultHelpActivationService({\n    resolver: new DefaultHelpIndexResolver({ cache, fetch: options.fetch, timeoutMs: options.timeoutMs }),\n    materializer: new DefaultHelpSkillMaterializer(cacheRoot),\n    publisher: { publish: (snapshot) => service.publish(snapshot) },\n    onBackgroundError(error) {\n      if (options.onBackgroundError) options.onBackgroundError(error);\n      else reportAsync(error);\n    },\n  });\n  const synchronize = (contributions: readonly PoHelpContribution[]): void => {\n    activation.replaceContributions(contributions);\n  };\n  const unsubscribe = service.subscribeContributions((contributions) => synchronize(contributions));\n  synchronize(service.listContributions());\n  let disposed = false;\n  return {\n    activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      unsubscribe();\n      activation.dispose();\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-help",
-  "version": "0.0.0-alpha.45",
+  "version": "0.0.0-alpha.46",
   "description": "Activation-gated package guidance and help skills for Po and Pi extensions.",
   "keywords": [
     "agent-documentation",
@@ -58,15 +58,15 @@
     "access": "public"
   },
   "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.45",
-    "@agimon-ai/po-minor-mode": "0.0.0-alpha.45",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.45",
+    "@agimon-ai/po-core": "0.0.0-alpha.46",
+    "@agimon-ai/po-minor-mode": "0.0.0-alpha.46",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.46",
     "@deepseek-ai/cordis": "4.0.5",
     "typebox": "1.4.2"
   },
   "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.45",
-    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.45",
+    "@agimon-ai/po-build": "0.0.0-alpha.46",
+    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.46",
     "@earendil-works/pi-coding-agent": "1.4.0",
     "@types/node": "26.6.5",
     "@types/react": "19.3.0",