@agimon-ai/po-core 0.0.0-alpha.0

package/dist/src/services/bundlePublication/index.mjs

@@ -0,0 +1,86 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createBundleSigner } from "@agimon-ai/po-web-security/node";
+//#region src/services/bundlePublication/index.ts
+/**
+* Signs synchronized plugin generations without replacing the stable shell publication.
+*
+* Publications are retained by the exact identity and revision advertised to pages, so
+* a concurrent sync cannot pair an old manifest with bytes from a new generation.
+*/
+function createPluginBundlePublication(stateDir, onNotice = () => {}) {
+	let signer;
+	try {
+		signer = createBundleSigner(stateDir, onNotice);
+	} catch (error) {
+		onNotice(`plugin compositions could not be signed: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	const byComposition = /* @__PURE__ */ new Map();
+	const byRoute = /* @__PURE__ */ new Map();
+	const publicationRoot = signer === void 0 ? void 0 : fs.mkdtempSync(path.join(stateDir, "plugin-publications-"));
+	let closed = false;
+	const routeKey = (compositionId, revision) => `${compositionId}:${String(revision)}`;
+	const publish = (compositionId, assetsDir, profile = "web") => {
+		if (closed) return void 0;
+		const existing = byComposition.get(compositionId);
+		if (existing !== void 0) return existing;
+		if (signer === void 0 || publicationRoot === void 0) return void 0;
+		const stagingRoot = fs.mkdtempSync(path.join(publicationRoot, ".staging-"));
+		const snapshot = path.join(stagingRoot, "assets");
+		try {
+			fs.cpSync(assetsDir, snapshot, { recursive: true });
+			const signed = signer.sign(snapshot, profile);
+			if (signed === void 0) {
+				onNotice(`plugin composition '${compositionId}' is empty and cannot be published`);
+				return;
+			}
+			const retainedDirectory = path.join(publicationRoot, `${compositionId}-${String(signed.manifest.revision)}`);
+			fs.renameSync(snapshot, retainedDirectory);
+			const published = {
+				signed,
+				assetsDir: retainedDirectory
+			};
+			byComposition.set(compositionId, published);
+			byRoute.set(routeKey(compositionId, signed.manifest.revision), published);
+			return published;
+		} catch (error) {
+			onNotice(`plugin composition '${compositionId}' could not be signed: ${error instanceof Error ? error.message : String(error)}`);
+			return;
+		} finally {
+			fs.rmSync(stagingRoot, {
+				recursive: true,
+				force: true
+			});
+		}
+	};
+	return {
+		publish,
+		release(compositionId) {
+			const bundle = byComposition.get(compositionId);
+			if (!bundle) return;
+			byComposition.delete(compositionId);
+			byRoute.delete(routeKey(compositionId, bundle.signed.manifest.revision));
+			fs.rmSync(bundle.assetsDir, {
+				recursive: true,
+				force: true
+			});
+		},
+		get: (compositionId, revision) => byRoute.get(routeKey(compositionId, revision)),
+		publicKey: () => signer?.publicKey(),
+		attest: (tag, fields) => signer?.attest(tag, fields),
+		close: () => {
+			if (closed) return;
+			closed = true;
+			byComposition.clear();
+			byRoute.clear();
+			if (publicationRoot !== void 0) fs.rmSync(publicationRoot, {
+				recursive: true,
+				force: true
+			});
+		}
+	};
+}
+//#endregion
+export { createPluginBundlePublication };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/bundlePublication/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/bundlePublication/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { BundleProfile, SignedBundleManifest } from '@agimon-ai/po-web-security';\nimport { createBundleSigner, type BundleSigner } from '@agimon-ai/po-web-security/node';\n\nexport interface PublishedBundle {\n  signed: SignedBundleManifest;\n  assetsDir: string;\n}\n\nexport interface PluginBundlePublication {\n  /** Signs under the given profile; a native publication is exactly one `/composition.js`. */\n  publish(compositionId: string, assetsDir: string, profile?: BundleProfile): PublishedBundle | undefined;\n  get(compositionId: string, revision: number): PublishedBundle | undefined;\n  publicKey(): string | undefined;\n  /** Base64url P1363 signature over a tagged attestation with the publication key. Undefined without a signer. */\n  attest(tag: string, fields: readonly string[]): string | undefined;\n  release(compositionId: string): void;\n  close(): void;\n}\n\n/**\n * Signs synchronized plugin generations without replacing the stable shell publication.\n *\n * Publications are retained by the exact identity and revision advertised to pages, so\n * a concurrent sync cannot pair an old manifest with bytes from a new generation.\n */\nexport function createPluginBundlePublication(\n  stateDir: string,\n  onNotice: (message: string) => void = () => {},\n): PluginBundlePublication {\n  let signer: BundleSigner | undefined;\n  try {\n    signer = createBundleSigner(stateDir, onNotice);\n  } catch (error) {\n    onNotice(`plugin compositions could not be signed: ${error instanceof Error ? error.message : String(error)}`);\n  }\n  const byComposition = new Map<string, PublishedBundle>();\n  const byRoute = new Map<string, PublishedBundle>();\n  const publicationRoot =\n    signer === undefined ? undefined : fs.mkdtempSync(path.join(stateDir, 'plugin-publications-'));\n  let closed = false;\n  const routeKey = (compositionId: string, revision: number): string => `${compositionId}:${String(revision)}`;\n  const publish = (\n    compositionId: string,\n    assetsDir: string,\n    profile: BundleProfile = 'web',\n  ): PublishedBundle | undefined => {\n    if (closed) return undefined;\n    const existing = byComposition.get(compositionId);\n    if (existing !== undefined) return existing;\n    if (signer === undefined || publicationRoot === undefined) return undefined;\n    const stagingRoot = fs.mkdtempSync(path.join(publicationRoot, '.staging-'));\n    const snapshot = path.join(stagingRoot, 'assets');\n    try {\n      fs.cpSync(assetsDir, snapshot, { recursive: true });\n      const signed = signer.sign(snapshot, profile);\n      if (signed === undefined) {\n        onNotice(`plugin composition '${compositionId}' is empty and cannot be published`);\n        return undefined;\n      }\n      const retainedDirectory = path.join(publicationRoot, `${compositionId}-${String(signed.manifest.revision)}`);\n      fs.renameSync(snapshot, retainedDirectory);\n      const published = { signed, assetsDir: retainedDirectory };\n      byComposition.set(compositionId, published);\n      byRoute.set(routeKey(compositionId, signed.manifest.revision), published);\n      return published;\n    } catch (error) {\n      onNotice(\n        `plugin composition '${compositionId}' could not be signed: ${error instanceof Error ? error.message : String(error)}`,\n      );\n      return undefined;\n    } finally {\n      fs.rmSync(stagingRoot, { recursive: true, force: true });\n    }\n  };\n\n  return {\n    publish,\n    release(compositionId) {\n      const bundle = byComposition.get(compositionId);\n      if (!bundle) return;\n      byComposition.delete(compositionId);\n      byRoute.delete(routeKey(compositionId, bundle.signed.manifest.revision));\n      fs.rmSync(bundle.assetsDir, { recursive: true, force: true });\n    },\n    get: (compositionId, revision) => byRoute.get(routeKey(compositionId, revision)),\n    publicKey: () => signer?.publicKey(),\n    attest: (tag, fields) => signer?.attest(tag, fields),\n    close: () => {\n      if (closed) return;\n      closed = true;\n      byComposition.clear();\n      byRoute.clear();\n      if (publicationRoot !== undefined) fs.rmSync(publicationRoot, { recursive: true, force: true });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AA4BA,SAAgB,8BACd,UACA,iBAA4C,CAAC,GACpB;CACzB,IAAI;CACJ,IAAI;EACF,SAAS,mBAAmB,UAAU,QAAQ;CAChD,SAAS,OAAO;EACd,SAAS,4CAA4C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG;CAC/G;CACA,MAAM,gCAAgB,IAAI,IAA6B;CACvD,MAAM,0BAAU,IAAI,IAA6B;CACjD,MAAM,kBACJ,WAAW,KAAA,IAAY,KAAA,IAAY,GAAG,YAAY,KAAK,KAAK,UAAU,sBAAsB,CAAC;CAC/F,IAAI,SAAS;CACb,MAAM,YAAY,eAAuB,aAA6B,GAAG,cAAc,GAAG,OAAO,QAAQ;CACzG,MAAM,WACJ,eACA,WACA,UAAyB,UACO;EAChC,IAAI,QAAQ,OAAO,KAAA;EACnB,MAAM,WAAW,cAAc,IAAI,aAAa;EAChD,IAAI,aAAa,KAAA,GAAW,OAAO;EACnC,IAAI,WAAW,KAAA,KAAa,oBAAoB,KAAA,GAAW,OAAO,KAAA;EAClE,MAAM,cAAc,GAAG,YAAY,KAAK,KAAK,iBAAiB,WAAW,CAAC;EAC1E,MAAM,WAAW,KAAK,KAAK,aAAa,QAAQ;EAChD,IAAI;GACF,GAAG,OAAO,WAAW,UAAU,EAAE,WAAW,KAAK,CAAC;GAClD,MAAM,SAAS,OAAO,KAAK,UAAU,OAAO;GAC5C,IAAI,WAAW,KAAA,GAAW;IACxB,SAAS,uBAAuB,cAAc,mCAAmC;IACjF;GACF;GACA,MAAM,oBAAoB,KAAK,KAAK,iBAAiB,GAAG,cAAc,GAAG,OAAO,OAAO,SAAS,QAAQ,GAAG;GAC3G,GAAG,WAAW,UAAU,iBAAiB;GACzC,MAAM,YAAY;IAAE;IAAQ,WAAW;GAAkB;GACzD,cAAc,IAAI,eAAe,SAAS;GAC1C,QAAQ,IAAI,SAAS,eAAe,OAAO,SAAS,QAAQ,GAAG,SAAS;GACxE,OAAO;EACT,SAAS,OAAO;GACd,SACE,uBAAuB,cAAc,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACrH;GACA;EACF,UAAU;GACR,GAAG,OAAO,aAAa;IAAE,WAAW;IAAM,OAAO;GAAK,CAAC;EACzD;CACF;CAEA,OAAO;EACL;EACA,QAAQ,eAAe;GACrB,MAAM,SAAS,cAAc,IAAI,aAAa;GAC9C,IAAI,CAAC,QAAQ;GACb,cAAc,OAAO,aAAa;GAClC,QAAQ,OAAO,SAAS,eAAe,OAAO,OAAO,SAAS,QAAQ,CAAC;GACvE,GAAG,OAAO,OAAO,WAAW;IAAE,WAAW;IAAM,OAAO;GAAK,CAAC;EAC9D;EACA,MAAM,eAAe,aAAa,QAAQ,IAAI,SAAS,eAAe,QAAQ,CAAC;EAC/E,iBAAiB,QAAQ,UAAU;EACnC,SAAS,KAAK,WAAW,QAAQ,OAAO,KAAK,MAAM;EACnD,aAAa;GACX,IAAI,QAAQ;GACZ,SAAS;GACT,cAAc,MAAM;GACpB,QAAQ,MAAM;GACd,IAAI,oBAAoB,KAAA,GAAW,GAAG,OAAO,iBAAiB;IAAE,WAAW;IAAM,OAAO;GAAK,CAAC;EAChG;CACF;AACF"}

package/dist/src/services/contextApiUrls/index.cjs

@@ -0,0 +1,53 @@
+const require_contextApi = require("../../constants/contextApi.cjs");
+//#region src/services/contextApiUrls/index.ts
+/** The absolute URL a page reads one row's detail through. */
+function itemDetailUrl(sessionPath, itemKind, name) {
+	const search = new URLSearchParams({
+		[require_contextApi.KIND_QUERY_PARAM]: itemKind,
+		[require_contextApi.NAME_QUERY_PARAM]: name
+	});
+	return `${sessionPath}/plugins/${require_contextApi.API_BASE_PATH}${require_contextApi.ITEM_ROUTE}?${search.toString()}`;
+}
+const MAX_WARNING_PAYLOAD = 1048576;
+const MAX_WARNING_TOOLS = 128;
+const MAX_WARNINGS_PER_TOOL = 64;
+const MAX_TOOL_NAME = 512;
+const MAX_WARNING_SOURCE = 600;
+const MAX_WARNING_PATH = 512;
+const MAX_WARNING_MESSAGE = 512;
+const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f]/;
+function warningText(value, limit) {
+	return typeof value === "string" && value.length > 0 && value.length <= limit && !CONTROL_CHARACTERS.test(value);
+}
+/** Invalid or oversized status data is ignored as a whole, never partially trusted. */
+function parseContextToolWarnings(raw) {
+	if (raw === void 0 || raw.length > MAX_WARNING_PAYLOAD) return {};
+	try {
+		const parsed = JSON.parse(raw);
+		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+		const entries = Object.entries(parsed);
+		if (entries.length > MAX_WARNING_TOOLS) return {};
+		const result = [];
+		for (const [name, warnings] of entries) {
+			if (!warningText(name, MAX_TOOL_NAME) || !Array.isArray(warnings) || warnings.length > MAX_WARNINGS_PER_TOOL) return {};
+			const clean = [];
+			for (const warning of warnings) {
+				if (warning === null || typeof warning !== "object" || Array.isArray(warning) || !warningText(warning.source, MAX_WARNING_SOURCE) || !warningText(warning.path, MAX_WARNING_PATH) || !warningText(warning.message, MAX_WARNING_MESSAGE)) return {};
+				clean.push({
+					source: warning.source,
+					path: warning.path,
+					message: warning.message
+				});
+			}
+			result.push([name, clean]);
+		}
+		return Object.fromEntries(result);
+	} catch {
+		return {};
+	}
+}
+//#endregion
+exports.itemDetailUrl = itemDetailUrl;
+exports.parseContextToolWarnings = parseContextToolWarnings;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/contextApiUrls/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["KIND_QUERY_PARAM","NAME_QUERY_PARAM","API_BASE_PATH","ITEM_ROUTE"],"sources":["../../../../src/services/contextApiUrls/index.ts"],"sourcesContent":["import { API_BASE_PATH, ITEM_ROUTE, NAME_QUERY_PARAM, KIND_QUERY_PARAM } from '../../constants/contextApi';\nimport type { ContextItemKind, ContextToolWarning } from '../../types/contextApi';\n\n/** The absolute URL a page reads one row's detail through. */\nexport function itemDetailUrl(sessionPath: string, itemKind: ContextItemKind, name: string): string {\n  const search = new URLSearchParams({\n    [KIND_QUERY_PARAM]: itemKind,\n    [NAME_QUERY_PARAM]: name,\n  });\n  return `${sessionPath}/plugins/${API_BASE_PATH}${ITEM_ROUTE}?${search.toString()}`;\n}\n\nconst MAX_WARNING_PAYLOAD = 1024 * 1024;\nconst MAX_WARNING_TOOLS = 128;\nconst MAX_WARNINGS_PER_TOOL = 64;\nconst MAX_TOOL_NAME = 512;\nconst MAX_WARNING_SOURCE = 600;\nconst MAX_WARNING_PATH = 512;\nconst MAX_WARNING_MESSAGE = 512;\n// Control characters are precisely the untrusted wire text this parser rejects.\n// oxlint-disable-next-line no-control-regex\nconst CONTROL_CHARACTERS = /[\\u0000-\\u001f\\u007f-\\u009f]/;\n\nfunction warningText(value: unknown, limit: number): value is string {\n  return typeof value === 'string' && value.length > 0 && value.length <= limit && !CONTROL_CHARACTERS.test(value);\n}\n\n/** Invalid or oversized status data is ignored as a whole, never partially trusted. */\nexport function parseContextToolWarnings(\n  raw: string | undefined,\n): Readonly<Record<string, readonly ContextToolWarning[]>> {\n  if (raw === undefined || raw.length > MAX_WARNING_PAYLOAD) return {};\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) return {};\n    const entries = Object.entries(parsed);\n    if (entries.length > MAX_WARNING_TOOLS) return {};\n    const result: [string, ContextToolWarning[]][] = [];\n    for (const [name, warnings] of entries) {\n      if (!warningText(name, MAX_TOOL_NAME) || !Array.isArray(warnings) || warnings.length > MAX_WARNINGS_PER_TOOL)\n        return {};\n      const clean: ContextToolWarning[] = [];\n      for (const warning of warnings) {\n        if (\n          warning === null ||\n          typeof warning !== 'object' ||\n          Array.isArray(warning) ||\n          !warningText(warning.source, MAX_WARNING_SOURCE) ||\n          !warningText(warning.path, MAX_WARNING_PATH) ||\n          !warningText(warning.message, MAX_WARNING_MESSAGE)\n        )\n          return {};\n        clean.push({ source: warning.source, path: warning.path, message: warning.message });\n      }\n      result.push([name, clean]);\n    }\n    return Object.fromEntries(result);\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;;AAIA,SAAgB,cAAc,aAAqB,UAA2B,MAAsB;CAClG,MAAM,SAAS,IAAI,gBAAgB;GAChCA,mBAAAA,mBAAmB;GACnBC,mBAAAA,mBAAmB;CACtB,CAAC;CACD,OAAO,GAAG,YAAY,WAAWC,mBAAAA,gBAAgBC,mBAAAA,WAAW,GAAG,OAAO,SAAS;AACjF;AAEA,MAAM,sBAAsB;AAC5B,MAAM,oBAAoB;AAC1B,MAAM,wBAAwB;AAC9B,MAAM,gBAAgB;AACtB,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AACzB,MAAM,sBAAsB;AAG5B,MAAM,qBAAqB;AAE3B,SAAS,YAAY,OAAgB,OAAgC;CACnE,OAAO,OAAO,UAAU,YAAY,MAAM,SAAS,KAAK,MAAM,UAAU,SAAS,CAAC,mBAAmB,KAAK,KAAK;AACjH;;AAGA,SAAgB,yBACd,KACyD;CACzD,IAAI,QAAQ,KAAA,KAAa,IAAI,SAAS,qBAAqB,OAAO,CAAC;CACnE,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,GAAG;EACtC,IAAI,WAAW,QAAQ,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;EACpF,MAAM,UAAU,OAAO,QAAQ,MAAM;EACrC,IAAI,QAAQ,SAAS,mBAAmB,OAAO,CAAC;EAChD,MAAM,SAA2C,CAAC;EAClD,KAAK,MAAM,CAAC,MAAM,aAAa,SAAS;GACtC,IAAI,CAAC,YAAY,MAAM,aAAa,KAAK,CAAC,MAAM,QAAQ,QAAQ,KAAK,SAAS,SAAS,uBACrF,OAAO,CAAC;GACV,MAAM,QAA8B,CAAC;GACrC,KAAK,MAAM,WAAW,UAAU;IAC9B,IACE,YAAY,QACZ,OAAO,YAAY,YACnB,MAAM,QAAQ,OAAO,KACrB,CAAC,YAAY,QAAQ,QAAQ,kBAAkB,KAC/C,CAAC,YAAY,QAAQ,MAAM,gBAAgB,KAC3C,CAAC,YAAY,QAAQ,SAAS,mBAAmB,GAEjD,OAAO,CAAC;IACV,MAAM,KAAK;KAAE,QAAQ,QAAQ;KAAQ,MAAM,QAAQ;KAAM,SAAS,QAAQ;IAAQ,CAAC;GACrF;GACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;EAC3B;EACA,OAAO,OAAO,YAAY,MAAM;CAClC,QAAQ;EACN,OAAO,CAAC;CACV;AACF"}

package/dist/src/services/contextApiUrls/index.d.mts

@@ -0,0 +1,8 @@
+import { ContextItemKind, ContextToolWarning } from "../../../typesContextApi.mjs";
+//#region src/services/contextApiUrls/index.d.ts
+/** The absolute URL a page reads one row's detail through. */
+export declare function itemDetailUrl(sessionPath: string, itemKind: ContextItemKind, name: string): string;
+/** Invalid or oversized status data is ignored as a whole, never partially trusted. */
+export declare function parseContextToolWarnings(raw: string | undefined): Readonly<Record<string, readonly ContextToolWarning[]>>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/contextApiUrls/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/contextApiUrls/index.ts"],"mappings":";;;wBAIgB,cAAc,qBAAqB,UAAU,iBAAiB;;wBAwB9D,yBACd,0BACC,SAAS,wBAAwB"}

package/dist/src/services/contextApiUrls/index.mjs

@@ -0,0 +1,52 @@
+import { API_BASE_PATH, ITEM_ROUTE, KIND_QUERY_PARAM, NAME_QUERY_PARAM } from "../../constants/contextApi.mjs";
+//#region src/services/contextApiUrls/index.ts
+/** The absolute URL a page reads one row's detail through. */
+function itemDetailUrl(sessionPath, itemKind, name) {
+	const search = new URLSearchParams({
+		[KIND_QUERY_PARAM]: itemKind,
+		[NAME_QUERY_PARAM]: name
+	});
+	return `${sessionPath}/plugins/${API_BASE_PATH}${ITEM_ROUTE}?${search.toString()}`;
+}
+const MAX_WARNING_PAYLOAD = 1048576;
+const MAX_WARNING_TOOLS = 128;
+const MAX_WARNINGS_PER_TOOL = 64;
+const MAX_TOOL_NAME = 512;
+const MAX_WARNING_SOURCE = 600;
+const MAX_WARNING_PATH = 512;
+const MAX_WARNING_MESSAGE = 512;
+const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f]/;
+function warningText(value, limit) {
+	return typeof value === "string" && value.length > 0 && value.length <= limit && !CONTROL_CHARACTERS.test(value);
+}
+/** Invalid or oversized status data is ignored as a whole, never partially trusted. */
+function parseContextToolWarnings(raw) {
+	if (raw === void 0 || raw.length > MAX_WARNING_PAYLOAD) return {};
+	try {
+		const parsed = JSON.parse(raw);
+		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+		const entries = Object.entries(parsed);
+		if (entries.length > MAX_WARNING_TOOLS) return {};
+		const result = [];
+		for (const [name, warnings] of entries) {
+			if (!warningText(name, MAX_TOOL_NAME) || !Array.isArray(warnings) || warnings.length > MAX_WARNINGS_PER_TOOL) return {};
+			const clean = [];
+			for (const warning of warnings) {
+				if (warning === null || typeof warning !== "object" || Array.isArray(warning) || !warningText(warning.source, MAX_WARNING_SOURCE) || !warningText(warning.path, MAX_WARNING_PATH) || !warningText(warning.message, MAX_WARNING_MESSAGE)) return {};
+				clean.push({
+					source: warning.source,
+					path: warning.path,
+					message: warning.message
+				});
+			}
+			result.push([name, clean]);
+		}
+		return Object.fromEntries(result);
+	} catch {
+		return {};
+	}
+}
+//#endregion
+export { itemDetailUrl, parseContextToolWarnings };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/contextApiUrls/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/contextApiUrls/index.ts"],"sourcesContent":["import { API_BASE_PATH, ITEM_ROUTE, NAME_QUERY_PARAM, KIND_QUERY_PARAM } from '../../constants/contextApi';\nimport type { ContextItemKind, ContextToolWarning } from '../../types/contextApi';\n\n/** The absolute URL a page reads one row's detail through. */\nexport function itemDetailUrl(sessionPath: string, itemKind: ContextItemKind, name: string): string {\n  const search = new URLSearchParams({\n    [KIND_QUERY_PARAM]: itemKind,\n    [NAME_QUERY_PARAM]: name,\n  });\n  return `${sessionPath}/plugins/${API_BASE_PATH}${ITEM_ROUTE}?${search.toString()}`;\n}\n\nconst MAX_WARNING_PAYLOAD = 1024 * 1024;\nconst MAX_WARNING_TOOLS = 128;\nconst MAX_WARNINGS_PER_TOOL = 64;\nconst MAX_TOOL_NAME = 512;\nconst MAX_WARNING_SOURCE = 600;\nconst MAX_WARNING_PATH = 512;\nconst MAX_WARNING_MESSAGE = 512;\n// Control characters are precisely the untrusted wire text this parser rejects.\n// oxlint-disable-next-line no-control-regex\nconst CONTROL_CHARACTERS = /[\\u0000-\\u001f\\u007f-\\u009f]/;\n\nfunction warningText(value: unknown, limit: number): value is string {\n  return typeof value === 'string' && value.length > 0 && value.length <= limit && !CONTROL_CHARACTERS.test(value);\n}\n\n/** Invalid or oversized status data is ignored as a whole, never partially trusted. */\nexport function parseContextToolWarnings(\n  raw: string | undefined,\n): Readonly<Record<string, readonly ContextToolWarning[]>> {\n  if (raw === undefined || raw.length > MAX_WARNING_PAYLOAD) return {};\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) return {};\n    const entries = Object.entries(parsed);\n    if (entries.length > MAX_WARNING_TOOLS) return {};\n    const result: [string, ContextToolWarning[]][] = [];\n    for (const [name, warnings] of entries) {\n      if (!warningText(name, MAX_TOOL_NAME) || !Array.isArray(warnings) || warnings.length > MAX_WARNINGS_PER_TOOL)\n        return {};\n      const clean: ContextToolWarning[] = [];\n      for (const warning of warnings) {\n        if (\n          warning === null ||\n          typeof warning !== 'object' ||\n          Array.isArray(warning) ||\n          !warningText(warning.source, MAX_WARNING_SOURCE) ||\n          !warningText(warning.path, MAX_WARNING_PATH) ||\n          !warningText(warning.message, MAX_WARNING_MESSAGE)\n        )\n          return {};\n        clean.push({ source: warning.source, path: warning.path, message: warning.message });\n      }\n      result.push([name, clean]);\n    }\n    return Object.fromEntries(result);\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;;AAIA,SAAgB,cAAc,aAAqB,UAA2B,MAAsB;CAClG,MAAM,SAAS,IAAI,gBAAgB;GAChC,mBAAmB;GACnB,mBAAmB;CACtB,CAAC;CACD,OAAO,GAAG,YAAY,WAAW,gBAAgB,WAAW,GAAG,OAAO,SAAS;AACjF;AAEA,MAAM,sBAAsB;AAC5B,MAAM,oBAAoB;AAC1B,MAAM,wBAAwB;AAC9B,MAAM,gBAAgB;AACtB,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AACzB,MAAM,sBAAsB;AAG5B,MAAM,qBAAqB;AAE3B,SAAS,YAAY,OAAgB,OAAgC;CACnE,OAAO,OAAO,UAAU,YAAY,MAAM,SAAS,KAAK,MAAM,UAAU,SAAS,CAAC,mBAAmB,KAAK,KAAK;AACjH;;AAGA,SAAgB,yBACd,KACyD;CACzD,IAAI,QAAQ,KAAA,KAAa,IAAI,SAAS,qBAAqB,OAAO,CAAC;CACnE,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,GAAG;EACtC,IAAI,WAAW,QAAQ,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;EACpF,MAAM,UAAU,OAAO,QAAQ,MAAM;EACrC,IAAI,QAAQ,SAAS,mBAAmB,OAAO,CAAC;EAChD,MAAM,SAA2C,CAAC;EAClD,KAAK,MAAM,CAAC,MAAM,aAAa,SAAS;GACtC,IAAI,CAAC,YAAY,MAAM,aAAa,KAAK,CAAC,MAAM,QAAQ,QAAQ,KAAK,SAAS,SAAS,uBACrF,OAAO,CAAC;GACV,MAAM,QAA8B,CAAC;GACrC,KAAK,MAAM,WAAW,UAAU;IAC9B,IACE,YAAY,QACZ,OAAO,YAAY,YACnB,MAAM,QAAQ,OAAO,KACrB,CAAC,YAAY,QAAQ,QAAQ,kBAAkB,KAC/C,CAAC,YAAY,QAAQ,MAAM,gBAAgB,KAC3C,CAAC,YAAY,QAAQ,SAAS,mBAAmB,GAEjD,OAAO,CAAC;IACV,MAAM,KAAK;KAAE,QAAQ,QAAQ;KAAQ,MAAM,QAAQ;KAAM,SAAS,QAAQ;IAAQ,CAAC;GACrF;GACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;EAC3B;EACA,OAAO,OAAO,YAAY,MAAM;CAClC,QAAQ;EACN,OAAO,CAAC;CACV;AACF"}

package/dist/src/services/contextContributions/index.cjs

@@ -0,0 +1,79 @@
+//#region src/services/contextContributions/index.ts
+function compareContributions(left, right) {
+	const sourceOrder = left.source < right.source ? -1 : left.source > right.source ? 1 : 0;
+	const idOrder = left.id < right.id ? -1 : left.id > right.id ? 1 : 0;
+	return left.order - right.order || sourceOrder || idOrder;
+}
+function assertNonEmpty(value, field) {
+	if (value.trim().length === 0) throw new Error(`Doom context contribution ${field} must not be empty.`);
+}
+function contributionErrorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/** Creates the host-owned aggregation service for one Doom session generation. */
+function createDoomContextContributionsService(generation) {
+	if (!generation) throw new Error("Doom context contributions require a session generation.");
+	const contributions = /* @__PURE__ */ new Map();
+	return Object.freeze({
+		generation,
+		register(contribution) {
+			assertNonEmpty(contribution.source, "source");
+			assertNonEmpty(contribution.id, "id");
+			assertNonEmpty(contribution.label, "label");
+			if (!Number.isFinite(contribution.order)) throw new Error("Doom context contribution order must be a finite number.");
+			if (typeof contribution.snapshot !== "function") throw new Error("Doom context contribution snapshot must be a function.");
+			const key = JSON.stringify([contribution.source, contribution.id]);
+			if (contributions.has(key)) throw new Error(`Doom context contribution is already registered: ${contribution.source}/${contribution.id}.`);
+			const stored = Object.freeze({
+				key,
+				source: contribution.source,
+				id: contribution.id,
+				label: contribution.label,
+				order: contribution.order,
+				snapshot: () => contribution.snapshot()
+			});
+			contributions.set(key, stored);
+			let disposed = false;
+			return Object.freeze({ dispose() {
+				if (disposed) return;
+				disposed = true;
+				if (contributions.get(key) === stored) contributions.delete(key);
+			} });
+		},
+		snapshot() {
+			const entries = [];
+			const errors = [];
+			const ordered = [...contributions.values()].sort(compareContributions);
+			for (const contribution of ordered) {
+				const identity = {
+					source: contribution.source,
+					id: contribution.id,
+					label: contribution.label,
+					order: contribution.order
+				};
+				try {
+					const text = contribution.snapshot();
+					if (text === void 0) continue;
+					if (typeof text !== "string") throw new Error("Snapshot returned a non-string value.");
+					entries.push(Object.freeze({
+						...identity,
+						text
+					}));
+				} catch (error) {
+					errors.push(Object.freeze({
+						...identity,
+						message: contributionErrorMessage(error)
+					}));
+				}
+			}
+			return Object.freeze({
+				entries: Object.freeze(entries),
+				errors: Object.freeze(errors)
+			});
+		}
+	});
+}
+//#endregion
+exports.createDoomContextContributionsService = createDoomContextContributionsService;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/contextContributions/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/contextContributions/index.ts"],"sourcesContent":["import type {\n  DoomContextContribution,\n  DoomContextContributionEntry,\n  DoomContextContributionError,\n  DoomContextContributionRegistration,\n  DoomContextContributionsService,\n  DoomContextContributionsSnapshot,\n} from '../../schemas/contextContributions';\n\ninterface StoredContribution extends DoomContextContribution {\n  readonly key: string;\n}\n\nfunction compareContributions(left: DoomContextContribution, right: DoomContextContribution): number {\n  const sourceOrder = left.source < right.source ? -1 : left.source > right.source ? 1 : 0;\n  const idOrder = left.id < right.id ? -1 : left.id > right.id ? 1 : 0;\n  return left.order - right.order || sourceOrder || idOrder;\n}\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) throw new Error(`Doom context contribution ${field} must not be empty.`);\n}\n\nfunction contributionErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Creates the host-owned aggregation service for one Doom session generation. */\nexport function createDoomContextContributionsService(generation: string): DoomContextContributionsService {\n  if (!generation) throw new Error('Doom context contributions require a session generation.');\n\n  const contributions = new Map<string, StoredContribution>();\n  return Object.freeze({\n    generation,\n    register(contribution: DoomContextContribution): DoomContextContributionRegistration {\n      assertNonEmpty(contribution.source, 'source');\n      assertNonEmpty(contribution.id, 'id');\n      assertNonEmpty(contribution.label, 'label');\n      if (!Number.isFinite(contribution.order)) {\n        throw new Error('Doom context contribution order must be a finite number.');\n      }\n      if (typeof contribution.snapshot !== 'function') {\n        throw new Error('Doom context contribution snapshot must be a function.');\n      }\n\n      const key = JSON.stringify([contribution.source, contribution.id]);\n      if (contributions.has(key)) {\n        throw new Error(`Doom context contribution is already registered: ${contribution.source}/${contribution.id}.`);\n      }\n      const stored: StoredContribution = Object.freeze({\n        key,\n        source: contribution.source,\n        id: contribution.id,\n        label: contribution.label,\n        order: contribution.order,\n        snapshot: () => contribution.snapshot(),\n      });\n      contributions.set(key, stored);\n\n      let disposed = false;\n      return Object.freeze({\n        dispose(): void {\n          if (disposed) return;\n          disposed = true;\n          if (contributions.get(key) === stored) contributions.delete(key);\n        },\n      });\n    },\n    snapshot(): DoomContextContributionsSnapshot {\n      const entries: DoomContextContributionEntry[] = [];\n      const errors: DoomContextContributionError[] = [];\n      const ordered = [...contributions.values()].sort(compareContributions);\n\n      for (const contribution of ordered) {\n        const identity = {\n          source: contribution.source,\n          id: contribution.id,\n          label: contribution.label,\n          order: contribution.order,\n        };\n        try {\n          const text = contribution.snapshot();\n          if (text === undefined) continue;\n          if (typeof text !== 'string') throw new Error('Snapshot returned a non-string value.');\n          entries.push(Object.freeze({ ...identity, text }));\n        } catch (error) {\n          errors.push(Object.freeze({ ...identity, message: contributionErrorMessage(error) }));\n        }\n      }\n\n      return Object.freeze({ entries: Object.freeze(entries), errors: Object.freeze(errors) });\n    },\n  });\n}\n"],"mappings":";AAaA,SAAS,qBAAqB,MAA+B,OAAwC;CACnG,MAAM,cAAc,KAAK,SAAS,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,IAAI;CACvF,MAAM,UAAU,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,KAAK,MAAM,KAAK,IAAI;CACnE,OAAO,KAAK,QAAQ,MAAM,SAAS,eAAe;AACpD;AAEA,SAAS,eAAe,OAAe,OAAqB;CAC1D,IAAI,MAAM,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,IAAI,MAAM,6BAA6B,MAAM,oBAAoB;AACxG;AAEA,SAAS,yBAAyB,OAAwB;CACxD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;AAGA,SAAgB,sCAAsC,YAAqD;CACzG,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,0DAA0D;CAE3F,MAAM,gCAAgB,IAAI,IAAgC;CAC1D,OAAO,OAAO,OAAO;EACnB;EACA,SAAS,cAA4E;GACnF,eAAe,aAAa,QAAQ,QAAQ;GAC5C,eAAe,aAAa,IAAI,IAAI;GACpC,eAAe,aAAa,OAAO,OAAO;GAC1C,IAAI,CAAC,OAAO,SAAS,aAAa,KAAK,GACrC,MAAM,IAAI,MAAM,0DAA0D;GAE5E,IAAI,OAAO,aAAa,aAAa,YACnC,MAAM,IAAI,MAAM,wDAAwD;GAG1E,MAAM,MAAM,KAAK,UAAU,CAAC,aAAa,QAAQ,aAAa,EAAE,CAAC;GACjE,IAAI,cAAc,IAAI,GAAG,GACvB,MAAM,IAAI,MAAM,oDAAoD,aAAa,OAAO,GAAG,aAAa,GAAG,EAAE;GAE/G,MAAM,SAA6B,OAAO,OAAO;IAC/C;IACA,QAAQ,aAAa;IACrB,IAAI,aAAa;IACjB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,gBAAgB,aAAa,SAAS;GACxC,CAAC;GACD,cAAc,IAAI,KAAK,MAAM;GAE7B,IAAI,WAAW;GACf,OAAO,OAAO,OAAO,EACnB,UAAgB;IACd,IAAI,UAAU;IACd,WAAW;IACX,IAAI,cAAc,IAAI,GAAG,MAAM,QAAQ,cAAc,OAAO,GAAG;GACjE,EACF,CAAC;EACH;EACA,WAA6C;GAC3C,MAAM,UAA0C,CAAC;GACjD,MAAM,SAAyC,CAAC;GAChD,MAAM,UAAU,CAAC,GAAG,cAAc,OAAO,CAAC,CAAC,CAAC,KAAK,oBAAoB;GAErE,KAAK,MAAM,gBAAgB,SAAS;IAClC,MAAM,WAAW;KACf,QAAQ,aAAa;KACrB,IAAI,aAAa;KACjB,OAAO,aAAa;KACpB,OAAO,aAAa;IACtB;IACA,IAAI;KACF,MAAM,OAAO,aAAa,SAAS;KACnC,IAAI,SAAS,KAAA,GAAW;KACxB,IAAI,OAAO,SAAS,UAAU,MAAM,IAAI,MAAM,uCAAuC;KACrF,QAAQ,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU;KAAK,CAAC,CAAC;IACnD,SAAS,OAAO;KACd,OAAO,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU,SAAS,yBAAyB,KAAK;KAAE,CAAC,CAAC;IACtF;GACF;GAEA,OAAO,OAAO,OAAO;IAAE,SAAS,OAAO,OAAO,OAAO;IAAG,QAAQ,OAAO,OAAO,MAAM;GAAE,CAAC;EACzF;CACF,CAAC;AACH"}

package/dist/src/services/contextContributions/index.d.mts

@@ -0,0 +1,6 @@
+import { DoomContextContributionsService } from "../../schemas/contextContributions.mjs";
+//#region src/services/contextContributions/index.d.ts
+/** Creates the host-owned aggregation service for one Doom session generation. */
+export declare function createDoomContextContributionsService(generation: string): DoomContextContributionsService;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/contextContributions/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/contextContributions/index.ts"],"mappings":";;;wBA4BgB,sCAAsC,qBAAqB"}

package/dist/src/services/contextContributions/index.mjs

@@ -0,0 +1,79 @@
+//#region src/services/contextContributions/index.ts
+function compareContributions(left, right) {
+	const sourceOrder = left.source < right.source ? -1 : left.source > right.source ? 1 : 0;
+	const idOrder = left.id < right.id ? -1 : left.id > right.id ? 1 : 0;
+	return left.order - right.order || sourceOrder || idOrder;
+}
+function assertNonEmpty(value, field) {
+	if (value.trim().length === 0) throw new Error(`Doom context contribution ${field} must not be empty.`);
+}
+function contributionErrorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/** Creates the host-owned aggregation service for one Doom session generation. */
+function createDoomContextContributionsService(generation) {
+	if (!generation) throw new Error("Doom context contributions require a session generation.");
+	const contributions = /* @__PURE__ */ new Map();
+	return Object.freeze({
+		generation,
+		register(contribution) {
+			assertNonEmpty(contribution.source, "source");
+			assertNonEmpty(contribution.id, "id");
+			assertNonEmpty(contribution.label, "label");
+			if (!Number.isFinite(contribution.order)) throw new Error("Doom context contribution order must be a finite number.");
+			if (typeof contribution.snapshot !== "function") throw new Error("Doom context contribution snapshot must be a function.");
+			const key = JSON.stringify([contribution.source, contribution.id]);
+			if (contributions.has(key)) throw new Error(`Doom context contribution is already registered: ${contribution.source}/${contribution.id}.`);
+			const stored = Object.freeze({
+				key,
+				source: contribution.source,
+				id: contribution.id,
+				label: contribution.label,
+				order: contribution.order,
+				snapshot: () => contribution.snapshot()
+			});
+			contributions.set(key, stored);
+			let disposed = false;
+			return Object.freeze({ dispose() {
+				if (disposed) return;
+				disposed = true;
+				if (contributions.get(key) === stored) contributions.delete(key);
+			} });
+		},
+		snapshot() {
+			const entries = [];
+			const errors = [];
+			const ordered = [...contributions.values()].sort(compareContributions);
+			for (const contribution of ordered) {
+				const identity = {
+					source: contribution.source,
+					id: contribution.id,
+					label: contribution.label,
+					order: contribution.order
+				};
+				try {
+					const text = contribution.snapshot();
+					if (text === void 0) continue;
+					if (typeof text !== "string") throw new Error("Snapshot returned a non-string value.");
+					entries.push(Object.freeze({
+						...identity,
+						text
+					}));
+				} catch (error) {
+					errors.push(Object.freeze({
+						...identity,
+						message: contributionErrorMessage(error)
+					}));
+				}
+			}
+			return Object.freeze({
+				entries: Object.freeze(entries),
+				errors: Object.freeze(errors)
+			});
+		}
+	});
+}
+//#endregion
+export { createDoomContextContributionsService };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/contextContributions/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/contextContributions/index.ts"],"sourcesContent":["import type {\n  DoomContextContribution,\n  DoomContextContributionEntry,\n  DoomContextContributionError,\n  DoomContextContributionRegistration,\n  DoomContextContributionsService,\n  DoomContextContributionsSnapshot,\n} from '../../schemas/contextContributions';\n\ninterface StoredContribution extends DoomContextContribution {\n  readonly key: string;\n}\n\nfunction compareContributions(left: DoomContextContribution, right: DoomContextContribution): number {\n  const sourceOrder = left.source < right.source ? -1 : left.source > right.source ? 1 : 0;\n  const idOrder = left.id < right.id ? -1 : left.id > right.id ? 1 : 0;\n  return left.order - right.order || sourceOrder || idOrder;\n}\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) throw new Error(`Doom context contribution ${field} must not be empty.`);\n}\n\nfunction contributionErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Creates the host-owned aggregation service for one Doom session generation. */\nexport function createDoomContextContributionsService(generation: string): DoomContextContributionsService {\n  if (!generation) throw new Error('Doom context contributions require a session generation.');\n\n  const contributions = new Map<string, StoredContribution>();\n  return Object.freeze({\n    generation,\n    register(contribution: DoomContextContribution): DoomContextContributionRegistration {\n      assertNonEmpty(contribution.source, 'source');\n      assertNonEmpty(contribution.id, 'id');\n      assertNonEmpty(contribution.label, 'label');\n      if (!Number.isFinite(contribution.order)) {\n        throw new Error('Doom context contribution order must be a finite number.');\n      }\n      if (typeof contribution.snapshot !== 'function') {\n        throw new Error('Doom context contribution snapshot must be a function.');\n      }\n\n      const key = JSON.stringify([contribution.source, contribution.id]);\n      if (contributions.has(key)) {\n        throw new Error(`Doom context contribution is already registered: ${contribution.source}/${contribution.id}.`);\n      }\n      const stored: StoredContribution = Object.freeze({\n        key,\n        source: contribution.source,\n        id: contribution.id,\n        label: contribution.label,\n        order: contribution.order,\n        snapshot: () => contribution.snapshot(),\n      });\n      contributions.set(key, stored);\n\n      let disposed = false;\n      return Object.freeze({\n        dispose(): void {\n          if (disposed) return;\n          disposed = true;\n          if (contributions.get(key) === stored) contributions.delete(key);\n        },\n      });\n    },\n    snapshot(): DoomContextContributionsSnapshot {\n      const entries: DoomContextContributionEntry[] = [];\n      const errors: DoomContextContributionError[] = [];\n      const ordered = [...contributions.values()].sort(compareContributions);\n\n      for (const contribution of ordered) {\n        const identity = {\n          source: contribution.source,\n          id: contribution.id,\n          label: contribution.label,\n          order: contribution.order,\n        };\n        try {\n          const text = contribution.snapshot();\n          if (text === undefined) continue;\n          if (typeof text !== 'string') throw new Error('Snapshot returned a non-string value.');\n          entries.push(Object.freeze({ ...identity, text }));\n        } catch (error) {\n          errors.push(Object.freeze({ ...identity, message: contributionErrorMessage(error) }));\n        }\n      }\n\n      return Object.freeze({ entries: Object.freeze(entries), errors: Object.freeze(errors) });\n    },\n  });\n}\n"],"mappings":";AAaA,SAAS,qBAAqB,MAA+B,OAAwC;CACnG,MAAM,cAAc,KAAK,SAAS,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,IAAI;CACvF,MAAM,UAAU,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,KAAK,MAAM,KAAK,IAAI;CACnE,OAAO,KAAK,QAAQ,MAAM,SAAS,eAAe;AACpD;AAEA,SAAS,eAAe,OAAe,OAAqB;CAC1D,IAAI,MAAM,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,IAAI,MAAM,6BAA6B,MAAM,oBAAoB;AACxG;AAEA,SAAS,yBAAyB,OAAwB;CACxD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;AAGA,SAAgB,sCAAsC,YAAqD;CACzG,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,0DAA0D;CAE3F,MAAM,gCAAgB,IAAI,IAAgC;CAC1D,OAAO,OAAO,OAAO;EACnB;EACA,SAAS,cAA4E;GACnF,eAAe,aAAa,QAAQ,QAAQ;GAC5C,eAAe,aAAa,IAAI,IAAI;GACpC,eAAe,aAAa,OAAO,OAAO;GAC1C,IAAI,CAAC,OAAO,SAAS,aAAa,KAAK,GACrC,MAAM,IAAI,MAAM,0DAA0D;GAE5E,IAAI,OAAO,aAAa,aAAa,YACnC,MAAM,IAAI,MAAM,wDAAwD;GAG1E,MAAM,MAAM,KAAK,UAAU,CAAC,aAAa,QAAQ,aAAa,EAAE,CAAC;GACjE,IAAI,cAAc,IAAI,GAAG,GACvB,MAAM,IAAI,MAAM,oDAAoD,aAAa,OAAO,GAAG,aAAa,GAAG,EAAE;GAE/G,MAAM,SAA6B,OAAO,OAAO;IAC/C;IACA,QAAQ,aAAa;IACrB,IAAI,aAAa;IACjB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,gBAAgB,aAAa,SAAS;GACxC,CAAC;GACD,cAAc,IAAI,KAAK,MAAM;GAE7B,IAAI,WAAW;GACf,OAAO,OAAO,OAAO,EACnB,UAAgB;IACd,IAAI,UAAU;IACd,WAAW;IACX,IAAI,cAAc,IAAI,GAAG,MAAM,QAAQ,cAAc,OAAO,GAAG;GACjE,EACF,CAAC;EACH;EACA,WAA6C;GAC3C,MAAM,UAA0C,CAAC;GACjD,MAAM,SAAyC,CAAC;GAChD,MAAM,UAAU,CAAC,GAAG,cAAc,OAAO,CAAC,CAAC,CAAC,KAAK,oBAAoB;GAErE,KAAK,MAAM,gBAAgB,SAAS;IAClC,MAAM,WAAW;KACf,QAAQ,aAAa;KACrB,IAAI,aAAa;KACjB,OAAO,aAAa;KACpB,OAAO,aAAa;IACtB;IACA,IAAI;KACF,MAAM,OAAO,aAAa,SAAS;KACnC,IAAI,SAAS,KAAA,GAAW;KACxB,IAAI,OAAO,SAAS,UAAU,MAAM,IAAI,MAAM,uCAAuC;KACrF,QAAQ,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU;KAAK,CAAC,CAAC;IACnD,SAAS,OAAO;KACd,OAAO,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU,SAAS,yBAAyB,KAAK;KAAE,CAAC,CAAC;IACtF;GACF;GAEA,OAAO,OAAO,OAAO;IAAE,SAAS,OAAO,OAAO,OAAO;IAAG,QAAQ,OAAO,OAAO,MAAM;GAAE,CAAC;EACzF;CACF,CAAC;AACH"}

package/dist/src/services/contextUsage/index.cjs

@@ -0,0 +1,27 @@
+//#region src/services/contextUsage/index.ts
+function contextTokensOf(usage) {
+	return usage === void 0 ? null : usage.input + usage.cacheRead + usage.cacheWrite;
+}
+/** Undefined when the active model declares no window, the one case where no ratio exists. */
+function contextUsageOf(tokens, contextWindow) {
+	if (contextWindow === void 0) return void 0;
+	return {
+		tokens,
+		contextWindow,
+		percent: tokens === null ? null : Math.round(tokens / contextWindow * 100)
+	};
+}
+/** The newest assistant usage on a branch, for priming a live counter from persisted history. */
+function latestAssistantUsage(entries) {
+	for (let index = entries.length - 1; index >= 0; index -= 1) {
+		const entry = entries[index];
+		if (entry?.type !== "message" || entry.message.role !== "assistant") continue;
+		return entry.message.usage;
+	}
+}
+//#endregion
+exports.contextTokensOf = contextTokensOf;
+exports.contextUsageOf = contextUsageOf;
+exports.latestAssistantUsage = latestAssistantUsage;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/contextUsage/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/contextUsage/index.ts"],"sourcesContent":["import type { Usage } from '@earendil-works/pi-ai';\n\n/**\n * How much of the model's window a conversation currently occupies.\n *\n * Occupancy is the last assistant turn's non-output tokens: input plus both\n * cache halves. Output tokens are already counted inside the next request's\n * input, so adding them would report the tail of the conversation twice.\n *\n * Two callers need this number and they reach it differently. The cockpit reads\n * the branch on demand; the Pi extension bridge tracks it from the message the\n * harness just finished. Both have to agree on what \"context tokens\" means, so\n * the definition lives here rather than at either call site.\n */\nimport type { Entry } from '../../types/server/directHarnessRuntime';\n\nexport interface ContextUsage {\n  /** Null while unknown: no assistant message has been measured against the current context yet. */\n  tokens: number | null;\n  contextWindow: number;\n  percent: number | null;\n}\n\nexport function contextTokensOf(usage: Usage | undefined): number | null {\n  return usage === undefined ? null : usage.input + usage.cacheRead + usage.cacheWrite;\n}\n\n/** Undefined when the active model declares no window, the one case where no ratio exists. */\nexport function contextUsageOf(tokens: number | null, contextWindow: number | undefined): ContextUsage | undefined {\n  if (contextWindow === undefined) return undefined;\n  return {\n    tokens,\n    contextWindow,\n    percent: tokens === null ? null : Math.round((tokens / contextWindow) * 100),\n  };\n}\n\n/** The newest assistant usage on a branch, for priming a live counter from persisted history. */\nexport function latestAssistantUsage(entries: readonly Entry[]): Usage | undefined {\n  for (let index = entries.length - 1; index >= 0; index -= 1) {\n    const entry = entries[index];\n    if (entry?.type !== 'message' || entry.message.role !== 'assistant') continue;\n    return entry.message.usage;\n  }\n  return undefined;\n}\n"],"mappings":";AAuBA,SAAgB,gBAAgB,OAAyC;CACvE,OAAO,UAAU,KAAA,IAAY,OAAO,MAAM,QAAQ,MAAM,YAAY,MAAM;AAC5E;;AAGA,SAAgB,eAAe,QAAuB,eAA6D;CACjH,IAAI,kBAAkB,KAAA,GAAW,OAAO,KAAA;CACxC,OAAO;EACL;EACA;EACA,SAAS,WAAW,OAAO,OAAO,KAAK,MAAO,SAAS,gBAAiB,GAAG;CAC7E;AACF;;AAGA,SAAgB,qBAAqB,SAA8C;CACjF,KAAK,IAAI,QAAQ,QAAQ,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG;EAC3D,MAAM,QAAQ,QAAQ;EACtB,IAAI,OAAO,SAAS,aAAa,MAAM,QAAQ,SAAS,aAAa;EACrE,OAAO,MAAM,QAAQ;CACvB;AAEF"}

package/dist/src/services/contextUsage/index.mjs

@@ -0,0 +1,25 @@
+//#region src/services/contextUsage/index.ts
+function contextTokensOf(usage) {
+	return usage === void 0 ? null : usage.input + usage.cacheRead + usage.cacheWrite;
+}
+/** Undefined when the active model declares no window, the one case where no ratio exists. */
+function contextUsageOf(tokens, contextWindow) {
+	if (contextWindow === void 0) return void 0;
+	return {
+		tokens,
+		contextWindow,
+		percent: tokens === null ? null : Math.round(tokens / contextWindow * 100)
+	};
+}
+/** The newest assistant usage on a branch, for priming a live counter from persisted history. */
+function latestAssistantUsage(entries) {
+	for (let index = entries.length - 1; index >= 0; index -= 1) {
+		const entry = entries[index];
+		if (entry?.type !== "message" || entry.message.role !== "assistant") continue;
+		return entry.message.usage;
+	}
+}
+//#endregion
+export { contextTokensOf, contextUsageOf, latestAssistantUsage };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/contextUsage/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/contextUsage/index.ts"],"sourcesContent":["import type { Usage } from '@earendil-works/pi-ai';\n\n/**\n * How much of the model's window a conversation currently occupies.\n *\n * Occupancy is the last assistant turn's non-output tokens: input plus both\n * cache halves. Output tokens are already counted inside the next request's\n * input, so adding them would report the tail of the conversation twice.\n *\n * Two callers need this number and they reach it differently. The cockpit reads\n * the branch on demand; the Pi extension bridge tracks it from the message the\n * harness just finished. Both have to agree on what \"context tokens\" means, so\n * the definition lives here rather than at either call site.\n */\nimport type { Entry } from '../../types/server/directHarnessRuntime';\n\nexport interface ContextUsage {\n  /** Null while unknown: no assistant message has been measured against the current context yet. */\n  tokens: number | null;\n  contextWindow: number;\n  percent: number | null;\n}\n\nexport function contextTokensOf(usage: Usage | undefined): number | null {\n  return usage === undefined ? null : usage.input + usage.cacheRead + usage.cacheWrite;\n}\n\n/** Undefined when the active model declares no window, the one case where no ratio exists. */\nexport function contextUsageOf(tokens: number | null, contextWindow: number | undefined): ContextUsage | undefined {\n  if (contextWindow === undefined) return undefined;\n  return {\n    tokens,\n    contextWindow,\n    percent: tokens === null ? null : Math.round((tokens / contextWindow) * 100),\n  };\n}\n\n/** The newest assistant usage on a branch, for priming a live counter from persisted history. */\nexport function latestAssistantUsage(entries: readonly Entry[]): Usage | undefined {\n  for (let index = entries.length - 1; index >= 0; index -= 1) {\n    const entry = entries[index];\n    if (entry?.type !== 'message' || entry.message.role !== 'assistant') continue;\n    return entry.message.usage;\n  }\n  return undefined;\n}\n"],"mappings":";AAuBA,SAAgB,gBAAgB,OAAyC;CACvE,OAAO,UAAU,KAAA,IAAY,OAAO,MAAM,QAAQ,MAAM,YAAY,MAAM;AAC5E;;AAGA,SAAgB,eAAe,QAAuB,eAA6D;CACjH,IAAI,kBAAkB,KAAA,GAAW,OAAO,KAAA;CACxC,OAAO;EACL;EACA;EACA,SAAS,WAAW,OAAO,OAAO,KAAK,MAAO,SAAS,gBAAiB,GAAG;CAC7E;AACF;;AAGA,SAAgB,qBAAqB,SAA8C;CACjF,KAAK,IAAI,QAAQ,QAAQ,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG;EAC3D,MAAM,QAAQ,QAAQ;EACtB,IAAI,OAAO,SAAS,aAAa,MAAM,QAAQ,SAAS,aAAa;EACrE,OAAO,MAAM,QAAQ;CACvB;AAEF"}