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

package/dist/src/server/headlessProtocol.mjs

@@ -0,0 +1,366 @@
+import { DOOM_COCKPIT_SERVER_ID, DoomHubService, DoomSessionManagementService } from "../schemas/sessionProtocol.mjs";
+import { harnessErrorMessage } from "./harnessErrorMessage.mjs";
+import "../../sessionProtocol.mjs";
+import { createAgentServerService } from "../pi/piSessionRuntime.mjs";
+import { DoomPluginService } from "../schemas/pluginProtocol.mjs";
+import "../../pluginProtocol.mjs";
+import { createPiWebSocketListener } from "../pi/piWebSocketListener.mjs";
+import { createThreadJournals } from "./threadJournals.mjs";
+import { randomUUID } from "node:crypto";
+import { RemoteServiceProvider, createRemoteServiceEndpoint, replicatedState } from "@earendil-works/chord";
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import { Server, SessionNotFoundError } from "@earendil-works/pi-server";
+//#region src/server/headlessProtocol.ts
+const MAX_HUB_EVENTS = 1024;
+function sessionView(session) {
+	return {
+		id: session.id,
+		...session.workspaceId === void 0 ? {} : { workspaceId: session.workspaceId },
+		...session.webComposition === void 0 ? {} : { webComposition: { ...session.webComposition } },
+		name: session.name,
+		cwd: session.cwd,
+		createdAt: session.createdAt,
+		updatedAt: session.updatedAt ?? session.createdAt,
+		phase: session.phase ?? "idle",
+		phaseSince: session.phaseSince ?? session.createdAt,
+		attach: "attached",
+		pendingMessageCount: session.pendingMessageCount ?? 0,
+		everPrompted: session.everPrompted ?? false,
+		awaitingInput: session.awaitingInput ?? false,
+		...session.lastSettledAt === void 0 ? {} : { lastSettledAt: session.lastSettledAt },
+		...session.git === void 0 ? {} : { git: {
+			branch: session.git.branch,
+			dirty: session.git.dirty
+		} },
+		...session.profile === void 0 ? {} : { profile: {
+			name: session.profile.name,
+			...session.profile.displayName === void 0 ? {} : { displayName: session.profile.displayName },
+			...session.profile.iconVersion === void 0 ? {} : { iconVersion: session.profile.iconVersion }
+		} },
+		...session.parentSessionId === void 0 ? {} : { parentSessionId: session.parentSessionId },
+		...session.sessionProvenance === void 0 ? {} : { sessionProvenance: session.sessionProvenance },
+		...session.pendingSetups === void 0 ? {} : { pendingSetups: session.pendingSetups.map((setup) => ({
+			id: setup.id,
+			name: setup.name,
+			createdAt: setup.createdAt,
+			...setup.cwd === void 0 ? {} : { cwd: setup.cwd },
+			...setup.setupKind === void 0 ? {} : { setupKind: setup.setupKind },
+			...setup.status === void 0 ? {} : { status: setup.status },
+			...setup.errorCode === void 0 ? {} : { errorCode: setup.errorCode }
+		})) }
+	};
+}
+/**
+* A recorded session with no runtime behind it yet.
+*
+* Carries the same field set as a live session so the rail keys both by id and
+* swaps one for the other in place once the server reopens the journal.
+*/
+function dormantView(record) {
+	return {
+		id: record.sessionId,
+		workspaceId: record.workspaceId,
+		name: record.name,
+		cwd: record.cwd,
+		createdAt: record.createdAt,
+		updatedAt: record.createdAt,
+		phase: "idle",
+		phaseSince: record.createdAt,
+		attach: "attached",
+		pendingMessageCount: 0,
+		everPrompted: false,
+		awaitingInput: false,
+		dormant: true,
+		...record.parentSessionId === void 0 ? {} : { parentSessionId: record.parentSessionId },
+		...record.sessionProvenance === void 0 ? {} : { sessionProvenance: record.sessionProvenance }
+	};
+}
+function endpointAttachment(endpoint) {
+	return {
+		invokeService: (call, publish, context) => endpoint.invoke(call, publish, context),
+		release: () => endpoint.dispose()
+	};
+}
+function metadataOf(session) {
+	const createdAt = Date.parse(session.createdAt);
+	return {
+		id: session.id,
+		createdAt: Number.isFinite(createdAt) ? createdAt : 0,
+		storageVersion: 1,
+		cwd: session.cwd,
+		sessionName: session.name
+	};
+}
+function frameOf(event) {
+	switch (event.kind) {
+		case "upsert": return {
+			type: "session_upsert",
+			session: sessionView(event.session)
+		};
+		case "removed": return {
+			type: "session_removed",
+			sessionId: event.sessionId
+		};
+		case "workspace_upsert": return {
+			type: "workspace_upsert",
+			workspace: {
+				id: event.workspace.id,
+				root: event.workspace.root,
+				...event.workspace.name === void 0 ? {} : { name: event.workspace.name },
+				available: event.workspace.available !== false
+			}
+		};
+		case "workspace_removed": return {
+			type: "workspace_removed",
+			workspaceId: event.workspaceId
+		};
+		case "channel": return {
+			type: event.frameType,
+			sessionId: event.sessionId,
+			payload: event.payload
+		};
+	}
+}
+function permitsSession(hub, mount, sessionId, authorize = () => true) {
+	const session = hub.session(sessionId);
+	return session !== void 0 && authorize(sessionId) && (mount.scope === "global" || session.workspaceId === mount.workspaceId && (mount.scope === "workspace" || mount.sessionId === sessionId));
+}
+function permitsDormant(mount, record) {
+	if (mount.scope === "global") return true;
+	if (record.workspaceId !== mount.workspaceId) return false;
+	return mount.scope === "workspace" || mount.sessionId === record.sessionId;
+}
+function managementHost(hub, threads, mount, dormantSessions, authorizeSession, authorizeDesktop) {
+	return { attachClient(presentation) {
+		const connectionId = randomUUID();
+		const subscriptions = /* @__PURE__ */ new Set();
+		const threadSubscriptions = /* @__PURE__ */ new Set();
+		const state = replicatedState({ events: [] });
+		let sequence = 0;
+		let released = false;
+		const publish = (frame) => {
+			sequence += 1;
+			state.change(BACKGROUND_CONTEXT, (draft) => {
+				draft.events.push({
+					sequence,
+					frame
+				});
+				if (draft.events.length > MAX_HUB_EVENTS) draft.events.shift();
+			});
+		};
+		const visible = new Set(hub.snapshot().filter((session) => permitsSession(hub, mount, session.id, authorizeSession)).map((session) => session.id));
+		publish({
+			type: "sessions_snapshot",
+			sessions: [...hub.snapshot().filter((session) => visible.has(session.id)).map(sessionView), ...dormantSessions().filter((record) => !visible.has(record.sessionId) && permitsDormant(mount, record)).map(dormantView)]
+		});
+		publish({
+			type: "workspaces_snapshot",
+			workspaces: hub.workspaces().filter((workspace) => mount.scope === "global" || workspace.id === mount.workspaceId).map((workspace) => ({
+				id: workspace.id,
+				root: workspace.root,
+				...workspace.name === void 0 ? {} : { name: workspace.name },
+				available: workspace.available !== false
+			}))
+		});
+		const stopEvents = hub.onEvent((event) => {
+			if (event.kind === "workspace_upsert" || event.kind === "workspace_removed") {
+				const workspaceId = event.kind === "workspace_upsert" ? event.workspace.id : event.workspaceId;
+				if (mount.scope !== "global" && mount.workspaceId !== workspaceId) return;
+				publish(frameOf(event));
+				return;
+			}
+			if (event.kind === "removed") {
+				if (!visible.delete(event.sessionId)) return;
+				const record = event.dormant === true ? dormantSessions().find((candidate) => candidate.sessionId === event.sessionId) : void 0;
+				if (record !== void 0 && permitsDormant(mount, record)) {
+					publish({
+						type: "session_upsert",
+						session: dormantView(record)
+					});
+					return;
+				}
+			} else {
+				const id = event.kind === "upsert" ? event.session.id : event.sessionId;
+				if (!permitsSession(hub, mount, id, authorizeSession)) return;
+				if (event.kind === "upsert") visible.add(id);
+			}
+			if (event.kind === "channel") {
+				if (event.frameType === "computer_use_state" && !authorizeDesktop()) return;
+				if (!subscriptions.has(event.sessionId)) return;
+				if (event.connectionId !== void 0 && event.connectionId !== connectionId) return;
+			}
+			publish(frameOf(event));
+		});
+		const stopThreadFrames = threads.onFrame((event) => {
+			if (!authorizeSession(event.sessionId) || !threadSubscriptions.has(`${event.sessionId}\n${event.threadId}`)) return;
+			publish({
+				type: "thread_frame",
+				sessionId: event.sessionId,
+				threadId: event.threadId,
+				frame: event.frame
+			});
+		});
+		const service = {
+			state,
+			async send(frame) {
+				const sessionId = typeof frame.sessionId === "string" ? frame.sessionId : void 0;
+				if (sessionId !== void 0 && !authorizeSession(sessionId)) throw new SessionNotFoundError("This session belongs to Desktop.");
+				if (sessionId !== void 0 && !permitsSession(hub, mount, sessionId)) return;
+				if (frame.type === "subscribe" && sessionId !== void 0) {
+					if (!hub.session(sessionId)) return;
+					subscriptions.add(sessionId);
+					for (const channelFrame of hub.channelFrames(sessionId)) if (channelFrame.type !== "computer_use_state" || authorizeDesktop()) publish(channelFrame);
+					return;
+				}
+				if (frame.type === "unsubscribe" && sessionId !== void 0) {
+					subscriptions.delete(sessionId);
+					return;
+				}
+				const threadId = typeof frame.threadId === "string" ? frame.threadId : void 0;
+				if ((frame.type === "subscribe_thread" || frame.type === "unsubscribe_thread") && threadId !== void 0) {
+					const key = `${sessionId ?? ""}\n${threadId}`;
+					if (sessionId === void 0) return;
+					if (frame.type === "unsubscribe_thread") {
+						if (threadSubscriptions.delete(key)) threads.unsubscribe(sessionId, threadId);
+						return;
+					}
+					if (threadSubscriptions.has(key)) return;
+					threadSubscriptions.add(key);
+					publish({
+						type: "thread_backlog",
+						sessionId,
+						threadId,
+						frames: threads.subscribe(sessionId, threadId)
+					});
+					return;
+				}
+				if (sessionId !== void 0) hub.receiveChannel(sessionId, frame.type, frame.payload, connectionId, authorizeDesktop());
+			}
+		};
+		const provider = new RemoteServiceProvider([
+			{
+				service: DoomSessionManagementService,
+				mode: "singleton"
+			},
+			{
+				service: DoomHubService,
+				mode: "singleton"
+			},
+			{
+				service: DoomPluginService,
+				mode: "singleton"
+			}
+		]);
+		provider.provide(DoomHubService, service);
+		provider.provide(DoomPluginService, { async invoke(call) {
+			if (call.mount.scope === "session" && !authorizeSession(call.mount.sessionId)) throw new Error("This session belongs to its Desktop instance.");
+			if (mount.scope !== "global") {
+				if (!(call.mount.scope === "session" ? permitsSession(hub, mount, call.mount.sessionId) : mount.scope === "workspace" && call.mount.scope === "workspace" && call.mount.workspaceId === mount.workspaceId)) throw new Error("Plugin is outside this WebSocket scope.");
+			}
+			return await hub.invokePlugin(call, "client-to-server", { connectionId });
+		} });
+		provider.provide(DoomSessionManagementService, {
+			attach: (sessionId, context) => {
+				if (!authorizeSession(sessionId)) throw new SessionNotFoundError("This session belongs to Desktop.");
+				return presentation.attachSession(sessionId, context);
+			},
+			detach: (context) => presentation.detachSession(context)
+		});
+		const attachment = endpointAttachment(createRemoteServiceEndpoint(provider));
+		return {
+			invokeService: attachment.invokeService,
+			release() {
+				if (released) return;
+				released = true;
+				stopEvents();
+				stopThreadFrames();
+				for (const key of threadSubscriptions) {
+					const [sessionId, threadId] = key.split("\n");
+					if (sessionId !== void 0 && threadId !== void 0) threads.unsubscribe(sessionId, threadId);
+				}
+				threadSubscriptions.clear();
+				subscriptions.clear();
+				hub.disconnectChannels(connectionId);
+				provider.dispose();
+				attachment.release();
+			}
+		};
+	} };
+}
+function protocolHost(hub, threads, telemetry, mount, dormantSessions, authorizeSession, authorizeDesktop) {
+	return {
+		serverServices: managementHost(hub, threads, mount, dormantSessions, authorizeSession, authorizeDesktop),
+		async resolveSession(sessionId) {
+			const session = hub.session(sessionId);
+			if (!session || !permitsSession(hub, mount, session.id, authorizeSession)) throw new SessionNotFoundError(`No session ${sessionId}`);
+			return metadataOf(session);
+		},
+		async openSession(metadata, context) {
+			const session = hub.session(metadata.id);
+			if (!session || !permitsSession(hub, mount, session.id, authorizeSession)) throw new SessionNotFoundError(`No session ${metadata.id}`);
+			const permitted = () => hub.session(session.id)?.host === session.host && authorizeSession(session.id);
+			const handle = await createAgentServerService({
+				runtime: session.host.runtime,
+				onPresentationFrame: (listener) => session.host.onPresentationFrame((frame) => {
+					if (permitted()) listener(frame);
+				}),
+				respondToExtensionUi: (frame) => {
+					if (!permitted()) throw new SessionNotFoundError("This session belongs to Desktop.");
+					return session.host.respondToExtensionUi(frame);
+				},
+				readThreadTranscript: (threadId, request, readContext) => {
+					if (!permitted()) throw new SessionNotFoundError("This session belongs to Desktop.");
+					return threads.readPage(session.id, threadId, request, readContext);
+				},
+				sessionId: session.id,
+				sessionName: session.name,
+				cwd: session.cwd,
+				createdAt: metadataOf(session).createdAt,
+				telemetry
+			}).openSession(metadata, context);
+			return {
+				...handle,
+				async attachClient(...args) {
+					const attachment = await handle.attachClient(...args);
+					return {
+						...attachment,
+						invokeService(call, publish, invocationContext) {
+							if (!permitted()) throw new SessionNotFoundError("This session belongs to Desktop.");
+							return attachment.invokeService(call, (...values) => {
+								if (permitted()) return publish(...values);
+							}, invocationContext);
+						}
+					};
+				},
+				terminated: session.host.runtime.exited.then(async () => {
+					await handle.close(BACKGROUND_CONTEXT);
+				})
+			};
+		}
+	};
+}
+/** Hosts the browser's Pi 0.85 connection directly over the process-local hub. */
+async function createHeadlessProtocol(options) {
+	const listener = createPiWebSocketListener({ onError: (error) => options.onNotice?.(error.message) });
+	const threads = createThreadJournals({ resolve: (sessionId, threadId) => options.hub.threadJournal(sessionId, threadId) });
+	const server = await new Server(protocolHost(options.hub, threads, options.telemetry, options.mount ?? { scope: "global" }, () => options.dormantSessions === void 0 ? [] : options.dormantSessions(), options.authorizeSession ?? ((id) => !options.hub.computerUse?.ownsSession?.(id)), options.authorizeDesktop ?? (() => false)), {
+		listeners: [listener],
+		serverId: DOOM_COCKPIT_SERVER_ID,
+		onError: (error) => options.onNotice?.(`headless protocol error (${harnessErrorMessage(error)})`)
+	}).start();
+	let closing;
+	return {
+		accept: (socket) => listener.accept(socket),
+		close() {
+			closing ??= (async () => {
+				threads.close();
+				await server.close();
+			})();
+			return closing;
+		}
+	};
+}
+//#endregion
+export { createHeadlessProtocol };
+
+//# sourceMappingURL=headlessProtocol.mjs.map

