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

package/dist/help.cjs

@@ -1,24 +1,24 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_help = require("./src/schemas/help.cjs");
 const require_index = require("./src/services/piHelpTools/index.cjs");
-exports.DOOM_HELP_ERROR_CODE = require_help.DOOM_HELP_ERROR_CODE;
-exports.DOOM_HELP_MAX_CONTRIBUTORS = require_help.DOOM_HELP_MAX_CONTRIBUTORS;
-exports.DOOM_HELP_MAX_DESCRIPTION_LENGTH = require_help.DOOM_HELP_MAX_DESCRIPTION_LENGTH;
-exports.DOOM_HELP_MAX_DIAGNOSTICS = require_help.DOOM_HELP_MAX_DIAGNOSTICS;
-exports.DOOM_HELP_MAX_DIAGNOSTIC_LENGTH = require_help.DOOM_HELP_MAX_DIAGNOSTIC_LENGTH;
-exports.DOOM_HELP_MAX_SKILLS = require_help.DOOM_HELP_MAX_SKILLS;
-exports.DOOM_HELP_SERVICE = require_help.DOOM_HELP_SERVICE;
-exports.DOOM_HELP_WHEN = require_help.DOOM_HELP_WHEN;
-exports.DoomHelpActivationSchema = require_help.DoomHelpActivationSchema;
-exports.DoomHelpContributionSchema = require_help.DoomHelpContributionSchema;
-exports.DoomHelpDiagnosticSchema = require_help.DoomHelpDiagnosticSchema;
-exports.DoomHelpError = require_help.DoomHelpError;
-exports.DoomHelpSkillDescriptorSchema = require_help.DoomHelpSkillDescriptorSchema;
-exports.DoomHelpSkillNameSchema = require_help.DoomHelpSkillNameSchema;
-exports.DoomHelpSkillSchema = require_help.DoomHelpSkillSchema;
-exports.DoomHelpSnapshotSchema = require_help.DoomHelpSnapshotSchema;
-exports.DoomHelpSourceSchema = require_help.DoomHelpSourceSchema;
-exports.createDoomHelpService = require_help.createDoomHelpService;
+exports.PO_HELP_ERROR_CODE = require_help.PO_HELP_ERROR_CODE;
+exports.PO_HELP_MAX_CONTRIBUTORS = require_help.PO_HELP_MAX_CONTRIBUTORS;
+exports.PO_HELP_MAX_DESCRIPTION_LENGTH = require_help.PO_HELP_MAX_DESCRIPTION_LENGTH;
+exports.PO_HELP_MAX_DIAGNOSTICS = require_help.PO_HELP_MAX_DIAGNOSTICS;
+exports.PO_HELP_MAX_DIAGNOSTIC_LENGTH = require_help.PO_HELP_MAX_DIAGNOSTIC_LENGTH;
+exports.PO_HELP_MAX_SKILLS = require_help.PO_HELP_MAX_SKILLS;
+exports.PO_HELP_SERVICE = require_help.PO_HELP_SERVICE;
+exports.PO_HELP_WHEN = require_help.PO_HELP_WHEN;
+exports.PoHelpActivationSchema = require_help.PoHelpActivationSchema;
+exports.PoHelpContributionSchema = require_help.PoHelpContributionSchema;
+exports.PoHelpDiagnosticSchema = require_help.PoHelpDiagnosticSchema;
+exports.PoHelpError = require_help.PoHelpError;
+exports.PoHelpSkillDescriptorSchema = require_help.PoHelpSkillDescriptorSchema;
+exports.PoHelpSkillNameSchema = require_help.PoHelpSkillNameSchema;
+exports.PoHelpSkillSchema = require_help.PoHelpSkillSchema;
+exports.PoHelpSnapshotSchema = require_help.PoHelpSnapshotSchema;
+exports.PoHelpSourceSchema = require_help.PoHelpSourceSchema;
 exports.createPiHelpToolGate = require_index.createPiHelpToolGate;
-exports.readDoomHelpService = require_help.readDoomHelpService;
-exports.requireDoomHelpService = require_help.requireDoomHelpService;
+exports.createPoHelpService = require_help.createPoHelpService;
+exports.readPoHelpService = require_help.readPoHelpService;
+exports.requirePoHelpService = require_help.requirePoHelpService;

package/dist/help.d.mts

@@ -1,3 +1,3 @@
-import { DOOM_HELP_ERROR_CODE, DOOM_HELP_MAX_CONTRIBUTORS, DOOM_HELP_MAX_DESCRIPTION_LENGTH, DOOM_HELP_MAX_DIAGNOSTICS, DOOM_HELP_MAX_DIAGNOSTIC_LENGTH, DOOM_HELP_MAX_SKILLS, DOOM_HELP_SERVICE, DOOM_HELP_WHEN, DoomHelpActivation, DoomHelpActivationSchema, DoomHelpContribution, DoomHelpContributionHandle, DoomHelpContributionSchema, DoomHelpDiagnostic, DoomHelpDiagnosticSchema, DoomHelpError, DoomHelpErrorCode, DoomHelpService, DoomHelpSkill, DoomHelpSkillDescriptor, DoomHelpSkillDescriptorSchema, DoomHelpSkillNameSchema, DoomHelpSkillSchema, DoomHelpSnapshot, DoomHelpSnapshotDraft, DoomHelpSnapshotSchema, DoomHelpSourceSchema, createDoomHelpService, readDoomHelpService, requireDoomHelpService } from "./src/schemas/help.mjs";
+import { PO_HELP_ERROR_CODE, PO_HELP_MAX_CONTRIBUTORS, PO_HELP_MAX_DESCRIPTION_LENGTH, PO_HELP_MAX_DIAGNOSTICS, PO_HELP_MAX_DIAGNOSTIC_LENGTH, PO_HELP_MAX_SKILLS, PO_HELP_SERVICE, PO_HELP_WHEN, PoHelpActivation, PoHelpActivationSchema, PoHelpContribution, PoHelpContributionHandle, PoHelpContributionSchema, PoHelpDiagnostic, PoHelpDiagnosticSchema, PoHelpError, PoHelpErrorCode, PoHelpService, PoHelpSkill, PoHelpSkillDescriptor, PoHelpSkillDescriptorSchema, PoHelpSkillNameSchema, PoHelpSkillSchema, PoHelpSnapshot, PoHelpSnapshotDraft, PoHelpSnapshotSchema, PoHelpSourceSchema, createPoHelpService, readPoHelpService, requirePoHelpService } from "./src/schemas/help.mjs";
 import { createPiHelpToolGate } from "./src/services/piHelpTools/index.mjs";
-export { DOOM_HELP_ERROR_CODE, DOOM_HELP_MAX_CONTRIBUTORS, DOOM_HELP_MAX_DESCRIPTION_LENGTH, DOOM_HELP_MAX_DIAGNOSTICS, DOOM_HELP_MAX_DIAGNOSTIC_LENGTH, DOOM_HELP_MAX_SKILLS, DOOM_HELP_SERVICE, DOOM_HELP_WHEN, type DoomHelpActivation, DoomHelpActivationSchema, type DoomHelpContribution, type DoomHelpContributionHandle, DoomHelpContributionSchema, type DoomHelpDiagnostic, DoomHelpDiagnosticSchema, DoomHelpError, type DoomHelpErrorCode, type DoomHelpService, type DoomHelpSkill, type DoomHelpSkillDescriptor, DoomHelpSkillDescriptorSchema, DoomHelpSkillNameSchema, DoomHelpSkillSchema, type DoomHelpSnapshot, type DoomHelpSnapshotDraft, DoomHelpSnapshotSchema, DoomHelpSourceSchema, createDoomHelpService, createPiHelpToolGate, readDoomHelpService, requireDoomHelpService };
+export { PO_HELP_ERROR_CODE, PO_HELP_MAX_CONTRIBUTORS, PO_HELP_MAX_DESCRIPTION_LENGTH, PO_HELP_MAX_DIAGNOSTICS, PO_HELP_MAX_DIAGNOSTIC_LENGTH, PO_HELP_MAX_SKILLS, PO_HELP_SERVICE, PO_HELP_WHEN, type PoHelpActivation, PoHelpActivationSchema, type PoHelpContribution, type PoHelpContributionHandle, PoHelpContributionSchema, type PoHelpDiagnostic, PoHelpDiagnosticSchema, PoHelpError, type PoHelpErrorCode, type PoHelpService, type PoHelpSkill, type PoHelpSkillDescriptor, PoHelpSkillDescriptorSchema, PoHelpSkillNameSchema, PoHelpSkillSchema, type PoHelpSnapshot, type PoHelpSnapshotDraft, PoHelpSnapshotSchema, PoHelpSourceSchema, createPiHelpToolGate, createPoHelpService, readPoHelpService, requirePoHelpService };

package/dist/help.mjs

@@ -1,3 +1,3 @@
-import { DOOM_HELP_ERROR_CODE, DOOM_HELP_MAX_CONTRIBUTORS, DOOM_HELP_MAX_DESCRIPTION_LENGTH, DOOM_HELP_MAX_DIAGNOSTICS, DOOM_HELP_MAX_DIAGNOSTIC_LENGTH, DOOM_HELP_MAX_SKILLS, DOOM_HELP_SERVICE, DOOM_HELP_WHEN, DoomHelpActivationSchema, DoomHelpContributionSchema, DoomHelpDiagnosticSchema, DoomHelpError, DoomHelpSkillDescriptorSchema, DoomHelpSkillNameSchema, DoomHelpSkillSchema, DoomHelpSnapshotSchema, DoomHelpSourceSchema, createDoomHelpService, readDoomHelpService, requireDoomHelpService } from "./src/schemas/help.mjs";
+import { PO_HELP_ERROR_CODE, PO_HELP_MAX_CONTRIBUTORS, PO_HELP_MAX_DESCRIPTION_LENGTH, PO_HELP_MAX_DIAGNOSTICS, PO_HELP_MAX_DIAGNOSTIC_LENGTH, PO_HELP_MAX_SKILLS, PO_HELP_SERVICE, PO_HELP_WHEN, PoHelpActivationSchema, PoHelpContributionSchema, PoHelpDiagnosticSchema, PoHelpError, PoHelpSkillDescriptorSchema, PoHelpSkillNameSchema, PoHelpSkillSchema, PoHelpSnapshotSchema, PoHelpSourceSchema, createPoHelpService, readPoHelpService, requirePoHelpService } from "./src/schemas/help.mjs";
 import { createPiHelpToolGate } from "./src/services/piHelpTools/index.mjs";
-export { DOOM_HELP_ERROR_CODE, DOOM_HELP_MAX_CONTRIBUTORS, DOOM_HELP_MAX_DESCRIPTION_LENGTH, DOOM_HELP_MAX_DIAGNOSTICS, DOOM_HELP_MAX_DIAGNOSTIC_LENGTH, DOOM_HELP_MAX_SKILLS, DOOM_HELP_SERVICE, DOOM_HELP_WHEN, DoomHelpActivationSchema, DoomHelpContributionSchema, DoomHelpDiagnosticSchema, DoomHelpError, DoomHelpSkillDescriptorSchema, DoomHelpSkillNameSchema, DoomHelpSkillSchema, DoomHelpSnapshotSchema, DoomHelpSourceSchema, createDoomHelpService, createPiHelpToolGate, readDoomHelpService, requireDoomHelpService };
+export { PO_HELP_ERROR_CODE, PO_HELP_MAX_CONTRIBUTORS, PO_HELP_MAX_DESCRIPTION_LENGTH, PO_HELP_MAX_DIAGNOSTICS, PO_HELP_MAX_DIAGNOSTIC_LENGTH, PO_HELP_MAX_SKILLS, PO_HELP_SERVICE, PO_HELP_WHEN, PoHelpActivationSchema, PoHelpContributionSchema, PoHelpDiagnosticSchema, PoHelpError, PoHelpSkillDescriptorSchema, PoHelpSkillNameSchema, PoHelpSkillSchema, PoHelpSnapshotSchema, PoHelpSourceSchema, createPiHelpToolGate, createPoHelpService, readPoHelpService, requirePoHelpService };

package/dist/history.cjs

