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

package/dist/sessionProtocol.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sessionProtocol = require("./src/schemas/sessionProtocol.cjs");
+exports.DOOM_COCKPIT_SERVER_ID = require_sessionProtocol.DOOM_COCKPIT_SERVER_ID;
+exports.DOOM_SESSION_MANAGEMENT_SERVICE_ID = require_sessionProtocol.DOOM_SESSION_MANAGEMENT_SERVICE_ID;
+exports.DOOM_SESSION_SERVICE_ID = require_sessionProtocol.DOOM_SESSION_SERVICE_ID;
+exports.DoomHubService = require_sessionProtocol.DoomHubService;
+exports.DoomSessionManagementService = require_sessionProtocol.DoomSessionManagementService;
+exports.DoomSessionService = require_sessionProtocol.DoomSessionService;

package/dist/sessionProtocol.d.mts

@@ -0,0 +1,3 @@
+import { DoomContentBlock, DoomSessionStopReason, DoomSessionUpdate, DoomSessionUpdateEvent, DoomToolCallStatus } from "./src/schemas/sessionUpdates.mjs";
+import { AssistantTranscriptItem, ClearQueueResult, DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, ModelRef, PromoteQueuedArgs, PromptArgs, ProtocolEvent, QueuedItemArgs, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem } from "./src/schemas/sessionProtocol.mjs";
+export { AssistantTranscriptItem, ClearQueueResult, DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomContentBlock, DoomHubService, DoomSessionManagementService, DoomSessionService, DoomSessionStopReason, DoomSessionUpdate, DoomSessionUpdateEvent, DoomToolCallStatus, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, ModelRef, PromoteQueuedArgs, PromptArgs, ProtocolEvent, QueuedItemArgs, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem };

package/dist/sessionProtocol.mjs

@@ -0,0 +1,2 @@
+import { DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService } from "./src/schemas/sessionProtocol.mjs";
+export { DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService };

package/dist/skills.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_skills = require("./src/schemas/skills.cjs");
+exports.DOOM_RESOURCE_CATALOG_ENTRY_TYPE = require_skills.DOOM_RESOURCE_CATALOG_ENTRY_TYPE;
+exports.DOOM_SKILL_SOURCES_SERVICE = require_skills.DOOM_SKILL_SOURCES_SERVICE;
+exports.SkillSourceContributionSchema = require_skills.SkillSourceContributionSchema;
+exports.SkillSourceNameSchema = require_skills.SkillSourceNameSchema;
+exports.createDoomSkillSourcesService = require_skills.createDoomSkillSourcesService;
+exports.readDoomSkillSourcesService = require_skills.readDoomSkillSourcesService;
+exports.requireDoomSkillSourcesService = require_skills.requireDoomSkillSourcesService;

package/dist/skills.d.mts

@@ -0,0 +1,2 @@
+import { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, DoomSkillSourcesService, ResourceCatalogProjection, SkillSourceContribution, SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService } from "./src/schemas/skills.mjs";
+export { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, type DoomSkillSourcesService, type ResourceCatalogProjection, type SkillSourceContribution, type SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService };

package/dist/skills.mjs

@@ -0,0 +1,2 @@
+import { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService } from "./src/schemas/skills.mjs";
+export { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService };

package/dist/sqliteSessionStorage.cjs