package/dist/src/server/headlessProtocol.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"headlessProtocol.mjs","names":[],"sources":["../../../src/server/headlessProtocol.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport {\n  createRemoteServiceEndpoint,\n  RemoteServiceProvider,\n  replicatedState,\n  type JsonValue,\n  type RemoteServiceEndpoint,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { RoutedServerServiceHost, RoutedSessionHandle, ServerHost } from '@earendil-works/pi-server';\nimport { Server, SessionNotFoundError } from '@earendil-works/pi-server';\n\nimport { DoomPluginService } from '../exports/pluginProtocol';\nimport {\n  DOOM_COCKPIT_SERVER_ID,\n  DoomHubService,\n  DoomSessionManagementService,\n  type HubService,\n  type ProtocolEvent,\n} from '../exports/sessionProtocol';\nimport { createAgentServerService, type DoomSessionMetadata } from '../pi/piSessionRuntime';\nimport { createPiWebSocketListener, type PiListenerSocket } from '../pi/piWebSocketListener';\nimport type { DoomSocketMount } from '../schemas/packageApi';\nimport type { OpenSessionRecord } from '../services/openSessionRegistry';\nimport type { ServerTelemetry } from '../services/serverTelemetry';\nimport { harnessErrorMessage } from './harnessErrorMessage';\nimport type { HeadlessHub, HeadlessHubEvent, HeadlessHubSession } from './headlessHub';\nimport { createThreadJournals, type ThreadJournals } from './threadJournals';\n\nconst MAX_HUB_EVENTS = 1_024;\n\ntype ProtocolHandler = NonNullable<ReturnType<ReturnType<typeof createPiWebSocketListener>['accept']>>;\ntype HubFrame = { type: string; [key: string]: JsonValue };\n\nfunction sessionView(session: HeadlessHubSession): Record<string, JsonValue> {\n  return {\n    id: session.id,\n    ...(session.workspaceId === undefined ? {} : { workspaceId: session.workspaceId }),\n    ...(session.webComposition === undefined ? {} : { webComposition: { ...session.webComposition } }),\n    name: session.name,\n    cwd: session.cwd,\n    createdAt: session.createdAt,\n    updatedAt: session.updatedAt ?? session.createdAt,\n    phase: session.phase ?? 'idle',\n    phaseSince: session.phaseSince ?? session.createdAt,\n    attach: 'attached',\n    pendingMessageCount: session.pendingMessageCount ?? 0,\n    everPrompted: session.everPrompted ?? false,\n    awaitingInput: session.awaitingInput ?? false,\n    ...(session.lastSettledAt === undefined ? {} : { lastSettledAt: session.lastSettledAt }),\n    ...(session.git === undefined ? {} : { git: { branch: session.git.branch, dirty: session.git.dirty } }),\n    ...(session.profile === undefined\n      ? {}\n      : {\n          profile: {\n            name: session.profile.name,\n            ...(session.profile.displayName === undefined ? {} : { displayName: session.profile.displayName }),\n            ...(session.profile.iconVersion === undefined ? {} : { iconVersion: session.profile.iconVersion }),\n          },\n        }),\n    ...(session.parentSessionId === undefined ? {} : { parentSessionId: session.parentSessionId }),\n    ...(session.sessionProvenance === undefined ? {} : { sessionProvenance: session.sessionProvenance }),\n    ...(session.pendingSetups === undefined\n      ? {}\n      : {\n          pendingSetups: session.pendingSetups.map((setup) => ({\n            id: setup.id,\n            name: setup.name,\n            createdAt: setup.createdAt,\n            ...(setup.cwd === undefined ? {} : { cwd: setup.cwd }),\n            ...(setup.setupKind === undefined ? {} : { setupKind: setup.setupKind }),\n            ...(setup.status === undefined ? {} : { status: setup.status }),\n            ...(setup.errorCode === undefined ? {} : { errorCode: setup.errorCode }),\n          })),\n        }),\n  };\n}\n\n/**\n * A recorded session with no runtime behind it yet.\n *\n * Carries the same field set as a live session so the rail keys both by id and\n * swaps one for the other in place once the server reopens the journal.\n */\nfunction dormantView(record: OpenSessionRecord): Record<string, JsonValue> {\n  return {\n    id: record.sessionId,\n    workspaceId: record.workspaceId,\n    name: record.name,\n    cwd: record.cwd,\n    createdAt: record.createdAt,\n    updatedAt: record.createdAt,\n    phase: 'idle',\n    phaseSince: record.createdAt,\n    attach: 'attached',\n    pendingMessageCount: 0,\n    everPrompted: false,\n    awaitingInput: false,\n    dormant: true,\n    ...(record.parentSessionId === undefined ? {} : { parentSessionId: record.parentSessionId }),\n    ...(record.sessionProvenance === undefined ? {} : { sessionProvenance: record.sessionProvenance }),\n  };\n}\n\nfunction endpointAttachment(endpoint: RemoteServiceEndpoint): {\n  invokeService: RemoteServiceEndpoint['invoke'];\n  release(): void;\n} {\n  return {\n    invokeService: (call, publish, context) => endpoint.invoke(call, publish, context),\n    release: () => endpoint.dispose(),\n  };\n}\n\nfunction metadataOf(session: HeadlessHubSession): DoomSessionMetadata {\n  const createdAt = Date.parse(session.createdAt);\n  return {\n    id: session.id,\n    createdAt: Number.isFinite(createdAt) ? createdAt : 0,\n    storageVersion: 1,\n    cwd: session.cwd,\n    sessionName: session.name,\n  };\n}\n\nfunction frameOf(event: HeadlessHubEvent): HubFrame {\n  switch (event.kind) {\n    case 'upsert':\n      return { type: 'session_upsert', session: sessionView(event.session) };\n    case 'removed':\n      return { type: 'session_removed', sessionId: event.sessionId };\n    case 'workspace_upsert':\n      return {\n        type: 'workspace_upsert',\n        workspace: {\n          id: event.workspace.id,\n          root: event.workspace.root,\n          ...(event.workspace.name === undefined ? {} : { name: event.workspace.name }),\n          available: event.workspace.available !== false,\n        },\n      };\n    case 'workspace_removed':\n      return { type: 'workspace_removed', workspaceId: event.workspaceId };\n    case 'channel':\n      return { type: event.frameType, sessionId: event.sessionId, payload: event.payload as JsonValue };\n  }\n}\n\nfunction permitsSession(\n  hub: HeadlessHub,\n  mount: DoomSocketMount,\n  sessionId: string,\n  authorize: (id: string) => boolean = () => true,\n): boolean {\n  const session = hub.session(sessionId);\n  return (\n    session !== undefined &&\n    authorize(sessionId) &&\n    (mount.scope === 'global' ||\n      (session.workspaceId === mount.workspaceId && (mount.scope === 'workspace' || mount.sessionId === sessionId)))\n  );\n}\n\nfunction permitsDormant(mount: DoomSocketMount, record: OpenSessionRecord): boolean {\n  if (mount.scope === 'global') return true;\n  if (record.workspaceId !== mount.workspaceId) return false;\n  return mount.scope === 'workspace' || mount.sessionId === record.sessionId;\n}\n\nfunction managementHost(\n  hub: HeadlessHub,\n  threads: ThreadJournals,\n  mount: DoomSocketMount,\n  dormantSessions: () => readonly OpenSessionRecord[],\n  authorizeSession: (id: string) => boolean,\n  authorizeDesktop: () => boolean,\n): RoutedServerServiceHost {\n  return {\n    attachClient(presentation) {\n      const connectionId = randomUUID();\n      const subscriptions = new Set<string>();\n      const threadSubscriptions = new Set<string>();\n      const state = replicatedState<{ events: ProtocolEvent[] }>({ events: [] });\n      let sequence = 0;\n      let released = false;\n      const publish = (frame: HubFrame): void => {\n        sequence += 1;\n        state.change(BACKGROUND_CONTEXT, (draft) => {\n          draft.events.push({ sequence, frame });\n          if (draft.events.length > MAX_HUB_EVENTS) draft.events.shift();\n        });\n      };\n      const visible = new Set(\n        hub\n          .snapshot()\n          .filter((session) => permitsSession(hub, mount, session.id, authorizeSession))\n          .map((session) => session.id),\n      );\n      publish({\n        type: 'sessions_snapshot',\n        sessions: [\n          ...hub\n            .snapshot()\n            .filter((session) => visible.has(session.id))\n            .map(sessionView),\n          ...dormantSessions()\n            .filter((record) => !visible.has(record.sessionId) && permitsDormant(mount, record))\n            .map(dormantView),\n        ],\n      });\n      publish({\n        type: 'workspaces_snapshot',\n        workspaces: hub\n          .workspaces()\n          .filter((workspace) => mount.scope === 'global' || workspace.id === mount.workspaceId)\n          .map((workspace) => ({\n            id: workspace.id,\n            root: workspace.root,\n            ...(workspace.name === undefined ? {} : { name: workspace.name }),\n            available: workspace.available !== false,\n          })),\n      });\n      const stopEvents = hub.onEvent((event) => {\n        if (event.kind === 'workspace_upsert' || event.kind === 'workspace_removed') {\n          const workspaceId = event.kind === 'workspace_upsert' ? event.workspace.id : event.workspaceId;\n          if (mount.scope !== 'global' && mount.workspaceId !== workspaceId) return;\n          publish(frameOf(event));\n          return;\n        }\n        if (event.kind === 'removed') {\n          if (!visible.delete(event.sessionId)) return;\n          // A released session keeps its record: it lists as dormant, as after a\n          // restart, so its history stays readable where it is shown.\n          const record =\n            event.dormant === true\n              ? dormantSessions().find((candidate) => candidate.sessionId === event.sessionId)\n              : undefined;\n          if (record !== undefined && permitsDormant(mount, record)) {\n            publish({ type: 'session_upsert', session: dormantView(record) });\n            return;\n          }\n        } else {\n          const id = event.kind === 'upsert' ? event.session.id : event.sessionId;\n          if (!permitsSession(hub, mount, id, authorizeSession)) return;\n          if (event.kind === 'upsert') visible.add(id);\n        }\n        if (event.kind === 'channel') {\n          if (event.frameType === 'computer_use_state' && !authorizeDesktop()) return;\n          if (!subscriptions.has(event.sessionId)) return;\n          if (event.connectionId !== undefined && event.connectionId !== connectionId) return;\n        }\n        publish(frameOf(event));\n      });\n      const stopThreadFrames = threads.onFrame((event) => {\n        if (!authorizeSession(event.sessionId) || !threadSubscriptions.has(`${event.sessionId}\\n${event.threadId}`))\n          return;\n        publish({\n          type: 'thread_frame',\n          sessionId: event.sessionId,\n          threadId: event.threadId,\n          frame: event.frame as JsonValue,\n        });\n      });\n      const service: HubService = {\n        state,\n        async send(frame) {\n          const sessionId = typeof frame.sessionId === 'string' ? frame.sessionId : undefined;\n          if (sessionId !== undefined && !authorizeSession(sessionId))\n            throw new SessionNotFoundError('This session belongs to Desktop.');\n          if (sessionId !== undefined && !permitsSession(hub, mount, sessionId)) return;\n          if (frame.type === 'subscribe' && sessionId !== undefined) {\n            if (!hub.session(sessionId)) return;\n            subscriptions.add(sessionId);\n            for (const channelFrame of hub.channelFrames(sessionId)) {\n              if (channelFrame.type !== 'computer_use_state' || authorizeDesktop()) publish(channelFrame as HubFrame);\n            }\n            return;\n          }\n          if (frame.type === 'unsubscribe' && sessionId !== undefined) {\n            subscriptions.delete(sessionId);\n            return;\n          }\n          const threadId = typeof frame.threadId === 'string' ? frame.threadId : undefined;\n          if ((frame.type === 'subscribe_thread' || frame.type === 'unsubscribe_thread') && threadId !== undefined) {\n            const key = `${sessionId ?? ''}\\n${threadId}`;\n            if (sessionId === undefined) return;\n            if (frame.type === 'unsubscribe_thread') {\n              if (threadSubscriptions.delete(key)) threads.unsubscribe(sessionId, threadId);\n              return;\n            }\n            if (threadSubscriptions.has(key)) return;\n            threadSubscriptions.add(key);\n            publish({\n              type: 'thread_backlog',\n              sessionId,\n              threadId,\n              frames: threads.subscribe(sessionId, threadId) as JsonValue,\n            });\n            return;\n          }\n          if (sessionId !== undefined)\n            hub.receiveChannel(sessionId, frame.type, frame.payload, connectionId, authorizeDesktop());\n        },\n      };\n      const provider = new RemoteServiceProvider([\n        { service: DoomSessionManagementService, mode: 'singleton' },\n        { service: DoomHubService, mode: 'singleton' },\n        { service: DoomPluginService, mode: 'singleton' },\n      ]);\n      provider.provide(DoomHubService, service);\n      provider.provide(DoomPluginService, {\n        async invoke(call) {\n          if (call.mount.scope === 'session' && !authorizeSession(call.mount.sessionId)) {\n            throw new Error('This session belongs to its Desktop instance.');\n          }\n          if (mount.scope !== 'global') {\n            const permitted =\n              call.mount.scope === 'session'\n                ? permitsSession(hub, mount, call.mount.sessionId)\n                : mount.scope === 'workspace' &&\n                  call.mount.scope === 'workspace' &&\n                  call.mount.workspaceId === mount.workspaceId;\n            if (!permitted) throw new Error('Plugin is outside this WebSocket scope.');\n          }\n          return (await hub.invokePlugin(call, 'client-to-server', { connectionId })) as JsonValue;\n        },\n      });\n      provider.provide(DoomSessionManagementService, {\n        attach: (sessionId, context) => {\n          if (!authorizeSession(sessionId)) throw new SessionNotFoundError('This session belongs to Desktop.');\n          return presentation.attachSession(sessionId, context);\n        },\n        detach: (context) => presentation.detachSession(context),\n      });\n      const endpoint = createRemoteServiceEndpoint(provider);\n      const attachment = endpointAttachment(endpoint);\n      return {\n        invokeService: attachment.invokeService,\n        release() {\n          if (released) return;\n          released = true;\n          stopEvents();\n          stopThreadFrames();\n          for (const key of threadSubscriptions) {\n            const [sessionId, threadId] = key.split('\\n');\n            if (sessionId !== undefined && threadId !== undefined) threads.unsubscribe(sessionId, threadId);\n          }\n          threadSubscriptions.clear();\n          subscriptions.clear();\n          hub.disconnectChannels(connectionId);\n          provider.dispose();\n          attachment.release();\n        },\n      };\n    },\n  };\n}\n\nfunction protocolHost(\n  hub: HeadlessHub,\n  threads: ThreadJournals,\n  telemetry: ServerTelemetry | undefined,\n  mount: DoomSocketMount,\n  dormantSessions: () => readonly OpenSessionRecord[],\n  authorizeSession: (id: string) => boolean,\n  authorizeDesktop: () => boolean,\n): ServerHost<DoomSessionMetadata> {\n  return {\n    serverServices: managementHost(hub, threads, mount, dormantSessions, authorizeSession, authorizeDesktop),\n    async resolveSession(sessionId) {\n      const session = hub.session(sessionId);\n      if (!session || !permitsSession(hub, mount, session.id, authorizeSession))\n        throw new SessionNotFoundError(`No session ${sessionId}`);\n      return metadataOf(session);\n    },\n    async openSession(metadata, context): Promise<RoutedSessionHandle> {\n      const session = hub.session(metadata.id);\n      if (!session || !permitsSession(hub, mount, session.id, authorizeSession))\n        throw new SessionNotFoundError(`No session ${metadata.id}`);\n      const permitted = () => hub.session(session.id)?.host === session.host && authorizeSession(session.id);\n      const service = createAgentServerService({\n        runtime: session.host.runtime,\n        onPresentationFrame: (listener) =>\n          session.host.onPresentationFrame((frame) => {\n            if (permitted()) listener(frame);\n          }),\n        respondToExtensionUi: (frame) => {\n          if (!permitted()) throw new SessionNotFoundError('This session belongs to Desktop.');\n          return session.host.respondToExtensionUi(frame);\n        },\n        readThreadTranscript: (threadId, request, readContext) => {\n          if (!permitted()) throw new SessionNotFoundError('This session belongs to Desktop.');\n          return threads.readPage(session.id, threadId, request, readContext);\n        },\n        sessionId: session.id,\n        sessionName: session.name,\n        cwd: session.cwd,\n        createdAt: metadataOf(session).createdAt,\n        telemetry,\n      });\n      const handle = await service.openSession(metadata, context);\n      return {\n        ...handle,\n        async attachClient(...args) {\n          const attachment = await handle.attachClient(...args);\n          return {\n            ...attachment,\n            invokeService(call, publish, invocationContext) {\n              if (!permitted()) throw new SessionNotFoundError('This session belongs to Desktop.');\n              return attachment.invokeService(\n                call,\n                (...values) => {\n                  if (permitted()) return publish(...values);\n                },\n                invocationContext,\n              );\n            },\n          };\n        },\n        terminated: session.host.runtime.exited.then(async () => {\n          await handle.close(BACKGROUND_CONTEXT);\n          return undefined;\n        }),\n      };\n    },\n  };\n}\n\nexport interface HeadlessProtocol {\n  accept(socket: PiListenerSocket): ProtocolHandler | undefined;\n  close(): Promise<void>;\n}\n\n/** Hosts the browser's Pi 0.85 connection directly over the process-local hub. */\nexport async function createHeadlessProtocol(options: {\n  hub: HeadlessHub;\n  mount?: DoomSocketMount;\n  telemetry?: ServerTelemetry;\n  onNotice?: (message: string) => void;\n  /** Recorded sessions the server has not reopened; they join the first snapshot only. */\n  dormantSessions?: () => readonly OpenSessionRecord[];\n  /** Evaluated for every invocation, including attachments established before a Desktop claim. */\n  authorizeSession?: (sessionId: string) => boolean;\n  authorizeDesktop?: () => boolean;\n}): Promise<HeadlessProtocol> {\n  const listener = createPiWebSocketListener({ onError: (error) => options.onNotice?.(error.message) });\n  const threads = createThreadJournals({\n    resolve: (sessionId, threadId) => options.hub.threadJournal(sessionId, threadId),\n  });\n  const server = await new Server(\n    protocolHost(\n      options.hub,\n      threads,\n      options.telemetry,\n      options.mount ?? { scope: 'global' },\n      () => (options.dormantSessions === undefined ? [] : options.dormantSessions()),\n      options.authorizeSession ?? ((id) => !options.hub.computerUse?.ownsSession?.(id)),\n      options.authorizeDesktop ?? (() => false),\n    ),\n    {\n      listeners: [listener],\n      serverId: DOOM_COCKPIT_SERVER_ID,\n      onError: (error) => options.onNotice?.(`headless protocol error (${harnessErrorMessage(error)})`),\n    },\n  ).start();\n  let closing: Promise<void> | undefined;\n  return {\n    accept: (socket) => listener.accept(socket),\n    close() {\n      closing ??= (async () => {\n        threads.close();\n        await server.close();\n      })();\n      return closing;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/server/jsonlTranscriptReader.cjs

@@ -0,0 +1,85 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_index = require("../services/transcriptPages/index.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let _earendil_works_pi_agent_core_harness_context = require("@earendil-works/pi-agent-core/harness/context");
+//#region src/server/jsonlTranscriptReader.ts
+function record(value, message) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(message);
+	return value;
+}
+/** Reads a completed v4 journal as immutable bytes. It never opens the writable JSONL repository. */
+async function readJsonlTranscript(file, request) {
+	const content = node_fs.default.readFileSync(file, "utf8");
+	if (!content.endsWith("\n")) throw new Error("Child JSONL transcript is incomplete");
+	const lines = content.slice(0, -1).split("\n");
+	const header = record(JSON.parse(lines.shift() ?? ""), "Invalid child JSONL header");
+	if (header.kind !== "header" || header.v !== 4 || typeof header.id !== "string") throw new Error("Child transcript is not a v4 JSONL journal");
+	const entries = /* @__PURE__ */ new Map();
+	const tips = /* @__PURE__ */ new Map();
+	let previousSeq = 0;
+	for (const [lineIndex, line] of lines.entries()) {
+		let transaction;
+		try {
+			transaction = JSON.parse(line);
+		} catch (cause) {
+			throw new Error(`Invalid child JSONL transaction at line ${lineIndex + 2}`, { cause });
+		}
+		const writes = Array.isArray(transaction) ? transaction : [transaction];
+		for (const value of writes) {
+			const write = record(value, `Invalid child JSONL write at line ${lineIndex + 2}`);
+			if (!Number.isSafeInteger(write.seq) || write.seq <= previousSeq) throw new Error(`Invalid child JSONL sequence at line ${lineIndex + 2}`);
+			previousSeq = write.seq;
+			if (write.kind === "entry") {
+				if (typeof write.id !== "string" || write.parentId !== null && typeof write.parentId !== "string") throw new Error(`Invalid child JSONL entry at line ${lineIndex + 2}`);
+				if (entries.has(write.id)) throw new Error(`Duplicate child JSONL entry '${write.id}'`);
+				entries.set(write.id, write);
+			} else if (write.kind === "value" && write.namespace === "pi.branch.tip" && typeof write.key === "string") {
+				if (write.op === "delete") tips.delete(write.key);
+				else if (write.op === "set" && typeof write.value === "string") tips.set(write.key, write.value);
+				else throw new Error(`Invalid child JSONL branch tip at line ${lineIndex + 2}`);
+			}
+		}
+	}
+	const laneName = tips.has("main") ? "main" : tips.size === 1 ? [...tips.keys()][0] : void 0;
+	if (!laneName && tips.size > 1) throw new Error("Child transcript has no unambiguous active lane");
+	const tip = laneName ? tips.get(laneName) ?? null : null;
+	const branch = [];
+	const visited = /* @__PURE__ */ new Set();
+	let id = tip;
+	while (id) {
+		if (visited.has(id)) throw new Error("Child JSONL transcript contains a parent cycle");
+		visited.add(id);
+		const entry = entries.get(id);
+		if (!entry) throw new Error(`Child JSONL transcript references missing entry '${id}'`);
+		branch.push(entry);
+		id = entry.parentId;
+	}
+	branch.reverse();
+	return {
+		...await require_index.readTranscriptPage({
+			sessionId: header.id,
+			laneName: laneName ?? "main",
+			lane: {
+				getTipId: async () => tip,
+				findEntries: async (query = {}) => {
+					let rows = branch;
+					const startIndex = query.start ? rows.findIndex((entry) => entry.id === query.start) : rows.length - 1;
+					if (startIndex >= 0) rows = rows.slice(0, startIndex + 1);
+					const cursor = query.cursor;
+					if (cursor) rows = rows.filter((entry) => query.order === "oldestFirst" ? entry.seq > cursor.seq : entry.seq < cursor.seq);
+					if (query.type) rows = rows.filter((entry) => entry.type === query.type);
+					if (query.customType) rows = rows.filter((entry) => entry.type === "custom" && entry.customType === query.customType);
+					if (query.order !== "oldestFirst") rows = [...rows].reverse();
+					return rows.slice(0, query.limit);
+				}
+			}
+		}, request, 0, _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT),
+		revision: 0,
+		drafts: []
+	};
+}
+//#endregion
+exports.readJsonlTranscript = readJsonlTranscript;
+
+//# sourceMappingURL=jsonlTranscriptReader.cjs.map

package/dist/src/server/jsonlTranscriptReader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonlTranscriptReader.cjs","names":["fs","readTranscriptPage","BACKGROUND_CONTEXT"],"sources":["../../../src/server/jsonlTranscriptReader.ts"],"sourcesContent":["import fs from 'node:fs';\n\nimport { BACKGROUND_CONTEXT } from '@earendil-works/pi-agent-core/harness/context';\nimport type { Entry } from '@earendil-works/pi-agent-core/harness/session';\n\nimport type { TranscriptPage, TranscriptPageRequest } from '../exports/sessionProtocol';\nimport { readTranscriptPage } from '../services/transcriptPages';\n\ninterface JsonRecord {\n  [key: string]: unknown;\n}\n\nfunction record(value: unknown, message: string): JsonRecord {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error(message);\n  return value as JsonRecord;\n}\n\n/** Reads a completed v4 journal as immutable bytes. It never opens the writable JSONL repository. */\nexport async function readJsonlTranscript(\n  file: string,\n  request: Omit<TranscriptPageRequest, 'threadId'>,\n): Promise<TranscriptPage> {\n  const content = fs.readFileSync(file, 'utf8');\n  if (!content.endsWith('\\n')) throw new Error('Child JSONL transcript is incomplete');\n  const lines = content.slice(0, -1).split('\\n');\n  const header = record(JSON.parse(lines.shift() ?? ''), 'Invalid child JSONL header');\n  if (header.kind !== 'header' || header.v !== 4 || typeof header.id !== 'string')\n    throw new Error('Child transcript is not a v4 JSONL journal');\n\n  const entries = new Map<string, Entry>();\n  const tips = new Map<string, string>();\n  let previousSeq = 0;\n  for (const [lineIndex, line] of lines.entries()) {\n    let transaction: unknown;\n    try {\n      transaction = JSON.parse(line);\n    } catch (cause) {\n      throw new Error(`Invalid child JSONL transaction at line ${lineIndex + 2}`, { cause });\n    }\n    const writes = Array.isArray(transaction) ? transaction : [transaction];\n    for (const value of writes) {\n      const write = record(value, `Invalid child JSONL write at line ${lineIndex + 2}`);\n      if (!Number.isSafeInteger(write.seq) || (write.seq as number) <= previousSeq)\n        throw new Error(`Invalid child JSONL sequence at line ${lineIndex + 2}`);\n      previousSeq = write.seq as number;\n      if (write.kind === 'entry') {\n        if (typeof write.id !== 'string' || (write.parentId !== null && typeof write.parentId !== 'string'))\n          throw new Error(`Invalid child JSONL entry at line ${lineIndex + 2}`);\n        if (entries.has(write.id)) throw new Error(`Duplicate child JSONL entry '${write.id}'`);\n        entries.set(write.id, write as unknown as Entry);\n      } else if (write.kind === 'value' && write.namespace === 'pi.branch.tip' && typeof write.key === 'string') {\n        if (write.op === 'delete') tips.delete(write.key);\n        else if (write.op === 'set' && typeof write.value === 'string') tips.set(write.key, write.value);\n        else throw new Error(`Invalid child JSONL branch tip at line ${lineIndex + 2}`);\n      }\n    }\n  }\n\n  const laneName = tips.has('main') ? 'main' : tips.size === 1 ? [...tips.keys()][0]! : undefined;\n  if (!laneName && tips.size > 1) throw new Error('Child transcript has no unambiguous active lane');\n  const tip = laneName ? (tips.get(laneName) ?? null) : null;\n  const branch: Entry[] = [];\n  const visited = new Set<string>();\n  let id = tip;\n  while (id) {\n    if (visited.has(id)) throw new Error('Child JSONL transcript contains a parent cycle');\n    visited.add(id);\n    const entry = entries.get(id);\n    if (!entry) throw new Error(`Child JSONL transcript references missing entry '${id}'`);\n    branch.push(entry);\n    id = entry.parentId;\n  }\n  branch.reverse();\n\n  const page = await readTranscriptPage(\n    {\n      sessionId: header.id,\n      laneName: laneName ?? 'main',\n      lane: {\n        getTipId: async () => tip,\n        findEntries: async (query = {}) => {\n          let rows = branch;\n          const startIndex = query.start ? rows.findIndex((entry) => entry.id === query.start) : rows.length - 1;\n          if (startIndex >= 0) rows = rows.slice(0, startIndex + 1);\n          const cursor = query.cursor;\n          if (cursor)\n            rows = rows.filter((entry) =>\n              query.order === 'oldestFirst' ? entry.seq > cursor.seq : entry.seq < cursor.seq,\n            );\n          if (query.type) rows = rows.filter((entry) => entry.type === query.type);\n          if (query.customType)\n            rows = rows.filter((entry) => entry.type === 'custom' && entry.customType === query.customType);\n          if (query.order !== 'oldestFirst') rows = [...rows].reverse();\n          return rows.slice(0, query.limit);\n        },\n      },\n    },\n    request,\n    0,\n    BACKGROUND_CONTEXT,\n  );\n  return { ...page, revision: 0, drafts: [] };\n}\n"],"mappings":"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"}

package/dist/src/server/jsonlTranscriptReader.mjs

@@ -0,0 +1,83 @@
+import { readTranscriptPage } from "../services/transcriptPages/index.mjs";
+import fs from "node:fs";
+import { BACKGROUND_CONTEXT } from "@earendil-works/pi-agent-core/harness/context";
+//#region src/server/jsonlTranscriptReader.ts
+function record(value, message) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(message);
+	return value;
+}
+/** Reads a completed v4 journal as immutable bytes. It never opens the writable JSONL repository. */
+async function readJsonlTranscript(file, request) {
+	const content = fs.readFileSync(file, "utf8");
+	if (!content.endsWith("\n")) throw new Error("Child JSONL transcript is incomplete");
+	const lines = content.slice(0, -1).split("\n");
+	const header = record(JSON.parse(lines.shift() ?? ""), "Invalid child JSONL header");
+	if (header.kind !== "header" || header.v !== 4 || typeof header.id !== "string") throw new Error("Child transcript is not a v4 JSONL journal");
+	const entries = /* @__PURE__ */ new Map();
+	const tips = /* @__PURE__ */ new Map();
+	let previousSeq = 0;
+	for (const [lineIndex, line] of lines.entries()) {
+		let transaction;
+		try {
+			transaction = JSON.parse(line);
+		} catch (cause) {
+			throw new Error(`Invalid child JSONL transaction at line ${lineIndex + 2}`, { cause });
+		}
+		const writes = Array.isArray(transaction) ? transaction : [transaction];
+		for (const value of writes) {
+			const write = record(value, `Invalid child JSONL write at line ${lineIndex + 2}`);
+			if (!Number.isSafeInteger(write.seq) || write.seq <= previousSeq) throw new Error(`Invalid child JSONL sequence at line ${lineIndex + 2}`);
+			previousSeq = write.seq;
+			if (write.kind === "entry") {
+				if (typeof write.id !== "string" || write.parentId !== null && typeof write.parentId !== "string") throw new Error(`Invalid child JSONL entry at line ${lineIndex + 2}`);
+				if (entries.has(write.id)) throw new Error(`Duplicate child JSONL entry '${write.id}'`);
+				entries.set(write.id, write);
+			} else if (write.kind === "value" && write.namespace === "pi.branch.tip" && typeof write.key === "string") {
+				if (write.op === "delete") tips.delete(write.key);
+				else if (write.op === "set" && typeof write.value === "string") tips.set(write.key, write.value);
+				else throw new Error(`Invalid child JSONL branch tip at line ${lineIndex + 2}`);
+			}
+		}
+	}
+	const laneName = tips.has("main") ? "main" : tips.size === 1 ? [...tips.keys()][0] : void 0;
+	if (!laneName && tips.size > 1) throw new Error("Child transcript has no unambiguous active lane");
+	const tip = laneName ? tips.get(laneName) ?? null : null;
+	const branch = [];
+	const visited = /* @__PURE__ */ new Set();
+	let id = tip;
+	while (id) {
+		if (visited.has(id)) throw new Error("Child JSONL transcript contains a parent cycle");
+		visited.add(id);
+		const entry = entries.get(id);
+		if (!entry) throw new Error(`Child JSONL transcript references missing entry '${id}'`);
+		branch.push(entry);
+		id = entry.parentId;
+	}
+	branch.reverse();
+	return {
+		...await readTranscriptPage({
+			sessionId: header.id,
+			laneName: laneName ?? "main",
+			lane: {
+				getTipId: async () => tip,
+				findEntries: async (query = {}) => {
+					let rows = branch;
+					const startIndex = query.start ? rows.findIndex((entry) => entry.id === query.start) : rows.length - 1;
+					if (startIndex >= 0) rows = rows.slice(0, startIndex + 1);
+					const cursor = query.cursor;
+					if (cursor) rows = rows.filter((entry) => query.order === "oldestFirst" ? entry.seq > cursor.seq : entry.seq < cursor.seq);
+					if (query.type) rows = rows.filter((entry) => entry.type === query.type);
+					if (query.customType) rows = rows.filter((entry) => entry.type === "custom" && entry.customType === query.customType);
+					if (query.order !== "oldestFirst") rows = [...rows].reverse();
+					return rows.slice(0, query.limit);
+				}
+			}
+		}, request, 0, BACKGROUND_CONTEXT),
+		revision: 0,
+		drafts: []
+	};
+}
+//#endregion
+export { readJsonlTranscript };
+
+//# sourceMappingURL=jsonlTranscriptReader.mjs.map

