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

package/dist/context-detail-store.d.cts

@@ -0,0 +1,19 @@
+import { ContextDetailFile, ContextItemDetail, ContextItemKind } from "./types-context-api.cjs";
+//#region src/services/contextDetailStore/index.d.ts
+export declare function contextDetailPath(sessionId: string, environment?: Readonly<Record<string, string | undefined>>): string;
+/**
+ * Publishes the detail for one session.
+ *
+ * Written through a temporary file so a reader never sees half a document, and
+ * failures are reported to the caller rather than thrown: the panel works
+ * without this, and a session must not be lost to a full disk.
+ */
+export declare function writeContextDetail(sessionId: string, revision: number, items: readonly ContextItemDetail[], environment?: Readonly<Record<string, string | undefined>>): boolean;
+/** Drops a session's file. Called when the session ends, so the directory does not grow forever. */
+export declare function removeContextDetail(sessionId: string, environment?: Readonly<Record<string, string | undefined>>): void;
+/** What the session wrote, or undefined when it has not written yet. */
+export declare function readContextDetail(sessionId: string, environment?: Readonly<Record<string, string | undefined>>): ContextDetailFile | undefined;
+/** One row's detail, matched the way the panel identifies it. */
+export declare function findContextItem(file: ContextDetailFile, itemKind: ContextItemKind, name: string): ContextItemDetail | undefined;
+//#endregion
+//# sourceMappingURL=context-detail-store.d.cts.map

package/dist/context-detail-store.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-detail-store.d.cts","names":[],"sources":["../src/services/contextDetailStore/index.ts"],"mappings":";;wBAoCgB,kBACd,mBACA,cAAa,SAAS;;;;;;;;wBAYR,mBACd,mBACA,kBACA,gBAAgB,qBAChB,cAAa,SAAS;;wBAqBR,oBACd,mBACA,cAAa,SAAS;;wBAiBR,kBACd,mBACA,cAAa,SAAS,sCACrB;;wBAUa,gBACd,MAAM,mBACN,UAAU,iBACV,eACC"}

package/dist/context-detail-store.d.mts

@@ -0,0 +1,19 @@
+import { ContextDetailFile, ContextItemDetail, ContextItemKind } from "./types-context-api.mjs";
+//#region src/services/contextDetailStore/index.d.ts
+export declare function contextDetailPath(sessionId: string, environment?: Readonly<Record<string, string | undefined>>): string;
+/**
+ * Publishes the detail for one session.
+ *
+ * Written through a temporary file so a reader never sees half a document, and
+ * failures are reported to the caller rather than thrown: the panel works
+ * without this, and a session must not be lost to a full disk.
+ */
+export declare function writeContextDetail(sessionId: string, revision: number, items: readonly ContextItemDetail[], environment?: Readonly<Record<string, string | undefined>>): boolean;
+/** Drops a session's file. Called when the session ends, so the directory does not grow forever. */
+export declare function removeContextDetail(sessionId: string, environment?: Readonly<Record<string, string | undefined>>): void;
+/** What the session wrote, or undefined when it has not written yet. */
+export declare function readContextDetail(sessionId: string, environment?: Readonly<Record<string, string | undefined>>): ContextDetailFile | undefined;
+/** One row's detail, matched the way the panel identifies it. */
+export declare function findContextItem(file: ContextDetailFile, itemKind: ContextItemKind, name: string): ContextItemDetail | undefined;
+//#endregion
+//# sourceMappingURL=context-detail-store.d.mts.map

package/dist/context-detail-store.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-detail-store.d.mts","names":[],"sources":["../src/services/contextDetailStore/index.ts"],"mappings":";;wBAoCgB,kBACd,mBACA,cAAa,SAAS;;;;;;;;wBAYR,mBACd,mBACA,kBACA,gBAAgB,qBAChB,cAAa,SAAS;;wBAqBR,oBACd,mBACA,cAAa,SAAS;;wBAiBR,kBACd,mBACA,cAAa,SAAS,sCACrB;;wBAUa,gBACd,MAAM,mBACN,UAAU,iBACV,eACC"}

package/dist/context-detail-store.mjs

