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

package/dist/packageApiServer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"packageApiServer.mjs","names":[],"sources":["../src/server/packageApiServer.ts"],"sourcesContent":["import type { DoomTraceContext } from '@agimon-ai/po-telemetry';\n\nimport type { DoomDirectEventBus, DoomHubSessionPromptOptions, DoomHubSessionService } from '../exports/hubChannel';\nimport { DOOM_API_ROUTE_PREFIX, type DoomApi, type DoomApiContext } from '../exports/packageApi';\nimport type { DoomPluginRegistry } from '../exports/pluginProtocol';\nimport { createDoomServerHost, type CreateDoomServerHostOptions, type DoomServerFacet } from '../exports/serverFacet';\nimport {\n  installServerFacets,\n  type LoadedServerFacet,\n  type InstalledServerFacets,\n  type InstallServerFacetsOptions,\n} from '../exports/serverFacet';\nimport { observe, type ServerTelemetry } from '../services/serverTelemetry';\nimport { validatedTraceContext } from '../services/traceContext';\n\n/**\n * A body that keeps streaming well after its headers went out is worth its own span. A fast\n * one is not: the request span already carries the duration and outcome, so emitting a second\n * span per call made package API traffic 99.65% of all spans recorded in a two hour sample.\n */\nexport const COMPLETION_SPAN_MIN_DURATION_MS = 1000;\n\nexport interface PackageApiServerOptions {\n  sessionId: string;\n  workspaceId?: string;\n  workspaceRoot?: string;\n  sessionContext?: DoomApiContext['sessionContext'];\n  homeDirectory?: string;\n  mountChannel?: CreateDoomServerHostOptions['mountChannel'];\n  cwd: string;\n  /** Admitted environment for APIs serving this session. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n  /** Lifecycle-owned direct events shared with the hub. */\n  readonly directEvents: DoomDirectEventBus;\n  readonly computerUse?: DoomApiContext['computerUse'];\n  /** Bound to this session's id and cwd by the host. */\n  readonly shareFile?: DoomApiContext['shareFile'];\n  readonly mediaArbitration?: DoomApiContext['mediaArbitration'];\n  readonly executionBudget?: DoomApiContext['executionBudget'];\n  readonly peerAgents?: DoomApiContext['peerAgents'];\n  readonly requestApi?: DoomApiContext['requestApi'];\n  /** Publishes this session's activity line through the hub; bound to this session only. */\n  readonly publishActivity?: DoomApiContext['publishActivity'];\n  internalToken?: string;\n  hubToken?: string;\n  /** Shared exact-scope dispatch table, so session facets can mount plugin methods. */\n  pluginRegistry?: DoomPluginRegistry;\n  sessionService?: DoomHubSessionService;\n  apis: readonly DoomApi[];\n  /** Server facets to install; each registers its own APIs through the host. */\n  facets?: readonly (DoomServerFacet | LoadedServerFacet)[];\n  prepareFacets?: InstallServerFacetsOptions['prepare'];\n  activateFacets?: (installed: InstalledServerFacets) => Promise<void>;\n  canDispatch?: () => boolean;\n  telemetry?: ServerTelemetry;\n  onNotice: (message: string) => void;\n}\n\nexport interface PackageApiServer {\n  /** Dispatches an already-authenticated request without crossing a transport boundary. */\n  readonly request: (request: Request) => Promise<Response>;\n  close(): Promise<void>;\n}\n\nfunction describeError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction responseWithCompletion(response: Response, complete: () => void): Response {\n  if (response.body === null) {\n    complete();\n    return response;\n  }\n  const reader = response.body.getReader();\n  let completed = false;\n  const finish = (): void => {\n    if (completed) return;\n    completed = true;\n    complete();\n  };\n  const body = new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const result = await reader.read();\n        if (result.done) {\n          finish();\n          controller.close();\n        } else controller.enqueue(result.value);\n      } catch (error) {\n        finish();\n        controller.error(error);\n      }\n    },\n    async cancel(reason) {\n      finish();\n      await reader.cancel(reason);\n    },\n  });\n  return new Response(body, response);\n}\n\n/** Installs session facets and dispatches authenticated package API calls in-process. */\nexport async function serveSessionApis(options: PackageApiServerOptions): Promise<PackageApiServer> {\n  if (options.environment === undefined)\n    throw new Error('Session package API server requires an admitted environment.');\n  if (options.directEvents === undefined) throw new Error('Session package API server requires direct events.');\n  const facets = options.facets ?? [];\n  if (options.apis.length === 0 && facets.length === 0 && !options.prepareFacets) {\n    return {\n      request: async () => Response.json({ error: 'No package APIs are mounted.' }, { status: 404 }),\n      close: () => Promise.resolve(),\n    };\n  }\n\n  const owningSessionService = options.sessionService;\n  const communication = owningSessionService?.bindCommunication?.(options.sessionId);\n  const ownedReadExecutionState = owningSessionService?.readExecutionState?.bind(owningSessionService);\n  const ownedPrompt = owningSessionService?.prompt?.bind(owningSessionService);\n  const ownedAbort = owningSessionService?.abort?.bind(owningSessionService);\n  const ownedSteer = owningSessionService?.steer?.bind(owningSessionService);\n  const ownedRelease = owningSessionService?.release?.bind(owningSessionService);\n  const exposedSessionService: DoomHubSessionService | undefined =\n    owningSessionService === undefined\n      ? undefined\n      : {\n          create: (request) => owningSessionService.create(request),\n          close: (sessionId) => owningSessionService.close(sessionId),\n          isLive: (sessionId) => owningSessionService.isLive(sessionId),\n          ...(ownedReadExecutionState === undefined\n            ? {}\n            : {\n                readExecutionState: (sessionId: string) =>\n                  ownedReadExecutionState(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          // A session may drive only the children it started, never its parent or a sibling.\n          ...(ownedPrompt === undefined\n            ? {}\n            : {\n                prompt: (sessionId: string, text: string, promptOptions?: DoomHubSessionPromptOptions) =>\n                  ownedPrompt(sessionId, text, {\n                    ...(promptOptions?.signal === undefined ? {} : { signal: promptOptions.signal }),\n                    parentSessionId: options.sessionId,\n                  }),\n              }),\n          ...(ownedAbort === undefined\n            ? {}\n            : {\n                abort: (sessionId: string) => ownedAbort(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          ...(ownedSteer === undefined\n            ? {}\n            : {\n                steer: (sessionId: string, message: string) =>\n                  ownedSteer(sessionId, message, { parentSessionId: options.sessionId }),\n              }),\n          ...(ownedRelease === undefined\n            ? {}\n            : {\n                release: (sessionId: string) => ownedRelease(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          ...(owningSessionService.canCommunicate === undefined\n            ? {}\n            : {\n                canCommunicate: (sourceSessionId: string, targetSessionId: string) =>\n                  owningSessionService.canCommunicate?.(sourceSessionId, targetSessionId) === true,\n              }),\n        };\n  const context: DoomApiContext = {\n    scope: 'session',\n    sessionId: options.sessionId,\n    workspaceId: options.workspaceId,\n    workspaceRoot: options.workspaceRoot,\n    ...(options.sessionContext === undefined ? {} : { sessionContext: options.sessionContext }),\n    homeDirectory: options.homeDirectory,\n    cwd: options.cwd,\n    environment: options.environment,\n    directEvents: options.directEvents,\n    ...(options.computerUse === undefined ? {} : { computerUse: options.computerUse }),\n    ...(options.shareFile === undefined ? {} : { shareFile: options.shareFile }),\n    ...(options.mediaArbitration === undefined ? {} : { mediaArbitration: options.mediaArbitration }),\n    ...(options.executionBudget === undefined ? {} : { executionBudget: options.executionBudget }),\n    ...(options.peerAgents === undefined ? {} : { peerAgents: options.peerAgents }),\n    ...(options.requestApi === undefined ? {} : { requestApi: options.requestApi }),\n    ...(options.publishActivity === undefined ? {} : { publishActivity: options.publishActivity }),\n    ...(options.internalToken === undefined ? {} : { internalToken: options.internalToken }),\n    ...(options.hubToken === undefined ? {} : { hubToken: options.hubToken }),\n    ...(exposedSessionService === undefined ? {} : { sessionService: exposedSessionService }),\n    ...(communication === undefined ? {} : { sessionCommunication: communication }),\n    onNotice: options.onNotice,\n  };\n  const host = createDoomServerHost({\n    scope: 'session',\n    context,\n    mountChannel: options.mountChannel,\n    ...(options.pluginRegistry === undefined ? {} : { pluginRegistry: options.pluginRegistry }),\n  });\n  for (const api of options.apis) host.registerApi(api);\n  let installed: InstalledServerFacets;\n  try {\n    installed = await installServerFacets({ host, facets, onNotice: options.onNotice, prepare: options.prepareFacets });\n    try {\n      await options.activateFacets?.(installed);\n    } catch (error) {\n      await installed.dispose();\n      throw error;\n    }\n  } catch (error) {\n    communication?.close();\n    host.dispose();\n    throw error;\n  }\n  if (host.mounted().length === 0 && !options.prepareFacets) {\n    await installed.dispose();\n    communication?.close();\n    host.dispose();\n    return {\n      request: async () => Response.json({ error: 'No package APIs are mounted.' }, { status: 404 }),\n      close: () => Promise.resolve(),\n    };\n  }\n\n  const dispatch = async (request: Request): Promise<Response> => {\n    if (options.canDispatch?.() === false)\n      return Response.json({ error: 'Session selection is not ready.' }, { status: 503 });\n    const url = new URL(request.url);\n    if (!url.pathname.startsWith(`${DOOM_API_ROUTE_PREFIX}/`))\n      return Response.json({ error: 'Not found.' }, { status: 404 });\n    const rest = url.pathname.slice(DOOM_API_ROUTE_PREFIX.length + 1);\n    const slash = rest.indexOf('/');\n    const basePath = slash === -1 ? rest : rest.slice(0, slash);\n    const handler = host.handlerFor(basePath);\n    if (handler === undefined)\n      return Response.json({ error: `No API '${basePath}' in this session.` }, { status: 404 });\n    url.pathname = slash === -1 ? '/' : rest.slice(slash);\n    const startedAt = performance.now();\n    const parent = validatedTraceContext(request.headers.get('traceparent'));\n    let childContext: DoomTraceContext | undefined;\n    let response: Response;\n    try {\n      const invoke = async (context?: DoomTraceContext): Promise<Response> => {\n        if (options.canDispatch?.() === false || host.handlerFor(basePath) !== handler) {\n          return Response.json({ error: 'Session selection changed before dispatch.' }, { status: 503 });\n        }\n        childContext = context;\n        return handler.fetch(new Request(url, request));\n      };\n      response = options.telemetry\n        ? await options.telemetry.runInSpan(\n            'po_server.package_api.request',\n            { api: basePath, method: request.method },\n            invoke,\n            parent,\n          )\n        : await invoke();\n    } catch (error) {\n      options.onNotice(`package API '${basePath}' failed on ${url.pathname} (${describeError(error)})`);\n      response = Response.json({ error: `The '${basePath}' API failed.` }, { status: 500 });\n    }\n    return responseWithCompletion(response, () => {\n      if (!options.telemetry) return;\n      const durationMs = Math.round(performance.now() - startedAt);\n      // Keep this span only where it says something the request span cannot: a failing status,\n      // or a body that took real time to flush after the headers were sent.\n      if (response.status < 400 && durationMs < COMPLETION_SPAN_MIN_DURATION_MS) return;\n      observe(\n        options.telemetry.runInSpan(\n          'po_server.package_api.complete',\n          {\n            api: basePath,\n            method: request.method,\n            status_code: response.status,\n            duration_ms: durationMs,\n          },\n          async () => undefined,\n          childContext ?? parent,\n        ),\n        options.onNotice,\n      );\n    });\n  };\n  let closePromise: Promise<void> | undefined;\n\n  return {\n    request: dispatch,\n    close: () => {\n      closePromise ??= (async () => {\n        await installed.dispose();\n        communication?.close();\n        host.dispose();\n      })();\n      return closePromise;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"packageApiServer.mjs","names":[],"sources":["../src/server/packageApiServer.ts"],"sourcesContent":["import type { PoTraceContext } from '@agimon-ai/po-telemetry';\nimport type { Context } from '@deepseek-ai/cordis';\n\nimport type { PoDirectEventBus, PoHubSessionPromptOptions, PoHubSessionService } from '../exports/hubChannel';\nimport { PO_API_ROUTE_PREFIX, type PoApi, type PoApiContext } from '../exports/packageApi';\nimport type { PoPlatform } from '../exports/platform';\nimport type { PoPluginRegistry } from '../exports/pluginProtocol';\nimport {\n  createPoServerHost,\n  type CreatePoServerHostOptions,\n  type LoadedServerPackage,\n  type PoServerPlugin,\n  PoServerScope,\n} from '../exports/serverPlugin';\nimport { observe, type ServerTelemetry } from '../services/serverTelemetry';\nimport { prepareSessionEnvironment } from '../services/sessionFiles';\nimport { validatedTraceContext } from '../services/traceContext';\n\n/**\n * A body that keeps streaming well after its headers went out is worth its own span. A fast\n * one is not: the request span already carries the duration and outcome, so emitting a second\n * span per call made package API traffic 99.65% of all spans recorded in a two hour sample.\n */\nexport const COMPLETION_SPAN_MIN_DURATION_MS = 1000;\n\nexport interface PackageApiServerOptions {\n  sessionId: string;\n  workspaceId?: string;\n  workspaceRoot?: string;\n  sessionContext?: PoApiContext['sessionContext'];\n  homeDirectory?: string;\n  mountChannel?: CreatePoServerHostOptions['mountChannel'];\n  cwd: string;\n  /** Admitted environment for APIs serving this session. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n  /** Lifecycle-owned direct events shared with the hub. */\n  readonly directEvents: PoDirectEventBus;\n  readonly computerUse?: PoApiContext['computerUse'];\n  /** Bound to this session's id and cwd by the host. */\n  readonly shareFile?: PoApiContext['shareFile'];\n  readonly mediaArbitration?: PoApiContext['mediaArbitration'];\n  readonly executionBudget?: PoApiContext['executionBudget'];\n  readonly editPresence?: PoApiContext['editPresence'];\n  readonly peerAgents?: PoApiContext['peerAgents'];\n  readonly requestApi?: PoApiContext['requestApi'];\n  /** Publishes this session's activity line through the hub; bound to this session only. */\n  readonly publishActivity?: PoApiContext['publishActivity'];\n  internalToken?: string;\n  hubToken?: string;\n  /** Shared exact-scope dispatch table, so session packages can mount plugin methods. */\n  pluginRegistry?: PoPluginRegistry;\n  sessionService?: PoHubSessionService;\n  apis: readonly PoApi[];\n  /** Server packages to install; each registers its own APIs through the host. */\n  packages?: readonly (PoServerPlugin | LoadedServerPackage)[];\n  /** Publishes the session's own services into its scope root before any package installs. */\n  preparePackages?: (root: Context) => void | Promise<void>;\n  /** The hub's workspace or global scope; the session's own scope opens below it and closes with it. */\n  parentScope?: PoServerScope;\n  /** Host capabilities for the session scope root, injected by the composition root. */\n  platform: PoPlatform;\n  activatePackages?: (installedPackages: readonly string[]) => Promise<void>;\n  canDispatch?: () => boolean;\n  telemetry?: ServerTelemetry;\n  onNotice: (message: string) => void;\n}\n\nexport interface PackageApiServer {\n  /** Dispatches an already-authenticated request without crossing a transport boundary. */\n  readonly request: (request: Request) => Promise<Response>;\n  close(): Promise<void>;\n}\n\nfunction describeError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction responseWithCompletion(response: Response, complete: () => void): Response {\n  if (response.body === null) {\n    complete();\n    return response;\n  }\n  const reader = response.body.getReader();\n  let completed = false;\n  const finish = (): void => {\n    if (completed) return;\n    completed = true;\n    complete();\n  };\n  const body = new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const result = await reader.read();\n        if (result.done) {\n          finish();\n          controller.close();\n        } else controller.enqueue(result.value);\n      } catch (error) {\n        finish();\n        controller.error(error);\n      }\n    },\n    async cancel(reason) {\n      finish();\n      await reader.cancel(reason);\n    },\n  });\n  return new Response(body, response);\n}\n\n/** Installs session packages and dispatches authenticated package API calls in-process. */\nexport async function serveSessionApis(options: PackageApiServerOptions): Promise<PackageApiServer> {\n  if (options.environment === undefined)\n    throw new Error('Session package API server requires an admitted environment.');\n  if (options.directEvents === undefined) throw new Error('Session package API server requires direct events.');\n  options = { ...options, environment: await prepareSessionEnvironment(options) };\n  const packages = options.packages ?? [];\n  // Without a level above it, a session that mounts nothing has nothing to route.\n  const routesNothing = (): boolean => !options.preparePackages && options.parentScope === undefined;\n  if (options.apis.length === 0 && packages.length === 0 && routesNothing()) {\n    return {\n      request: async () => Response.json({ error: 'No package APIs are mounted.' }, { status: 404 }),\n      close: () => Promise.resolve(),\n    };\n  }\n\n  const owningSessionService = options.sessionService;\n  const communication = owningSessionService?.bindCommunication?.(options.sessionId);\n  const ownedReadExecutionState = owningSessionService?.readExecutionState?.bind(owningSessionService);\n  const ownedPrompt = owningSessionService?.prompt?.bind(owningSessionService);\n  const ownedAbort = owningSessionService?.abort?.bind(owningSessionService);\n  const ownedSteer = owningSessionService?.steer?.bind(owningSessionService);\n  const ownedRelease = owningSessionService?.release?.bind(owningSessionService);\n  const exposedSessionService: PoHubSessionService | undefined =\n    owningSessionService === undefined\n      ? undefined\n      : {\n          create: (request) => owningSessionService.create(request),\n          close: (sessionId) => owningSessionService.close(sessionId),\n          isLive: (sessionId) => owningSessionService.isLive(sessionId),\n          ...(ownedReadExecutionState === undefined\n            ? {}\n            : {\n                readExecutionState: (sessionId: string) =>\n                  ownedReadExecutionState(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          // A session may drive only the children it started, never its parent or a sibling.\n          ...(ownedPrompt === undefined\n            ? {}\n            : {\n                prompt: (sessionId: string, text: string, promptOptions?: PoHubSessionPromptOptions) =>\n                  ownedPrompt(sessionId, text, {\n                    ...(promptOptions?.signal === undefined ? {} : { signal: promptOptions.signal }),\n                    parentSessionId: options.sessionId,\n                  }),\n              }),\n          ...(ownedAbort === undefined\n            ? {}\n            : {\n                abort: (sessionId: string) => ownedAbort(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          ...(ownedSteer === undefined\n            ? {}\n            : {\n                steer: (sessionId: string, message: string) =>\n                  ownedSteer(sessionId, message, { parentSessionId: options.sessionId }),\n              }),\n          ...(ownedRelease === undefined\n            ? {}\n            : {\n                release: (sessionId: string) => ownedRelease(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          ...(owningSessionService.canCommunicate === undefined\n            ? {}\n            : {\n                canCommunicate: (sourceSessionId: string, targetSessionId: string) =>\n                  owningSessionService.canCommunicate?.(sourceSessionId, targetSessionId) === true,\n              }),\n        };\n  const context: PoApiContext = {\n    scope: 'session',\n    sessionId: options.sessionId,\n    workspaceId: options.workspaceId,\n    workspaceRoot: options.workspaceRoot,\n    ...(options.sessionContext === undefined ? {} : { sessionContext: options.sessionContext }),\n    homeDirectory: options.homeDirectory ?? options.platform.homeDirectory,\n    sessionStorage: options.platform.sessions,\n    cwd: options.cwd,\n    environment: options.environment,\n    directEvents: options.directEvents,\n    ...(options.computerUse === undefined ? {} : { computerUse: options.computerUse }),\n    ...(options.shareFile === undefined ? {} : { shareFile: options.shareFile }),\n    ...(options.mediaArbitration === undefined ? {} : { mediaArbitration: options.mediaArbitration }),\n    ...(options.executionBudget === undefined ? {} : { executionBudget: options.executionBudget }),\n    ...(options.editPresence === undefined ? {} : { editPresence: options.editPresence }),\n    ...(options.peerAgents === undefined ? {} : { peerAgents: options.peerAgents }),\n    ...(options.requestApi === undefined ? {} : { requestApi: options.requestApi }),\n    ...(options.publishActivity === undefined ? {} : { publishActivity: options.publishActivity }),\n    ...(options.internalToken === undefined ? {} : { internalToken: options.internalToken }),\n    ...(options.hubToken === undefined ? {} : { hubToken: options.hubToken }),\n    ...(exposedSessionService === undefined ? {} : { sessionService: exposedSessionService }),\n    ...(communication === undefined ? {} : { sessionCommunication: communication }),\n    onNotice: options.onNotice,\n  };\n  const host = createPoServerHost({\n    scope: 'session',\n    context,\n    mountChannel: options.mountChannel,\n    ...(options.pluginRegistry === undefined ? {} : { pluginRegistry: options.pluginRegistry }),\n  });\n  let scope: PoServerScope | undefined;\n  try {\n    for (const api of options.apis) host.registerApi(api);\n    // The session's own level of the server IoC tree; it closes with the hub level it opens below.\n    scope = await PoServerScope.open('session', options.parentScope);\n    await scope.serve({ host, platform: options.platform });\n    await options.preparePackages?.(scope.root);\n    const installed = await scope.install(packages, {\n      onNotice: options.onNotice,\n      onPackageSettled: (report) => {\n        if (!options.telemetry) return;\n        observe(\n          options.telemetry.recordEvent('po_server.package_install', {\n            'package.name': report.packageName,\n            'package.outcome': report.outcome,\n            duration_ms: report.durationMs,\n            scope: 'session',\n          }),\n          options.onNotice,\n        );\n      },\n    });\n    await options.activatePackages?.(installed);\n  } catch (error) {\n    await scope?.dispose();\n    communication?.close();\n    host.dispose();\n    throw error;\n  }\n  if (host.mounted().length === 0 && routesNothing()) {\n    await scope.dispose();\n    communication?.close();\n    host.dispose();\n    return {\n      request: async () => Response.json({ error: 'No package APIs are mounted.' }, { status: 404 }),\n      close: () => Promise.resolve(),\n    };\n  }\n  const sessionScope = scope;\n\n  const dispatch = async (request: Request): Promise<Response> => {\n    if (options.canDispatch?.() === false)\n      return Response.json({ error: 'Session selection is not ready.' }, { status: 503 });\n    const url = new URL(request.url);\n    if (!url.pathname.startsWith(`${PO_API_ROUTE_PREFIX}/`))\n      return Response.json({ error: 'Not found.' }, { status: 404 });\n    const rest = url.pathname.slice(PO_API_ROUTE_PREFIX.length + 1);\n    const slash = rest.indexOf('/');\n    const basePath = slash === -1 ? rest : rest.slice(0, slash);\n    // The session's own API, else the nearest level above it that serves one.\n    const handler = sessionScope.apiHandler(basePath);\n    if (handler === undefined)\n      return Response.json({ error: `No API '${basePath}' in this session.` }, { status: 404 });\n    url.pathname = slash === -1 ? '/' : rest.slice(slash);\n    const startedAt = performance.now();\n    const parent = validatedTraceContext(request.headers.get('traceparent'));\n    let childContext: PoTraceContext | undefined;\n    let response: Response;\n    try {\n      const invoke = async (context?: PoTraceContext): Promise<Response> => {\n        if (options.canDispatch?.() === false || sessionScope.apiHandler(basePath) !== handler) {\n          return Response.json({ error: 'Session selection changed before dispatch.' }, { status: 503 });\n        }\n        childContext = context;\n        return handler.fetch(new Request(url, request));\n      };\n      response = options.telemetry\n        ? await options.telemetry.runInSpan(\n            'po_server.package_api.request',\n            { api: basePath, method: request.method },\n            invoke,\n            parent,\n          )\n        : await invoke();\n    } catch (error) {\n      if (request.signal.aborted) return new Response(null, { status: 499 });\n      options.onNotice(`package API '${basePath}' failed on ${url.pathname} (${describeError(error)})`);\n      response = Response.json({ error: `The '${basePath}' API failed.` }, { status: 500 });\n    }\n    return responseWithCompletion(response, () => {\n      if (!options.telemetry) return;\n      const durationMs = Math.round(performance.now() - startedAt);\n      // Keep this span only where it says something the request span cannot: a failing status,\n      // or a body that took real time to flush after the headers were sent.\n      if (response.status < 400 && durationMs < COMPLETION_SPAN_MIN_DURATION_MS) return;\n      observe(\n        options.telemetry.runInSpan(\n          'po_server.package_api.complete',\n          {\n            api: basePath,\n            method: request.method,\n            status_code: response.status,\n            duration_ms: durationMs,\n          },\n          async () => undefined,\n          childContext ?? parent,\n        ),\n        options.onNotice,\n      );\n    });\n  };\n  let closePromise: Promise<void> | undefined;\n\n  return {\n    request: dispatch,\n    close: () => {\n      closePromise ??= (async () => {\n        await scope.dispose();\n        communication?.close();\n        host.dispose();\n      })();\n      return closePromise;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/piSettings.cjs

@@ -1,21 +1,42 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_runtimePiSettings = require("./runtimePiSettings.cjs");
-exports.AMBIENT_EXTENSION_FILTER = require_runtimePiSettings.AMBIENT_EXTENSION_FILTER;
-exports.DISABLED_PI_BUILTINS = require_runtimePiSettings.DISABLED_PI_BUILTINS;
-exports.DOOM_EXTENSION = require_runtimePiSettings.DOOM_EXTENSION;
-exports.PO_DISPATCHER_MARKER = require_runtimePiSettings.PO_DISPATCHER_MARKER;
-exports.PO_HOME_ENV = require_runtimePiSettings.PO_HOME_ENV;
-exports.hasRepositoryDoomDirectory = require_runtimePiSettings.hasRepositoryDoomDirectory;
-exports.isPoDispatcherPackage = require_runtimePiSettings.isPoDispatcherPackage;
-exports.mergePiSettings = require_runtimePiSettings.mergePiSettings;
-exports.modelConfigDirectory = require_runtimePiSettings.modelConfigDirectory;
-exports.modelSettingsDirectory = require_runtimePiSettings.modelSettingsDirectory;
-exports.piAgentDirectory = require_runtimePiSettings.piAgentDirectory;
-exports.piSettingsPath = require_runtimePiSettings.piSettingsPath;
-exports.piThemeDirectory = require_runtimePiSettings.piThemeDirectory;
-exports.poHomeDirectory = require_runtimePiSettings.poHomeDirectory;
-exports.poRuntimeDirectory = require_runtimePiSettings.poRuntimeDirectory;
-exports.readPiSettings = require_runtimePiSettings.readPiSettings;
-exports.removePoPiSettings = require_runtimePiSettings.removePoPiSettings;
-exports.serializePiSettings = require_runtimePiSettings.serializePiSettings;
-exports.writePiSettings = require_runtimePiSettings.writePiSettings;
+const require_core = require("./src/services/piSettings/core.cjs");
+const require_sync = require("./src/services/piSettings/sync.cjs");
+require("./runtimePiSettings.cjs");
+exports.AGENT_DIRECTORY = require_core.AGENT_DIRECTORY;
+exports.AMBIENT_EXTENSION_FILTER = require_core.AMBIENT_EXTENSION_FILTER;
+exports.AUTH_FILE = require_core.AUTH_FILE;
+exports.DISABLED_PI_BUILTINS = require_core.DISABLED_PI_BUILTINS;
+exports.MODELS_FILE = require_core.MODELS_FILE;
+exports.PI_HOME_DIRECTORY = require_core.PI_HOME_DIRECTORY;
+exports.PO_DISPATCHER_MARKER = require_core.PO_DISPATCHER_MARKER;
+exports.PO_EXTENSION = require_core.PO_EXTENSION;
+exports.PO_HOME_DIRECTORY = require_core.PO_HOME_DIRECTORY;
+exports.PO_HOME_ENV = require_core.PO_HOME_ENV;
+exports.PO_THEME_FILE = require_core.PO_THEME_FILE;
+exports.hasRepositoryPoDirectory = require_sync.hasRepositoryPoDirectory;
+exports.hasRepositoryPoDirectoryAsync = require_core.hasRepositoryPoDirectoryAsync;
+exports.isPoDispatcherManifest = require_core.isPoDispatcherManifest;
+exports.isPoDispatcherPackage = require_sync.isPoDispatcherPackage;
+exports.isPoDispatcherPackageAsync = require_core.isPoDispatcherPackageAsync;
+exports.isPoHomeMarker = require_core.isPoHomeMarker;
+exports.mergePiSettings = require_core.mergePiSettings;
+exports.modelConfigDirectory = require_sync.modelConfigDirectory;
+exports.modelConfigDirectoryAsync = require_core.modelConfigDirectoryAsync;
+exports.modelSettingsDirectory = require_sync.modelSettingsDirectory;
+exports.modelSettingsDirectoryAsync = require_core.modelSettingsDirectoryAsync;
+exports.normalizePiSettings = require_core.normalizePiSettings;
+exports.piAgentDirectory = require_core.piAgentDirectory;
+exports.piSettingsPath = require_core.piSettingsPath;
+exports.piThemeDirectory = require_core.piThemeDirectory;
+exports.poDispatcherPath = require_core.poDispatcherPath;
+exports.poHomeDirectory = require_core.poHomeDirectory;
+exports.poRuntimeDirectory = require_core.poRuntimeDirectory;
+exports.poThemePath = require_core.poThemePath;
+exports.prunePoPiSettings = require_core.prunePoPiSettings;
+exports.readPiSettings = require_sync.readPiSettings;
+exports.readPiSettingsAsync = require_core.readPiSettingsAsync;
+exports.removePoPiSettings = require_sync.removePoPiSettings;
+exports.removePoPiSettingsAsync = require_core.removePoPiSettingsAsync;
+exports.serializePiSettings = require_core.serializePiSettings;
+exports.writePiSettings = require_sync.writePiSettings;
+exports.writePiSettingsAsync = require_core.writePiSettingsAsync;

package/dist/piSettings.d.mts

@@ -1,2 +1,4 @@
-import { AMBIENT_EXTENSION_FILTER, DISABLED_PI_BUILTINS, DOOM_EXTENSION, PO_DISPATCHER_MARKER, PO_HOME_ENV, PiSettingsUpdate, hasRepositoryDoomDirectory, isPoDispatcherPackage, mergePiSettings, modelConfigDirectory, modelSettingsDirectory, piAgentDirectory, piSettingsPath, piThemeDirectory, poHomeDirectory, poRuntimeDirectory, readPiSettings, removePoPiSettings, serializePiSettings, writePiSettings } from "./runtimePiSettings.mjs";
-export { AMBIENT_EXTENSION_FILTER, DISABLED_PI_BUILTINS, DOOM_EXTENSION, PO_DISPATCHER_MARKER, PO_HOME_ENV, PiSettingsUpdate, hasRepositoryDoomDirectory, isPoDispatcherPackage, mergePiSettings, modelConfigDirectory, modelSettingsDirectory, piAgentDirectory, piSettingsPath, piThemeDirectory, poHomeDirectory, poRuntimeDirectory, readPiSettings, removePoPiSettings, serializePiSettings, writePiSettings };
+import { AGENT_DIRECTORY, AMBIENT_EXTENSION_FILTER, AUTH_FILE, DISABLED_PI_BUILTINS, MODELS_FILE, PI_HOME_DIRECTORY, PO_DISPATCHER_MARKER, PO_EXTENSION, PO_HOME_DIRECTORY, PO_HOME_ENV, PO_THEME_FILE, PiSettingsUpdate, hasRepositoryPoDirectoryAsync, isPoDispatcherManifest, isPoDispatcherPackageAsync, isPoHomeMarker, mergePiSettings, modelConfigDirectoryAsync, modelSettingsDirectoryAsync, normalizePiSettings, piAgentDirectory, piSettingsPath, piThemeDirectory, poDispatcherPath, poHomeDirectory, poRuntimeDirectory, poThemePath, prunePoPiSettings, readPiSettingsAsync, removePoPiSettingsAsync, serializePiSettings, writePiSettingsAsync } from "./src/services/piSettings/core.mjs";
+import { hasRepositoryPoDirectory, isPoDispatcherPackage, modelConfigDirectory, modelSettingsDirectory, readPiSettings, removePoPiSettings, writePiSettings } from "./src/services/piSettings/sync.mjs";
+import "./runtimePiSettings.mjs";
+export { AGENT_DIRECTORY, AMBIENT_EXTENSION_FILTER, AUTH_FILE, DISABLED_PI_BUILTINS, MODELS_FILE, PI_HOME_DIRECTORY, PO_DISPATCHER_MARKER, PO_EXTENSION, PO_HOME_DIRECTORY, PO_HOME_ENV, PO_THEME_FILE, PiSettingsUpdate, hasRepositoryPoDirectory, hasRepositoryPoDirectoryAsync, isPoDispatcherManifest, isPoDispatcherPackage, isPoDispatcherPackageAsync, isPoHomeMarker, mergePiSettings, modelConfigDirectory, modelConfigDirectoryAsync, modelSettingsDirectory, modelSettingsDirectoryAsync, normalizePiSettings, piAgentDirectory, piSettingsPath, piThemeDirectory, poDispatcherPath, poHomeDirectory, poRuntimeDirectory, poThemePath, prunePoPiSettings, readPiSettings, readPiSettingsAsync, removePoPiSettings, removePoPiSettingsAsync, serializePiSettings, writePiSettings, writePiSettingsAsync };

package/dist/piSettings.mjs

@@ -1,2 +1,4 @@
-import { AMBIENT_EXTENSION_FILTER, DISABLED_PI_BUILTINS, DOOM_EXTENSION, PO_DISPATCHER_MARKER, PO_HOME_ENV, hasRepositoryDoomDirectory, isPoDispatcherPackage, mergePiSettings, modelConfigDirectory, modelSettingsDirectory, piAgentDirectory, piSettingsPath, piThemeDirectory, poHomeDirectory, poRuntimeDirectory, readPiSettings, removePoPiSettings, serializePiSettings, writePiSettings } from "./runtimePiSettings.mjs";
-export { AMBIENT_EXTENSION_FILTER, DISABLED_PI_BUILTINS, DOOM_EXTENSION, PO_DISPATCHER_MARKER, PO_HOME_ENV, hasRepositoryDoomDirectory, isPoDispatcherPackage, mergePiSettings, modelConfigDirectory, modelSettingsDirectory, piAgentDirectory, piSettingsPath, piThemeDirectory, poHomeDirectory, poRuntimeDirectory, readPiSettings, removePoPiSettings, serializePiSettings, writePiSettings };
+import { AGENT_DIRECTORY, AMBIENT_EXTENSION_FILTER, AUTH_FILE, DISABLED_PI_BUILTINS, MODELS_FILE, PI_HOME_DIRECTORY, PO_DISPATCHER_MARKER, PO_EXTENSION, PO_HOME_DIRECTORY, PO_HOME_ENV, PO_THEME_FILE, hasRepositoryPoDirectoryAsync, isPoDispatcherManifest, isPoDispatcherPackageAsync, isPoHomeMarker, mergePiSettings, modelConfigDirectoryAsync, modelSettingsDirectoryAsync, normalizePiSettings, piAgentDirectory, piSettingsPath, piThemeDirectory, poDispatcherPath, poHomeDirectory, poRuntimeDirectory, poThemePath, prunePoPiSettings, readPiSettingsAsync, removePoPiSettingsAsync, serializePiSettings, writePiSettingsAsync } from "./src/services/piSettings/core.mjs";
+import { hasRepositoryPoDirectory, isPoDispatcherPackage, modelConfigDirectory, modelSettingsDirectory, readPiSettings, removePoPiSettings, writePiSettings } from "./src/services/piSettings/sync.mjs";
+import "./runtimePiSettings.mjs";
+export { AGENT_DIRECTORY, AMBIENT_EXTENSION_FILTER, AUTH_FILE, DISABLED_PI_BUILTINS, MODELS_FILE, PI_HOME_DIRECTORY, PO_DISPATCHER_MARKER, PO_EXTENSION, PO_HOME_DIRECTORY, PO_HOME_ENV, PO_THEME_FILE, hasRepositoryPoDirectory, hasRepositoryPoDirectoryAsync, isPoDispatcherManifest, isPoDispatcherPackage, isPoDispatcherPackageAsync, isPoHomeMarker, mergePiSettings, modelConfigDirectory, modelConfigDirectoryAsync, modelSettingsDirectory, modelSettingsDirectoryAsync, normalizePiSettings, piAgentDirectory, piSettingsPath, piThemeDirectory, poDispatcherPath, poHomeDirectory, poRuntimeDirectory, poThemePath, prunePoPiSettings, readPiSettings, readPiSettingsAsync, removePoPiSettings, removePoPiSettingsAsync, serializePiSettings, writePiSettings, writePiSettingsAsync };

package/dist/platform.cjs

@@ -0,0 +1,62 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_index = require("./src/services/platformFiles/index.cjs");
+const require_index$1 = require("./src/services/nodeHost/index.cjs");
+const require_index$2 = require("./src/services/serialRunner/index.cjs");
+const require_docs = require("./src/services/durableSession/docs.cjs");
+const require_index$3 = require("./src/services/durableSession/index.cjs");
+const require_index$4 = require("./src/services/sessionFiles/index.cjs");
+const require_platform = require("./src/schemas/platform.cjs");
+let _earendil_works_pi_durable_env = require("@earendil-works/pi-durable/env");
+let dist_interop_chordContext_mjs = require("../dist/interop/chordContext.mjs");
+Object.defineProperty(exports, "BACKGROUND_CONTEXT", {
+	enumerable: true,
+	get: function() {
+		return dist_interop_chordContext_mjs.BACKGROUND_CONTEXT;
+	}
+});
+Object.defineProperty(exports, "ExecutionError", {
+	enumerable: true,
+	get: function() {
+		return _earendil_works_pi_durable_env.ExecutionError;
+	}
+});
+Object.defineProperty(exports, "FileError", {
+	enumerable: true,
+	get: function() {
+		return _earendil_works_pi_durable_env.FileError;
+	}
+});
+exports.PO_FS_SERVICE = require_platform.PO_FS_SERVICE;
+exports.PO_SESSION_FILES_SERVICE = require_index$4.PO_SESSION_FILES_SERVICE;
+exports.PO_SESSION_STORAGE_SERVICE = require_platform.PO_SESSION_STORAGE_SERVICE;
+exports.PO_SESSION_TEMP_DIR = require_index$4.PO_SESSION_TEMP_DIR;
+exports.PO_SHELL_SERVICE = require_platform.PO_SHELL_SERVICE;
+exports.PO_SQLITE_SERVICE = require_platform.PO_SQLITE_SERVICE;
+exports.SessionIdentityDoc = require_docs.SessionIdentityDoc;
+exports.SessionMetadataDoc = require_docs.SessionMetadataDoc;
+exports.createSerialRunner = require_index$2.createSerialRunner;
+Object.defineProperty(exports, "getOrThrow", {
+	enumerable: true,
+	get: function() {
+		return _earendil_works_pi_durable_env.getOrThrow;
+	}
+});
+exports.initializeSessionIdentity = require_index$3.initializeSessionIdentity;
+exports.nodeHost = require_index$1.nodeHost;
+exports.pathExists = require_index.pathExists;
+exports.readPoFs = require_platform.readPoFs;
+exports.readSessionFileDirectories = require_index$4.readSessionFileDirectories;
+exports.readTextIfExists = require_index.readTextIfExists;
+exports.removePath = require_index.removePath;
+exports.removeSessionFiles = require_index$4.removeSessionFiles;
+exports.requirePoFs = require_platform.requirePoFs;
+exports.requirePoShell = require_platform.requirePoShell;
+exports.requirePoSqlite = require_platform.requirePoSqlite;
+exports.sessionTempDirectory = require_index$4.sessionTempDirectory;
+Object.defineProperty(exports, "withAbortSignal", {
+	enumerable: true,
+	get: function() {
+		return dist_interop_chordContext_mjs.withAbortSignal;
+	}
+});
+exports.writeFileAtomic = require_index.writeFileAtomic;

package/dist/platform.d.mts

@@ -0,0 +1,10 @@
+import { PO_FS_SERVICE, PO_SESSION_STORAGE_SERVICE, PO_SHELL_SERVICE, PO_SQLITE_SERVICE, PoPlatform, PoSessionStorage, PoSessionStorageRequest, PoSessionStorageService, PoSqliteService, PoStoredSession, readPoFs, requirePoFs, requirePoShell, requirePoSqlite } from "./src/schemas/platform.mjs";
+import { PO_SESSION_FILES_SERVICE, PO_SESSION_TEMP_DIR, PoSessionFileDirectories, PoSessionFiles, SessionTempDirectoryOptions, readSessionFileDirectories, removeSessionFiles, sessionTempDirectory } from "./src/services/sessionFiles/index.mjs";
+import { SerialRunner, SerialTask, createSerialRunner } from "./src/services/serialRunner/index.mjs";
+import { initializeSessionIdentity } from "./src/services/durableSession/index.mjs";
+import { SessionIdentityDoc, SessionMetadataDoc } from "./src/services/durableSession/docs.mjs";
+import { nodeHost } from "./src/services/nodeHost/index.mjs";
+import { pathExists, readTextIfExists, removePath, writeFileAtomic } from "./src/services/platformFiles/index.mjs";
+import { ExecutionEnv, ExecutionError, FileError, FileSystem, Result, Shell, getOrThrow } from "@earendil-works/pi-durable/env";
+import { BACKGROUND_CONTEXT, withAbortSignal } from "@earendil-works/chord/context";
+export { BACKGROUND_CONTEXT, type ExecutionEnv, ExecutionError, FileError, type FileSystem, PO_FS_SERVICE, PO_SESSION_FILES_SERVICE, PO_SESSION_STORAGE_SERVICE, PO_SESSION_TEMP_DIR, PO_SHELL_SERVICE, PO_SQLITE_SERVICE, type PoPlatform, type PoSessionFileDirectories, type PoSessionFiles, type PoSessionStorage, type PoSessionStorageRequest, type PoSessionStorageService, type PoSqliteService, type PoStoredSession, type Result, type SerialRunner, type SerialTask, SessionIdentityDoc, SessionMetadataDoc, type SessionTempDirectoryOptions, type Shell, createSerialRunner, getOrThrow, initializeSessionIdentity, nodeHost, pathExists, readPoFs, readSessionFileDirectories, readTextIfExists, removePath, removeSessionFiles, requirePoFs, requirePoShell, requirePoSqlite, sessionTempDirectory, withAbortSignal, writeFileAtomic };

package/dist/platform.mjs

@@ -0,0 +1,10 @@
+import { pathExists, readTextIfExists, removePath, writeFileAtomic } from "./src/services/platformFiles/index.mjs";
+import { nodeHost } from "./src/services/nodeHost/index.mjs";
+import { createSerialRunner } from "./src/services/serialRunner/index.mjs";
+import { SessionIdentityDoc, SessionMetadataDoc } from "./src/services/durableSession/docs.mjs";
+import { initializeSessionIdentity } from "./src/services/durableSession/index.mjs";
+import { PO_SESSION_FILES_SERVICE, PO_SESSION_TEMP_DIR, readSessionFileDirectories, removeSessionFiles, sessionTempDirectory } from "./src/services/sessionFiles/index.mjs";
+import { PO_FS_SERVICE, PO_SESSION_STORAGE_SERVICE, PO_SHELL_SERVICE, PO_SQLITE_SERVICE, readPoFs, requirePoFs, requirePoShell, requirePoSqlite } from "./src/schemas/platform.mjs";
+import { ExecutionError, FileError, getOrThrow } from "@earendil-works/pi-durable/env";
+import { BACKGROUND_CONTEXT, withAbortSignal } from "@earendil-works/chord/context";
+export { BACKGROUND_CONTEXT, ExecutionError, FileError, PO_FS_SERVICE, PO_SESSION_FILES_SERVICE, PO_SESSION_STORAGE_SERVICE, PO_SESSION_TEMP_DIR, PO_SHELL_SERVICE, PO_SQLITE_SERVICE, SessionIdentityDoc, SessionMetadataDoc, createSerialRunner, getOrThrow, initializeSessionIdentity, nodeHost, pathExists, readPoFs, readSessionFileDirectories, readTextIfExists, removePath, removeSessionFiles, requirePoFs, requirePoShell, requirePoSqlite, sessionTempDirectory, withAbortSignal, writeFileAtomic };

package/dist/pluginProtocol.cjs

@@ -1,10 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_pluginProtocol = require("./src/schemas/pluginProtocol.cjs");
-exports.DoomPluginCallError = require_pluginProtocol.DoomPluginCallError;
-exports.DoomPluginCallSchema = require_pluginProtocol.DoomPluginCallSchema;
-exports.DoomPluginMountSchema = require_pluginProtocol.DoomPluginMountSchema;
-exports.DoomPluginService = require_pluginProtocol.DoomPluginService;
-exports.createDoomPluginRegistry = require_pluginProtocol.createDoomPluginRegistry;
-exports.defineDoomPluginMethod = require_pluginProtocol.defineDoomPluginMethod;
-exports.doomPluginMountKey = require_pluginProtocol.doomPluginMountKey;
-exports.invokeDoomPluginMethod = require_pluginProtocol.invokeDoomPluginMethod;
+exports.PoPluginCallError = require_pluginProtocol.PoPluginCallError;
+exports.PoPluginCallSchema = require_pluginProtocol.PoPluginCallSchema;
+exports.PoPluginMountSchema = require_pluginProtocol.PoPluginMountSchema;
+exports.createPoPluginRegistry = require_pluginProtocol.createPoPluginRegistry;
+exports.definePoPluginMethod = require_pluginProtocol.definePoPluginMethod;
+exports.invokePoPluginMethod = require_pluginProtocol.invokePoPluginMethod;
+exports.poPluginMountKey = require_pluginProtocol.poPluginMountKey;

package/dist/pluginProtocol.d.mts

@@ -1,2 +1,2 @@
-import { DoomPluginCall, DoomPluginCallError, DoomPluginCallSchema, DoomPluginCaller, DoomPluginDirection, DoomPluginMethod, DoomPluginMountSchema, DoomPluginRegistry, DoomPluginService, createDoomPluginRegistry, defineDoomPluginMethod, doomPluginMountKey, invokeDoomPluginMethod } from "./src/schemas/pluginProtocol.mjs";
-export { DoomPluginCall, DoomPluginCallError, DoomPluginCallSchema, DoomPluginCaller, DoomPluginDirection, DoomPluginMethod, DoomPluginMountSchema, DoomPluginRegistry, DoomPluginService, createDoomPluginRegistry, defineDoomPluginMethod, doomPluginMountKey, invokeDoomPluginMethod };
+import { PoPluginCall, PoPluginCallError, PoPluginCallSchema, PoPluginCaller, PoPluginDirection, PoPluginMethod, PoPluginMountSchema, PoPluginRegistry, PoPluginService, createPoPluginRegistry, definePoPluginMethod, invokePoPluginMethod, poPluginMountKey } from "./src/schemas/pluginProtocol.mjs";
+export { PoPluginCall, PoPluginCallError, PoPluginCallSchema, PoPluginCaller, PoPluginDirection, PoPluginMethod, PoPluginMountSchema, PoPluginRegistry, PoPluginService, createPoPluginRegistry, definePoPluginMethod, invokePoPluginMethod, poPluginMountKey };

package/dist/pluginProtocol.mjs

@@ -1,2 +1 @@
-import { DoomPluginCallError, DoomPluginCallSchema, DoomPluginMountSchema, DoomPluginService, createDoomPluginRegistry, defineDoomPluginMethod, doomPluginMountKey, invokeDoomPluginMethod } from "./src/schemas/pluginProtocol.mjs";
-export { DoomPluginCallError, DoomPluginCallSchema, DoomPluginMountSchema, DoomPluginService, createDoomPluginRegistry, defineDoomPluginMethod, doomPluginMountKey, invokeDoomPluginMethod };
+export { PoPluginCallError, PoPluginCallSchema, PoPluginMountSchema, createPoPluginRegistry, definePoPluginMethod, invokePoPluginMethod, poPluginMountKey } from "./src/schemas/pluginProtocol.mjs";

package/dist/poPackage.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_core = require("./src/services/poPackage/core.cjs");
+const require_sync = require("./src/services/poPackage/sync.cjs");
+exports.PACKAGE_MANIFEST = require_core.PACKAGE_MANIFEST;
+exports.PO_PACKAGE_NAME = require_core.PO_PACKAGE_NAME;
+exports.enclosingPackageName = require_sync.enclosingPackageName;
+exports.enclosingPackageNameAsync = require_core.enclosingPackageNameAsync;
+exports.isPoPackagePath = require_sync.isPoPackagePath;
+exports.isPoPackagePathAsync = require_core.isPoPackagePathAsync;
+exports.manifestName = require_sync.manifestName;
+exports.manifestNameAsync = require_core.manifestNameAsync;
+exports.parseManifestName = require_core.parseManifestName;

package/dist/poPackage.d.mts

@@ -0,0 +1,3 @@
+import { PACKAGE_MANIFEST, PO_PACKAGE_NAME, enclosingPackageNameAsync, isPoPackagePathAsync, manifestNameAsync, parseManifestName } from "./src/services/poPackage/core.mjs";
+import { enclosingPackageName, isPoPackagePath, manifestName } from "./src/services/poPackage/sync.mjs";
+export { PACKAGE_MANIFEST, PO_PACKAGE_NAME, enclosingPackageName, enclosingPackageNameAsync, isPoPackagePath, isPoPackagePathAsync, manifestName, manifestNameAsync, parseManifestName };

package/dist/poPackage.mjs

@@ -0,0 +1,3 @@
+import { PACKAGE_MANIFEST, PO_PACKAGE_NAME, enclosingPackageNameAsync, isPoPackagePathAsync, manifestNameAsync, parseManifestName } from "./src/services/poPackage/core.mjs";
+import { enclosingPackageName, isPoPackagePath, manifestName } from "./src/services/poPackage/sync.mjs";
+export { PACKAGE_MANIFEST, PO_PACKAGE_NAME, enclosingPackageName, enclosingPackageNameAsync, isPoPackagePath, isPoPackagePathAsync, manifestName, manifestNameAsync, parseManifestName };

package/dist/profileIdentity.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_profileIdentity = require("./src/schemas/profileIdentity.cjs");
-exports.DOOM_PROFILE_IDENTITY_ENTRY_TYPE = require_profileIdentity.DOOM_PROFILE_IDENTITY_ENTRY_TYPE;
+exports.PO_PROFILE_IDENTITY_ENTRY_TYPE = require_profileIdentity.PO_PROFILE_IDENTITY_ENTRY_TYPE;
 exports.PROFILE_ICON_MAX_DATA_URL_LENGTH = require_profileIdentity.PROFILE_ICON_MAX_DATA_URL_LENGTH;
 exports.PROFILE_ICON_MIME_TYPES = require_profileIdentity.PROFILE_ICON_MIME_TYPES;
 exports.ProfileIdentityProjectionSchema = require_profileIdentity.ProfileIdentityProjectionSchema;

package/dist/profileIdentity.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_PROFILE_IDENTITY_ENTRY_TYPE, PROFILE_ICON_MAX_DATA_URL_LENGTH, PROFILE_ICON_MIME_TYPES, ProfileIconMimeType, ProfileIdentityProjection, ProfileIdentityProjectionSchema } from "./src/schemas/profileIdentity.mjs";
-export { DOOM_PROFILE_IDENTITY_ENTRY_TYPE, PROFILE_ICON_MAX_DATA_URL_LENGTH, PROFILE_ICON_MIME_TYPES, type ProfileIconMimeType, type ProfileIdentityProjection, ProfileIdentityProjectionSchema };
+import { PO_PROFILE_IDENTITY_ENTRY_TYPE, PROFILE_ICON_MAX_DATA_URL_LENGTH, PROFILE_ICON_MIME_TYPES, ProfileIconMimeType, ProfileIdentityProjection, ProfileIdentityProjectionSchema } from "./src/schemas/profileIdentity.mjs";
+export { PO_PROFILE_IDENTITY_ENTRY_TYPE, PROFILE_ICON_MAX_DATA_URL_LENGTH, PROFILE_ICON_MIME_TYPES, type ProfileIconMimeType, type ProfileIdentityProjection, ProfileIdentityProjectionSchema };