@@ -1,25 +1,21 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_historyOwnership = require("./historyOwnership.cjs");
-const require_jsonlSessionRepo = require("./jsonlSessionRepo.cjs");
-const require_index = require("./src/services/historyImport/index.cjs");
-const require_v3Export = require("./v3Export.cjs");
-const require_index$1 = require("./src/services/sqliteSessionHistory/index.cjs");
-const require_index$2 = require("./src/services/sqliteTranscriptReader/index.cjs");
-const require_index$3 = require("./src/services/openSessionRegistry/index.cjs");
-const require_index$4 = require("./src/services/workspaceRegistry/index.cjs");
-const require_index$5 = require("./src/services/requestReceipts/index.cjs");
+const require_index = require("./src/services/sqliteSessionHistory/index.cjs");
+const require_index$1 = require("./src/services/sqliteTranscriptReader/index.cjs");
+const require_sync = require("./src/services/openSessionRegistry/sync.cjs");
+require("./src/services/openSessionRegistry/index.cjs");
+const require_sync$1 = require("./src/services/workspaceRegistry/sync.cjs");
+require("./src/services/workspaceRegistry/index.cjs");
+const require_index$4 = require("./src/services/durableRequestReceipts/index.cjs");
 exports.createHistoryOwnership = require_historyOwnership.createHistoryOwnership;
-exports.createOpenSessionRegistry = require_index$3.createOpenSessionRegistry;
-exports.createRequestReceipts = require_index$5.createRequestReceipts;
+exports.createOpenSessionRegistry = require_sync.createOpenSessionRegistry;
+exports.createRequestReceipts = require_index$4.createRequestReceipts;
 exports.createV4HistoryOwnership = require_historyOwnership.createV4HistoryOwnership;
-exports.createWorkspaceRegistry = require_index$4.createWorkspaceRegistry;
-exports.exportV4ToV3 = require_v3Export.exportV4ToV3;
+exports.createWorkspaceRegistry = require_sync$1.createWorkspaceRegistry;
 exports.historyOwnershipLockPath = require_historyOwnership.historyOwnershipLockPath;
-exports.identifyWorkspace = require_index$4.identifyWorkspace;
-exports.importV3WithPinnedUpstream = require_jsonlSessionRepo.importV3WithPinnedUpstream;
-exports.listSavedSessionRecords = require_index$1.listSavedSessionRecords;
-exports.listSavedSessions = require_index$1.listSavedSessions;
-exports.protectAndImportHistory = require_index.protectAndImportHistory;
-exports.readSqliteTranscript = require_index$2.readSqliteTranscript;
-exports.readWorkspaceMarker = require_index$4.readWorkspaceMarker;
-exports.writeWorkspaceMarker = require_index$4.writeWorkspaceMarker;
+exports.identifyWorkspace = require_sync$1.identifyWorkspace;
+exports.listSavedSessionRecords = require_index.listSavedSessionRecords;
+exports.listSavedSessions = require_index.listSavedSessions;
+exports.readSqliteTranscript = require_index$1.readSqliteTranscript;
+exports.readWorkspaceMarker = require_sync$1.readWorkspaceMarker;
+exports.writeWorkspaceMarker = require_sync$1.writeWorkspaceMarker;

package/dist/history.d.mts

@@ -1,10 +1,12 @@
-import { HistoryBranchProof, HistoryEntryProof, HistoryImportOptions, HistoryImportVerification, HistoryOwnership, HistoryOwnershipLease, HistorySourceIdentity, HistoryStagingImportInput, ProtectedHistoryImportResult, protectAndImportHistory } from "./src/services/historyImport/index.mjs";
+import { HistoryOwnership, HistoryOwnershipLease } from "./src/services/historyOwnership/type.mjs";
 import { HistoryOwnershipOptions, createHistoryOwnership, createV4HistoryOwnership, historyOwnershipLockPath } from "./historyOwnership.mjs";
-import { importV3WithPinnedUpstream } from "./jsonlSessionRepo.mjs";
-import { V3ExportLoss, V3ExportLossReport, V3ExportOptions, V3ExportResult, exportV4ToV3 } from "./v3Export.mjs";
 import { SavedSessionExecution, SavedSessionRecord, listSavedSessionRecords, listSavedSessions } from "./src/services/sqliteSessionHistory/index.mjs";
 import { SqliteTranscriptOwnership, readSqliteTranscript } from "./src/services/sqliteTranscriptReader/index.mjs";
-import { OpenSessionRecord, OpenSessionRegistry, OpenSessionRegistryOptions, createOpenSessionRegistry } from "./src/services/openSessionRegistry/index.mjs";
-import { WorkspaceIdentity, WorkspaceRecord, WorkspaceRegistry, WorkspaceRegistryOptions, createWorkspaceRegistry, identifyWorkspace, readWorkspaceMarker, writeWorkspaceMarker } from "./src/services/workspaceRegistry/index.mjs";
-import { createRequestReceipts } from "./src/services/requestReceipts/index.mjs";
-export { type HistoryBranchProof, type HistoryEntryProof, type HistoryImportOptions, type HistoryImportVerification, type HistoryOwnership, type HistoryOwnershipLease, type HistoryOwnershipOptions, type HistorySourceIdentity, type HistoryStagingImportInput, type OpenSessionRecord, type OpenSessionRegistry, type OpenSessionRegistryOptions, type ProtectedHistoryImportResult, type SavedSessionExecution, type SavedSessionRecord, type SqliteTranscriptOwnership, type V3ExportLoss, type V3ExportLossReport, type V3ExportOptions, type V3ExportResult, type WorkspaceIdentity, type WorkspaceRecord, type WorkspaceRegistry, type WorkspaceRegistryOptions, createHistoryOwnership, createOpenSessionRegistry, createRequestReceipts, createV4HistoryOwnership, createWorkspaceRegistry, exportV4ToV3, historyOwnershipLockPath, identifyWorkspace, importV3WithPinnedUpstream, listSavedSessionRecords, listSavedSessions, protectAndImportHistory, readSqliteTranscript, readWorkspaceMarker, writeWorkspaceMarker };
+import { OpenSessionRecord, OpenSessionRegistry, OpenSessionRegistryOptions } from "./src/services/openSessionRegistry/openSessionRecords.mjs";
+import { createOpenSessionRegistry } from "./src/services/openSessionRegistry/sync.mjs";
+import "./src/services/openSessionRegistry/index.mjs";
+import { WorkspaceIdentity, WorkspaceRecord, WorkspaceRegistry, WorkspaceRegistryOptions } from "./src/services/workspaceRegistry/workspaceRecords.mjs";
+import { createWorkspaceRegistry, identifyWorkspace, readWorkspaceMarker, writeWorkspaceMarker } from "./src/services/workspaceRegistry/sync.mjs";
+import "./src/services/workspaceRegistry/index.mjs";
+import { createRequestReceipts } from "./src/services/durableRequestReceipts/index.mjs";
+export { type HistoryOwnership, type HistoryOwnershipLease, type HistoryOwnershipOptions, type OpenSessionRecord, type OpenSessionRegistry, type OpenSessionRegistryOptions, type SavedSessionExecution, type SavedSessionRecord, type SqliteTranscriptOwnership, type WorkspaceIdentity, type WorkspaceRecord, type WorkspaceRegistry, type WorkspaceRegistryOptions, createHistoryOwnership, createOpenSessionRegistry, createRequestReceipts, createV4HistoryOwnership, createWorkspaceRegistry, historyOwnershipLockPath, identifyWorkspace, listSavedSessionRecords, listSavedSessions, readSqliteTranscript, readWorkspaceMarker, writeWorkspaceMarker };

package/dist/history.mjs

@@ -1,10 +1,9 @@
 import { createHistoryOwnership, createV4HistoryOwnership, historyOwnershipLockPath } from "./historyOwnership.mjs";
-import { importV3WithPinnedUpstream } from "./jsonlSessionRepo.mjs";
-import { protectAndImportHistory } from "./src/services/historyImport/index.mjs";
-import { exportV4ToV3 } from "./v3Export.mjs";
 import { listSavedSessionRecords, listSavedSessions } from "./src/services/sqliteSessionHistory/index.mjs";
 import { readSqliteTranscript } from "./src/services/sqliteTranscriptReader/index.mjs";
-import { createOpenSessionRegistry } from "./src/services/openSessionRegistry/index.mjs";
-import { createWorkspaceRegistry, identifyWorkspace, readWorkspaceMarker, writeWorkspaceMarker } from "./src/services/workspaceRegistry/index.mjs";
-import { createRequestReceipts } from "./src/services/requestReceipts/index.mjs";
-export { createHistoryOwnership, createOpenSessionRegistry, createRequestReceipts, createV4HistoryOwnership, createWorkspaceRegistry, exportV4ToV3, historyOwnershipLockPath, identifyWorkspace, importV3WithPinnedUpstream, listSavedSessionRecords, listSavedSessions, protectAndImportHistory, readSqliteTranscript, readWorkspaceMarker, writeWorkspaceMarker };
+import { createOpenSessionRegistry } from "./src/services/openSessionRegistry/sync.mjs";
+import "./src/services/openSessionRegistry/index.mjs";
+import { createWorkspaceRegistry, identifyWorkspace, readWorkspaceMarker, writeWorkspaceMarker } from "./src/services/workspaceRegistry/sync.mjs";
+import "./src/services/workspaceRegistry/index.mjs";
+import { createRequestReceipts } from "./src/services/durableRequestReceipts/index.mjs";
+export { createHistoryOwnership, createOpenSessionRegistry, createRequestReceipts, createV4HistoryOwnership, createWorkspaceRegistry, historyOwnershipLockPath, identifyWorkspace, listSavedSessionRecords, listSavedSessions, readSqliteTranscript, readWorkspaceMarker, writeWorkspaceMarker };

