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

package/dist/runtimeCordisHost.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeCordisHost.mjs","names":[],"sources":["../src/pi/cordisHost.ts"],"sourcesContent":["import { Context, type Fiber } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext, SessionStartEvent } from '@earendil-works/pi-coding-agent';\n\nimport { DOOM_CONTEXT_CONTRIBUTIONS_SERVICE } from '../schemas/contextContributions';\nimport { DOOM_TOOL_OVERRIDES_SERVICE } from '../schemas/toolOverrides';\nimport { DOOM_TOOL_SURFACE_SERVICE } from '../schemas/toolSurface';\nimport { createDoomContextContributionsService } from '../services/contextContributions';\nimport { createDoomToolOverridesService } from '../services/toolOverrides';\nimport { createDoomToolSurface } from '../services/toolSurface';\n\nexport const DOOM_CORDIS_HOST_ABI_VERSION = 1 as const;\nexport const DOOM_CORDIS_HOST_QUERY_CHANNEL = 'doom:cordis:host:v1:query';\nexport const DOOM_CORDIS_RUNTIME_SERVICE = 'doom/runtime';\nexport const DOOM_CORDIS_SESSION_SERVICE = 'doom/session';\nexport const DOOM_CORDIS_SERVER_SERVICES = 'doom/server-session-services';\n\n/** Read-only access to services already owned by this session's server facets. */\nexport interface DoomCordisServerServices {\n  readonly sessionId: string;\n  get<T>(name: string): T | undefined;\n}\nconst HOST_PROTOCOL = 'doom.cordis.host';\nconst DEFAULT_HOST_SOURCE = '@agimon-ai/po/cordis-host';\n\nexport type DoomCordisHostMode = 'composed' | 'standalone';\n\nexport interface DoomCordisRuntimeService {\n  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly generation: string;\n  readonly mode: DoomCordisHostMode;\n}\n\nexport interface DoomCordisSessionService {\n  readonly sessionId: string;\n  readonly generation: string;\n  readonly reason: SessionStartEvent['reason'];\n  readonly context: ExtensionContext;\n  /** This session's admitted environment: its own in a server, the process's in a terminal. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n}\n\ntype SessionEnvironment = Readonly<Record<string, string | undefined>>;\n\n/**\n * Admitted environments of sessions sharing this process, by session id.\n *\n * A server runs many sessions' Pi extensions in one process, so `process.env` is\n * the server's, not any session's. Held on a global symbol because extension\n * packages can load their own copy of this module.\n */\nconst SESSION_ENVIRONMENTS: Map<string, { readonly environment: SessionEnvironment }> = ((\n  globalThis as Record<symbol, unknown>\n)[Symbol.for('doom.cordis.session-environments.v1')] ??= new Map()) as Map<\n  string,\n  { readonly environment: SessionEnvironment }\n>;\n\n/**\n * Binds a session id to its admitted environment until the returned release runs.\n *\n * The newest registration wins: a reopened session can start before its previous host has\n * finished closing, and that late release must not unbind the new one.\n */\nexport function registerDoomSessionEnvironment(sessionId: string, environment: SessionEnvironment): () => void {\n  const registration = { environment };\n  SESSION_ENVIRONMENTS.set(sessionId, registration);\n  return () => {\n    if (SESSION_ENVIRONMENTS.get(sessionId) === registration) SESSION_ENVIRONMENTS.delete(sessionId);\n  };\n}\n\n/** The session's admitted environment, or `process.env` for a session that owns its process. */\nexport function readDoomSessionEnvironment(sessionId: string | undefined): SessionEnvironment {\n  return (sessionId === undefined ? undefined : SESSION_ENVIRONMENTS.get(sessionId)?.environment) ?? process.env;\n}\n\nexport function requireDoomCordisSession(context: Context): DoomCordisSessionService {\n  const session = context.get(DOOM_CORDIS_SESSION_SERVICE) as DoomCordisSessionService | undefined;\n  if (!session) throw new Error('Doom Cordis session service is unavailable.');\n  return session;\n}\n\nexport interface DoomCordisHostConnection {\n  readonly root: Context;\n  readonly runtime: DoomCordisRuntimeService;\n  /** Releases this consumer's lease. It never disposes a composed host. */\n  dispose(): Promise<void>;\n}\n\nexport interface DoomCordisHostController {\n  readonly root: Context;\n  readonly runtime: DoomCordisRuntimeService;\n  /** Recursively disposes the session and application plugin tree. */\n  shutdown(): Promise<void>;\n}\n\nexport interface InstallDoomCordisHostOptions {\n  readonly mode: DoomCordisHostMode;\n  readonly source?: string;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/runtime': DoomCordisRuntimeService;\n    'doom/session': DoomCordisSessionService;\n  }\n}\n\ninterface HostQuery {\n  readonly protocol: typeof HOST_PROTOCOL;\n  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;\n  readonly kind: 'query';\n  readonly requestId: string;\n  readonly source: string;\n  readonly accept: (response: unknown) => void;\n}\n\ninterface HostResponder {\n  readonly protocol: typeof HOST_PROTOCOL;\n  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly root: Context;\n  readonly runtime: DoomCordisRuntimeService;\n  readonly ready: Promise<void>;\n  acquire(): DoomCordisHostConnection;\n  shutdown(): Promise<void>;\n}\n\nfunction isRecord(value: unknown): value is Record<PropertyKey, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction asHostQuery(value: unknown): HostQuery | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.protocol !== HOST_PROTOCOL ||\n    value.abiVersion !== DOOM_CORDIS_HOST_ABI_VERSION ||\n    value.kind !== 'query' ||\n    typeof value.requestId !== 'string' ||\n    value.requestId.length === 0 ||\n    typeof value.source !== 'string' ||\n    value.source.length === 0 ||\n    typeof value.accept !== 'function'\n  ) {\n    return undefined;\n  }\n  return value as unknown as HostQuery;\n}\n\nfunction asHostResponder(value: unknown): HostResponder {\n  if (!isRecord(value)) throw new Error('The Doom Cordis host returned an invalid discovery response.');\n  if (value.protocol !== HOST_PROTOCOL) {\n    throw new Error('The Doom Cordis host returned an invalid protocol identifier.');\n  }\n  if (value.abiVersion !== DOOM_CORDIS_HOST_ABI_VERSION) {\n    throw new Error(\n      `The Doom Cordis host ABI is incompatible: expected ${String(DOOM_CORDIS_HOST_ABI_VERSION)}, received ${String(value.abiVersion)}.`,\n    );\n  }\n  if (typeof value.hostId !== 'string' || value.hostId.length === 0) {\n    throw new Error('The Doom Cordis host returned an invalid host identifier.');\n  }\n  if (!Context.is(value.root)) {\n    throw new Error('The Doom Cordis host returned a value that is not a Cordis Context.');\n  }\n  if (\n    !isRecord(value.runtime) ||\n    value.runtime.abiVersion !== DOOM_CORDIS_HOST_ABI_VERSION ||\n    value.runtime.hostId !== value.hostId ||\n    typeof value.acquire !== 'function' ||\n    typeof value.shutdown !== 'function' ||\n    !isRecord(value.ready) ||\n    typeof value.ready.then !== 'function'\n  ) {\n    throw new Error('The Doom Cordis host returned incomplete runtime metadata.');\n  }\n  return value as unknown as HostResponder;\n}\n\nfunction discoverHosts(pi: Pick<ExtensionAPI, 'events'>, source: string): HostResponder[] {\n  const responses: HostResponder[] = [];\n  const request: HostQuery = {\n    protocol: HOST_PROTOCOL,\n    abiVersion: DOOM_CORDIS_HOST_ABI_VERSION,\n    kind: 'query',\n    requestId: `${source}:${crypto.randomUUID()}`,\n    source,\n    accept(response) {\n      responses.push(asHostResponder(response));\n    },\n  };\n  pi.events.emit(DOOM_CORDIS_HOST_QUERY_CHANNEL, request);\n  return responses;\n}\n\nfunction exactlyOneHost(responses: readonly HostResponder[], source: string): HostResponder | undefined {\n  if (responses.length <= 1) return responses[0];\n  const hostIds = responses.map(({ hostId }) => hostId).join(', ');\n  throw new Error(`Multiple Doom Cordis hosts answered ${source}: ${hostIds}.`);\n}\n\nfunction runtimeProvider(ctx: Context, service: DoomCordisRuntimeService): void {\n  ctx.provide(DOOM_CORDIS_RUNTIME_SERVICE, service);\n  ctx.provide(DOOM_TOOL_OVERRIDES_SERVICE, createDoomToolOverridesService(service.generation));\n}\n\nfunction sessionProvider(ctx: Context, service: DoomCordisSessionService, pi: ExtensionAPI): void {\n  ctx.provide(DOOM_CORDIS_SESSION_SERVICE, service);\n  ctx.provide(DOOM_CONTEXT_CONTRIBUTIONS_SERVICE, createDoomContextContributionsService(service.generation));\n  ctx.provide(\n    DOOM_TOOL_SURFACE_SERVICE,\n    createDoomToolSurface({\n      generation: service.generation,\n      allTools: () => pi.getAllTools().map((tool) => tool.name),\n      activeTools: () => pi.getActiveTools(),\n      setActiveTools: (names) => pi.setActiveTools(names),\n    }),\n  );\n}\n\n/**\n * Installs the sole Cordis application root for one Pi extension runner.\n *\n * The versioned EventBus query is intentional: Pi may hand independently\n * loaded factories different ExtensionAPI wrapper objects, while their event\n * buses still address the same runner.\n */\nexport async function installDoomCordisHost(\n  pi: ExtensionAPI,\n  options: InstallDoomCordisHostOptions,\n): Promise<DoomCordisHostController> {\n  const source = options.source ?? DEFAULT_HOST_SOURCE;\n  const existing = exactlyOneHost(discoverHosts(pi, source), source);\n  if (existing) throw new Error(`A Doom Cordis host is already installed: ${existing.hostId}.`);\n\n  // This is the one intentional Context constructor for Po extension code.\n  const root = new Context();\n  const runtime: DoomCordisRuntimeService = Object.freeze({\n    abiVersion: DOOM_CORDIS_HOST_ABI_VERSION,\n    hostId: `doom-cordis:${crypto.randomUUID()}`,\n    generation: `doom-runtime:${crypto.randomUUID()}`,\n    mode: options.mode,\n  });\n  const runtimeFiber = root.plugin(runtimeProvider, runtime);\n  const ready = runtimeFiber.await().then(() => undefined);\n  let sessionFiber: Fiber | undefined;\n  let sessionGeneration = 0;\n  let sessionQueue = Promise.resolve();\n  let leaseCount = 0;\n  let shutdownPromise: Promise<void> | undefined;\n  let responder: HostResponder;\n  let disposeQuerySubscription = (): void => undefined;\n\n  const controller: DoomCordisHostController = {\n    root,\n    runtime,\n    shutdown() {\n      shutdownPromise ??= (async () => {\n        disposeQuerySubscription();\n        await ready.catch(() => undefined);\n        await sessionQueue.catch(() => undefined);\n        await sessionFiber?.dispose();\n        sessionFiber = undefined;\n        await root.fiber.dispose();\n      })();\n      return shutdownPromise;\n    },\n  };\n\n  responder = {\n    protocol: HOST_PROTOCOL,\n    abiVersion: DOOM_CORDIS_HOST_ABI_VERSION,\n    hostId: runtime.hostId,\n    root,\n    runtime,\n    ready,\n    acquire() {\n      if (shutdownPromise) throw new Error(`The Doom Cordis host is shutting down: ${runtime.hostId}.`);\n      leaseCount += 1;\n      let released = false;\n      return {\n        root,\n        runtime,\n        async dispose() {\n          if (released) return;\n          released = true;\n          leaseCount -= 1;\n          if (options.mode === 'standalone' && leaseCount === 0) await controller.shutdown();\n        },\n      };\n    },\n    shutdown: () => controller.shutdown(),\n  };\n  try {\n    disposeQuerySubscription = pi.events.on(DOOM_CORDIS_HOST_QUERY_CHANNEL, (value) => {\n      const query = asHostQuery(value);\n      if (query) query.accept(responder);\n    });\n    pi.on('session_start', (event, context) => {\n      sessionQueue = sessionQueue\n        .catch(() => undefined)\n        .then(async () => {\n          // Pi owns its listener table and can retain this callback across a\n          // replacement. A start delivered after finalization belongs to the\n          // stale graph and must not revive or fail the next one.\n          if (shutdownPromise) return;\n          await sessionFiber?.dispose();\n          sessionGeneration += 1;\n          const service: DoomCordisSessionService = Object.freeze({\n            sessionId: context.sessionManager.getSessionId(),\n            generation: `${runtime.generation}:${String(sessionGeneration)}`,\n            reason: event.reason,\n            context,\n            environment: readDoomSessionEnvironment(context.sessionManager.getSessionId()),\n          });\n          sessionFiber = root.plugin((ctx: Context, value: DoomCordisSessionService) => {\n            sessionProvider(ctx, value, pi);\n          }, service);\n          await sessionFiber.await();\n        });\n      return sessionQueue;\n    });\n    if (options.mode === 'standalone') {\n      pi.on('session_shutdown', () => {\n        disposeQuerySubscription();\n      });\n    }\n    await ready;\n  } catch (error) {\n    await controller.shutdown();\n    throw error;\n  }\n  return controller;\n}\n\n/** Resolves the composed host installed by the canonical runtime. */\nexport function connectDoomCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n): Promise<DoomCordisHostConnection>;\nexport function connectDoomCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n  options: { readonly optional: true },\n): Promise<DoomCordisHostConnection | undefined>;\nexport async function connectDoomCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n  options?: { readonly optional: true },\n): Promise<DoomCordisHostConnection | undefined> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  if (!responder) {\n    // Vanilla Pi plugins do not install a Doom host. Optional discovery permits only\n    // that absence, never an invalid or ambiguous responder.\n    if (options?.optional) return undefined;\n    throw new Error('The composed Doom Cordis host is unavailable. Ensure cordisHost is the first extension.');\n  }\n  await responder.ready;\n  return responder.acquire();\n}\n\n/** Ends the host discovered on this runner. Repeated finalization is a no-op. */\nexport async function finalizeDoomCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<void> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  await responder?.shutdown();\n}\n"],"mappings":";;;;;;;;AAUA,MAAa,+BAA+B;AAC5C,MAAa,iCAAiC;AAC9C,MAAa,8BAA8B;AAC3C,MAAa,8BAA8B;AAC3C,MAAa,8BAA8B;AAO3C,MAAM,gBAAgB;AACtB,MAAM,sBAAsB;;;;;;;;AA6B5B,MAAM,uBAAmF,WAEvF,OAAO,IAAI,qCAAqC,uBAAO,IAAI,IAAI;;;;;;;AAWjE,SAAgB,+BAA+B,WAAmB,aAA6C;CAC7G,MAAM,eAAe,EAAE,YAAY;CACnC,qBAAqB,IAAI,WAAW,YAAY;CAChD,aAAa;EACX,IAAI,qBAAqB,IAAI,SAAS,MAAM,cAAc,qBAAqB,OAAO,SAAS;CACjG;AACF;;AAGA,SAAgB,2BAA2B,WAAmD;CAC5F,QAAQ,cAAc,KAAA,IAAY,KAAA,IAAY,qBAAqB,IAAI,SAAS,CAAC,EAAE,gBAAgB,QAAQ;AAC7G;AAEA,SAAgB,yBAAyB,SAA4C;CACnF,MAAM,UAAU,QAAQ,IAAI,2BAA2B;CACvD,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,6CAA6C;CAC3E,OAAO;AACT;AAgDA,SAAS,SAAS,OAAuD;CACvE,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,YAAY,OAAuC;CAC1D,IAAI,CAAC,SAAS,KAAK,GAAG,OAAO,KAAA;CAC7B,IACE,MAAM,aAAa,iBACnB,MAAM,eAAA,KACN,MAAM,SAAS,WACf,OAAO,MAAM,cAAc,YAC3B,MAAM,UAAU,WAAW,KAC3B,OAAO,MAAM,WAAW,YACxB,MAAM,OAAO,WAAW,KACxB,OAAO,MAAM,WAAW,YAExB;CAEF,OAAO;AACT;AAEA,SAAS,gBAAgB,OAA+B;CACtD,IAAI,CAAC,SAAS,KAAK,GAAG,MAAM,IAAI,MAAM,8DAA8D;CACpG,IAAI,MAAM,aAAa,eACrB,MAAM,IAAI,MAAM,+DAA+D;CAEjF,IAAI,MAAM,eAAA,GACR,MAAM,IAAI,MACR,sDAAsD,OAAA,CAAmC,EAAE,aAAa,OAAO,MAAM,UAAU,EAAE,EACnI;CAEF,IAAI,OAAO,MAAM,WAAW,YAAY,MAAM,OAAO,WAAW,GAC9D,MAAM,IAAI,MAAM,2DAA2D;CAE7E,IAAI,CAAC,QAAQ,GAAG,MAAM,IAAI,GACxB,MAAM,IAAI,MAAM,qEAAqE;CAEvF,IACE,CAAC,SAAS,MAAM,OAAO,KACvB,MAAM,QAAQ,eAAA,KACd,MAAM,QAAQ,WAAW,MAAM,UAC/B,OAAO,MAAM,YAAY,cACzB,OAAO,MAAM,aAAa,cAC1B,CAAC,SAAS,MAAM,KAAK,KACrB,OAAO,MAAM,MAAM,SAAS,YAE5B,MAAM,IAAI,MAAM,4DAA4D;CAE9E,OAAO;AACT;AAEA,SAAS,cAAc,IAAkC,QAAiC;CACxF,MAAM,YAA6B,CAAC;CACpC,MAAM,UAAqB;EACzB,UAAU;EACV,YAAA;EACA,MAAM;EACN,WAAW,GAAG,OAAO,GAAG,OAAO,WAAW;EAC1C;EACA,OAAO,UAAU;GACf,UAAU,KAAK,gBAAgB,QAAQ,CAAC;EAC1C;CACF;CACA,GAAG,OAAO,KAAK,gCAAgC,OAAO;CACtD,OAAO;AACT;AAEA,SAAS,eAAe,WAAqC,QAA2C;CACtG,IAAI,UAAU,UAAU,GAAG,OAAO,UAAU;CAC5C,MAAM,UAAU,UAAU,KAAK,EAAE,aAAa,MAAM,CAAC,CAAC,KAAK,IAAI;CAC/D,MAAM,IAAI,MAAM,uCAAuC,OAAO,IAAI,QAAQ,EAAE;AAC9E;AAEA,SAAS,gBAAgB,KAAc,SAAyC;CAC9E,IAAI,QAAQ,6BAA6B,OAAO;CAChD,IAAI,QAAQ,6BAA6B,+BAA+B,QAAQ,UAAU,CAAC;AAC7F;AAEA,SAAS,gBAAgB,KAAc,SAAmC,IAAwB;CAChG,IAAI,QAAQ,6BAA6B,OAAO;CAChD,IAAI,QAAQ,oCAAoC,sCAAsC,QAAQ,UAAU,CAAC;CACzG,IAAI,QACF,2BACA,sBAAsB;EACpB,YAAY,QAAQ;EACpB,gBAAgB,GAAG,YAAY,CAAC,CAAC,KAAK,SAAS,KAAK,IAAI;EACxD,mBAAmB,GAAG,eAAe;EACrC,iBAAiB,UAAU,GAAG,eAAe,KAAK;CACpD,CAAC,CACH;AACF;;;;;;;;AASA,eAAsB,sBACpB,IACA,SACmC;CACnC,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,WAAW,eAAe,cAAc,IAAI,MAAM,GAAG,MAAM;CACjE,IAAI,UAAU,MAAM,IAAI,MAAM,4CAA4C,SAAS,OAAO,EAAE;CAG5F,MAAM,OAAO,IAAI,QAAQ;CACzB,MAAM,UAAoC,OAAO,OAAO;EACtD,YAAA;EACA,QAAQ,eAAe,OAAO,WAAW;EACzC,YAAY,gBAAgB,OAAO,WAAW;EAC9C,MAAM,QAAQ;CAChB,CAAC;CAED,MAAM,QADe,KAAK,OAAO,iBAAiB,OACzB,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,KAAA,CAAS;CACvD,IAAI;CACJ,IAAI,oBAAoB;CACxB,IAAI,eAAe,QAAQ,QAAQ;CACnC,IAAI,aAAa;CACjB,IAAI;CACJ,IAAI;CACJ,IAAI,iCAAuC,KAAA;CAE3C,MAAM,aAAuC;EAC3C;EACA;EACA,WAAW;GACT,qBAAqB,YAAY;IAC/B,yBAAyB;IACzB,MAAM,MAAM,YAAY,KAAA,CAAS;IACjC,MAAM,aAAa,YAAY,KAAA,CAAS;IACxC,MAAM,cAAc,QAAQ;IAC5B,eAAe,KAAA;IACf,MAAM,KAAK,MAAM,QAAQ;GAC3B,EAAA,CAAG;GACH,OAAO;EACT;CACF;CAEA,YAAY;EACV,UAAU;EACV,YAAA;EACA,QAAQ,QAAQ;EAChB;EACA;EACA;EACA,UAAU;GACR,IAAI,iBAAiB,MAAM,IAAI,MAAM,0CAA0C,QAAQ,OAAO,EAAE;GAChG,cAAc;GACd,IAAI,WAAW;GACf,OAAO;IACL;IACA;IACA,MAAM,UAAU;KACd,IAAI,UAAU;KACd,WAAW;KACX,cAAc;KACd,IAAI,QAAQ,SAAS,gBAAgB,eAAe,GAAG,MAAM,WAAW,SAAS;IACnF;GACF;EACF;EACA,gBAAgB,WAAW,SAAS;CACtC;CACA,IAAI;EACF,2BAA2B,GAAG,OAAO,GAAG,iCAAiC,UAAU;GACjF,MAAM,QAAQ,YAAY,KAAK;GAC/B,IAAI,OAAO,MAAM,OAAO,SAAS;EACnC,CAAC;EACD,GAAG,GAAG,kBAAkB,OAAO,YAAY;GACzC,eAAe,aACZ,YAAY,KAAA,CAAS,CAAC,CACtB,KAAK,YAAY;IAIhB,IAAI,iBAAiB;IACrB,MAAM,cAAc,QAAQ;IAC5B,qBAAqB;IACrB,MAAM,UAAoC,OAAO,OAAO;KACtD,WAAW,QAAQ,eAAe,aAAa;KAC/C,YAAY,GAAG,QAAQ,WAAW,GAAG,OAAO,iBAAiB;KAC7D,QAAQ,MAAM;KACd;KACA,aAAa,2BAA2B,QAAQ,eAAe,aAAa,CAAC;IAC/E,CAAC;IACD,eAAe,KAAK,QAAQ,KAAc,UAAoC;KAC5E,gBAAgB,KAAK,OAAO,EAAE;IAChC,GAAG,OAAO;IACV,MAAM,aAAa,MAAM;GAC3B,CAAC;GACH,OAAO;EACT,CAAC;EACD,IAAI,QAAQ,SAAS,cACnB,GAAG,GAAG,0BAA0B;GAC9B,yBAAyB;EAC3B,CAAC;EAEH,MAAM;CACR,SAAS,OAAO;EACd,MAAM,WAAW,SAAS;EAC1B,MAAM;CACR;CACA,OAAO;AACT;AAYA,eAAsB,sBACpB,IACA,QACA,SAC+C;CAC/C,MAAM,YAAY,eAAe,cAAc,IAAI,MAAM,GAAG,MAAM;CAClE,IAAI,CAAC,WAAW;EAGd,IAAI,SAAS,UAAU,OAAO,KAAA;EAC9B,MAAM,IAAI,MAAM,yFAAyF;CAC3G;CACA,MAAM,UAAU;CAChB,OAAO,UAAU,QAAQ;AAC3B;;AAGA,eAAsB,uBAAuB,IAAkC,QAA+B;CAE5G,MADkB,eAAe,cAAc,IAAI,MAAM,GAAG,MAC9C,CAAC,EAAE,SAAS;AAC5B"}
+{"version":3,"file":"runtimeCordisHost.mjs","names":[],"sources":["../src/pi/cordisHost.ts"],"sourcesContent":["import { Context, type Fiber } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext, SessionStartEvent } from '@earendil-works/pi-coding-agent';\n\nimport { PO_CONTEXT_CONTRIBUTIONS_SERVICE } from '../schemas/contextContributions';\nimport { PO_TOOL_OVERRIDES_SERVICE } from '../schemas/toolOverrides';\nimport { PO_TOOL_SURFACE_SERVICE } from '../schemas/toolSurface';\nimport { createPoContextContributionsService } from '../services/contextContributions';\nimport { createPoToolOverridesService } from '../services/toolOverrides';\nimport { createPoToolSurface } from '../services/toolSurface';\n\nexport const PO_CORDIS_HOST_ABI_VERSION = 1 as const;\nexport const PO_CORDIS_HOST_QUERY_CHANNEL = 'po:cordis:host:v1:query';\nexport const PO_CORDIS_RUNTIME_SERVICE = 'po/runtime';\nexport const PO_CORDIS_SESSION_SERVICE = 'po/session';\nexport const PO_CORDIS_SERVER_SERVICES = 'po/server-session-services';\n\n/** Read-only access to services already owned by this session's server packages. */\nexport interface PoCordisServerServices {\n  readonly sessionId: string;\n  get<T>(name: string): T | undefined;\n}\nconst HOST_PROTOCOL = 'po.cordis.host';\nconst DEFAULT_HOST_SOURCE = '@agimon-ai/po/cordis-host';\n\nexport type PoCordisHostMode = 'composed' | 'standalone';\n\nexport interface PoCordisRuntimeService {\n  readonly abiVersion: typeof PO_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly generation: string;\n  readonly mode: PoCordisHostMode;\n}\n\nexport interface PoCordisSessionService {\n  readonly sessionId: string;\n  readonly generation: string;\n  readonly reason: SessionStartEvent['reason'];\n  readonly context: ExtensionContext;\n  /** This session's admitted environment: its own in a server, the process's in a terminal. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n}\n\ntype SessionEnvironment = Readonly<Record<string, string | undefined>>;\n\n/**\n * Admitted environments of sessions sharing this process, by session id.\n *\n * A server runs many sessions' Pi extensions in one process, so `process.env` is\n * the server's, not any session's. Held on a global symbol because extension\n * packages can load their own copy of this module.\n */\nconst SESSION_ENVIRONMENTS: Map<string, { readonly environment: SessionEnvironment }> = ((\n  globalThis as Record<symbol, unknown>\n)[Symbol.for('po.cordis.session-environments.v1')] ??= new Map()) as Map<\n  string,\n  { readonly environment: SessionEnvironment }\n>;\n\n/**\n * Binds a session id to its admitted environment until the returned release runs.\n *\n * The newest registration wins: a reopened session can start before its previous host has\n * finished closing, and that late release must not unbind the new one.\n */\nexport function registerPoSessionEnvironment(sessionId: string, environment: SessionEnvironment): () => void {\n  const registration = { environment };\n  SESSION_ENVIRONMENTS.set(sessionId, registration);\n  return () => {\n    if (SESSION_ENVIRONMENTS.get(sessionId) === registration) SESSION_ENVIRONMENTS.delete(sessionId);\n  };\n}\n\n/** The session's admitted environment, or `process.env` for a session that owns its process. */\nexport function readPoSessionEnvironment(sessionId: string | undefined): SessionEnvironment {\n  return (sessionId === undefined ? undefined : SESSION_ENVIRONMENTS.get(sessionId)?.environment) ?? process.env;\n}\n\nexport function requirePoCordisSession(context: Context): PoCordisSessionService {\n  const session = context.get(PO_CORDIS_SESSION_SERVICE) as PoCordisSessionService | undefined;\n  if (!session) throw new Error('Po Cordis session service is unavailable.');\n  return session;\n}\n\nexport interface PoCordisHostConnection {\n  readonly root: Context;\n  readonly runtime: PoCordisRuntimeService;\n  /** Releases this consumer's lease. It never disposes a composed host. */\n  dispose(): Promise<void>;\n}\n\nexport interface PoCordisHostController {\n  readonly root: Context;\n  readonly runtime: PoCordisRuntimeService;\n  /** Recursively disposes the session and application plugin tree. */\n  shutdown(): Promise<void>;\n}\n\nexport interface InstallPoCordisHostOptions {\n  readonly mode: PoCordisHostMode;\n  readonly source?: string;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/runtime': PoCordisRuntimeService;\n    'po/session': PoCordisSessionService;\n  }\n}\n\ninterface HostQuery {\n  readonly protocol: typeof HOST_PROTOCOL;\n  readonly abiVersion: typeof PO_CORDIS_HOST_ABI_VERSION;\n  readonly kind: 'query';\n  readonly requestId: string;\n  readonly source: string;\n  readonly accept: (response: unknown) => void;\n}\n\ninterface HostResponder {\n  readonly protocol: typeof HOST_PROTOCOL;\n  readonly abiVersion: typeof PO_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly root: Context;\n  readonly runtime: PoCordisRuntimeService;\n  readonly ready: Promise<void>;\n  acquire(): PoCordisHostConnection;\n  shutdown(): Promise<void>;\n}\n\nfunction isRecord(value: unknown): value is Record<PropertyKey, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction asHostQuery(value: unknown): HostQuery | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.protocol !== HOST_PROTOCOL ||\n    value.abiVersion !== PO_CORDIS_HOST_ABI_VERSION ||\n    value.kind !== 'query' ||\n    typeof value.requestId !== 'string' ||\n    value.requestId.length === 0 ||\n    typeof value.source !== 'string' ||\n    value.source.length === 0 ||\n    typeof value.accept !== 'function'\n  ) {\n    return undefined;\n  }\n  return value as unknown as HostQuery;\n}\n\nfunction asHostResponder(value: unknown): HostResponder {\n  if (!isRecord(value)) throw new Error('The Po Cordis host returned an invalid discovery response.');\n  if (value.protocol !== HOST_PROTOCOL) {\n    throw new Error('The Po Cordis host returned an invalid protocol identifier.');\n  }\n  if (value.abiVersion !== PO_CORDIS_HOST_ABI_VERSION) {\n    throw new Error(\n      `The Po Cordis host ABI is incompatible: expected ${String(PO_CORDIS_HOST_ABI_VERSION)}, received ${String(value.abiVersion)}.`,\n    );\n  }\n  if (typeof value.hostId !== 'string' || value.hostId.length === 0) {\n    throw new Error('The Po Cordis host returned an invalid host identifier.');\n  }\n  if (!Context.is(value.root)) {\n    throw new Error('The Po Cordis host returned a value that is not a Cordis Context.');\n  }\n  if (\n    !isRecord(value.runtime) ||\n    value.runtime.abiVersion !== PO_CORDIS_HOST_ABI_VERSION ||\n    value.runtime.hostId !== value.hostId ||\n    typeof value.acquire !== 'function' ||\n    typeof value.shutdown !== 'function' ||\n    !isRecord(value.ready) ||\n    typeof value.ready.then !== 'function'\n  ) {\n    throw new Error('The Po Cordis host returned incomplete runtime metadata.');\n  }\n  return value as unknown as HostResponder;\n}\n\nfunction discoverHosts(pi: Pick<ExtensionAPI, 'events'>, source: string): HostResponder[] {\n  const responses: HostResponder[] = [];\n  const request: HostQuery = {\n    protocol: HOST_PROTOCOL,\n    abiVersion: PO_CORDIS_HOST_ABI_VERSION,\n    kind: 'query',\n    requestId: `${source}:${crypto.randomUUID()}`,\n    source,\n    accept(response) {\n      responses.push(asHostResponder(response));\n    },\n  };\n  pi.events.emit(PO_CORDIS_HOST_QUERY_CHANNEL, request);\n  return responses;\n}\n\nfunction exactlyOneHost(responses: readonly HostResponder[], source: string): HostResponder | undefined {\n  if (responses.length <= 1) return responses[0];\n  const hostIds = responses.map(({ hostId }) => hostId).join(', ');\n  throw new Error(`Multiple Po Cordis hosts answered ${source}: ${hostIds}.`);\n}\n\nfunction runtimeProvider(ctx: Context, service: PoCordisRuntimeService): void {\n  ctx.provide(PO_CORDIS_RUNTIME_SERVICE, service);\n  ctx.provide(PO_TOOL_OVERRIDES_SERVICE, createPoToolOverridesService(service.generation));\n}\n\nfunction sessionProvider(ctx: Context, service: PoCordisSessionService, pi: ExtensionAPI): void {\n  ctx.provide(PO_CORDIS_SESSION_SERVICE, service);\n  ctx.provide(PO_CONTEXT_CONTRIBUTIONS_SERVICE, createPoContextContributionsService(service.generation));\n  ctx.provide(\n    PO_TOOL_SURFACE_SERVICE,\n    createPoToolSurface({\n      generation: service.generation,\n      allTools: () => pi.getAllTools().map((tool) => tool.name),\n      activeTools: () => pi.getActiveTools(),\n      setActiveTools: (names) => pi.setActiveTools(names),\n    }),\n  );\n}\n\n/**\n * Installs the sole Cordis application root for one Pi extension runner.\n *\n * The versioned EventBus query is intentional: Pi may hand independently\n * loaded factories different ExtensionAPI wrapper objects, while their event\n * buses still address the same runner.\n */\nexport async function installPoCordisHost(\n  pi: ExtensionAPI,\n  options: InstallPoCordisHostOptions,\n): Promise<PoCordisHostController> {\n  const source = options.source ?? DEFAULT_HOST_SOURCE;\n  const existing = exactlyOneHost(discoverHosts(pi, source), source);\n  if (existing) throw new Error(`A Po Cordis host is already installed: ${existing.hostId}.`);\n\n  // This is the one intentional Context constructor for Po extension code.\n  const root = new Context();\n  const runtime: PoCordisRuntimeService = Object.freeze({\n    abiVersion: PO_CORDIS_HOST_ABI_VERSION,\n    hostId: `po-cordis:${crypto.randomUUID()}`,\n    generation: `po-runtime:${crypto.randomUUID()}`,\n    mode: options.mode,\n  });\n  const runtimeFiber = root.plugin(runtimeProvider, runtime);\n  const ready = runtimeFiber.await().then(() => undefined);\n  let sessionFiber: Fiber | undefined;\n  let sessionGeneration = 0;\n  let sessionQueue = Promise.resolve();\n  let leaseCount = 0;\n  let shutdownPromise: Promise<void> | undefined;\n  let responder: HostResponder;\n  let disposeQuerySubscription = (): void => undefined;\n\n  const controller: PoCordisHostController = {\n    root,\n    runtime,\n    shutdown() {\n      shutdownPromise ??= (async () => {\n        disposeQuerySubscription();\n        await ready.catch(() => undefined);\n        await sessionQueue.catch(() => undefined);\n        await sessionFiber?.dispose();\n        sessionFiber = undefined;\n        await root.fiber.dispose();\n      })();\n      return shutdownPromise;\n    },\n  };\n\n  responder = {\n    protocol: HOST_PROTOCOL,\n    abiVersion: PO_CORDIS_HOST_ABI_VERSION,\n    hostId: runtime.hostId,\n    root,\n    runtime,\n    ready,\n    acquire() {\n      if (shutdownPromise) throw new Error(`The Po Cordis host is shutting down: ${runtime.hostId}.`);\n      leaseCount += 1;\n      let released = false;\n      return {\n        root,\n        runtime,\n        async dispose() {\n          if (released) return;\n          released = true;\n          leaseCount -= 1;\n          if (options.mode === 'standalone' && leaseCount === 0) await controller.shutdown();\n        },\n      };\n    },\n    shutdown: () => controller.shutdown(),\n  };\n  try {\n    disposeQuerySubscription = pi.events.on(PO_CORDIS_HOST_QUERY_CHANNEL, (value) => {\n      const query = asHostQuery(value);\n      if (query) query.accept(responder);\n    });\n    pi.on('session_start', (event, context) => {\n      sessionQueue = sessionQueue\n        .catch(() => undefined)\n        .then(async () => {\n          // Pi owns its listener table and can retain this callback across a\n          // replacement. A start delivered after finalization belongs to the\n          // stale graph and must not revive or fail the next one.\n          if (shutdownPromise) return;\n          await sessionFiber?.dispose();\n          sessionGeneration += 1;\n          const service: PoCordisSessionService = Object.freeze({\n            sessionId: context.sessionManager.getSessionId(),\n            generation: `${runtime.generation}:${String(sessionGeneration)}`,\n            reason: event.reason,\n            context,\n            environment: readPoSessionEnvironment(context.sessionManager.getSessionId()),\n          });\n          sessionFiber = root.plugin((ctx: Context, value: PoCordisSessionService) => {\n            sessionProvider(ctx, value, pi);\n          }, service);\n          await sessionFiber.await();\n        });\n      return sessionQueue;\n    });\n    if (options.mode === 'standalone') {\n      pi.on('session_shutdown', () => {\n        disposeQuerySubscription();\n      });\n    }\n    await ready;\n  } catch (error) {\n    await controller.shutdown();\n    throw error;\n  }\n  return controller;\n}\n\n/** Resolves the composed host installed by the canonical runtime. */\nexport function connectPoCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<PoCordisHostConnection>;\nexport function connectPoCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n  options: { readonly optional: true },\n): Promise<PoCordisHostConnection | undefined>;\nexport async function connectPoCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n  options?: { readonly optional: true },\n): Promise<PoCordisHostConnection | undefined> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  if (!responder) {\n    // Vanilla Pi plugins do not install a Po host. Optional discovery permits only\n    // that absence, never an invalid or ambiguous responder.\n    if (options?.optional) return undefined;\n    throw new Error('The composed Po Cordis host is unavailable. Ensure cordisHost is the first extension.');\n  }\n  await responder.ready;\n  return responder.acquire();\n}\n\n/** Ends the host discovered on this runner. Repeated finalization is a no-op. */\nexport async function finalizePoCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<void> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  await responder?.shutdown();\n}\n"],"mappings":"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"}

package/dist/runtimeIdentity.cjs

@@ -1,26 +1,23 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_sync = require("./src/services/runtimeIdentity/sync.cjs");
 let node_crypto = require("node:crypto");
-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/services/runtimeIdentity/index.ts
 /** Canonical on-disk identity used for activation deduplication and fingerprints. */
-function canonicalModulePath(target) {
+async function canonicalModulePathAsync(fs, target, context) {
 	const absolute = node_path.default.resolve(target);
-	let resolved = absolute;
-	try {
-		resolved = node_fs.default.realpathSync.native(absolute);
-	} catch {}
-	return resolved.split(node_path.default.sep).join("/");
+	const resolved = await fs.canonicalPath(absolute, context);
+	return (resolved.ok ? resolved.value : absolute).split(node_path.default.sep).join("/");
 }
 /** Stable SHA-256 digest for a canonically serialized runtime identity. */
 function sha256(value) {
 	return (0, node_crypto.createHash)("sha256").update(value).digest("hex");
 }
 //#endregion
-exports.canonicalModulePath = canonicalModulePath;
+exports.canonicalModulePath = require_sync.canonicalModulePath;
+exports.canonicalModulePathAsync = canonicalModulePathAsync;
 exports.sha256 = sha256;
 
 //# sourceMappingURL=runtimeIdentity.cjs.map

package/dist/runtimeIdentity.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeIdentity.cjs","names":["path","fs","createHash"],"sources":["../src/services/runtimeIdentity/index.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\n/** Canonical on-disk identity used for activation deduplication and fingerprints. */\nexport function canonicalModulePath(target: string): string {\n  const absolute = path.resolve(target);\n  let resolved = absolute;\n  try {\n    resolved = fs.realpathSync.native(absolute);\n  } catch {\n    // Missing synthetic/test paths still receive an absolute normalized identity.\n  }\n  return resolved.split(path.sep).join('/');\n}\n\n/** Stable SHA-256 digest for a canonically serialized runtime identity. */\nexport function sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n"],"mappings":";;;;;;;;;AAKA,SAAgB,oBAAoB,QAAwB;CAC1D,MAAM,WAAWA,UAAAA,QAAK,QAAQ,MAAM;CACpC,IAAI,WAAW;CACf,IAAI;EACF,WAAWC,QAAAA,QAAG,aAAa,OAAO,QAAQ;CAC5C,QAAQ,CAER;CACA,OAAO,SAAS,MAAMD,UAAAA,QAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC1C;;AAGA,SAAgB,OAAO,OAAuB;CAC5C,QAAA,GAAOE,YAAAA,WAAAA,CAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;AACxD"}
+{"version":3,"file":"runtimeIdentity.cjs","names":["path","createHash"],"sources":["../src/services/runtimeIdentity/index.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport type { FileSystem } from '@earendil-works/pi-durable/env';\n\nexport { canonicalModulePath } from './sync';\n\n/** Canonical on-disk identity used for activation deduplication and fingerprints. */\nexport async function canonicalModulePathAsync(fs: FileSystem, target: string, context: Context): Promise<string> {\n  const absolute = path.resolve(target);\n  const resolved = await fs.canonicalPath(absolute, context);\n  // Missing synthetic/test paths still receive an absolute normalized identity.\n  return (resolved.ok ? resolved.value : absolute).split(path.sep).join('/');\n}\n\n/** Stable SHA-256 digest for a canonically serialized runtime identity. */\nexport function sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n"],"mappings":";;;;;;;;AASA,eAAsB,yBAAyB,IAAgB,QAAgB,SAAmC;CAChH,MAAM,WAAWA,UAAAA,QAAK,QAAQ,MAAM;CACpC,MAAM,WAAW,MAAM,GAAG,cAAc,UAAU,OAAO;CAEzD,QAAQ,SAAS,KAAK,SAAS,QAAQ,SAAA,CAAU,MAAMA,UAAAA,QAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC3E;;AAGA,SAAgB,OAAO,OAAuB;CAC5C,QAAA,GAAOC,YAAAA,WAAAA,CAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;AACxD"}

package/dist/runtimeIdentity.d.mts

@@ -1,7 +1,11 @@
+import { canonicalModulePath } from "./src/services/runtimeIdentity/sync.mjs";
+import { FileSystem } from "@earendil-works/pi-durable/env";
+import { Context } from "@earendil-works/chord";
 //#region src/services/runtimeIdentity/index.d.ts
 /** Canonical on-disk identity used for activation deduplication and fingerprints. */
-export declare function canonicalModulePath(target: string): string;
+export declare function canonicalModulePathAsync(fs: FileSystem, target: string, context: Context): Promise<string>;
 /** Stable SHA-256 digest for a canonically serialized runtime identity. */
 export declare function sha256(value: string): string;
 //#endregion
+export { canonicalModulePath };
 //# sourceMappingURL=runtimeIdentity.d.mts.map

package/dist/runtimeIdentity.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeIdentity.d.mts","names":[],"sources":["../src/services/runtimeIdentity/index.ts"],"mappings":";;wBAKgB,oBAAoB;;wBAYpB,OAAO"}
+{"version":3,"file":"runtimeIdentity.d.mts","names":[],"sources":["../src/services/runtimeIdentity/index.ts"],"mappings":";;;;;wBASsB,yBAAyB,IAAI,YAAY,gBAAgB,SAAS,UAAU;;wBAQlF,OAAO"}

package/dist/runtimeIdentity.mjs

@@ -1,21 +1,18 @@
+import { canonicalModulePath } from "./src/services/runtimeIdentity/sync.mjs";
 import { createHash } from "node:crypto";
-import fs from "node:fs";
 import path from "node:path";
 //#region src/services/runtimeIdentity/index.ts
 /** Canonical on-disk identity used for activation deduplication and fingerprints. */
-function canonicalModulePath(target) {
+async function canonicalModulePathAsync(fs, target, context) {
 	const absolute = path.resolve(target);
-	let resolved = absolute;
-	try {
-		resolved = fs.realpathSync.native(absolute);
-	} catch {}
-	return resolved.split(path.sep).join("/");
+	const resolved = await fs.canonicalPath(absolute, context);
+	return (resolved.ok ? resolved.value : absolute).split(path.sep).join("/");
 }
 /** Stable SHA-256 digest for a canonically serialized runtime identity. */
 function sha256(value) {
 	return createHash("sha256").update(value).digest("hex");
 }
 //#endregion
-export { canonicalModulePath, sha256 };
+export { canonicalModulePath, canonicalModulePathAsync, sha256 };
 
 //# sourceMappingURL=runtimeIdentity.mjs.map

package/dist/runtimeIdentity.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeIdentity.mjs","names":[],"sources":["../src/services/runtimeIdentity/index.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\n/** Canonical on-disk identity used for activation deduplication and fingerprints. */\nexport function canonicalModulePath(target: string): string {\n  const absolute = path.resolve(target);\n  let resolved = absolute;\n  try {\n    resolved = fs.realpathSync.native(absolute);\n  } catch {\n    // Missing synthetic/test paths still receive an absolute normalized identity.\n  }\n  return resolved.split(path.sep).join('/');\n}\n\n/** Stable SHA-256 digest for a canonically serialized runtime identity. */\nexport function sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n"],"mappings":";;;;;AAKA,SAAgB,oBAAoB,QAAwB;CAC1D,MAAM,WAAW,KAAK,QAAQ,MAAM;CACpC,IAAI,WAAW;CACf,IAAI;EACF,WAAW,GAAG,aAAa,OAAO,QAAQ;CAC5C,QAAQ,CAER;CACA,OAAO,SAAS,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC1C;;AAGA,SAAgB,OAAO,OAAuB;CAC5C,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;AACxD"}
+{"version":3,"file":"runtimeIdentity.mjs","names":[],"sources":["../src/services/runtimeIdentity/index.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport type { FileSystem } from '@earendil-works/pi-durable/env';\n\nexport { canonicalModulePath } from './sync';\n\n/** Canonical on-disk identity used for activation deduplication and fingerprints. */\nexport async function canonicalModulePathAsync(fs: FileSystem, target: string, context: Context): Promise<string> {\n  const absolute = path.resolve(target);\n  const resolved = await fs.canonicalPath(absolute, context);\n  // Missing synthetic/test paths still receive an absolute normalized identity.\n  return (resolved.ok ? resolved.value : absolute).split(path.sep).join('/');\n}\n\n/** Stable SHA-256 digest for a canonically serialized runtime identity. */\nexport function sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n"],"mappings":";;;;;AASA,eAAsB,yBAAyB,IAAgB,QAAgB,SAAmC;CAChH,MAAM,WAAW,KAAK,QAAQ,MAAM;CACpC,MAAM,WAAW,MAAM,GAAG,cAAc,UAAU,OAAO;CAEzD,QAAQ,SAAS,KAAK,SAAS,QAAQ,SAAA,CAAU,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC3E;;AAGA,SAAgB,OAAO,OAAuB;CAC5C,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;AACxD"}

package/dist/runtimeJson.cjs

@@ -1,46 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
-let node_crypto = require("node:crypto");
-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/services/json/index.ts
-const ATOMIC_FILE_SUFFIX = ".tmp";
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** Reads a JSON object, treating a missing or empty file as the fallback. */
-function readJson(filePath, fallback = {}) {
-	if (!node_fs.default.existsSync(filePath)) return fallback;
-	const content = node_fs.default.readFileSync(filePath, "utf8").trim();
-	return content ? JSON.parse(content) : fallback;
-}
-/**
-* Writes through a uniquely named temporary file in the same directory.
-*
-* The pid and a UUID are both in the name so two harnesses writing the same
-* target cannot collide on the temporary path, and a failed write cleans up
-* after itself rather than leaving the fragment behind.
-*/
-function writeFileAtomic(filePath, content) {
-	node_fs.default.mkdirSync(node_path.default.dirname(filePath), { recursive: true });
-	const temporaryPath = `${filePath}.${process.pid}.${(0, node_crypto.randomUUID)()}${ATOMIC_FILE_SUFFIX}`;
-	try {
-		node_fs.default.writeFileSync(temporaryPath, content);
-		node_fs.default.renameSync(temporaryPath, filePath);
-	} catch (error) {
-		node_fs.default.rmSync(temporaryPath, { force: true });
-		throw error;
-	}
-}
-function writeJson(filePath, value) {
-	writeFileAtomic(filePath, `${JSON.stringify(value, null, 2)}\n`);
-}
-//#endregion
-exports.isRecord = isRecord;
-exports.readJson = readJson;
-exports.writeFileAtomic = writeFileAtomic;
-exports.writeJson = writeJson;
-
-//# sourceMappingURL=runtimeJson.cjs.map
+const require_core = require("./src/services/json/core.cjs");
+const require_sync = require("./src/services/json/sync.cjs");
+exports.isRecord = require_core.isRecord;
+exports.parseJsonObject = require_core.parseJsonObject;
+exports.readJson = require_sync.readJson;
+exports.readJsonAsync = require_core.readJsonAsync;
+exports.serializeJson = require_core.serializeJson;
+exports.writeFileAtomic = require_sync.writeFileAtomic;
+exports.writeJson = require_sync.writeJson;
+exports.writeJsonAsync = require_core.writeJsonAsync;

package/dist/runtimeJson.d.mts

@@ -1,22 +1,3 @@
-//#region src/services/json/index.d.ts
-/**
- * JSON state helpers for files the harness owns on disk.
- *
- * Compatibility frontends read these files while another repository's harness
- * may be writing them, so writes go through a rename rather than a truncate.
- */
-export type JsonObject = Record<string, unknown>;
-export declare function isRecord(value: unknown): value is JsonObject;
-/** Reads a JSON object, treating a missing or empty file as the fallback. */
-export declare function readJson(filePath: string, fallback?: JsonObject): JsonObject;
-/**
- * Writes through a uniquely named temporary file in the same directory.
- *
- * The pid and a UUID are both in the name so two harnesses writing the same
- * target cannot collide on the temporary path, and a failed write cleans up
- * after itself rather than leaving the fragment behind.
- */
-export declare function writeFileAtomic(filePath: string, content: string): void;
-export declare function writeJson(filePath: string, value: JsonObject): void;
-//#endregion
-//# sourceMappingURL=runtimeJson.d.mts.map
+import { JsonObject, isRecord, parseJsonObject, readJsonAsync, serializeJson, writeJsonAsync } from "./src/services/json/core.mjs";
+import { readJson, writeFileAtomic, writeJson } from "./src/services/json/sync.mjs";
+export { JsonObject, isRecord, parseJsonObject, readJson, readJsonAsync, serializeJson, writeFileAtomic, writeJson, writeJsonAsync };

package/dist/runtimeJson.mjs

@@ -1,39 +1,3 @@
-import { randomUUID } from "node:crypto";
-import fs from "node:fs";
-import path from "node:path";
-//#region src/services/json/index.ts
-const ATOMIC_FILE_SUFFIX = ".tmp";
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** Reads a JSON object, treating a missing or empty file as the fallback. */
-function readJson(filePath, fallback = {}) {
-	if (!fs.existsSync(filePath)) return fallback;
-	const content = fs.readFileSync(filePath, "utf8").trim();
-	return content ? JSON.parse(content) : fallback;
-}
-/**
-* Writes through a uniquely named temporary file in the same directory.
-*
-* The pid and a UUID are both in the name so two harnesses writing the same
-* target cannot collide on the temporary path, and a failed write cleans up
-* after itself rather than leaving the fragment behind.
-*/
-function writeFileAtomic(filePath, content) {
-	fs.mkdirSync(path.dirname(filePath), { recursive: true });
-	const temporaryPath = `${filePath}.${process.pid}.${randomUUID()}${ATOMIC_FILE_SUFFIX}`;
-	try {
-		fs.writeFileSync(temporaryPath, content);
-		fs.renameSync(temporaryPath, filePath);
-	} catch (error) {
-		fs.rmSync(temporaryPath, { force: true });
-		throw error;
-	}
-}
-function writeJson(filePath, value) {
-	writeFileAtomic(filePath, `${JSON.stringify(value, null, 2)}\n`);
-}
-//#endregion
-export { isRecord, readJson, writeFileAtomic, writeJson };
-
-//# sourceMappingURL=runtimeJson.mjs.map
+import { isRecord, parseJsonObject, readJsonAsync, serializeJson, writeJsonAsync } from "./src/services/json/core.mjs";
+import { readJson, writeFileAtomic, writeJson } from "./src/services/json/sync.mjs";
+export { isRecord, parseJsonObject, readJson, readJsonAsync, serializeJson, writeFileAtomic, writeJson, writeJsonAsync };

package/dist/runtimeLogSinkTelemetry.cjs

@@ -4,30 +4,30 @@ const MAX_PENDING_EVENTS = 64;
 const SERVICE_NAME = "po";
 const PACKAGE_NAME = "@agimon-ai/po";
 const HARNESS_EVENT = {
-	cliFailed: "doom_pi.cli_failed",
-	contextBuildFailed: "doom_pi.context_build_failed",
-	resourceCollectionFailed: "doom_pi.resource_collection_failed",
-	configLoadFailed: "doom_pi.config_load_failed",
-	launchFailed: "doom_pi.launch_failed",
-	compatibilityLaunchFailed: "doom_pi.compatibility_launch_failed",
-	harnessStateParseFailed: "doom_pi.harness_state_parse_failed",
-	hookFailed: "doom_pi.hook_failed",
-	hookRegistryReadFailed: "doom_pi.hook_registry_read_failed",
-	personaReadFailed: "doom_pi.persona_read_failed",
-	styleSystemRenderFailed: "doom_pi.style_system_render_failed",
-	majorModeUnavailable: "doom_pi.major_mode_unavailable",
-	profileLoadFailed: "doom_pi.profile_load_failed",
-	launchCompleted: "doom_pi.launch_completed",
-	projectTrustResolved: "doom_pi.project_trust_resolved",
-	majorModeSwitched: "doom_pi.major_mode_switched",
-	profileApplied: "doom_pi.profile_applied"
+	cliFailed: "po_pi.cli_failed",
+	contextBuildFailed: "po_pi.context_build_failed",
+	resourceCollectionFailed: "po_pi.resource_collection_failed",
+	configLoadFailed: "po_pi.config_load_failed",
+	launchFailed: "po_pi.launch_failed",
+	compatibilityLaunchFailed: "po_pi.compatibility_launch_failed",
+	harnessStateParseFailed: "po_pi.harness_state_parse_failed",
+	hookFailed: "po_pi.hook_failed",
+	hookRegistryReadFailed: "po_pi.hook_registry_read_failed",
+	personaReadFailed: "po_pi.persona_read_failed",
+	styleSystemRenderFailed: "po_pi.style_system_render_failed",
+	majorModeUnavailable: "po_pi.major_mode_unavailable",
+	profileLoadFailed: "po_pi.profile_load_failed",
+	launchCompleted: "po_pi.launch_completed",
+	projectTrustResolved: "po_pi.project_trust_resolved",
+	majorModeSwitched: "po_pi.major_mode_switched",
+	profileApplied: "po_pi.profile_applied"
 };
 function createHarnessTelemetry(options = {}) {
 	let telemetryPromise;
 	const pendingEvents = [];
 	let pendingEventDropReported = false;
 	const telemetry = () => {
-		telemetryPromise ??= import("@agimon-ai/po-telemetry").then(({ createDoomTelemetry }) => createDoomTelemetry({
+		telemetryPromise ??= import("@agimon-ai/po-telemetry").then(({ createPoTelemetry }) => createPoTelemetry({
 			serviceName: SERVICE_NAME,
 			packageName: PACKAGE_NAME,
 			cwd: options.cwd,
@@ -63,7 +63,7 @@ function createHarnessTelemetry(options = {}) {
 				else if (!pendingEventDropReported) {
 					pendingEventDropReported = true;
 					try {
-						(options.warn ?? ((message) => process.emitWarning(message)))("Doom telemetry deferred event limit reached; later events were dropped.");
+						(options.warn ?? ((message) => process.emitWarning(message)))("Po telemetry deferred event limit reached; later events were dropped.");
 					} catch {}
 				}
 				return;

package/dist/runtimeLogSinkTelemetry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeLogSinkTelemetry.cjs","names":[],"sources":["../src/services/logSinkTelemetry/index.ts"],"sourcesContent":["import type { DoomTelemetry, DoomTelemetryOptions } from '@agimon-ai/po-telemetry';\n\nconst MAX_PENDING_EVENTS = 64;\nconst SERVICE_NAME = 'po';\nconst PACKAGE_NAME = '@agimon-ai/po';\n\nexport const HARNESS_EVENT = {\n  cliFailed: 'doom_pi.cli_failed',\n  contextBuildFailed: 'doom_pi.context_build_failed',\n  resourceCollectionFailed: 'doom_pi.resource_collection_failed',\n  configLoadFailed: 'doom_pi.config_load_failed',\n  launchFailed: 'doom_pi.launch_failed',\n  compatibilityLaunchFailed: 'doom_pi.compatibility_launch_failed',\n  harnessStateParseFailed: 'doom_pi.harness_state_parse_failed',\n  hookFailed: 'doom_pi.hook_failed',\n  hookRegistryReadFailed: 'doom_pi.hook_registry_read_failed',\n  personaReadFailed: 'doom_pi.persona_read_failed',\n  styleSystemRenderFailed: 'doom_pi.style_system_render_failed',\n  majorModeUnavailable: 'doom_pi.major_mode_unavailable',\n  profileLoadFailed: 'doom_pi.profile_load_failed',\n  launchCompleted: 'doom_pi.launch_completed',\n  projectTrustResolved: 'doom_pi.project_trust_resolved',\n  majorModeSwitched: 'doom_pi.major_mode_switched',\n  profileApplied: 'doom_pi.profile_applied',\n} as const;\n\nexport type HarnessEventName = (typeof HARNESS_EVENT)[keyof typeof HARNESS_EVENT];\nexport type HarnessEventAttributes = Record<string, string | number | boolean>;\nexport type HarnessErrorSink = (event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes) => void;\n\nexport interface HarnessFailureReporter {\n  error: HarnessErrorSink;\n  warn: HarnessErrorSink;\n}\n\nexport interface HarnessTelemetryOptions {\n  cwd?: string;\n  workspaceRoot?: string;\n  env?: NodeJS.ProcessEnv;\n  telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;\n  warn?: (message: string) => void;\n  /** Run startup callbacks before loading the telemetry backend. */\n  deferSpans?: boolean;\n}\n\nexport interface HarnessTelemetry {\n  recordError(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordWarning(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordEvent(event: HarnessEventName, attributes?: HarnessEventAttributes): Promise<void>;\n  runInSpan<T>(name: string, attributes: HarnessEventAttributes, callback: () => Promise<T>): Promise<T>;\n  flush(): Promise<void>;\n  shutdown(): Promise<void>;\n}\n\nexport function createHarnessTelemetry(options: HarnessTelemetryOptions = {}): HarnessTelemetry {\n  let telemetryPromise: Promise<DoomTelemetry> | undefined;\n  const pendingEvents: Array<{ event: HarnessEventName; attributes?: HarnessEventAttributes }> = [];\n  let pendingEventDropReported = false;\n  const telemetry = (): Promise<DoomTelemetry> => {\n    telemetryPromise ??= import('@agimon-ai/po-telemetry').then(({ createDoomTelemetry }) =>\n      createDoomTelemetry({\n        serviceName: SERVICE_NAME,\n        packageName: PACKAGE_NAME,\n        cwd: options.cwd,\n        workspaceRoot: options.workspaceRoot,\n        env: options.env,\n        telemetryFactory: options.telemetryFactory,\n        warn: options.warn,\n        enableLogs: true,\n        enableTraces: true,\n      }),\n    );\n    return telemetryPromise;\n  };\n  const drainEvents = async (loaded: DoomTelemetry): Promise<void> => {\n    for (const pending of pendingEvents.splice(0)) {\n      await loaded.recordEvent(pending.event, pending.attributes);\n    }\n  };\n  return {\n    recordError: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordError(event, error, attributes);\n    },\n    recordWarning: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordWarning(event, error, attributes);\n    },\n    recordEvent: async (event, attributes) => {\n      if (options.deferSpans && !telemetryPromise) {\n        if (pendingEvents.length < MAX_PENDING_EVENTS) pendingEvents.push({ event, attributes });\n        else if (!pendingEventDropReported) {\n          pendingEventDropReported = true;\n          try {\n            const reportWarning = options.warn ?? ((message: string) => process.emitWarning(message));\n            reportWarning('Doom telemetry deferred event limit reached; later events were dropped.');\n          } catch {\n            // Telemetry warnings must not interrupt launcher startup.\n          }\n        }\n        return;\n      }\n      await (await telemetry()).recordEvent(event, attributes);\n    },\n    runInSpan: (name, attributes, callback) => {\n      // The launcher opts into this path for pre-spawn preparation. Lifecycle\n      // events remain buffered until flush; failures still initialize the real\n      // sink immediately so diagnostics are not lost.\n      if (options.deferSpans && !telemetryPromise) return callback();\n      return telemetry().then((loaded) => loaded.runInSpan(name, attributes, callback));\n    },\n    flush: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.flush();\n    },\n    shutdown: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.shutdown();\n    },\n  };\n}\n\nexport function toFailureReporter(telemetry: HarnessTelemetry): HarnessFailureReporter {\n  return {\n    error: (event, error, attributes) => void telemetry.recordError(event, error, attributes),\n    warn: (event, error, attributes) => void telemetry.recordWarning(event, error, attributes),\n  };\n}\n"],"mappings":";;AAEA,MAAM,qBAAqB;AAC3B,MAAM,eAAe;AACrB,MAAM,eAAe;AAErB,MAAa,gBAAgB;CAC3B,WAAW;CACX,oBAAoB;CACpB,0BAA0B;CAC1B,kBAAkB;CAClB,cAAc;CACd,2BAA2B;CAC3B,yBAAyB;CACzB,YAAY;CACZ,wBAAwB;CACxB,mBAAmB;CACnB,yBAAyB;CACzB,sBAAsB;CACtB,mBAAmB;CACnB,iBAAiB;CACjB,sBAAsB;CACtB,mBAAmB;CACnB,gBAAgB;AAClB;AA8BA,SAAgB,uBAAuB,UAAmC,CAAC,GAAqB;CAC9F,IAAI;CACJ,MAAM,gBAAyF,CAAC;CAChG,IAAI,2BAA2B;CAC/B,MAAM,kBAA0C;EAC9C,qBAAqB,OAAO,0BAA0B,CAAC,MAAM,EAAE,0BAC7D,oBAAoB;GAClB,aAAa;GACb,aAAa;GACb,KAAK,QAAQ;GACb,eAAe,QAAQ;GACvB,KAAK,QAAQ;GACb,kBAAkB,QAAQ;GAC1B,MAAM,QAAQ;GACd,YAAY;GACZ,cAAc;EAChB,CAAC,CACH;EACA,OAAO;CACT;CACA,MAAM,cAAc,OAAO,WAAyC;EAClE,KAAK,MAAM,WAAW,cAAc,OAAO,CAAC,GAC1C,MAAM,OAAO,YAAY,QAAQ,OAAO,QAAQ,UAAU;CAE9D;CACA,OAAO;EACL,aAAa,OAAO,OAAO,OAAO,eAAe;GAC/C,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,YAAY,OAAO,OAAO,UAAU;EACnD;EACA,eAAe,OAAO,OAAO,OAAO,eAAe;GACjD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,cAAc,OAAO,OAAO,UAAU;EACrD;EACA,aAAa,OAAO,OAAO,eAAe;GACxC,IAAI,QAAQ,cAAc,CAAC,kBAAkB;IAC3C,IAAI,cAAc,SAAS,oBAAoB,cAAc,KAAK;KAAE;KAAO;IAAW,CAAC;SAClF,IAAI,CAAC,0BAA0B;KAClC,2BAA2B;KAC3B,IAAI;MAEF,CADsB,QAAQ,UAAU,YAAoB,QAAQ,YAAY,OAAO,GAAA,CACzE,yEAAyE;KACzF,QAAQ,CAER;IACF;IACA;GACF;GACA,OAAO,MAAM,UAAU,EAAA,CAAG,YAAY,OAAO,UAAU;EACzD;EACA,YAAY,MAAM,YAAY,aAAa;GAIzC,IAAI,QAAQ,cAAc,CAAC,kBAAkB,OAAO,SAAS;GAC7D,OAAO,UAAU,CAAC,CAAC,MAAM,WAAW,OAAO,UAAU,MAAM,YAAY,QAAQ,CAAC;EAClF;EACA,OAAO,YAAY;GACjB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,MAAM;EACrB;EACA,UAAU,YAAY;GACpB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,SAAS;EACxB;CACF;AACF;AAEA,SAAgB,kBAAkB,WAAqD;CACrF,OAAO;EACL,QAAQ,OAAO,OAAO,eAAe,KAAK,UAAU,YAAY,OAAO,OAAO,UAAU;EACxF,OAAO,OAAO,OAAO,eAAe,KAAK,UAAU,cAAc,OAAO,OAAO,UAAU;CAC3F;AACF"}
+{"version":3,"file":"runtimeLogSinkTelemetry.cjs","names":[],"sources":["../src/services/logSinkTelemetry/index.ts"],"sourcesContent":["import type { PoTelemetry, PoTelemetryOptions } from '@agimon-ai/po-telemetry';\n\nconst MAX_PENDING_EVENTS = 64;\nconst SERVICE_NAME = 'po';\nconst PACKAGE_NAME = '@agimon-ai/po';\n\nexport const HARNESS_EVENT = {\n  cliFailed: 'po_pi.cli_failed',\n  contextBuildFailed: 'po_pi.context_build_failed',\n  resourceCollectionFailed: 'po_pi.resource_collection_failed',\n  configLoadFailed: 'po_pi.config_load_failed',\n  launchFailed: 'po_pi.launch_failed',\n  compatibilityLaunchFailed: 'po_pi.compatibility_launch_failed',\n  harnessStateParseFailed: 'po_pi.harness_state_parse_failed',\n  hookFailed: 'po_pi.hook_failed',\n  hookRegistryReadFailed: 'po_pi.hook_registry_read_failed',\n  personaReadFailed: 'po_pi.persona_read_failed',\n  styleSystemRenderFailed: 'po_pi.style_system_render_failed',\n  majorModeUnavailable: 'po_pi.major_mode_unavailable',\n  profileLoadFailed: 'po_pi.profile_load_failed',\n  launchCompleted: 'po_pi.launch_completed',\n  projectTrustResolved: 'po_pi.project_trust_resolved',\n  majorModeSwitched: 'po_pi.major_mode_switched',\n  profileApplied: 'po_pi.profile_applied',\n} as const;\n\nexport type HarnessEventName = (typeof HARNESS_EVENT)[keyof typeof HARNESS_EVENT];\nexport type HarnessEventAttributes = Record<string, string | number | boolean>;\nexport type HarnessErrorSink = (event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes) => void;\n\nexport interface HarnessFailureReporter {\n  error: HarnessErrorSink;\n  warn: HarnessErrorSink;\n}\n\nexport interface HarnessTelemetryOptions {\n  cwd?: string;\n  workspaceRoot?: string;\n  env?: NodeJS.ProcessEnv;\n  telemetryFactory?: NonNullable<PoTelemetryOptions['telemetryFactory']>;\n  warn?: (message: string) => void;\n  /** Run startup callbacks before loading the telemetry backend. */\n  deferSpans?: boolean;\n}\n\nexport interface HarnessTelemetry {\n  recordError(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordWarning(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordEvent(event: HarnessEventName, attributes?: HarnessEventAttributes): Promise<void>;\n  runInSpan<T>(name: string, attributes: HarnessEventAttributes, callback: () => Promise<T>): Promise<T>;\n  flush(): Promise<void>;\n  shutdown(): Promise<void>;\n}\n\nexport function createHarnessTelemetry(options: HarnessTelemetryOptions = {}): HarnessTelemetry {\n  let telemetryPromise: Promise<PoTelemetry> | undefined;\n  const pendingEvents: Array<{ event: HarnessEventName; attributes?: HarnessEventAttributes }> = [];\n  let pendingEventDropReported = false;\n  const telemetry = (): Promise<PoTelemetry> => {\n    telemetryPromise ??= import('@agimon-ai/po-telemetry').then(({ createPoTelemetry }) =>\n      createPoTelemetry({\n        serviceName: SERVICE_NAME,\n        packageName: PACKAGE_NAME,\n        cwd: options.cwd,\n        workspaceRoot: options.workspaceRoot,\n        env: options.env,\n        telemetryFactory: options.telemetryFactory,\n        warn: options.warn,\n        enableLogs: true,\n        enableTraces: true,\n      }),\n    );\n    return telemetryPromise;\n  };\n  const drainEvents = async (loaded: PoTelemetry): Promise<void> => {\n    for (const pending of pendingEvents.splice(0)) {\n      await loaded.recordEvent(pending.event, pending.attributes);\n    }\n  };\n  return {\n    recordError: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordError(event, error, attributes);\n    },\n    recordWarning: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordWarning(event, error, attributes);\n    },\n    recordEvent: async (event, attributes) => {\n      if (options.deferSpans && !telemetryPromise) {\n        if (pendingEvents.length < MAX_PENDING_EVENTS) pendingEvents.push({ event, attributes });\n        else if (!pendingEventDropReported) {\n          pendingEventDropReported = true;\n          try {\n            const reportWarning = options.warn ?? ((message: string) => process.emitWarning(message));\n            reportWarning('Po telemetry deferred event limit reached; later events were dropped.');\n          } catch {\n            // Telemetry warnings must not interrupt launcher startup.\n          }\n        }\n        return;\n      }\n      await (await telemetry()).recordEvent(event, attributes);\n    },\n    runInSpan: (name, attributes, callback) => {\n      // The launcher opts into this path for pre-spawn preparation. Lifecycle\n      // events remain buffered until flush; failures still initialize the real\n      // sink immediately so diagnostics are not lost.\n      if (options.deferSpans && !telemetryPromise) return callback();\n      return telemetry().then((loaded) => loaded.runInSpan(name, attributes, callback));\n    },\n    flush: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.flush();\n    },\n    shutdown: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.shutdown();\n    },\n  };\n}\n\nexport function toFailureReporter(telemetry: HarnessTelemetry): HarnessFailureReporter {\n  return {\n    error: (event, error, attributes) => void telemetry.recordError(event, error, attributes),\n    warn: (event, error, attributes) => void telemetry.recordWarning(event, error, attributes),\n  };\n}\n"],"mappings":";;AAEA,MAAM,qBAAqB;AAC3B,MAAM,eAAe;AACrB,MAAM,eAAe;AAErB,MAAa,gBAAgB;CAC3B,WAAW;CACX,oBAAoB;CACpB,0BAA0B;CAC1B,kBAAkB;CAClB,cAAc;CACd,2BAA2B;CAC3B,yBAAyB;CACzB,YAAY;CACZ,wBAAwB;CACxB,mBAAmB;CACnB,yBAAyB;CACzB,sBAAsB;CACtB,mBAAmB;CACnB,iBAAiB;CACjB,sBAAsB;CACtB,mBAAmB;CACnB,gBAAgB;AAClB;AA8BA,SAAgB,uBAAuB,UAAmC,CAAC,GAAqB;CAC9F,IAAI;CACJ,MAAM,gBAAyF,CAAC;CAChG,IAAI,2BAA2B;CAC/B,MAAM,kBAAwC;EAC5C,qBAAqB,OAAO,0BAA0B,CAAC,MAAM,EAAE,wBAC7D,kBAAkB;GAChB,aAAa;GACb,aAAa;GACb,KAAK,QAAQ;GACb,eAAe,QAAQ;GACvB,KAAK,QAAQ;GACb,kBAAkB,QAAQ;GAC1B,MAAM,QAAQ;GACd,YAAY;GACZ,cAAc;EAChB,CAAC,CACH;EACA,OAAO;CACT;CACA,MAAM,cAAc,OAAO,WAAuC;EAChE,KAAK,MAAM,WAAW,cAAc,OAAO,CAAC,GAC1C,MAAM,OAAO,YAAY,QAAQ,OAAO,QAAQ,UAAU;CAE9D;CACA,OAAO;EACL,aAAa,OAAO,OAAO,OAAO,eAAe;GAC/C,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,YAAY,OAAO,OAAO,UAAU;EACnD;EACA,eAAe,OAAO,OAAO,OAAO,eAAe;GACjD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,cAAc,OAAO,OAAO,UAAU;EACrD;EACA,aAAa,OAAO,OAAO,eAAe;GACxC,IAAI,QAAQ,cAAc,CAAC,kBAAkB;IAC3C,IAAI,cAAc,SAAS,oBAAoB,cAAc,KAAK;KAAE;KAAO;IAAW,CAAC;SAClF,IAAI,CAAC,0BAA0B;KAClC,2BAA2B;KAC3B,IAAI;MAEF,CADsB,QAAQ,UAAU,YAAoB,QAAQ,YAAY,OAAO,GAAA,CACzE,uEAAuE;KACvF,QAAQ,CAER;IACF;IACA;GACF;GACA,OAAO,MAAM,UAAU,EAAA,CAAG,YAAY,OAAO,UAAU;EACzD;EACA,YAAY,MAAM,YAAY,aAAa;GAIzC,IAAI,QAAQ,cAAc,CAAC,kBAAkB,OAAO,SAAS;GAC7D,OAAO,UAAU,CAAC,CAAC,MAAM,WAAW,OAAO,UAAU,MAAM,YAAY,QAAQ,CAAC;EAClF;EACA,OAAO,YAAY;GACjB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,MAAM;EACrB;EACA,UAAU,YAAY;GACpB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,SAAS;EACxB;CACF;AACF;AAEA,SAAgB,kBAAkB,WAAqD;CACrF,OAAO;EACL,QAAQ,OAAO,OAAO,eAAe,KAAK,UAAU,YAAY,OAAO,OAAO,UAAU;EACxF,OAAO,OAAO,OAAO,eAAe,KAAK,UAAU,cAAc,OAAO,OAAO,UAAU;CAC3F;AACF"}

package/dist/runtimeLogSinkTelemetry.d.mts

@@ -1,23 +1,23 @@
-import { DoomTelemetryOptions } from "@agimon-ai/po-telemetry";
+import { PoTelemetryOptions } from "@agimon-ai/po-telemetry";
 //#region src/services/logSinkTelemetry/index.d.ts
 export declare const HARNESS_EVENT: {
-  readonly cliFailed: 'doom_pi.cli_failed';
-  readonly contextBuildFailed: 'doom_pi.context_build_failed';
-  readonly resourceCollectionFailed: 'doom_pi.resource_collection_failed';
-  readonly configLoadFailed: 'doom_pi.config_load_failed';
-  readonly launchFailed: 'doom_pi.launch_failed';
-  readonly compatibilityLaunchFailed: 'doom_pi.compatibility_launch_failed';
-  readonly harnessStateParseFailed: 'doom_pi.harness_state_parse_failed';
-  readonly hookFailed: 'doom_pi.hook_failed';
-  readonly hookRegistryReadFailed: 'doom_pi.hook_registry_read_failed';
-  readonly personaReadFailed: 'doom_pi.persona_read_failed';
-  readonly styleSystemRenderFailed: 'doom_pi.style_system_render_failed';
-  readonly majorModeUnavailable: 'doom_pi.major_mode_unavailable';
-  readonly profileLoadFailed: 'doom_pi.profile_load_failed';
-  readonly launchCompleted: 'doom_pi.launch_completed';
-  readonly projectTrustResolved: 'doom_pi.project_trust_resolved';
-  readonly majorModeSwitched: 'doom_pi.major_mode_switched';
-  readonly profileApplied: 'doom_pi.profile_applied';
+  readonly cliFailed: 'po_pi.cli_failed';
+  readonly contextBuildFailed: 'po_pi.context_build_failed';
+  readonly resourceCollectionFailed: 'po_pi.resource_collection_failed';
+  readonly configLoadFailed: 'po_pi.config_load_failed';
+  readonly launchFailed: 'po_pi.launch_failed';
+  readonly compatibilityLaunchFailed: 'po_pi.compatibility_launch_failed';
+  readonly harnessStateParseFailed: 'po_pi.harness_state_parse_failed';
+  readonly hookFailed: 'po_pi.hook_failed';
+  readonly hookRegistryReadFailed: 'po_pi.hook_registry_read_failed';
+  readonly personaReadFailed: 'po_pi.persona_read_failed';
+  readonly styleSystemRenderFailed: 'po_pi.style_system_render_failed';
+  readonly majorModeUnavailable: 'po_pi.major_mode_unavailable';
+  readonly profileLoadFailed: 'po_pi.profile_load_failed';
+  readonly launchCompleted: 'po_pi.launch_completed';
+  readonly projectTrustResolved: 'po_pi.project_trust_resolved';
+  readonly majorModeSwitched: 'po_pi.major_mode_switched';
+  readonly profileApplied: 'po_pi.profile_applied';
 };
 export type HarnessEventName = (typeof HARNESS_EVENT)[keyof typeof HARNESS_EVENT];
 export type HarnessEventAttributes = Record<string, string | number | boolean>;
@@ -30,7 +30,7 @@ export interface HarnessTelemetryOptions {
   cwd?: string;
   workspaceRoot?: string;
   env?: NodeJS.ProcessEnv;
-  telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;
+  telemetryFactory?: NonNullable<PoTelemetryOptions['telemetryFactory']>;
   warn?: (message: string) => void;
   /** Run startup callbacks before loading the telemetry backend. */
   deferSpans?: boolean;

package/dist/runtimeLogSinkTelemetry.mjs

@@ -3,30 +3,30 @@ const MAX_PENDING_EVENTS = 64;
 const SERVICE_NAME = "po";
 const PACKAGE_NAME = "@agimon-ai/po";
 const HARNESS_EVENT = {
-	cliFailed: "doom_pi.cli_failed",
-	contextBuildFailed: "doom_pi.context_build_failed",
-	resourceCollectionFailed: "doom_pi.resource_collection_failed",
-	configLoadFailed: "doom_pi.config_load_failed",
-	launchFailed: "doom_pi.launch_failed",
-	compatibilityLaunchFailed: "doom_pi.compatibility_launch_failed",
-	harnessStateParseFailed: "doom_pi.harness_state_parse_failed",
-	hookFailed: "doom_pi.hook_failed",
-	hookRegistryReadFailed: "doom_pi.hook_registry_read_failed",
-	personaReadFailed: "doom_pi.persona_read_failed",
-	styleSystemRenderFailed: "doom_pi.style_system_render_failed",
-	majorModeUnavailable: "doom_pi.major_mode_unavailable",
-	profileLoadFailed: "doom_pi.profile_load_failed",
-	launchCompleted: "doom_pi.launch_completed",
-	projectTrustResolved: "doom_pi.project_trust_resolved",
-	majorModeSwitched: "doom_pi.major_mode_switched",
-	profileApplied: "doom_pi.profile_applied"
+	cliFailed: "po_pi.cli_failed",
+	contextBuildFailed: "po_pi.context_build_failed",
+	resourceCollectionFailed: "po_pi.resource_collection_failed",
+	configLoadFailed: "po_pi.config_load_failed",
+	launchFailed: "po_pi.launch_failed",
+	compatibilityLaunchFailed: "po_pi.compatibility_launch_failed",
+	harnessStateParseFailed: "po_pi.harness_state_parse_failed",
+	hookFailed: "po_pi.hook_failed",
+	hookRegistryReadFailed: "po_pi.hook_registry_read_failed",
+	personaReadFailed: "po_pi.persona_read_failed",
+	styleSystemRenderFailed: "po_pi.style_system_render_failed",
+	majorModeUnavailable: "po_pi.major_mode_unavailable",
+	profileLoadFailed: "po_pi.profile_load_failed",
+	launchCompleted: "po_pi.launch_completed",
+	projectTrustResolved: "po_pi.project_trust_resolved",
+	majorModeSwitched: "po_pi.major_mode_switched",
+	profileApplied: "po_pi.profile_applied"
 };
 function createHarnessTelemetry(options = {}) {
 	let telemetryPromise;
 	const pendingEvents = [];
 	let pendingEventDropReported = false;
 	const telemetry = () => {
-		telemetryPromise ??= import("@agimon-ai/po-telemetry").then(({ createDoomTelemetry }) => createDoomTelemetry({
+		telemetryPromise ??= import("@agimon-ai/po-telemetry").then(({ createPoTelemetry }) => createPoTelemetry({
 			serviceName: SERVICE_NAME,
 			packageName: PACKAGE_NAME,
 			cwd: options.cwd,
@@ -62,7 +62,7 @@ function createHarnessTelemetry(options = {}) {
 				else if (!pendingEventDropReported) {
 					pendingEventDropReported = true;
 					try {
-						(options.warn ?? ((message) => process.emitWarning(message)))("Doom telemetry deferred event limit reached; later events were dropped.");
+						(options.warn ?? ((message) => process.emitWarning(message)))("Po telemetry deferred event limit reached; later events were dropped.");
 					} catch {}
 				}
 				return;

package/dist/runtimeLogSinkTelemetry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeLogSinkTelemetry.mjs","names":[],"sources":["../src/services/logSinkTelemetry/index.ts"],"sourcesContent":["import type { DoomTelemetry, DoomTelemetryOptions } from '@agimon-ai/po-telemetry';\n\nconst MAX_PENDING_EVENTS = 64;\nconst SERVICE_NAME = 'po';\nconst PACKAGE_NAME = '@agimon-ai/po';\n\nexport const HARNESS_EVENT = {\n  cliFailed: 'doom_pi.cli_failed',\n  contextBuildFailed: 'doom_pi.context_build_failed',\n  resourceCollectionFailed: 'doom_pi.resource_collection_failed',\n  configLoadFailed: 'doom_pi.config_load_failed',\n  launchFailed: 'doom_pi.launch_failed',\n  compatibilityLaunchFailed: 'doom_pi.compatibility_launch_failed',\n  harnessStateParseFailed: 'doom_pi.harness_state_parse_failed',\n  hookFailed: 'doom_pi.hook_failed',\n  hookRegistryReadFailed: 'doom_pi.hook_registry_read_failed',\n  personaReadFailed: 'doom_pi.persona_read_failed',\n  styleSystemRenderFailed: 'doom_pi.style_system_render_failed',\n  majorModeUnavailable: 'doom_pi.major_mode_unavailable',\n  profileLoadFailed: 'doom_pi.profile_load_failed',\n  launchCompleted: 'doom_pi.launch_completed',\n  projectTrustResolved: 'doom_pi.project_trust_resolved',\n  majorModeSwitched: 'doom_pi.major_mode_switched',\n  profileApplied: 'doom_pi.profile_applied',\n} as const;\n\nexport type HarnessEventName = (typeof HARNESS_EVENT)[keyof typeof HARNESS_EVENT];\nexport type HarnessEventAttributes = Record<string, string | number | boolean>;\nexport type HarnessErrorSink = (event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes) => void;\n\nexport interface HarnessFailureReporter {\n  error: HarnessErrorSink;\n  warn: HarnessErrorSink;\n}\n\nexport interface HarnessTelemetryOptions {\n  cwd?: string;\n  workspaceRoot?: string;\n  env?: NodeJS.ProcessEnv;\n  telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;\n  warn?: (message: string) => void;\n  /** Run startup callbacks before loading the telemetry backend. */\n  deferSpans?: boolean;\n}\n\nexport interface HarnessTelemetry {\n  recordError(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordWarning(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordEvent(event: HarnessEventName, attributes?: HarnessEventAttributes): Promise<void>;\n  runInSpan<T>(name: string, attributes: HarnessEventAttributes, callback: () => Promise<T>): Promise<T>;\n  flush(): Promise<void>;\n  shutdown(): Promise<void>;\n}\n\nexport function createHarnessTelemetry(options: HarnessTelemetryOptions = {}): HarnessTelemetry {\n  let telemetryPromise: Promise<DoomTelemetry> | undefined;\n  const pendingEvents: Array<{ event: HarnessEventName; attributes?: HarnessEventAttributes }> = [];\n  let pendingEventDropReported = false;\n  const telemetry = (): Promise<DoomTelemetry> => {\n    telemetryPromise ??= import('@agimon-ai/po-telemetry').then(({ createDoomTelemetry }) =>\n      createDoomTelemetry({\n        serviceName: SERVICE_NAME,\n        packageName: PACKAGE_NAME,\n        cwd: options.cwd,\n        workspaceRoot: options.workspaceRoot,\n        env: options.env,\n        telemetryFactory: options.telemetryFactory,\n        warn: options.warn,\n        enableLogs: true,\n        enableTraces: true,\n      }),\n    );\n    return telemetryPromise;\n  };\n  const drainEvents = async (loaded: DoomTelemetry): Promise<void> => {\n    for (const pending of pendingEvents.splice(0)) {\n      await loaded.recordEvent(pending.event, pending.attributes);\n    }\n  };\n  return {\n    recordError: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordError(event, error, attributes);\n    },\n    recordWarning: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordWarning(event, error, attributes);\n    },\n    recordEvent: async (event, attributes) => {\n      if (options.deferSpans && !telemetryPromise) {\n        if (pendingEvents.length < MAX_PENDING_EVENTS) pendingEvents.push({ event, attributes });\n        else if (!pendingEventDropReported) {\n          pendingEventDropReported = true;\n          try {\n            const reportWarning = options.warn ?? ((message: string) => process.emitWarning(message));\n            reportWarning('Doom telemetry deferred event limit reached; later events were dropped.');\n          } catch {\n            // Telemetry warnings must not interrupt launcher startup.\n          }\n        }\n        return;\n      }\n      await (await telemetry()).recordEvent(event, attributes);\n    },\n    runInSpan: (name, attributes, callback) => {\n      // The launcher opts into this path for pre-spawn preparation. Lifecycle\n      // events remain buffered until flush; failures still initialize the real\n      // sink immediately so diagnostics are not lost.\n      if (options.deferSpans && !telemetryPromise) return callback();\n      return telemetry().then((loaded) => loaded.runInSpan(name, attributes, callback));\n    },\n    flush: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.flush();\n    },\n    shutdown: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.shutdown();\n    },\n  };\n}\n\nexport function toFailureReporter(telemetry: HarnessTelemetry): HarnessFailureReporter {\n  return {\n    error: (event, error, attributes) => void telemetry.recordError(event, error, attributes),\n    warn: (event, error, attributes) => void telemetry.recordWarning(event, error, attributes),\n  };\n}\n"],"mappings":";AAEA,MAAM,qBAAqB;AAC3B,MAAM,eAAe;AACrB,MAAM,eAAe;AAErB,MAAa,gBAAgB;CAC3B,WAAW;CACX,oBAAoB;CACpB,0BAA0B;CAC1B,kBAAkB;CAClB,cAAc;CACd,2BAA2B;CAC3B,yBAAyB;CACzB,YAAY;CACZ,wBAAwB;CACxB,mBAAmB;CACnB,yBAAyB;CACzB,sBAAsB;CACtB,mBAAmB;CACnB,iBAAiB;CACjB,sBAAsB;CACtB,mBAAmB;CACnB,gBAAgB;AAClB;AA8BA,SAAgB,uBAAuB,UAAmC,CAAC,GAAqB;CAC9F,IAAI;CACJ,MAAM,gBAAyF,CAAC;CAChG,IAAI,2BAA2B;CAC/B,MAAM,kBAA0C;EAC9C,qBAAqB,OAAO,0BAA0B,CAAC,MAAM,EAAE,0BAC7D,oBAAoB;GAClB,aAAa;GACb,aAAa;GACb,KAAK,QAAQ;GACb,eAAe,QAAQ;GACvB,KAAK,QAAQ;GACb,kBAAkB,QAAQ;GAC1B,MAAM,QAAQ;GACd,YAAY;GACZ,cAAc;EAChB,CAAC,CACH;EACA,OAAO;CACT;CACA,MAAM,cAAc,OAAO,WAAyC;EAClE,KAAK,MAAM,WAAW,cAAc,OAAO,CAAC,GAC1C,MAAM,OAAO,YAAY,QAAQ,OAAO,QAAQ,UAAU;CAE9D;CACA,OAAO;EACL,aAAa,OAAO,OAAO,OAAO,eAAe;GAC/C,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,YAAY,OAAO,OAAO,UAAU;EACnD;EACA,eAAe,OAAO,OAAO,OAAO,eAAe;GACjD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,cAAc,OAAO,OAAO,UAAU;EACrD;EACA,aAAa,OAAO,OAAO,eAAe;GACxC,IAAI,QAAQ,cAAc,CAAC,kBAAkB;IAC3C,IAAI,cAAc,SAAS,oBAAoB,cAAc,KAAK;KAAE;KAAO;IAAW,CAAC;SAClF,IAAI,CAAC,0BAA0B;KAClC,2BAA2B;KAC3B,IAAI;MAEF,CADsB,QAAQ,UAAU,YAAoB,QAAQ,YAAY,OAAO,GAAA,CACzE,yEAAyE;KACzF,QAAQ,CAER;IACF;IACA;GACF;GACA,OAAO,MAAM,UAAU,EAAA,CAAG,YAAY,OAAO,UAAU;EACzD;EACA,YAAY,MAAM,YAAY,aAAa;GAIzC,IAAI,QAAQ,cAAc,CAAC,kBAAkB,OAAO,SAAS;GAC7D,OAAO,UAAU,CAAC,CAAC,MAAM,WAAW,OAAO,UAAU,MAAM,YAAY,QAAQ,CAAC;EAClF;EACA,OAAO,YAAY;GACjB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,MAAM;EACrB;EACA,UAAU,YAAY;GACpB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,SAAS;EACxB;CACF;AACF;AAEA,SAAgB,kBAAkB,WAAqD;CACrF,OAAO;EACL,QAAQ,OAAO,OAAO,eAAe,KAAK,UAAU,YAAY,OAAO,OAAO,UAAU;EACxF,OAAO,OAAO,OAAO,eAAe,KAAK,UAAU,cAAc,OAAO,OAAO,UAAU;CAC3F;AACF"}
+{"version":3,"file":"runtimeLogSinkTelemetry.mjs","names":[],"sources":["../src/services/logSinkTelemetry/index.ts"],"sourcesContent":["import type { PoTelemetry, PoTelemetryOptions } from '@agimon-ai/po-telemetry';\n\nconst MAX_PENDING_EVENTS = 64;\nconst SERVICE_NAME = 'po';\nconst PACKAGE_NAME = '@agimon-ai/po';\n\nexport const HARNESS_EVENT = {\n  cliFailed: 'po_pi.cli_failed',\n  contextBuildFailed: 'po_pi.context_build_failed',\n  resourceCollectionFailed: 'po_pi.resource_collection_failed',\n  configLoadFailed: 'po_pi.config_load_failed',\n  launchFailed: 'po_pi.launch_failed',\n  compatibilityLaunchFailed: 'po_pi.compatibility_launch_failed',\n  harnessStateParseFailed: 'po_pi.harness_state_parse_failed',\n  hookFailed: 'po_pi.hook_failed',\n  hookRegistryReadFailed: 'po_pi.hook_registry_read_failed',\n  personaReadFailed: 'po_pi.persona_read_failed',\n  styleSystemRenderFailed: 'po_pi.style_system_render_failed',\n  majorModeUnavailable: 'po_pi.major_mode_unavailable',\n  profileLoadFailed: 'po_pi.profile_load_failed',\n  launchCompleted: 'po_pi.launch_completed',\n  projectTrustResolved: 'po_pi.project_trust_resolved',\n  majorModeSwitched: 'po_pi.major_mode_switched',\n  profileApplied: 'po_pi.profile_applied',\n} as const;\n\nexport type HarnessEventName = (typeof HARNESS_EVENT)[keyof typeof HARNESS_EVENT];\nexport type HarnessEventAttributes = Record<string, string | number | boolean>;\nexport type HarnessErrorSink = (event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes) => void;\n\nexport interface HarnessFailureReporter {\n  error: HarnessErrorSink;\n  warn: HarnessErrorSink;\n}\n\nexport interface HarnessTelemetryOptions {\n  cwd?: string;\n  workspaceRoot?: string;\n  env?: NodeJS.ProcessEnv;\n  telemetryFactory?: NonNullable<PoTelemetryOptions['telemetryFactory']>;\n  warn?: (message: string) => void;\n  /** Run startup callbacks before loading the telemetry backend. */\n  deferSpans?: boolean;\n}\n\nexport interface HarnessTelemetry {\n  recordError(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordWarning(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordEvent(event: HarnessEventName, attributes?: HarnessEventAttributes): Promise<void>;\n  runInSpan<T>(name: string, attributes: HarnessEventAttributes, callback: () => Promise<T>): Promise<T>;\n  flush(): Promise<void>;\n  shutdown(): Promise<void>;\n}\n\nexport function createHarnessTelemetry(options: HarnessTelemetryOptions = {}): HarnessTelemetry {\n  let telemetryPromise: Promise<PoTelemetry> | undefined;\n  const pendingEvents: Array<{ event: HarnessEventName; attributes?: HarnessEventAttributes }> = [];\n  let pendingEventDropReported = false;\n  const telemetry = (): Promise<PoTelemetry> => {\n    telemetryPromise ??= import('@agimon-ai/po-telemetry').then(({ createPoTelemetry }) =>\n      createPoTelemetry({\n        serviceName: SERVICE_NAME,\n        packageName: PACKAGE_NAME,\n        cwd: options.cwd,\n        workspaceRoot: options.workspaceRoot,\n        env: options.env,\n        telemetryFactory: options.telemetryFactory,\n        warn: options.warn,\n        enableLogs: true,\n        enableTraces: true,\n      }),\n    );\n    return telemetryPromise;\n  };\n  const drainEvents = async (loaded: PoTelemetry): Promise<void> => {\n    for (const pending of pendingEvents.splice(0)) {\n      await loaded.recordEvent(pending.event, pending.attributes);\n    }\n  };\n  return {\n    recordError: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordError(event, error, attributes);\n    },\n    recordWarning: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordWarning(event, error, attributes);\n    },\n    recordEvent: async (event, attributes) => {\n      if (options.deferSpans && !telemetryPromise) {\n        if (pendingEvents.length < MAX_PENDING_EVENTS) pendingEvents.push({ event, attributes });\n        else if (!pendingEventDropReported) {\n          pendingEventDropReported = true;\n          try {\n            const reportWarning = options.warn ?? ((message: string) => process.emitWarning(message));\n            reportWarning('Po telemetry deferred event limit reached; later events were dropped.');\n          } catch {\n            // Telemetry warnings must not interrupt launcher startup.\n          }\n        }\n        return;\n      }\n      await (await telemetry()).recordEvent(event, attributes);\n    },\n    runInSpan: (name, attributes, callback) => {\n      // The launcher opts into this path for pre-spawn preparation. Lifecycle\n      // events remain buffered until flush; failures still initialize the real\n      // sink immediately so diagnostics are not lost.\n      if (options.deferSpans && !telemetryPromise) return callback();\n      return telemetry().then((loaded) => loaded.runInSpan(name, attributes, callback));\n    },\n    flush: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.flush();\n    },\n    shutdown: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.shutdown();\n    },\n  };\n}\n\nexport function toFailureReporter(telemetry: HarnessTelemetry): HarnessFailureReporter {\n  return {\n    error: (event, error, attributes) => void telemetry.recordError(event, error, attributes),\n    warn: (event, error, attributes) => void telemetry.recordWarning(event, error, attributes),\n  };\n}\n"],"mappings":";AAEA,MAAM,qBAAqB;AAC3B,MAAM,eAAe;AACrB,MAAM,eAAe;AAErB,MAAa,gBAAgB;CAC3B,WAAW;CACX,oBAAoB;CACpB,0BAA0B;CAC1B,kBAAkB;CAClB,cAAc;CACd,2BAA2B;CAC3B,yBAAyB;CACzB,YAAY;CACZ,wBAAwB;CACxB,mBAAmB;CACnB,yBAAyB;CACzB,sBAAsB;CACtB,mBAAmB;CACnB,iBAAiB;CACjB,sBAAsB;CACtB,mBAAmB;CACnB,gBAAgB;AAClB;AA8BA,SAAgB,uBAAuB,UAAmC,CAAC,GAAqB;CAC9F,IAAI;CACJ,MAAM,gBAAyF,CAAC;CAChG,IAAI,2BAA2B;CAC/B,MAAM,kBAAwC;EAC5C,qBAAqB,OAAO,0BAA0B,CAAC,MAAM,EAAE,wBAC7D,kBAAkB;GAChB,aAAa;GACb,aAAa;GACb,KAAK,QAAQ;GACb,eAAe,QAAQ;GACvB,KAAK,QAAQ;GACb,kBAAkB,QAAQ;GAC1B,MAAM,QAAQ;GACd,YAAY;GACZ,cAAc;EAChB,CAAC,CACH;EACA,OAAO;CACT;CACA,MAAM,cAAc,OAAO,WAAuC;EAChE,KAAK,MAAM,WAAW,cAAc,OAAO,CAAC,GAC1C,MAAM,OAAO,YAAY,QAAQ,OAAO,QAAQ,UAAU;CAE9D;CACA,OAAO;EACL,aAAa,OAAO,OAAO,OAAO,eAAe;GAC/C,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,YAAY,OAAO,OAAO,UAAU;EACnD;EACA,eAAe,OAAO,OAAO,OAAO,eAAe;GACjD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,cAAc,OAAO,OAAO,UAAU;EACrD;EACA,aAAa,OAAO,OAAO,eAAe;GACxC,IAAI,QAAQ,cAAc,CAAC,kBAAkB;IAC3C,IAAI,cAAc,SAAS,oBAAoB,cAAc,KAAK;KAAE;KAAO;IAAW,CAAC;SAClF,IAAI,CAAC,0BAA0B;KAClC,2BAA2B;KAC3B,IAAI;MAEF,CADsB,QAAQ,UAAU,YAAoB,QAAQ,YAAY,OAAO,GAAA,CACzE,uEAAuE;KACvF,QAAQ,CAER;IACF;IACA;GACF;GACA,OAAO,MAAM,UAAU,EAAA,CAAG,YAAY,OAAO,UAAU;EACzD;EACA,YAAY,MAAM,YAAY,aAAa;GAIzC,IAAI,QAAQ,cAAc,CAAC,kBAAkB,OAAO,SAAS;GAC7D,OAAO,UAAU,CAAC,CAAC,MAAM,WAAW,OAAO,UAAU,MAAM,YAAY,QAAQ,CAAC;EAClF;EACA,OAAO,YAAY;GACjB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,MAAM;EACrB;EACA,UAAU,YAAY;GACpB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,SAAS;EACxB;CACF;AACF;AAEA,SAAgB,kBAAkB,WAAqD;CACrF,OAAO;EACL,QAAQ,OAAO,OAAO,eAAe,KAAK,UAAU,YAAY,OAAO,OAAO,UAAU;EACxF,OAAO,OAAO,OAAO,eAAe,KAAK,UAAU,cAAc,OAAO,OAAO,UAAU;CAC3F;AACF"}

package/dist/runtimePackages.cjs

@@ -39,11 +39,16 @@ function compatibleUpm() {
 */
 /** Days a newly picked version must have been published, matching `pnpm-workspace.yaml`. */
 const RUNTIME_MIN_RELEASE_AGE_DAYS = 2;
-/** First-party scopes that are never held back, matching `pnpm-workspace.yaml`. */
+/**
+* Packages that are never held back: the first-party scopes and the pins `pnpm-workspace.yaml`
+* excludes by version. upm only honours name or scope entries, so the pins are listed by name.
+*/
 const RUNTIME_MIN_RELEASE_AGE_EXCLUDE = [
 	"@agimon-ai/*",
 	"@agiflowai/*",
-	"@earendil-works/*"
+	"@earendil-works/*",
+	"@deepseek-ai/cordis",
+	"@deepseek-ai/cosmokit"
 ];
 const STORE_DIRECTORY = "store";
 const ENV_PROXY_FLAG = "--use-env-proxy";