package/dist/src/server/jsonlTranscriptReader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonlTranscriptReader.mjs","names":[],"sources":["../../../src/server/jsonlTranscriptReader.ts"],"sourcesContent":["import fs from 'node:fs';\n\nimport { BACKGROUND_CONTEXT } from '@earendil-works/pi-agent-core/harness/context';\nimport type { Entry } from '@earendil-works/pi-agent-core/harness/session';\n\nimport type { TranscriptPage, TranscriptPageRequest } from '../exports/sessionProtocol';\nimport { readTranscriptPage } from '../services/transcriptPages';\n\ninterface JsonRecord {\n  [key: string]: unknown;\n}\n\nfunction record(value: unknown, message: string): JsonRecord {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error(message);\n  return value as JsonRecord;\n}\n\n/** Reads a completed v4 journal as immutable bytes. It never opens the writable JSONL repository. */\nexport async function readJsonlTranscript(\n  file: string,\n  request: Omit<TranscriptPageRequest, 'threadId'>,\n): Promise<TranscriptPage> {\n  const content = fs.readFileSync(file, 'utf8');\n  if (!content.endsWith('\\n')) throw new Error('Child JSONL transcript is incomplete');\n  const lines = content.slice(0, -1).split('\\n');\n  const header = record(JSON.parse(lines.shift() ?? ''), 'Invalid child JSONL header');\n  if (header.kind !== 'header' || header.v !== 4 || typeof header.id !== 'string')\n    throw new Error('Child transcript is not a v4 JSONL journal');\n\n  const entries = new Map<string, Entry>();\n  const tips = new Map<string, string>();\n  let previousSeq = 0;\n  for (const [lineIndex, line] of lines.entries()) {\n    let transaction: unknown;\n    try {\n      transaction = JSON.parse(line);\n    } catch (cause) {\n      throw new Error(`Invalid child JSONL transaction at line ${lineIndex + 2}`, { cause });\n    }\n    const writes = Array.isArray(transaction) ? transaction : [transaction];\n    for (const value of writes) {\n      const write = record(value, `Invalid child JSONL write at line ${lineIndex + 2}`);\n      if (!Number.isSafeInteger(write.seq) || (write.seq as number) <= previousSeq)\n        throw new Error(`Invalid child JSONL sequence at line ${lineIndex + 2}`);\n      previousSeq = write.seq as number;\n      if (write.kind === 'entry') {\n        if (typeof write.id !== 'string' || (write.parentId !== null && typeof write.parentId !== 'string'))\n          throw new Error(`Invalid child JSONL entry at line ${lineIndex + 2}`);\n        if (entries.has(write.id)) throw new Error(`Duplicate child JSONL entry '${write.id}'`);\n        entries.set(write.id, write as unknown as Entry);\n      } else if (write.kind === 'value' && write.namespace === 'pi.branch.tip' && typeof write.key === 'string') {\n        if (write.op === 'delete') tips.delete(write.key);\n        else if (write.op === 'set' && typeof write.value === 'string') tips.set(write.key, write.value);\n        else throw new Error(`Invalid child JSONL branch tip at line ${lineIndex + 2}`);\n      }\n    }\n  }\n\n  const laneName = tips.has('main') ? 'main' : tips.size === 1 ? [...tips.keys()][0]! : undefined;\n  if (!laneName && tips.size > 1) throw new Error('Child transcript has no unambiguous active lane');\n  const tip = laneName ? (tips.get(laneName) ?? null) : null;\n  const branch: Entry[] = [];\n  const visited = new Set<string>();\n  let id = tip;\n  while (id) {\n    if (visited.has(id)) throw new Error('Child JSONL transcript contains a parent cycle');\n    visited.add(id);\n    const entry = entries.get(id);\n    if (!entry) throw new Error(`Child JSONL transcript references missing entry '${id}'`);\n    branch.push(entry);\n    id = entry.parentId;\n  }\n  branch.reverse();\n\n  const page = await readTranscriptPage(\n    {\n      sessionId: header.id,\n      laneName: laneName ?? 'main',\n      lane: {\n        getTipId: async () => tip,\n        findEntries: async (query = {}) => {\n          let rows = branch;\n          const startIndex = query.start ? rows.findIndex((entry) => entry.id === query.start) : rows.length - 1;\n          if (startIndex >= 0) rows = rows.slice(0, startIndex + 1);\n          const cursor = query.cursor;\n          if (cursor)\n            rows = rows.filter((entry) =>\n              query.order === 'oldestFirst' ? entry.seq > cursor.seq : entry.seq < cursor.seq,\n            );\n          if (query.type) rows = rows.filter((entry) => entry.type === query.type);\n          if (query.customType)\n            rows = rows.filter((entry) => entry.type === 'custom' && entry.customType === query.customType);\n          if (query.order !== 'oldestFirst') rows = [...rows].reverse();\n          return rows.slice(0, query.limit);\n        },\n      },\n    },\n    request,\n    0,\n    BACKGROUND_CONTEXT,\n  );\n  return { ...page, revision: 0, drafts: [] };\n}\n"],"mappings":"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"}