package/dist/profileIdentity.mjs

@@ -1,2 +1 @@
-import { DOOM_PROFILE_IDENTITY_ENTRY_TYPE, PROFILE_ICON_MAX_DATA_URL_LENGTH, PROFILE_ICON_MIME_TYPES, ProfileIdentityProjectionSchema } from "./src/schemas/profileIdentity.mjs";
-export { DOOM_PROFILE_IDENTITY_ENTRY_TYPE, PROFILE_ICON_MAX_DATA_URL_LENGTH, PROFILE_ICON_MIME_TYPES, ProfileIdentityProjectionSchema };
+export { PO_PROFILE_IDENTITY_ENTRY_TYPE, PROFILE_ICON_MAX_DATA_URL_LENGTH, PROFILE_ICON_MIME_TYPES, ProfileIdentityProjectionSchema } from "./src/schemas/profileIdentity.mjs";

package/dist/protocol.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtimeProtocol = require("./runtimeProtocol.cjs");
-exports.DOOM_PROTOCOL_ERROR_CODE = require_runtimeProtocol.DOOM_PROTOCOL_ERROR_CODE;
-exports.DoomProtocolError = require_runtimeProtocol.DoomProtocolError;
-exports.DoomProtocolValidationError = require_runtimeProtocol.DoomProtocolValidationError;
+exports.PO_PROTOCOL_ERROR_CODE = require_runtimeProtocol.PO_PROTOCOL_ERROR_CODE;
+exports.PoProtocolError = require_runtimeProtocol.PoProtocolError;
+exports.PoProtocolValidationError = require_runtimeProtocol.PoProtocolValidationError;
 exports.ProtocolErrorSchema = require_runtimeProtocol.ProtocolErrorSchema;
 exports.createProtocolRuntime = require_runtimeProtocol.createProtocolRuntime;
 exports.defineJob = require_runtimeProtocol.defineJob;

