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

package/dist/server/serverFacetLoader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverFacetLoader.mjs","names":[],"sources":["../../src/server/serverFacetLoader.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { Context, Service, type Fiber } from '@deepseek-ai/cordis';\n\nimport { DOOM_HEADLESS_OWNER, readDoomHeadlessHost } from '../schemas/headless';\nimport type { DoomApiScope } from '../schemas/packageApi';\nimport {\n  DOOM_SERVER_BUNDLE_FILE,\n  type DoomServerBundle,\n  type DoomServerBundleEntry,\n  parseDoomServerBundle,\n} from '../schemas/serverBundle';\nimport {\n  DOOM_SERVER_HOST_SERVICE,\n  type DoomServerFacet,\n  type DoomServerHostService,\n  isDoomServerFacet,\n} from '../schemas/serverFacet';\n\nexport type ServerBundleSource =\n  | {\n      readonly kind: 'descriptor';\n      readonly directory: string;\n      readonly generation: string;\n      readonly fingerprint: string;\n    }\n  | { readonly kind: 'empty' };\n\n/** Normalize operator-selected directories without falling back after descriptor errors. */\nexport function resolveServerBundleSource(options: {\n  registration?: {\n    readonly apiDirectory: string;\n    readonly generation: string;\n    readonly serverBundle?: { readonly path: string; readonly fingerprint: string };\n  };\n  directoryOverride?: string;\n}): ServerBundleSource {\n  const registration = options.registration;\n  const override = options.directoryOverride || undefined;\n  const selected = override ?? registration?.apiDirectory;\n  if (selected === undefined) return { kind: 'empty' };\n  const directory = fs.realpathSync(selected);\n  const isRegisteredDirectory = registration !== undefined && directory === fs.realpathSync(registration.apiDirectory);\n  if (isRegisteredDirectory && registration.serverBundle !== undefined) {\n    // The registration already declares this as new format, even when the file\n    // was removed after admission. loadServerBundle must reject, never downgrade.\n    return {\n      kind: 'descriptor',\n      directory,\n      generation: registration.generation,\n      fingerprint: registration.serverBundle.fingerprint,\n    };\n  }\n  const descriptorPath = path.join(directory, DOOM_SERVER_BUNDLE_FILE);\n  if (fs.existsSync(descriptorPath)) {\n    const descriptor = parseDoomServerBundle(\n      JSON.parse(fs.readFileSync(containedFile(directory, DOOM_SERVER_BUNDLE_FILE), 'utf8')),\n    );\n    return { kind: 'descriptor', directory, generation: descriptor.generation, fingerprint: descriptor.fingerprint };\n  }\n  throw new Error(`Server bundle descriptor is missing: ${descriptorPath}`);\n}\n\nexport interface LoadServerBundleOptions {\n  /** Already admitted generation directory, not a repository selected by a request. */\n  readonly directory: string;\n  readonly generation: string;\n  readonly fingerprint: string;\n  readonly majorMode: string;\n  readonly activeLayers: readonly string[];\n  readonly onNotice?: (message: string) => void;\n  /** Only a session host with declarative contribution gating may retain all candidates. */\n  readonly retainCandidates?: boolean;\n}\n\nexport interface LoadedServerFacet {\n  readonly declaration: DoomServerBundleEntry;\n  readonly facet: DoomServerFacet;\n  readonly retained?: true;\n  readonly initiallyEligible?: boolean;\n}\n\nexport interface LoadedServerBundle {\n  readonly descriptor: DoomServerBundle;\n  readonly facets: readonly LoadedServerFacet[];\n}\n\nfunction containedFile(directory: string, relativeFile: string): string {\n  const resolved = fs.realpathSync(path.resolve(directory, relativeFile));\n  const relative = path.relative(directory, resolved);\n  if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {\n    throw new Error(`Server bundle file escapes its generation: ${relativeFile}`);\n  }\n  return resolved;\n}\n\n/** Explicit new-generation reader. Missing or corrupt descriptors never select legacy modules. */\nexport async function loadServerBundle(\n  scope: DoomApiScope,\n  options: LoadServerBundleOptions,\n): Promise<LoadedServerBundle> {\n  const directory = fs.realpathSync(options.directory);\n  const descriptor = parseDoomServerBundle(\n    JSON.parse(fs.readFileSync(containedFile(directory, DOOM_SERVER_BUNDLE_FILE), 'utf8')),\n  );\n  if (descriptor.generation !== options.generation || descriptor.fingerprint !== options.fingerprint) {\n    throw new Error('Server bundle does not match the admitted generation');\n  }\n  const facets: LoadedServerFacet[] = [];\n  for (const declaration of descriptor.entries) {\n    if (!declaration.scopes.includes(scope)) continue;\n    const eligible = declaration.owners.some(\n      (owner) =>\n        owner.majorMode === options.majorMode &&\n        (owner.layer === 'default' || options.activeLayers.includes(owner.layer)),\n    );\n    if (!(scope === 'session' && options.retainCandidates === true) && !eligible) continue;\n    try {\n      const file = containedFile(directory, declaration.module);\n      const imported = (await import(pathToFileURL(file).href)) as { default?: unknown };\n      if (!isDoomServerFacet(imported.default)) throw new Error('default export is not a server object facet');\n      facets.push({\n        declaration,\n        facet: imported.default,\n        ...(scope === 'session' && options.retainCandidates\n          ? { retained: true as const, initiallyEligible: eligible }\n          : {}),\n      });\n    } catch (error) {\n      const message = `Server facet '${declaration.packageName}' could not load (${error instanceof Error ? error.message : String(error)})`;\n      if (declaration.required && eligible) throw new Error(message, { cause: error });\n      options.onNotice?.(message);\n    }\n  }\n  return { descriptor, facets };\n}\nexport interface InstallServerFacetsOptions {\n  host: DoomServerHostService;\n  facets: readonly (DoomServerFacet | LoadedServerFacet)[];\n  onNotice?: (message: string) => void;\n  /** Install additional typed services before any package facet is applied. */\n  prepare?: (root: Context) => void | Promise<void>;\n}\n\nexport interface InstalledServerFacets {\n  /** The cordis root the facets were installed into, for a host that provides more services. */\n  readonly root: Context;\n  readonly installedPackages: readonly string[];\n  dispose(): Promise<void>;\n}\n\n/**\n * Binds registrations to the Cordis fiber that calls the host service.\n *\n * The host itself is shared, but Cordis traceable services rebind `ctx` to the\n * caller. That lets a facet's registration unwind even when `apply` throws\n * before it can return its disposer.\n */\nclass ScopedDoomServerHost extends Service<DoomServerHostService> implements DoomServerHostService {\n  readonly scope: DoomServerHostService['scope'];\n  readonly context: DoomServerHostService['context'];\n\n  constructor(\n    ctx: Context,\n    private readonly host: DoomServerHostService,\n  ) {\n    super(ctx, DOOM_SERVER_HOST_SERVICE);\n    this.scope = host.scope;\n    this.context = host.context;\n  }\n\n  registerApi(api: Parameters<DoomServerHostService['registerApi']>[0]) {\n    const headless = this.scope === 'session' ? readDoomHeadlessHost(this.ctx) : undefined;\n    if (headless) {\n      const activity = headless.registerActivity({\n        name: `api:${api.basePath}`,\n        start: () => {\n          const registration = this.host.registerApi(api);\n          if (registration.mounted !== true) {\n            registration.dispose();\n            throw new Error(`package API '${api.basePath}' did not mount.`);\n          }\n          return () => {\n            registration.dispose();\n          };\n        },\n      });\n      return {\n        mounted: true,\n        dispose: () => activity.dispose(),\n      };\n    }\n    const registration = this.host.registerApi(api);\n    if (registration.mounted !== true) {\n      registration.dispose();\n      throw new Error(`package API '${api.basePath}' did not mount.`);\n    }\n    this.ctx.effect(() => () => registration.dispose(), 'server facet API registration');\n    return registration;\n  }\n\n  registerChannel(channel: Parameters<DoomServerHostService['registerChannel']>[0]) {\n    const registration = this.host.registerChannel(channel);\n    if (registration.mounted !== true) {\n      registration.dispose();\n      throw new Error(`hub channel '${channel.frameType}' did not mount.`);\n    }\n    this.ctx.effect(() => () => registration.dispose(), 'server facet channel registration');\n    return registration;\n  }\n\n  registerMethod: DoomServerHostService['registerMethod'] = (definition, handler) => {\n    const registration = this.host.registerMethod(definition, handler);\n    if (registration.mounted !== true) {\n      registration.dispose();\n      throw new Error(`plugin method '${definition.service}.${definition.method}' did not mount.`);\n    }\n    this.ctx.effect(() => () => registration.dispose(), 'server facet method registration');\n    return registration;\n  };\n\n  mounted(): readonly string[] {\n    return this.host.mounted();\n  }\n\n  mountedChannels(): readonly string[] {\n    return this.host.mountedChannels();\n  }\n}\n\n/** Publishes the host service from inside a mounted plugin, so it unwinds with the root. */\nfunction serverHostProvider(context: Context, host: DoomServerHostService): void {\n  new ScopedDoomServerHost(context, host);\n}\n\n/**\n * Installs server facets into a cordis root that provides the server host.\n *\n * A cordis root rather than plain calls, because a facet is a Doom\n * contribution like any other: it may inject services a host provides later,\n * and it unwinds through the same fiber disposal the Pi facet uses. One root\n * per host process, created here, so no host has to know cordis to run one.\n *\n * Facets are awaited one at a time and each is a single fiber, because a\n * facet declares its `inject` on itself. `fiber.await()` therefore settles\n * once `apply` has run, and the caller can read a complete mount table before\n * deciding whether to open a listener.\n */\nexport async function installServerFacets(options: InstallServerFacetsOptions): Promise<InstalledServerFacets> {\n  const notice = options.onNotice ?? ((): void => {});\n  const root = new Context();\n  await root.plugin(serverHostProvider, options.host).await();\n  try {\n    await options.prepare?.(root);\n  } catch (error) {\n    await root.fiber.dispose();\n    throw error;\n  }\n  if (\n    options.facets.some((candidate) => 'retained' in candidate && candidate.retained === true) &&\n    !readDoomHeadlessHost(root)\n  ) {\n    await root.fiber.dispose();\n    throw new Error('Retained server candidates require a gated headless host');\n  }\n  const installed: Fiber[] = [];\n  const installedPackages: string[] = [];\n\n  const disposeInstalled = async (): Promise<void> => {\n    for (const fiber of [...installed].reverse()) await fiber.dispose();\n  };\n\n  for (const candidate of options.facets) {\n    const facet = 'declaration' in candidate ? candidate.facet : candidate;\n    const declaration = 'declaration' in candidate ? candidate.declaration : undefined;\n    let fiber: Fiber | undefined;\n    try {\n      const scope = declaration ? root.extend({ [DOOM_HEADLESS_OWNER]: declaration }) : root;\n      fiber = scope.plugin(facet);\n      await fiber.await();\n      installed.push(fiber);\n      if (declaration) installedPackages.push(declaration.packageName);\n    } catch (error) {\n      await fiber?.dispose();\n      const message = `${declaration === undefined ? 'a server facet' : `server facet '${declaration.packageName}'`} did not install (${error instanceof Error ? error.message : String(error)})`;\n      if (\n        declaration?.required === true &&\n        !('initiallyEligible' in candidate && candidate.initiallyEligible === false)\n      ) {\n        await disposeInstalled();\n        await root.fiber.dispose();\n        throw new Error(message, { cause: error });\n      }\n      notice(message);\n    }\n  }\n\n  let disposePromise: Promise<void> | undefined;\n  return {\n    root,\n    installedPackages,\n    dispose: () => {\n      disposePromise ??= (async () => {\n        await disposeInstalled();\n        await root.fiber.dispose();\n      })();\n      return disposePromise;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/server/threadJournals.cjs

@@ -0,0 +1,172 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_index = require("../services/sqliteTranscriptReader/index.cjs");
+const require_nativeChildRuntimes = require("../systems/child/adapters/nativeChildRuntimes.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+//#region src/server/threadJournals.ts
+const POLL_MS = 250;
+const MAX_INITIAL_BYTES = 8388608;
+const NEWLINE = 10;
+function keyOf(sessionId, threadId) {
+	return `${sessionId}\n${threadId}`;
+}
+function journalFrames(text) {
+	const frames = [];
+	for (const line of text.split("\n")) {
+		let parsed;
+		try {
+			parsed = JSON.parse(line);
+		} catch {
+			continue;
+		}
+		const rows = Array.isArray(parsed) ? parsed : [parsed];
+		for (const row of rows) {
+			if (typeof row !== "object" || row === null || Array.isArray(row)) continue;
+			const entry = row;
+			const isLegacyMessage = entry.type === "message";
+			const isCurrentMessage = entry.kind === "entry" && entry.type === "message";
+			if (!isLegacyMessage && !isCurrentMessage || typeof entry.id !== "string" || typeof entry.message !== "object") continue;
+			frames.push({
+				type: "entry_appended",
+				entry
+			});
+		}
+	}
+	return frames;
+}
+function readRange(file, start, end) {
+	const buffer = Buffer.alloc(end - start);
+	let descriptor;
+	try {
+		descriptor = node_fs.default.openSync(file, "r");
+		return buffer.subarray(0, node_fs.default.readSync(descriptor, buffer, 0, buffer.length, start));
+	} catch {
+		return;
+	} finally {
+		if (descriptor !== void 0) node_fs.default.closeSync(descriptor);
+	}
+}
+/** Tails child journals only while at least one browser thread is subscribed. */
+function createThreadJournals(options) {
+	const tails = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	let timer;
+	const advance = (tail) => {
+		const candidate = tail.file ?? options.resolve(tail.sessionId, tail.threadId);
+		if (candidate && node_path.default.isAbsolute(candidate) && node_path.default.extname(candidate) === ".sqlite") {
+			tail.file = candidate;
+			if (tail.stop) return [];
+			const runtime = require_nativeChildRuntimes.nativeChildRuntime(candidate);
+			if (runtime) {
+				tail.stop = runtime.state.subscribe((state) => {
+					const frame = {
+						type: "transcript_state",
+						state
+					};
+					tail.retained = [frame];
+					for (const listener of listeners) listener({
+						sessionId: tail.sessionId,
+						threadId: tail.threadId,
+						frame
+					});
+				});
+				tail.retained = [{
+					type: "transcript_state",
+					state: runtime.state.state
+				}];
+			} else tail.retained = [{ type: "transcript_ready" }];
+			return tail.retained;
+		}
+		if (candidate === void 0 || !node_path.default.isAbsolute(candidate) || node_path.default.extname(candidate) !== ".jsonl") return [];
+		tail.file = candidate;
+		let size;
+		try {
+			size = node_fs.default.statSync(candidate).size;
+		} catch {
+			return [];
+		}
+		if (size < tail.offset) {
+			tail.offset = 0;
+			tail.retained = [];
+		}
+		const cut = tail.offset === 0 && size > MAX_INITIAL_BYTES;
+		const start = cut ? size - MAX_INITIAL_BYTES : tail.offset;
+		if (size <= start) return [];
+		const chunk = readRange(candidate, start, size);
+		if (chunk === void 0) return [];
+		const lastNewline = chunk.lastIndexOf(NEWLINE);
+		if (lastNewline < 0) return [];
+		const first = cut ? chunk.indexOf(NEWLINE) + 1 : 0;
+		const frames = first > lastNewline ? [] : journalFrames(chunk.toString("utf8", first, lastNewline + 1));
+		tail.offset = start + lastNewline + 1;
+		if (frames.length > 0) tail.retained = [...tail.retained, ...frames].slice(-300);
+		return frames;
+	};
+	const tick = () => {
+		for (const tail of tails.values()) for (const frame of advance(tail)) for (const listener of listeners) listener({
+			sessionId: tail.sessionId,
+			threadId: tail.threadId,
+			frame
+		});
+	};
+	const syncTimer = () => {
+		if (tails.size > 0 && timer === void 0) timer = setInterval(tick, POLL_MS);
+		if (tails.size === 0 && timer !== void 0) {
+			clearInterval(timer);
+			timer = void 0;
+		}
+	};
+	return {
+		async readPage(sessionId, threadId, request, context) {
+			const file = options.resolve(sessionId, threadId);
+			if (!file || !node_path.default.isAbsolute(file) || node_path.default.extname(file) !== ".sqlite") throw new Error("Child SQLite transcript not found");
+			const { threadId: _threadId, ...query } = request;
+			const runtime = require_nativeChildRuntimes.nativeChildRuntime(file);
+			return runtime ? runtime.readTranscriptPage(query, context) : require_index.readSqliteTranscript(file, query, context);
+		},
+		subscribe(sessionId, threadId) {
+			const key = keyOf(sessionId, threadId);
+			const tail = tails.get(key) ?? {
+				sessionId,
+				threadId,
+				refs: 0,
+				file: void 0,
+				offset: 0,
+				retained: []
+			};
+			if (!tails.has(key)) tails.set(key, tail);
+			tail.refs += 1;
+			advance(tail);
+			syncTimer();
+			return [...tail.retained];
+		},
+		unsubscribe(sessionId, threadId) {
+			const key = keyOf(sessionId, threadId);
+			const tail = tails.get(key);
+			if (tail === void 0) return;
+			tail.refs -= 1;
+			if (tail.refs <= 0) {
+				tail.stop?.();
+				tails.delete(key);
+			}
+			syncTimer();
+		},
+		onFrame(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		close() {
+			if (timer !== void 0) clearInterval(timer);
+			timer = void 0;
+			for (const tail of tails.values()) tail.stop?.();
+			tails.clear();
+			listeners.clear();
+		}
+	};
+}
+//#endregion
+exports.createThreadJournals = createThreadJournals;
+
+//# sourceMappingURL=threadJournals.cjs.map

package/dist/server/threadJournals.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"threadJournals.cjs","names":["fs","path","nativeChildRuntime","readSqliteTranscript"],"sources":["../../src/server/threadJournals.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\n\nimport type { TranscriptPage, TranscriptPageRequest } from '../exports/sessionProtocol';\nimport { readSqliteTranscript } from '../services/sqliteTranscriptReader';\nimport { nativeChildRuntime } from '../systems/child/adapters/nativeChildRuntimes';\n\nconst POLL_MS = 250;\nconst RETAIN_LIMIT = 300;\nconst MAX_INITIAL_BYTES = 8 * 1024 * 1024;\nconst NEWLINE = 0x0a;\n\ntype Frame = Record<string, unknown>;\n\ninterface Tail {\n  readonly sessionId: string;\n  readonly threadId: string;\n  refs: number;\n  file: string | undefined;\n  offset: number;\n  retained: Frame[];\n  stop?: () => void;\n}\n\nexport interface ThreadJournals {\n  readPage(\n    sessionId: string,\n    threadId: string,\n    request: TranscriptPageRequest,\n    context: Context,\n  ): Promise<TranscriptPage>;\n  subscribe(sessionId: string, threadId: string): Frame[];\n  unsubscribe(sessionId: string, threadId: string): void;\n  onFrame(listener: (event: { sessionId: string; threadId: string; frame: Frame }) => void): () => void;\n  close(): void;\n}\n\nfunction keyOf(sessionId: string, threadId: string): string {\n  return `${sessionId}\\n${threadId}`;\n}\n\nfunction journalFrames(text: string): Frame[] {\n  const frames: Frame[] = [];\n  for (const line of text.split('\\n')) {\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(line) as unknown;\n    } catch {\n      continue;\n    }\n    const rows = Array.isArray(parsed) ? parsed : [parsed];\n    for (const row of rows) {\n      if (typeof row !== 'object' || row === null || Array.isArray(row)) continue;\n      const entry = row as Record<string, unknown>;\n      const isLegacyMessage = entry.type === 'message';\n      const isCurrentMessage = entry.kind === 'entry' && entry.type === 'message';\n      if (\n        (!isLegacyMessage && !isCurrentMessage) ||\n        typeof entry.id !== 'string' ||\n        typeof entry.message !== 'object'\n      ) {\n        continue;\n      }\n      frames.push({ type: 'entry_appended', entry });\n    }\n  }\n  return frames;\n}\n\nfunction readRange(file: string, start: number, end: number): Buffer | undefined {\n  const buffer = Buffer.alloc(end - start);\n  let descriptor: number | undefined;\n  try {\n    descriptor = fs.openSync(file, 'r');\n    return buffer.subarray(0, fs.readSync(descriptor, buffer, 0, buffer.length, start));\n  } catch {\n    return undefined;\n  } finally {\n    if (descriptor !== undefined) fs.closeSync(descriptor);\n  }\n}\n\n/** Tails child journals only while at least one browser thread is subscribed. */\nexport function createThreadJournals(options: {\n  resolve(sessionId: string, threadId: string): string | undefined;\n}): ThreadJournals {\n  const tails = new Map<string, Tail>();\n  const listeners = new Set<(event: { sessionId: string; threadId: string; frame: Frame }) => void>();\n  let timer: NodeJS.Timeout | undefined;\n\n  const advance = (tail: Tail): Frame[] => {\n    const candidate = tail.file ?? options.resolve(tail.sessionId, tail.threadId);\n    if (candidate && path.isAbsolute(candidate) && path.extname(candidate) === '.sqlite') {\n      tail.file = candidate;\n      if (tail.stop) return [];\n      const runtime = nativeChildRuntime(candidate);\n      if (runtime) {\n        tail.stop = runtime.state.subscribe((state) => {\n          const frame = { type: 'transcript_state', state };\n          tail.retained = [frame];\n          for (const listener of listeners) listener({ sessionId: tail.sessionId, threadId: tail.threadId, frame });\n        });\n        tail.retained = [{ type: 'transcript_state', state: runtime.state.state }];\n      } else tail.retained = [{ type: 'transcript_ready' }];\n      return tail.retained;\n    }\n    if (candidate === undefined || !path.isAbsolute(candidate) || path.extname(candidate) !== '.jsonl') return [];\n    tail.file = candidate;\n    let size: number;\n    try {\n      size = fs.statSync(candidate).size;\n    } catch {\n      return [];\n    }\n    if (size < tail.offset) {\n      tail.offset = 0;\n      tail.retained = [];\n    }\n    const cut = tail.offset === 0 && size > MAX_INITIAL_BYTES;\n    const start = cut ? size - MAX_INITIAL_BYTES : tail.offset;\n    if (size <= start) return [];\n    const chunk = readRange(candidate, start, size);\n    if (chunk === undefined) return [];\n    const lastNewline = chunk.lastIndexOf(NEWLINE);\n    if (lastNewline < 0) return [];\n    const first = cut ? chunk.indexOf(NEWLINE) + 1 : 0;\n    const frames = first > lastNewline ? [] : journalFrames(chunk.toString('utf8', first, lastNewline + 1));\n    tail.offset = start + lastNewline + 1;\n    if (frames.length > 0) tail.retained = [...tail.retained, ...frames].slice(-RETAIN_LIMIT);\n    return frames;\n  };\n  const tick = (): void => {\n    for (const tail of tails.values()) {\n      for (const frame of advance(tail)) {\n        for (const listener of listeners) listener({ sessionId: tail.sessionId, threadId: tail.threadId, frame });\n      }\n    }\n  };\n  const syncTimer = (): void => {\n    if (tails.size > 0 && timer === undefined) timer = setInterval(tick, POLL_MS);\n    if (tails.size === 0 && timer !== undefined) {\n      clearInterval(timer);\n      timer = undefined;\n    }\n  };\n\n  return {\n    async readPage(sessionId, threadId, request, context) {\n      const file = options.resolve(sessionId, threadId);\n      if (!file || !path.isAbsolute(file) || path.extname(file) !== '.sqlite')\n        throw new Error('Child SQLite transcript not found');\n      const { threadId: _threadId, ...query } = request;\n      const runtime = nativeChildRuntime(file);\n      return runtime ? runtime.readTranscriptPage(query, context) : readSqliteTranscript(file, query, context);\n    },\n    subscribe(sessionId, threadId) {\n      const key = keyOf(sessionId, threadId);\n      const tail = tails.get(key) ?? {\n        sessionId,\n        threadId,\n        refs: 0,\n        file: undefined,\n        offset: 0,\n        retained: [],\n      };\n      if (!tails.has(key)) tails.set(key, tail);\n      tail.refs += 1;\n      advance(tail);\n      syncTimer();\n      return [...tail.retained];\n    },\n    unsubscribe(sessionId, threadId) {\n      const key = keyOf(sessionId, threadId);\n      const tail = tails.get(key);\n      if (tail === undefined) return;\n      tail.refs -= 1;\n      if (tail.refs <= 0) {\n        tail.stop?.();\n        tails.delete(key);\n      }\n      syncTimer();\n    },\n    onFrame(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    close() {\n      if (timer !== undefined) clearInterval(timer);\n      timer = undefined;\n      for (const tail of tails.values()) tail.stop?.();\n      tails.clear();\n      listeners.clear();\n    },\n  };\n}\n"],"mappings":";;;;;;;;AASA,MAAM,UAAU;AAEhB,MAAM,oBAAoB;AAC1B,MAAM,UAAU;AA2BhB,SAAS,MAAM,WAAmB,UAA0B;CAC1D,OAAO,GAAG,UAAU,IAAI;AAC1B;AAEA,SAAS,cAAc,MAAuB;CAC5C,MAAM,SAAkB,CAAC;CACzB,KAAK,MAAM,QAAQ,KAAK,MAAM,IAAI,GAAG;EACnC,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,IAAI;EAC1B,QAAQ;GACN;EACF;EACA,MAAM,OAAO,MAAM,QAAQ,MAAM,IAAI,SAAS,CAAC,MAAM;EACrD,KAAK,MAAM,OAAO,MAAM;GACtB,IAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,MAAM,QAAQ,GAAG,GAAG;GACnE,MAAM,QAAQ;GACd,MAAM,kBAAkB,MAAM,SAAS;GACvC,MAAM,mBAAmB,MAAM,SAAS,WAAW,MAAM,SAAS;GAClE,IACG,CAAC,mBAAmB,CAAC,oBACtB,OAAO,MAAM,OAAO,YACpB,OAAO,MAAM,YAAY,UAEzB;GAEF,OAAO,KAAK;IAAE,MAAM;IAAkB;GAAM,CAAC;EAC/C;CACF;CACA,OAAO;AACT;AAEA,SAAS,UAAU,MAAc,OAAe,KAAiC;CAC/E,MAAM,SAAS,OAAO,MAAM,MAAM,KAAK;CACvC,IAAI;CACJ,IAAI;EACF,aAAaA,QAAAA,QAAG,SAAS,MAAM,GAAG;EAClC,OAAO,OAAO,SAAS,GAAGA,QAAAA,QAAG,SAAS,YAAY,QAAQ,GAAG,OAAO,QAAQ,KAAK,CAAC;CACpF,QAAQ;EACN;CACF,UAAU;EACR,IAAI,eAAe,KAAA,GAAW,QAAA,QAAG,UAAU,UAAU;CACvD;AACF;;AAGA,SAAgB,qBAAqB,SAElB;CACjB,MAAM,wBAAQ,IAAI,IAAkB;CACpC,MAAM,4BAAY,IAAI,IAA4E;CAClG,IAAI;CAEJ,MAAM,WAAW,SAAwB;EACvC,MAAM,YAAY,KAAK,QAAQ,QAAQ,QAAQ,KAAK,WAAW,KAAK,QAAQ;EAC5E,IAAI,aAAaC,UAAAA,QAAK,WAAW,SAAS,KAAKA,UAAAA,QAAK,QAAQ,SAAS,MAAM,WAAW;GACpF,KAAK,OAAO;GACZ,IAAI,KAAK,MAAM,OAAO,CAAC;GACvB,MAAM,UAAUC,4BAAAA,mBAAmB,SAAS;GAC5C,IAAI,SAAS;IACX,KAAK,OAAO,QAAQ,MAAM,WAAW,UAAU;KAC7C,MAAM,QAAQ;MAAE,MAAM;MAAoB;KAAM;KAChD,KAAK,WAAW,CAAC,KAAK;KACtB,KAAK,MAAM,YAAY,WAAW,SAAS;MAAE,WAAW,KAAK;MAAW,UAAU,KAAK;MAAU;KAAM,CAAC;IAC1G,CAAC;IACD,KAAK,WAAW,CAAC;KAAE,MAAM;KAAoB,OAAO,QAAQ,MAAM;IAAM,CAAC;GAC3E,OAAO,KAAK,WAAW,CAAC,EAAE,MAAM,mBAAmB,CAAC;GACpD,OAAO,KAAK;EACd;EACA,IAAI,cAAc,KAAA,KAAa,CAACD,UAAAA,QAAK,WAAW,SAAS,KAAKA,UAAAA,QAAK,QAAQ,SAAS,MAAM,UAAU,OAAO,CAAC;EAC5G,KAAK,OAAO;EACZ,IAAI;EACJ,IAAI;GACF,OAAOD,QAAAA,QAAG,SAAS,SAAS,CAAC,CAAC;EAChC,QAAQ;GACN,OAAO,CAAC;EACV;EACA,IAAI,OAAO,KAAK,QAAQ;GACtB,KAAK,SAAS;GACd,KAAK,WAAW,CAAC;EACnB;EACA,MAAM,MAAM,KAAK,WAAW,KAAK,OAAO;EACxC,MAAM,QAAQ,MAAM,OAAO,oBAAoB,KAAK;EACpD,IAAI,QAAQ,OAAO,OAAO,CAAC;EAC3B,MAAM,QAAQ,UAAU,WAAW,OAAO,IAAI;EAC9C,IAAI,UAAU,KAAA,GAAW,OAAO,CAAC;EACjC,MAAM,cAAc,MAAM,YAAY,OAAO;EAC7C,IAAI,cAAc,GAAG,OAAO,CAAC;EAC7B,MAAM,QAAQ,MAAM,MAAM,QAAQ,OAAO,IAAI,IAAI;EACjD,MAAM,SAAS,QAAQ,cAAc,CAAC,IAAI,cAAc,MAAM,SAAS,QAAQ,OAAO,cAAc,CAAC,CAAC;EACtG,KAAK,SAAS,QAAQ,cAAc;EACpC,IAAI,OAAO,SAAS,GAAG,KAAK,WAAW,CAAC,GAAG,KAAK,UAAU,GAAG,MAAM,CAAC,CAAC,MAAM,IAAa;EACxF,OAAO;CACT;CACA,MAAM,aAAmB;EACvB,KAAK,MAAM,QAAQ,MAAM,OAAO,GAC9B,KAAK,MAAM,SAAS,QAAQ,IAAI,GAC9B,KAAK,MAAM,YAAY,WAAW,SAAS;GAAE,WAAW,KAAK;GAAW,UAAU,KAAK;GAAU;EAAM,CAAC;CAG9G;CACA,MAAM,kBAAwB;EAC5B,IAAI,MAAM,OAAO,KAAK,UAAU,KAAA,GAAW,QAAQ,YAAY,MAAM,OAAO;EAC5E,IAAI,MAAM,SAAS,KAAK,UAAU,KAAA,GAAW;GAC3C,cAAc,KAAK;GACnB,QAAQ,KAAA;EACV;CACF;CAEA,OAAO;EACL,MAAM,SAAS,WAAW,UAAU,SAAS,SAAS;GACpD,MAAM,OAAO,QAAQ,QAAQ,WAAW,QAAQ;GAChD,IAAI,CAAC,QAAQ,CAACC,UAAAA,QAAK,WAAW,IAAI,KAAKA,UAAAA,QAAK,QAAQ,IAAI,MAAM,WAC5D,MAAM,IAAI,MAAM,mCAAmC;GACrD,MAAM,EAAE,UAAU,WAAW,GAAG,UAAU;GAC1C,MAAM,UAAUC,4BAAAA,mBAAmB,IAAI;GACvC,OAAO,UAAU,QAAQ,mBAAmB,OAAO,OAAO,IAAIC,cAAAA,qBAAqB,MAAM,OAAO,OAAO;EACzG;EACA,UAAU,WAAW,UAAU;GAC7B,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,OAAO,MAAM,IAAI,GAAG,KAAK;IAC7B;IACA;IACA,MAAM;IACN,MAAM,KAAA;IACN,QAAQ;IACR,UAAU,CAAC;GACb;GACA,IAAI,CAAC,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,KAAK,IAAI;GACxC,KAAK,QAAQ;GACb,QAAQ,IAAI;GACZ,UAAU;GACV,OAAO,CAAC,GAAG,KAAK,QAAQ;EAC1B;EACA,YAAY,WAAW,UAAU;GAC/B,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,OAAO,MAAM,IAAI,GAAG;GAC1B,IAAI,SAAS,KAAA,GAAW;GACxB,KAAK,QAAQ;GACb,IAAI,KAAK,QAAQ,GAAG;IAClB,KAAK,OAAO;IACZ,MAAM,OAAO,GAAG;GAClB;GACA,UAAU;EACZ;EACA,QAAQ,UAAU;GAChB,UAAU,IAAI,QAAQ;GACtB,aAAa,UAAU,OAAO,QAAQ;EACxC;EACA,QAAQ;GACN,IAAI,UAAU,KAAA,GAAW,cAAc,KAAK;GAC5C,QAAQ,KAAA;GACR,KAAK,MAAM,QAAQ,MAAM,OAAO,GAAG,KAAK,OAAO;GAC/C,MAAM,MAAM;GACZ,UAAU,MAAM;EAClB;CACF;AACF"}

package/dist/server/threadJournals.mjs

@@ -0,0 +1,169 @@
+import { readSqliteTranscript } from "../services/sqliteTranscriptReader/index.mjs";
+import { nativeChildRuntime } from "../systems/child/adapters/nativeChildRuntimes.mjs";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/server/threadJournals.ts
+const POLL_MS = 250;
+const MAX_INITIAL_BYTES = 8388608;
+const NEWLINE = 10;
+function keyOf(sessionId, threadId) {
+	return `${sessionId}\n${threadId}`;
+}
+function journalFrames(text) {
+	const frames = [];
+	for (const line of text.split("\n")) {
+		let parsed;
+		try {
+			parsed = JSON.parse(line);
+		} catch {
+			continue;
+		}
+		const rows = Array.isArray(parsed) ? parsed : [parsed];
+		for (const row of rows) {
+			if (typeof row !== "object" || row === null || Array.isArray(row)) continue;
+			const entry = row;
+			const isLegacyMessage = entry.type === "message";
+			const isCurrentMessage = entry.kind === "entry" && entry.type === "message";
+			if (!isLegacyMessage && !isCurrentMessage || typeof entry.id !== "string" || typeof entry.message !== "object") continue;
+			frames.push({
+				type: "entry_appended",
+				entry
+			});
+		}
+	}
+	return frames;
+}
+function readRange(file, start, end) {
+	const buffer = Buffer.alloc(end - start);
+	let descriptor;
+	try {
+		descriptor = fs.openSync(file, "r");
+		return buffer.subarray(0, fs.readSync(descriptor, buffer, 0, buffer.length, start));
+	} catch {
+		return;
+	} finally {
+		if (descriptor !== void 0) fs.closeSync(descriptor);
+	}
+}
+/** Tails child journals only while at least one browser thread is subscribed. */
+function createThreadJournals(options) {
+	const tails = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	let timer;
+	const advance = (tail) => {
+		const candidate = tail.file ?? options.resolve(tail.sessionId, tail.threadId);
+		if (candidate && path.isAbsolute(candidate) && path.extname(candidate) === ".sqlite") {
+			tail.file = candidate;
+			if (tail.stop) return [];
+			const runtime = nativeChildRuntime(candidate);
+			if (runtime) {
+				tail.stop = runtime.state.subscribe((state) => {
+					const frame = {
+						type: "transcript_state",
+						state
+					};
+					tail.retained = [frame];
+					for (const listener of listeners) listener({
+						sessionId: tail.sessionId,
+						threadId: tail.threadId,
+						frame
+					});
+				});
+				tail.retained = [{
+					type: "transcript_state",
+					state: runtime.state.state
+				}];
+			} else tail.retained = [{ type: "transcript_ready" }];
+			return tail.retained;
+		}
+		if (candidate === void 0 || !path.isAbsolute(candidate) || path.extname(candidate) !== ".jsonl") return [];
+		tail.file = candidate;
+		let size;
+		try {
+			size = fs.statSync(candidate).size;
+		} catch {
+			return [];
+		}
+		if (size < tail.offset) {
+			tail.offset = 0;
+			tail.retained = [];
+		}
+		const cut = tail.offset === 0 && size > MAX_INITIAL_BYTES;
+		const start = cut ? size - MAX_INITIAL_BYTES : tail.offset;
+		if (size <= start) return [];
+		const chunk = readRange(candidate, start, size);
+		if (chunk === void 0) return [];
+		const lastNewline = chunk.lastIndexOf(NEWLINE);
+		if (lastNewline < 0) return [];
+		const first = cut ? chunk.indexOf(NEWLINE) + 1 : 0;
+		const frames = first > lastNewline ? [] : journalFrames(chunk.toString("utf8", first, lastNewline + 1));
+		tail.offset = start + lastNewline + 1;
+		if (frames.length > 0) tail.retained = [...tail.retained, ...frames].slice(-300);
+		return frames;
+	};
+	const tick = () => {
+		for (const tail of tails.values()) for (const frame of advance(tail)) for (const listener of listeners) listener({
+			sessionId: tail.sessionId,
+			threadId: tail.threadId,
+			frame
+		});
+	};
+	const syncTimer = () => {
+		if (tails.size > 0 && timer === void 0) timer = setInterval(tick, POLL_MS);
+		if (tails.size === 0 && timer !== void 0) {
+			clearInterval(timer);
+			timer = void 0;
+		}
+	};
+	return {
+		async readPage(sessionId, threadId, request, context) {
+			const file = options.resolve(sessionId, threadId);
+			if (!file || !path.isAbsolute(file) || path.extname(file) !== ".sqlite") throw new Error("Child SQLite transcript not found");
+			const { threadId: _threadId, ...query } = request;
+			const runtime = nativeChildRuntime(file);
+			return runtime ? runtime.readTranscriptPage(query, context) : readSqliteTranscript(file, query, context);
+		},
+		subscribe(sessionId, threadId) {
+			const key = keyOf(sessionId, threadId);
+			const tail = tails.get(key) ?? {
+				sessionId,
+				threadId,
+				refs: 0,
+				file: void 0,
+				offset: 0,
+				retained: []
+			};
+			if (!tails.has(key)) tails.set(key, tail);
+			tail.refs += 1;
+			advance(tail);
+			syncTimer();
+			return [...tail.retained];
+		},
+		unsubscribe(sessionId, threadId) {
+			const key = keyOf(sessionId, threadId);
+			const tail = tails.get(key);
+			if (tail === void 0) return;
+			tail.refs -= 1;
+			if (tail.refs <= 0) {
+				tail.stop?.();
+				tails.delete(key);
+			}
+			syncTimer();
+		},
+		onFrame(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		close() {
+			if (timer !== void 0) clearInterval(timer);
+			timer = void 0;
+			for (const tail of tails.values()) tail.stop?.();
+			tails.clear();
+			listeners.clear();
+		}
+	};
+}
+//#endregion
+export { createThreadJournals };
+
+//# sourceMappingURL=threadJournals.mjs.map

package/dist/server/threadJournals.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"threadJournals.mjs","names":[],"sources":["../../src/server/threadJournals.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\n\nimport type { TranscriptPage, TranscriptPageRequest } from '../exports/sessionProtocol';\nimport { readSqliteTranscript } from '../services/sqliteTranscriptReader';\nimport { nativeChildRuntime } from '../systems/child/adapters/nativeChildRuntimes';\n\nconst POLL_MS = 250;\nconst RETAIN_LIMIT = 300;\nconst MAX_INITIAL_BYTES = 8 * 1024 * 1024;\nconst NEWLINE = 0x0a;\n\ntype Frame = Record<string, unknown>;\n\ninterface Tail {\n  readonly sessionId: string;\n  readonly threadId: string;\n  refs: number;\n  file: string | undefined;\n  offset: number;\n  retained: Frame[];\n  stop?: () => void;\n}\n\nexport interface ThreadJournals {\n  readPage(\n    sessionId: string,\n    threadId: string,\n    request: TranscriptPageRequest,\n    context: Context,\n  ): Promise<TranscriptPage>;\n  subscribe(sessionId: string, threadId: string): Frame[];\n  unsubscribe(sessionId: string, threadId: string): void;\n  onFrame(listener: (event: { sessionId: string; threadId: string; frame: Frame }) => void): () => void;\n  close(): void;\n}\n\nfunction keyOf(sessionId: string, threadId: string): string {\n  return `${sessionId}\\n${threadId}`;\n}\n\nfunction journalFrames(text: string): Frame[] {\n  const frames: Frame[] = [];\n  for (const line of text.split('\\n')) {\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(line) as unknown;\n    } catch {\n      continue;\n    }\n    const rows = Array.isArray(parsed) ? parsed : [parsed];\n    for (const row of rows) {\n      if (typeof row !== 'object' || row === null || Array.isArray(row)) continue;\n      const entry = row as Record<string, unknown>;\n      const isLegacyMessage = entry.type === 'message';\n      const isCurrentMessage = entry.kind === 'entry' && entry.type === 'message';\n      if (\n        (!isLegacyMessage && !isCurrentMessage) ||\n        typeof entry.id !== 'string' ||\n        typeof entry.message !== 'object'\n      ) {\n        continue;\n      }\n      frames.push({ type: 'entry_appended', entry });\n    }\n  }\n  return frames;\n}\n\nfunction readRange(file: string, start: number, end: number): Buffer | undefined {\n  const buffer = Buffer.alloc(end - start);\n  let descriptor: number | undefined;\n  try {\n    descriptor = fs.openSync(file, 'r');\n    return buffer.subarray(0, fs.readSync(descriptor, buffer, 0, buffer.length, start));\n  } catch {\n    return undefined;\n  } finally {\n    if (descriptor !== undefined) fs.closeSync(descriptor);\n  }\n}\n\n/** Tails child journals only while at least one browser thread is subscribed. */\nexport function createThreadJournals(options: {\n  resolve(sessionId: string, threadId: string): string | undefined;\n}): ThreadJournals {\n  const tails = new Map<string, Tail>();\n  const listeners = new Set<(event: { sessionId: string; threadId: string; frame: Frame }) => void>();\n  let timer: NodeJS.Timeout | undefined;\n\n  const advance = (tail: Tail): Frame[] => {\n    const candidate = tail.file ?? options.resolve(tail.sessionId, tail.threadId);\n    if (candidate && path.isAbsolute(candidate) && path.extname(candidate) === '.sqlite') {\n      tail.file = candidate;\n      if (tail.stop) return [];\n      const runtime = nativeChildRuntime(candidate);\n      if (runtime) {\n        tail.stop = runtime.state.subscribe((state) => {\n          const frame = { type: 'transcript_state', state };\n          tail.retained = [frame];\n          for (const listener of listeners) listener({ sessionId: tail.sessionId, threadId: tail.threadId, frame });\n        });\n        tail.retained = [{ type: 'transcript_state', state: runtime.state.state }];\n      } else tail.retained = [{ type: 'transcript_ready' }];\n      return tail.retained;\n    }\n    if (candidate === undefined || !path.isAbsolute(candidate) || path.extname(candidate) !== '.jsonl') return [];\n    tail.file = candidate;\n    let size: number;\n    try {\n      size = fs.statSync(candidate).size;\n    } catch {\n      return [];\n    }\n    if (size < tail.offset) {\n      tail.offset = 0;\n      tail.retained = [];\n    }\n    const cut = tail.offset === 0 && size > MAX_INITIAL_BYTES;\n    const start = cut ? size - MAX_INITIAL_BYTES : tail.offset;\n    if (size <= start) return [];\n    const chunk = readRange(candidate, start, size);\n    if (chunk === undefined) return [];\n    const lastNewline = chunk.lastIndexOf(NEWLINE);\n    if (lastNewline < 0) return [];\n    const first = cut ? chunk.indexOf(NEWLINE) + 1 : 0;\n    const frames = first > lastNewline ? [] : journalFrames(chunk.toString('utf8', first, lastNewline + 1));\n    tail.offset = start + lastNewline + 1;\n    if (frames.length > 0) tail.retained = [...tail.retained, ...frames].slice(-RETAIN_LIMIT);\n    return frames;\n  };\n  const tick = (): void => {\n    for (const tail of tails.values()) {\n      for (const frame of advance(tail)) {\n        for (const listener of listeners) listener({ sessionId: tail.sessionId, threadId: tail.threadId, frame });\n      }\n    }\n  };\n  const syncTimer = (): void => {\n    if (tails.size > 0 && timer === undefined) timer = setInterval(tick, POLL_MS);\n    if (tails.size === 0 && timer !== undefined) {\n      clearInterval(timer);\n      timer = undefined;\n    }\n  };\n\n  return {\n    async readPage(sessionId, threadId, request, context) {\n      const file = options.resolve(sessionId, threadId);\n      if (!file || !path.isAbsolute(file) || path.extname(file) !== '.sqlite')\n        throw new Error('Child SQLite transcript not found');\n      const { threadId: _threadId, ...query } = request;\n      const runtime = nativeChildRuntime(file);\n      return runtime ? runtime.readTranscriptPage(query, context) : readSqliteTranscript(file, query, context);\n    },\n    subscribe(sessionId, threadId) {\n      const key = keyOf(sessionId, threadId);\n      const tail = tails.get(key) ?? {\n        sessionId,\n        threadId,\n        refs: 0,\n        file: undefined,\n        offset: 0,\n        retained: [],\n      };\n      if (!tails.has(key)) tails.set(key, tail);\n      tail.refs += 1;\n      advance(tail);\n      syncTimer();\n      return [...tail.retained];\n    },\n    unsubscribe(sessionId, threadId) {\n      const key = keyOf(sessionId, threadId);\n      const tail = tails.get(key);\n      if (tail === undefined) return;\n      tail.refs -= 1;\n      if (tail.refs <= 0) {\n        tail.stop?.();\n        tails.delete(key);\n      }\n      syncTimer();\n    },\n    onFrame(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    close() {\n      if (timer !== undefined) clearInterval(timer);\n      timer = undefined;\n      for (const tail of tails.values()) tail.stop?.();\n      tails.clear();\n      listeners.clear();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/server-facet.cjs

@@ -0,0 +1,27 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_serverFacet = require("./schemas/serverFacet.cjs");
+const require_index = require("./services/serverFacet/index.cjs");
+const require_serverBundle = require("./schemas/serverBundle.cjs");
+const require_serverFacetLoader = require("./server/serverFacetLoader.cjs");
+const require_pluginContributions = require("./schemas/pluginContributions.cjs");
+const require_serverPlugin = require("./extensions/serverPlugin.cjs");
+exports.DOOM_SERVER_BUNDLE_FILE = require_serverBundle.DOOM_SERVER_BUNDLE_FILE;
+exports.DOOM_SERVER_BUNDLE_VERSION = require_serverBundle.DOOM_SERVER_BUNDLE_VERSION;
+exports.DOOM_SERVER_FACET_EXPORT = require_serverFacet.DOOM_SERVER_FACET_EXPORT;
+exports.DOOM_SERVER_FACET_MANIFEST_FIELD = require_serverFacet.DOOM_SERVER_FACET_MANIFEST_FIELD;
+exports.DOOM_SERVER_HOST_SERVICE = require_serverFacet.DOOM_SERVER_HOST_SERVICE;
+exports.DoomServerFacetManifestError = require_serverFacet.DoomServerFacetManifestError;
+exports.createDoomServerHost = require_index.createDoomServerHost;
+exports.declaredServerFacetsOf = require_serverFacet.declaredServerFacetsOf;
+exports.defineCommand = require_pluginContributions.defineCommand;
+exports.defineServerMethod = require_serverFacet.defineServerMethod;
+exports.defineServerPlugin = require_serverPlugin.defineServerPlugin;
+exports.defineTool = require_pluginContributions.defineTool;
+exports.installServerFacets = require_serverFacetLoader.installServerFacets;
+exports.isDoomServerFacet = require_serverFacet.isDoomServerFacet;
+exports.loadServerBundle = require_serverFacetLoader.loadServerBundle;
+exports.orderServerFacets = require_serverFacet.orderServerFacets;
+exports.parseDoomServerBundle = require_serverBundle.parseDoomServerBundle;
+exports.readDoomServerHost = require_serverFacet.readDoomServerHost;
+exports.requireDoomServerHost = require_serverFacet.requireDoomServerHost;
+exports.resolveServerBundleSource = require_serverFacetLoader.resolveServerBundleSource;

package/dist/server-facet.d.cts

@@ -0,0 +1,7 @@
+import { DOOM_SERVER_BUNDLE_FILE, DOOM_SERVER_BUNDLE_VERSION, DoomServerBundle, DoomServerBundleEntry, DoomServerBundleOwner, parseDoomServerBundle } from "./schemas/serverBundle.cjs";
+import { DoomPluginCommand, DoomPluginTool, DoomPluginToolExecution, DoomPluginToolResult, defineCommand, defineTool } from "./schemas/pluginContributions.cjs";
+import { DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, DeclaredServerFacet, DoomServerFacet, DoomServerFacetManifestError, DoomServerHostService, DoomServerMethod, DoomServerPluginContext, DoomServerPluginDefinition, DoomServerPluginScope, DoomServerRegistration, DoomServerSessionPlugin, declaredServerFacetsOf, defineServerMethod, isDoomServerFacet, orderServerFacets, readDoomServerHost, requireDoomServerHost } from "./schemas/serverFacet.cjs";
+import { CreateDoomServerHostOptions, DoomServerHost, createDoomServerHost } from "./services/serverFacet/index.cjs";
+import { InstallServerFacetsOptions, InstalledServerFacets, LoadServerBundleOptions, LoadedServerBundle, LoadedServerFacet, ServerBundleSource, installServerFacets, loadServerBundle, resolveServerBundleSource } from "./server/serverFacetLoader.cjs";
+import { defineServerPlugin } from "./extensions/serverPlugin.cjs";
+export { type CreateDoomServerHostOptions, DOOM_SERVER_BUNDLE_FILE, DOOM_SERVER_BUNDLE_VERSION, DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, type DeclaredServerFacet, type DoomPluginCommand, type DoomPluginTool, type DoomPluginToolExecution, type DoomPluginToolResult, type DoomServerBundle, type DoomServerBundleEntry, type DoomServerBundleOwner, type DoomServerFacet, DoomServerFacetManifestError, type DoomServerHost, type DoomServerHostService, type DoomServerMethod, type DoomServerPluginContext, type DoomServerPluginDefinition, type DoomServerPluginScope, type DoomServerRegistration, type DoomServerSessionPlugin, type InstallServerFacetsOptions, type InstalledServerFacets, type LoadServerBundleOptions, type LoadedServerBundle, type LoadedServerFacet, type ServerBundleSource, createDoomServerHost, declaredServerFacetsOf, defineCommand, defineServerMethod, defineServerPlugin, defineTool, installServerFacets, isDoomServerFacet, loadServerBundle, orderServerFacets, parseDoomServerBundle, readDoomServerHost, requireDoomServerHost, resolveServerBundleSource };

package/dist/server-facet.d.mts

@@ -0,0 +1,7 @@
+import { DOOM_SERVER_BUNDLE_FILE, DOOM_SERVER_BUNDLE_VERSION, DoomServerBundle, DoomServerBundleEntry, DoomServerBundleOwner, parseDoomServerBundle } from "./schemas/serverBundle.mjs";
+import { DoomPluginCommand, DoomPluginTool, DoomPluginToolExecution, DoomPluginToolResult, defineCommand, defineTool } from "./schemas/pluginContributions.mjs";
+import { DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, DeclaredServerFacet, DoomServerFacet, DoomServerFacetManifestError, DoomServerHostService, DoomServerMethod, DoomServerPluginContext, DoomServerPluginDefinition, DoomServerPluginScope, DoomServerRegistration, DoomServerSessionPlugin, declaredServerFacetsOf, defineServerMethod, isDoomServerFacet, orderServerFacets, readDoomServerHost, requireDoomServerHost } from "./schemas/serverFacet.mjs";
+import { CreateDoomServerHostOptions, DoomServerHost, createDoomServerHost } from "./services/serverFacet/index.mjs";
+import { InstallServerFacetsOptions, InstalledServerFacets, LoadServerBundleOptions, LoadedServerBundle, LoadedServerFacet, ServerBundleSource, installServerFacets, loadServerBundle, resolveServerBundleSource } from "./server/serverFacetLoader.mjs";
+import { defineServerPlugin } from "./extensions/serverPlugin.mjs";
+export { type CreateDoomServerHostOptions, DOOM_SERVER_BUNDLE_FILE, DOOM_SERVER_BUNDLE_VERSION, DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, type DeclaredServerFacet, type DoomPluginCommand, type DoomPluginTool, type DoomPluginToolExecution, type DoomPluginToolResult, type DoomServerBundle, type DoomServerBundleEntry, type DoomServerBundleOwner, type DoomServerFacet, DoomServerFacetManifestError, type DoomServerHost, type DoomServerHostService, type DoomServerMethod, type DoomServerPluginContext, type DoomServerPluginDefinition, type DoomServerPluginScope, type DoomServerRegistration, type DoomServerSessionPlugin, type InstallServerFacetsOptions, type InstalledServerFacets, type LoadServerBundleOptions, type LoadedServerBundle, type LoadedServerFacet, type ServerBundleSource, createDoomServerHost, declaredServerFacetsOf, defineCommand, defineServerMethod, defineServerPlugin, defineTool, installServerFacets, isDoomServerFacet, loadServerBundle, orderServerFacets, parseDoomServerBundle, readDoomServerHost, requireDoomServerHost, resolveServerBundleSource };

package/dist/server-facet.mjs

@@ -0,0 +1,7 @@
+import { DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, DoomServerFacetManifestError, declaredServerFacetsOf, defineServerMethod, isDoomServerFacet, orderServerFacets, readDoomServerHost, requireDoomServerHost } from "./schemas/serverFacet.mjs";
+import { createDoomServerHost } from "./services/serverFacet/index.mjs";
+import { DOOM_SERVER_BUNDLE_FILE, DOOM_SERVER_BUNDLE_VERSION, parseDoomServerBundle } from "./schemas/serverBundle.mjs";
+import { installServerFacets, loadServerBundle, resolveServerBundleSource } from "./server/serverFacetLoader.mjs";
+import { defineCommand, defineTool } from "./schemas/pluginContributions.mjs";
+import { defineServerPlugin } from "./extensions/serverPlugin.mjs";
+export { DOOM_SERVER_BUNDLE_FILE, DOOM_SERVER_BUNDLE_VERSION, DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, DoomServerFacetManifestError, createDoomServerHost, declaredServerFacetsOf, defineCommand, defineServerMethod, defineServerPlugin, defineTool, installServerFacets, isDoomServerFacet, loadServerBundle, orderServerFacets, parseDoomServerBundle, readDoomServerHost, requireDoomServerHost, resolveServerBundleSource };

package/dist/server-telemetry.cjs

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _agimon_ai_doompi_telemetry = require("@agimon-ai/doompi-telemetry");
+//#region src/services/serverTelemetry/index.ts
+const SERVICE_NAME = "doompi-server";
+const PACKAGE_NAME = "@agimon-ai/doompi";
+function createServerTelemetry(options = {}) {
+	return (0, _agimon_ai_doompi_telemetry.createDoomTelemetry)({
+		serviceName: SERVICE_NAME,
+		packageName: PACKAGE_NAME,
+		cwd: options.cwd,
+		env: options.env,
+		warn: options.warn,
+		enableLogs: true,
+		enableTraces: true
+	});
+}
+/** Telemetry is diagnostic and must never interrupt the server's critical path. */
+function observe(operation, onNotice) {
+	operation.catch((error) => onNotice?.(`telemetry failed: ${error instanceof Error ? error.message : String(error)}`));
+}
+//#endregion
+exports.createServerTelemetry = createServerTelemetry;
+exports.observe = observe;
+
+//# sourceMappingURL=server-telemetry.cjs.map

package/dist/server-telemetry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-telemetry.cjs","names":["createDoomTelemetry"],"sources":["../src/services/serverTelemetry/index.ts"],"sourcesContent":["import { createDoomTelemetry, type DoomTelemetry } from '@agimon-ai/doompi-telemetry';\n\nconst SERVICE_NAME = 'doompi-server';\nconst PACKAGE_NAME = '@agimon-ai/doompi';\n\nexport type ServerTelemetry = Pick<\n  DoomTelemetry,\n  'recordEvent' | 'recordWarning' | 'recordError' | 'runInSpan' | 'flush' | 'shutdown'\n>;\n\nexport function createServerTelemetry(\n  options: {\n    cwd?: string;\n    env?: NodeJS.ProcessEnv;\n    warn?: (message: string) => void;\n  } = {},\n): ServerTelemetry {\n  return createDoomTelemetry({\n    serviceName: SERVICE_NAME,\n    packageName: PACKAGE_NAME,\n    cwd: options.cwd,\n    env: options.env,\n    warn: options.warn,\n    enableLogs: true,\n    enableTraces: true,\n  });\n}\n\n/** Telemetry is diagnostic and must never interrupt the server's critical path. */\nexport function observe(operation: Promise<unknown>, onNotice?: (message: string) => void): void {\n  void operation.catch((error: unknown) =>\n    onNotice?.(`telemetry failed: ${error instanceof Error ? error.message : String(error)}`),\n  );\n}\n"],"mappings":";;;AAEA,MAAM,eAAe;AACrB,MAAM,eAAe;AAOrB,SAAgB,sBACd,UAII,CAAC,GACY;CACjB,QAAA,GAAOA,4BAAAA,oBAAAA,CAAoB;EACzB,aAAa;EACb,aAAa;EACb,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,MAAM,QAAQ;EACd,YAAY;EACZ,cAAc;CAChB,CAAC;AACH;;AAGA,SAAgB,QAAQ,WAA6B,UAA4C;CAC/F,UAAe,OAAO,UACpB,WAAW,qBAAqB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,CAC1F;AACF"}

package/dist/server-telemetry.d.cts

@@ -0,0 +1,12 @@
+import { DoomTelemetry } from "@agimon-ai/doompi-telemetry";
+//#region src/services/serverTelemetry/index.d.ts
+export type ServerTelemetry = Pick<DoomTelemetry, 'recordEvent' | 'recordWarning' | 'recordError' | 'runInSpan' | 'flush' | 'shutdown'>;
+export declare function createServerTelemetry(options?: {
+  cwd?: string;
+  env?: NodeJS.ProcessEnv;
+  warn?: (message: string) => void;
+}): ServerTelemetry;
+/** Telemetry is diagnostic and must never interrupt the server's critical path. */
+export declare function observe(operation: Promise<unknown>, onNotice?: (message: string) => void): void;
+//#endregion
+//# sourceMappingURL=server-telemetry.d.cts.map

package/dist/server-telemetry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-telemetry.d.cts","names":[],"sources":["../src/services/serverTelemetry/index.ts"],"mappings":";;YAKY,kBAAkB,KAC5B;wBAIc,sBACd;EACE;EACA,MAAM,OAAO;EACb,QAAQ;IAET;;wBAaa,QAAQ,WAAW,kBAAkB,YAAY"}

package/dist/server-telemetry.d.mts

@@ -0,0 +1,12 @@
+import { DoomTelemetry } from "@agimon-ai/doompi-telemetry";
+//#region src/services/serverTelemetry/index.d.ts
+export type ServerTelemetry = Pick<DoomTelemetry, 'recordEvent' | 'recordWarning' | 'recordError' | 'runInSpan' | 'flush' | 'shutdown'>;
+export declare function createServerTelemetry(options?: {
+  cwd?: string;
+  env?: NodeJS.ProcessEnv;
+  warn?: (message: string) => void;
+}): ServerTelemetry;
+/** Telemetry is diagnostic and must never interrupt the server's critical path. */
+export declare function observe(operation: Promise<unknown>, onNotice?: (message: string) => void): void;
+//#endregion
+//# sourceMappingURL=server-telemetry.d.mts.map

package/dist/server-telemetry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-telemetry.d.mts","names":[],"sources":["../src/services/serverTelemetry/index.ts"],"mappings":";;YAKY,kBAAkB,KAC5B;wBAIc,sBACd;EACE;EACA,MAAM,OAAO;EACb,QAAQ;IAET;;wBAaa,QAAQ,WAAW,kBAAkB,YAAY"}

package/dist/server-telemetry.mjs

@@ -0,0 +1,23 @@
+import { createDoomTelemetry } from "@agimon-ai/doompi-telemetry";
+//#region src/services/serverTelemetry/index.ts
+const SERVICE_NAME = "doompi-server";
+const PACKAGE_NAME = "@agimon-ai/doompi";
+function createServerTelemetry(options = {}) {
+	return createDoomTelemetry({
+		serviceName: SERVICE_NAME,
+		packageName: PACKAGE_NAME,
+		cwd: options.cwd,
+		env: options.env,
+		warn: options.warn,
+		enableLogs: true,
+		enableTraces: true
+	});
+}
+/** Telemetry is diagnostic and must never interrupt the server's critical path. */
+function observe(operation, onNotice) {
+	operation.catch((error) => onNotice?.(`telemetry failed: ${error instanceof Error ? error.message : String(error)}`));
+}
+//#endregion
+export { createServerTelemetry, observe };
+
+//# sourceMappingURL=server-telemetry.mjs.map

package/dist/server-telemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-telemetry.mjs","names":[],"sources":["../src/services/serverTelemetry/index.ts"],"sourcesContent":["import { createDoomTelemetry, type DoomTelemetry } from '@agimon-ai/doompi-telemetry';\n\nconst SERVICE_NAME = 'doompi-server';\nconst PACKAGE_NAME = '@agimon-ai/doompi';\n\nexport type ServerTelemetry = Pick<\n  DoomTelemetry,\n  'recordEvent' | 'recordWarning' | 'recordError' | 'runInSpan' | 'flush' | 'shutdown'\n>;\n\nexport function createServerTelemetry(\n  options: {\n    cwd?: string;\n    env?: NodeJS.ProcessEnv;\n    warn?: (message: string) => void;\n  } = {},\n): ServerTelemetry {\n  return createDoomTelemetry({\n    serviceName: SERVICE_NAME,\n    packageName: PACKAGE_NAME,\n    cwd: options.cwd,\n    env: options.env,\n    warn: options.warn,\n    enableLogs: true,\n    enableTraces: true,\n  });\n}\n\n/** Telemetry is diagnostic and must never interrupt the server's critical path. */\nexport function observe(operation: Promise<unknown>, onNotice?: (message: string) => void): void {\n  void operation.catch((error: unknown) =>\n    onNotice?.(`telemetry failed: ${error instanceof Error ? error.message : String(error)}`),\n  );\n}\n"],"mappings":";;AAEA,MAAM,eAAe;AACrB,MAAM,eAAe;AAOrB,SAAgB,sBACd,UAII,CAAC,GACY;CACjB,OAAO,oBAAoB;EACzB,aAAa;EACb,aAAa;EACb,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,MAAM,QAAQ;EACd,YAAY;EACZ,cAAc;CAChB,CAAC;AACH;;AAGA,SAAgB,QAAQ,WAA6B,UAA4C;CAC/F,UAAe,OAAO,UACpB,WAAW,qBAAqB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,CAC1F;AACF"}

package/dist/server.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_headless_hub = require("./headless-hub.cjs");
+const require_index = require("./services/rpcTranscript/index.cjs");
+const require_piSessionRuntime = require("./pi/piSessionRuntime.cjs");
+const require_headless_server = require("./headless-server.cjs");
+const require_headlessChildSessionService = require("./systems/child/adapters/headlessChildSessionService.cjs");
+const require_terminal_pi_child_session_service = require("./terminal-pi-child-session-service.cjs");
+exports.captureTerminalPiForkSource = require_terminal_pi_child_session_service.captureTerminalPiForkSource;
+exports.createAgentServerService = require_piSessionRuntime.createAgentServerService;
+exports.createAgentSessionRuntime = require_piSessionRuntime.createAgentSessionRuntime;
+exports.createHeadlessChildSessionService = require_headlessChildSessionService.createHeadlessChildSessionService;
+exports.createHeadlessChildSessionServiceProvider = require_headlessChildSessionService.createHeadlessChildSessionServiceProvider;
+exports.createHeadlessHub = require_headless_hub.createHeadlessHub;
+exports.createRpcTranscript = require_index.createRpcTranscript;
+exports.createTerminalPiChildSessionService = require_terminal_pi_child_session_service.createTerminalPiChildSessionService;
+exports.createTerminalPiChildSessionServiceProvider = require_terminal_pi_child_session_service.createTerminalPiChildSessionServiceProvider;
+exports.serveHeadlessServer = require_headless_server.serveHeadlessServer;

package/dist/server.d.cts

@@ -0,0 +1,10 @@
+import { HeadlessSessionHost, HeadlessSessionHostOptions } from "./headless-session-host.cjs";
+import { HeadlessSessionManager, HeadlessSessionManagerCreateOptions } from "./runtime-headless-session-manager.cjs";
+import { HeadlessHub, HeadlessHubEvent, HeadlessHubOptions, HeadlessHubSession, createHeadlessHub } from "./headless-hub.cjs";
+import { HeadlessServer, HeadlessServerOptions, serveHeadlessServer } from "./headless-server.cjs";
+import { HeadlessChildSessionServiceOptions, HeadlessChildSessionServiceProvider, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider } from "./systems/child/adapters/headlessChildSessionService.cjs";
+import { TerminalPiChildSessionServiceOptions, TerminalPiChildSessionServiceProvider, TerminalPiForkSourceManager, captureTerminalPiForkSource, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider } from "./terminal-pi-child-session-service.cjs";
+import { SessionFrame } from "./types/server/session.cjs";
+import { RpcTranscript, RpcTranscriptOptions, TranscriptReduction, createRpcTranscript } from "./services/rpcTranscript/index.cjs";
+import { AgentServerServiceOptions, AgentSessionRuntime, AgentSessionRuntimeOptions, DoomSessionMetadata, createAgentServerService, createAgentSessionRuntime } from "./pi/piSessionRuntime.cjs";
+export { type AgentServerServiceOptions, type AgentSessionRuntime, type AgentSessionRuntimeOptions, type DoomSessionMetadata, type HeadlessChildSessionServiceOptions, type HeadlessChildSessionServiceProvider, type HeadlessHub, type HeadlessHubEvent, type HeadlessHubOptions, type HeadlessHubSession, type HeadlessServer, type HeadlessServerOptions, type HeadlessSessionHost, type HeadlessSessionHostOptions, type HeadlessSessionManager, type HeadlessSessionManagerCreateOptions, type RpcTranscript, type RpcTranscriptOptions, type SessionFrame, type TerminalPiChildSessionServiceOptions, type TerminalPiChildSessionServiceProvider, type TerminalPiForkSourceManager, type TranscriptReduction, captureTerminalPiForkSource, createAgentServerService, createAgentSessionRuntime, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider, createHeadlessHub, createRpcTranscript, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider, serveHeadlessServer };