@@ -0,0 +1,168 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+let node_crypto = require("node:crypto");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_sqlite = require("node:sqlite");
+let _earendil_works_pi_durable = require("@earendil-works/pi-durable");
+let _earendil_works_chord_context = require("@earendil-works/chord/context");
+let _earendil_works_pi_durable_storage_sqlite = require("@earendil-works/pi-durable/storage/sqlite");
+let _earendil_works_pi_durable_storage_sqlite_node = require("@earendil-works/pi-durable/storage/sqlite/node");
+//#region src/services/sqliteSessionStorage/index.ts
+const DURABLE_BACKGROUND_CONTEXT = _earendil_works_chord_context.BACKGROUND_CONTEXT;
+const DURABLE_DIRECTORY = "durable-v1";
+/** Public string identity belongs to Doom, not the durable numeric ID namespace. */
+const SessionIdentityDoc = (0, _earendil_works_pi_durable.defineDoc)({
+	kind: "po.session.identity",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		id: "",
+		createdAt: 0,
+		parentSessionId: ""
+	})
+});
+const SessionMetadataDoc = (0, _earendil_works_pi_durable.defineDoc)({
+	kind: "po.session.metadata",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		name: "",
+		workspaceRoot: "",
+		execution: "",
+		laneName: "main"
+	})
+});
+/** Validate existing files without admitting a writer or applying schema upgrades. */
+function validateDurableSessionFile(file) {
+	const database = new node_sqlite.DatabaseSync(file, { readOnly: true });
+	try {
+		if (database.prepare("SELECT version FROM durable_schema WHERE singleton = 1").get()?.version !== 1) throw new Error("Unsupported durable SQLite schema");
+		const tables = database.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all();
+		for (const name of [
+			"durable_metadata",
+			"record_ids",
+			"conversations",
+			"entries",
+			"tasks",
+			"submissions",
+			"documents",
+			"document_revisions"
+		]) if (!tables.some((table) => table.name === name)) throw new Error("Invalid durable SQLite schema");
+	} catch (cause) {
+		throw new Error("Unsupported or legacy SQLite session format", { cause });
+	} finally {
+		database.close();
+	}
+}
+/** Completed histories use a read-only connection. Initialization cannot write or migrate. */
+async function openReadOnlyDurableStorage(file) {
+	validateDurableSessionFile(file);
+	const native = new node_sqlite.DatabaseSync(file, { readOnly: true });
+	const database = new _earendil_works_pi_durable_storage_sqlite_node.NodeSqliteDatabase(native);
+	let closed = false;
+	const close = async () => {
+		if (closed) return;
+		native.close();
+		closed = true;
+	};
+	try {
+		return await _earendil_works_pi_durable_storage_sqlite.SqliteStorage.open({
+			exec: (sql) => database.exec(sql),
+			run: (sql, ...params) => database.run(sql, ...params),
+			get: (sql, ...params) => database.get(sql, ...params),
+			all: (sql, ...params) => database.all(sql, ...params),
+			close,
+			transaction: (callback) => callback({
+				exec: async (sql) => {
+					if (!/^CREATE TABLE IF NOT EXISTS durable_schema\s/u.test(sql)) throw new Error("Read-only durable storage");
+				},
+				run: async (sql) => {
+					if (sql !== "INSERT OR IGNORE INTO durable_schema (singleton, version) VALUES (1, 0)") throw new Error("Read-only durable storage");
+				},
+				get: (sql, ...params) => database.get(sql, ...params),
+				all: (sql, ...params) => database.all(sql, ...params)
+			})
+		});
+	} catch (error) {
+		try {
+			await close();
+		} catch (cleanupError) {
+			throw new AggregateError([error, cleanupError], "Read-only storage initialization cleanup failed");
+		}
+		throw error;
+	}
+}
+/** Opens the one fresh-format SQLite container owned by a server session. */
+async function openSqliteSessionStorage(options, context) {
+	if (!options.historyOwnership) throw new Error("SQLite sessions require explicit HistoryOwnership");
+	if (!options.sessionsRoot && !options.sessionPath) throw new Error("SQLite sessions require a server data directory");
+	const id = options.sessionId ?? (options.sessionPath ? node_path.default.basename(options.sessionPath, ".sqlite") : (0, node_crypto.randomUUID)());
+	if (!/^[a-zA-Z0-9_-]+$/u.test(id)) throw new Error("Invalid SQLite session id");
+	const sessionFile = node_path.default.resolve(options.sessionPath ?? node_path.default.join(options.sessionsRoot, "durable-v1", `${id}.sqlite`));
+	if (node_path.default.basename(node_path.default.dirname(sessionFile)) !== "durable-v1" || node_path.default.extname(sessionFile) !== ".sqlite") throw new Error("Unsupported or legacy SQLite session path");
+	const existing = node_fs.default.existsSync(sessionFile);
+	if (!existing && options.sessionsRoot && node_fs.default.existsSync(node_path.default.join(options.sessionsRoot, `${id}.sqlite`))) throw new Error("Legacy SQLite sessions are unsupported by fresh durable storage");
+	if (options.sessionPath && !existing) throw new Error(`SQLite session not found: ${sessionFile}`);
+	if (existing) validateDurableSessionFile(sessionFile);
+	node_fs.default.mkdirSync(node_path.default.dirname(sessionFile), {
+		recursive: true,
+		mode: 448
+	});
+	const historyLease = await options.historyOwnership.acquire(sessionFile);
+	let storage;
+	let database;
+	let writerOpenAttempted = false;
+	try {
+		await historyLease.assertQuiescent();
+		if (node_fs.default.existsSync(sessionFile)) validateDurableSessionFile(sessionFile);
+		writerOpenAttempted = true;
+		database = await (0, _earendil_works_pi_durable_storage_sqlite_node.openNodeSqliteDatabase)(sessionFile);
+		storage = await _earendil_works_pi_durable_storage_sqlite.SqliteStorage.open(database);
+		const session = (0, _earendil_works_pi_durable.createSession)(storage);
+		const identity = await session.snapshot(SessionIdentityDoc, context);
+		if (existing && (!identity || identity.id !== id)) throw new Error("SQLite session id does not match the requested session");
+		if (!existing) {
+			await session.commit(async (tx) => {
+				const doc = await tx.doc(SessionIdentityDoc);
+				doc.id = id;
+				doc.createdAt = Date.now();
+				doc.parentSessionId = options.parentSessionId ?? "";
+			}, context);
+			node_fs.default.chmodSync(sessionFile, 384);
+		}
+		return {
+			storage,
+			session,
+			sessionFile,
+			repository: { close: (closeContext = context) => session.close(closeContext) },
+			historyLease
+		};
+	} catch (error) {
+		if (writerOpenAttempted && !database) throw error;
+		try {
+			if (storage) await storage.close(context);
+			else if (database) await database.close();
+		} catch (cleanupError) {
+			throw new AggregateError([error, cleanupError], "SQLite storage initialization cleanup failed");
+		}
+		try {
+			await historyLease.release();
+		} catch (cleanupError) {
+			throw new AggregateError([error, cleanupError], "SQLite storage ownership cleanup failed");
+		}
+		throw error;
+	}
+}
+//#endregion
+exports.DURABLE_BACKGROUND_CONTEXT = DURABLE_BACKGROUND_CONTEXT;
+exports.DURABLE_DIRECTORY = DURABLE_DIRECTORY;
+exports.SessionIdentityDoc = SessionIdentityDoc;
+exports.SessionMetadataDoc = SessionMetadataDoc;
+exports.openReadOnlyDurableStorage = openReadOnlyDurableStorage;
+exports.openSqliteSessionStorage = openSqliteSessionStorage;
+exports.validateDurableSessionFile = validateDurableSessionFile;
+
+//# sourceMappingURL=sqliteSessionStorage.cjs.map