package/dist/protocol.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_PROTOCOL_ERROR_CODE, DoomProtocolError, DoomProtocolValidationError, EventBusLike, NotificationDefinition, ProtocolErrorPayload, ProtocolErrorSchema, ProtocolIdentity, ProtocolRuntime, ProtocolRuntimeOptions, RequestOptions, RequestReplyDefinition, createProtocolRuntime, defineJob, defineNotification, defineRequestReply } from "./runtimeProtocol.mjs";
-export { DOOM_PROTOCOL_ERROR_CODE, DoomProtocolError, DoomProtocolValidationError, type EventBusLike, type NotificationDefinition, type ProtocolErrorPayload, ProtocolErrorSchema, type ProtocolIdentity, type ProtocolRuntime, type ProtocolRuntimeOptions, type RequestOptions, type RequestReplyDefinition, createProtocolRuntime, defineJob, defineNotification, defineRequestReply };
+import { EventBusLike, NotificationDefinition, PO_PROTOCOL_ERROR_CODE, PoProtocolError, PoProtocolValidationError, ProtocolErrorPayload, ProtocolErrorSchema, ProtocolIdentity, ProtocolRuntime, ProtocolRuntimeOptions, RequestOptions, RequestReplyDefinition, createProtocolRuntime, defineJob, defineNotification, defineRequestReply } from "./runtimeProtocol.mjs";
+export { type EventBusLike, type NotificationDefinition, PO_PROTOCOL_ERROR_CODE, PoProtocolError, PoProtocolValidationError, type ProtocolErrorPayload, ProtocolErrorSchema, type ProtocolIdentity, type ProtocolRuntime, type ProtocolRuntimeOptions, type RequestOptions, type RequestReplyDefinition, createProtocolRuntime, defineJob, defineNotification, defineRequestReply };