@@ -0,0 +1,91 @@
+import "./constants/contextApi.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+//#region src/services/contextDetailStore/index.ts
+/**
+* Where the agent leaves the composition's detail for the session API to find.
+*
+* The two are separate processes: the inventory only exists inside the agent,
+* and the API that answers the browser is served by the session's host. Every
+* other package-owned API in the repository bridges that gap through the
+* filesystem rather than through the frame protocol, and this one follows,
+* because a file is also what makes the answer survive the agent going quiet
+* between turns.
+*
+* One file per session, replaced whole. The detail is a projection of the
+* composition, not a log of it, so an older copy has no reader.
+*/
+const DIRECTORY_NAME = "doom-context";
+const AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
+/** Owner-only: a tool schema is not secret, but it describes the machine. */
+const PRIVATE_DIRECTORY_MODE = 448;
+const PRIVATE_FILE_MODE = 384;
+function agentDirectory(environment) {
+	return environment[AGENT_DIR_ENV] || path.join(os.homedir(), ".pi", "agent");
+}
+/** A session id reaches this from a query string, so it never becomes a path. */
+function safeName(sessionId) {
+	return sessionId.replace(/[^a-zA-Z0-9._-]/gu, "_");
+}
+function contextDetailPath(sessionId, environment = process.env) {
+	return path.join(agentDirectory(environment), DIRECTORY_NAME, `${safeName(sessionId)}.json`);
+}
+/**
+* Publishes the detail for one session.
+*
+* Written through a temporary file so a reader never sees half a document, and
+* failures are reported to the caller rather than thrown: the panel works
+* without this, and a session must not be lost to a full disk.
+*/
+function writeContextDetail(sessionId, revision, items, environment = process.env) {
+	const target = contextDetailPath(sessionId, environment);
+	const payload = {
+		version: 1,
+		revision,
+		items
+	};
+	const temporary = `${target}.${String(process.pid)}.tmp`;
+	try {
+		fs.mkdirSync(path.dirname(target), {
+			recursive: true,
+			mode: PRIVATE_DIRECTORY_MODE
+		});
+		fs.writeFileSync(temporary, JSON.stringify(payload), { mode: PRIVATE_FILE_MODE });
+		fs.renameSync(temporary, target);
+		return true;
+	} catch {
+		try {
+			fs.rmSync(temporary, { force: true });
+		} catch {}
+		return false;
+	}
+}
+/** Drops a session's file. Called when the session ends, so the directory does not grow forever. */
+function removeContextDetail(sessionId, environment = process.env) {
+	try {
+		fs.rmSync(contextDetailPath(sessionId, environment), { force: true });
+	} catch {}
+}
+function isDetailFile(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const candidate = value;
+	return candidate.version === 1 && Array.isArray(candidate.items);
+}
+/** What the session wrote, or undefined when it has not written yet. */
+function readContextDetail(sessionId, environment = process.env) {
+	try {
+		const parsed = JSON.parse(fs.readFileSync(contextDetailPath(sessionId, environment), "utf8"));
+		return isDetailFile(parsed) ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+/** One row's detail, matched the way the panel identifies it. */
+function findContextItem(file, itemKind, name) {
+	return file.items.find((item) => item.itemKind === itemKind && item.name === name);
+}
+//#endregion
+export { contextDetailPath, findContextItem, readContextDetail, removeContextDetail, writeContextDetail };
+
+//# sourceMappingURL=context-detail-store.mjs.map

package/dist/context-detail-store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-detail-store.mjs","names":[],"sources":["../src/services/contextDetailStore/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { CONTEXT_DETAIL_VERSION } from '../../constants/contextApi';\nimport type { ContextDetailFile, ContextItemDetail, ContextItemKind } from '../../types/contextApi';\n\n/**\n * Where the agent leaves the composition's detail for the session API to find.\n *\n * The two are separate processes: the inventory only exists inside the agent,\n * and the API that answers the browser is served by the session's host. Every\n * other package-owned API in the repository bridges that gap through the\n * filesystem rather than through the frame protocol, and this one follows,\n * because a file is also what makes the answer survive the agent going quiet\n * between turns.\n *\n * One file per session, replaced whole. The detail is a projection of the\n * composition, not a log of it, so an older copy has no reader.\n */\n\nconst DIRECTORY_NAME = 'doom-context';\nconst AGENT_DIR_ENV = 'PI_CODING_AGENT_DIR';\n/** Owner-only: a tool schema is not secret, but it describes the machine. */\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst PRIVATE_FILE_MODE = 0o600;\n\nfunction agentDirectory(environment: NodeJS.ProcessEnv): string {\n  return environment[AGENT_DIR_ENV] || path.join(os.homedir(), '.pi', 'agent');\n}\n\n/** A session id reaches this from a query string, so it never becomes a path. */\nfunction safeName(sessionId: string): string {\n  return sessionId.replace(/[^a-zA-Z0-9._-]/gu, '_');\n}\n\nexport function contextDetailPath(\n  sessionId: string,\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): string {\n  return path.join(agentDirectory(environment), DIRECTORY_NAME, `${safeName(sessionId)}.json`);\n}\n\n/**\n * Publishes the detail for one session.\n *\n * Written through a temporary file so a reader never sees half a document, and\n * failures are reported to the caller rather than thrown: the panel works\n * without this, and a session must not be lost to a full disk.\n */\nexport function writeContextDetail(\n  sessionId: string,\n  revision: number,\n  items: readonly ContextItemDetail[],\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): boolean {\n  const target = contextDetailPath(sessionId, environment);\n  const payload: ContextDetailFile = { version: CONTEXT_DETAIL_VERSION, revision, items };\n  const temporary = `${target}.${String(process.pid)}.tmp`;\n  try {\n    fs.mkdirSync(path.dirname(target), { recursive: true, mode: PRIVATE_DIRECTORY_MODE });\n    fs.writeFileSync(temporary, JSON.stringify(payload), { mode: PRIVATE_FILE_MODE });\n    fs.renameSync(temporary, target);\n    return true;\n  } catch {\n    try {\n      fs.rmSync(temporary, { force: true });\n    } catch {\n      // The temporary file is already unreachable; nothing further to do.\n    }\n    return false;\n  }\n}\n\n/** Drops a session's file. Called when the session ends, so the directory does not grow forever. */\nexport function removeContextDetail(\n  sessionId: string,\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): void {\n  try {\n    fs.rmSync(contextDetailPath(sessionId, environment), { force: true });\n  } catch {\n    // A file that cannot be removed is stale, not fatal; the next session with\n    // this id overwrites it.\n  }\n}\n\nfunction isDetailFile(value: unknown): value is ContextDetailFile {\n  if (typeof value !== 'object' || value === null) return false;\n  const candidate = value as Record<string, unknown>;\n  return candidate.version === CONTEXT_DETAIL_VERSION && Array.isArray(candidate.items);\n}\n\n/** What the session wrote, or undefined when it has not written yet. */\nexport function readContextDetail(\n  sessionId: string,\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): ContextDetailFile | undefined {\n  try {\n    const parsed: unknown = JSON.parse(fs.readFileSync(contextDetailPath(sessionId, environment), 'utf8'));\n    return isDetailFile(parsed) ? parsed : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** One row's detail, matched the way the panel identifies it. */\nexport function findContextItem(\n  file: ContextDetailFile,\n  itemKind: ContextItemKind,\n  name: string,\n): ContextItemDetail | undefined {\n  return file.items.find((item) => item.itemKind === itemKind && item.name === name);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,iBAAiB;AACvB,MAAM,gBAAgB;;AAEtB,MAAM,yBAAyB;AAC/B,MAAM,oBAAoB;AAE1B,SAAS,eAAe,aAAwC;CAC9D,OAAO,YAAY,kBAAkB,KAAK,KAAK,GAAG,QAAQ,GAAG,OAAO,OAAO;AAC7E;;AAGA,SAAS,SAAS,WAA2B;CAC3C,OAAO,UAAU,QAAQ,qBAAqB,GAAG;AACnD;AAEA,SAAgB,kBACd,WACA,cAA4D,QAAQ,KAC5D;CACR,OAAO,KAAK,KAAK,eAAe,WAAW,GAAG,gBAAgB,GAAG,SAAS,SAAS,EAAE,MAAM;AAC7F;;;;;;;;AASA,SAAgB,mBACd,WACA,UACA,OACA,cAA4D,QAAQ,KAC3D;CACT,MAAM,SAAS,kBAAkB,WAAW,WAAW;CACvD,MAAM,UAA6B;EAAE,SAAA;EAAiC;EAAU;CAAM;CACtF,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,QAAQ,GAAG,EAAE;CACnD,IAAI;EACF,GAAG,UAAU,KAAK,QAAQ,MAAM,GAAG;GAAE,WAAW;GAAM,MAAM;EAAuB,CAAC;EACpF,GAAG,cAAc,WAAW,KAAK,UAAU,OAAO,GAAG,EAAE,MAAM,kBAAkB,CAAC;EAChF,GAAG,WAAW,WAAW,MAAM;EAC/B,OAAO;CACT,QAAQ;EACN,IAAI;GACF,GAAG,OAAO,WAAW,EAAE,OAAO,KAAK,CAAC;EACtC,QAAQ,CAER;EACA,OAAO;CACT;AACF;;AAGA,SAAgB,oBACd,WACA,cAA4D,QAAQ,KAC9D;CACN,IAAI;EACF,GAAG,OAAO,kBAAkB,WAAW,WAAW,GAAG,EAAE,OAAO,KAAK,CAAC;CACtE,QAAQ,CAGR;AACF;AAEA,SAAS,aAAa,OAA4C;CAChE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,YAAY;CAClB,OAAO,UAAU,YAAA,KAAsC,MAAM,QAAQ,UAAU,KAAK;AACtF;;AAGA,SAAgB,kBACd,WACA,cAA4D,QAAQ,KACrC;CAC/B,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,GAAG,aAAa,kBAAkB,WAAW,WAAW,GAAG,MAAM,CAAC;EACrG,OAAO,aAAa,MAAM,IAAI,SAAS,KAAA;CACzC,QAAQ;EACN;CACF;AACF;;AAGA,SAAgB,gBACd,MACA,UACA,MAC+B;CAC/B,OAAO,KAAK,MAAM,MAAM,SAAS,KAAK,aAAa,YAAY,KAAK,SAAS,IAAI;AACnF"}

package/dist/context-detail.cjs

@@ -0,0 +1,57 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_index = require("./services/toolCost/index.cjs");
+//#region src/services/contextDetail/index.ts
+const CORE_OWNER = "pi";
+/** The same join the projection makes, so a row and its detail agree on the owner. */
+function ownerOf(source) {
+	if (source.kind === "extension") return source.packageName ?? source.key;
+	if (source.kind === "mcp") return source.key.slice(4);
+	return CORE_OWNER;
+}
+function skillSource(group) {
+	if (group === "plugins") return "plugin";
+	if (group === "extensions") return "extension";
+	return "core";
+}
+function buildContextDetail(input) {
+	const items = [];
+	for (const source of input.sources) {
+		const owner = ownerOf(source);
+		for (const tool of source.tools) {
+			const cost = require_index.tokensForTool(tool, input.countTokens);
+			const detail = {
+				itemKind: "tool",
+				name: tool.name,
+				owner,
+				source: source.kind === "core" ? "core" : source.kind,
+				active: tool.active,
+				tokens: {
+					schemaTokens: cost.schemaTokens,
+					promptTokens: cost.promptTokens,
+					totalTokens: cost.totalTokens
+				},
+				...tool.description ? { description: tool.description } : {},
+				...tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {},
+				...tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {},
+				...tool.parameters === void 0 ? {} : { parameters: tool.parameters }
+			};
+			items.push(detail);
+		}
+	}
+	for (const skill of input.skills) items.push({
+		itemKind: "skill",
+		name: skill.name,
+		owner: skill.owner,
+		source: skillSource(skill.group),
+		active: true,
+		tokens: skill.promptTokens ?? 0,
+		description: skill.description,
+		...skill.filePath === void 0 ? {} : { filePath: skill.filePath },
+		modelInvocable: skill.modelInvocable
+	});
+	return items;
+}
+//#endregion
+exports.buildContextDetail = buildContextDetail;
+
+//# sourceMappingURL=context-detail.cjs.map

package/dist/context-detail.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-detail.cjs","names":["tokensForTool"],"sources":["../src/services/contextDetail/index.ts"],"sourcesContent":["import type { ContextItemDetail, ContextToolDetail } from '../../types/contextApi';\nimport type { ContextSkillInventory } from '../contextProjection';\nimport { type CountTokens, type ToolSource, tokensForTool } from '../toolInventory';\n\n/**\n * The prose and schema behind the projection's figures.\n *\n * Built from the same inventory in the same pass, so a detail can never\n * describe a composition the panel is not showing. Nothing is grouped here:\n * the panel already knows which mode a row sits under, and a lookup by name is\n * all a click needs.\n */\n\nconst MCP_KEY_PREFIX = 'mcp:';\nconst CORE_OWNER = 'pi';\n\n/** The same join the projection makes, so a row and its detail agree on the owner. */\nfunction ownerOf(source: ToolSource): string {\n  if (source.kind === 'extension') return source.packageName ?? source.key;\n  if (source.kind === 'mcp') return source.key.slice(MCP_KEY_PREFIX.length);\n  return CORE_OWNER;\n}\n\nfunction skillSource(group: ContextSkillInventory['group']): ContextItemDetail['source'] {\n  if (group === 'plugins') return 'plugin';\n  if (group === 'extensions') return 'extension';\n  return 'core';\n}\n\nexport interface ContextDetailInput {\n  readonly sources: readonly ToolSource[];\n  readonly skills: readonly ContextSkillInventory[];\n  readonly countTokens: CountTokens;\n}\n\nexport function buildContextDetail(input: ContextDetailInput): ContextItemDetail[] {\n  const items: ContextItemDetail[] = [];\n\n  for (const source of input.sources) {\n    const owner = ownerOf(source);\n    for (const tool of source.tools) {\n      const cost = tokensForTool(tool, input.countTokens);\n      const detail: ContextToolDetail = {\n        itemKind: 'tool',\n        name: tool.name,\n        owner,\n        source: source.kind === 'core' ? 'core' : source.kind,\n        active: tool.active,\n        tokens: { schemaTokens: cost.schemaTokens, promptTokens: cost.promptTokens, totalTokens: cost.totalTokens },\n        ...(tool.description ? { description: tool.description } : {}),\n        ...(tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {}),\n        ...(tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {}),\n        ...(tool.parameters === undefined ? {} : { parameters: tool.parameters }),\n      };\n      items.push(detail);\n    }\n  }\n\n  for (const skill of input.skills) {\n    items.push({\n      itemKind: 'skill',\n      name: skill.name,\n      owner: skill.owner,\n      source: skillSource(skill.group),\n      active: true,\n      tokens: skill.promptTokens ?? 0,\n      description: skill.description,\n      ...(skill.filePath === undefined ? {} : { filePath: skill.filePath }),\n      modelInvocable: skill.modelInvocable,\n    });\n  }\n\n  return items;\n}\n"],"mappings":";;;AAcA,MAAM,aAAa;;AAGnB,SAAS,QAAQ,QAA4B;CAC3C,IAAI,OAAO,SAAS,aAAa,OAAO,OAAO,eAAe,OAAO;CACrE,IAAI,OAAO,SAAS,OAAO,OAAO,OAAO,IAAI,MAAM,CAAqB;CACxE,OAAO;AACT;AAEA,SAAS,YAAY,OAAoE;CACvF,IAAI,UAAU,WAAW,OAAO;CAChC,IAAI,UAAU,cAAc,OAAO;CACnC,OAAO;AACT;AAQA,SAAgB,mBAAmB,OAAgD;CACjF,MAAM,QAA6B,CAAC;CAEpC,KAAK,MAAM,UAAU,MAAM,SAAS;EAClC,MAAM,QAAQ,QAAQ,MAAM;EAC5B,KAAK,MAAM,QAAQ,OAAO,OAAO;GAC/B,MAAM,OAAOA,cAAAA,cAAc,MAAM,MAAM,WAAW;GAClD,MAAM,SAA4B;IAChC,UAAU;IACV,MAAM,KAAK;IACX;IACA,QAAQ,OAAO,SAAS,SAAS,SAAS,OAAO;IACjD,QAAQ,KAAK;IACb,QAAQ;KAAE,cAAc,KAAK;KAAc,cAAc,KAAK;KAAc,aAAa,KAAK;IAAY;IAC1G,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;IAC5D,GAAI,KAAK,gBAAgB,EAAE,eAAe,KAAK,cAAc,IAAI,CAAC;IAClE,GAAI,KAAK,kBAAkB,SAAS,EAAE,kBAAkB,KAAK,iBAAiB,IAAI,CAAC;IACnF,GAAI,KAAK,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,KAAK,WAAW;GACzE;GACA,MAAM,KAAK,MAAM;EACnB;CACF;CAEA,KAAK,MAAM,SAAS,MAAM,QACxB,MAAM,KAAK;EACT,UAAU;EACV,MAAM,MAAM;EACZ,OAAO,MAAM;EACb,QAAQ,YAAY,MAAM,KAAK;EAC/B,QAAQ;EACR,QAAQ,MAAM,gBAAgB;EAC9B,aAAa,MAAM;EACnB,GAAI,MAAM,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,MAAM,SAAS;EACnE,gBAAgB,MAAM;CACxB,CAAC;CAGH,OAAO;AACT"}

package/dist/context-detail.d.cts

@@ -0,0 +1,13 @@
+import { CountTokens } from "./services/toolCost/index.cjs";
+import { ToolSource } from "./tool-inventory.cjs";
+import { ContextSkillInventory } from "./context-projection.cjs";
+import { ContextItemDetail } from "./types-context-api.cjs";
+//#region src/services/contextDetail/index.d.ts
+export interface ContextDetailInput {
+  readonly sources: readonly ToolSource[];
+  readonly skills: readonly ContextSkillInventory[];
+  readonly countTokens: CountTokens;
+}
+export declare function buildContextDetail(input: ContextDetailInput): ContextItemDetail[];
+//#endregion
+//# sourceMappingURL=context-detail.d.cts.map

package/dist/context-detail.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-detail.d.cts","names":[],"sources":["../src/services/contextDetail/index.ts"],"mappings":";;;;;iBA6BiB;WACN,kBAAkB;WAClB,iBAAiB;WACjB,aAAa;;wBAGR,mBAAmB,OAAO,qBAAqB"}

package/dist/context-detail.d.mts

@@ -0,0 +1,13 @@
+import { CountTokens } from "./services/toolCost/index.mjs";
+import { ToolSource } from "./tool-inventory.mjs";
+import { ContextSkillInventory } from "./context-projection.mjs";
+import { ContextItemDetail } from "./types-context-api.mjs";
+//#region src/services/contextDetail/index.d.ts
+export interface ContextDetailInput {
+  readonly sources: readonly ToolSource[];
+  readonly skills: readonly ContextSkillInventory[];
+  readonly countTokens: CountTokens;
+}
+export declare function buildContextDetail(input: ContextDetailInput): ContextItemDetail[];
+//#endregion
+//# sourceMappingURL=context-detail.d.mts.map

package/dist/context-detail.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-detail.d.mts","names":[],"sources":["../src/services/contextDetail/index.ts"],"mappings":";;;;;iBA6BiB;WACN,kBAAkB;WAClB,iBAAiB;WACjB,aAAa;;wBAGR,mBAAmB,OAAO,qBAAqB"}

package/dist/context-detail.mjs

@@ -0,0 +1,56 @@
+import { tokensForTool } from "./services/toolCost/index.mjs";
+//#region src/services/contextDetail/index.ts
+const CORE_OWNER = "pi";
+/** The same join the projection makes, so a row and its detail agree on the owner. */
+function ownerOf(source) {
+	if (source.kind === "extension") return source.packageName ?? source.key;
+	if (source.kind === "mcp") return source.key.slice(4);
+	return CORE_OWNER;
+}
+function skillSource(group) {
+	if (group === "plugins") return "plugin";
+	if (group === "extensions") return "extension";
+	return "core";
+}
+function buildContextDetail(input) {
+	const items = [];
+	for (const source of input.sources) {
+		const owner = ownerOf(source);
+		for (const tool of source.tools) {
+			const cost = tokensForTool(tool, input.countTokens);
+			const detail = {
+				itemKind: "tool",
+				name: tool.name,
+				owner,
+				source: source.kind === "core" ? "core" : source.kind,
+				active: tool.active,
+				tokens: {
+					schemaTokens: cost.schemaTokens,
+					promptTokens: cost.promptTokens,
+					totalTokens: cost.totalTokens
+				},
+				...tool.description ? { description: tool.description } : {},
+				...tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {},
+				...tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {},
+				...tool.parameters === void 0 ? {} : { parameters: tool.parameters }
+			};
+			items.push(detail);
+		}
+	}
+	for (const skill of input.skills) items.push({
+		itemKind: "skill",
+		name: skill.name,
+		owner: skill.owner,
+		source: skillSource(skill.group),
+		active: true,
+		tokens: skill.promptTokens ?? 0,
+		description: skill.description,
+		...skill.filePath === void 0 ? {} : { filePath: skill.filePath },
+		modelInvocable: skill.modelInvocable
+	});
+	return items;
+}
+//#endregion
+export { buildContextDetail };
+
+//# sourceMappingURL=context-detail.mjs.map

package/dist/context-detail.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-detail.mjs","names":[],"sources":["../src/services/contextDetail/index.ts"],"sourcesContent":["import type { ContextItemDetail, ContextToolDetail } from '../../types/contextApi';\nimport type { ContextSkillInventory } from '../contextProjection';\nimport { type CountTokens, type ToolSource, tokensForTool } from '../toolInventory';\n\n/**\n * The prose and schema behind the projection's figures.\n *\n * Built from the same inventory in the same pass, so a detail can never\n * describe a composition the panel is not showing. Nothing is grouped here:\n * the panel already knows which mode a row sits under, and a lookup by name is\n * all a click needs.\n */\n\nconst MCP_KEY_PREFIX = 'mcp:';\nconst CORE_OWNER = 'pi';\n\n/** The same join the projection makes, so a row and its detail agree on the owner. */\nfunction ownerOf(source: ToolSource): string {\n  if (source.kind === 'extension') return source.packageName ?? source.key;\n  if (source.kind === 'mcp') return source.key.slice(MCP_KEY_PREFIX.length);\n  return CORE_OWNER;\n}\n\nfunction skillSource(group: ContextSkillInventory['group']): ContextItemDetail['source'] {\n  if (group === 'plugins') return 'plugin';\n  if (group === 'extensions') return 'extension';\n  return 'core';\n}\n\nexport interface ContextDetailInput {\n  readonly sources: readonly ToolSource[];\n  readonly skills: readonly ContextSkillInventory[];\n  readonly countTokens: CountTokens;\n}\n\nexport function buildContextDetail(input: ContextDetailInput): ContextItemDetail[] {\n  const items: ContextItemDetail[] = [];\n\n  for (const source of input.sources) {\n    const owner = ownerOf(source);\n    for (const tool of source.tools) {\n      const cost = tokensForTool(tool, input.countTokens);\n      const detail: ContextToolDetail = {\n        itemKind: 'tool',\n        name: tool.name,\n        owner,\n        source: source.kind === 'core' ? 'core' : source.kind,\n        active: tool.active,\n        tokens: { schemaTokens: cost.schemaTokens, promptTokens: cost.promptTokens, totalTokens: cost.totalTokens },\n        ...(tool.description ? { description: tool.description } : {}),\n        ...(tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {}),\n        ...(tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {}),\n        ...(tool.parameters === undefined ? {} : { parameters: tool.parameters }),\n      };\n      items.push(detail);\n    }\n  }\n\n  for (const skill of input.skills) {\n    items.push({\n      itemKind: 'skill',\n      name: skill.name,\n      owner: skill.owner,\n      source: skillSource(skill.group),\n      active: true,\n      tokens: skill.promptTokens ?? 0,\n      description: skill.description,\n      ...(skill.filePath === undefined ? {} : { filePath: skill.filePath }),\n      modelInvocable: skill.modelInvocable,\n    });\n  }\n\n  return items;\n}\n"],"mappings":";;AAcA,MAAM,aAAa;;AAGnB,SAAS,QAAQ,QAA4B;CAC3C,IAAI,OAAO,SAAS,aAAa,OAAO,OAAO,eAAe,OAAO;CACrE,IAAI,OAAO,SAAS,OAAO,OAAO,OAAO,IAAI,MAAM,CAAqB;CACxE,OAAO;AACT;AAEA,SAAS,YAAY,OAAoE;CACvF,IAAI,UAAU,WAAW,OAAO;CAChC,IAAI,UAAU,cAAc,OAAO;CACnC,OAAO;AACT;AAQA,SAAgB,mBAAmB,OAAgD;CACjF,MAAM,QAA6B,CAAC;CAEpC,KAAK,MAAM,UAAU,MAAM,SAAS;EAClC,MAAM,QAAQ,QAAQ,MAAM;EAC5B,KAAK,MAAM,QAAQ,OAAO,OAAO;GAC/B,MAAM,OAAO,cAAc,MAAM,MAAM,WAAW;GAClD,MAAM,SAA4B;IAChC,UAAU;IACV,MAAM,KAAK;IACX;IACA,QAAQ,OAAO,SAAS,SAAS,SAAS,OAAO;IACjD,QAAQ,KAAK;IACb,QAAQ;KAAE,cAAc,KAAK;KAAc,cAAc,KAAK;KAAc,aAAa,KAAK;IAAY;IAC1G,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;IAC5D,GAAI,KAAK,gBAAgB,EAAE,eAAe,KAAK,cAAc,IAAI,CAAC;IAClE,GAAI,KAAK,kBAAkB,SAAS,EAAE,kBAAkB,KAAK,iBAAiB,IAAI,CAAC;IACnF,GAAI,KAAK,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,KAAK,WAAW;GACzE;GACA,MAAM,KAAK,MAAM;EACnB;CACF;CAEA,KAAK,MAAM,SAAS,MAAM,QACxB,MAAM,KAAK;EACT,UAAU;EACV,MAAM,MAAM;EACZ,OAAO,MAAM;EACb,QAAQ,YAAY,MAAM,KAAK;EAC/B,QAAQ;EACR,QAAQ,MAAM,gBAAgB;EAC9B,aAAa,MAAM;EACnB,GAAI,MAAM,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,MAAM,SAAS;EACnE,gBAAgB,MAAM;CACxB,CAAC;CAGH,OAAO;AACT"}

package/dist/context-projection.cjs

@@ -0,0 +1,120 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_index = require("./services/toolCost/index.cjs");
+//#region src/services/contextProjection/index.ts
+/**
+* What the session is carrying, and what carrying it costs.
+*
+* Grouped by the mode that admitted each package rather than by where the tool
+* came from, because a mode is the thing a reader can switch off. The mechanism
+* (extension, MCP server, plugin) orders rows inside a group instead, so the
+* expensive thing is still easy to find.
+*
+* Schemas never travel. Only names, kinds, owners and integer counts do, which
+* keeps the payload small enough to republish whenever the composition changes.
+*/
+const CONTEXT_PROJECTION_VERSION = 1;
+/** Journal entry the cockpit reads; mirrored by CONTEXT_ENTRY_TYPE in doompi-web. */
+const DOOM_CONTEXT_ENTRY_TYPE = "doom-context";
+/** The tokenizer these counts came from, so a reader can judge them. */
+const CONTEXT_PROJECTION_ESTIMATOR = "gpt-tokenizer";
+/** Everything the runtime could not attribute lands here rather than vanishing. */
+const CORE_GROUP = "core";
+/** Pi's own tools have no package; the runtime itself is the owner. */
+const CORE_OWNER = "pi";
+const KIND_ORDER = {
+	major: 0,
+	minor: 1,
+	domain: 2,
+	core: 3
+};
+const SOURCE_ORDER = {
+	extension: 0,
+	mcp: 1,
+	plugin: 2,
+	core: 3
+};
+function skillSource(group) {
+	if (group === "plugins") return "plugin";
+	if (group === "extensions") return "extension";
+	return "core";
+}
+function byRow(left, right) {
+	return SOURCE_ORDER[left.source] - SOURCE_ORDER[right.source] || left.name.localeCompare(right.name);
+}
+function projectContext(input) {
+	const buckets = /* @__PURE__ */ new Map();
+	const declare = (id, label, kind) => {
+		if (!buckets.has(id)) buckets.set(id, {
+			kind,
+			label,
+			items: []
+		});
+	};
+	if (input.majorMode) declare(input.majorMode, input.majorMode, "major");
+	for (const group of input.groups) declare(group.id, group.label, group.kind);
+	for (const domain of input.domains) declare(domain, domain, "domain");
+	const place = (owner, item, conditional) => {
+		const attributed = conditional ?? input.attribution[owner];
+		const id = attributed?.mode ?? CORE_GROUP;
+		const kind = attributed?.kind ?? "core";
+		declare(id, attributed && "label" in attributed ? attributed.label ?? id : id, kind);
+		buckets.get(id)?.items.push(item);
+	};
+	for (const source of input.sources) {
+		const owner = source.kind === "extension" ? source.packageName ?? source.key : source.kind === "mcp" ? source.key.slice(4) : CORE_OWNER;
+		for (const tool of source.tools) {
+			const cost = require_index.tokensForTool(tool, input.countTokens);
+			const item = {
+				name: tool.name,
+				itemKind: "tool",
+				source: source.kind === "core" ? "core" : source.kind,
+				owner,
+				tokens: cost.totalTokens,
+				active: tool.active
+			};
+			if (source.kind === "core") {
+				declare(CORE_GROUP, CORE_GROUP, "core");
+				buckets.get(CORE_GROUP)?.items.push(item);
+			} else place(owner, item, tool.contextAttribution);
+		}
+	}
+	for (const skill of input.skills) place(skill.owner, {
+		name: skill.name,
+		itemKind: "skill",
+		source: skillSource(skill.group),
+		owner: skill.owner,
+		tokens: skill.promptTokens ?? 0,
+		active: true
+	}, skill.contextAttribution);
+	const groups = [...buckets.entries()].map(([id, bucket]) => {
+		const items = [...bucket.items].sort(byRow);
+		return {
+			id,
+			label: bucket.label,
+			kind: bucket.kind,
+			items,
+			tokens: items.reduce((total, item) => total + (item.active ? item.tokens : 0), 0),
+			inactiveTokens: items.reduce((total, item) => total + (item.active ? 0 : item.tokens), 0)
+		};
+	}).sort((left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind] || left.label.localeCompare(right.label));
+	return {
+		version: 1,
+		revision: input.revision,
+		selection: {
+			majorMode: input.majorMode,
+			domains: [...input.domains],
+			...input.profile === void 0 ? {} : { profile: input.profile }
+		},
+		groups,
+		totalTokens: groups.reduce((total, group) => total + group.tokens, 0),
+		inactiveTokens: groups.reduce((total, group) => total + group.inactiveTokens, 0),
+		estimator: CONTEXT_PROJECTION_ESTIMATOR
+	};
+}
+//#endregion
+exports.CONTEXT_PROJECTION_ESTIMATOR = CONTEXT_PROJECTION_ESTIMATOR;
+exports.CONTEXT_PROJECTION_VERSION = CONTEXT_PROJECTION_VERSION;
+exports.DOOM_CONTEXT_ENTRY_TYPE = DOOM_CONTEXT_ENTRY_TYPE;
+exports.projectContext = projectContext;
+
+//# sourceMappingURL=context-projection.cjs.map

package/dist/context-projection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-projection.cjs","names":["tokensForTool"],"sources":["../src/services/contextProjection/index.ts"],"sourcesContent":["/** What admitted a package into the composition. */\nexport interface PackageAttribution {\n  /** `major` for a layer package, `domain` for a plugin a domain carries. */\n  kind: 'major' | 'domain';\n  /** The major mode name, or the domain name. */\n  mode: string;\n  /** The layer the package was listed under; absent for a domain plugin. */\n  layer?: string;\n}\n\nimport { type CountTokens, type ToolEntry, type ToolSource, tokensForTool } from '../toolInventory';\n\n/**\n * What the session is carrying, and what carrying it costs.\n *\n * Grouped by the mode that admitted each package rather than by where the tool\n * came from, because a mode is the thing a reader can switch off. The mechanism\n * (extension, MCP server, plugin) orders rows inside a group instead, so the\n * expensive thing is still easy to find.\n *\n * Schemas never travel. Only names, kinds, owners and integer counts do, which\n * keeps the payload small enough to republish whenever the composition changes.\n */\nexport const CONTEXT_PROJECTION_VERSION = 1;\n\n/** Journal entry the cockpit reads; mirrored by CONTEXT_ENTRY_TYPE in doompi-web. */\nexport const DOOM_CONTEXT_ENTRY_TYPE = 'doom-context';\n\n/** The tokenizer these counts came from, so a reader can judge them. */\nexport const CONTEXT_PROJECTION_ESTIMATOR = 'gpt-tokenizer';\n\nexport type ContextGroupKind = 'major' | 'minor' | 'domain' | 'core';\nexport type ContextItemSource = 'extension' | 'mcp' | 'plugin' | 'core';\n\n/** Everything the runtime could not attribute lands here rather than vanishing. */\nconst CORE_GROUP = 'core';\n/** Pi's own tools have no package; the runtime itself is the owner. */\nconst CORE_OWNER = 'pi';\nconst MCP_KEY_PREFIX = 'mcp:';\n\nconst KIND_ORDER: Record<ContextGroupKind, number> = { major: 0, minor: 1, domain: 2, core: 3 };\nconst SOURCE_ORDER: Record<ContextItemSource, number> = { extension: 0, mcp: 1, plugin: 2, core: 3 };\n\nexport interface ContextItemProjection {\n  readonly name: string;\n  readonly itemKind: 'tool' | 'skill';\n  readonly source: ContextItemSource;\n  /** The package, server, or plugin that registered it. */\n  readonly owner: string;\n  readonly tokens: number;\n  readonly active: boolean;\n}\n\nexport interface ContextGroupProjection {\n  readonly id: string;\n  readonly label: string;\n  readonly kind: ContextGroupKind;\n  readonly items: readonly ContextItemProjection[];\n  /** What the group costs now: active items only. */\n  readonly tokens: number;\n  /** What its gated items would add if switched on. */\n  readonly inactiveTokens: number;\n}\n\nexport interface ContextProjection {\n  readonly version: typeof CONTEXT_PROJECTION_VERSION;\n  readonly revision: number;\n  /** Selection snapshot used to build this projection, replayable after reconnect. */\n  readonly selection: {\n    readonly majorMode: string;\n    readonly domains: readonly string[];\n    readonly profile?: string;\n  };\n  readonly groups: readonly ContextGroupProjection[];\n  readonly totalTokens: number;\n  readonly inactiveTokens: number;\n  readonly estimator: typeof CONTEXT_PROJECTION_ESTIMATOR;\n}\n\nexport interface ContextConditionalAttribution {\n  readonly kind: 'minor' | 'domain';\n  readonly mode: string;\n  readonly label?: string;\n}\n\nexport interface ContextToolInventory extends ToolEntry {\n  /** A contribution-level gate is more specific than its package's major-mode owner. */\n  readonly contextAttribution?: ContextConditionalAttribution;\n}\n\nexport interface ContextToolSource extends Omit<ToolSource, 'tools'> {\n  readonly tools: readonly ContextToolInventory[];\n}\n\n/** Skill fields needed to project cost and serve detail. Virtual resources may not have a filesystem path. */\nexport interface ContextSkillInventory {\n  readonly name: string;\n  readonly description: string;\n  readonly group: 'extensions' | 'help' | 'plugins' | 'default';\n  readonly owner: string;\n  readonly modelInvocable: boolean;\n  readonly promptTokens?: number;\n  readonly filePath?: string;\n  readonly contextAttribution?: ContextConditionalAttribution;\n}\n\nexport interface ContextProjectionInput {\n  readonly revision: number;\n  readonly majorMode: string;\n  readonly profile?: string;\n  /** Additional groups supplied by the composition owner, in display order. */\n  readonly groups: readonly { readonly id: string; readonly label: string; readonly kind: ContextGroupKind }[];\n  /** Domains the composition resolved under, whether or not they carried a plugin. */\n  readonly domains: readonly string[];\n  readonly sources: readonly ContextToolSource[];\n  readonly skills: readonly ContextSkillInventory[];\n  /**\n   * Owner identifier to the mode that admitted it.\n   *\n   * Keys are package names for extensions and layer packages, and plugin or\n   * server names for anything a domain carries. The caller owns this join\n   * because only it knows how a given deployment resolved its plugins.\n   */\n  readonly attribution: Readonly<Record<string, PackageAttribution>>;\n  readonly countTokens: CountTokens;\n}\n\ninterface Bucket {\n  kind: ContextGroupKind;\n  label: string;\n  items: ContextItemProjection[];\n}\n\nfunction skillSource(group: ContextSkillInventory['group']): ContextItemSource {\n  if (group === 'plugins') return 'plugin';\n  if (group === 'extensions') return 'extension';\n  return 'core';\n}\n\nfunction byRow(left: ContextItemProjection, right: ContextItemProjection): number {\n  return SOURCE_ORDER[left.source] - SOURCE_ORDER[right.source] || left.name.localeCompare(right.name);\n}\n\nexport function projectContext(input: ContextProjectionInput): ContextProjection {\n  const buckets = new Map<string, Bucket>();\n\n  // Declared before anything is placed, so a mode with nothing attributed to it\n  // still appears. An empty group is a fact worth showing: it says the mode is\n  // on and cheap, not that the runtime forgot about it.\n  const declare = (id: string, label: string, kind: ContextGroupKind): void => {\n    if (!buckets.has(id)) buckets.set(id, { kind, label, items: [] });\n  };\n  if (input.majorMode) declare(input.majorMode, input.majorMode, 'major');\n  for (const group of input.groups) declare(group.id, group.label, group.kind);\n  // A domain that contributed no plugin is still part of what the session is\n  // running under, and a reader comparing the panel against the footer would\n  // otherwise read its absence as the panel being out of date.\n  for (const domain of input.domains) declare(domain, domain, 'domain');\n\n  const place = (owner: string, item: ContextItemProjection, conditional?: ContextConditionalAttribution): void => {\n    const attributed = conditional ?? input.attribution[owner];\n    const id = attributed?.mode ?? CORE_GROUP;\n    const kind = attributed?.kind ?? 'core';\n    declare(id, attributed && 'label' in attributed ? (attributed.label ?? id) : id, kind);\n    buckets.get(id)?.items.push(item);\n  };\n\n  for (const source of input.sources) {\n    // An extension is owned by its package, an MCP tool by the server that\n    // advertised it. `label` is display text like `scaffold · mcp`, so the\n    // identifier comes from the key instead: an owner is joined on, not read.\n    const owner =\n      source.kind === 'extension'\n        ? (source.packageName ?? source.key)\n        : source.kind === 'mcp'\n          ? source.key.slice(MCP_KEY_PREFIX.length)\n          : CORE_OWNER;\n    for (const tool of source.tools) {\n      const cost = tokensForTool(tool, input.countTokens);\n      const item: ContextItemProjection = {\n        name: tool.name,\n        itemKind: 'tool',\n        source: source.kind === 'core' ? 'core' : source.kind,\n        owner,\n        tokens: cost.totalTokens,\n        active: tool.active,\n      };\n      if (source.kind === 'core') {\n        declare(CORE_GROUP, CORE_GROUP, 'core');\n        buckets.get(CORE_GROUP)?.items.push(item);\n      } else {\n        place(owner, item, tool.contextAttribution);\n      }\n    }\n  }\n\n  for (const skill of input.skills) {\n    place(\n      skill.owner,\n      {\n        name: skill.name,\n        itemKind: 'skill',\n        source: skillSource(skill.group),\n        owner: skill.owner,\n        tokens: skill.promptTokens ?? 0,\n        // A skill is always offered to the model; there is no inactive state for\n        // it the way there is for a tool Pi has filtered out.\n        active: true,\n      },\n      skill.contextAttribution,\n    );\n  }\n\n  const groups: ContextGroupProjection[] = [...buckets.entries()]\n    .map(([id, bucket]) => {\n      const items = [...bucket.items].sort(byRow);\n      // Only what is actually sent counts. Pi builds the prompt from its\n      // active tools, so a gated one costs nothing until it is switched on,\n      // and folding it into the total would overstate the bill by a third.\n      return {\n        id,\n        label: bucket.label,\n        kind: bucket.kind,\n        items,\n        tokens: items.reduce((total, item) => total + (item.active ? item.tokens : 0), 0),\n        inactiveTokens: items.reduce((total, item) => total + (item.active ? 0 : item.tokens), 0),\n      };\n    })\n    .sort((left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind] || left.label.localeCompare(right.label));\n\n  return {\n    version: CONTEXT_PROJECTION_VERSION,\n    revision: input.revision,\n    selection: {\n      majorMode: input.majorMode,\n      domains: [...input.domains],\n      ...(input.profile === undefined ? {} : { profile: input.profile }),\n    },\n    groups,\n    totalTokens: groups.reduce((total, group) => total + group.tokens, 0),\n    inactiveTokens: groups.reduce((total, group) => total + group.inactiveTokens, 0),\n    estimator: CONTEXT_PROJECTION_ESTIMATOR,\n  };\n}\n"],"mappings":"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"}

package/dist/context-projection.d.cts

@@ -0,0 +1,113 @@
+import { CountTokens } from "./services/toolCost/index.cjs";
+import { ToolEntry, ToolSource } from "./tool-inventory.cjs";
+//#region src/services/contextProjection/index.d.ts
+/** What admitted a package into the composition. */
+export interface PackageAttribution {
+  /** `major` for a layer package, `domain` for a plugin a domain carries. */
+  kind: 'major' | 'domain';
+  /** The major mode name, or the domain name. */
+  mode: string;
+  /** The layer the package was listed under; absent for a domain plugin. */
+  layer?: string;
+}
+/**
+ * What the session is carrying, and what carrying it costs.
+ *
+ * Grouped by the mode that admitted each package rather than by where the tool
+ * came from, because a mode is the thing a reader can switch off. The mechanism
+ * (extension, MCP server, plugin) orders rows inside a group instead, so the
+ * expensive thing is still easy to find.
+ *
+ * Schemas never travel. Only names, kinds, owners and integer counts do, which
+ * keeps the payload small enough to republish whenever the composition changes.
+ */
+export declare const CONTEXT_PROJECTION_VERSION = 1;
+/** Journal entry the cockpit reads; mirrored by CONTEXT_ENTRY_TYPE in doompi-web. */
+export declare const DOOM_CONTEXT_ENTRY_TYPE = "doom-context";
+/** The tokenizer these counts came from, so a reader can judge them. */
+export declare const CONTEXT_PROJECTION_ESTIMATOR = "gpt-tokenizer";
+export type ContextGroupKind = 'major' | 'minor' | 'domain' | 'core';
+export type ContextItemSource = 'extension' | 'mcp' | 'plugin' | 'core';
+export interface ContextItemProjection {
+  readonly name: string;
+  readonly itemKind: 'tool' | 'skill';
+  readonly source: ContextItemSource;
+  /** The package, server, or plugin that registered it. */
+  readonly owner: string;
+  readonly tokens: number;
+  readonly active: boolean;
+}
+export interface ContextGroupProjection {
+  readonly id: string;
+  readonly label: string;
+  readonly kind: ContextGroupKind;
+  readonly items: readonly ContextItemProjection[];
+  /** What the group costs now: active items only. */
+  readonly tokens: number;
+  /** What its gated items would add if switched on. */
+  readonly inactiveTokens: number;
+}
+export interface ContextProjection {
+  readonly version: typeof CONTEXT_PROJECTION_VERSION;
+  readonly revision: number;
+  /** Selection snapshot used to build this projection, replayable after reconnect. */
+  readonly selection: {
+    readonly majorMode: string;
+    readonly domains: readonly string[];
+    readonly profile?: string;
+  };
+  readonly groups: readonly ContextGroupProjection[];
+  readonly totalTokens: number;
+  readonly inactiveTokens: number;
+  readonly estimator: typeof CONTEXT_PROJECTION_ESTIMATOR;
+}
+export interface ContextConditionalAttribution {
+  readonly kind: 'minor' | 'domain';
+  readonly mode: string;
+  readonly label?: string;
+}
+export interface ContextToolInventory extends ToolEntry {
+  /** A contribution-level gate is more specific than its package's major-mode owner. */
+  readonly contextAttribution?: ContextConditionalAttribution;
+}
+export interface ContextToolSource extends Omit<ToolSource, 'tools'> {
+  readonly tools: readonly ContextToolInventory[];
+}
+/** Skill fields needed to project cost and serve detail. Virtual resources may not have a filesystem path. */
+export interface ContextSkillInventory {
+  readonly name: string;
+  readonly description: string;
+  readonly group: 'extensions' | 'help' | 'plugins' | 'default';
+  readonly owner: string;
+  readonly modelInvocable: boolean;
+  readonly promptTokens?: number;
+  readonly filePath?: string;
+  readonly contextAttribution?: ContextConditionalAttribution;
+}
+export interface ContextProjectionInput {
+  readonly revision: number;
+  readonly majorMode: string;
+  readonly profile?: string;
+  /** Additional groups supplied by the composition owner, in display order. */
+  readonly groups: readonly {
+    readonly id: string;
+    readonly label: string;
+    readonly kind: ContextGroupKind;
+  }[];
+  /** Domains the composition resolved under, whether or not they carried a plugin. */
+  readonly domains: readonly string[];
+  readonly sources: readonly ContextToolSource[];
+  readonly skills: readonly ContextSkillInventory[];
+  /**
+   * Owner identifier to the mode that admitted it.
+   *
+   * Keys are package names for extensions and layer packages, and plugin or
+   * server names for anything a domain carries. The caller owns this join
+   * because only it knows how a given deployment resolved its plugins.
+   */
+  readonly attribution: Readonly<Record<string, PackageAttribution>>;
+  readonly countTokens: CountTokens;
+}
+export declare function projectContext(input: ContextProjectionInput): ContextProjection;
+//#endregion
+//# sourceMappingURL=context-projection.d.cts.map

package/dist/context-projection.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-projection.d.cts","names":[],"sources":["../src/services/contextProjection/index.ts"],"mappings":";;;;iBACiB;;EAEf;;EAEA;;EAEA;;;;;;;;;;;;;qBAgBW;;qBAGA;;qBAGA;YAED;YACA;iBAWK;WACN;WACA;WACA,QAAQ;;WAER;WACA;WACA;;iBAGM;WACN;WACA;WACA,MAAM;WACN,gBAAgB;;WAEhB;;WAEA;;iBAGM;WACN,gBAAgB;WAChB;;WAEA;aACE;aACA;aACA;;WAEF,iBAAiB;WACjB;WACA;WACA,kBAAkB;;iBAGZ;WACN;WACA;WACA;;iBAGM,6BAA6B;;WAEnC,qBAAqB;;iBAGf,0BAA0B,KAAK;WACrC,gBAAgB;;;iBAIV;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA,qBAAqB;;iBAGf;WACN;WACA;WACA;;WAEA;aAA4B;aAAqB;aAAwB,MAAM;;;WAE/E;WACA,kBAAkB;WAClB,iBAAiB;;;;;;;;WAQjB,aAAa,SAAS,eAAe;WACrC,aAAa;;wBAmBR,eAAe,OAAO,yBAAyB"}