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

package/dist/runtimeProtocol.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeProtocol.mjs","names":[],"sources":["../src/schemas/protocol.ts"],"sourcesContent":["import { type Static, type TSchema, Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\nexport const DOOM_PROTOCOL_ERROR_CODE = {\n  aborted: 'ABORTED',\n  invalidMessage: 'INVALID_MESSAGE',\n  providerError: 'PROVIDER_ERROR',\n  timeout: 'TIMEOUT',\n} as const;\n\nconst DEFAULT_PROTOCOL_TIMEOUT_MS = 5_000;\nconst DEFAULT_DUPLICATE_WINDOW = 256;\n\nexport interface EventBusLike {\n  emit(event: string, data: unknown): void;\n  on(event: string, handler: (data: unknown) => void): () => void;\n}\n\nexport const ProtocolErrorSchema = Type.Object(\n  {\n    code: Type.String({ minLength: 1 }),\n    message: Type.String({ minLength: 1 }),\n    retryable: Type.Optional(Type.Boolean()),\n  },\n  { additionalProperties: false },\n);\n\nexport type ProtocolErrorPayload = Static<typeof ProtocolErrorSchema>;\n\nexport class DoomProtocolError extends Error {\n  readonly code: string;\n  readonly retryable: boolean;\n\n  constructor(payload: ProtocolErrorPayload) {\n    super(payload.message);\n    this.name = 'DoomProtocolError';\n    this.code = payload.code;\n    this.retryable = payload.retryable ?? false;\n  }\n}\n\nexport class DoomProtocolValidationError extends DoomProtocolError {\n  constructor(channel: string, details: string) {\n    super({ code: DOOM_PROTOCOL_ERROR_CODE.invalidMessage, message: `Invalid message on ${channel}: ${details}` });\n    this.name = 'DoomProtocolValidationError';\n  }\n}\n\nexport interface ProtocolIdentity {\n  source: string;\n  sessionId: string;\n}\n\ninterface ProtocolEnvelope<TPayload> extends ProtocolIdentity {\n  protocol: string;\n  version: 1;\n  kind: string;\n  messageId: string;\n  correlationId?: string;\n  payload: TPayload;\n}\n\nexport interface NotificationDefinition<TPayload extends TSchema> {\n  channel: string;\n  kind: string;\n  payload: TPayload;\n}\n\nexport interface RequestReplyDefinition<TRequest extends TSchema, TResponse extends TSchema> {\n  requestChannel: string;\n  responseChannel: string;\n  errorChannel: string;\n  requestKind: string;\n  responseKind: string;\n  request: TRequest;\n  response: TResponse;\n}\n\nexport interface RequestOptions {\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  /** Ignore correlated replies from any source except this exact provider. */\n  expectedSource?: string;\n}\n\nexport interface ProtocolRuntimeOptions extends ProtocolIdentity {\n  bus: EventBusLike;\n  defaultTimeoutMs?: number;\n  createMessageId?: () => string;\n  duplicateWindow?: number;\n}\n\nexport interface ProtocolRuntime {\n  notify<TPayload extends TSchema>(definition: NotificationDefinition<TPayload>, payload: Static<TPayload>): void;\n  onNotification<TPayload extends TSchema>(\n    definition: NotificationDefinition<TPayload>,\n    handler: (payload: Static<TPayload>, identity: ProtocolIdentity) => void | Promise<void>,\n  ): () => void;\n  request<TRequest extends TSchema, TResponse extends TSchema>(\n    definition: RequestReplyDefinition<TRequest, TResponse>,\n    payload: Static<TRequest>,\n    options?: RequestOptions,\n  ): Promise<Static<TResponse>>;\n  provide<TRequest extends TSchema, TResponse extends TSchema>(\n    definition: RequestReplyDefinition<TRequest, TResponse>,\n    handler: (payload: Static<TRequest>, identity: ProtocolIdentity) => Static<TResponse> | Promise<Static<TResponse>>,\n  ): () => void;\n}\n\nconst EnvelopeBaseSchema = Type.Object(\n  {\n    protocol: Type.String({ minLength: 1 }),\n    version: Type.Literal(1),\n    kind: Type.String({ minLength: 1 }),\n    messageId: Type.String({ minLength: 1 }),\n    correlationId: Type.Optional(Type.String({ minLength: 1 })),\n    source: Type.String({ minLength: 1 }),\n    sessionId: Type.String({ minLength: 1 }),\n  },\n  { additionalProperties: false },\n);\n\nfunction envelopeSchema<TPayload extends TSchema>(payload: TPayload) {\n  return Type.Object({ ...EnvelopeBaseSchema.properties, payload }, { additionalProperties: false });\n}\n\nfunction protocolName(channel: string): string {\n  const match = /^(doom:[^:]+(?::[^:]+)*):v\\d+:/.exec(channel);\n  if (!match) throw new Error(`Invalid Doom protocol channel: ${channel}`);\n  return match[1];\n}\n\n/** Up to three field-level problems, e.g. `/ must have required properties path`. */\nexport function validationDetails(schema: TSchema, value: unknown): string {\n  return (\n    Errors(schema, value)\n      // Each extra key also yields a bare `schema is false`; the additionalProperties entry names them instead.\n      .filter((error) => !(error.keyword === 'boolean' && error.schemaPath.endsWith('/additionalProperties')))\n      .slice(0, 3)\n      .map((error) => {\n        const extra =\n          error.keyword === 'additionalProperties'\n            ? `: ${((error.params as { additionalProperties?: string[] }).additionalProperties ?? []).join(', ')}`\n            : '';\n        return `${error.instancePath || '/'} ${error.message}${extra}`;\n      })\n      .join('; ')\n  );\n}\n\nfunction assertValid<TSchemaValue extends TSchema>(\n  channel: string,\n  schema: TSchemaValue,\n  value: unknown,\n): asserts value is Static<TSchemaValue> {\n  if (!Check(schema, value)) throw new DoomProtocolValidationError(channel, validationDetails(schema, value));\n}\n\nfunction asProtocolError(error: unknown): ProtocolErrorPayload {\n  if (error instanceof DoomProtocolError) {\n    return { code: error.code, message: error.message, retryable: error.retryable };\n  }\n  return {\n    code: DOOM_PROTOCOL_ERROR_CODE.providerError,\n    message: error instanceof Error ? error.message : String(error),\n  };\n}\n\nexport function defineNotification<TPayload extends TSchema>(definition: {\n  channel: `doom:${string}:${string}:v1:${string}`;\n  kind: string;\n  payload: TPayload;\n}): NotificationDefinition<TPayload> {\n  protocolName(definition.channel);\n  return definition;\n}\n\nexport function defineRequestReply<TRequest extends TSchema, TResponse extends TSchema>(definition: {\n  channels: {\n    request: `doom:${string}:${string}:v1:${string}`;\n    response: `doom:${string}:${string}:v1:${string}`;\n    error: `doom:${string}:${string}:v1:${string}`;\n  };\n  kinds: { request: string; response: string };\n  request: TRequest;\n  response: TResponse;\n}): RequestReplyDefinition<TRequest, TResponse> {\n  const protocol = protocolName(definition.channels.request);\n  for (const channel of [definition.channels.response, definition.channels.error]) {\n    if (protocolName(channel) !== protocol) throw new Error('Request/reply channels must share one protocol');\n  }\n  return {\n    requestChannel: definition.channels.request,\n    responseChannel: definition.channels.response,\n    errorChannel: definition.channels.error,\n    requestKind: definition.kinds.request,\n    responseKind: definition.kinds.response,\n    request: definition.request,\n    response: definition.response,\n  };\n}\n\nexport const defineJob = defineRequestReply;\n\nexport function createProtocolRuntime(options: ProtocolRuntimeOptions): ProtocolRuntime {\n  const timeoutDefault = options.defaultTimeoutMs ?? DEFAULT_PROTOCOL_TIMEOUT_MS;\n  const duplicateWindow = options.duplicateWindow ?? DEFAULT_DUPLICATE_WINDOW;\n  const createMessageId = options.createMessageId ?? (() => `${options.source}:${crypto.randomUUID()}`);\n\n  const rethrowAsync = (error: unknown): void => {\n    queueMicrotask(() => {\n      throw error instanceof Error ? error : new Error(String(error));\n    });\n  };\n\n  function duplicateGuard(): (messageId: string) => boolean {\n    const handled = new Set<string>();\n    return (messageId) => {\n      if (handled.has(messageId)) return false;\n      handled.add(messageId);\n      if (handled.size > duplicateWindow) handled.delete(handled.values().next().value as string);\n      return true;\n    };\n  }\n\n  function base(channel: string, kind: string, messageId = createMessageId(), correlationId?: string) {\n    return {\n      protocol: protocolName(channel),\n      version: 1 as const,\n      kind,\n      messageId,\n      ...(correlationId ? { correlationId } : {}),\n      source: options.source,\n      sessionId: options.sessionId,\n    };\n  }\n\n  return {\n    notify<TPayload extends TSchema>(definition: NotificationDefinition<TPayload>, payload: Static<TPayload>) {\n      assertValid(definition.channel, definition.payload, payload);\n      options.bus.emit(definition.channel, { ...base(definition.channel, definition.kind), payload });\n    },\n\n    onNotification<TPayload extends TSchema>(\n      definition: NotificationDefinition<TPayload>,\n      handler: (payload: Static<TPayload>, identity: ProtocolIdentity) => void | Promise<void>,\n    ) {\n      const schema = envelopeSchema(definition.payload);\n      const remember = duplicateGuard();\n      return options.bus.on(definition.channel, (message) => {\n        assertValid(definition.channel, schema, message);\n        const envelope = message as unknown as ProtocolEnvelope<Static<TPayload>>;\n        if (envelope.sessionId !== options.sessionId) return;\n        if (!remember(envelope.messageId)) return;\n        void Promise.resolve(handler(envelope.payload, envelope)).catch(rethrowAsync);\n      });\n    },\n\n    request<TRequest extends TSchema, TResponse extends TSchema>(\n      definition: RequestReplyDefinition<TRequest, TResponse>,\n      payload: Static<TRequest>,\n      requestOptions: RequestOptions = {},\n    ) {\n      assertValid(definition.requestChannel, definition.request, payload);\n      const messageId = createMessageId();\n      const responseSchema = envelopeSchema(definition.response);\n      const errorSchema = envelopeSchema(ProtocolErrorSchema);\n      return new Promise<Static<typeof definition.response>>((resolve, reject) => {\n        let settled = false;\n        const cleanups: Array<() => void> = [];\n        const finish = (action: () => void) => {\n          if (settled) return;\n          settled = true;\n          for (const cleanup of cleanups.splice(0)) cleanup();\n          action();\n        };\n        cleanups.push(\n          options.bus.on(definition.responseChannel, (message) => {\n            assertValid(definition.responseChannel, responseSchema, message);\n            const envelope = message as unknown as ProtocolEnvelope<Static<TResponse>>;\n            if (envelope.sessionId !== options.sessionId) return;\n            if (envelope.correlationId !== messageId) return;\n            if (requestOptions.expectedSource && envelope.source !== requestOptions.expectedSource) return;\n            finish(() => resolve(envelope.payload));\n          }),\n          options.bus.on(definition.errorChannel, (message) => {\n            assertValid(definition.errorChannel, errorSchema, message);\n            const envelope = message as unknown as ProtocolEnvelope<ProtocolErrorPayload>;\n            if (envelope.sessionId !== options.sessionId) return;\n            if (envelope.correlationId !== messageId) return;\n            if (requestOptions.expectedSource && envelope.source !== requestOptions.expectedSource) return;\n            finish(() => reject(new DoomProtocolError(envelope.payload)));\n          }),\n        );\n        const timer = setTimeout(\n          () =>\n            finish(() =>\n              reject(\n                new DoomProtocolError({\n                  code: DOOM_PROTOCOL_ERROR_CODE.timeout,\n                  message: `Timed out waiting for ${definition.responseKind}`,\n                }),\n              ),\n            ),\n          requestOptions.timeoutMs ?? timeoutDefault,\n        );\n        cleanups.push(() => clearTimeout(timer));\n        if (requestOptions.signal) {\n          const abort = () =>\n            finish(() =>\n              reject(new DoomProtocolError({ code: DOOM_PROTOCOL_ERROR_CODE.aborted, message: 'Request aborted' })),\n            );\n          requestOptions.signal.addEventListener('abort', abort, { once: true });\n          cleanups.push(() => requestOptions.signal?.removeEventListener('abort', abort));\n          if (requestOptions.signal.aborted) return abort();\n        }\n        options.bus.emit(definition.requestChannel, {\n          ...base(definition.requestChannel, definition.requestKind, messageId),\n          payload,\n        });\n      });\n    },\n\n    provide<TRequest extends TSchema, TResponse extends TSchema>(\n      definition: RequestReplyDefinition<TRequest, TResponse>,\n      handler: (\n        payload: Static<TRequest>,\n        identity: ProtocolIdentity,\n      ) => Static<TResponse> | Promise<Static<TResponse>>,\n    ) {\n      const requestSchema = envelopeSchema(definition.request);\n      const remember = duplicateGuard();\n      return options.bus.on(definition.requestChannel, (message) => {\n        assertValid(definition.requestChannel, requestSchema, message);\n        const envelope = message as unknown as ProtocolEnvelope<Static<TRequest>>;\n        if (envelope.sessionId !== options.sessionId) return;\n        if (!remember(envelope.messageId)) return;\n        void Promise.resolve()\n          .then(() => handler(envelope.payload, envelope))\n          .then(\n            (payload) => {\n              assertValid(definition.responseChannel, definition.response, payload);\n              options.bus.emit(definition.responseChannel, {\n                ...base(definition.responseChannel, definition.responseKind, createMessageId(), envelope.messageId),\n                payload,\n              });\n            },\n            (error) => {\n              options.bus.emit(definition.errorChannel, {\n                ...base(definition.errorChannel, 'error', createMessageId(), envelope.messageId),\n                payload: asProtocolError(error),\n              });\n            },\n          );\n      });\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"runtimeProtocol.mjs","names":[],"sources":["../src/schemas/protocol.ts"],"sourcesContent":["import { type Static, type TSchema, Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\nexport const PO_PROTOCOL_ERROR_CODE = {\n  aborted: 'ABORTED',\n  invalidMessage: 'INVALID_MESSAGE',\n  providerError: 'PROVIDER_ERROR',\n  timeout: 'TIMEOUT',\n} as const;\n\nconst DEFAULT_PROTOCOL_TIMEOUT_MS = 5_000;\nconst DEFAULT_DUPLICATE_WINDOW = 256;\n\nexport interface EventBusLike {\n  emit(event: string, data: unknown): void;\n  on(event: string, handler: (data: unknown) => void): () => void;\n}\n\nexport const ProtocolErrorSchema = Type.Object(\n  {\n    code: Type.String({ minLength: 1 }),\n    message: Type.String({ minLength: 1 }),\n    retryable: Type.Optional(Type.Boolean()),\n  },\n  { additionalProperties: false },\n);\n\nexport type ProtocolErrorPayload = Static<typeof ProtocolErrorSchema>;\n\nexport class PoProtocolError extends Error {\n  readonly code: string;\n  readonly retryable: boolean;\n\n  constructor(payload: ProtocolErrorPayload) {\n    super(payload.message);\n    this.name = 'PoProtocolError';\n    this.code = payload.code;\n    this.retryable = payload.retryable ?? false;\n  }\n}\n\nexport class PoProtocolValidationError extends PoProtocolError {\n  constructor(channel: string, details: string) {\n    super({ code: PO_PROTOCOL_ERROR_CODE.invalidMessage, message: `Invalid message on ${channel}: ${details}` });\n    this.name = 'PoProtocolValidationError';\n  }\n}\n\nexport interface ProtocolIdentity {\n  source: string;\n  sessionId: string;\n}\n\ninterface ProtocolEnvelope<TPayload> extends ProtocolIdentity {\n  protocol: string;\n  version: 1;\n  kind: string;\n  messageId: string;\n  correlationId?: string;\n  payload: TPayload;\n}\n\nexport interface NotificationDefinition<TPayload extends TSchema> {\n  channel: string;\n  kind: string;\n  payload: TPayload;\n}\n\nexport interface RequestReplyDefinition<TRequest extends TSchema, TResponse extends TSchema> {\n  requestChannel: string;\n  responseChannel: string;\n  errorChannel: string;\n  requestKind: string;\n  responseKind: string;\n  request: TRequest;\n  response: TResponse;\n}\n\nexport interface RequestOptions {\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  /** Ignore correlated replies from any source except this exact provider. */\n  expectedSource?: string;\n}\n\nexport interface ProtocolRuntimeOptions extends ProtocolIdentity {\n  bus: EventBusLike;\n  defaultTimeoutMs?: number;\n  createMessageId?: () => string;\n  duplicateWindow?: number;\n}\n\nexport interface ProtocolRuntime {\n  notify<TPayload extends TSchema>(definition: NotificationDefinition<TPayload>, payload: Static<TPayload>): void;\n  onNotification<TPayload extends TSchema>(\n    definition: NotificationDefinition<TPayload>,\n    handler: (payload: Static<TPayload>, identity: ProtocolIdentity) => void | Promise<void>,\n  ): () => void;\n  request<TRequest extends TSchema, TResponse extends TSchema>(\n    definition: RequestReplyDefinition<TRequest, TResponse>,\n    payload: Static<TRequest>,\n    options?: RequestOptions,\n  ): Promise<Static<TResponse>>;\n  provide<TRequest extends TSchema, TResponse extends TSchema>(\n    definition: RequestReplyDefinition<TRequest, TResponse>,\n    handler: (payload: Static<TRequest>, identity: ProtocolIdentity) => Static<TResponse> | Promise<Static<TResponse>>,\n  ): () => void;\n}\n\nconst EnvelopeBaseSchema = Type.Object(\n  {\n    protocol: Type.String({ minLength: 1 }),\n    version: Type.Literal(1),\n    kind: Type.String({ minLength: 1 }),\n    messageId: Type.String({ minLength: 1 }),\n    correlationId: Type.Optional(Type.String({ minLength: 1 })),\n    source: Type.String({ minLength: 1 }),\n    sessionId: Type.String({ minLength: 1 }),\n  },\n  { additionalProperties: false },\n);\n\nfunction envelopeSchema<TPayload extends TSchema>(payload: TPayload) {\n  return Type.Object({ ...EnvelopeBaseSchema.properties, payload }, { additionalProperties: false });\n}\n\nfunction protocolName(channel: string): string {\n  const match = /^(po:[^:]+(?::[^:]+)*):v\\d+:/.exec(channel);\n  if (!match) throw new Error(`Invalid Po protocol channel: ${channel}`);\n  return match[1];\n}\n\n/** Up to three field-level problems, e.g. `/ must have required properties path`. */\nexport function validationDetails(schema: TSchema, value: unknown): string {\n  return (\n    Errors(schema, value)\n      // Each extra key also yields a bare `schema is false`; the additionalProperties entry names them instead.\n      .filter((error) => !(error.keyword === 'boolean' && error.schemaPath.endsWith('/additionalProperties')))\n      .slice(0, 3)\n      .map((error) => {\n        const extra =\n          error.keyword === 'additionalProperties'\n            ? `: ${((error.params as { additionalProperties?: string[] }).additionalProperties ?? []).join(', ')}`\n            : '';\n        return `${error.instancePath || '/'} ${error.message}${extra}`;\n      })\n      .join('; ')\n  );\n}\n\nfunction assertValid<TSchemaValue extends TSchema>(\n  channel: string,\n  schema: TSchemaValue,\n  value: unknown,\n): asserts value is Static<TSchemaValue> {\n  if (!Check(schema, value)) throw new PoProtocolValidationError(channel, validationDetails(schema, value));\n}\n\nfunction asProtocolError(error: unknown): ProtocolErrorPayload {\n  if (error instanceof PoProtocolError) {\n    return { code: error.code, message: error.message, retryable: error.retryable };\n  }\n  return {\n    code: PO_PROTOCOL_ERROR_CODE.providerError,\n    message: error instanceof Error ? error.message : String(error),\n  };\n}\n\nexport function defineNotification<TPayload extends TSchema>(definition: {\n  channel: `po:${string}:${string}:v1:${string}`;\n  kind: string;\n  payload: TPayload;\n}): NotificationDefinition<TPayload> {\n  protocolName(definition.channel);\n  return definition;\n}\n\nexport function defineRequestReply<TRequest extends TSchema, TResponse extends TSchema>(definition: {\n  channels: {\n    request: `po:${string}:${string}:v1:${string}`;\n    response: `po:${string}:${string}:v1:${string}`;\n    error: `po:${string}:${string}:v1:${string}`;\n  };\n  kinds: { request: string; response: string };\n  request: TRequest;\n  response: TResponse;\n}): RequestReplyDefinition<TRequest, TResponse> {\n  const protocol = protocolName(definition.channels.request);\n  for (const channel of [definition.channels.response, definition.channels.error]) {\n    if (protocolName(channel) !== protocol) throw new Error('Request/reply channels must share one protocol');\n  }\n  return {\n    requestChannel: definition.channels.request,\n    responseChannel: definition.channels.response,\n    errorChannel: definition.channels.error,\n    requestKind: definition.kinds.request,\n    responseKind: definition.kinds.response,\n    request: definition.request,\n    response: definition.response,\n  };\n}\n\nexport const defineJob = defineRequestReply;\n\nexport function createProtocolRuntime(options: ProtocolRuntimeOptions): ProtocolRuntime {\n  const timeoutDefault = options.defaultTimeoutMs ?? DEFAULT_PROTOCOL_TIMEOUT_MS;\n  const duplicateWindow = options.duplicateWindow ?? DEFAULT_DUPLICATE_WINDOW;\n  const createMessageId = options.createMessageId ?? (() => `${options.source}:${crypto.randomUUID()}`);\n\n  const rethrowAsync = (error: unknown): void => {\n    queueMicrotask(() => {\n      throw error instanceof Error ? error : new Error(String(error));\n    });\n  };\n\n  function duplicateGuard(): (messageId: string) => boolean {\n    const handled = new Set<string>();\n    return (messageId) => {\n      if (handled.has(messageId)) return false;\n      handled.add(messageId);\n      if (handled.size > duplicateWindow) handled.delete(handled.values().next().value as string);\n      return true;\n    };\n  }\n\n  function base(channel: string, kind: string, messageId = createMessageId(), correlationId?: string) {\n    return {\n      protocol: protocolName(channel),\n      version: 1 as const,\n      kind,\n      messageId,\n      ...(correlationId ? { correlationId } : {}),\n      source: options.source,\n      sessionId: options.sessionId,\n    };\n  }\n\n  return {\n    notify<TPayload extends TSchema>(definition: NotificationDefinition<TPayload>, payload: Static<TPayload>) {\n      assertValid(definition.channel, definition.payload, payload);\n      options.bus.emit(definition.channel, { ...base(definition.channel, definition.kind), payload });\n    },\n\n    onNotification<TPayload extends TSchema>(\n      definition: NotificationDefinition<TPayload>,\n      handler: (payload: Static<TPayload>, identity: ProtocolIdentity) => void | Promise<void>,\n    ) {\n      const schema = envelopeSchema(definition.payload);\n      const remember = duplicateGuard();\n      return options.bus.on(definition.channel, (message) => {\n        assertValid(definition.channel, schema, message);\n        const envelope = message as unknown as ProtocolEnvelope<Static<TPayload>>;\n        if (envelope.sessionId !== options.sessionId) return;\n        if (!remember(envelope.messageId)) return;\n        void Promise.resolve(handler(envelope.payload, envelope)).catch(rethrowAsync);\n      });\n    },\n\n    request<TRequest extends TSchema, TResponse extends TSchema>(\n      definition: RequestReplyDefinition<TRequest, TResponse>,\n      payload: Static<TRequest>,\n      requestOptions: RequestOptions = {},\n    ) {\n      assertValid(definition.requestChannel, definition.request, payload);\n      const messageId = createMessageId();\n      const responseSchema = envelopeSchema(definition.response);\n      const errorSchema = envelopeSchema(ProtocolErrorSchema);\n      return new Promise<Static<typeof definition.response>>((resolve, reject) => {\n        let settled = false;\n        const cleanups: Array<() => void> = [];\n        const finish = (action: () => void) => {\n          if (settled) return;\n          settled = true;\n          for (const cleanup of cleanups.splice(0)) cleanup();\n          action();\n        };\n        cleanups.push(\n          options.bus.on(definition.responseChannel, (message) => {\n            assertValid(definition.responseChannel, responseSchema, message);\n            const envelope = message as unknown as ProtocolEnvelope<Static<TResponse>>;\n            if (envelope.sessionId !== options.sessionId) return;\n            if (envelope.correlationId !== messageId) return;\n            if (requestOptions.expectedSource && envelope.source !== requestOptions.expectedSource) return;\n            finish(() => resolve(envelope.payload));\n          }),\n          options.bus.on(definition.errorChannel, (message) => {\n            assertValid(definition.errorChannel, errorSchema, message);\n            const envelope = message as unknown as ProtocolEnvelope<ProtocolErrorPayload>;\n            if (envelope.sessionId !== options.sessionId) return;\n            if (envelope.correlationId !== messageId) return;\n            if (requestOptions.expectedSource && envelope.source !== requestOptions.expectedSource) return;\n            finish(() => reject(new PoProtocolError(envelope.payload)));\n          }),\n        );\n        const timer = setTimeout(\n          () =>\n            finish(() =>\n              reject(\n                new PoProtocolError({\n                  code: PO_PROTOCOL_ERROR_CODE.timeout,\n                  message: `Timed out waiting for ${definition.responseKind}`,\n                }),\n              ),\n            ),\n          requestOptions.timeoutMs ?? timeoutDefault,\n        );\n        cleanups.push(() => clearTimeout(timer));\n        if (requestOptions.signal) {\n          const abort = () =>\n            finish(() =>\n              reject(new PoProtocolError({ code: PO_PROTOCOL_ERROR_CODE.aborted, message: 'Request aborted' })),\n            );\n          requestOptions.signal.addEventListener('abort', abort, { once: true });\n          cleanups.push(() => requestOptions.signal?.removeEventListener('abort', abort));\n          if (requestOptions.signal.aborted) return abort();\n        }\n        options.bus.emit(definition.requestChannel, {\n          ...base(definition.requestChannel, definition.requestKind, messageId),\n          payload,\n        });\n      });\n    },\n\n    provide<TRequest extends TSchema, TResponse extends TSchema>(\n      definition: RequestReplyDefinition<TRequest, TResponse>,\n      handler: (\n        payload: Static<TRequest>,\n        identity: ProtocolIdentity,\n      ) => Static<TResponse> | Promise<Static<TResponse>>,\n    ) {\n      const requestSchema = envelopeSchema(definition.request);\n      const remember = duplicateGuard();\n      return options.bus.on(definition.requestChannel, (message) => {\n        assertValid(definition.requestChannel, requestSchema, message);\n        const envelope = message as unknown as ProtocolEnvelope<Static<TRequest>>;\n        if (envelope.sessionId !== options.sessionId) return;\n        if (!remember(envelope.messageId)) return;\n        void Promise.resolve()\n          .then(() => handler(envelope.payload, envelope))\n          .then(\n            (payload) => {\n              assertValid(definition.responseChannel, definition.response, payload);\n              options.bus.emit(definition.responseChannel, {\n                ...base(definition.responseChannel, definition.responseKind, createMessageId(), envelope.messageId),\n                payload,\n              });\n            },\n            (error) => {\n              options.bus.emit(definition.errorChannel, {\n                ...base(definition.errorChannel, 'error', createMessageId(), envelope.messageId),\n                payload: asProtocolError(error),\n              });\n            },\n          );\n      });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/runtimeTransition.cjs

@@ -1,27 +1,27 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/schemas/transition.ts
 /** Cordis service name the Po host publishes its transition coordinator under. */
-const DOOM_TRANSITION_SERVICE = "doom/transition";
+const PO_TRANSITION_SERVICE = "po/transition";
 /**
 * Typed reads of the two host services off the session's cordis registry.
 *
 * Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should
 * declare the corresponding service name with `ctx.inject()` before reading it.
 */
-function readDoomTransitionCoordinator(root) {
-	return root.get(DOOM_TRANSITION_SERVICE);
+function readPoTransitionCoordinator(root) {
+	return root.get(PO_TRANSITION_SERVICE);
 }
 /**
 * The coordinator for an injected Cordis context.
 */
-function requireDoomTransitionCoordinator(context) {
-	const coordinator = readDoomTransitionCoordinator(context);
-	if (!coordinator) throw new Error("Doom transition coordinator is unavailable. Load the Po parent runtime.");
+function requirePoTransitionCoordinator(context) {
+	const coordinator = readPoTransitionCoordinator(context);
+	if (!coordinator) throw new Error("Po transition coordinator is unavailable. Load the Po parent runtime.");
 	return coordinator;
 }
 //#endregion
-exports.DOOM_TRANSITION_SERVICE = DOOM_TRANSITION_SERVICE;
-exports.readDoomTransitionCoordinator = readDoomTransitionCoordinator;
-exports.requireDoomTransitionCoordinator = requireDoomTransitionCoordinator;
+exports.PO_TRANSITION_SERVICE = PO_TRANSITION_SERVICE;
+exports.readPoTransitionCoordinator = readPoTransitionCoordinator;
+exports.requirePoTransitionCoordinator = requirePoTransitionCoordinator;
 
 //# sourceMappingURL=runtimeTransition.cjs.map

package/dist/runtimeTransition.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeTransition.cjs","names":[],"sources":["../src/schemas/transition.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\nexport type TransitionAxis = 'domains' | 'major-mode' | 'live' | 'profile';\n\nexport type TransitionDisposition = 'live' | 'reload' | 'relaunch' | 'sync-required';\n\nexport type TransitionExecutionStrategy = 'pi-reload' | 'process-relaunch';\n\nexport type TransitionOutcome = 'applied' | 'queued' | 'unchanged' | 'rejected' | 'stale';\n\nexport type TransitionSource = 'voice' | 'command' | 'leader' | 'ui' | 'system';\n\n/** Runtime identities captured when a transition enters the serialized queue. */\nexport interface TransitionGeneration {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly configGeneration?: string;\n}\n\nexport interface TransitionSelectionSnapshot {\n  readonly domains: readonly string[];\n  readonly majorMode: string;\n  readonly layers: readonly string[];\n  readonly profile?: string;\n  readonly compositionFingerprint?: string;\n  readonly parentActivation?: readonly string[];\n  readonly childActivation?: readonly string[];\n}\n\nexport interface DomainTransitionTarget {\n  readonly axis: 'domains';\n  readonly domains: readonly string[];\n}\n\nexport interface MajorModeTransitionTarget {\n  readonly axis: 'major-mode';\n  readonly majorMode: string;\n}\n\nexport interface LiveTransitionTarget {\n  readonly axis: 'live';\n  readonly capability: string;\n}\n\nexport interface ProfileTransitionTarget {\n  readonly axis: 'profile';\n  readonly profile: string;\n}\n\nexport type TransitionTarget =\n  | DomainTransitionTarget\n  | MajorModeTransitionTarget\n  | LiveTransitionTarget\n  | ProfileTransitionTarget;\n\nexport interface DoomTransitionRequest {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly operationId: string;\n  readonly source: TransitionSource;\n  readonly target: TransitionTarget;\n  readonly signal?: AbortSignal;\n}\n\nexport type TransitionSynchronization =\n  | { readonly kind: 'launcher' }\n  /**\n   * A launcher session whose Pi entry resolves its composition on every load.\n   *\n   * Pi freezes the CLI extension list at construction, so a session handed a\n   * fingerprint-named bundle cannot change composition without a new process.\n   * One entry that reads the selection when its factory runs lifts that limit:\n   * the list Pi holds never changes, and a reload composes again. Such a\n   * session is never `sync-required`, because the entry falls back to the\n   * individual extension paths when no aggregate has been built yet.\n   */\n  | { readonly kind: 'launcher-composed' }\n  | {\n      readonly kind: 'synchronized';\n      readonly resolutionAvailable: boolean;\n      readonly availableCompositionFingerprints: readonly string[];\n    };\n\nexport type TransitionDiagnosticCode =\n  | 'transition.live.capability'\n  | 'transition.no-change'\n  | 'transition.reload.domains'\n  | 'transition.reload.major-mode'\n  | 'transition.reload.profile'\n  | 'transition.rejected.aborted'\n  | 'transition.rejected.duplicate'\n  | 'transition.rejected.execution'\n  | 'transition.rejected.unavailable'\n  | 'transition.relaunch.extension-closure'\n  | 'transition.stale.generation'\n  | 'transition.stale.config'\n  | 'transition.stale.session'\n  | 'transition.sync-required.artifact'\n  | 'transition.sync-required.resolution';\n\nexport interface DoomTransitionPlan {\n  readonly operationId: string;\n  readonly axis: TransitionAxis;\n  readonly disposition: TransitionDisposition;\n  readonly strategy?: TransitionExecutionStrategy;\n  readonly previous: TransitionSelectionSnapshot;\n  readonly candidate: TransitionSelectionSnapshot;\n  readonly diagnostics: readonly TransitionDiagnosticCode[];\n  readonly reloadHandoffRequired: boolean;\n  readonly externalRelaunchRequired: boolean;\n}\n\nexport interface DoomTransitionResult extends DoomTransitionPlan {\n  readonly outcome: TransitionOutcome;\n}\n\nexport type StructuralTransitionExecution = (\n  request: DoomTransitionRequest,\n  plan: DoomTransitionPlan,\n) => Promise<TransitionOutcome>;\n\n/** Cordis service name the Po host publishes its transition coordinator under. */\nexport const DOOM_TRANSITION_SERVICE = 'doom/transition';\n\n/**\n * The session-scoped object that serializes structural transitions.\n *\n * Declared here rather than beside its implementation because the packages that\n * drive the selection axes resolve it from the session and must not depend on\n * the host that builds it. plan() is deliberately synchronous and the result\n * carries live values, so this contract is an in-process handle, not a wire\n * protocol.\n */\nexport interface DoomTransitionCoordinator {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  plan(request: DoomTransitionRequest): DoomTransitionPlan;\n  execute(\n    request: DoomTransitionRequest,\n    executeStructural?: StructuralTransitionExecution,\n  ): Promise<DoomTransitionResult>;\n  dispose(): void;\n}\n\n/**\n * Typed reads of the two host services off the session's cordis registry.\n *\n * Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should\n * declare the corresponding service name with `ctx.inject()` before reading it.\n */\nexport function readDoomTransitionCoordinator(root: Context): DoomTransitionCoordinator | undefined {\n  return root.get(DOOM_TRANSITION_SERVICE) as DoomTransitionCoordinator | undefined;\n}\n\n/**\n * The coordinator for an injected Cordis context.\n */\nexport function requireDoomTransitionCoordinator(context: Context): DoomTransitionCoordinator {\n  const coordinator = readDoomTransitionCoordinator(context);\n  if (!coordinator) throw new Error('Doom transition coordinator is unavailable. Load the Po parent runtime.');\n  return coordinator;\n}\n"],"mappings":";;;AA0HA,MAAa,0BAA0B;;;;;;;AA4BvC,SAAgB,8BAA8B,MAAsD;CAClG,OAAO,KAAK,IAAI,uBAAuB;AACzC;;;;AAKA,SAAgB,iCAAiC,SAA6C;CAC5F,MAAM,cAAc,8BAA8B,OAAO;CACzD,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,yEAAyE;CAC3G,OAAO;AACT"}
+{"version":3,"file":"runtimeTransition.cjs","names":[],"sources":["../src/schemas/transition.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\nexport type TransitionAxis = 'domains' | 'major-mode' | 'live' | 'profile';\n\nexport type TransitionDisposition = 'live' | 'reload' | 'relaunch' | 'sync-required';\n\nexport type TransitionExecutionStrategy = 'pi-reload' | 'process-relaunch';\n\nexport type TransitionOutcome = 'applied' | 'queued' | 'unchanged' | 'rejected' | 'stale';\n\nexport type TransitionSource = 'voice' | 'command' | 'leader' | 'ui' | 'system';\n\n/** Runtime identities captured when a transition enters the serialized queue. */\nexport interface TransitionGeneration {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly configGeneration?: string;\n}\n\nexport interface TransitionSelectionSnapshot {\n  readonly domains: readonly string[];\n  readonly majorMode: string;\n  readonly layers: readonly string[];\n  readonly profile?: string;\n  readonly compositionFingerprint?: string;\n  readonly parentActivation?: readonly string[];\n  readonly childActivation?: readonly string[];\n}\n\nexport interface DomainTransitionTarget {\n  readonly axis: 'domains';\n  readonly domains: readonly string[];\n}\n\nexport interface MajorModeTransitionTarget {\n  readonly axis: 'major-mode';\n  readonly majorMode: string;\n}\n\nexport interface LiveTransitionTarget {\n  readonly axis: 'live';\n  readonly capability: string;\n}\n\nexport interface ProfileTransitionTarget {\n  readonly axis: 'profile';\n  readonly profile: string;\n}\n\nexport type TransitionTarget =\n  | DomainTransitionTarget\n  | MajorModeTransitionTarget\n  | LiveTransitionTarget\n  | ProfileTransitionTarget;\n\nexport interface PoTransitionRequest {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly operationId: string;\n  readonly source: TransitionSource;\n  readonly target: TransitionTarget;\n  readonly signal?: AbortSignal;\n}\n\nexport type TransitionSynchronization =\n  | { readonly kind: 'launcher' }\n  /**\n   * A launcher session whose Pi entry resolves its composition on every load.\n   *\n   * Pi freezes the CLI extension list at construction, so a session handed a\n   * fingerprint-named bundle cannot change composition without a new process.\n   * One entry that reads the selection when its factory runs lifts that limit:\n   * the list Pi holds never changes, and a reload composes again. Such a\n   * session is never `sync-required`, because the entry falls back to the\n   * individual extension paths when no aggregate has been built yet.\n   */\n  | { readonly kind: 'launcher-composed' }\n  | {\n      readonly kind: 'synchronized';\n      readonly resolutionAvailable: boolean;\n      readonly availableCompositionFingerprints: readonly string[];\n    };\n\nexport type TransitionDiagnosticCode =\n  | 'transition.live.capability'\n  | 'transition.no-change'\n  | 'transition.reload.domains'\n  | 'transition.reload.major-mode'\n  | 'transition.reload.profile'\n  | 'transition.rejected.aborted'\n  | 'transition.rejected.duplicate'\n  | 'transition.rejected.execution'\n  | 'transition.rejected.unavailable'\n  | 'transition.relaunch.extension-closure'\n  | 'transition.stale.generation'\n  | 'transition.stale.config'\n  | 'transition.stale.session'\n  | 'transition.sync-required.artifact'\n  | 'transition.sync-required.resolution';\n\nexport interface PoTransitionPlan {\n  readonly operationId: string;\n  readonly axis: TransitionAxis;\n  readonly disposition: TransitionDisposition;\n  readonly strategy?: TransitionExecutionStrategy;\n  readonly previous: TransitionSelectionSnapshot;\n  readonly candidate: TransitionSelectionSnapshot;\n  readonly diagnostics: readonly TransitionDiagnosticCode[];\n  readonly reloadHandoffRequired: boolean;\n  readonly externalRelaunchRequired: boolean;\n}\n\nexport interface PoTransitionResult extends PoTransitionPlan {\n  readonly outcome: TransitionOutcome;\n}\n\nexport type StructuralTransitionExecution = (\n  request: PoTransitionRequest,\n  plan: PoTransitionPlan,\n) => Promise<TransitionOutcome>;\n\n/** Cordis service name the Po host publishes its transition coordinator under. */\nexport const PO_TRANSITION_SERVICE = 'po/transition';\n\n/**\n * The session-scoped object that serializes structural transitions.\n *\n * Declared here rather than beside its implementation because the packages that\n * drive the selection axes resolve it from the session and must not depend on\n * the host that builds it. plan() is deliberately synchronous and the result\n * carries live values, so this contract is an in-process handle, not a wire\n * protocol.\n */\nexport interface PoTransitionCoordinator {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  plan(request: PoTransitionRequest): PoTransitionPlan;\n  execute(request: PoTransitionRequest, executeStructural?: StructuralTransitionExecution): Promise<PoTransitionResult>;\n  dispose(): void;\n}\n\n/**\n * Typed reads of the two host services off the session's cordis registry.\n *\n * Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should\n * declare the corresponding service name with `ctx.inject()` before reading it.\n */\nexport function readPoTransitionCoordinator(root: Context): PoTransitionCoordinator | undefined {\n  return root.get(PO_TRANSITION_SERVICE) as PoTransitionCoordinator | undefined;\n}\n\n/**\n * The coordinator for an injected Cordis context.\n */\nexport function requirePoTransitionCoordinator(context: Context): PoTransitionCoordinator {\n  const coordinator = readPoTransitionCoordinator(context);\n  if (!coordinator) throw new Error('Po transition coordinator is unavailable. Load the Po parent runtime.');\n  return coordinator;\n}\n"],"mappings":";;;AA0HA,MAAa,wBAAwB;;;;;;;AAyBrC,SAAgB,4BAA4B,MAAoD;CAC9F,OAAO,KAAK,IAAI,qBAAqB;AACvC;;;;AAKA,SAAgB,+BAA+B,SAA2C;CACxF,MAAM,cAAc,4BAA4B,OAAO;CACvD,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,uEAAuE;CACzG,OAAO;AACT"}

package/dist/runtimeTransition.d.mts

@@ -37,7 +37,7 @@ export interface ProfileTransitionTarget {
   readonly profile: string;
 }
 export type TransitionTarget = DomainTransitionTarget | MajorModeTransitionTarget | LiveTransitionTarget | ProfileTransitionTarget;
-export interface DoomTransitionRequest {
+export interface PoTransitionRequest {
   readonly sessionId: string;
   readonly hostGeneration: string;
   readonly operationId: string;
@@ -66,7 +66,7 @@ export type TransitionSynchronization = {
   readonly availableCompositionFingerprints: readonly string[];
 };
 export type TransitionDiagnosticCode = 'transition.live.capability' | 'transition.no-change' | 'transition.reload.domains' | 'transition.reload.major-mode' | 'transition.reload.profile' | 'transition.rejected.aborted' | 'transition.rejected.duplicate' | 'transition.rejected.execution' | 'transition.rejected.unavailable' | 'transition.relaunch.extension-closure' | 'transition.stale.generation' | 'transition.stale.config' | 'transition.stale.session' | 'transition.sync-required.artifact' | 'transition.sync-required.resolution';
-export interface DoomTransitionPlan {
+export interface PoTransitionPlan {
   readonly operationId: string;
   readonly axis: TransitionAxis;
   readonly disposition: TransitionDisposition;
@@ -77,12 +77,12 @@ export interface DoomTransitionPlan {
   readonly reloadHandoffRequired: boolean;
   readonly externalRelaunchRequired: boolean;
 }
-export interface DoomTransitionResult extends DoomTransitionPlan {
+export interface PoTransitionResult extends PoTransitionPlan {
   readonly outcome: TransitionOutcome;
 }
-export type StructuralTransitionExecution = (request: DoomTransitionRequest, plan: DoomTransitionPlan) => Promise<TransitionOutcome>;
+export type StructuralTransitionExecution = (request: PoTransitionRequest, plan: PoTransitionPlan) => Promise<TransitionOutcome>;
 /** Cordis service name the Po host publishes its transition coordinator under. */
-export declare const DOOM_TRANSITION_SERVICE = "doom/transition";
+export declare const PO_TRANSITION_SERVICE = "po/transition";
 /**
  * The session-scoped object that serializes structural transitions.
  *
@@ -92,11 +92,11 @@ export declare const DOOM_TRANSITION_SERVICE = "doom/transition";
  * carries live values, so this contract is an in-process handle, not a wire
  * protocol.
  */
-export interface DoomTransitionCoordinator {
+export interface PoTransitionCoordinator {
   readonly sessionId: string;
   readonly hostGeneration: string;
-  plan(request: DoomTransitionRequest): DoomTransitionPlan;
-  execute(request: DoomTransitionRequest, executeStructural?: StructuralTransitionExecution): Promise<DoomTransitionResult>;
+  plan(request: PoTransitionRequest): PoTransitionPlan;
+  execute(request: PoTransitionRequest, executeStructural?: StructuralTransitionExecution): Promise<PoTransitionResult>;
   dispose(): void;
 }
 /**
@@ -105,10 +105,10 @@ export interface DoomTransitionCoordinator {
  * Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should
  * declare the corresponding service name with `ctx.inject()` before reading it.
  */
-export declare function readDoomTransitionCoordinator(root: Context): DoomTransitionCoordinator | undefined;
+export declare function readPoTransitionCoordinator(root: Context): PoTransitionCoordinator | undefined;
 /**
  * The coordinator for an injected Cordis context.
  */
-export declare function requireDoomTransitionCoordinator(context: Context): DoomTransitionCoordinator;
+export declare function requirePoTransitionCoordinator(context: Context): PoTransitionCoordinator;
 //#endregion
 //# sourceMappingURL=runtimeTransition.d.mts.map

package/dist/runtimeTransition.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeTransition.d.mts","names":[],"sources":["../src/schemas/transition.ts"],"mappings":";;YAEY;YAEA;YAEA;YAEA;YAEA;;iBAGK;WACN;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;YAGC,mBACR,yBACA,4BACA,uBACA;iBAEa;WACN;WACA;WACA;WACA,QAAQ;WACR,QAAQ;WACR,SAAS;;YAGR;WACG;;;;;;;;;;;;;WAWA;;WAEA;WACA;WACA;;YAGH;iBAiBK;WACN;WACA,MAAM;WACN,aAAa;WACb,WAAW;WACX,UAAU;WACV,WAAW;WACX,sBAAsB;WACtB;WACA;;iBAGM,6BAA6B;WACnC,SAAS;;YAGR,iCACV,SAAS,uBACT,MAAM,uBACH,QAAQ;;qBAGA;;;;;;;;;;iBAWI;WACN;WACA;EACT,KAAK,SAAS,wBAAwB;EACtC,QACE,SAAS,uBACT,oBAAoB,gCACnB,QAAQ;EACX;;;;;;;;wBASc,8BAA8B,MAAM,UAAU;;;;wBAO9C,iCAAiC,SAAS,UAAU"}
+{"version":3,"file":"runtimeTransition.d.mts","names":[],"sources":["../src/schemas/transition.ts"],"mappings":";;YAEY;YAEA;YAEA;YAEA;YAEA;;iBAGK;WACN;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;YAGC,mBACR,yBACA,4BACA,uBACA;iBAEa;WACN;WACA;WACA;WACA,QAAQ;WACR,QAAQ;WACR,SAAS;;YAGR;WACG;;;;;;;;;;;;;WAWA;;WAEA;WACA;WACA;;YAGH;iBAiBK;WACN;WACA,MAAM;WACN,aAAa;WACb,WAAW;WACX,UAAU;WACV,WAAW;WACX,sBAAsB;WACtB;WACA;;iBAGM,2BAA2B;WACjC,SAAS;;YAGR,iCACV,SAAS,qBACT,MAAM,qBACH,QAAQ;;qBAGA;;;;;;;;;;iBAWI;WACN;WACA;EACT,KAAK,SAAS,sBAAsB;EACpC,QAAQ,SAAS,qBAAqB,oBAAoB,gCAAgC,QAAQ;EAClG;;;;;;;;wBASc,4BAA4B,MAAM,UAAU;;;;wBAO5C,+BAA+B,SAAS,UAAU"}

package/dist/runtimeTransition.mjs

@@ -1,24 +1,24 @@
 //#region src/schemas/transition.ts
 /** Cordis service name the Po host publishes its transition coordinator under. */
-const DOOM_TRANSITION_SERVICE = "doom/transition";
+const PO_TRANSITION_SERVICE = "po/transition";
 /**
 * Typed reads of the two host services off the session's cordis registry.
 *
 * Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should
 * declare the corresponding service name with `ctx.inject()` before reading it.
 */
-function readDoomTransitionCoordinator(root) {
-	return root.get(DOOM_TRANSITION_SERVICE);
+function readPoTransitionCoordinator(root) {
+	return root.get(PO_TRANSITION_SERVICE);
 }
 /**
 * The coordinator for an injected Cordis context.
 */
-function requireDoomTransitionCoordinator(context) {
-	const coordinator = readDoomTransitionCoordinator(context);
-	if (!coordinator) throw new Error("Doom transition coordinator is unavailable. Load the Po parent runtime.");
+function requirePoTransitionCoordinator(context) {
+	const coordinator = readPoTransitionCoordinator(context);
+	if (!coordinator) throw new Error("Po transition coordinator is unavailable. Load the Po parent runtime.");
 	return coordinator;
 }
 //#endregion
-export { DOOM_TRANSITION_SERVICE, readDoomTransitionCoordinator, requireDoomTransitionCoordinator };
+export { PO_TRANSITION_SERVICE, readPoTransitionCoordinator, requirePoTransitionCoordinator };
 
 //# sourceMappingURL=runtimeTransition.mjs.map

package/dist/runtimeTransition.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeTransition.mjs","names":[],"sources":["../src/schemas/transition.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\nexport type TransitionAxis = 'domains' | 'major-mode' | 'live' | 'profile';\n\nexport type TransitionDisposition = 'live' | 'reload' | 'relaunch' | 'sync-required';\n\nexport type TransitionExecutionStrategy = 'pi-reload' | 'process-relaunch';\n\nexport type TransitionOutcome = 'applied' | 'queued' | 'unchanged' | 'rejected' | 'stale';\n\nexport type TransitionSource = 'voice' | 'command' | 'leader' | 'ui' | 'system';\n\n/** Runtime identities captured when a transition enters the serialized queue. */\nexport interface TransitionGeneration {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly configGeneration?: string;\n}\n\nexport interface TransitionSelectionSnapshot {\n  readonly domains: readonly string[];\n  readonly majorMode: string;\n  readonly layers: readonly string[];\n  readonly profile?: string;\n  readonly compositionFingerprint?: string;\n  readonly parentActivation?: readonly string[];\n  readonly childActivation?: readonly string[];\n}\n\nexport interface DomainTransitionTarget {\n  readonly axis: 'domains';\n  readonly domains: readonly string[];\n}\n\nexport interface MajorModeTransitionTarget {\n  readonly axis: 'major-mode';\n  readonly majorMode: string;\n}\n\nexport interface LiveTransitionTarget {\n  readonly axis: 'live';\n  readonly capability: string;\n}\n\nexport interface ProfileTransitionTarget {\n  readonly axis: 'profile';\n  readonly profile: string;\n}\n\nexport type TransitionTarget =\n  | DomainTransitionTarget\n  | MajorModeTransitionTarget\n  | LiveTransitionTarget\n  | ProfileTransitionTarget;\n\nexport interface DoomTransitionRequest {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly operationId: string;\n  readonly source: TransitionSource;\n  readonly target: TransitionTarget;\n  readonly signal?: AbortSignal;\n}\n\nexport type TransitionSynchronization =\n  | { readonly kind: 'launcher' }\n  /**\n   * A launcher session whose Pi entry resolves its composition on every load.\n   *\n   * Pi freezes the CLI extension list at construction, so a session handed a\n   * fingerprint-named bundle cannot change composition without a new process.\n   * One entry that reads the selection when its factory runs lifts that limit:\n   * the list Pi holds never changes, and a reload composes again. Such a\n   * session is never `sync-required`, because the entry falls back to the\n   * individual extension paths when no aggregate has been built yet.\n   */\n  | { readonly kind: 'launcher-composed' }\n  | {\n      readonly kind: 'synchronized';\n      readonly resolutionAvailable: boolean;\n      readonly availableCompositionFingerprints: readonly string[];\n    };\n\nexport type TransitionDiagnosticCode =\n  | 'transition.live.capability'\n  | 'transition.no-change'\n  | 'transition.reload.domains'\n  | 'transition.reload.major-mode'\n  | 'transition.reload.profile'\n  | 'transition.rejected.aborted'\n  | 'transition.rejected.duplicate'\n  | 'transition.rejected.execution'\n  | 'transition.rejected.unavailable'\n  | 'transition.relaunch.extension-closure'\n  | 'transition.stale.generation'\n  | 'transition.stale.config'\n  | 'transition.stale.session'\n  | 'transition.sync-required.artifact'\n  | 'transition.sync-required.resolution';\n\nexport interface DoomTransitionPlan {\n  readonly operationId: string;\n  readonly axis: TransitionAxis;\n  readonly disposition: TransitionDisposition;\n  readonly strategy?: TransitionExecutionStrategy;\n  readonly previous: TransitionSelectionSnapshot;\n  readonly candidate: TransitionSelectionSnapshot;\n  readonly diagnostics: readonly TransitionDiagnosticCode[];\n  readonly reloadHandoffRequired: boolean;\n  readonly externalRelaunchRequired: boolean;\n}\n\nexport interface DoomTransitionResult extends DoomTransitionPlan {\n  readonly outcome: TransitionOutcome;\n}\n\nexport type StructuralTransitionExecution = (\n  request: DoomTransitionRequest,\n  plan: DoomTransitionPlan,\n) => Promise<TransitionOutcome>;\n\n/** Cordis service name the Po host publishes its transition coordinator under. */\nexport const DOOM_TRANSITION_SERVICE = 'doom/transition';\n\n/**\n * The session-scoped object that serializes structural transitions.\n *\n * Declared here rather than beside its implementation because the packages that\n * drive the selection axes resolve it from the session and must not depend on\n * the host that builds it. plan() is deliberately synchronous and the result\n * carries live values, so this contract is an in-process handle, not a wire\n * protocol.\n */\nexport interface DoomTransitionCoordinator {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  plan(request: DoomTransitionRequest): DoomTransitionPlan;\n  execute(\n    request: DoomTransitionRequest,\n    executeStructural?: StructuralTransitionExecution,\n  ): Promise<DoomTransitionResult>;\n  dispose(): void;\n}\n\n/**\n * Typed reads of the two host services off the session's cordis registry.\n *\n * Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should\n * declare the corresponding service name with `ctx.inject()` before reading it.\n */\nexport function readDoomTransitionCoordinator(root: Context): DoomTransitionCoordinator | undefined {\n  return root.get(DOOM_TRANSITION_SERVICE) as DoomTransitionCoordinator | undefined;\n}\n\n/**\n * The coordinator for an injected Cordis context.\n */\nexport function requireDoomTransitionCoordinator(context: Context): DoomTransitionCoordinator {\n  const coordinator = readDoomTransitionCoordinator(context);\n  if (!coordinator) throw new Error('Doom transition coordinator is unavailable. Load the Po parent runtime.');\n  return coordinator;\n}\n"],"mappings":";;AA0HA,MAAa,0BAA0B;;;;;;;AA4BvC,SAAgB,8BAA8B,MAAsD;CAClG,OAAO,KAAK,IAAI,uBAAuB;AACzC;;;;AAKA,SAAgB,iCAAiC,SAA6C;CAC5F,MAAM,cAAc,8BAA8B,OAAO;CACzD,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,yEAAyE;CAC3G,OAAO;AACT"}
+{"version":3,"file":"runtimeTransition.mjs","names":[],"sources":["../src/schemas/transition.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\nexport type TransitionAxis = 'domains' | 'major-mode' | 'live' | 'profile';\n\nexport type TransitionDisposition = 'live' | 'reload' | 'relaunch' | 'sync-required';\n\nexport type TransitionExecutionStrategy = 'pi-reload' | 'process-relaunch';\n\nexport type TransitionOutcome = 'applied' | 'queued' | 'unchanged' | 'rejected' | 'stale';\n\nexport type TransitionSource = 'voice' | 'command' | 'leader' | 'ui' | 'system';\n\n/** Runtime identities captured when a transition enters the serialized queue. */\nexport interface TransitionGeneration {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly configGeneration?: string;\n}\n\nexport interface TransitionSelectionSnapshot {\n  readonly domains: readonly string[];\n  readonly majorMode: string;\n  readonly layers: readonly string[];\n  readonly profile?: string;\n  readonly compositionFingerprint?: string;\n  readonly parentActivation?: readonly string[];\n  readonly childActivation?: readonly string[];\n}\n\nexport interface DomainTransitionTarget {\n  readonly axis: 'domains';\n  readonly domains: readonly string[];\n}\n\nexport interface MajorModeTransitionTarget {\n  readonly axis: 'major-mode';\n  readonly majorMode: string;\n}\n\nexport interface LiveTransitionTarget {\n  readonly axis: 'live';\n  readonly capability: string;\n}\n\nexport interface ProfileTransitionTarget {\n  readonly axis: 'profile';\n  readonly profile: string;\n}\n\nexport type TransitionTarget =\n  | DomainTransitionTarget\n  | MajorModeTransitionTarget\n  | LiveTransitionTarget\n  | ProfileTransitionTarget;\n\nexport interface PoTransitionRequest {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly operationId: string;\n  readonly source: TransitionSource;\n  readonly target: TransitionTarget;\n  readonly signal?: AbortSignal;\n}\n\nexport type TransitionSynchronization =\n  | { readonly kind: 'launcher' }\n  /**\n   * A launcher session whose Pi entry resolves its composition on every load.\n   *\n   * Pi freezes the CLI extension list at construction, so a session handed a\n   * fingerprint-named bundle cannot change composition without a new process.\n   * One entry that reads the selection when its factory runs lifts that limit:\n   * the list Pi holds never changes, and a reload composes again. Such a\n   * session is never `sync-required`, because the entry falls back to the\n   * individual extension paths when no aggregate has been built yet.\n   */\n  | { readonly kind: 'launcher-composed' }\n  | {\n      readonly kind: 'synchronized';\n      readonly resolutionAvailable: boolean;\n      readonly availableCompositionFingerprints: readonly string[];\n    };\n\nexport type TransitionDiagnosticCode =\n  | 'transition.live.capability'\n  | 'transition.no-change'\n  | 'transition.reload.domains'\n  | 'transition.reload.major-mode'\n  | 'transition.reload.profile'\n  | 'transition.rejected.aborted'\n  | 'transition.rejected.duplicate'\n  | 'transition.rejected.execution'\n  | 'transition.rejected.unavailable'\n  | 'transition.relaunch.extension-closure'\n  | 'transition.stale.generation'\n  | 'transition.stale.config'\n  | 'transition.stale.session'\n  | 'transition.sync-required.artifact'\n  | 'transition.sync-required.resolution';\n\nexport interface PoTransitionPlan {\n  readonly operationId: string;\n  readonly axis: TransitionAxis;\n  readonly disposition: TransitionDisposition;\n  readonly strategy?: TransitionExecutionStrategy;\n  readonly previous: TransitionSelectionSnapshot;\n  readonly candidate: TransitionSelectionSnapshot;\n  readonly diagnostics: readonly TransitionDiagnosticCode[];\n  readonly reloadHandoffRequired: boolean;\n  readonly externalRelaunchRequired: boolean;\n}\n\nexport interface PoTransitionResult extends PoTransitionPlan {\n  readonly outcome: TransitionOutcome;\n}\n\nexport type StructuralTransitionExecution = (\n  request: PoTransitionRequest,\n  plan: PoTransitionPlan,\n) => Promise<TransitionOutcome>;\n\n/** Cordis service name the Po host publishes its transition coordinator under. */\nexport const PO_TRANSITION_SERVICE = 'po/transition';\n\n/**\n * The session-scoped object that serializes structural transitions.\n *\n * Declared here rather than beside its implementation because the packages that\n * drive the selection axes resolve it from the session and must not depend on\n * the host that builds it. plan() is deliberately synchronous and the result\n * carries live values, so this contract is an in-process handle, not a wire\n * protocol.\n */\nexport interface PoTransitionCoordinator {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  plan(request: PoTransitionRequest): PoTransitionPlan;\n  execute(request: PoTransitionRequest, executeStructural?: StructuralTransitionExecution): Promise<PoTransitionResult>;\n  dispose(): void;\n}\n\n/**\n * Typed reads of the two host services off the session's cordis registry.\n *\n * Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should\n * declare the corresponding service name with `ctx.inject()` before reading it.\n */\nexport function readPoTransitionCoordinator(root: Context): PoTransitionCoordinator | undefined {\n  return root.get(PO_TRANSITION_SERVICE) as PoTransitionCoordinator | undefined;\n}\n\n/**\n * The coordinator for an injected Cordis context.\n */\nexport function requirePoTransitionCoordinator(context: Context): PoTransitionCoordinator {\n  const coordinator = readPoTransitionCoordinator(context);\n  if (!coordinator) throw new Error('Po transition coordinator is unavailable. Load the Po parent runtime.');\n  return coordinator;\n}\n"],"mappings":";;AA0HA,MAAa,wBAAwB;;;;;;;AAyBrC,SAAgB,4BAA4B,MAAoD;CAC9F,OAAO,KAAK,IAAI,qBAAqB;AACvC;;;;AAKA,SAAgB,+BAA+B,SAA2C;CACxF,MAAM,cAAc,4BAA4B,OAAO;CACvD,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,uEAAuE;CACzG,OAAO;AACT"}

package/dist/sandboxHarness.mjs

@@ -1,2 +1 @@
-import { PO_SANDBOX_ENV, SANDBOX_HARNESS_EXPORT_SUBPATH, insideSandbox, isSandboxHarnessModule } from "./src/schemas/sandboxHarness.mjs";
-export { PO_SANDBOX_ENV, SANDBOX_HARNESS_EXPORT_SUBPATH, insideSandbox, isSandboxHarnessModule };
+export { PO_SANDBOX_ENV, SANDBOX_HARNESS_EXPORT_SUBPATH, insideSandbox, isSandboxHarnessModule } from "./src/schemas/sandboxHarness.mjs";

package/dist/server.cjs

@@ -1,17 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_index = require("./src/services/rpcTranscript/index.cjs");
+const require_directHarnessRuntime = require("./src/server/directHarnessRuntime.cjs");
 const require_piSessionRuntime = require("./src/pi/piSessionRuntime.cjs");
 const require_headlessChildSessionService = require("./src/systems/child/adapters/headlessChildSessionService.cjs");
 const require_headlessHub = require("./headlessHub.cjs");
 const require_headlessServer = require("./headlessServer.cjs");
-const require_terminalPiChildSessionService = require("./terminalPiChildSessionService.cjs");
-exports.captureTerminalPiForkSource = require_terminalPiChildSessionService.captureTerminalPiForkSource;
-exports.createAgentServerService = require_piSessionRuntime.createAgentServerService;
 exports.createAgentSessionRuntime = require_piSessionRuntime.createAgentSessionRuntime;
+exports.createDirectHarnessRuntime = require_directHarnessRuntime.createDirectHarnessRuntime;
 exports.createHeadlessChildSessionService = require_headlessChildSessionService.createHeadlessChildSessionService;
 exports.createHeadlessChildSessionServiceProvider = require_headlessChildSessionService.createHeadlessChildSessionServiceProvider;
 exports.createHeadlessHub = require_headlessHub.createHeadlessHub;
-exports.createRpcTranscript = require_index.createRpcTranscript;
-exports.createTerminalPiChildSessionService = require_terminalPiChildSessionService.createTerminalPiChildSessionService;
-exports.createTerminalPiChildSessionServiceProvider = require_terminalPiChildSessionService.createTerminalPiChildSessionServiceProvider;
+exports.serveAgentSessions = require_piSessionRuntime.serveAgentSessions;
 exports.serveHeadlessServer = require_headlessServer.serveHeadlessServer;

package/dist/server.d.mts

@@ -1,10 +1,10 @@
-import { HeadlessSessionHost, HeadlessSessionHostOptions } from "./headlessSessionHost.mjs";
+import { DirectHarnessRuntime, DirectHarnessRuntimeOptions } from "./src/types/server/directHarnessRuntime.mjs";
+import { HeadlessModelDependencies, HeadlessPiExtensionsInput, HeadlessSessionHost, HeadlessSessionHostOptions, PoModelRuntime } from "./headlessSessionHost.mjs";
 import { HeadlessSessionManager, HeadlessSessionManagerCreateOptions } from "./runtimeHeadlessSessionManager.mjs";
 import { HeadlessHub, HeadlessHubEvent, HeadlessHubOptions, HeadlessHubSession, createHeadlessHub } from "./headlessHub.mjs";
 import { HeadlessServer, HeadlessServerOptions, serveHeadlessServer } from "./headlessServer.mjs";
-import { HeadlessChildSessionServiceOptions, HeadlessChildSessionServiceProvider, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider } from "./src/systems/child/adapters/headlessChildSessionService.mjs";
-import { TerminalPiChildSessionServiceOptions, TerminalPiChildSessionServiceProvider, TerminalPiForkSourceManager, captureTerminalPiForkSource, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider } from "./terminalPiChildSessionService.mjs";
+import { createDirectHarnessRuntime } from "./src/server/directHarnessRuntime.mjs";
+import { HeadlessChildSessionService, HeadlessChildSessionServiceOptions, HeadlessChildSessionServiceProvider, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider } from "./src/systems/child/adapters/headlessChildSessionService.mjs";
+import { AgentSessionBinding, AgentSessionRuntime, AgentSessionRuntimeOptions, createAgentSessionRuntime, serveAgentSessions } from "./src/pi/piSessionRuntime.mjs";
 import { SessionFrame } from "./src/types/server/session.mjs";
-import { RpcTranscript, RpcTranscriptOptions, TranscriptReduction, createRpcTranscript } from "./src/services/rpcTranscript/index.mjs";
-import { AgentServerServiceOptions, AgentSessionRuntime, AgentSessionRuntimeOptions, DoomSessionMetadata, createAgentServerService, createAgentSessionRuntime } from "./src/pi/piSessionRuntime.mjs";
-export { type AgentServerServiceOptions, type AgentSessionRuntime, type AgentSessionRuntimeOptions, type DoomSessionMetadata, type HeadlessChildSessionServiceOptions, type HeadlessChildSessionServiceProvider, type HeadlessHub, type HeadlessHubEvent, type HeadlessHubOptions, type HeadlessHubSession, type HeadlessServer, type HeadlessServerOptions, type HeadlessSessionHost, type HeadlessSessionHostOptions, type HeadlessSessionManager, type HeadlessSessionManagerCreateOptions, type RpcTranscript, type RpcTranscriptOptions, type SessionFrame, type TerminalPiChildSessionServiceOptions, type TerminalPiChildSessionServiceProvider, type TerminalPiForkSourceManager, type TranscriptReduction, captureTerminalPiForkSource, createAgentServerService, createAgentSessionRuntime, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider, createHeadlessHub, createRpcTranscript, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider, serveHeadlessServer };
+export { type AgentSessionBinding, type AgentSessionRuntime, type AgentSessionRuntimeOptions, type DirectHarnessRuntime, type DirectHarnessRuntimeOptions, type HeadlessChildSessionService, type HeadlessChildSessionServiceOptions, type HeadlessChildSessionServiceProvider, type HeadlessHub, type HeadlessHubEvent, type HeadlessHubOptions, type HeadlessHubSession, type HeadlessModelDependencies, type HeadlessPiExtensionsInput, type HeadlessServer, type HeadlessServerOptions, type HeadlessSessionHost, type HeadlessSessionHostOptions, type HeadlessSessionManager, type HeadlessSessionManagerCreateOptions, type PoModelRuntime, type SessionFrame, createAgentSessionRuntime, createDirectHarnessRuntime, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider, createHeadlessHub, serveAgentSessions, serveHeadlessServer };

package/dist/server.mjs

@@ -1,7 +1,6 @@
-import { createRpcTranscript } from "./src/services/rpcTranscript/index.mjs";
-import { createAgentServerService, createAgentSessionRuntime } from "./src/pi/piSessionRuntime.mjs";
+import { createDirectHarnessRuntime } from "./src/server/directHarnessRuntime.mjs";
+import { createAgentSessionRuntime, serveAgentSessions } from "./src/pi/piSessionRuntime.mjs";
 import { createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider } from "./src/systems/child/adapters/headlessChildSessionService.mjs";
 import { createHeadlessHub } from "./headlessHub.mjs";
 import { serveHeadlessServer } from "./headlessServer.mjs";
-import { captureTerminalPiForkSource, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider } from "./terminalPiChildSessionService.mjs";
-export { captureTerminalPiForkSource, createAgentServerService, createAgentSessionRuntime, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider, createHeadlessHub, createRpcTranscript, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider, serveHeadlessServer };
+export { createAgentSessionRuntime, createDirectHarnessRuntime, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider, createHeadlessHub, serveAgentSessions, serveHeadlessServer };

package/dist/serverPlugin.cjs

@@ -0,0 +1,39 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_serverScope = require("./src/schemas/serverScope.cjs");
+const require_liveImport = require("./src/server/liveImport.cjs");
+const require_serverPlugin = require("./src/schemas/serverPlugin.cjs");
+const require_index = require("./src/services/serverHost/index.cjs");
+const require_serverPackages = require("./src/server/serverPackages.cjs");
+const require_serverScope$1 = require("./src/server/serverScope.cjs");
+const require_pluginContributions = require("./src/schemas/pluginContributions.cjs");
+const require_serverPlugin$1 = require("./src/extensions/serverPlugin.cjs");
+const require_index$1 = require("./src/services/packageResource/index.cjs");
+const require_index$2 = require("./src/services/sessionAttachments/index.cjs");
+exports.LIVE_FACTORY_TIMEOUT_MS = require_liveImport.LIVE_FACTORY_TIMEOUT_MS;
+exports.LIVE_IMPORT_TIMEOUT_MS = require_liveImport.LIVE_IMPORT_TIMEOUT_MS;
+exports.PO_SERVER_HOST_SERVICE = require_serverPlugin.PO_SERVER_HOST_SERVICE;
+exports.PO_SERVER_MANIFEST_FIELD = require_serverPlugin.PO_SERVER_MANIFEST_FIELD;
+exports.PO_SERVER_SCOPE_LEVELS = require_serverScope.PO_SERVER_SCOPE_LEVELS;
+exports.PO_SERVER_SCOPE_SERVICE = require_serverScope.PO_SERVER_SCOPE_SERVICE;
+exports.PoServerManifestError = require_serverPlugin.PoServerManifestError;
+exports.PoServerScope = require_serverScope$1.PoServerScope;
+exports.composeServerProviderOverrides = require_serverPlugin.composeServerProviderOverrides;
+exports.createPoServerHost = require_index.createPoServerHost;
+exports.declaredServerPackagesOf = require_serverPlugin.declaredServerPackagesOf;
+exports.defineCommand = require_pluginContributions.defineCommand;
+exports.defineServerMethod = require_serverPlugin.defineServerMethod;
+exports.defineServerPlugin = require_serverPlugin$1.defineServerPlugin;
+exports.defineServiceContract = require_serverScope.defineServiceContract;
+exports.defineTool = require_pluginContributions.defineTool;
+exports.guardedImport = require_liveImport.guardedImport;
+exports.loadServerPackages = require_serverPackages.loadServerPackages;
+exports.orderServerPackages = require_serverPlugin.orderServerPackages;
+exports.packageResourcePath = require_index$1.packageResourcePath;
+exports.readPackageResource = require_index$1.readPackageResource;
+exports.readPoServerHost = require_serverPlugin.readPoServerHost;
+exports.readPoServerScope = require_serverScope.readPoServerScope;
+exports.requirePoServerHost = require_serverPlugin.requirePoServerHost;
+exports.requirePoServerScope = require_serverScope.requirePoServerScope;
+exports.selectedServerProviderOverrides = require_serverPackages.selectedServerProviderOverrides;
+exports.withTimeout = require_liveImport.withTimeout;
+exports.writeSessionAttachment = require_index$2.writeSessionAttachment;

package/dist/serverPlugin.d.mts

@@ -0,0 +1,12 @@
+import { PoServerBundleEntry, PoServerBundleOwner } from "./src/schemas/serverBundle.mjs";
+import { PoPluginCommand, PoPluginTool, PoPluginToolExecution, PoPluginToolResult, defineCommand, defineTool } from "./src/schemas/pluginContributions.mjs";
+import { PO_SERVER_SCOPE_LEVELS, PO_SERVER_SCOPE_SERVICE, PoServerResourceKey, PoServerResources, PoServerScopeService, PoServiceContract, defineServiceContract, readPoServerScope, requirePoServerScope } from "./src/schemas/serverScope.mjs";
+import { DeclaredServerPackage, PO_SERVER_HOST_SERVICE, PO_SERVER_MANIFEST_FIELD, PoServerContracts, PoServerHostService, PoServerManifestError, PoServerMethod, PoServerPlugin, PoServerPluginContext, PoServerPluginDefinition, PoServerPluginScope, PoServerProviderOverride, PoServerProviderOverrides, PoServerRegistration, PoServerSessionPlugin, composeServerProviderOverrides, declaredServerPackagesOf, defineServerMethod, orderServerPackages, readPoServerHost, requirePoServerHost } from "./src/schemas/serverPlugin.mjs";
+import { CreatePoServerHostOptions, PoServerHost, createPoServerHost } from "./src/services/serverHost/index.mjs";
+import { LIVE_FACTORY_TIMEOUT_MS, LIVE_IMPORT_TIMEOUT_MS, LiveImportGuard, guardedImport, withTimeout } from "./src/server/liveImport.mjs";
+import { LiveServerPackageEntry, LoadServerPackagesOptions, LoadedServerPackage, LoadedServerPackages, loadServerPackages, selectedServerProviderOverrides } from "./src/server/serverPackages.mjs";
+import { PoServerInstallOptions, PoServerPackageSettledReport, PoServerScope, PoServerScopeHost } from "./src/server/serverScope.mjs";
+import { defineServerPlugin } from "./src/extensions/serverPlugin.mjs";
+import { packageResourcePath, readPackageResource } from "./src/services/packageResource/index.mjs";
+import { writeSessionAttachment } from "./src/services/sessionAttachments/index.mjs";
+export { type CreatePoServerHostOptions, type DeclaredServerPackage, LIVE_FACTORY_TIMEOUT_MS, LIVE_IMPORT_TIMEOUT_MS, type LiveImportGuard, type LiveServerPackageEntry, type LoadServerPackagesOptions, type LoadedServerPackage, type LoadedServerPackages, PO_SERVER_HOST_SERVICE, PO_SERVER_MANIFEST_FIELD, PO_SERVER_SCOPE_LEVELS, PO_SERVER_SCOPE_SERVICE, type PoPluginCommand, type PoPluginTool, type PoPluginToolExecution, type PoPluginToolResult, type PoServerBundleEntry, type PoServerBundleOwner, type PoServerContracts, type PoServerHost, type PoServerHostService, type PoServerInstallOptions, PoServerManifestError, type PoServerMethod, type PoServerPackageSettledReport, type PoServerPlugin, type PoServerPluginContext, type PoServerPluginDefinition, type PoServerPluginScope, type PoServerProviderOverride, type PoServerProviderOverrides, type PoServerRegistration, type PoServerResourceKey, type PoServerResources, PoServerScope, type PoServerScopeHost, type PoServerScopeService, type PoServerSessionPlugin, type PoServiceContract, composeServerProviderOverrides, createPoServerHost, declaredServerPackagesOf, defineCommand, defineServerMethod, defineServerPlugin, defineServiceContract, defineTool, guardedImport, loadServerPackages, orderServerPackages, packageResourcePath, readPackageResource, readPoServerHost, readPoServerScope, requirePoServerHost, requirePoServerScope, selectedServerProviderOverrides, withTimeout, writeSessionAttachment };

package/dist/serverPlugin.mjs

@@ -0,0 +1,11 @@
+import { PO_SERVER_SCOPE_LEVELS, PO_SERVER_SCOPE_SERVICE, defineServiceContract, readPoServerScope, requirePoServerScope } from "./src/schemas/serverScope.mjs";
+import { LIVE_FACTORY_TIMEOUT_MS, LIVE_IMPORT_TIMEOUT_MS, guardedImport, withTimeout } from "./src/server/liveImport.mjs";
+import { PO_SERVER_HOST_SERVICE, PO_SERVER_MANIFEST_FIELD, PoServerManifestError, composeServerProviderOverrides, declaredServerPackagesOf, defineServerMethod, orderServerPackages, readPoServerHost, requirePoServerHost } from "./src/schemas/serverPlugin.mjs";
+import { createPoServerHost } from "./src/services/serverHost/index.mjs";
+import { loadServerPackages, selectedServerProviderOverrides } from "./src/server/serverPackages.mjs";
+import { PoServerScope } from "./src/server/serverScope.mjs";
+import { defineCommand, defineTool } from "./src/schemas/pluginContributions.mjs";
+import { defineServerPlugin } from "./src/extensions/serverPlugin.mjs";
+import { packageResourcePath, readPackageResource } from "./src/services/packageResource/index.mjs";
+import { writeSessionAttachment } from "./src/services/sessionAttachments/index.mjs";
+export { LIVE_FACTORY_TIMEOUT_MS, LIVE_IMPORT_TIMEOUT_MS, PO_SERVER_HOST_SERVICE, PO_SERVER_MANIFEST_FIELD, PO_SERVER_SCOPE_LEVELS, PO_SERVER_SCOPE_SERVICE, PoServerManifestError, PoServerScope, composeServerProviderOverrides, createPoServerHost, declaredServerPackagesOf, defineCommand, defineServerMethod, defineServerPlugin, defineServiceContract, defineTool, guardedImport, loadServerPackages, orderServerPackages, packageResourcePath, readPackageResource, readPoServerHost, readPoServerScope, requirePoServerHost, requirePoServerScope, selectedServerProviderOverrides, withTimeout, writeSessionAttachment };

package/dist/serverTelemetry.cjs

@@ -4,7 +4,7 @@ let _agimon_ai_po_telemetry = require("@agimon-ai/po-telemetry");
 const SERVICE_NAME = "po-server";
 const PACKAGE_NAME = "@agimon-ai/po";
 function createServerTelemetry(options = {}) {
-	return (0, _agimon_ai_po_telemetry.createDoomTelemetry)({
+	return (0, _agimon_ai_po_telemetry.createPoTelemetry)({
 		serviceName: SERVICE_NAME,
 		packageName: PACKAGE_NAME,
 		cwd: options.cwd,

package/dist/serverTelemetry.cjs.map

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

package/dist/serverTelemetry.d.mts

@@ -1,6 +1,6 @@
-import { DoomTelemetry } from "@agimon-ai/po-telemetry";
+import { PoTelemetry } from "@agimon-ai/po-telemetry";
 //#region src/services/serverTelemetry/index.d.ts
-export type ServerTelemetry = Pick<DoomTelemetry, 'recordEvent' | 'recordWarning' | 'recordError' | 'runInSpan' | 'flush' | 'shutdown'>;
+export type ServerTelemetry = Pick<PoTelemetry, 'recordEvent' | 'recordWarning' | 'recordError' | 'runInSpan' | 'flush' | 'shutdown'>;
 export declare function createServerTelemetry(options?: {
   cwd?: string;
   env?: NodeJS.ProcessEnv;

package/dist/serverTelemetry.mjs

@@ -1,9 +1,9 @@
-import { createDoomTelemetry } from "@agimon-ai/po-telemetry";
+import { createPoTelemetry } from "@agimon-ai/po-telemetry";
 //#region src/services/serverTelemetry/index.ts
 const SERVICE_NAME = "po-server";
 const PACKAGE_NAME = "@agimon-ai/po";
 function createServerTelemetry(options = {}) {
-	return createDoomTelemetry({
+	return createPoTelemetry({
 		serviceName: SERVICE_NAME,
 		packageName: PACKAGE_NAME,
 		cwd: options.cwd,

package/dist/serverTelemetry.mjs.map

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