package/dist/protocol.mjs

@@ -1,2 +1 @@
-import { DOOM_PROTOCOL_ERROR_CODE, DoomProtocolError, DoomProtocolValidationError, ProtocolErrorSchema, createProtocolRuntime, defineJob, defineNotification, defineRequestReply } from "./runtimeProtocol.mjs";
-export { DOOM_PROTOCOL_ERROR_CODE, DoomProtocolError, DoomProtocolValidationError, ProtocolErrorSchema, createProtocolRuntime, defineJob, defineNotification, defineRequestReply };
+export { PO_PROTOCOL_ERROR_CODE, PoProtocolError, PoProtocolValidationError, ProtocolErrorSchema, createProtocolRuntime, defineJob, defineNotification, defineRequestReply } from "./runtimeProtocol.mjs";

package/dist/readiness.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_readiness = require("./src/schemas/readiness.cjs");
-exports.DOOM_READINESS_ERROR_CODE = require_readiness.DOOM_READINESS_ERROR_CODE;
-exports.DOOM_READINESS_SERVICE = require_readiness.DOOM_READINESS_SERVICE;
-exports.DoomReadinessError = require_readiness.DoomReadinessError;
-exports.createDoomReadinessCoordinator = require_readiness.createDoomReadinessCoordinator;
-exports.readDoomReadinessCoordinator = require_readiness.readDoomReadinessCoordinator;
-exports.requireDoomReadinessCoordinator = require_readiness.requireDoomReadinessCoordinator;
+exports.PO_READINESS_ERROR_CODE = require_readiness.PO_READINESS_ERROR_CODE;
+exports.PO_READINESS_SERVICE = require_readiness.PO_READINESS_SERVICE;
+exports.PoReadinessError = require_readiness.PoReadinessError;
+exports.createPoReadinessCoordinator = require_readiness.createPoReadinessCoordinator;
+exports.readPoReadinessCoordinator = require_readiness.readPoReadinessCoordinator;
+exports.requirePoReadinessCoordinator = require_readiness.requirePoReadinessCoordinator;