package/dist/historyOwnership.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"historyOwnership.cjs","names":["path","fs","randomUUID"],"sources":["../src/services/historyOwnership/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { HistoryOwnership, HistoryOwnershipLease } from '../historyImport';\n\nconst LOCK_SUFFIX = '.po-v4.lock';\nconst LOCK_VERSION = 1;\nconst LOCK_FORMAT = 'po-v4-history-ownership';\n\ninterface HistoryLockRecord {\n  version: 1;\n  format: 'po-v4-history-ownership';\n  pid: number;\n  sourcePath: string;\n  token: string;\n}\n\ninterface HeldHistoryLock {\n  lockPath: string;\n  token: string;\n  handle: number;\n}\n\nexport interface HistoryOwnershipOptions {\n  /** Checks managed writers; this cannot account for an unmanaged Pi process. */\n  assertQuiescent?: (sourcePath: string) => void | Promise<void>;\n  /** The source format admitted by this owner. Defaults to canonical v4. */\n  sourceFormat?: 'v3' | 'v4' | 'sqlite';\n  /** Additional paths to lock for the lifetime of each acquired source lease. */\n  additionalPaths?: readonly string[];\n}\n\nfunction canonicalSourcePath(sourcePath: string): string {\n  const absolute = path.resolve(sourcePath);\n  if (fs.existsSync(absolute)) return fs.realpathSync(absolute);\n  const segments = [path.basename(absolute)];\n  let parent = path.dirname(absolute);\n  while (!fs.existsSync(parent)) {\n    segments.unshift(path.basename(parent));\n    parent = path.dirname(parent);\n  }\n  return path.join(fs.realpathSync(parent), ...segments);\n}\n\n/** Resolve aliases so every writer and exporter contends for the same lock. */\nexport function historyOwnershipLockPath(sourcePath: string): string {\n  return `${canonicalSourcePath(sourcePath)}${LOCK_SUFFIX}`;\n}\n\nfunction isHistoryObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isV4Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.kind === 'header' && value.v === 4;\n}\n\nfunction isV3Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.type === 'session' && value.version === 3;\n}\n\nfunction readHeader(sourcePath: string, format: 'v3' | 'v4'): unknown {\n  const firstLine = fs.readFileSync(sourcePath, 'utf8').split('\\n', 1)[0] ?? '';\n  try {\n    return JSON.parse(firstLine);\n  } catch (error) {\n    const message =\n      format === 'v4'\n        ? `History ownership source is not canonical v4 JSONL: ${sourcePath}`\n        : `Offline history source is not canonical v3 JSONL: ${sourcePath}`;\n    throw new Error(message, { cause: error });\n  }\n}\n\nfunction assertIndependentRegularFile(sourcePath: string, label: string): void {\n  const stat = fs.statSync(sourcePath);\n  if (!stat.isFile() || stat.nlink !== 1) throw new Error(`${label} must be an independent regular file`);\n}\n\nfunction assertV4Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Canonical history');\n  if (!isV4Header(readHeader(sourcePath, 'v4')))\n    throw new Error(`History ownership only supports canonical v4 sources: ${sourcePath}`);\n}\n\nfunction assertV3Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Offline v3 history source');\n  if (!isV3Header(readHeader(sourcePath, 'v3')))\n    throw new Error(`Offline history import only supports v3 sources: ${sourcePath}`);\n}\n\nfunction assertSqliteSource(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'SQLite history');\n  const descriptor = fs.openSync(sourcePath, 'r');\n  try {\n    const header = Buffer.alloc(16);\n    if (\n      fs.readSync(descriptor, header, 0, header.length, 0) !== header.length ||\n      header.toString('utf8') !== 'SQLite format 3\\u0000'\n    )\n      throw new Error(`History ownership source is not SQLite: ${sourcePath}`);\n  } finally {\n    fs.closeSync(descriptor);\n  }\n}\n\nfunction isFileSystemError(error: unknown): error is NodeJS.ErrnoException {\n  return error instanceof Error && typeof (error as NodeJS.ErrnoException).code === 'string';\n}\n\nfunction readToken(lockPath: string): string | undefined {\n  try {\n    const value = JSON.parse(fs.readFileSync(lockPath, 'utf8')) as Partial<HistoryLockRecord>;\n    return typeof value.token === 'string' ? value.token : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** A dead owner is recoverable only when the entire lock record is recognizable. */\nfunction readRecoverableLock(lockPath: string, sourcePath: string): HistoryLockRecord | undefined {\n  try {\n    const stat = fs.lstatSync(lockPath);\n    if (!stat.isFile() || stat.nlink !== 1) return undefined;\n    const value: unknown = JSON.parse(fs.readFileSync(lockPath, 'utf8'));\n    if (\n      !isHistoryObject(value) ||\n      value.version !== LOCK_VERSION ||\n      value.format !== LOCK_FORMAT ||\n      value.sourcePath !== sourcePath ||\n      !Number.isSafeInteger(value.pid) ||\n      (value.pid as number) <= 0 ||\n      typeof value.token !== 'string' ||\n      !/^[\\da-f]{8}(?:-[\\da-f]{4}){3}-[\\da-f]{12}$/iu.test(value.token)\n    )\n      return undefined;\n    return value as unknown as HistoryLockRecord;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction ownerMayBeAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    return !(isFileSystemError(error) && error.code === 'ESRCH');\n  }\n}\n/** A guard left by a dead acquirer can be retired without touching its source lock. */\nfunction retireDeadGuard(guard: string): boolean {\n  try {\n    const stat = fs.lstatSync(guard);\n    if (!stat.isDirectory()) return false;\n    const entries = fs.readdirSync(guard);\n    // An empty guard might still belong to a process killed between mkdir and\n    // publishing its marker. Fail closed rather than race a new acquirer.\n    if (entries.length !== 1 || !/^owner-[\\da-f-]{36}\\.json$/iu.test(entries[0]!)) return false;\n    const marker = path.join(guard, entries[0]!);\n    const markerStat = fs.lstatSync(marker);\n    if (!markerStat.isFile() || markerStat.nlink !== 1) return false;\n    const owner: unknown = JSON.parse(fs.readFileSync(marker, 'utf8'));\n    if (!isHistoryObject(owner) || !Number.isSafeInteger(owner.pid) || (owner.pid as number) <= 0) return false;\n    if (ownerMayBeAlive(owner.pid as number)) return false;\n    // Only the process that unlinks this unique marker may retire the directory.\n    // Other cleaners see a newly empty guard and refuse to remove it.\n    fs.unlinkSync(marker);\n    fs.rmdirSync(guard);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** All new acquirers hold this guard until their ownership record is durable. */\nfunction withAcquisitionGuard<T>(lockPath: string, acquire: () => T): T {\n  const guard = `${lockPath}.recovery`;\n  try {\n    fs.mkdirSync(guard, { mode: 0o700 });\n  } catch (error) {\n    if (!isFileSystemError(error) || error.code !== 'EEXIST' || !retireDeadGuard(guard)) throw error;\n    fs.mkdirSync(guard, { mode: 0o700 });\n  }\n  const marker = path.join(guard, `owner-${randomUUID()}.json`);\n  try {\n    fs.writeFileSync(marker, JSON.stringify({ pid: process.pid }), { flag: 'wx', mode: 0o600 });\n    return acquire();\n  } finally {\n    fs.rmSync(marker, { force: true });\n    fs.rmdirSync(guard);\n  }\n}\n\n/** Called only under the acquisition guard, before publishing a new owner. */\nfunction recoverDeadOwner(lockPath: string, sourcePath: string): boolean {\n  try {\n    const record = readRecoverableLock(lockPath, sourcePath);\n    if (!record || ownerMayBeAlive(record.pid)) return false;\n    const before = fs.lstatSync(lockPath);\n    if (readRecoverableLock(lockPath, sourcePath)?.token !== record.token || ownerMayBeAlive(record.pid)) return false;\n    const current = fs.lstatSync(lockPath);\n    if (before.dev !== current.dev || before.ino !== current.ino) return false;\n    // The owner is gone, and other recoverers cannot remove this lock while\n    // the guard is held. Legacy writers still contend on the exclusive wx open.\n    fs.unlinkSync(lockPath);\n    return true;\n  } catch (error) {\n    if (isFileSystemError(error) && error.code === 'ENOENT') return false;\n    throw error;\n  }\n}\n\nfunction releaseLock(lockPath: string, token: string, handle: number): void {\n  fs.closeSync(handle);\n  // Recovery only retires a lock after its recorded owner has exited, so that\n  // owner cannot be here releasing it concurrently. A replaced lock is ambiguous.\n  if (readToken(lockPath) === token) fs.rmSync(lockPath, { force: true });\n}\n\nfunction createLease(\n  locks: readonly HeldHistoryLock[],\n  sourcePath: string,\n  assertQuiescent: (sourcePath: string) => void | Promise<void>,\n): HistoryOwnershipLease {\n  let released = false;\n  return {\n    assertQuiescent: () => {\n      if (released) throw new Error('History ownership lease has been released');\n      for (const lock of locks) {\n        const held = fs.fstatSync(lock.handle);\n        const current = fs.statSync(lock.lockPath);\n        if (held.dev !== current.dev || held.ino !== current.ino || readToken(lock.lockPath) !== lock.token) {\n          throw new Error('History ownership lock was replaced');\n        }\n      }\n      return assertQuiescent(sourcePath);\n    },\n    release: () => {\n      if (released) return;\n      released = true;\n      let firstError: unknown;\n      for (const lock of [...locks].reverse()) {\n        try {\n          releaseLock(lock.lockPath, lock.token, lock.handle);\n        } catch (error) {\n          firstError ??= error;\n        }\n      }\n      if (firstError !== undefined) throw firstError;\n    },\n  };\n}\n\n/**\n * Creates the canonical history owner used by runtime writers, export CLI, and\n * the explicit offline importer. The default source boundary remains v4.\n * Complete locks left by a dead process are recovered under an exclusive guard.\n * A live owner or an ambiguous sidecar still blocks acquisition.\n */\nexport function createHistoryOwnership(options: HistoryOwnershipOptions = {}): HistoryOwnership {\n  const assertQuiescent = options.assertQuiescent ?? (() => undefined);\n  const assertSource =\n    options.sourceFormat === 'sqlite'\n      ? assertSqliteSource\n      : options.sourceFormat === 'v3'\n        ? assertV3Source\n        : assertV4Source;\n  return {\n    async acquire(sourcePath: string): Promise<HistoryOwnershipLease> {\n      const absoluteSourcePath = canonicalSourcePath(sourcePath);\n      const paths = [absoluteSourcePath, ...(options.additionalPaths ?? [])].map(canonicalSourcePath);\n      const canonicalPaths = [...new Set(paths)].sort((left, right) => left.localeCompare(right));\n      const locks: HeldHistoryLock[] = [];\n      let conflictingLockPath = historyOwnershipLockPath(absoluteSourcePath);\n      try {\n        for (const lockedPath of canonicalPaths) {\n          const lockPath = historyOwnershipLockPath(lockedPath);\n          conflictingLockPath = lockPath;\n          const token = randomUUID();\n          const record: HistoryLockRecord = {\n            version: LOCK_VERSION,\n            format: LOCK_FORMAT,\n            pid: process.pid,\n            sourcePath: lockedPath,\n            token,\n          };\n          fs.mkdirSync(path.dirname(lockPath), { recursive: true, mode: 0o700 });\n          withAcquisitionGuard(lockPath, () => {\n            let handle: number;\n            try {\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            } catch (error) {\n              if (!isFileSystemError(error) || error.code !== 'EEXIST' || !recoverDeadOwner(lockPath, lockedPath))\n                throw error;\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            }\n            const lock = { lockPath, token, handle };\n            locks.push(lock);\n            fs.writeFileSync(handle, `${JSON.stringify(record)}\\n`, 'utf8');\n            fs.fsyncSync(handle);\n          });\n        }\n        assertSource(absoluteSourcePath);\n      } catch (error) {\n        for (const lock of [...locks].reverse()) {\n          try {\n            releaseLock(lock.lockPath, lock.token, lock.handle);\n          } catch {\n            // Preserve the acquisition failure and never remove a replaced lock.\n          }\n        }\n        if (isFileSystemError(error) && error.code === 'EEXIST') {\n          throw new Error(`History ownership lock already exists or is ambiguous: ${conflictingLockPath}`, {\n            cause: error,\n          });\n        }\n        throw error;\n      }\n      return createLease(locks, absoluteSourcePath, assertQuiescent);\n    },\n  };\n}\n\n/** Explicitly named alias for hosts that want to document the v4 boundary. */\nexport const createV4HistoryOwnership = createHistoryOwnership;\n"],"mappings":"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"}
+{"version":3,"file":"historyOwnership.cjs","names":["path","fs","randomUUID"],"sources":["../src/services/historyOwnership/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { HistoryOwnership, HistoryOwnershipLease } from './type';\n\nconst LOCK_SUFFIX = '.po-v4.lock';\nconst LOCK_VERSION = 1;\nconst LOCK_FORMAT = 'po-v4-history-ownership';\n\ninterface HistoryLockRecord {\n  version: 1;\n  format: 'po-v4-history-ownership';\n  pid: number;\n  sourcePath: string;\n  token: string;\n}\n\ninterface HeldHistoryLock {\n  lockPath: string;\n  token: string;\n  handle: number;\n}\n\nexport interface HistoryOwnershipOptions {\n  /** Checks managed writers; this cannot account for an unmanaged Pi process. */\n  assertQuiescent?: (sourcePath: string) => void | Promise<void>;\n  /** The source format admitted by this owner. Defaults to canonical v4. */\n  sourceFormat?: 'v3' | 'v4' | 'sqlite';\n  /** Additional paths to lock for the lifetime of each acquired source lease. */\n  additionalPaths?: readonly string[];\n}\n\nfunction canonicalSourcePath(sourcePath: string): string {\n  const absolute = path.resolve(sourcePath);\n  if (fs.existsSync(absolute)) return fs.realpathSync(absolute);\n  const segments = [path.basename(absolute)];\n  let parent = path.dirname(absolute);\n  while (!fs.existsSync(parent)) {\n    segments.unshift(path.basename(parent));\n    parent = path.dirname(parent);\n  }\n  return path.join(fs.realpathSync(parent), ...segments);\n}\n\n/** Resolve aliases so every writer and exporter contends for the same lock. */\nexport function historyOwnershipLockPath(sourcePath: string): string {\n  return `${canonicalSourcePath(sourcePath)}${LOCK_SUFFIX}`;\n}\n\nfunction isHistoryObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isV4Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.kind === 'header' && value.v === 4;\n}\n\nfunction isV3Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.type === 'session' && value.version === 3;\n}\n\nfunction readHeader(sourcePath: string, format: 'v3' | 'v4'): unknown {\n  const firstLine = fs.readFileSync(sourcePath, 'utf8').split('\\n', 1)[0] ?? '';\n  try {\n    return JSON.parse(firstLine);\n  } catch (error) {\n    const message =\n      format === 'v4'\n        ? `History ownership source is not canonical v4 JSONL: ${sourcePath}`\n        : `Offline history source is not canonical v3 JSONL: ${sourcePath}`;\n    throw new Error(message, { cause: error });\n  }\n}\n\nfunction assertIndependentRegularFile(sourcePath: string, label: string): void {\n  const stat = fs.statSync(sourcePath);\n  if (!stat.isFile() || stat.nlink !== 1) throw new Error(`${label} must be an independent regular file`);\n}\n\nfunction assertV4Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Canonical history');\n  if (!isV4Header(readHeader(sourcePath, 'v4')))\n    throw new Error(`History ownership only supports canonical v4 sources: ${sourcePath}`);\n}\n\nfunction assertV3Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Offline v3 history source');\n  if (!isV3Header(readHeader(sourcePath, 'v3')))\n    throw new Error(`Offline history import only supports v3 sources: ${sourcePath}`);\n}\n\nfunction assertSqliteSource(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'SQLite history');\n  const descriptor = fs.openSync(sourcePath, 'r');\n  try {\n    const header = Buffer.alloc(16);\n    if (\n      fs.readSync(descriptor, header, 0, header.length, 0) !== header.length ||\n      header.toString('utf8') !== 'SQLite format 3\\u0000'\n    )\n      throw new Error(`History ownership source is not SQLite: ${sourcePath}`);\n  } finally {\n    fs.closeSync(descriptor);\n  }\n}\n\nfunction isFileSystemError(error: unknown): error is NodeJS.ErrnoException {\n  return error instanceof Error && typeof (error as NodeJS.ErrnoException).code === 'string';\n}\n\nfunction readToken(lockPath: string): string | undefined {\n  try {\n    const value = JSON.parse(fs.readFileSync(lockPath, 'utf8')) as Partial<HistoryLockRecord>;\n    return typeof value.token === 'string' ? value.token : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** A dead owner is recoverable only when the entire lock record is recognizable. */\nfunction readRecoverableLock(lockPath: string, sourcePath: string): HistoryLockRecord | undefined {\n  try {\n    const stat = fs.lstatSync(lockPath);\n    if (!stat.isFile() || stat.nlink !== 1) return undefined;\n    const value: unknown = JSON.parse(fs.readFileSync(lockPath, 'utf8'));\n    if (\n      !isHistoryObject(value) ||\n      value.version !== LOCK_VERSION ||\n      value.format !== LOCK_FORMAT ||\n      value.sourcePath !== sourcePath ||\n      !Number.isSafeInteger(value.pid) ||\n      (value.pid as number) <= 0 ||\n      typeof value.token !== 'string' ||\n      !/^[\\da-f]{8}(?:-[\\da-f]{4}){3}-[\\da-f]{12}$/iu.test(value.token)\n    )\n      return undefined;\n    return value as unknown as HistoryLockRecord;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction ownerMayBeAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    return !(isFileSystemError(error) && error.code === 'ESRCH');\n  }\n}\n/** A guard left by a dead acquirer can be retired without touching its source lock. */\nfunction retireDeadGuard(guard: string): boolean {\n  try {\n    const stat = fs.lstatSync(guard);\n    if (!stat.isDirectory()) return false;\n    const entries = fs.readdirSync(guard);\n    // An empty guard might still belong to a process killed between mkdir and\n    // publishing its marker. Fail closed rather than race a new acquirer.\n    if (entries.length !== 1 || !/^owner-[\\da-f-]{36}\\.json$/iu.test(entries[0]!)) return false;\n    const marker = path.join(guard, entries[0]!);\n    const markerStat = fs.lstatSync(marker);\n    if (!markerStat.isFile() || markerStat.nlink !== 1) return false;\n    const owner: unknown = JSON.parse(fs.readFileSync(marker, 'utf8'));\n    if (!isHistoryObject(owner) || !Number.isSafeInteger(owner.pid) || (owner.pid as number) <= 0) return false;\n    if (ownerMayBeAlive(owner.pid as number)) return false;\n    // Only the process that unlinks this unique marker may retire the directory.\n    // Other cleaners see a newly empty guard and refuse to remove it.\n    fs.unlinkSync(marker);\n    fs.rmdirSync(guard);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** All new acquirers hold this guard until their ownership record is durable. */\nfunction withAcquisitionGuard<T>(lockPath: string, acquire: () => T): T {\n  const guard = `${lockPath}.recovery`;\n  try {\n    fs.mkdirSync(guard, { mode: 0o700 });\n  } catch (error) {\n    if (!isFileSystemError(error) || error.code !== 'EEXIST' || !retireDeadGuard(guard)) throw error;\n    fs.mkdirSync(guard, { mode: 0o700 });\n  }\n  const marker = path.join(guard, `owner-${randomUUID()}.json`);\n  try {\n    fs.writeFileSync(marker, JSON.stringify({ pid: process.pid }), { flag: 'wx', mode: 0o600 });\n    return acquire();\n  } finally {\n    fs.rmSync(marker, { force: true });\n    fs.rmdirSync(guard);\n  }\n}\n\n/** Called only under the acquisition guard, before publishing a new owner. */\nfunction recoverDeadOwner(lockPath: string, sourcePath: string): boolean {\n  try {\n    const record = readRecoverableLock(lockPath, sourcePath);\n    if (!record || ownerMayBeAlive(record.pid)) return false;\n    const before = fs.lstatSync(lockPath);\n    if (readRecoverableLock(lockPath, sourcePath)?.token !== record.token || ownerMayBeAlive(record.pid)) return false;\n    const current = fs.lstatSync(lockPath);\n    if (before.dev !== current.dev || before.ino !== current.ino) return false;\n    // The owner is gone, and other recoverers cannot remove this lock while\n    // the guard is held. Legacy writers still contend on the exclusive wx open.\n    fs.unlinkSync(lockPath);\n    return true;\n  } catch (error) {\n    if (isFileSystemError(error) && error.code === 'ENOENT') return false;\n    throw error;\n  }\n}\n\nfunction releaseLock(lockPath: string, token: string, handle: number): void {\n  fs.closeSync(handle);\n  // Recovery only retires a lock after its recorded owner has exited, so that\n  // owner cannot be here releasing it concurrently. A replaced lock is ambiguous.\n  if (readToken(lockPath) === token) fs.rmSync(lockPath, { force: true });\n}\n\nfunction createLease(\n  locks: readonly HeldHistoryLock[],\n  sourcePath: string,\n  assertQuiescent: (sourcePath: string) => void | Promise<void>,\n): HistoryOwnershipLease {\n  let released = false;\n  return {\n    assertQuiescent: () => {\n      if (released) throw new Error('History ownership lease has been released');\n      for (const lock of locks) {\n        const held = fs.fstatSync(lock.handle);\n        const current = fs.statSync(lock.lockPath);\n        if (held.dev !== current.dev || held.ino !== current.ino || readToken(lock.lockPath) !== lock.token) {\n          throw new Error('History ownership lock was replaced');\n        }\n      }\n      return assertQuiescent(sourcePath);\n    },\n    release: () => {\n      if (released) return;\n      released = true;\n      let firstError: unknown;\n      for (const lock of [...locks].reverse()) {\n        try {\n          releaseLock(lock.lockPath, lock.token, lock.handle);\n        } catch (error) {\n          firstError ??= error;\n        }\n      }\n      if (firstError !== undefined) throw firstError;\n    },\n  };\n}\n\n/**\n * Creates the canonical history owner used by runtime writers, export CLI, and\n * the explicit offline importer. The default source boundary remains v4.\n * Complete locks left by a dead process are recovered under an exclusive guard.\n * A live owner or an ambiguous sidecar still blocks acquisition.\n */\nexport function createHistoryOwnership(options: HistoryOwnershipOptions = {}): HistoryOwnership {\n  const assertQuiescent = options.assertQuiescent ?? (() => undefined);\n  const assertSource =\n    options.sourceFormat === 'sqlite'\n      ? assertSqliteSource\n      : options.sourceFormat === 'v3'\n        ? assertV3Source\n        : assertV4Source;\n  return {\n    async acquire(sourcePath: string): Promise<HistoryOwnershipLease> {\n      const absoluteSourcePath = canonicalSourcePath(sourcePath);\n      const paths = [absoluteSourcePath, ...(options.additionalPaths ?? [])].map(canonicalSourcePath);\n      const canonicalPaths = [...new Set(paths)].sort((left, right) => left.localeCompare(right));\n      const locks: HeldHistoryLock[] = [];\n      let conflictingLockPath = historyOwnershipLockPath(absoluteSourcePath);\n      try {\n        for (const lockedPath of canonicalPaths) {\n          const lockPath = historyOwnershipLockPath(lockedPath);\n          conflictingLockPath = lockPath;\n          const token = randomUUID();\n          const record: HistoryLockRecord = {\n            version: LOCK_VERSION,\n            format: LOCK_FORMAT,\n            pid: process.pid,\n            sourcePath: lockedPath,\n            token,\n          };\n          fs.mkdirSync(path.dirname(lockPath), { recursive: true, mode: 0o700 });\n          withAcquisitionGuard(lockPath, () => {\n            let handle: number;\n            try {\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            } catch (error) {\n              if (!isFileSystemError(error) || error.code !== 'EEXIST' || !recoverDeadOwner(lockPath, lockedPath))\n                throw error;\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            }\n            const lock = { lockPath, token, handle };\n            locks.push(lock);\n            fs.writeFileSync(handle, `${JSON.stringify(record)}\\n`, 'utf8');\n            fs.fsyncSync(handle);\n          });\n        }\n        assertSource(absoluteSourcePath);\n      } catch (error) {\n        for (const lock of [...locks].reverse()) {\n          try {\n            releaseLock(lock.lockPath, lock.token, lock.handle);\n          } catch {\n            // Preserve the acquisition failure and never remove a replaced lock.\n          }\n        }\n        if (isFileSystemError(error) && error.code === 'EEXIST') {\n          throw new Error(`History ownership lock already exists or is ambiguous: ${conflictingLockPath}`, {\n            cause: error,\n          });\n        }\n        throw error;\n      }\n      return createLease(locks, absoluteSourcePath, assertQuiescent);\n    },\n  };\n}\n\n/** Explicitly named alias for hosts that want to document the v4 boundary. */\nexport const createV4HistoryOwnership = createHistoryOwnership;\n"],"mappings":"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"}

