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

package/dist/sqliteSessionStorage.cjs.map

@@ -1 +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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"}
+{"version":3,"file":"sqliteSessionStorage.cjs","names":["BACKGROUND_CONTEXT","fs","path","DatabaseSync","CURRENT_SQLITE_SCHEMA_VERSION","NodeSqliteDatabase","SqliteStorage","DURABLE_DIRECTORY","randomUUID","openNodeSqliteDatabase","createSession","initializeSessionIdentity"],"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, type Storage } from '@earendil-works/pi-durable';\nimport { CURRENT_SQLITE_SCHEMA_VERSION, SqliteStorage } from '@earendil-works/pi-durable/storage/sqlite';\nimport { NodeSqliteDatabase, openNodeSqliteDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { PoSessionStorageRequest } from '../../schemas/platform';\nimport { DURABLE_DIRECTORY, initializeSessionIdentity } from '../durableSession';\nimport type { HistoryOwnership } from '../historyOwnership/type';\n\nexport { DURABLE_DIRECTORY } from '../durableSession';\nexport { SessionIdentityDoc, SessionMetadataDoc } from '../durableSession/docs';\n\nexport const DURABLE_BACKGROUND_CONTEXT = BACKGROUND_CONTEXT;\n\n/** Validate existing files without admitting a writer or applying schema upgrades. */\nexport function validateDurableSessionFile(file: string): void {\n  if (!fs.existsSync(file)) throw new Error(`SQLite session not found: ${path.basename(file, '.sqlite')}`);\n  const database = new DatabaseSync(file, { readOnly: true });\n  let version: unknown;\n  try {\n    const schema = database.prepare('SELECT version FROM durable_schema WHERE singleton = 1').get();\n    version = schema?.version;\n    // Read-only connections cannot migrate, so only the schema this pi-durable writes is accepted.\n    if (version !== CURRENT_SQLITE_SCHEMA_VERSION) 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    if (typeof version === 'number' && version > CURRENT_SQLITE_SCHEMA_VERSION)\n      throw new Error('This session was written by a newer Po. Update Po to open it.', { 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\nexport interface SqliteSessionStorageOptions extends PoSessionStorageRequest {\n  /** The sessions directory the launching entry chose; files live under its `durable-v1`. */\n  readonly sessionsRoot: string;\n  readonly historyOwnership: HistoryOwnership;\n}\n\nconst SESSION_ID = /^[a-zA-Z0-9_-]+$/u;\n\n/** The durable-v1 file that holds one session. */\nexport function sqliteSessionFile(sessionsRoot: string, sessionId: string): string {\n  if (!SESSION_ID.test(sessionId)) throw new Error('Invalid SQLite session id');\n  return path.resolve(sessionsRoot, DURABLE_DIRECTORY, `${sessionId}.sqlite`);\n}\n\n/** Opens the one fresh-format SQLite container owned by a server session. */\nexport async function openSqliteSessionStorage(options: SqliteSessionStorageOptions, context: Context) {\n  const id = options.sessionId ?? randomUUID();\n  const sessionFile = sqliteSessionFile(options.sessionsRoot, id);\n  const existing = fs.existsSync(sessionFile);\n  if (options.existing && !existing) throw new Error(`SQLite session not found: ${id}`);\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    await initializeSessionIdentity(session, { id, existing, parentSessionId: options.parentSessionId }, context);\n    if (!existing) fs.chmodSync(sessionFile, 0o600);\n    return { storage, session, 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

@@ -1,35 +1,28 @@
-import { HistoryOwnershipLease } from "./src/services/historyImport/index.mjs";
-import { DirectHarnessRuntimeOptions } from "./src/types/server/directHarnessRuntime.mjs";
+import { PoSessionStorageRequest } from "./src/schemas/platform.mjs";
+import { HistoryOwnership, HistoryOwnershipLease } from "./src/services/historyOwnership/type.mjs";
+import { DURABLE_DIRECTORY } from "./src/services/durableSession/index.mjs";
+import { SessionIdentityDoc, SessionMetadataDoc } from "./src/services/durableSession/docs.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>;
+export interface SqliteSessionStorageOptions extends PoSessionStorageRequest {
+  /** The sessions directory the launching entry chose; files live under its `durable-v1`. */
+  readonly sessionsRoot: string;
+  readonly historyOwnership: HistoryOwnership;
+}
+/** The durable-v1 file that holds one session. */
+export declare function sqliteSessionFile(sessionsRoot: string, sessionId: string): string;
 /** 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<{
+export declare function openSqliteSessionStorage(options: SqliteSessionStorageOptions, context: Context): Promise<{
   storage: Storage;
   session: import("@earendil-works/pi-durable").Session;
-  sessionFile: string;
-  repository: {
-    close: (closeContext?: Context) => Promise<void>;
-  };
   historyLease: HistoryOwnershipLease;
 }>;
 //#endregion
+export { DURABLE_DIRECTORY, SessionIdentityDoc, SessionMetadataDoc };
 //# sourceMappingURL=sqliteSessionStorage.d.mts.map

package/dist/sqliteSessionStorage.d.mts.map

@@ -1 +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"}
+{"version":3,"file":"sqliteSessionStorage.d.mts","names":["_$___historyOwnership_type0.HistoryOwnershipLease"],"sources":["../src/services/sqliteSessionStorage/index.ts"],"mappings":";;;;;;;qBAkBa,4BAA0B;;wBAGvB,2BAA2B;;wBAgCrB,2BAA2B,eAAe,QAAQ;iBA2CvD,oCAAoC;;WAE1C;WACA,kBAAkB;;;wBAMb,kBAAkB,sBAAsB;;wBAMlC,yBAAyB,SAAS,6BAA6B,SAAS,UAAO"}

package/dist/sqliteSessionStorage.mjs

@@ -1,41 +1,23 @@
+import { SessionIdentityDoc, SessionMetadataDoc } from "./src/services/durableSession/docs.mjs";
+import { DURABLE_DIRECTORY, initializeSessionIdentity } from "./src/services/durableSession/index.mjs";
 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 { createSession } from "@earendil-works/pi-durable";
 import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
-import { SqliteStorage } from "@earendil-works/pi-durable/storage/sqlite";
+import { CURRENT_SQLITE_SCHEMA_VERSION, 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) {
+	if (!fs.existsSync(file)) throw new Error(`SQLite session not found: ${path.basename(file, ".sqlite")}`);
 	const database = new DatabaseSync(file, { readOnly: true });
+	let version;
 	try {
-		if (database.prepare("SELECT version FROM durable_schema WHERE singleton = 1").get()?.version !== 1) throw new Error("Unsupported durable SQLite schema");
+		version = database.prepare("SELECT version FROM durable_schema WHERE singleton = 1").get()?.version;
+		if (version !== CURRENT_SQLITE_SCHEMA_VERSION) 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",
@@ -48,6 +30,7 @@ function validateDurableSessionFile(file) {
 			"document_revisions"
 		]) if (!tables.some((table) => table.name === name)) throw new Error("Invalid durable SQLite schema");
 	} catch (cause) {
+		if (typeof version === "number" && version > CURRENT_SQLITE_SCHEMA_VERSION) throw new Error("This session was written by a newer Po. Update Po to open it.", { cause });
 		throw new Error("Unsupported or legacy SQLite session format", { cause });
 	} finally {
 		database.close();
@@ -91,17 +74,18 @@ async function openReadOnlyDurableStorage(file) {
 		throw error;
 	}
 }
+const SESSION_ID = /^[a-zA-Z0-9_-]+$/u;
+/** The durable-v1 file that holds one session. */
+function sqliteSessionFile(sessionsRoot, sessionId) {
+	if (!SESSION_ID.test(sessionId)) throw new Error("Invalid SQLite session id");
+	return path.resolve(sessionsRoot, DURABLE_DIRECTORY, `${sessionId}.sqlite`);
+}
 /** 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 id = options.sessionId ?? randomUUID();
+	const sessionFile = sqliteSessionFile(options.sessionsRoot, id);
 	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 (options.existing && !existing) throw new Error(`SQLite session not found: ${id}`);
 	if (existing) validateDurableSessionFile(sessionFile);
 	fs.mkdirSync(path.dirname(sessionFile), {
 		recursive: true,
@@ -118,22 +102,15 @@ async function openSqliteSessionStorage(options, context) {
 		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);
-		}
+		await initializeSessionIdentity(session, {
+			id,
+			existing,
+			parentSessionId: options.parentSessionId
+		}, context);
+		if (!existing) fs.chmodSync(sessionFile, 384);
 		return {
 			storage,
 			session,
-			sessionFile,
-			repository: { close: (closeContext = context) => session.close(closeContext) },
 			historyLease
 		};
 	} catch (error) {
@@ -153,6 +130,6 @@ async function openSqliteSessionStorage(options, context) {
 	}
 }
 //#endregion
-export { DURABLE_BACKGROUND_CONTEXT, DURABLE_DIRECTORY, SessionIdentityDoc, SessionMetadataDoc, openReadOnlyDurableStorage, openSqliteSessionStorage, validateDurableSessionFile };
+export { DURABLE_BACKGROUND_CONTEXT, DURABLE_DIRECTORY, SessionIdentityDoc, SessionMetadataDoc, openReadOnlyDurableStorage, openSqliteSessionStorage, sqliteSessionFile, validateDurableSessionFile };
 
 //# sourceMappingURL=sqliteSessionStorage.mjs.map

package/dist/sqliteSessionStorage.mjs.map

@@ -1 +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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"}
+{"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, type Storage } from '@earendil-works/pi-durable';\nimport { CURRENT_SQLITE_SCHEMA_VERSION, SqliteStorage } from '@earendil-works/pi-durable/storage/sqlite';\nimport { NodeSqliteDatabase, openNodeSqliteDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { PoSessionStorageRequest } from '../../schemas/platform';\nimport { DURABLE_DIRECTORY, initializeSessionIdentity } from '../durableSession';\nimport type { HistoryOwnership } from '../historyOwnership/type';\n\nexport { DURABLE_DIRECTORY } from '../durableSession';\nexport { SessionIdentityDoc, SessionMetadataDoc } from '../durableSession/docs';\n\nexport const DURABLE_BACKGROUND_CONTEXT = BACKGROUND_CONTEXT;\n\n/** Validate existing files without admitting a writer or applying schema upgrades. */\nexport function validateDurableSessionFile(file: string): void {\n  if (!fs.existsSync(file)) throw new Error(`SQLite session not found: ${path.basename(file, '.sqlite')}`);\n  const database = new DatabaseSync(file, { readOnly: true });\n  let version: unknown;\n  try {\n    const schema = database.prepare('SELECT version FROM durable_schema WHERE singleton = 1').get();\n    version = schema?.version;\n    // Read-only connections cannot migrate, so only the schema this pi-durable writes is accepted.\n    if (version !== CURRENT_SQLITE_SCHEMA_VERSION) 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    if (typeof version === 'number' && version > CURRENT_SQLITE_SCHEMA_VERSION)\n      throw new Error('This session was written by a newer Po. Update Po to open it.', { 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\nexport interface SqliteSessionStorageOptions extends PoSessionStorageRequest {\n  /** The sessions directory the launching entry chose; files live under its `durable-v1`. */\n  readonly sessionsRoot: string;\n  readonly historyOwnership: HistoryOwnership;\n}\n\nconst SESSION_ID = /^[a-zA-Z0-9_-]+$/u;\n\n/** The durable-v1 file that holds one session. */\nexport function sqliteSessionFile(sessionsRoot: string, sessionId: string): string {\n  if (!SESSION_ID.test(sessionId)) throw new Error('Invalid SQLite session id');\n  return path.resolve(sessionsRoot, DURABLE_DIRECTORY, `${sessionId}.sqlite`);\n}\n\n/** Opens the one fresh-format SQLite container owned by a server session. */\nexport async function openSqliteSessionStorage(options: SqliteSessionStorageOptions, context: Context) {\n  const id = options.sessionId ?? randomUUID();\n  const sessionFile = sqliteSessionFile(options.sessionsRoot, id);\n  const existing = fs.existsSync(sessionFile);\n  if (options.existing && !existing) throw new Error(`SQLite session not found: ${id}`);\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    await initializeSessionIdentity(session, { id, existing, parentSessionId: options.parentSessionId }, context);\n    if (!existing) fs.chmodSync(sessionFile, 0o600);\n    return { storage, session, 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/agentSettled.cjs

@@ -0,0 +1,7 @@
+//#region src/constants/agentSettled.ts
+/** Journal entry the direct harness appends when an agent run settles; the hub reads it back. */
+const AGENT_SETTLED_ENTRY_TYPE = "po.agent-settled";
+//#endregion
+exports.AGENT_SETTLED_ENTRY_TYPE = AGENT_SETTLED_ENTRY_TYPE;
+
+//# sourceMappingURL=agentSettled.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentSettled.cjs","names":[],"sources":["../../../src/constants/agentSettled.ts"],"sourcesContent":["/** Journal entry the direct harness appends when an agent run settles; the hub reads it back. */\nexport const AGENT_SETTLED_ENTRY_TYPE = 'po.agent-settled';\n"],"mappings":";;AACA,MAAa,2BAA2B"}

package/dist/src/constants/agentSettled.mjs

@@ -0,0 +1,7 @@
+//#region src/constants/agentSettled.ts
+/** Journal entry the direct harness appends when an agent run settles; the hub reads it back. */
+const AGENT_SETTLED_ENTRY_TYPE = "po.agent-settled";
+//#endregion
+export { AGENT_SETTLED_ENTRY_TYPE };
+
+//# sourceMappingURL=agentSettled.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentSettled.mjs","names":[],"sources":["../../../src/constants/agentSettled.ts"],"sourcesContent":["/** Journal entry the direct harness appends when an agent run settles; the hub reads it back. */\nexport const AGENT_SETTLED_ENTRY_TYPE = 'po.agent-settled';\n"],"mappings":";;AACA,MAAa,2BAA2B"}

package/dist/src/constants/contextApi.cjs

@@ -14,15 +14,17 @@ 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 CURRENT_ROUTE = "/current";
 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";
+const CONTEXT_TOOL_WARNINGS_STATUS_KEY = "po-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.CURRENT_ROUTE = CURRENT_ROUTE;
 exports.ITEM_ROUTE = ITEM_ROUTE;
 exports.KIND_QUERY_PARAM = KIND_QUERY_PARAM;
 exports.NAME_QUERY_PARAM = NAME_QUERY_PARAM;

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

@@ -1 +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"}
+{"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 CURRENT_ROUTE = '/current';\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 = 'po-context-tool-warnings';\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,gBAAgB;;AAG7B,MAAa,sBAAsB;AAEnC,MAAa,aAAa;AAE1B,MAAa,gBAAgB;AAE7B,MAAa,mBAAmB;AAEhC,MAAa,mBAAmB;AAEhC,MAAa,yBAAyB;;AAGtC,MAAa,mCAAmC"}

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

@@ -14,10 +14,11 @@ 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 CURRENT_ROUTE = "/current";
 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";
+export declare const CONTEXT_TOOL_WARNINGS_STATUS_KEY = "po-context-tool-warnings";
 //#endregion
 //# sourceMappingURL=contextApi.d.mts.map

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

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

package/dist/src/constants/contextApi.mjs

@@ -14,12 +14,13 @@ 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 CURRENT_ROUTE = "/current";
 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";
+const CONTEXT_TOOL_WARNINGS_STATUS_KEY = "po-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 };
+export { API_BASE_PATH, CONTEXT_DETAIL_VERSION, CONTEXT_TOOL_WARNINGS_STATUS_KEY, CURRENT_ROUTE, ITEM_ROUTE, KIND_QUERY_PARAM, NAME_QUERY_PARAM, SESSION_QUERY_PARAM };
 
 //# sourceMappingURL=contextApi.mjs.map

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

@@ -1 +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"}
+{"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 CURRENT_ROUTE = '/current';\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 = 'po-context-tool-warnings';\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,gBAAgB;;AAG7B,MAAa,sBAAsB;AAEnC,MAAa,aAAa;AAE1B,MAAa,gBAAgB;AAE7B,MAAa,mBAAmB;AAEhC,MAAa,mBAAmB;AAEhC,MAAa,yBAAyB;;AAGtC,MAAa,mCAAmC"}

package/dist/src/constants/voiceTools.cjs

@@ -1,5 +1,5 @@
 //#region src/constants/voiceTools.ts
-const DOOM_VOICE_TOOLS_SERVICE = "doom/voice-tools";
+const PO_VOICE_TOOLS_SERVICE = "po/voice-tools";
 const VOICE_DESCRIBE_TOOL_NAME = "describe_voice_tools";
 const VOICE_USE_TOOL_NAME = "use_voice_tools";
 const VOICE_FACADE_TOOL_NAMES = [VOICE_DESCRIBE_TOOL_NAME, VOICE_USE_TOOL_NAME];
@@ -52,13 +52,13 @@ const VOICE_TOOL_TIMEOUT = VOICE_TOOL_ERROR_CODE.timeout;
 const VOICE_TOOL_ABORTED = VOICE_TOOL_ERROR_CODE.aborted;
 const VOICE_TOOL_EXECUTION_FAILED = VOICE_TOOL_ERROR_CODE.executionFailed;
 const VOICE_TOOL_BATCH_STOPPED = VOICE_TOOL_ERROR_CODE.batchStopped;
-const DOOM_VOICE_SOURCE = "@agimon-ai/po-voice";
-const DOOM_VOICE_AUTO_MODE_ID = "voice-auto";
+const PO_VOICE_SOURCE = "@agimon-ai/po-voice";
+const PO_VOICE_AUTO_MODE_ID = "voice-auto";
 //#endregion
-exports.DOOM_VOICE_AUTO_MODE_ID = DOOM_VOICE_AUTO_MODE_ID;
-exports.DOOM_VOICE_SOURCE = DOOM_VOICE_SOURCE;
-exports.DOOM_VOICE_TOOLS_SERVICE = DOOM_VOICE_TOOLS_SERVICE;
 exports.MAX_ORDER = MAX_ORDER;
+exports.PO_VOICE_AUTO_MODE_ID = PO_VOICE_AUTO_MODE_ID;
+exports.PO_VOICE_SOURCE = PO_VOICE_SOURCE;
+exports.PO_VOICE_TOOLS_SERVICE = PO_VOICE_TOOLS_SERVICE;
 exports.SAFE_IDENTIFIER = SAFE_IDENTIFIER;
 exports.SAFE_NAME = SAFE_NAME;
 exports.VOICE_DESCRIBE_TOOL_NAME = VOICE_DESCRIBE_TOOL_NAME;

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

@@ -1 +1 @@
-{"version":3,"file":"voiceTools.cjs","names":[],"sources":["../../../src/constants/voiceTools.ts"],"sourcesContent":["export const DOOM_VOICE_TOOLS_SERVICE = 'doom/voice-tools';\nexport const VOICE_DESCRIBE_TOOL_NAME = 'describe_voice_tools' as const;\nexport const VOICE_USE_TOOL_NAME = 'use_voice_tools' as const;\nexport const VOICE_FACADE_TOOL_NAMES = [VOICE_DESCRIBE_TOOL_NAME, VOICE_USE_TOOL_NAME] as const;\nexport const VOICE_NARRATE_TOOL_NAME = 'narrate' as const;\nexport const VOICE_MODE_TOOL_NAMES = [...VOICE_FACADE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME] as const;\nexport const VOICE_TOOL_DEFAULT_TIMEOUT_MS = 10_000;\nexport const VOICE_TOOL_MAX_TIMEOUT_MS = 30_000;\nexport const VOICE_TOOL_MAX_BATCH_ITEMS = 16;\nexport const VOICE_TOOL_MAX_INPUT_BYTES = 64 * 1024;\nexport const VOICE_TOOL_MAX_BATCH_BYTES = 256 * 1024;\nexport const VOICE_TOOL_MAX_SCHEMA_BYTES = 32 * 1024;\nexport const VOICE_TOOL_MAX_JSON_DEPTH = 16;\nexport const VOICE_TOOL_TERMINAL_OPERATION_LIMIT = 256;\nexport const VOICE_TOOL_MAX_IDENTIFIER_LENGTH = 128;\nexport const VOICE_TOOL_MAX_LABEL_LENGTH = 96;\nexport const VOICE_TOOL_MAX_DESCRIPTION_LENGTH = 240;\nexport const VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH = 240;\nexport const VOICE_TOOL_MAX_DOMAIN_COUNT = 32;\nexport const SAFE_IDENTIFIER = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u;\nexport const SAFE_NAME = /^[a-z][a-z0-9_:-]*$/u;\nexport const MAX_ORDER = 1_000;\nexport const VOICE_TOOL_ERROR_CODE = {\n  hostUnavailable: 'VOICE_TOOL_HOST_UNAVAILABLE',\n  inactive: 'VOICE_TOOL_INACTIVE',\n  staleSession: 'VOICE_TOOL_STALE_SESSION',\n  staleCatalog: 'VOICE_TOOL_STALE_CATALOG',\n  notFound: 'VOICE_TOOL_NOT_FOUND',\n  nameConflict: 'VOICE_TOOL_NAME_CONFLICT',\n  invalidInput: 'VOICE_TOOL_INVALID_INPUT',\n  invalidResult: 'VOICE_TOOL_INVALID_RESULT',\n  executionFailed: 'VOICE_TOOL_EXECUTION_FAILED',\n  timeout: 'VOICE_TOOL_TIMEOUT',\n  aborted: 'VOICE_TOOL_ABORTED',\n  cancelled: 'VOICE_TOOL_CANCELLED',\n  registrationDisposed: 'VOICE_TOOL_REGISTRATION_DISPOSED',\n  sessionShutdown: 'VOICE_TOOL_SESSION_SHUTDOWN',\n  batchStopped: 'VOICE_TOOL_BATCH_STOPPED',\n  reloadQueued: 'VOICE_TOOL_RELOAD_QUEUED',\n  invalidRequest: 'VOICE_TOOL_INVALID_REQUEST',\n} as const;\nexport const VOICE_TOOL_HOST_UNAVAILABLE = VOICE_TOOL_ERROR_CODE.hostUnavailable;\nexport const VOICE_TOOL_INACTIVE = VOICE_TOOL_ERROR_CODE.inactive;\nexport const VOICE_TOOL_STALE_SESSION = VOICE_TOOL_ERROR_CODE.staleSession;\nexport const VOICE_TOOL_STALE_CATALOG = VOICE_TOOL_ERROR_CODE.staleCatalog;\nexport const VOICE_TOOL_NOT_FOUND = VOICE_TOOL_ERROR_CODE.notFound;\nexport const VOICE_TOOL_NAME_CONFLICT = VOICE_TOOL_ERROR_CODE.nameConflict;\nexport const VOICE_TOOL_INVALID_INPUT = VOICE_TOOL_ERROR_CODE.invalidInput;\nexport const VOICE_TOOL_INVALID_RESULT = VOICE_TOOL_ERROR_CODE.invalidResult;\nexport const VOICE_TOOL_TIMEOUT = VOICE_TOOL_ERROR_CODE.timeout;\nexport const VOICE_TOOL_ABORTED = VOICE_TOOL_ERROR_CODE.aborted;\nexport const VOICE_TOOL_EXECUTION_FAILED = VOICE_TOOL_ERROR_CODE.executionFailed;\nexport const VOICE_TOOL_BATCH_STOPPED = VOICE_TOOL_ERROR_CODE.batchStopped;\n\nexport const DOOM_VOICE_SOURCE = '@agimon-ai/po-voice';\nexport const DOOM_VOICE_AUTO_MODE_ID = 'voice-auto';\n"],"mappings":";AAAA,MAAa,2BAA2B;AACxC,MAAa,2BAA2B;AACxC,MAAa,sBAAsB;AACnC,MAAa,0BAA0B,CAAC,0BAA0B,mBAAmB;AACrF,MAAa,0BAA0B;AACvC,MAAa,wBAAwB,CAAC,GAAG,yBAAyB,uBAAuB;AACzF,MAAa,gCAAgC;AAC7C,MAAa,4BAA4B;AACzC,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,8BAA8B;AAC3C,MAAa,4BAA4B;AACzC,MAAa,sCAAsC;AACnD,MAAa,mCAAmC;AAChD,MAAa,8BAA8B;AAC3C,MAAa,oCAAoC;AACjD,MAAa,sCAAsC;AACnD,MAAa,8BAA8B;AAC3C,MAAa,kBAAkB;AAC/B,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,wBAAwB;CACnC,iBAAiB;CACjB,UAAU;CACV,cAAc;CACd,cAAc;CACd,UAAU;CACV,cAAc;CACd,cAAc;CACd,eAAe;CACf,iBAAiB;CACjB,SAAS;CACT,SAAS;CACT,WAAW;CACX,sBAAsB;CACtB,iBAAiB;CACjB,cAAc;CACd,cAAc;CACd,gBAAgB;AAClB;AACA,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,sBAAsB,sBAAsB;AACzD,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,uBAAuB,sBAAsB;AAC1D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,4BAA4B,sBAAsB;AAC/D,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,2BAA2B,sBAAsB;AAE9D,MAAa,oBAAoB;AACjC,MAAa,0BAA0B"}
+{"version":3,"file":"voiceTools.cjs","names":[],"sources":["../../../src/constants/voiceTools.ts"],"sourcesContent":["export const PO_VOICE_TOOLS_SERVICE = 'po/voice-tools';\nexport const VOICE_DESCRIBE_TOOL_NAME = 'describe_voice_tools' as const;\nexport const VOICE_USE_TOOL_NAME = 'use_voice_tools' as const;\nexport const VOICE_FACADE_TOOL_NAMES = [VOICE_DESCRIBE_TOOL_NAME, VOICE_USE_TOOL_NAME] as const;\nexport const VOICE_NARRATE_TOOL_NAME = 'narrate' as const;\nexport const VOICE_MODE_TOOL_NAMES = [...VOICE_FACADE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME] as const;\nexport const VOICE_TOOL_DEFAULT_TIMEOUT_MS = 10_000;\nexport const VOICE_TOOL_MAX_TIMEOUT_MS = 30_000;\nexport const VOICE_TOOL_MAX_BATCH_ITEMS = 16;\nexport const VOICE_TOOL_MAX_INPUT_BYTES = 64 * 1024;\nexport const VOICE_TOOL_MAX_BATCH_BYTES = 256 * 1024;\nexport const VOICE_TOOL_MAX_SCHEMA_BYTES = 32 * 1024;\nexport const VOICE_TOOL_MAX_JSON_DEPTH = 16;\nexport const VOICE_TOOL_TERMINAL_OPERATION_LIMIT = 256;\nexport const VOICE_TOOL_MAX_IDENTIFIER_LENGTH = 128;\nexport const VOICE_TOOL_MAX_LABEL_LENGTH = 96;\nexport const VOICE_TOOL_MAX_DESCRIPTION_LENGTH = 240;\nexport const VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH = 240;\nexport const VOICE_TOOL_MAX_DOMAIN_COUNT = 32;\nexport const SAFE_IDENTIFIER = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u;\nexport const SAFE_NAME = /^[a-z][a-z0-9_:-]*$/u;\nexport const MAX_ORDER = 1_000;\nexport const VOICE_TOOL_ERROR_CODE = {\n  hostUnavailable: 'VOICE_TOOL_HOST_UNAVAILABLE',\n  inactive: 'VOICE_TOOL_INACTIVE',\n  staleSession: 'VOICE_TOOL_STALE_SESSION',\n  staleCatalog: 'VOICE_TOOL_STALE_CATALOG',\n  notFound: 'VOICE_TOOL_NOT_FOUND',\n  nameConflict: 'VOICE_TOOL_NAME_CONFLICT',\n  invalidInput: 'VOICE_TOOL_INVALID_INPUT',\n  invalidResult: 'VOICE_TOOL_INVALID_RESULT',\n  executionFailed: 'VOICE_TOOL_EXECUTION_FAILED',\n  timeout: 'VOICE_TOOL_TIMEOUT',\n  aborted: 'VOICE_TOOL_ABORTED',\n  cancelled: 'VOICE_TOOL_CANCELLED',\n  registrationDisposed: 'VOICE_TOOL_REGISTRATION_DISPOSED',\n  sessionShutdown: 'VOICE_TOOL_SESSION_SHUTDOWN',\n  batchStopped: 'VOICE_TOOL_BATCH_STOPPED',\n  reloadQueued: 'VOICE_TOOL_RELOAD_QUEUED',\n  invalidRequest: 'VOICE_TOOL_INVALID_REQUEST',\n} as const;\nexport const VOICE_TOOL_HOST_UNAVAILABLE = VOICE_TOOL_ERROR_CODE.hostUnavailable;\nexport const VOICE_TOOL_INACTIVE = VOICE_TOOL_ERROR_CODE.inactive;\nexport const VOICE_TOOL_STALE_SESSION = VOICE_TOOL_ERROR_CODE.staleSession;\nexport const VOICE_TOOL_STALE_CATALOG = VOICE_TOOL_ERROR_CODE.staleCatalog;\nexport const VOICE_TOOL_NOT_FOUND = VOICE_TOOL_ERROR_CODE.notFound;\nexport const VOICE_TOOL_NAME_CONFLICT = VOICE_TOOL_ERROR_CODE.nameConflict;\nexport const VOICE_TOOL_INVALID_INPUT = VOICE_TOOL_ERROR_CODE.invalidInput;\nexport const VOICE_TOOL_INVALID_RESULT = VOICE_TOOL_ERROR_CODE.invalidResult;\nexport const VOICE_TOOL_TIMEOUT = VOICE_TOOL_ERROR_CODE.timeout;\nexport const VOICE_TOOL_ABORTED = VOICE_TOOL_ERROR_CODE.aborted;\nexport const VOICE_TOOL_EXECUTION_FAILED = VOICE_TOOL_ERROR_CODE.executionFailed;\nexport const VOICE_TOOL_BATCH_STOPPED = VOICE_TOOL_ERROR_CODE.batchStopped;\n\nexport const PO_VOICE_SOURCE = '@agimon-ai/po-voice';\nexport const PO_VOICE_AUTO_MODE_ID = 'voice-auto';\n"],"mappings":";AAAA,MAAa,yBAAyB;AACtC,MAAa,2BAA2B;AACxC,MAAa,sBAAsB;AACnC,MAAa,0BAA0B,CAAC,0BAA0B,mBAAmB;AACrF,MAAa,0BAA0B;AACvC,MAAa,wBAAwB,CAAC,GAAG,yBAAyB,uBAAuB;AACzF,MAAa,gCAAgC;AAC7C,MAAa,4BAA4B;AACzC,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,8BAA8B;AAC3C,MAAa,4BAA4B;AACzC,MAAa,sCAAsC;AACnD,MAAa,mCAAmC;AAChD,MAAa,8BAA8B;AAC3C,MAAa,oCAAoC;AACjD,MAAa,sCAAsC;AACnD,MAAa,8BAA8B;AAC3C,MAAa,kBAAkB;AAC/B,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,wBAAwB;CACnC,iBAAiB;CACjB,UAAU;CACV,cAAc;CACd,cAAc;CACd,UAAU;CACV,cAAc;CACd,cAAc;CACd,eAAe;CACf,iBAAiB;CACjB,SAAS;CACT,SAAS;CACT,WAAW;CACX,sBAAsB;CACtB,iBAAiB;CACjB,cAAc;CACd,cAAc;CACd,gBAAgB;AAClB;AACA,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,sBAAsB,sBAAsB;AACzD,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,uBAAuB,sBAAsB;AAC1D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,4BAA4B,sBAAsB;AAC/D,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,2BAA2B,sBAAsB;AAE9D,MAAa,kBAAkB;AAC/B,MAAa,wBAAwB"}

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

@@ -1,5 +1,5 @@
 //#region src/constants/voiceTools.d.ts
-export declare const DOOM_VOICE_TOOLS_SERVICE = "doom/voice-tools";
+export declare const PO_VOICE_TOOLS_SERVICE = "po/voice-tools";
 export declare const VOICE_DESCRIBE_TOOL_NAME: 'describe_voice_tools';
 export declare const VOICE_USE_TOOL_NAME: 'use_voice_tools';
 export declare const VOICE_FACADE_TOOL_NAMES: readonly ["describe_voice_tools", "use_voice_tools"];
@@ -52,7 +52,7 @@ export declare const VOICE_TOOL_TIMEOUT: "VOICE_TOOL_TIMEOUT";
 export declare const VOICE_TOOL_ABORTED: "VOICE_TOOL_ABORTED";
 export declare const VOICE_TOOL_EXECUTION_FAILED: "VOICE_TOOL_EXECUTION_FAILED";
 export declare const VOICE_TOOL_BATCH_STOPPED: "VOICE_TOOL_BATCH_STOPPED";
-export declare const DOOM_VOICE_SOURCE = "@agimon-ai/po-voice";
-export declare const DOOM_VOICE_AUTO_MODE_ID = "voice-auto";
+export declare const PO_VOICE_SOURCE = "@agimon-ai/po-voice";
+export declare const PO_VOICE_AUTO_MODE_ID = "voice-auto";
 //#endregion
 //# sourceMappingURL=voiceTools.d.mts.map

package/dist/src/constants/voiceTools.mjs

@@ -1,5 +1,5 @@
 //#region src/constants/voiceTools.ts
-const DOOM_VOICE_TOOLS_SERVICE = "doom/voice-tools";
+const PO_VOICE_TOOLS_SERVICE = "po/voice-tools";
 const VOICE_DESCRIBE_TOOL_NAME = "describe_voice_tools";
 const VOICE_USE_TOOL_NAME = "use_voice_tools";
 const VOICE_FACADE_TOOL_NAMES = [VOICE_DESCRIBE_TOOL_NAME, VOICE_USE_TOOL_NAME];
@@ -52,9 +52,9 @@ const VOICE_TOOL_TIMEOUT = VOICE_TOOL_ERROR_CODE.timeout;
 const VOICE_TOOL_ABORTED = VOICE_TOOL_ERROR_CODE.aborted;
 const VOICE_TOOL_EXECUTION_FAILED = VOICE_TOOL_ERROR_CODE.executionFailed;
 const VOICE_TOOL_BATCH_STOPPED = VOICE_TOOL_ERROR_CODE.batchStopped;
-const DOOM_VOICE_SOURCE = "@agimon-ai/po-voice";
-const DOOM_VOICE_AUTO_MODE_ID = "voice-auto";
+const PO_VOICE_SOURCE = "@agimon-ai/po-voice";
+const PO_VOICE_AUTO_MODE_ID = "voice-auto";
 //#endregion
-export { DOOM_VOICE_AUTO_MODE_ID, DOOM_VOICE_SOURCE, DOOM_VOICE_TOOLS_SERVICE, MAX_ORDER, SAFE_IDENTIFIER, SAFE_NAME, VOICE_DESCRIBE_TOOL_NAME, VOICE_FACADE_TOOL_NAMES, VOICE_MODE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME, VOICE_TOOL_ABORTED, VOICE_TOOL_BATCH_STOPPED, VOICE_TOOL_DEFAULT_TIMEOUT_MS, VOICE_TOOL_ERROR_CODE, VOICE_TOOL_EXECUTION_FAILED, VOICE_TOOL_HOST_UNAVAILABLE, VOICE_TOOL_INACTIVE, VOICE_TOOL_INVALID_INPUT, VOICE_TOOL_INVALID_RESULT, VOICE_TOOL_MAX_BATCH_BYTES, VOICE_TOOL_MAX_BATCH_ITEMS, VOICE_TOOL_MAX_DESCRIPTION_LENGTH, VOICE_TOOL_MAX_DOMAIN_COUNT, VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH, VOICE_TOOL_MAX_IDENTIFIER_LENGTH, VOICE_TOOL_MAX_INPUT_BYTES, VOICE_TOOL_MAX_JSON_DEPTH, VOICE_TOOL_MAX_LABEL_LENGTH, VOICE_TOOL_MAX_SCHEMA_BYTES, VOICE_TOOL_MAX_TIMEOUT_MS, VOICE_TOOL_NAME_CONFLICT, VOICE_TOOL_NOT_FOUND, VOICE_TOOL_STALE_CATALOG, VOICE_TOOL_STALE_SESSION, VOICE_TOOL_TERMINAL_OPERATION_LIMIT, VOICE_TOOL_TIMEOUT, VOICE_USE_TOOL_NAME };
+export { MAX_ORDER, PO_VOICE_AUTO_MODE_ID, PO_VOICE_SOURCE, PO_VOICE_TOOLS_SERVICE, SAFE_IDENTIFIER, SAFE_NAME, VOICE_DESCRIBE_TOOL_NAME, VOICE_FACADE_TOOL_NAMES, VOICE_MODE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME, VOICE_TOOL_ABORTED, VOICE_TOOL_BATCH_STOPPED, VOICE_TOOL_DEFAULT_TIMEOUT_MS, VOICE_TOOL_ERROR_CODE, VOICE_TOOL_EXECUTION_FAILED, VOICE_TOOL_HOST_UNAVAILABLE, VOICE_TOOL_INACTIVE, VOICE_TOOL_INVALID_INPUT, VOICE_TOOL_INVALID_RESULT, VOICE_TOOL_MAX_BATCH_BYTES, VOICE_TOOL_MAX_BATCH_ITEMS, VOICE_TOOL_MAX_DESCRIPTION_LENGTH, VOICE_TOOL_MAX_DOMAIN_COUNT, VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH, VOICE_TOOL_MAX_IDENTIFIER_LENGTH, VOICE_TOOL_MAX_INPUT_BYTES, VOICE_TOOL_MAX_JSON_DEPTH, VOICE_TOOL_MAX_LABEL_LENGTH, VOICE_TOOL_MAX_SCHEMA_BYTES, VOICE_TOOL_MAX_TIMEOUT_MS, VOICE_TOOL_NAME_CONFLICT, VOICE_TOOL_NOT_FOUND, VOICE_TOOL_STALE_CATALOG, VOICE_TOOL_STALE_SESSION, VOICE_TOOL_TERMINAL_OPERATION_LIMIT, VOICE_TOOL_TIMEOUT, VOICE_USE_TOOL_NAME };
 
 //# sourceMappingURL=voiceTools.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"voiceTools.mjs","names":[],"sources":["../../../src/constants/voiceTools.ts"],"sourcesContent":["export const DOOM_VOICE_TOOLS_SERVICE = 'doom/voice-tools';\nexport const VOICE_DESCRIBE_TOOL_NAME = 'describe_voice_tools' as const;\nexport const VOICE_USE_TOOL_NAME = 'use_voice_tools' as const;\nexport const VOICE_FACADE_TOOL_NAMES = [VOICE_DESCRIBE_TOOL_NAME, VOICE_USE_TOOL_NAME] as const;\nexport const VOICE_NARRATE_TOOL_NAME = 'narrate' as const;\nexport const VOICE_MODE_TOOL_NAMES = [...VOICE_FACADE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME] as const;\nexport const VOICE_TOOL_DEFAULT_TIMEOUT_MS = 10_000;\nexport const VOICE_TOOL_MAX_TIMEOUT_MS = 30_000;\nexport const VOICE_TOOL_MAX_BATCH_ITEMS = 16;\nexport const VOICE_TOOL_MAX_INPUT_BYTES = 64 * 1024;\nexport const VOICE_TOOL_MAX_BATCH_BYTES = 256 * 1024;\nexport const VOICE_TOOL_MAX_SCHEMA_BYTES = 32 * 1024;\nexport const VOICE_TOOL_MAX_JSON_DEPTH = 16;\nexport const VOICE_TOOL_TERMINAL_OPERATION_LIMIT = 256;\nexport const VOICE_TOOL_MAX_IDENTIFIER_LENGTH = 128;\nexport const VOICE_TOOL_MAX_LABEL_LENGTH = 96;\nexport const VOICE_TOOL_MAX_DESCRIPTION_LENGTH = 240;\nexport const VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH = 240;\nexport const VOICE_TOOL_MAX_DOMAIN_COUNT = 32;\nexport const SAFE_IDENTIFIER = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u;\nexport const SAFE_NAME = /^[a-z][a-z0-9_:-]*$/u;\nexport const MAX_ORDER = 1_000;\nexport const VOICE_TOOL_ERROR_CODE = {\n  hostUnavailable: 'VOICE_TOOL_HOST_UNAVAILABLE',\n  inactive: 'VOICE_TOOL_INACTIVE',\n  staleSession: 'VOICE_TOOL_STALE_SESSION',\n  staleCatalog: 'VOICE_TOOL_STALE_CATALOG',\n  notFound: 'VOICE_TOOL_NOT_FOUND',\n  nameConflict: 'VOICE_TOOL_NAME_CONFLICT',\n  invalidInput: 'VOICE_TOOL_INVALID_INPUT',\n  invalidResult: 'VOICE_TOOL_INVALID_RESULT',\n  executionFailed: 'VOICE_TOOL_EXECUTION_FAILED',\n  timeout: 'VOICE_TOOL_TIMEOUT',\n  aborted: 'VOICE_TOOL_ABORTED',\n  cancelled: 'VOICE_TOOL_CANCELLED',\n  registrationDisposed: 'VOICE_TOOL_REGISTRATION_DISPOSED',\n  sessionShutdown: 'VOICE_TOOL_SESSION_SHUTDOWN',\n  batchStopped: 'VOICE_TOOL_BATCH_STOPPED',\n  reloadQueued: 'VOICE_TOOL_RELOAD_QUEUED',\n  invalidRequest: 'VOICE_TOOL_INVALID_REQUEST',\n} as const;\nexport const VOICE_TOOL_HOST_UNAVAILABLE = VOICE_TOOL_ERROR_CODE.hostUnavailable;\nexport const VOICE_TOOL_INACTIVE = VOICE_TOOL_ERROR_CODE.inactive;\nexport const VOICE_TOOL_STALE_SESSION = VOICE_TOOL_ERROR_CODE.staleSession;\nexport const VOICE_TOOL_STALE_CATALOG = VOICE_TOOL_ERROR_CODE.staleCatalog;\nexport const VOICE_TOOL_NOT_FOUND = VOICE_TOOL_ERROR_CODE.notFound;\nexport const VOICE_TOOL_NAME_CONFLICT = VOICE_TOOL_ERROR_CODE.nameConflict;\nexport const VOICE_TOOL_INVALID_INPUT = VOICE_TOOL_ERROR_CODE.invalidInput;\nexport const VOICE_TOOL_INVALID_RESULT = VOICE_TOOL_ERROR_CODE.invalidResult;\nexport const VOICE_TOOL_TIMEOUT = VOICE_TOOL_ERROR_CODE.timeout;\nexport const VOICE_TOOL_ABORTED = VOICE_TOOL_ERROR_CODE.aborted;\nexport const VOICE_TOOL_EXECUTION_FAILED = VOICE_TOOL_ERROR_CODE.executionFailed;\nexport const VOICE_TOOL_BATCH_STOPPED = VOICE_TOOL_ERROR_CODE.batchStopped;\n\nexport const DOOM_VOICE_SOURCE = '@agimon-ai/po-voice';\nexport const DOOM_VOICE_AUTO_MODE_ID = 'voice-auto';\n"],"mappings":";AAAA,MAAa,2BAA2B;AACxC,MAAa,2BAA2B;AACxC,MAAa,sBAAsB;AACnC,MAAa,0BAA0B,CAAC,0BAA0B,mBAAmB;AACrF,MAAa,0BAA0B;AACvC,MAAa,wBAAwB,CAAC,GAAG,yBAAyB,uBAAuB;AACzF,MAAa,gCAAgC;AAC7C,MAAa,4BAA4B;AACzC,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,8BAA8B;AAC3C,MAAa,4BAA4B;AACzC,MAAa,sCAAsC;AACnD,MAAa,mCAAmC;AAChD,MAAa,8BAA8B;AAC3C,MAAa,oCAAoC;AACjD,MAAa,sCAAsC;AACnD,MAAa,8BAA8B;AAC3C,MAAa,kBAAkB;AAC/B,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,wBAAwB;CACnC,iBAAiB;CACjB,UAAU;CACV,cAAc;CACd,cAAc;CACd,UAAU;CACV,cAAc;CACd,cAAc;CACd,eAAe;CACf,iBAAiB;CACjB,SAAS;CACT,SAAS;CACT,WAAW;CACX,sBAAsB;CACtB,iBAAiB;CACjB,cAAc;CACd,cAAc;CACd,gBAAgB;AAClB;AACA,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,sBAAsB,sBAAsB;AACzD,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,uBAAuB,sBAAsB;AAC1D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,4BAA4B,sBAAsB;AAC/D,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,2BAA2B,sBAAsB;AAE9D,MAAa,oBAAoB;AACjC,MAAa,0BAA0B"}
+{"version":3,"file":"voiceTools.mjs","names":[],"sources":["../../../src/constants/voiceTools.ts"],"sourcesContent":["export const PO_VOICE_TOOLS_SERVICE = 'po/voice-tools';\nexport const VOICE_DESCRIBE_TOOL_NAME = 'describe_voice_tools' as const;\nexport const VOICE_USE_TOOL_NAME = 'use_voice_tools' as const;\nexport const VOICE_FACADE_TOOL_NAMES = [VOICE_DESCRIBE_TOOL_NAME, VOICE_USE_TOOL_NAME] as const;\nexport const VOICE_NARRATE_TOOL_NAME = 'narrate' as const;\nexport const VOICE_MODE_TOOL_NAMES = [...VOICE_FACADE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME] as const;\nexport const VOICE_TOOL_DEFAULT_TIMEOUT_MS = 10_000;\nexport const VOICE_TOOL_MAX_TIMEOUT_MS = 30_000;\nexport const VOICE_TOOL_MAX_BATCH_ITEMS = 16;\nexport const VOICE_TOOL_MAX_INPUT_BYTES = 64 * 1024;\nexport const VOICE_TOOL_MAX_BATCH_BYTES = 256 * 1024;\nexport const VOICE_TOOL_MAX_SCHEMA_BYTES = 32 * 1024;\nexport const VOICE_TOOL_MAX_JSON_DEPTH = 16;\nexport const VOICE_TOOL_TERMINAL_OPERATION_LIMIT = 256;\nexport const VOICE_TOOL_MAX_IDENTIFIER_LENGTH = 128;\nexport const VOICE_TOOL_MAX_LABEL_LENGTH = 96;\nexport const VOICE_TOOL_MAX_DESCRIPTION_LENGTH = 240;\nexport const VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH = 240;\nexport const VOICE_TOOL_MAX_DOMAIN_COUNT = 32;\nexport const SAFE_IDENTIFIER = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u;\nexport const SAFE_NAME = /^[a-z][a-z0-9_:-]*$/u;\nexport const MAX_ORDER = 1_000;\nexport const VOICE_TOOL_ERROR_CODE = {\n  hostUnavailable: 'VOICE_TOOL_HOST_UNAVAILABLE',\n  inactive: 'VOICE_TOOL_INACTIVE',\n  staleSession: 'VOICE_TOOL_STALE_SESSION',\n  staleCatalog: 'VOICE_TOOL_STALE_CATALOG',\n  notFound: 'VOICE_TOOL_NOT_FOUND',\n  nameConflict: 'VOICE_TOOL_NAME_CONFLICT',\n  invalidInput: 'VOICE_TOOL_INVALID_INPUT',\n  invalidResult: 'VOICE_TOOL_INVALID_RESULT',\n  executionFailed: 'VOICE_TOOL_EXECUTION_FAILED',\n  timeout: 'VOICE_TOOL_TIMEOUT',\n  aborted: 'VOICE_TOOL_ABORTED',\n  cancelled: 'VOICE_TOOL_CANCELLED',\n  registrationDisposed: 'VOICE_TOOL_REGISTRATION_DISPOSED',\n  sessionShutdown: 'VOICE_TOOL_SESSION_SHUTDOWN',\n  batchStopped: 'VOICE_TOOL_BATCH_STOPPED',\n  reloadQueued: 'VOICE_TOOL_RELOAD_QUEUED',\n  invalidRequest: 'VOICE_TOOL_INVALID_REQUEST',\n} as const;\nexport const VOICE_TOOL_HOST_UNAVAILABLE = VOICE_TOOL_ERROR_CODE.hostUnavailable;\nexport const VOICE_TOOL_INACTIVE = VOICE_TOOL_ERROR_CODE.inactive;\nexport const VOICE_TOOL_STALE_SESSION = VOICE_TOOL_ERROR_CODE.staleSession;\nexport const VOICE_TOOL_STALE_CATALOG = VOICE_TOOL_ERROR_CODE.staleCatalog;\nexport const VOICE_TOOL_NOT_FOUND = VOICE_TOOL_ERROR_CODE.notFound;\nexport const VOICE_TOOL_NAME_CONFLICT = VOICE_TOOL_ERROR_CODE.nameConflict;\nexport const VOICE_TOOL_INVALID_INPUT = VOICE_TOOL_ERROR_CODE.invalidInput;\nexport const VOICE_TOOL_INVALID_RESULT = VOICE_TOOL_ERROR_CODE.invalidResult;\nexport const VOICE_TOOL_TIMEOUT = VOICE_TOOL_ERROR_CODE.timeout;\nexport const VOICE_TOOL_ABORTED = VOICE_TOOL_ERROR_CODE.aborted;\nexport const VOICE_TOOL_EXECUTION_FAILED = VOICE_TOOL_ERROR_CODE.executionFailed;\nexport const VOICE_TOOL_BATCH_STOPPED = VOICE_TOOL_ERROR_CODE.batchStopped;\n\nexport const PO_VOICE_SOURCE = '@agimon-ai/po-voice';\nexport const PO_VOICE_AUTO_MODE_ID = 'voice-auto';\n"],"mappings":";AAAA,MAAa,yBAAyB;AACtC,MAAa,2BAA2B;AACxC,MAAa,sBAAsB;AACnC,MAAa,0BAA0B,CAAC,0BAA0B,mBAAmB;AACrF,MAAa,0BAA0B;AACvC,MAAa,wBAAwB,CAAC,GAAG,yBAAyB,uBAAuB;AACzF,MAAa,gCAAgC;AAC7C,MAAa,4BAA4B;AACzC,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,8BAA8B;AAC3C,MAAa,4BAA4B;AACzC,MAAa,sCAAsC;AACnD,MAAa,mCAAmC;AAChD,MAAa,8BAA8B;AAC3C,MAAa,oCAAoC;AACjD,MAAa,sCAAsC;AACnD,MAAa,8BAA8B;AAC3C,MAAa,kBAAkB;AAC/B,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,wBAAwB;CACnC,iBAAiB;CACjB,UAAU;CACV,cAAc;CACd,cAAc;CACd,UAAU;CACV,cAAc;CACd,cAAc;CACd,eAAe;CACf,iBAAiB;CACjB,SAAS;CACT,SAAS;CACT,WAAW;CACX,sBAAsB;CACtB,iBAAiB;CACjB,cAAc;CACd,cAAc;CACd,gBAAgB;AAClB;AACA,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,sBAAsB,sBAAsB;AACzD,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,uBAAuB,sBAAsB;AAC1D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,4BAA4B,sBAAsB;AAC/D,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,2BAA2B,sBAAsB;AAE9D,MAAa,kBAAkB;AAC/B,MAAa,wBAAwB"}

package/dist/src/extensions/extensionFile.cjs

@@ -1,3 +1,4 @@
+const require_index = require("../services/pluginLifecycle/index.cjs");
 //#region src/extensions/extensionFile.ts
 /**
 * Identity helpers for folder-routed backend files, one per surface.
@@ -55,9 +56,24 @@ function defineServerTool(file) {
 * it as `context.root`, so the package decomposes into a file per surface
 * without either rebuilding the graph per file or reaching for a module-level
 * singleton.
+*
+* `inject` names the contracts, from this package or another, that the level
+* waits for before it builds this root and restarts with when they change.
 */
-function defineRoot(file) {
-	return file;
+function defineRoot(file, options) {
+	return options?.inject === void 0 ? file : Object.assign(file, { inject: options.inject });
+}
+/**
+* The contracts each level waits for: every contract injected by the roots that level builds or
+* reuses, once each. A level none of whose roots inject anything is left out.
+*/
+function composeRootInjects(levels) {
+	const injects = {};
+	for (const [level, roots] of Object.entries(levels)) {
+		const contracts = new Map(roots.flatMap((root) => root.inject ?? []).map((contract) => [contract.name, contract]));
+		if (contracts.size > 0) injects[level] = [...contracts.values()];
+	}
+	return injects;
 }
 /**
 * Folds every root in a scope chain into one set of lifecycle hooks.
@@ -73,14 +89,14 @@ function composeRootHooks(...roots) {
 			for (const root of roots) await root.onStart?.(context);
 		},
 		async onStop(context) {
-			for (const root of reversed) await root.onStop?.(context);
+			await require_index.runCleanups(reversed.map((root) => () => root.onStop?.(context)), "Root stop failed.");
 		},
 		async onDispose(context) {
-			for (const root of reversed) await root.onDispose?.(context);
+			await require_index.runCleanups(reversed.map((root) => () => root.onDispose?.(context)), "Root cleanup failed.");
 		}
 	};
 }
-/** `command/<name>.server.ts`. A native headless or portable Doom command. */
+/** `command/<name>.server.ts`. A native headless or portable Po command. */
 function defineServerCommand(file) {
 	return file;
 }
@@ -120,6 +136,7 @@ function defineActivity(file) {
 }
 //#endregion
 exports.composeRootHooks = composeRootHooks;
+exports.composeRootInjects = composeRootInjects;
 exports.defineActivity = defineActivity;
 exports.defineChannel = defineChannel;
 exports.defineCommand = defineCommand;