package/dist/readiness.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_READINESS_ERROR_CODE, DOOM_READINESS_SERVICE, DoomReadinessCoordinator, DoomReadinessCoordinatorOptions, DoomReadinessError, DoomReadinessErrorCode, DoomReadinessErrorDetail, DoomReadinessErrorOptions, DoomReadinessHandle, DoomReadinessNotification, DoomReadinessSnapshot, DoomReadinessState, DoomReadinessTask, DoomReadinessTaskResult, DoomReadinessWaitOptions, createDoomReadinessCoordinator, readDoomReadinessCoordinator, requireDoomReadinessCoordinator } from "./src/schemas/readiness.mjs";
-export { DOOM_READINESS_ERROR_CODE, DOOM_READINESS_SERVICE, type DoomReadinessCoordinator, type DoomReadinessCoordinatorOptions, DoomReadinessError, type DoomReadinessErrorCode, type DoomReadinessErrorDetail, type DoomReadinessErrorOptions, type DoomReadinessHandle, type DoomReadinessNotification, type DoomReadinessSnapshot, type DoomReadinessState, type DoomReadinessTask, type DoomReadinessTaskResult, type DoomReadinessWaitOptions, createDoomReadinessCoordinator, readDoomReadinessCoordinator, requireDoomReadinessCoordinator };
+import { PO_READINESS_ERROR_CODE, PO_READINESS_SERVICE, PoReadinessCoordinator, PoReadinessCoordinatorOptions, PoReadinessError, PoReadinessErrorCode, PoReadinessErrorDetail, PoReadinessErrorOptions, PoReadinessHandle, PoReadinessNotification, PoReadinessSnapshot, PoReadinessState, PoReadinessTask, PoReadinessTaskResult, PoReadinessWaitOptions, createPoReadinessCoordinator, readPoReadinessCoordinator, requirePoReadinessCoordinator } from "./src/schemas/readiness.mjs";
+export { PO_READINESS_ERROR_CODE, PO_READINESS_SERVICE, type PoReadinessCoordinator, type PoReadinessCoordinatorOptions, PoReadinessError, type PoReadinessErrorCode, type PoReadinessErrorDetail, type PoReadinessErrorOptions, type PoReadinessHandle, type PoReadinessNotification, type PoReadinessSnapshot, type PoReadinessState, type PoReadinessTask, type PoReadinessTaskResult, type PoReadinessWaitOptions, createPoReadinessCoordinator, readPoReadinessCoordinator, requirePoReadinessCoordinator };