package/dist/sqliteSessionStorage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteSessionStorage.cjs","names":["BACKGROUND_CONTEXT","defineDoc","DatabaseSync","NodeSqliteDatabase","SqliteStorage","path","randomUUID","fs","openNodeSqliteDatabase","createSession"],"sources":["../src/services/sqliteSessionStorage/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { DatabaseSync } from 'node:sqlite';\n\nimport type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport { createSession, defineDoc, type Storage } from '@earendil-works/pi-durable';\nimport { SqliteStorage } from '@earendil-works/pi-durable/storage/sqlite';\nimport { NodeSqliteDatabase, openNodeSqliteDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { DirectHarnessRuntimeOptions } from '../../types/server/directHarnessRuntime';\n\nexport const DURABLE_BACKGROUND_CONTEXT = BACKGROUND_CONTEXT;\n\nexport const DURABLE_DIRECTORY = 'durable-v1';\n/** Public string identity belongs to Doom, not the durable numeric ID namespace. */\nexport const SessionIdentityDoc = defineDoc({\n  kind: 'po.session.identity',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ id: '', createdAt: 0, parentSessionId: '' }),\n});\nexport const SessionMetadataDoc = defineDoc({\n  kind: 'po.session.metadata',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ name: '', workspaceRoot: '', execution: '', laneName: 'main' }),\n});\n\n/** Validate existing files without admitting a writer or applying schema upgrades. */\nexport function validateDurableSessionFile(file: string): void {\n  const database = new DatabaseSync(file, { readOnly: true });\n  try {\n    const schema = database.prepare('SELECT version FROM durable_schema WHERE singleton = 1').get();\n    if (schema?.version !== 1) throw new Error('Unsupported durable SQLite schema');\n    const tables = database.prepare(\"SELECT name FROM sqlite_master WHERE type = 'table'\").all();\n    for (const name of [\n      'durable_metadata',\n      'record_ids',\n      'conversations',\n      'entries',\n      'tasks',\n      'submissions',\n      'documents',\n      'document_revisions',\n    ]) {\n      if (!tables.some((table) => table.name === name)) throw new Error('Invalid durable SQLite schema');\n    }\n  } catch (cause) {\n    throw new Error('Unsupported or legacy SQLite session format', { cause });\n  } finally {\n    database.close();\n  }\n}\n\n/** Completed histories use a read-only connection. Initialization cannot write or migrate. */\nexport async function openReadOnlyDurableStorage(file: string): Promise<Storage> {\n  validateDurableSessionFile(file);\n  const native = new DatabaseSync(file, { readOnly: true });\n  const database = new NodeSqliteDatabase(native);\n  let closed = false;\n  const close = async () => {\n    if (closed) return;\n    // The writer adapter checkpoints WAL on close, which read-only connections cannot do.\n    native.close();\n    closed = true;\n  };\n  try {\n    const storage = await SqliteStorage.open({\n      exec: (sql) => database.exec(sql),\n      run: (sql, ...params) => database.run(sql, ...params),\n      get: (sql, ...params) => database.get(sql, ...params),\n      all: (sql, ...params) => database.all(sql, ...params),\n      close,\n      transaction: (callback) =>\n        callback({\n          exec: async (sql) => {\n            if (!/^CREATE TABLE IF NOT EXISTS durable_schema\\s/u.test(sql))\n              throw new Error('Read-only durable storage');\n          },\n          run: async (sql) => {\n            if (sql !== 'INSERT OR IGNORE INTO durable_schema (singleton, version) VALUES (1, 0)')\n              throw new Error('Read-only durable storage');\n          },\n          get: (sql, ...params) => database.get(sql, ...params),\n          all: (sql, ...params) => database.all(sql, ...params),\n        }),\n    });\n    return storage;\n  } catch (error) {\n    try {\n      await close();\n    } catch (cleanupError) {\n      throw new AggregateError([error, cleanupError], 'Read-only storage initialization cleanup failed');\n    }\n    throw error;\n  }\n}\n\n/** Opens the one fresh-format SQLite container owned by a server session. */\nexport async function openSqliteSessionStorage(\n  options: Pick<\n    DirectHarnessRuntimeOptions,\n    'historyOwnership' | 'sessionsRoot' | 'sessionPath' | 'sessionId' | 'parentSessionId'\n  >,\n  context: Context,\n) {\n  if (!options.historyOwnership) throw new Error('SQLite sessions require explicit HistoryOwnership');\n  if (!options.sessionsRoot && !options.sessionPath) throw new Error('SQLite sessions require a server data directory');\n  const id = options.sessionId ?? (options.sessionPath ? path.basename(options.sessionPath, '.sqlite') : randomUUID());\n  if (!/^[a-zA-Z0-9_-]+$/u.test(id)) throw new Error('Invalid SQLite session id');\n  const sessionFile = path.resolve(\n    options.sessionPath ?? path.join(options.sessionsRoot!, DURABLE_DIRECTORY, `${id}.sqlite`),\n  );\n  if (path.basename(path.dirname(sessionFile)) !== DURABLE_DIRECTORY || path.extname(sessionFile) !== '.sqlite')\n    throw new Error('Unsupported or legacy SQLite session path');\n  const existing = fs.existsSync(sessionFile);\n  if (!existing && options.sessionsRoot && fs.existsSync(path.join(options.sessionsRoot, `${id}.sqlite`)))\n    throw new Error('Legacy SQLite sessions are unsupported by fresh durable storage');\n  if (options.sessionPath && !existing) throw new Error(`SQLite session not found: ${sessionFile}`);\n  if (existing) validateDurableSessionFile(sessionFile);\n  fs.mkdirSync(path.dirname(sessionFile), { recursive: true, mode: 0o700 });\n  const historyLease = await options.historyOwnership.acquire(sessionFile);\n  let storage: Storage | undefined;\n  let database: NodeSqliteDatabase | undefined;\n  let writerOpenAttempted = false;\n  try {\n    await historyLease.assertQuiescent();\n    if (fs.existsSync(sessionFile)) validateDurableSessionFile(sessionFile);\n    writerOpenAttempted = true;\n    database = await openNodeSqliteDatabase(sessionFile);\n    storage = await SqliteStorage.open(database);\n    const session = createSession(storage);\n    const identity = await session.snapshot(SessionIdentityDoc, context);\n    if (existing && (!identity || identity.id !== id))\n      throw new Error('SQLite session id does not match the requested session');\n    if (!existing) {\n      await session.commit(async (tx) => {\n        const doc = await tx.doc(SessionIdentityDoc);\n        doc.id = id;\n        doc.createdAt = Date.now();\n        doc.parentSessionId = options.parentSessionId ?? '';\n      }, context);\n      fs.chmodSync(sessionFile, 0o600);\n    }\n    const repository = { close: (closeContext: Context = context) => session.close(closeContext) };\n    return { storage, session, sessionFile, repository, historyLease };\n  } catch (error) {\n    // ponytail: An upstream open rejection has no closure receipt, so retain ownership until shutdown is confirmed.\n    if (writerOpenAttempted && !database) throw error;\n    try {\n      if (storage) await storage.close(context);\n      else if (database) await database.close();\n    } catch (cleanupError) {\n      throw new AggregateError([error, cleanupError], 'SQLite storage initialization cleanup failed');\n    }\n    try {\n      await historyLease.release();\n    } catch (cleanupError) {\n      throw new AggregateError([error, cleanupError], 'SQLite storage ownership cleanup failed');\n    }\n    throw error;\n  }\n}\n"],"mappings":"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"}

package/dist/sqliteSessionStorage.d.mts

@@ -0,0 +1,35 @@
+import { HistoryOwnershipLease } from "./src/services/historyImport/index.mjs";
+import { DirectHarnessRuntimeOptions } from "./src/types/server/directHarnessRuntime.mjs";
+import { Storage } from "@earendil-works/pi-durable";
+import { Context } from "@earendil-works/chord";
+//#region src/services/sqliteSessionStorage/index.d.ts
+export declare const DURABLE_BACKGROUND_CONTEXT: Context;
+export declare const DURABLE_DIRECTORY = "durable-v1";
+/** Public string identity belongs to Doom, not the durable numeric ID namespace. */
+export declare const SessionIdentityDoc: import("@earendil-works/pi-durable").SessionDocToken<{
+  id: string;
+  createdAt: number;
+  parentSessionId: string;
+}>;
+export declare const SessionMetadataDoc: import("@earendil-works/pi-durable").SessionDocToken<{
+  name: string;
+  workspaceRoot: string;
+  execution: string;
+  laneName: string;
+}>;
+/** Validate existing files without admitting a writer or applying schema upgrades. */
+export declare function validateDurableSessionFile(file: string): void;
+/** Completed histories use a read-only connection. Initialization cannot write or migrate. */
+export declare function openReadOnlyDurableStorage(file: string): Promise<Storage>;
+/** Opens the one fresh-format SQLite container owned by a server session. */
+export declare function openSqliteSessionStorage(options: Pick<DirectHarnessRuntimeOptions, 'historyOwnership' | 'sessionsRoot' | 'sessionPath' | 'sessionId' | 'parentSessionId'>, context: Context): Promise<{
+  storage: Storage;
+  session: import("@earendil-works/pi-durable").Session;
+  sessionFile: string;
+  repository: {
+    close: (closeContext?: Context) => Promise<void>;
+  };
+  historyLease: HistoryOwnershipLease;
+}>;
+//#endregion
+//# sourceMappingURL=sqliteSessionStorage.d.mts.map

package/dist/sqliteSessionStorage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteSessionStorage.d.mts","names":["_$___historyImport0.HistoryOwnershipLease"],"sources":["../src/services/sqliteSessionStorage/index.ts"],"mappings":";;;;;qBAaa,4BAA0B;qBAE1B;;qBAEA,yDAAkB;;;;;qBAMlB,yDAAkB;;;;;;;wBAQf,2BAA2B;;wBA0BrB,2BAA2B,eAAe,QAAQ;;wBA4ClD,yBACpB,SAAS,KACP,qHAGF,SAAS,UAAO;;;;;IAwC6B,QAAA,eAAA,YAAO;;gBAAAA"}

package/dist/sqliteSessionStorage.mjs

@@ -0,0 +1,158 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { createSession, defineDoc } from "@earendil-works/pi-durable";
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import { SqliteStorage } from "@earendil-works/pi-durable/storage/sqlite";
+import { NodeSqliteDatabase, openNodeSqliteDatabase } from "@earendil-works/pi-durable/storage/sqlite/node";
+//#region src/services/sqliteSessionStorage/index.ts
+const DURABLE_BACKGROUND_CONTEXT = BACKGROUND_CONTEXT;
+const DURABLE_DIRECTORY = "durable-v1";
+/** Public string identity belongs to Doom, not the durable numeric ID namespace. */
+const SessionIdentityDoc = defineDoc({
+	kind: "po.session.identity",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		id: "",
+		createdAt: 0,
+		parentSessionId: ""
+	})
+});
+const SessionMetadataDoc = defineDoc({
+	kind: "po.session.metadata",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		name: "",
+		workspaceRoot: "",
+		execution: "",
+		laneName: "main"
+	})
+});
+/** Validate existing files without admitting a writer or applying schema upgrades. */
+function validateDurableSessionFile(file) {
+	const database = new DatabaseSync(file, { readOnly: true });
+	try {
+		if (database.prepare("SELECT version FROM durable_schema WHERE singleton = 1").get()?.version !== 1) throw new Error("Unsupported durable SQLite schema");
+		const tables = database.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all();
+		for (const name of [
+			"durable_metadata",
+			"record_ids",
+			"conversations",
+			"entries",
+			"tasks",
+			"submissions",
+			"documents",
+			"document_revisions"
+		]) if (!tables.some((table) => table.name === name)) throw new Error("Invalid durable SQLite schema");
+	} catch (cause) {
+		throw new Error("Unsupported or legacy SQLite session format", { cause });
+	} finally {
+		database.close();
+	}
+}
+/** Completed histories use a read-only connection. Initialization cannot write or migrate. */
+async function openReadOnlyDurableStorage(file) {
+	validateDurableSessionFile(file);
+	const native = new DatabaseSync(file, { readOnly: true });
+	const database = new NodeSqliteDatabase(native);
+	let closed = false;
+	const close = async () => {
+		if (closed) return;
+		native.close();
+		closed = true;
+	};
+	try {
+		return await SqliteStorage.open({
+			exec: (sql) => database.exec(sql),
+			run: (sql, ...params) => database.run(sql, ...params),
+			get: (sql, ...params) => database.get(sql, ...params),
+			all: (sql, ...params) => database.all(sql, ...params),
+			close,
+			transaction: (callback) => callback({
+				exec: async (sql) => {
+					if (!/^CREATE TABLE IF NOT EXISTS durable_schema\s/u.test(sql)) throw new Error("Read-only durable storage");
+				},
+				run: async (sql) => {
+					if (sql !== "INSERT OR IGNORE INTO durable_schema (singleton, version) VALUES (1, 0)") throw new Error("Read-only durable storage");
+				},
+				get: (sql, ...params) => database.get(sql, ...params),
+				all: (sql, ...params) => database.all(sql, ...params)
+			})
+		});
+	} catch (error) {
+		try {
+			await close();
+		} catch (cleanupError) {
+			throw new AggregateError([error, cleanupError], "Read-only storage initialization cleanup failed");
+		}
+		throw error;
+	}
+}
+/** Opens the one fresh-format SQLite container owned by a server session. */
+async function openSqliteSessionStorage(options, context) {
+	if (!options.historyOwnership) throw new Error("SQLite sessions require explicit HistoryOwnership");
+	if (!options.sessionsRoot && !options.sessionPath) throw new Error("SQLite sessions require a server data directory");
+	const id = options.sessionId ?? (options.sessionPath ? path.basename(options.sessionPath, ".sqlite") : randomUUID());
+	if (!/^[a-zA-Z0-9_-]+$/u.test(id)) throw new Error("Invalid SQLite session id");
+	const sessionFile = path.resolve(options.sessionPath ?? path.join(options.sessionsRoot, "durable-v1", `${id}.sqlite`));
+	if (path.basename(path.dirname(sessionFile)) !== "durable-v1" || path.extname(sessionFile) !== ".sqlite") throw new Error("Unsupported or legacy SQLite session path");
+	const existing = fs.existsSync(sessionFile);
+	if (!existing && options.sessionsRoot && fs.existsSync(path.join(options.sessionsRoot, `${id}.sqlite`))) throw new Error("Legacy SQLite sessions are unsupported by fresh durable storage");
+	if (options.sessionPath && !existing) throw new Error(`SQLite session not found: ${sessionFile}`);
+	if (existing) validateDurableSessionFile(sessionFile);
+	fs.mkdirSync(path.dirname(sessionFile), {
+		recursive: true,
+		mode: 448
+	});
+	const historyLease = await options.historyOwnership.acquire(sessionFile);
+	let storage;
+	let database;
+	let writerOpenAttempted = false;
+	try {
+		await historyLease.assertQuiescent();
+		if (fs.existsSync(sessionFile)) validateDurableSessionFile(sessionFile);
+		writerOpenAttempted = true;
+		database = await openNodeSqliteDatabase(sessionFile);
+		storage = await SqliteStorage.open(database);
+		const session = createSession(storage);
+		const identity = await session.snapshot(SessionIdentityDoc, context);
+		if (existing && (!identity || identity.id !== id)) throw new Error("SQLite session id does not match the requested session");
+		if (!existing) {
+			await session.commit(async (tx) => {
+				const doc = await tx.doc(SessionIdentityDoc);
+				doc.id = id;
+				doc.createdAt = Date.now();
+				doc.parentSessionId = options.parentSessionId ?? "";
+			}, context);
+			fs.chmodSync(sessionFile, 384);
+		}
+		return {
+			storage,
+			session,
+			sessionFile,
+			repository: { close: (closeContext = context) => session.close(closeContext) },
+			historyLease
+		};
+	} catch (error) {
+		if (writerOpenAttempted && !database) throw error;
+		try {
+			if (storage) await storage.close(context);
+			else if (database) await database.close();
+		} catch (cleanupError) {
+			throw new AggregateError([error, cleanupError], "SQLite storage initialization cleanup failed");
+		}
+		try {
+			await historyLease.release();
+		} catch (cleanupError) {
+			throw new AggregateError([error, cleanupError], "SQLite storage ownership cleanup failed");
+		}
+		throw error;
+	}
+}
+//#endregion
+export { DURABLE_BACKGROUND_CONTEXT, DURABLE_DIRECTORY, SessionIdentityDoc, SessionMetadataDoc, openReadOnlyDurableStorage, openSqliteSessionStorage, validateDurableSessionFile };
+
+//# sourceMappingURL=sqliteSessionStorage.mjs.map