package/dist/historyOwnership.d.mts

@@ -1,4 +1,4 @@
-import { HistoryOwnership } from "./src/services/historyImport/index.mjs";
+import { HistoryOwnership } from "./src/services/historyOwnership/type.mjs";
 //#region src/services/historyOwnership/index.d.ts
 export interface HistoryOwnershipOptions {
   /** Checks managed writers; this cannot account for an unmanaged Pi process. */

package/dist/historyOwnership.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"historyOwnership.mjs","names":[],"sources":["../src/services/historyOwnership/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { HistoryOwnership, HistoryOwnershipLease } from '../historyImport';\n\nconst LOCK_SUFFIX = '.po-v4.lock';\nconst LOCK_VERSION = 1;\nconst LOCK_FORMAT = 'po-v4-history-ownership';\n\ninterface HistoryLockRecord {\n  version: 1;\n  format: 'po-v4-history-ownership';\n  pid: number;\n  sourcePath: string;\n  token: string;\n}\n\ninterface HeldHistoryLock {\n  lockPath: string;\n  token: string;\n  handle: number;\n}\n\nexport interface HistoryOwnershipOptions {\n  /** Checks managed writers; this cannot account for an unmanaged Pi process. */\n  assertQuiescent?: (sourcePath: string) => void | Promise<void>;\n  /** The source format admitted by this owner. Defaults to canonical v4. */\n  sourceFormat?: 'v3' | 'v4' | 'sqlite';\n  /** Additional paths to lock for the lifetime of each acquired source lease. */\n  additionalPaths?: readonly string[];\n}\n\nfunction canonicalSourcePath(sourcePath: string): string {\n  const absolute = path.resolve(sourcePath);\n  if (fs.existsSync(absolute)) return fs.realpathSync(absolute);\n  const segments = [path.basename(absolute)];\n  let parent = path.dirname(absolute);\n  while (!fs.existsSync(parent)) {\n    segments.unshift(path.basename(parent));\n    parent = path.dirname(parent);\n  }\n  return path.join(fs.realpathSync(parent), ...segments);\n}\n\n/** Resolve aliases so every writer and exporter contends for the same lock. */\nexport function historyOwnershipLockPath(sourcePath: string): string {\n  return `${canonicalSourcePath(sourcePath)}${LOCK_SUFFIX}`;\n}\n\nfunction isHistoryObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isV4Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.kind === 'header' && value.v === 4;\n}\n\nfunction isV3Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.type === 'session' && value.version === 3;\n}\n\nfunction readHeader(sourcePath: string, format: 'v3' | 'v4'): unknown {\n  const firstLine = fs.readFileSync(sourcePath, 'utf8').split('\\n', 1)[0] ?? '';\n  try {\n    return JSON.parse(firstLine);\n  } catch (error) {\n    const message =\n      format === 'v4'\n        ? `History ownership source is not canonical v4 JSONL: ${sourcePath}`\n        : `Offline history source is not canonical v3 JSONL: ${sourcePath}`;\n    throw new Error(message, { cause: error });\n  }\n}\n\nfunction assertIndependentRegularFile(sourcePath: string, label: string): void {\n  const stat = fs.statSync(sourcePath);\n  if (!stat.isFile() || stat.nlink !== 1) throw new Error(`${label} must be an independent regular file`);\n}\n\nfunction assertV4Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Canonical history');\n  if (!isV4Header(readHeader(sourcePath, 'v4')))\n    throw new Error(`History ownership only supports canonical v4 sources: ${sourcePath}`);\n}\n\nfunction assertV3Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Offline v3 history source');\n  if (!isV3Header(readHeader(sourcePath, 'v3')))\n    throw new Error(`Offline history import only supports v3 sources: ${sourcePath}`);\n}\n\nfunction assertSqliteSource(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'SQLite history');\n  const descriptor = fs.openSync(sourcePath, 'r');\n  try {\n    const header = Buffer.alloc(16);\n    if (\n      fs.readSync(descriptor, header, 0, header.length, 0) !== header.length ||\n      header.toString('utf8') !== 'SQLite format 3\\u0000'\n    )\n      throw new Error(`History ownership source is not SQLite: ${sourcePath}`);\n  } finally {\n    fs.closeSync(descriptor);\n  }\n}\n\nfunction isFileSystemError(error: unknown): error is NodeJS.ErrnoException {\n  return error instanceof Error && typeof (error as NodeJS.ErrnoException).code === 'string';\n}\n\nfunction readToken(lockPath: string): string | undefined {\n  try {\n    const value = JSON.parse(fs.readFileSync(lockPath, 'utf8')) as Partial<HistoryLockRecord>;\n    return typeof value.token === 'string' ? value.token : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** A dead owner is recoverable only when the entire lock record is recognizable. */\nfunction readRecoverableLock(lockPath: string, sourcePath: string): HistoryLockRecord | undefined {\n  try {\n    const stat = fs.lstatSync(lockPath);\n    if (!stat.isFile() || stat.nlink !== 1) return undefined;\n    const value: unknown = JSON.parse(fs.readFileSync(lockPath, 'utf8'));\n    if (\n      !isHistoryObject(value) ||\n      value.version !== LOCK_VERSION ||\n      value.format !== LOCK_FORMAT ||\n      value.sourcePath !== sourcePath ||\n      !Number.isSafeInteger(value.pid) ||\n      (value.pid as number) <= 0 ||\n      typeof value.token !== 'string' ||\n      !/^[\\da-f]{8}(?:-[\\da-f]{4}){3}-[\\da-f]{12}$/iu.test(value.token)\n    )\n      return undefined;\n    return value as unknown as HistoryLockRecord;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction ownerMayBeAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    return !(isFileSystemError(error) && error.code === 'ESRCH');\n  }\n}\n/** A guard left by a dead acquirer can be retired without touching its source lock. */\nfunction retireDeadGuard(guard: string): boolean {\n  try {\n    const stat = fs.lstatSync(guard);\n    if (!stat.isDirectory()) return false;\n    const entries = fs.readdirSync(guard);\n    // An empty guard might still belong to a process killed between mkdir and\n    // publishing its marker. Fail closed rather than race a new acquirer.\n    if (entries.length !== 1 || !/^owner-[\\da-f-]{36}\\.json$/iu.test(entries[0]!)) return false;\n    const marker = path.join(guard, entries[0]!);\n    const markerStat = fs.lstatSync(marker);\n    if (!markerStat.isFile() || markerStat.nlink !== 1) return false;\n    const owner: unknown = JSON.parse(fs.readFileSync(marker, 'utf8'));\n    if (!isHistoryObject(owner) || !Number.isSafeInteger(owner.pid) || (owner.pid as number) <= 0) return false;\n    if (ownerMayBeAlive(owner.pid as number)) return false;\n    // Only the process that unlinks this unique marker may retire the directory.\n    // Other cleaners see a newly empty guard and refuse to remove it.\n    fs.unlinkSync(marker);\n    fs.rmdirSync(guard);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** All new acquirers hold this guard until their ownership record is durable. */\nfunction withAcquisitionGuard<T>(lockPath: string, acquire: () => T): T {\n  const guard = `${lockPath}.recovery`;\n  try {\n    fs.mkdirSync(guard, { mode: 0o700 });\n  } catch (error) {\n    if (!isFileSystemError(error) || error.code !== 'EEXIST' || !retireDeadGuard(guard)) throw error;\n    fs.mkdirSync(guard, { mode: 0o700 });\n  }\n  const marker = path.join(guard, `owner-${randomUUID()}.json`);\n  try {\n    fs.writeFileSync(marker, JSON.stringify({ pid: process.pid }), { flag: 'wx', mode: 0o600 });\n    return acquire();\n  } finally {\n    fs.rmSync(marker, { force: true });\n    fs.rmdirSync(guard);\n  }\n}\n\n/** Called only under the acquisition guard, before publishing a new owner. */\nfunction recoverDeadOwner(lockPath: string, sourcePath: string): boolean {\n  try {\n    const record = readRecoverableLock(lockPath, sourcePath);\n    if (!record || ownerMayBeAlive(record.pid)) return false;\n    const before = fs.lstatSync(lockPath);\n    if (readRecoverableLock(lockPath, sourcePath)?.token !== record.token || ownerMayBeAlive(record.pid)) return false;\n    const current = fs.lstatSync(lockPath);\n    if (before.dev !== current.dev || before.ino !== current.ino) return false;\n    // The owner is gone, and other recoverers cannot remove this lock while\n    // the guard is held. Legacy writers still contend on the exclusive wx open.\n    fs.unlinkSync(lockPath);\n    return true;\n  } catch (error) {\n    if (isFileSystemError(error) && error.code === 'ENOENT') return false;\n    throw error;\n  }\n}\n\nfunction releaseLock(lockPath: string, token: string, handle: number): void {\n  fs.closeSync(handle);\n  // Recovery only retires a lock after its recorded owner has exited, so that\n  // owner cannot be here releasing it concurrently. A replaced lock is ambiguous.\n  if (readToken(lockPath) === token) fs.rmSync(lockPath, { force: true });\n}\n\nfunction createLease(\n  locks: readonly HeldHistoryLock[],\n  sourcePath: string,\n  assertQuiescent: (sourcePath: string) => void | Promise<void>,\n): HistoryOwnershipLease {\n  let released = false;\n  return {\n    assertQuiescent: () => {\n      if (released) throw new Error('History ownership lease has been released');\n      for (const lock of locks) {\n        const held = fs.fstatSync(lock.handle);\n        const current = fs.statSync(lock.lockPath);\n        if (held.dev !== current.dev || held.ino !== current.ino || readToken(lock.lockPath) !== lock.token) {\n          throw new Error('History ownership lock was replaced');\n        }\n      }\n      return assertQuiescent(sourcePath);\n    },\n    release: () => {\n      if (released) return;\n      released = true;\n      let firstError: unknown;\n      for (const lock of [...locks].reverse()) {\n        try {\n          releaseLock(lock.lockPath, lock.token, lock.handle);\n        } catch (error) {\n          firstError ??= error;\n        }\n      }\n      if (firstError !== undefined) throw firstError;\n    },\n  };\n}\n\n/**\n * Creates the canonical history owner used by runtime writers, export CLI, and\n * the explicit offline importer. The default source boundary remains v4.\n * Complete locks left by a dead process are recovered under an exclusive guard.\n * A live owner or an ambiguous sidecar still blocks acquisition.\n */\nexport function createHistoryOwnership(options: HistoryOwnershipOptions = {}): HistoryOwnership {\n  const assertQuiescent = options.assertQuiescent ?? (() => undefined);\n  const assertSource =\n    options.sourceFormat === 'sqlite'\n      ? assertSqliteSource\n      : options.sourceFormat === 'v3'\n        ? assertV3Source\n        : assertV4Source;\n  return {\n    async acquire(sourcePath: string): Promise<HistoryOwnershipLease> {\n      const absoluteSourcePath = canonicalSourcePath(sourcePath);\n      const paths = [absoluteSourcePath, ...(options.additionalPaths ?? [])].map(canonicalSourcePath);\n      const canonicalPaths = [...new Set(paths)].sort((left, right) => left.localeCompare(right));\n      const locks: HeldHistoryLock[] = [];\n      let conflictingLockPath = historyOwnershipLockPath(absoluteSourcePath);\n      try {\n        for (const lockedPath of canonicalPaths) {\n          const lockPath = historyOwnershipLockPath(lockedPath);\n          conflictingLockPath = lockPath;\n          const token = randomUUID();\n          const record: HistoryLockRecord = {\n            version: LOCK_VERSION,\n            format: LOCK_FORMAT,\n            pid: process.pid,\n            sourcePath: lockedPath,\n            token,\n          };\n          fs.mkdirSync(path.dirname(lockPath), { recursive: true, mode: 0o700 });\n          withAcquisitionGuard(lockPath, () => {\n            let handle: number;\n            try {\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            } catch (error) {\n              if (!isFileSystemError(error) || error.code !== 'EEXIST' || !recoverDeadOwner(lockPath, lockedPath))\n                throw error;\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            }\n            const lock = { lockPath, token, handle };\n            locks.push(lock);\n            fs.writeFileSync(handle, `${JSON.stringify(record)}\\n`, 'utf8');\n            fs.fsyncSync(handle);\n          });\n        }\n        assertSource(absoluteSourcePath);\n      } catch (error) {\n        for (const lock of [...locks].reverse()) {\n          try {\n            releaseLock(lock.lockPath, lock.token, lock.handle);\n          } catch {\n            // Preserve the acquisition failure and never remove a replaced lock.\n          }\n        }\n        if (isFileSystemError(error) && error.code === 'EEXIST') {\n          throw new Error(`History ownership lock already exists or is ambiguous: ${conflictingLockPath}`, {\n            cause: error,\n          });\n        }\n        throw error;\n      }\n      return createLease(locks, absoluteSourcePath, assertQuiescent);\n    },\n  };\n}\n\n/** Explicitly named alias for hosts that want to document the v4 boundary. */\nexport const createV4HistoryOwnership = createHistoryOwnership;\n"],"mappings":"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"}
+{"version":3,"file":"historyOwnership.mjs","names":[],"sources":["../src/services/historyOwnership/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { HistoryOwnership, HistoryOwnershipLease } from './type';\n\nconst LOCK_SUFFIX = '.po-v4.lock';\nconst LOCK_VERSION = 1;\nconst LOCK_FORMAT = 'po-v4-history-ownership';\n\ninterface HistoryLockRecord {\n  version: 1;\n  format: 'po-v4-history-ownership';\n  pid: number;\n  sourcePath: string;\n  token: string;\n}\n\ninterface HeldHistoryLock {\n  lockPath: string;\n  token: string;\n  handle: number;\n}\n\nexport interface HistoryOwnershipOptions {\n  /** Checks managed writers; this cannot account for an unmanaged Pi process. */\n  assertQuiescent?: (sourcePath: string) => void | Promise<void>;\n  /** The source format admitted by this owner. Defaults to canonical v4. */\n  sourceFormat?: 'v3' | 'v4' | 'sqlite';\n  /** Additional paths to lock for the lifetime of each acquired source lease. */\n  additionalPaths?: readonly string[];\n}\n\nfunction canonicalSourcePath(sourcePath: string): string {\n  const absolute = path.resolve(sourcePath);\n  if (fs.existsSync(absolute)) return fs.realpathSync(absolute);\n  const segments = [path.basename(absolute)];\n  let parent = path.dirname(absolute);\n  while (!fs.existsSync(parent)) {\n    segments.unshift(path.basename(parent));\n    parent = path.dirname(parent);\n  }\n  return path.join(fs.realpathSync(parent), ...segments);\n}\n\n/** Resolve aliases so every writer and exporter contends for the same lock. */\nexport function historyOwnershipLockPath(sourcePath: string): string {\n  return `${canonicalSourcePath(sourcePath)}${LOCK_SUFFIX}`;\n}\n\nfunction isHistoryObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isV4Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.kind === 'header' && value.v === 4;\n}\n\nfunction isV3Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.type === 'session' && value.version === 3;\n}\n\nfunction readHeader(sourcePath: string, format: 'v3' | 'v4'): unknown {\n  const firstLine = fs.readFileSync(sourcePath, 'utf8').split('\\n', 1)[0] ?? '';\n  try {\n    return JSON.parse(firstLine);\n  } catch (error) {\n    const message =\n      format === 'v4'\n        ? `History ownership source is not canonical v4 JSONL: ${sourcePath}`\n        : `Offline history source is not canonical v3 JSONL: ${sourcePath}`;\n    throw new Error(message, { cause: error });\n  }\n}\n\nfunction assertIndependentRegularFile(sourcePath: string, label: string): void {\n  const stat = fs.statSync(sourcePath);\n  if (!stat.isFile() || stat.nlink !== 1) throw new Error(`${label} must be an independent regular file`);\n}\n\nfunction assertV4Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Canonical history');\n  if (!isV4Header(readHeader(sourcePath, 'v4')))\n    throw new Error(`History ownership only supports canonical v4 sources: ${sourcePath}`);\n}\n\nfunction assertV3Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Offline v3 history source');\n  if (!isV3Header(readHeader(sourcePath, 'v3')))\n    throw new Error(`Offline history import only supports v3 sources: ${sourcePath}`);\n}\n\nfunction assertSqliteSource(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'SQLite history');\n  const descriptor = fs.openSync(sourcePath, 'r');\n  try {\n    const header = Buffer.alloc(16);\n    if (\n      fs.readSync(descriptor, header, 0, header.length, 0) !== header.length ||\n      header.toString('utf8') !== 'SQLite format 3\\u0000'\n    )\n      throw new Error(`History ownership source is not SQLite: ${sourcePath}`);\n  } finally {\n    fs.closeSync(descriptor);\n  }\n}\n\nfunction isFileSystemError(error: unknown): error is NodeJS.ErrnoException {\n  return error instanceof Error && typeof (error as NodeJS.ErrnoException).code === 'string';\n}\n\nfunction readToken(lockPath: string): string | undefined {\n  try {\n    const value = JSON.parse(fs.readFileSync(lockPath, 'utf8')) as Partial<HistoryLockRecord>;\n    return typeof value.token === 'string' ? value.token : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** A dead owner is recoverable only when the entire lock record is recognizable. */\nfunction readRecoverableLock(lockPath: string, sourcePath: string): HistoryLockRecord | undefined {\n  try {\n    const stat = fs.lstatSync(lockPath);\n    if (!stat.isFile() || stat.nlink !== 1) return undefined;\n    const value: unknown = JSON.parse(fs.readFileSync(lockPath, 'utf8'));\n    if (\n      !isHistoryObject(value) ||\n      value.version !== LOCK_VERSION ||\n      value.format !== LOCK_FORMAT ||\n      value.sourcePath !== sourcePath ||\n      !Number.isSafeInteger(value.pid) ||\n      (value.pid as number) <= 0 ||\n      typeof value.token !== 'string' ||\n      !/^[\\da-f]{8}(?:-[\\da-f]{4}){3}-[\\da-f]{12}$/iu.test(value.token)\n    )\n      return undefined;\n    return value as unknown as HistoryLockRecord;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction ownerMayBeAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    return !(isFileSystemError(error) && error.code === 'ESRCH');\n  }\n}\n/** A guard left by a dead acquirer can be retired without touching its source lock. */\nfunction retireDeadGuard(guard: string): boolean {\n  try {\n    const stat = fs.lstatSync(guard);\n    if (!stat.isDirectory()) return false;\n    const entries = fs.readdirSync(guard);\n    // An empty guard might still belong to a process killed between mkdir and\n    // publishing its marker. Fail closed rather than race a new acquirer.\n    if (entries.length !== 1 || !/^owner-[\\da-f-]{36}\\.json$/iu.test(entries[0]!)) return false;\n    const marker = path.join(guard, entries[0]!);\n    const markerStat = fs.lstatSync(marker);\n    if (!markerStat.isFile() || markerStat.nlink !== 1) return false;\n    const owner: unknown = JSON.parse(fs.readFileSync(marker, 'utf8'));\n    if (!isHistoryObject(owner) || !Number.isSafeInteger(owner.pid) || (owner.pid as number) <= 0) return false;\n    if (ownerMayBeAlive(owner.pid as number)) return false;\n    // Only the process that unlinks this unique marker may retire the directory.\n    // Other cleaners see a newly empty guard and refuse to remove it.\n    fs.unlinkSync(marker);\n    fs.rmdirSync(guard);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** All new acquirers hold this guard until their ownership record is durable. */\nfunction withAcquisitionGuard<T>(lockPath: string, acquire: () => T): T {\n  const guard = `${lockPath}.recovery`;\n  try {\n    fs.mkdirSync(guard, { mode: 0o700 });\n  } catch (error) {\n    if (!isFileSystemError(error) || error.code !== 'EEXIST' || !retireDeadGuard(guard)) throw error;\n    fs.mkdirSync(guard, { mode: 0o700 });\n  }\n  const marker = path.join(guard, `owner-${randomUUID()}.json`);\n  try {\n    fs.writeFileSync(marker, JSON.stringify({ pid: process.pid }), { flag: 'wx', mode: 0o600 });\n    return acquire();\n  } finally {\n    fs.rmSync(marker, { force: true });\n    fs.rmdirSync(guard);\n  }\n}\n\n/** Called only under the acquisition guard, before publishing a new owner. */\nfunction recoverDeadOwner(lockPath: string, sourcePath: string): boolean {\n  try {\n    const record = readRecoverableLock(lockPath, sourcePath);\n    if (!record || ownerMayBeAlive(record.pid)) return false;\n    const before = fs.lstatSync(lockPath);\n    if (readRecoverableLock(lockPath, sourcePath)?.token !== record.token || ownerMayBeAlive(record.pid)) return false;\n    const current = fs.lstatSync(lockPath);\n    if (before.dev !== current.dev || before.ino !== current.ino) return false;\n    // The owner is gone, and other recoverers cannot remove this lock while\n    // the guard is held. Legacy writers still contend on the exclusive wx open.\n    fs.unlinkSync(lockPath);\n    return true;\n  } catch (error) {\n    if (isFileSystemError(error) && error.code === 'ENOENT') return false;\n    throw error;\n  }\n}\n\nfunction releaseLock(lockPath: string, token: string, handle: number): void {\n  fs.closeSync(handle);\n  // Recovery only retires a lock after its recorded owner has exited, so that\n  // owner cannot be here releasing it concurrently. A replaced lock is ambiguous.\n  if (readToken(lockPath) === token) fs.rmSync(lockPath, { force: true });\n}\n\nfunction createLease(\n  locks: readonly HeldHistoryLock[],\n  sourcePath: string,\n  assertQuiescent: (sourcePath: string) => void | Promise<void>,\n): HistoryOwnershipLease {\n  let released = false;\n  return {\n    assertQuiescent: () => {\n      if (released) throw new Error('History ownership lease has been released');\n      for (const lock of locks) {\n        const held = fs.fstatSync(lock.handle);\n        const current = fs.statSync(lock.lockPath);\n        if (held.dev !== current.dev || held.ino !== current.ino || readToken(lock.lockPath) !== lock.token) {\n          throw new Error('History ownership lock was replaced');\n        }\n      }\n      return assertQuiescent(sourcePath);\n    },\n    release: () => {\n      if (released) return;\n      released = true;\n      let firstError: unknown;\n      for (const lock of [...locks].reverse()) {\n        try {\n          releaseLock(lock.lockPath, lock.token, lock.handle);\n        } catch (error) {\n          firstError ??= error;\n        }\n      }\n      if (firstError !== undefined) throw firstError;\n    },\n  };\n}\n\n/**\n * Creates the canonical history owner used by runtime writers, export CLI, and\n * the explicit offline importer. The default source boundary remains v4.\n * Complete locks left by a dead process are recovered under an exclusive guard.\n * A live owner or an ambiguous sidecar still blocks acquisition.\n */\nexport function createHistoryOwnership(options: HistoryOwnershipOptions = {}): HistoryOwnership {\n  const assertQuiescent = options.assertQuiescent ?? (() => undefined);\n  const assertSource =\n    options.sourceFormat === 'sqlite'\n      ? assertSqliteSource\n      : options.sourceFormat === 'v3'\n        ? assertV3Source\n        : assertV4Source;\n  return {\n    async acquire(sourcePath: string): Promise<HistoryOwnershipLease> {\n      const absoluteSourcePath = canonicalSourcePath(sourcePath);\n      const paths = [absoluteSourcePath, ...(options.additionalPaths ?? [])].map(canonicalSourcePath);\n      const canonicalPaths = [...new Set(paths)].sort((left, right) => left.localeCompare(right));\n      const locks: HeldHistoryLock[] = [];\n      let conflictingLockPath = historyOwnershipLockPath(absoluteSourcePath);\n      try {\n        for (const lockedPath of canonicalPaths) {\n          const lockPath = historyOwnershipLockPath(lockedPath);\n          conflictingLockPath = lockPath;\n          const token = randomUUID();\n          const record: HistoryLockRecord = {\n            version: LOCK_VERSION,\n            format: LOCK_FORMAT,\n            pid: process.pid,\n            sourcePath: lockedPath,\n            token,\n          };\n          fs.mkdirSync(path.dirname(lockPath), { recursive: true, mode: 0o700 });\n          withAcquisitionGuard(lockPath, () => {\n            let handle: number;\n            try {\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            } catch (error) {\n              if (!isFileSystemError(error) || error.code !== 'EEXIST' || !recoverDeadOwner(lockPath, lockedPath))\n                throw error;\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            }\n            const lock = { lockPath, token, handle };\n            locks.push(lock);\n            fs.writeFileSync(handle, `${JSON.stringify(record)}\\n`, 'utf8');\n            fs.fsyncSync(handle);\n          });\n        }\n        assertSource(absoluteSourcePath);\n      } catch (error) {\n        for (const lock of [...locks].reverse()) {\n          try {\n            releaseLock(lock.lockPath, lock.token, lock.handle);\n          } catch {\n            // Preserve the acquisition failure and never remove a replaced lock.\n          }\n        }\n        if (isFileSystemError(error) && error.code === 'EEXIST') {\n          throw new Error(`History ownership lock already exists or is ambiguous: ${conflictingLockPath}`, {\n            cause: error,\n          });\n        }\n        throw error;\n      }\n      return createLease(locks, absoluteSourcePath, assertQuiescent);\n    },\n  };\n}\n\n/** Explicitly named alias for hosts that want to document the v4 boundary. */\nexport const createV4HistoryOwnership = createHistoryOwnership;\n"],"mappings":"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"}