package/dist/readiness.mjs

@@ -1,2 +1 @@
-import { DOOM_READINESS_ERROR_CODE, DOOM_READINESS_SERVICE, DoomReadinessError, createDoomReadinessCoordinator, readDoomReadinessCoordinator, requireDoomReadinessCoordinator } from "./src/schemas/readiness.mjs";
-export { DOOM_READINESS_ERROR_CODE, DOOM_READINESS_SERVICE, DoomReadinessError, createDoomReadinessCoordinator, readDoomReadinessCoordinator, requireDoomReadinessCoordinator };
+export { PO_READINESS_ERROR_CODE, PO_READINESS_SERVICE, PoReadinessError, createPoReadinessCoordinator, readPoReadinessCoordinator, requirePoReadinessCoordinator } from "./src/schemas/readiness.mjs";

package/dist/remoteApi.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"remoteApi.cjs","names":[],"sources":["../src/server/remoteApi.ts"],"sourcesContent":["import { DOOM_API_CALLER_LOCALITY_HEADER, type DoomApi } from '../exports/packageApi';\n\n/** Global package mount for the machine's Remote Control service. */\nexport const remoteApi: DoomApi = {\n  basePath: 'remote',\n  start(context) {\n    if (context.scope !== 'global' || !context.remoteControl)\n      throw new Error('Remote Control requires the global headless host.');\n    const control = context.remoteControl;\n    let closed = false;\n    return {\n      fetch(request) {\n        if (closed) return Response.json({ error: 'Remote Control is closed.' }, { status: 503 });\n        // Paired devices use /api/remote on the tunnel; this mount drives host-only actions.\n        if (request.headers.get(DOOM_API_CALLER_LOCALITY_HEADER) === 'remote')\n          return Response.json({ error: 'Remote Control is local only.' }, { status: 403 });\n        const origin = request.headers.get('origin');\n        if (origin !== null) {\n          let allowed = false;\n          try {\n            const parsed = new URL(origin);\n            allowed = parsed.protocol === 'http:' && ['127.0.0.1', 'localhost', '[::1]'].includes(parsed.hostname);\n          } catch {\n            allowed = false;\n          }\n          if (!allowed) return Response.json({ error: 'That origin may not control this cockpit.' }, { status: 403 });\n        }\n        const from = new URL(request.url);\n        const suffix = from.pathname === '/' ? '' : from.pathname;\n        const target = new URL(`/api/remote${suffix}${from.search}`, 'http://po.local');\n        return control.fetch(new Request(target, request));\n      },\n      close() {\n        closed = true;\n      },\n    };\n  },\n};\n"],"mappings":";;;;;AAGA,MAAa,YAAqB;CAChC,UAAU;CACV,MAAM,SAAS;EACb,IAAI,QAAQ,UAAU,YAAY,CAAC,QAAQ,eACzC,MAAM,IAAI,MAAM,mDAAmD;EACrE,MAAM,UAAU,QAAQ;EACxB,IAAI,SAAS;EACb,OAAO;GACL,MAAM,SAAS;IACb,IAAI,QAAQ,OAAO,SAAS,KAAK,EAAE,OAAO,4BAA4B,GAAG,EAAE,QAAQ,IAAI,CAAC;IAExF,IAAI,QAAQ,QAAQ,IAAA,0BAAmC,MAAM,UAC3D,OAAO,SAAS,KAAK,EAAE,OAAO,gCAAgC,GAAG,EAAE,QAAQ,IAAI,CAAC;IAClF,MAAM,SAAS,QAAQ,QAAQ,IAAI,QAAQ;IAC3C,IAAI,WAAW,MAAM;KACnB,IAAI,UAAU;KACd,IAAI;MACF,MAAM,SAAS,IAAI,IAAI,MAAM;MAC7B,UAAU,OAAO,aAAa,WAAW;OAAC;OAAa;OAAa;MAAO,CAAC,CAAC,SAAS,OAAO,QAAQ;KACvG,QAAQ;MACN,UAAU;KACZ;KACA,IAAI,CAAC,SAAS,OAAO,SAAS,KAAK,EAAE,OAAO,4CAA4C,GAAG,EAAE,QAAQ,IAAI,CAAC;IAC5G;IACA,MAAM,OAAO,IAAI,IAAI,QAAQ,GAAG;IAChC,MAAM,SAAS,KAAK,aAAa,MAAM,KAAK,KAAK;IACjD,MAAM,SAAS,IAAI,IAAI,cAAc,SAAS,KAAK,UAAU,iBAAiB;IAC9E,OAAO,QAAQ,MAAM,IAAI,QAAQ,QAAQ,OAAO,CAAC;GACnD;GACA,QAAQ;IACN,SAAS;GACX;EACF;CACF;AACF"}
+{"version":3,"file":"remoteApi.cjs","names":[],"sources":["../src/server/remoteApi.ts"],"sourcesContent":["import { PO_API_CALLER_LOCALITY_HEADER, type PoApi } from '../exports/packageApi';\n\n/** Global package mount for the machine's Remote Control service. */\nexport const remoteApi: PoApi = {\n  basePath: 'remote',\n  start(context) {\n    if (context.scope !== 'global' || !context.remoteControl)\n      throw new Error('Remote Control requires the global headless host.');\n    const control = context.remoteControl;\n    let closed = false;\n    return {\n      fetch(request) {\n        if (closed) return Response.json({ error: 'Remote Control is closed.' }, { status: 503 });\n        // Paired devices use /api/remote on the tunnel; this mount drives host-only actions.\n        if (request.headers.get(PO_API_CALLER_LOCALITY_HEADER) === 'remote')\n          return Response.json({ error: 'Remote Control is local only.' }, { status: 403 });\n        const origin = request.headers.get('origin');\n        if (origin !== null) {\n          let allowed = false;\n          try {\n            const parsed = new URL(origin);\n            allowed = parsed.protocol === 'http:' && ['127.0.0.1', 'localhost', '[::1]'].includes(parsed.hostname);\n          } catch {\n            allowed = false;\n          }\n          if (!allowed) return Response.json({ error: 'That origin may not control this cockpit.' }, { status: 403 });\n        }\n        const from = new URL(request.url);\n        const suffix = from.pathname === '/' ? '' : from.pathname;\n        const target = new URL(`/api/remote${suffix}${from.search}`, 'http://po.local');\n        return control.fetch(new Request(target, request));\n      },\n      close() {\n        closed = true;\n      },\n    };\n  },\n};\n"],"mappings":";;;;;AAGA,MAAa,YAAmB;CAC9B,UAAU;CACV,MAAM,SAAS;EACb,IAAI,QAAQ,UAAU,YAAY,CAAC,QAAQ,eACzC,MAAM,IAAI,MAAM,mDAAmD;EACrE,MAAM,UAAU,QAAQ;EACxB,IAAI,SAAS;EACb,OAAO;GACL,MAAM,SAAS;IACb,IAAI,QAAQ,OAAO,SAAS,KAAK,EAAE,OAAO,4BAA4B,GAAG,EAAE,QAAQ,IAAI,CAAC;IAExF,IAAI,QAAQ,QAAQ,IAAA,0BAAiC,MAAM,UACzD,OAAO,SAAS,KAAK,EAAE,OAAO,gCAAgC,GAAG,EAAE,QAAQ,IAAI,CAAC;IAClF,MAAM,SAAS,QAAQ,QAAQ,IAAI,QAAQ;IAC3C,IAAI,WAAW,MAAM;KACnB,IAAI,UAAU;KACd,IAAI;MACF,MAAM,SAAS,IAAI,IAAI,MAAM;MAC7B,UAAU,OAAO,aAAa,WAAW;OAAC;OAAa;OAAa;MAAO,CAAC,CAAC,SAAS,OAAO,QAAQ;KACvG,QAAQ;MACN,UAAU;KACZ;KACA,IAAI,CAAC,SAAS,OAAO,SAAS,KAAK,EAAE,OAAO,4CAA4C,GAAG,EAAE,QAAQ,IAAI,CAAC;IAC5G;IACA,MAAM,OAAO,IAAI,IAAI,QAAQ,GAAG;IAChC,MAAM,SAAS,KAAK,aAAa,MAAM,KAAK,KAAK;IACjD,MAAM,SAAS,IAAI,IAAI,cAAc,SAAS,KAAK,UAAU,iBAAiB;IAC9E,OAAO,QAAQ,MAAM,IAAI,QAAQ,QAAQ,OAAO,CAAC;GACnD;GACA,QAAQ;IACN,SAAS;GACX;EACF;CACF;AACF"}