package/dist/sqliteSessionStorage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteSessionStorage.mjs","names":[],"sources":["../src/services/sqliteSessionStorage/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { DatabaseSync } from 'node:sqlite';\n\nimport type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport { createSession, defineDoc, type Storage } from '@earendil-works/pi-durable';\nimport { SqliteStorage } from '@earendil-works/pi-durable/storage/sqlite';\nimport { NodeSqliteDatabase, openNodeSqliteDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { DirectHarnessRuntimeOptions } from '../../types/server/directHarnessRuntime';\n\nexport const DURABLE_BACKGROUND_CONTEXT = BACKGROUND_CONTEXT;\n\nexport const DURABLE_DIRECTORY = 'durable-v1';\n/** Public string identity belongs to Doom, not the durable numeric ID namespace. */\nexport const SessionIdentityDoc = defineDoc({\n  kind: 'po.session.identity',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ id: '', createdAt: 0, parentSessionId: '' }),\n});\nexport const SessionMetadataDoc = defineDoc({\n  kind: 'po.session.metadata',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ name: '', workspaceRoot: '', execution: '', laneName: 'main' }),\n});\n\n/** Validate existing files without admitting a writer or applying schema upgrades. */\nexport function validateDurableSessionFile(file: string): void {\n  const database = new DatabaseSync(file, { readOnly: true });\n  try {\n    const schema = database.prepare('SELECT version FROM durable_schema WHERE singleton = 1').get();\n    if (schema?.version !== 1) throw new Error('Unsupported durable SQLite schema');\n    const tables = database.prepare(\"SELECT name FROM sqlite_master WHERE type = 'table'\").all();\n    for (const name of [\n      'durable_metadata',\n      'record_ids',\n      'conversations',\n      'entries',\n      'tasks',\n      'submissions',\n      'documents',\n      'document_revisions',\n    ]) {\n      if (!tables.some((table) => table.name === name)) throw new Error('Invalid durable SQLite schema');\n    }\n  } catch (cause) {\n    throw new Error('Unsupported or legacy SQLite session format', { cause });\n  } finally {\n    database.close();\n  }\n}\n\n/** Completed histories use a read-only connection. Initialization cannot write or migrate. */\nexport async function openReadOnlyDurableStorage(file: string): Promise<Storage> {\n  validateDurableSessionFile(file);\n  const native = new DatabaseSync(file, { readOnly: true });\n  const database = new NodeSqliteDatabase(native);\n  let closed = false;\n  const close = async () => {\n    if (closed) return;\n    // The writer adapter checkpoints WAL on close, which read-only connections cannot do.\n    native.close();\n    closed = true;\n  };\n  try {\n    const storage = await SqliteStorage.open({\n      exec: (sql) => database.exec(sql),\n      run: (sql, ...params) => database.run(sql, ...params),\n      get: (sql, ...params) => database.get(sql, ...params),\n      all: (sql, ...params) => database.all(sql, ...params),\n      close,\n      transaction: (callback) =>\n        callback({\n          exec: async (sql) => {\n            if (!/^CREATE TABLE IF NOT EXISTS durable_schema\\s/u.test(sql))\n              throw new Error('Read-only durable storage');\n          },\n          run: async (sql) => {\n            if (sql !== 'INSERT OR IGNORE INTO durable_schema (singleton, version) VALUES (1, 0)')\n              throw new Error('Read-only durable storage');\n          },\n          get: (sql, ...params) => database.get(sql, ...params),\n          all: (sql, ...params) => database.all(sql, ...params),\n        }),\n    });\n    return storage;\n  } catch (error) {\n    try {\n      await close();\n    } catch (cleanupError) {\n      throw new AggregateError([error, cleanupError], 'Read-only storage initialization cleanup failed');\n    }\n    throw error;\n  }\n}\n\n/** Opens the one fresh-format SQLite container owned by a server session. */\nexport async function openSqliteSessionStorage(\n  options: Pick<\n    DirectHarnessRuntimeOptions,\n    'historyOwnership' | 'sessionsRoot' | 'sessionPath' | 'sessionId' | 'parentSessionId'\n  >,\n  context: Context,\n) {\n  if (!options.historyOwnership) throw new Error('SQLite sessions require explicit HistoryOwnership');\n  if (!options.sessionsRoot && !options.sessionPath) throw new Error('SQLite sessions require a server data directory');\n  const id = options.sessionId ?? (options.sessionPath ? path.basename(options.sessionPath, '.sqlite') : randomUUID());\n  if (!/^[a-zA-Z0-9_-]+$/u.test(id)) throw new Error('Invalid SQLite session id');\n  const sessionFile = path.resolve(\n    options.sessionPath ?? path.join(options.sessionsRoot!, DURABLE_DIRECTORY, `${id}.sqlite`),\n  );\n  if (path.basename(path.dirname(sessionFile)) !== DURABLE_DIRECTORY || path.extname(sessionFile) !== '.sqlite')\n    throw new Error('Unsupported or legacy SQLite session path');\n  const existing = fs.existsSync(sessionFile);\n  if (!existing && options.sessionsRoot && fs.existsSync(path.join(options.sessionsRoot, `${id}.sqlite`)))\n    throw new Error('Legacy SQLite sessions are unsupported by fresh durable storage');\n  if (options.sessionPath && !existing) throw new Error(`SQLite session not found: ${sessionFile}`);\n  if (existing) validateDurableSessionFile(sessionFile);\n  fs.mkdirSync(path.dirname(sessionFile), { recursive: true, mode: 0o700 });\n  const historyLease = await options.historyOwnership.acquire(sessionFile);\n  let storage: Storage | undefined;\n  let database: NodeSqliteDatabase | undefined;\n  let writerOpenAttempted = false;\n  try {\n    await historyLease.assertQuiescent();\n    if (fs.existsSync(sessionFile)) validateDurableSessionFile(sessionFile);\n    writerOpenAttempted = true;\n    database = await openNodeSqliteDatabase(sessionFile);\n    storage = await SqliteStorage.open(database);\n    const session = createSession(storage);\n    const identity = await session.snapshot(SessionIdentityDoc, context);\n    if (existing && (!identity || identity.id !== id))\n      throw new Error('SQLite session id does not match the requested session');\n    if (!existing) {\n      await session.commit(async (tx) => {\n        const doc = await tx.doc(SessionIdentityDoc);\n        doc.id = id;\n        doc.createdAt = Date.now();\n        doc.parentSessionId = options.parentSessionId ?? '';\n      }, context);\n      fs.chmodSync(sessionFile, 0o600);\n    }\n    const repository = { close: (closeContext: Context = context) => session.close(closeContext) };\n    return { storage, session, sessionFile, repository, historyLease };\n  } catch (error) {\n    // ponytail: An upstream open rejection has no closure receipt, so retain ownership until shutdown is confirmed.\n    if (writerOpenAttempted && !database) throw error;\n    try {\n      if (storage) await storage.close(context);\n      else if (database) await database.close();\n    } catch (cleanupError) {\n      throw new AggregateError([error, cleanupError], 'SQLite storage initialization cleanup failed');\n    }\n    try {\n      await historyLease.release();\n    } catch (cleanupError) {\n      throw new AggregateError([error, cleanupError], 'SQLite storage ownership cleanup failed');\n    }\n    throw error;\n  }\n}\n"],"mappings":"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"}

package/dist/src/constants/authorTools.cjs

@@ -0,0 +1,10 @@
+//#region src/constants/authorTools.ts
+const AUTHOR_DESCRIBE_TOOL_NAME = "describe_author_tools";
+const AUTHOR_USE_TOOL_NAME = "use_author_tools";
+const AUTHOR_FACADE_TOOL_NAMES = [AUTHOR_DESCRIBE_TOOL_NAME, AUTHOR_USE_TOOL_NAME];
+//#endregion
+exports.AUTHOR_DESCRIBE_TOOL_NAME = AUTHOR_DESCRIBE_TOOL_NAME;
+exports.AUTHOR_FACADE_TOOL_NAMES = AUTHOR_FACADE_TOOL_NAMES;
+exports.AUTHOR_USE_TOOL_NAME = AUTHOR_USE_TOOL_NAME;
+
+//# sourceMappingURL=authorTools.cjs.map

package/dist/src/constants/authorTools.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorTools.cjs","names":[],"sources":["../../../src/constants/authorTools.ts"],"sourcesContent":["export const AUTHOR_DESCRIBE_TOOL_NAME = 'describe_author_tools' as const;\nexport const AUTHOR_USE_TOOL_NAME = 'use_author_tools' as const;\nexport const AUTHOR_FACADE_TOOL_NAMES = [AUTHOR_DESCRIBE_TOOL_NAME, AUTHOR_USE_TOOL_NAME] as const;\n"],"mappings":";AAAA,MAAa,4BAA4B;AACzC,MAAa,uBAAuB;AACpC,MAAa,2BAA2B,CAAC,2BAA2B,oBAAoB"}

package/dist/src/constants/authorTools.d.mts

@@ -0,0 +1,6 @@
+//#region src/constants/authorTools.d.ts
+export declare const AUTHOR_DESCRIBE_TOOL_NAME: 'describe_author_tools';
+export declare const AUTHOR_USE_TOOL_NAME: 'use_author_tools';
+export declare const AUTHOR_FACADE_TOOL_NAMES: readonly ["describe_author_tools", "use_author_tools"];
+//#endregion
+//# sourceMappingURL=authorTools.d.mts.map

package/dist/src/constants/authorTools.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorTools.d.mts","names":[],"sources":["../../../src/constants/authorTools.ts"],"mappings":";qBAAa;qBACA;qBACA"}

package/dist/src/constants/authorTools.mjs

@@ -0,0 +1,8 @@
+//#region src/constants/authorTools.ts
+const AUTHOR_DESCRIBE_TOOL_NAME = "describe_author_tools";
+const AUTHOR_USE_TOOL_NAME = "use_author_tools";
+const AUTHOR_FACADE_TOOL_NAMES = [AUTHOR_DESCRIBE_TOOL_NAME, AUTHOR_USE_TOOL_NAME];
+//#endregion
+export { AUTHOR_DESCRIBE_TOOL_NAME, AUTHOR_FACADE_TOOL_NAMES, AUTHOR_USE_TOOL_NAME };
+
+//# sourceMappingURL=authorTools.mjs.map

package/dist/src/constants/authorTools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorTools.mjs","names":[],"sources":["../../../src/constants/authorTools.ts"],"sourcesContent":["export const AUTHOR_DESCRIBE_TOOL_NAME = 'describe_author_tools' as const;\nexport const AUTHOR_USE_TOOL_NAME = 'use_author_tools' as const;\nexport const AUTHOR_FACADE_TOOL_NAMES = [AUTHOR_DESCRIBE_TOOL_NAME, AUTHOR_USE_TOOL_NAME] as const;\n"],"mappings":";AAAA,MAAa,4BAA4B;AACzC,MAAa,uBAAuB;AACpC,MAAa,2BAA2B,CAAC,2BAA2B,oBAAoB"}

package/dist/src/constants/contextApi.cjs

@@ -0,0 +1,31 @@
+//#region src/constants/contextApi.ts
+/**
+* What one entry in the composition actually is, for a reader who clicked it.
+*
+* The projection prices the composition and stops there: names, owners, and
+* integer counts, small enough to republish whenever the composition changes.
+* The prose and the schema behind a figure are an order of magnitude larger and
+* are wanted one row at a time, so they travel on request instead. This module
+* is the contract both ends of that request share, and it is deliberately free
+* of Node imports so a browser can hold it too.
+*/
+/** Where a host mounts this package's API; the segment after /api/plugins/. */
+const API_BASE_PATH = "context";
+/** The session a proxied request belongs to; the hub strips it before forwarding. */
+const SESSION_QUERY_PARAM = "session";
+const ITEM_ROUTE = "/item";
+const NAME_QUERY_PARAM = "name";
+const KIND_QUERY_PARAM = "kind";
+const CONTEXT_DETAIL_VERSION = 1;
+/** Plugin-agnostic status payload: a JSON map keyed by registered tool name. */
+const CONTEXT_TOOL_WARNINGS_STATUS_KEY = "doom-context-tool-warnings";
+//#endregion
+exports.API_BASE_PATH = API_BASE_PATH;
+exports.CONTEXT_DETAIL_VERSION = CONTEXT_DETAIL_VERSION;
+exports.CONTEXT_TOOL_WARNINGS_STATUS_KEY = CONTEXT_TOOL_WARNINGS_STATUS_KEY;
+exports.ITEM_ROUTE = ITEM_ROUTE;
+exports.KIND_QUERY_PARAM = KIND_QUERY_PARAM;
+exports.NAME_QUERY_PARAM = NAME_QUERY_PARAM;
+exports.SESSION_QUERY_PARAM = SESSION_QUERY_PARAM;
+
+//# sourceMappingURL=contextApi.cjs.map

package/dist/src/constants/contextApi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextApi.cjs","names":[],"sources":["../../../src/constants/contextApi.ts"],"sourcesContent":["/**\n * What one entry in the composition actually is, for a reader who clicked it.\n *\n * The projection prices the composition and stops there: names, owners, and\n * integer counts, small enough to republish whenever the composition changes.\n * The prose and the schema behind a figure are an order of magnitude larger and\n * are wanted one row at a time, so they travel on request instead. This module\n * is the contract both ends of that request share, and it is deliberately free\n * of Node imports so a browser can hold it too.\n */\n\n/** Where a host mounts this package's API; the segment after /api/plugins/. */\nexport const API_BASE_PATH = 'context';\n\n/** The session a proxied request belongs to; the hub strips it before forwarding. */\nexport const SESSION_QUERY_PARAM = 'session';\n\nexport const ITEM_ROUTE = '/item';\n\nexport const NAME_QUERY_PARAM = 'name';\n\nexport const KIND_QUERY_PARAM = 'kind';\n\nexport const CONTEXT_DETAIL_VERSION = 1;\n\n/** Plugin-agnostic status payload: a JSON map keyed by registered tool name. */\nexport const CONTEXT_TOOL_WARNINGS_STATUS_KEY = 'doom-context-tool-warnings';\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,gBAAgB;;AAG7B,MAAa,sBAAsB;AAEnC,MAAa,aAAa;AAE1B,MAAa,mBAAmB;AAEhC,MAAa,mBAAmB;AAEhC,MAAa,yBAAyB;;AAGtC,MAAa,mCAAmC"}

package/dist/src/constants/contextApi.d.mts

@@ -0,0 +1,23 @@
+//#region src/constants/contextApi.d.ts
+/**
+ * What one entry in the composition actually is, for a reader who clicked it.
+ *
+ * The projection prices the composition and stops there: names, owners, and
+ * integer counts, small enough to republish whenever the composition changes.
+ * The prose and the schema behind a figure are an order of magnitude larger and
+ * are wanted one row at a time, so they travel on request instead. This module
+ * is the contract both ends of that request share, and it is deliberately free
+ * of Node imports so a browser can hold it too.
+ */
+/** Where a host mounts this package's API; the segment after /api/plugins/. */
+export declare const API_BASE_PATH = "context";
+/** The session a proxied request belongs to; the hub strips it before forwarding. */
+export declare const SESSION_QUERY_PARAM = "session";
+export declare const ITEM_ROUTE = "/item";
+export declare const NAME_QUERY_PARAM = "name";
+export declare const KIND_QUERY_PARAM = "kind";
+export declare const CONTEXT_DETAIL_VERSION = 1;
+/** Plugin-agnostic status payload: a JSON map keyed by registered tool name. */
+export declare const CONTEXT_TOOL_WARNINGS_STATUS_KEY = "doom-context-tool-warnings";
+//#endregion
+//# sourceMappingURL=contextApi.d.mts.map

package/dist/src/constants/contextApi.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextApi.d.mts","names":[],"sources":["../../../src/constants/contextApi.ts"],"mappings":";;;;;;;;;;;;qBAYa;;qBAGA;qBAEA;qBAEA;qBAEA;qBAEA;;qBAGA"}

package/dist/src/constants/contextApi.mjs

@@ -0,0 +1,25 @@
+//#region src/constants/contextApi.ts
+/**
+* What one entry in the composition actually is, for a reader who clicked it.
+*
+* The projection prices the composition and stops there: names, owners, and
+* integer counts, small enough to republish whenever the composition changes.
+* The prose and the schema behind a figure are an order of magnitude larger and
+* are wanted one row at a time, so they travel on request instead. This module
+* is the contract both ends of that request share, and it is deliberately free
+* of Node imports so a browser can hold it too.
+*/
+/** Where a host mounts this package's API; the segment after /api/plugins/. */
+const API_BASE_PATH = "context";
+/** The session a proxied request belongs to; the hub strips it before forwarding. */
+const SESSION_QUERY_PARAM = "session";
+const ITEM_ROUTE = "/item";
+const NAME_QUERY_PARAM = "name";
+const KIND_QUERY_PARAM = "kind";
+const CONTEXT_DETAIL_VERSION = 1;
+/** Plugin-agnostic status payload: a JSON map keyed by registered tool name. */
+const CONTEXT_TOOL_WARNINGS_STATUS_KEY = "doom-context-tool-warnings";
+//#endregion
+export { API_BASE_PATH, CONTEXT_DETAIL_VERSION, CONTEXT_TOOL_WARNINGS_STATUS_KEY, ITEM_ROUTE, KIND_QUERY_PARAM, NAME_QUERY_PARAM, SESSION_QUERY_PARAM };
+
+//# sourceMappingURL=contextApi.mjs.map

package/dist/src/constants/contextApi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextApi.mjs","names":[],"sources":["../../../src/constants/contextApi.ts"],"sourcesContent":["/**\n * What one entry in the composition actually is, for a reader who clicked it.\n *\n * The projection prices the composition and stops there: names, owners, and\n * integer counts, small enough to republish whenever the composition changes.\n * The prose and the schema behind a figure are an order of magnitude larger and\n * are wanted one row at a time, so they travel on request instead. This module\n * is the contract both ends of that request share, and it is deliberately free\n * of Node imports so a browser can hold it too.\n */\n\n/** Where a host mounts this package's API; the segment after /api/plugins/. */\nexport const API_BASE_PATH = 'context';\n\n/** The session a proxied request belongs to; the hub strips it before forwarding. */\nexport const SESSION_QUERY_PARAM = 'session';\n\nexport const ITEM_ROUTE = '/item';\n\nexport const NAME_QUERY_PARAM = 'name';\n\nexport const KIND_QUERY_PARAM = 'kind';\n\nexport const CONTEXT_DETAIL_VERSION = 1;\n\n/** Plugin-agnostic status payload: a JSON map keyed by registered tool name. */\nexport const CONTEXT_TOOL_WARNINGS_STATUS_KEY = 'doom-context-tool-warnings';\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,gBAAgB;;AAG7B,MAAa,sBAAsB;AAEnC,MAAa,aAAa;AAE1B,MAAa,mBAAmB;AAEhC,MAAa,mBAAmB;AAEhC,MAAa,yBAAyB;;AAGtC,MAAa,mCAAmC"}