package/dist/hubChannel.cjs

@@ -1,4 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_hubChannel = require("./src/schemas/hubChannel.cjs");
+const require_home = require("./src/schemas/home.cjs");
+exports.HOME_ENTITY_LIMIT = require_home.HOME_ENTITY_LIMIT;
+exports.HOME_KINDS = require_home.HOME_KINDS;
+exports.HOME_PAGE_LIMIT = require_home.HOME_PAGE_LIMIT;
+exports.REMOTE_CONVERSATION_SESSION_PROVENANCE = require_hubChannel.REMOTE_CONVERSATION_SESSION_PROVENANCE;
 exports.WORKFLOW_DISPATCHER_SESSION_PROVENANCE = require_hubChannel.WORKFLOW_DISPATCHER_SESSION_PROVENANCE;
 exports.WORKFLOW_STEP_SESSION_PROVENANCE = require_hubChannel.WORKFLOW_STEP_SESSION_PROVENANCE;
+exports.parseHomeContribution = require_home.parseHomeContribution;
+exports.parseHomeEntity = require_home.parseHomeEntity;
+exports.parseHomeProjection = require_home.parseHomeProjection;
+exports.parseHomeSnapshot = require_home.parseHomeSnapshot;

package/dist/hubChannel.d.mts

@@ -1,2 +1,3 @@
-import { DoomComputerUseHostBinding, DoomComputerUseHostOperation, DoomComputerUseHostRequest, DoomComputerUseSessionAccess, DoomDirectEventBus, DoomDirectEventSubscriptionOptions, DoomHubChannel, DoomHubChannelConnection, DoomHubChannelFrame, DoomHubChannelHost, DoomHubChannelLifecycle, DoomHubChannelSource, DoomHubReservedWorktreeProvisioner, DoomHubReservedWorktreeRequest, DoomHubSessionApiRequest, DoomHubSessionCreateRequest, DoomHubSessionExecutionState, DoomHubSessionPromptOptions, DoomHubSessionPromptReceipt, DoomHubSessionReservations, DoomHubSessionScope, DoomHubSessionSelection, DoomHubSessionService, DoomPendingSessionSetup, DoomSessionActivity, DoomSessionCommunicationEndpoint, DoomSessionContext, WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE } from "./src/schemas/hubChannel.mjs";
-export { DoomComputerUseHostBinding, DoomComputerUseHostOperation, DoomComputerUseHostRequest, DoomComputerUseSessionAccess, DoomDirectEventBus, DoomDirectEventSubscriptionOptions, DoomHubChannel, DoomHubChannelConnection, DoomHubChannelFrame, DoomHubChannelHost, DoomHubChannelLifecycle, DoomHubChannelSource, DoomHubReservedWorktreeProvisioner, DoomHubReservedWorktreeRequest, DoomHubSessionApiRequest, DoomHubSessionCreateRequest, DoomHubSessionExecutionState, DoomHubSessionPromptOptions, DoomHubSessionPromptReceipt, DoomHubSessionReservations, DoomHubSessionScope, DoomHubSessionSelection, DoomHubSessionService, DoomPendingSessionSetup, DoomSessionActivity, DoomSessionCommunicationEndpoint, DoomSessionContext, WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE };
+import { HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, HomeContribution, HomeCoverage, HomeEntity, HomeItem, HomeKind, HomeProjection, HomeRequest, HomeSnapshot, HomeSourceStatus, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot } from "./src/schemas/home.mjs";
+import { PoComputerUseHostBinding, PoComputerUseHostOperation, PoComputerUseHostRequest, PoComputerUseSessionAccess, PoDirectEventBus, PoDirectEventSubscriptionOptions, PoHubChannel, PoHubChannelConnection, PoHubChannelFrame, PoHubChannelHost, PoHubChannelLifecycle, PoHubChannelSource, PoHubReservedWorktreeProvisioner, PoHubReservedWorktreeRequest, PoHubSessionApiRequest, PoHubSessionCreateRequest, PoHubSessionExecutionState, PoHubSessionPromptOptions, PoHubSessionPromptReceipt, PoHubSessionReservations, PoHubSessionScope, PoHubSessionSelection, PoHubSessionService, PoPendingSessionSetup, PoSessionActivity, PoSessionCommunicationEndpoint, PoSessionContext, PoSessionPeerDescription, REMOTE_CONVERSATION_SESSION_PROVENANCE, WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE } from "./src/schemas/hubChannel.mjs";
+export { HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, HomeContribution, HomeCoverage, HomeEntity, HomeItem, HomeKind, HomeProjection, HomeRequest, HomeSnapshot, HomeSourceStatus, PoComputerUseHostBinding, PoComputerUseHostOperation, PoComputerUseHostRequest, PoComputerUseSessionAccess, PoDirectEventBus, PoDirectEventSubscriptionOptions, PoHubChannel, PoHubChannelConnection, PoHubChannelFrame, PoHubChannelHost, PoHubChannelLifecycle, PoHubChannelSource, PoHubReservedWorktreeProvisioner, PoHubReservedWorktreeRequest, PoHubSessionApiRequest, PoHubSessionCreateRequest, PoHubSessionExecutionState, PoHubSessionPromptOptions, PoHubSessionPromptReceipt, PoHubSessionReservations, PoHubSessionScope, PoHubSessionSelection, PoHubSessionService, PoPendingSessionSetup, PoSessionActivity, PoSessionCommunicationEndpoint, PoSessionContext, PoSessionPeerDescription, REMOTE_CONVERSATION_SESSION_PROVENANCE, WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot };

package/dist/hubChannel.mjs

@@ -1,2 +1,3 @@
-import { WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE } from "./src/schemas/hubChannel.mjs";
-export { WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE };
+import { REMOTE_CONVERSATION_SESSION_PROVENANCE, WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE } from "./src/schemas/hubChannel.mjs";
+import { HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot } from "./src/schemas/home.mjs";
+export { HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, REMOTE_CONVERSATION_SESSION_PROVENANCE, WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot };

package/dist/index.cjs

@@ -8,37 +8,35 @@ exports.AskUserBlockedEventSchema = require_askUser.AskUserBlockedEventSchema;
 exports.AskUserPromptEventSchema = require_askUser.AskUserPromptEventSchema;
 exports.AskUserPromptOptionSchema = require_askUser.AskUserPromptOptionSchema;
 exports.AskUserPromptQuestionSchema = require_askUser.AskUserPromptQuestionSchema;
-exports.DOOM_ASK_USER_BLOCKED_EVENT = require_askUser.DOOM_ASK_USER_BLOCKED_EVENT;
-exports.DOOM_ASK_USER_PROMPT_EVENT = require_askUser.DOOM_ASK_USER_PROMPT_EVENT;
-exports.DOOM_COCKPIT_SERVER_ID = require_sessionProtocol.DOOM_COCKPIT_SERVER_ID;
-exports.DOOM_NARRATION_SERVICE = require_narration.DOOM_NARRATION_SERVICE;
-exports.DOOM_NOTIFICATION_ENTRY_TYPE = require_notification.DOOM_NOTIFICATION_ENTRY_TYPE;
-exports.DOOM_NOTIFICATION_ENTRY_VERSION = require_notification.DOOM_NOTIFICATION_ENTRY_VERSION;
-exports.DOOM_NOTIFICATION_SERVICE = require_notification.DOOM_NOTIFICATION_SERVICE;
-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.DoomNotificationEntryDataSchema = require_notification.DoomNotificationEntryDataSchema;
-exports.DoomNotificationLevelSchema = require_notification.DoomNotificationLevelSchema;
-exports.DoomNotificationRequestSchema = require_notification.DoomNotificationRequestSchema;
-exports.DoomProtocolError = require_runtimeProtocol.DoomProtocolError;
-exports.DoomProtocolValidationError = require_runtimeProtocol.DoomProtocolValidationError;
-exports.DoomSessionManagementService = require_sessionProtocol.DoomSessionManagementService;
-exports.DoomSessionService = require_sessionProtocol.DoomSessionService;
-exports.MAX_DOOM_NOTIFICATION_BODY_CHARACTERS = require_notification.MAX_DOOM_NOTIFICATION_BODY_CHARACTERS;
-exports.MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS = require_notification.MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS;
-exports.MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS = require_notification.MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS;
 exports.MAX_NARRATION_TEXT_CHARACTERS = require_narration.MAX_NARRATION_TEXT_CHARACTERS;