package/dist/remoteApi.d.mts

@@ -1,7 +1,7 @@
-import { DoomApi } from "./src/schemas/packageApi.mjs";
+import { PoApi } from "./src/schemas/packageApi.mjs";
 import "./packageApi.mjs";
 //#region src/server/remoteApi.d.ts
 /** Global package mount for the machine's Remote Control service. */
-export declare const remoteApi: DoomApi;
+export declare const remoteApi: PoApi;
 //#endregion
 //# sourceMappingURL=remoteApi.d.mts.map

package/dist/remoteApi.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"remoteApi.mjs","names":[],"sources":["../src/server/remoteApi.ts"],"sourcesContent":["import { DOOM_API_CALLER_LOCALITY_HEADER, type DoomApi } from '../exports/packageApi';\n\n/** Global package mount for the machine's Remote Control service. */\nexport const remoteApi: DoomApi = {\n  basePath: 'remote',\n  start(context) {\n    if (context.scope !== 'global' || !context.remoteControl)\n      throw new Error('Remote Control requires the global headless host.');\n    const control = context.remoteControl;\n    let closed = false;\n    return {\n      fetch(request) {\n        if (closed) return Response.json({ error: 'Remote Control is closed.' }, { status: 503 });\n        // Paired devices use /api/remote on the tunnel; this mount drives host-only actions.\n        if (request.headers.get(DOOM_API_CALLER_LOCALITY_HEADER) === 'remote')\n          return Response.json({ error: 'Remote Control is local only.' }, { status: 403 });\n        const origin = request.headers.get('origin');\n        if (origin !== null) {\n          let allowed = false;\n          try {\n            const parsed = new URL(origin);\n            allowed = parsed.protocol === 'http:' && ['127.0.0.1', 'localhost', '[::1]'].includes(parsed.hostname);\n          } catch {\n            allowed = false;\n          }\n          if (!allowed) return Response.json({ error: 'That origin may not control this cockpit.' }, { status: 403 });\n        }\n        const from = new URL(request.url);\n        const suffix = from.pathname === '/' ? '' : from.pathname;\n        const target = new URL(`/api/remote${suffix}${from.search}`, 'http://po.local');\n        return control.fetch(new Request(target, request));\n      },\n      close() {\n        closed = true;\n      },\n    };\n  },\n};\n"],"mappings":";;;;AAGA,MAAa,YAAqB;CAChC,UAAU;CACV,MAAM,SAAS;EACb,IAAI,QAAQ,UAAU,YAAY,CAAC,QAAQ,eACzC,MAAM,IAAI,MAAM,mDAAmD;EACrE,MAAM,UAAU,QAAQ;EACxB,IAAI,SAAS;EACb,OAAO;GACL,MAAM,SAAS;IACb,IAAI,QAAQ,OAAO,SAAS,KAAK,EAAE,OAAO,4BAA4B,GAAG,EAAE,QAAQ,IAAI,CAAC;IAExF,IAAI,QAAQ,QAAQ,IAAA,0BAAmC,MAAM,UAC3D,OAAO,SAAS,KAAK,EAAE,OAAO,gCAAgC,GAAG,EAAE,QAAQ,IAAI,CAAC;IAClF,MAAM,SAAS,QAAQ,QAAQ,IAAI,QAAQ;IAC3C,IAAI,WAAW,MAAM;KACnB,IAAI,UAAU;KACd,IAAI;MACF,MAAM,SAAS,IAAI,IAAI,MAAM;MAC7B,UAAU,OAAO,aAAa,WAAW;OAAC;OAAa;OAAa;MAAO,CAAC,CAAC,SAAS,OAAO,QAAQ;KACvG,QAAQ;MACN,UAAU;KACZ;KACA,IAAI,CAAC,SAAS,OAAO,SAAS,KAAK,EAAE,OAAO,4CAA4C,GAAG,EAAE,QAAQ,IAAI,CAAC;IAC5G;IACA,MAAM,OAAO,IAAI,IAAI,QAAQ,GAAG;IAChC,MAAM,SAAS,KAAK,aAAa,MAAM,KAAK,KAAK;IACjD,MAAM,SAAS,IAAI,IAAI,cAAc,SAAS,KAAK,UAAU,iBAAiB;IAC9E,OAAO,QAAQ,MAAM,IAAI,QAAQ,QAAQ,OAAO,CAAC;GACnD;GACA,QAAQ;IACN,SAAS;GACX;EACF;CACF;AACF"}
+{"version":3,"file":"remoteApi.mjs","names":[],"sources":["../src/server/remoteApi.ts"],"sourcesContent":["import { PO_API_CALLER_LOCALITY_HEADER, type PoApi } from '../exports/packageApi';\n\n/** Global package mount for the machine's Remote Control service. */\nexport const remoteApi: PoApi = {\n  basePath: 'remote',\n  start(context) {\n    if (context.scope !== 'global' || !context.remoteControl)\n      throw new Error('Remote Control requires the global headless host.');\n    const control = context.remoteControl;\n    let closed = false;\n    return {\n      fetch(request) {\n        if (closed) return Response.json({ error: 'Remote Control is closed.' }, { status: 503 });\n        // Paired devices use /api/remote on the tunnel; this mount drives host-only actions.\n        if (request.headers.get(PO_API_CALLER_LOCALITY_HEADER) === 'remote')\n          return Response.json({ error: 'Remote Control is local only.' }, { status: 403 });\n        const origin = request.headers.get('origin');\n        if (origin !== null) {\n          let allowed = false;\n          try {\n            const parsed = new URL(origin);\n            allowed = parsed.protocol === 'http:' && ['127.0.0.1', 'localhost', '[::1]'].includes(parsed.hostname);\n          } catch {\n            allowed = false;\n          }\n          if (!allowed) return Response.json({ error: 'That origin may not control this cockpit.' }, { status: 403 });\n        }\n        const from = new URL(request.url);\n        const suffix = from.pathname === '/' ? '' : from.pathname;\n        const target = new URL(`/api/remote${suffix}${from.search}`, 'http://po.local');\n        return control.fetch(new Request(target, request));\n      },\n      close() {\n        closed = true;\n      },\n    };\n  },\n};\n"],"mappings":";;;;AAGA,MAAa,YAAmB;CAC9B,UAAU;CACV,MAAM,SAAS;EACb,IAAI,QAAQ,UAAU,YAAY,CAAC,QAAQ,eACzC,MAAM,IAAI,MAAM,mDAAmD;EACrE,MAAM,UAAU,QAAQ;EACxB,IAAI,SAAS;EACb,OAAO;GACL,MAAM,SAAS;IACb,IAAI,QAAQ,OAAO,SAAS,KAAK,EAAE,OAAO,4BAA4B,GAAG,EAAE,QAAQ,IAAI,CAAC;IAExF,IAAI,QAAQ,QAAQ,IAAA,0BAAiC,MAAM,UACzD,OAAO,SAAS,KAAK,EAAE,OAAO,gCAAgC,GAAG,EAAE,QAAQ,IAAI,CAAC;IAClF,MAAM,SAAS,QAAQ,QAAQ,IAAI,QAAQ;IAC3C,IAAI,WAAW,MAAM;KACnB,IAAI,UAAU;KACd,IAAI;MACF,MAAM,SAAS,IAAI,IAAI,MAAM;MAC7B,UAAU,OAAO,aAAa,WAAW;OAAC;OAAa;OAAa;MAAO,CAAC,CAAC,SAAS,OAAO,QAAQ;KACvG,QAAQ;MACN,UAAU;KACZ;KACA,IAAI,CAAC,SAAS,OAAO,SAAS,KAAK,EAAE,OAAO,4CAA4C,GAAG,EAAE,QAAQ,IAAI,CAAC;IAC5G;IACA,MAAM,OAAO,IAAI,IAAI,QAAQ,GAAG;IAChC,MAAM,SAAS,KAAK,aAAa,MAAM,KAAK,KAAK;IACjD,MAAM,SAAS,IAAI,IAAI,cAAc,SAAS,KAAK,UAAU,iBAAiB;IAC9E,OAAO,QAAQ,MAAM,IAAI,QAAQ,QAAQ,OAAO,CAAC;GACnD;GACA,QAAQ;IACN,SAAS;GACX;EACF;CACF;AACF"}