+exports.MAX_PO_NOTIFICATION_BODY_CHARACTERS = require_notification.MAX_PO_NOTIFICATION_BODY_CHARACTERS;
+exports.MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS = require_notification.MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS;
+exports.MAX_PO_NOTIFICATION_TITLE_CHARACTERS = require_notification.MAX_PO_NOTIFICATION_TITLE_CHARACTERS;
+exports.MAX_SESSION_GROUPS = require_sessionProtocol.MAX_SESSION_GROUPS;
+exports.MAX_SESSION_GROUP_LENGTH = require_sessionProtocol.MAX_SESSION_GROUP_LENGTH;
 exports.NarrationRequestSchema = require_narration.NarrationRequestSchema;
-exports.createDoomNotificationEntryData = require_notification.createDoomNotificationEntryData;
+exports.PO_ASK_USER_BLOCKED_EVENT = require_askUser.PO_ASK_USER_BLOCKED_EVENT;
+exports.PO_ASK_USER_PROMPT_EVENT = require_askUser.PO_ASK_USER_PROMPT_EVENT;
+exports.PO_NARRATION_SERVICE = require_narration.PO_NARRATION_SERVICE;
+exports.PO_NOTIFICATION_ENTRY_TYPE = require_notification.PO_NOTIFICATION_ENTRY_TYPE;
+exports.PO_NOTIFICATION_ENTRY_VERSION = require_notification.PO_NOTIFICATION_ENTRY_VERSION;
+exports.PO_NOTIFICATION_SERVICE = require_notification.PO_NOTIFICATION_SERVICE;
+exports.PoNotificationEntryDataSchema = require_notification.PoNotificationEntryDataSchema;
+exports.PoNotificationLevelSchema = require_notification.PoNotificationLevelSchema;
+exports.PoNotificationRequestSchema = require_notification.PoNotificationRequestSchema;
+exports.PoProtocolError = require_runtimeProtocol.PoProtocolError;
+exports.PoProtocolValidationError = require_runtimeProtocol.PoProtocolValidationError;
+exports.SESSION_GROUPS_CHANGED_FRAME = require_sessionProtocol.SESSION_GROUPS_CHANGED_FRAME;
 exports.createNarrationRequest = require_narration.createNarrationRequest;
+exports.createPoNotificationEntryData = require_notification.createPoNotificationEntryData;
 exports.createProtocolRuntime = require_runtimeProtocol.createProtocolRuntime;
-exports.isDoomNotificationEntryData = require_notification.isDoomNotificationEntryData;
-exports.isDoomNotificationRequest = require_notification.isDoomNotificationRequest;
 exports.isNarrationRequest = require_narration.isNarrationRequest;
-exports.normalizeDoomNotificationRequest = require_notification.normalizeDoomNotificationRequest;
+exports.isPoNotificationEntryData = require_notification.isPoNotificationEntryData;
+exports.isPoNotificationRequest = require_notification.isPoNotificationRequest;
 exports.normalizeNarrationText = require_narration.normalizeNarrationText;
-exports.readDoomNarrationService = require_narration.readDoomNarrationService;
-exports.readDoomNotificationService = require_notification.readDoomNotificationService;
-exports.requireDoomNarrationService = require_narration.requireDoomNarrationService;
-exports.requireDoomNotificationService = require_notification.requireDoomNotificationService;
+exports.normalizePoNotificationRequest = require_notification.normalizePoNotificationRequest;
+exports.normalizeSessionGroups = require_sessionProtocol.normalizeSessionGroups;
+exports.readPoNarrationService = require_narration.readPoNarrationService;
+exports.readPoNotificationService = require_notification.readPoNotificationService;
+exports.requirePoNarrationService = require_narration.requirePoNarrationService;
+exports.requirePoNotificationService = require_notification.requirePoNotificationService;

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { AskUserBlockedEvent, AskUserBlockedEventSchema, AskUserPromptEvent, AskUserPromptEventSchema, AskUserPromptOption, AskUserPromptOptionSchema, AskUserPromptQuestion, AskUserPromptQuestionSchema, DOOM_ASK_USER_BLOCKED_EVENT, DOOM_ASK_USER_PROMPT_EVENT } from "./src/schemas/askUser.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";
-import { DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DoomNotificationEntryData, DoomNotificationEntryDataSchema, DoomNotificationLevel, DoomNotificationLevelSchema, DoomNotificationRequest, DoomNotificationRequestSchema, DoomNotificationService, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, createDoomNotificationEntryData, isDoomNotificationEntryData, isDoomNotificationRequest, normalizeDoomNotificationRequest, readDoomNotificationService, requireDoomNotificationService } from "./src/schemas/notification.mjs";
-import { DOOM_NARRATION_SERVICE, DoomNarrationService, MAX_NARRATION_TEXT_CHARACTERS, NarrationRequest, NarrationRequestSchema, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readDoomNarrationService, requireDoomNarrationService } from "./src/schemas/narration.mjs";
-import { DoomProtocolError, DoomProtocolValidationError, EventBusLike, ProtocolRuntime, ProtocolRuntimeOptions, RequestOptions, createProtocolRuntime } from "./runtimeProtocol.mjs";
-export { AskUserBlockedEvent, AskUserBlockedEventSchema, AskUserPromptEvent, AskUserPromptEventSchema, AskUserPromptOption, AskUserPromptOptionSchema, AskUserPromptQuestion, AskUserPromptQuestionSchema, AssistantTranscriptItem, ClearQueueResult, DOOM_ASK_USER_BLOCKED_EVENT, DOOM_ASK_USER_PROMPT_EVENT, DOOM_COCKPIT_SERVER_ID, DOOM_NARRATION_SERVICE, DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomNarrationService, DoomNotificationEntryData, DoomNotificationEntryDataSchema, DoomNotificationLevel, DoomNotificationLevelSchema, DoomNotificationRequest, DoomNotificationRequestSchema, DoomNotificationService, DoomProtocolError, DoomProtocolValidationError, DoomSessionManagementService, DoomSessionService, type EventBusLike, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, MAX_NARRATION_TEXT_CHARACTERS, ModelRef, NarrationRequest, NarrationRequestSchema, PromoteQueuedArgs, PromptArgs, ProtocolEvent, type ProtocolRuntime, type ProtocolRuntimeOptions, QueuedItemArgs, type RequestOptions, 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, createDoomNotificationEntryData, createNarrationRequest, createProtocolRuntime, isDoomNotificationEntryData, isDoomNotificationRequest, isNarrationRequest, normalizeDoomNotificationRequest, normalizeNarrationText, readDoomNarrationService, readDoomNotificationService, requireDoomNarrationService, requireDoomNotificationService };
+import { AskUserBlockedEvent, AskUserBlockedEventSchema, AskUserPromptEvent, AskUserPromptEventSchema, AskUserPromptOption, AskUserPromptOptionSchema, AskUserPromptQuestion, AskUserPromptQuestionSchema, PO_ASK_USER_BLOCKED_EVENT, PO_ASK_USER_PROMPT_EVENT } from "./src/schemas/askUser.mjs";
+import { AssistantTranscriptItem, ClearQueueResult, ExtensionUiResponse, FollowUpArgs, ImageContentPart, JsonValue, MAX_SESSION_GROUPS, MAX_SESSION_GROUP_LENGTH, ModelRef, PromoteQueuedArgs, PromptArgs, ProtocolEvent, QueuedItemArgs, RewindArgs, RewindResult, RewindSummaryEntry, SESSION_GROUPS_CHANGED_FRAME, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionLive, SessionLiveTool, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, UserTranscriptItem, normalizeSessionGroups } from "./src/schemas/sessionProtocol.mjs";
+import { MAX_PO_NOTIFICATION_BODY_CHARACTERS, MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_PO_NOTIFICATION_TITLE_CHARACTERS, PO_NOTIFICATION_ENTRY_TYPE, PO_NOTIFICATION_ENTRY_VERSION, PO_NOTIFICATION_SERVICE, PoNotificationEntryData, PoNotificationEntryDataSchema, PoNotificationLevel, PoNotificationLevelSchema, PoNotificationRequest, PoNotificationRequestSchema, PoNotificationService, createPoNotificationEntryData, isPoNotificationEntryData, isPoNotificationRequest, normalizePoNotificationRequest, readPoNotificationService, requirePoNotificationService } from "./src/schemas/notification.mjs";
+import { MAX_NARRATION_TEXT_CHARACTERS, NarrationRequest, NarrationRequestSchema, PO_NARRATION_SERVICE, PoNarrationService, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readPoNarrationService, requirePoNarrationService } from "./src/schemas/narration.mjs";
+import { EventBusLike, PoProtocolError, PoProtocolValidationError, ProtocolRuntime, ProtocolRuntimeOptions, RequestOptions, createProtocolRuntime } from "./runtimeProtocol.mjs";
+export { AskUserBlockedEvent, AskUserBlockedEventSchema, AskUserPromptEvent, AskUserPromptEventSchema, AskUserPromptOption, AskUserPromptOptionSchema, AskUserPromptQuestion, AskUserPromptQuestionSchema, AssistantTranscriptItem, ClearQueueResult, type EventBusLike, ExtensionUiResponse, FollowUpArgs, ImageContentPart, JsonValue, MAX_NARRATION_TEXT_CHARACTERS, MAX_PO_NOTIFICATION_BODY_CHARACTERS, MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_PO_NOTIFICATION_TITLE_CHARACTERS, MAX_SESSION_GROUPS, MAX_SESSION_GROUP_LENGTH, ModelRef, NarrationRequest, NarrationRequestSchema, PO_ASK_USER_BLOCKED_EVENT, PO_ASK_USER_PROMPT_EVENT, PO_NARRATION_SERVICE, PO_NOTIFICATION_ENTRY_TYPE, PO_NOTIFICATION_ENTRY_VERSION, PO_NOTIFICATION_SERVICE, PoNarrationService, PoNotificationEntryData, PoNotificationEntryDataSchema, PoNotificationLevel, PoNotificationLevelSchema, PoNotificationRequest, PoNotificationRequestSchema, PoNotificationService, PoProtocolError, PoProtocolValidationError, PromoteQueuedArgs, PromptArgs, ProtocolEvent, type ProtocolRuntime, type ProtocolRuntimeOptions, QueuedItemArgs, type RequestOptions, RewindArgs, RewindResult, RewindSummaryEntry, SESSION_GROUPS_CHANGED_FRAME, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionLive, SessionLiveTool, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, UserTranscriptItem, createNarrationRequest, createPoNotificationEntryData, createProtocolRuntime, isNarrationRequest, isPoNotificationEntryData, isPoNotificationRequest, normalizeNarrationText, normalizePoNotificationRequest, normalizeSessionGroups, readPoNarrationService, readPoNotificationService, requirePoNarrationService, requirePoNotificationService };

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { AskUserBlockedEventSchema, AskUserPromptEventSchema, AskUserPromptOptionSchema, AskUserPromptQuestionSchema, DOOM_ASK_USER_BLOCKED_EVENT, DOOM_ASK_USER_PROMPT_EVENT } from "./src/schemas/askUser.mjs";
-import { DOOM_NARRATION_SERVICE, MAX_NARRATION_TEXT_CHARACTERS, NarrationRequestSchema, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readDoomNarrationService, requireDoomNarrationService } from "./src/schemas/narration.mjs";
-import { DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DoomNotificationEntryDataSchema, DoomNotificationLevelSchema, DoomNotificationRequestSchema, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, createDoomNotificationEntryData, isDoomNotificationEntryData, isDoomNotificationRequest, normalizeDoomNotificationRequest, readDoomNotificationService, requireDoomNotificationService } from "./src/schemas/notification.mjs";
-import { DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService } from "./src/schemas/sessionProtocol.mjs";
-import { DoomProtocolError, DoomProtocolValidationError, createProtocolRuntime } from "./runtimeProtocol.mjs";
-export { AskUserBlockedEventSchema, AskUserPromptEventSchema, AskUserPromptOptionSchema, AskUserPromptQuestionSchema, DOOM_ASK_USER_BLOCKED_EVENT, DOOM_ASK_USER_PROMPT_EVENT, DOOM_COCKPIT_SERVER_ID, DOOM_NARRATION_SERVICE, DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomNotificationEntryDataSchema, DoomNotificationLevelSchema, DoomNotificationRequestSchema, DoomProtocolError, DoomProtocolValidationError, DoomSessionManagementService, DoomSessionService, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, MAX_NARRATION_TEXT_CHARACTERS, NarrationRequestSchema, createDoomNotificationEntryData, createNarrationRequest, createProtocolRuntime, isDoomNotificationEntryData, isDoomNotificationRequest, isNarrationRequest, normalizeDoomNotificationRequest, normalizeNarrationText, readDoomNarrationService, readDoomNotificationService, requireDoomNarrationService, requireDoomNotificationService };
+import { AskUserBlockedEventSchema, AskUserPromptEventSchema, AskUserPromptOptionSchema, AskUserPromptQuestionSchema, PO_ASK_USER_BLOCKED_EVENT, PO_ASK_USER_PROMPT_EVENT } from "./src/schemas/askUser.mjs";
+import { MAX_NARRATION_TEXT_CHARACTERS, NarrationRequestSchema, PO_NARRATION_SERVICE, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readPoNarrationService, requirePoNarrationService } from "./src/schemas/narration.mjs";
+import { MAX_PO_NOTIFICATION_BODY_CHARACTERS, MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_PO_NOTIFICATION_TITLE_CHARACTERS, PO_NOTIFICATION_ENTRY_TYPE, PO_NOTIFICATION_ENTRY_VERSION, PO_NOTIFICATION_SERVICE, PoNotificationEntryDataSchema, PoNotificationLevelSchema, PoNotificationRequestSchema, createPoNotificationEntryData, isPoNotificationEntryData, isPoNotificationRequest, normalizePoNotificationRequest, readPoNotificationService, requirePoNotificationService } from "./src/schemas/notification.mjs";
+import { MAX_SESSION_GROUPS, MAX_SESSION_GROUP_LENGTH, SESSION_GROUPS_CHANGED_FRAME, normalizeSessionGroups } from "./src/schemas/sessionProtocol.mjs";
+import { PoProtocolError, PoProtocolValidationError, createProtocolRuntime } from "./runtimeProtocol.mjs";
+export { AskUserBlockedEventSchema, AskUserPromptEventSchema, AskUserPromptOptionSchema, AskUserPromptQuestionSchema, MAX_NARRATION_TEXT_CHARACTERS, MAX_PO_NOTIFICATION_BODY_CHARACTERS, MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_PO_NOTIFICATION_TITLE_CHARACTERS, MAX_SESSION_GROUPS, MAX_SESSION_GROUP_LENGTH, NarrationRequestSchema, PO_ASK_USER_BLOCKED_EVENT, PO_ASK_USER_PROMPT_EVENT, PO_NARRATION_SERVICE, PO_NOTIFICATION_ENTRY_TYPE, PO_NOTIFICATION_ENTRY_VERSION, PO_NOTIFICATION_SERVICE, PoNotificationEntryDataSchema, PoNotificationLevelSchema, PoNotificationRequestSchema, PoProtocolError, PoProtocolValidationError, SESSION_GROUPS_CHANGED_FRAME, createNarrationRequest, createPoNotificationEntryData, createProtocolRuntime, isNarrationRequest, isPoNotificationEntryData, isPoNotificationRequest, normalizeNarrationText, normalizePoNotificationRequest, normalizeSessionGroups, readPoNarrationService, readPoNotificationService, requirePoNarrationService, requirePoNotificationService };

package/dist/interop/chord.mjs

@@ -0,0 +1 @@
+export * from '@earendil-works/chord';

package/dist/interop/chordContext.mjs

@@ -0,0 +1 @@
+export * from '@earendil-works/chord/context';

package/dist/json.cjs

@@ -1,6 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_runtimeJson = require("./runtimeJson.cjs");
-exports.isRecord = require_runtimeJson.isRecord;
-exports.readJson = require_runtimeJson.readJson;
-exports.writeFileAtomic = require_runtimeJson.writeFileAtomic;
-exports.writeJson = require_runtimeJson.writeJson;
+const require_core = require("./src/services/json/core.cjs");
+const require_sync = require("./src/services/json/sync.cjs");
+require("./runtimeJson.cjs");
+exports.isRecord = require_core.isRecord;
+exports.parseJsonObject = require_core.parseJsonObject;
+exports.readJson = require_sync.readJson;
+exports.readJsonAsync = require_core.readJsonAsync;
+exports.serializeJson = require_core.serializeJson;
+exports.writeFileAtomic = require_sync.writeFileAtomic;
+exports.writeJson = require_sync.writeJson;
+exports.writeJsonAsync = require_core.writeJsonAsync;

package/dist/json.d.mts

@@ -1,2 +1,4 @@
-import { JsonObject, isRecord, readJson, writeFileAtomic, writeJson } from "./runtimeJson.mjs";
-export { JsonObject, isRecord, readJson, writeFileAtomic, writeJson };
+import { JsonObject, isRecord, parseJsonObject, readJsonAsync, serializeJson, writeJsonAsync } from "./src/services/json/core.mjs";
+import { readJson, writeFileAtomic, writeJson } from "./src/services/json/sync.mjs";
+import "./runtimeJson.mjs";
+export { JsonObject, isRecord, parseJsonObject, readJson, readJsonAsync, serializeJson, writeFileAtomic, writeJson, writeJsonAsync };

package/dist/json.mjs

@@ -1,2 +1,4 @@
-import { isRecord, readJson, writeFileAtomic, writeJson } from "./runtimeJson.mjs";
-export { isRecord, readJson, writeFileAtomic, writeJson };
+import { isRecord, parseJsonObject, readJsonAsync, serializeJson, writeJsonAsync } from "./src/services/json/core.mjs";
+import { readJson, writeFileAtomic, writeJson } from "./src/services/json/sync.mjs";
+import "./runtimeJson.mjs";
+export { isRecord, parseJsonObject, readJson, readJsonAsync, serializeJson, writeFileAtomic, writeJson, writeJsonAsync };

package/dist/kernel.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_index = require("./src/services/kernel/index.cjs");
-exports.createDoomKernel = require_index.createDoomKernel;
+exports.createPoKernel = require_index.createPoKernel;

package/dist/kernel.d.mts

@@ -1,3 +1,3 @@
-import { DoomKernel, KernelContribution, KernelRegistration, KernelSlotHandle, KernelSlotSink } from "./src/types/kernel.mjs";
-import { CreateDoomKernelOptions, createDoomKernel } from "./src/services/kernel/index.mjs";
-export { type CreateDoomKernelOptions, type DoomKernel, type KernelContribution, type KernelRegistration, type KernelSlotHandle, type KernelSlotSink, createDoomKernel };
+import { KernelContribution, KernelRegistration, KernelSlotHandle, KernelSlotSink, PoKernel } from "./src/types/kernel.mjs";
+import { CreatePoKernelOptions, createPoKernel } from "./src/services/kernel/index.mjs";
+export { type CreatePoKernelOptions, type KernelContribution, type KernelRegistration, type KernelSlotHandle, type KernelSlotSink, type PoKernel, createPoKernel };