@alvin0/ai-agent-sdk-core 0.1.3 → 0.1.5

package/dist/runtime/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../../src/runtime/registry.ts"],"sourcesContent":["/**\n * The adapter registry and the streaming call API.\n *\n * This is the deepseek-harness `LlmRuntime` with its dependency-injection\n * framework removed: a plain `Map` for routes, an ordered array for the\n * interception point that was a cordis waterfall, and a listener set for the\n * topology event. What is kept is everything that made it trustworthy  E * all-or-nothing validating registration, an atomic route swap, prepare/dispatch\n * generation binding, and a single failure funnel at the adapter boundary.\n *\n * @module ai-agent-sdk/core/runtime/registry\n */\n\nimport type { ModelAdapter } from '../contract/adapter.ts'\nimport {\n  callConfigEquals,\n  type CallConfig,\n  type CallConfigAdapterDefaults,\n} from '../contract/call-config.ts'\nimport type { GenerateOptions } from '../contract/generate-options.ts'\nimport type {\n  ModelContext,\n  ModelCatalogOptions,\n  ModelCatalogSnapshot,\n  ModelInfo,\n  ModelModality,\n  ProviderInfo,\n  ResolvedModelInfo,\n} from '../contract/model-info.ts'\nimport { resolveRetryPolicy, type ResolvedRetryPolicy } from '../contract/retry-policy.ts'\nimport { ModelError, REGISTRY_ERROR_CODES } from '../errors/model-error.ts'\nimport { deepFreeze } from '../primitives/freeze.ts'\nimport { SDK_VERSION } from '../primitives/version.ts'\nimport type { ObservationResource } from '../observation/event.ts'\nimport type { ObservationPort } from '../observation/port.ts'\nimport type { ModelCallHandle, ModelInvocationContext } from '../observation/report.ts'\nimport type { StreamChunk } from '../stream/chunk.ts'\nimport { createModelCallHandle } from './model-call-handle.ts'\nimport { normalizeResolvedModelInfo, resolveCallWithModelInfo,\n  validateCatalogModels, validateModelCatalogSnapshot } from './model-metadata.ts'\nimport { streamAdapter, type PreparedDispatch,\n  type RuntimeAdapterRegistration } from './model-stream.ts'\nimport {\n  PLUGIN_ERROR_CODES,\n  PluginError,\n  type AdapterRegistrationHandle,\n  type ModelProviderPlugin,\n  type ModelProviderRegistrar,\n  type PluginRegistrationHandle,\n  type StreamMiddleware,\n} from '../plugin/provider-plugin.ts'\n\nexport type { AdapterRegistrationHandle, StreamMiddleware } from '../plugin/provider-plugin.ts'\n\n/**\n * Wraps every streaming model call. Call `next()` to reach the adapter, or yield\n * your own chunks to short-circuit it entirely.\n *\n * This is the extension point for retry, caching, request logging, replay, and\n * test doubles. Middleware registered EARLIER sits further out.\n */\n/** One call whose configuration and adapter registration were resolved together. */\nexport interface PreparedCall {\n  /** Detached, deep-frozen config with any adapter-owned default materialized. */\n  readonly config: CallConfig\n  /** Immutable retry policy captured with the adapter registration. */\n  readonly retryPolicy: ResolvedRetryPolicy\n  /** Context capacity resolved with the registration-bound call. */\n  readonly context?: ModelContext\n  /** Exact model modalities captured with the dispatch generation. */\n  readonly inputModalities?: readonly ModelModality[]\n  /** Complete validated capability snapshot bound to this adapter generation. */\n  readonly model: ResolvedModelInfo\n  /** Which config fields the adapter supplied rather than the caller. */\n  readonly adapterDefaults: CallConfigAdapterDefaults\n  /**\n   * Dispatch this call ONCE, through the registration captured at preparation.\n   * @param options - the assembled request, carrying the prepared config.\n   * @returns the chunk stream, including middleware.\n   */\n  stream(options: GenerateOptions, context?: ModelInvocationContext): ModelCallHandle\n}\n\nexport interface ModelRegistryOptions {\n  /** Maximum model rows accepted from one adapter catalog. Defaults to 2,048. */\n  readonly maxCatalogModels?: number\n  /** Maximum serialized bytes accepted from a catalog or model-info record. Defaults to 4 MiB. */\n  readonly maxCatalogBytes?: number\n  /** Default observation port; a per-call invocation context may override it. */\n  readonly observation?: ObservationPort\n  /** Safe SDK/service/runtime identity copied onto observation events. */\n  readonly observationResource?: ObservationResource\n}\n\ntype AdapterRegistration = RuntimeAdapterRegistration\n\ninterface InstalledPlugin {\n  readonly routes: ReadonlySet<string>\n  readonly registrations: readonly AdapterRegistration[]\n  readonly middleware: readonly StreamMiddleware[]\n  readonly cleanup?: () => void\n}\n\n\nfunction containThenable(value: unknown): boolean {\n  if ((typeof value !== 'object' || value === null) && typeof value !== 'function') return false\n  let then: unknown\n  try {\n    then = Reflect.get(value, 'then')\n  } catch {\n    return true\n  }\n  if (typeof then !== 'function') return false\n  try { void Promise.resolve(value).catch(() => {}) } catch { /* hostile thenable contained */ }\n  return true\n}\n\nfunction synchronousCleanupFailure(cleanup: () => void): unknown | undefined {\n  try {\n    const result: unknown = cleanup()\n    return containThenable(result) ? new TypeError('plugin cleanup must be synchronous') : undefined\n  } catch (error) {\n    return error\n  }\n}\n\n\n/**\n * Routes model calls to registered adapters.\n *\n * Construct one per application or isolated runtime scope, register the adapters\n * you use, then call {@link stream} or {@link prepareCall}.\n */\nexport class ModelRegistry {\n  private adapters = new Map<string, AdapterRegistration>()\n  private middleware: StreamMiddleware[] = []\n  private listeners = new Set<() => void>()\n  private plugins = new Map<string, InstalledPlugin>()\n  private readonly maxCatalogModels: number\n  private readonly maxCatalogBytes: number\n  private readonly observation: ObservationPort | undefined\n  private readonly observationResource: ObservationResource\n\n  constructor(options: ModelRegistryOptions = {}) {\n    this.maxCatalogModels = positiveSafeInteger(options.maxCatalogModels ?? 2_048, 'maxCatalogModels')\n    this.maxCatalogBytes = positiveSafeInteger(options.maxCatalogBytes ?? 4 * 1024 * 1024, 'maxCatalogBytes')\n    this.observation = options.observation\n    this.observationResource = deepFreeze(options.observationResource ?? {\n      sdkName: 'ai-agent-sdk',\n      sdkVersion: SDK_VERSION,\n      runtime: 'unknown',\n    })\n  }\n\n  /** Install one provider plugin as a single synchronous topology transaction. */\n  install(plugin: ModelProviderPlugin): PluginRegistrationHandle {\n    const pluginId = typeof plugin?.id === 'string' ? plugin.id : ''\n    const fail = (message: string, cause?: unknown, cleanupFailures: readonly unknown[] = []): never => {\n      const causes = [...cause === undefined ? [] : [cause], ...cleanupFailures]\n      const wrappedCause = causes.length <= 1 ? causes[0] : new AggregateError(causes, `plugin ${pluginId} install cleanup failed`)\n      throw new PluginError(message, PLUGIN_ERROR_CODES.INSTALL_FAILED, pluginId, wrappedCause === undefined ? undefined : { cause: wrappedCause })\n    }\n    if (pluginId.trim().length === 0 || pluginId !== pluginId.trim()) fail('plugin id must be a non-empty trimmed string')\n    if (this.plugins.has(pluginId)) fail(`plugin \"${pluginId}\" is already installed`)\n    if (typeof plugin.displayName !== 'string' || plugin.displayName.trim().length === 0) fail(`plugin \"${pluginId}\" displayName must be non-empty`)\n    if (typeof plugin.setup !== 'function') fail(`plugin \"${pluginId}\" setup must be a function`)\n    const family = plugin.family ?? pluginId\n    if (typeof family !== 'string' || family.trim().length === 0 || family !== family.trim()) {\n      fail(`plugin \"${pluginId}\" family must be a non-empty trimmed string`)\n    }\n    const owner = Object.freeze({ pluginId, family })\n\n    interface StagedAdapter {\n      active: boolean\n      routes: string[]\n      readonly adapter: ModelAdapter\n    }\n    interface StagedMiddleware { active: boolean; readonly middleware: StreamMiddleware }\n    const stagedAdapters: StagedAdapter[] = []\n    const stagedMiddleware: StagedMiddleware[] = []\n    let staging = true\n\n    const registrar: ModelProviderRegistrar = {\n      registerAdapter: (routes, adapter) => {\n        if (!staging) fail(`plugin \"${pluginId}\" staging registrar is closed`)\n        if (routes.length === 0) throw new ModelError('an adapter must register at least one provider route', REGISTRY_ERROR_CODES.INVALID_ADAPTER)\n        const item: StagedAdapter = { active: true, routes: [...routes], adapter }\n        // Validate metadata and conflicts without mutating live routes.\n        const occupied = new Set(stagedAdapters.filter(value => value.active).flatMap(value => value.routes))\n        for (const route of routes) if (occupied.has(route)) {\n          throw new ModelError(`an adapter for provider route \"${route}\" is already staged`, REGISTRY_ERROR_CODES.DUPLICATE_ADAPTER)\n        }\n        this.prepareRoutes(routes, adapter, new Set(), owner)\n        stagedAdapters.push(item)\n        const handle = (() => {\n          if (staging) item.active = false\n        }) as AdapterRegistrationHandle\n        handle.replace = (next) => {\n          if (!staging || !item.active) throw new ModelError('a disposed staged registration cannot replace routes', REGISTRY_ERROR_CODES.REGISTRATION_DISPOSED)\n          const occupiedByOthers = new Set(stagedAdapters.filter(value => value.active && value !== item).flatMap(value => value.routes))\n          for (const route of next) if (occupiedByOthers.has(route)) {\n            throw new ModelError(`an adapter for provider route \"${route}\" is already staged`, REGISTRY_ERROR_CODES.DUPLICATE_ADAPTER)\n          }\n          this.prepareRoutes(next, adapter, new Set(), owner)\n          item.routes = [...next]\n        }\n        return handle\n      },\n      use: (middleware) => {\n        if (!staging) fail(`plugin \"${pluginId}\" staging registrar is closed`)\n        if (typeof middleware !== 'function') throw new TypeError('plugin middleware must be a function')\n        const item: StagedMiddleware = { active: true, middleware }\n        stagedMiddleware.push(item)\n        return () => { if (staging) item.active = false }\n      },\n    }\n\n    let cleanup: (() => void) | undefined\n    try {\n      const result = plugin.setup(registrar)\n      if (containThenable(result)) fail(`plugin \"${pluginId}\" setup must be synchronous`)\n      if (result !== undefined && typeof result !== 'function') fail(`plugin \"${pluginId}\" setup must be synchronous and return void or cleanup`)\n      cleanup = typeof result === 'function' ? result : undefined\n    } catch (error) {\n      if (error instanceof PluginError && error.code === PLUGIN_ERROR_CODES.INSTALL_FAILED) throw error\n      fail(`plugin \"${pluginId}\" setup failed`, error)\n    } finally {\n      staging = false\n    }\n\n    const registrations: AdapterRegistration[] = []\n    const routeNames = new Set<string>()\n    try {\n      for (const item of stagedAdapters) {\n        if (!item.active) continue\n        for (const route of item.routes) {\n          if (routeNames.has(route)) throw new ModelError(`an adapter for provider route \"${route}\" is already staged`, REGISTRY_ERROR_CODES.DUPLICATE_ADAPTER)\n          routeNames.add(route)\n        }\n        registrations.push(...this.prepareRoutes(item.routes, item.adapter, new Set(), owner))\n      }\n    } catch (error) {\n      const cleanupFailures: unknown[] = []\n      if (cleanup) {\n        const cleanupFailure = synchronousCleanupFailure(cleanup)\n        if (cleanupFailure !== undefined) cleanupFailures.push(cleanupFailure)\n      }\n      fail(`plugin \"${pluginId}\" commit validation failed`, error, cleanupFailures)\n    }\n\n    const committedMiddleware = stagedMiddleware.filter(item => item.active).map(item => item.middleware)\n    for (const registration of registrations) this.adapters.set(registration.provider.id, registration)\n    this.middleware.push(...committedMiddleware)\n    const installed: InstalledPlugin = {\n      routes: routeNames,\n      registrations,\n      middleware: committedMiddleware,\n      ...(cleanup === undefined ? {} : { cleanup }),\n    }\n    this.plugins.set(pluginId, installed)\n    this.emitAdaptersUpdated()\n\n    let disposed = false\n    const dispose = (() => {\n      if (disposed) return\n      disposed = true\n      this.plugins.delete(pluginId)\n      for (const registration of installed.registrations) {\n        if (this.adapters.get(registration.provider.id) === registration) this.adapters.delete(registration.provider.id)\n      }\n      for (let index = installed.middleware.length - 1; index >= 0; index--) {\n        const middleware = installed.middleware[index]\n        const liveIndex = middleware === undefined ? -1 : this.middleware.lastIndexOf(middleware)\n        if (liveIndex >= 0) this.middleware.splice(liveIndex, 1)\n      }\n      this.emitAdaptersUpdated()\n      const failures: unknown[] = []\n      if (installed.cleanup) {\n        const cleanupFailure = synchronousCleanupFailure(installed.cleanup)\n        if (cleanupFailure !== undefined) failures.push(cleanupFailure)\n      }\n      if (failures.length > 0) {\n        throw new PluginError(\n          `plugin \"${pluginId}\" cleanup failed`,\n          PLUGIN_ERROR_CODES.CLEANUP_FAILED,\n          pluginId,\n          { cause: new AggregateError(failures, `plugin \"${pluginId}\" cleanup failed`) },\n        )\n      }\n    }) as PluginRegistrationHandle\n    Object.defineProperty(dispose, 'pluginId', { value: pluginId, enumerable: true })\n    return dispose\n  }\n\n  /**\n   * Register an adapter for the given routes.\n   *\n   * All-or-nothing: if ANY route conflicts, nothing is registered. A partial\n   * registration would leave the caller believing a route exists when it does not.\n   * @param providers - every route this adapter should serve; must be non-empty.\n   * @param adapter - the adapter that streams calls for those routes.\n   * @returns the disposer, carrying {@link AdapterRegistrationHandle.replace}.\n   */\n  registerAdapter(\n    providers: readonly string[],\n    adapter: ModelAdapter,\n  ): AdapterRegistrationHandle {\n    if (providers.length === 0) {\n      throw new ModelError(\n        'an adapter must register at least one provider route',\n        REGISTRY_ERROR_CODES.INVALID_ADAPTER,\n      )\n    }\n    /** Routes this registration currently holds; `replace` rewrites it. */\n    const owned = new Set<string>()\n    // `owned` being empty cannot signal disposal on its own, because\n    // `replace([])` legally leaves a live registration holding no routes.\n    let released = false\n\n    this.commitRoutes(owned, this.prepareRoutes(providers, adapter, owned))\n\n    const handle = (() => {\n      if (released) return\n      released = true\n      for (const provider of owned) this.adapters.delete(provider)\n      owned.clear()\n      this.emitAdaptersUpdated()\n    }) as AdapterRegistrationHandle\n\n    handle.replace = (next: readonly string[]): void => {\n      // Registering after disposal would leak: nothing remains to release what\n      // this call would put back into the map.\n      if (released) {\n        throw new ModelError(\n          'a disposed adapter registration cannot replace its routes',\n          REGISTRY_ERROR_CODES.REGISTRATION_DISPOSED,\n        )\n      }\n      this.commitRoutes(owned, this.prepareRoutes(next, adapter, owned))\n    }\n    return handle\n  }\n\n  /**\n   * Validate one candidate route set, treating routes this registration already\n   * holds as available. Mutates nothing  Ea rejected candidate leaves the registry\n   * exactly as it was.\n   */\n  private prepareRoutes(\n    providers: readonly string[],\n    adapter: ModelAdapter,\n    owned: ReadonlySet<string>,\n    owner?: Readonly<{ pluginId: string; family: string }>,\n  ): AdapterRegistration[] {\n    const unique = new Set<string>()\n    const registrations: AdapterRegistration[] = []\n    for (const provider of providers) {\n      if (typeof provider !== 'string' || provider.length === 0) {\n        throw new ModelError(\n          'adapter provider route names must be non-empty strings',\n          REGISTRY_ERROR_CODES.INVALID_ADAPTER,\n        )\n      }\n      if (unique.has(provider) || (this.adapters.has(provider) && !owned.has(provider))) {\n        throw new ModelError(\n          `an adapter for provider route \"${provider}\" is already registered`,\n          REGISTRY_ERROR_CODES.DUPLICATE_ADAPTER,\n        )\n      }\n      const info = adapter.providerInfo(provider)\n      if (typeof info.id !== 'string' || info.id !== provider\n        || typeof info.name !== 'string' || info.name.length === 0) {\n        throw new ModelError(\n          `adapter metadata for route \"${provider}\" must preserve its id and carry a non-empty name`,\n          REGISTRY_ERROR_CODES.INVALID_ADAPTER,\n        )\n      }\n      unique.add(provider)\n      registrations.push({\n        adapter,\n        provider: { id: info.id, name: info.name },\n        ...(owner === undefined ? {} : owner),\n        // Captured at REGISTRATION time, not per call. An adapter whose policy\n        // follows mutable configuration re-registers via `handle.replace`.\n        retryPolicy: adapter.providerRetryPolicy(provider)\n          ?? resolveRetryPolicy(undefined, `provider \"${provider}\" retryPolicy`),\n      })\n    }\n    return registrations\n  }\n\n  /**\n   * Swap this registration's routes in ONE synchronous section, so no caller can\n   * observe the registry between the release and the re-registration.\n   */\n  private commitRoutes(\n    owned: Set<string>,\n    registrations: readonly AdapterRegistration[],\n  ): void {\n    for (const provider of owned) this.adapters.delete(provider)\n    owned.clear()\n    for (const registration of registrations) {\n      this.adapters.set(registration.provider.id, registration)\n      owned.add(registration.provider.id)\n    }\n    this.emitAdaptersUpdated()\n  }\n\n  /**\n   * Install streaming middleware.\n   * @param middleware - wrapper invoked around every call; earlier registrations sit further out.\n   * @returns a disposer that removes exactly this middleware.\n   */\n  use(middleware: StreamMiddleware): () => void {\n    this.middleware.push(middleware)\n    return () => {\n      const index = this.middleware.indexOf(middleware)\n      if (index >= 0) this.middleware.splice(index, 1)\n    }\n  }\n\n  /**\n   * Observe route-topology changes (registration, replacement, disposal).\n   * @param listener - payload-free notification; re-read `listProviders()` for new state.\n   * @returns a disposer that removes the listener.\n   */\n  onAdaptersUpdated(listener: () => void): () => void {\n    this.listeners.add(listener)\n    return () => void this.listeners.delete(listener)\n  }\n\n  /**\n   * Notify topology observers.\n   *\n   * Each listener is contained independently: a topology notification is not a\n   * veto, so one broken observer must not starve the others or roll back a\n   * registration that already happened.\n   */\n  private emitAdaptersUpdated(): void {\n    for (const listener of [...this.listeners]) {\n      try {\n        listener()\n      } catch {\n        // Contained deliberately; see above.\n      }\n    }\n  }\n\n  /**\n   * Describe every route with a registered adapter.\n   * @returns detached provider metadata, in registration order.\n   */\n  listProviders(): ProviderInfo[] {\n    return [...this.adapters.values()].map(({ provider }) => ({ ...provider }))\n  }\n\n  /**\n   * List the models one route advertises.\n   *\n   * Re-validated here rather than trusted, because a malformed catalog entry\n   * surfaces in a caller's model picker where its origin is far from obvious.\n   * @param provider - a registered route.\n   * @returns detached, validated model metadata.\n   */\n  async listModels(provider: string, signal?: AbortSignal): Promise<ModelInfo[]> {\n    const registration = this.registration(provider)\n    const models = await registration.adapter.listModels(provider, signal)\n    return validateCatalogModels(provider, models, this.maxCatalogModels, this.maxCatalogBytes)\n  }\n\n  /** Resolve and validate one uncached adapter-level catalog generation. */\n  async modelCatalog(provider: string, options: ModelCatalogOptions = {}): Promise<ModelCatalogSnapshot> {\n    const registration = this.registration(provider)\n    const snapshot = await registration.adapter.modelCatalog(provider, options)\n    return validateModelCatalogSnapshot(provider, snapshot, this.maxCatalogModels, this.maxCatalogBytes)\n  }\n\n  /**\n   * Resolve metadata for one exact model.\n   * @param provider - a registered route.\n   * @param model - exact model id.\n   * @param signal - cancellation for adapter-side resolution.\n   * @returns validated, detached metadata.\n   */\n  async resolveModelInfo(\n    provider: string,\n    model: string,\n    signal?: AbortSignal,\n  ): Promise<ResolvedModelInfo> {\n    const registration = this.registration(provider)\n    const resolved = await registration.adapter.resolveModel(provider, model, signal)\n    return normalizeResolvedModelInfo(registration.provider.id, model, resolved, this.maxCatalogBytes)\n  }\n\n  /** The retry policy captured for one route. */\n  retryPolicy(provider: string): ResolvedRetryPolicy {\n    return this.registration(provider).retryPolicy\n  }\n\n  /**\n   * Resolve one call under its CURRENT adapter registration, returning a one-shot\n   * handle that keeps that registration through to dispatch.\n   * @param config - route, model, and optional request controls.\n   * @param signal - cancellation for adapter-side capability lookup.\n   * @returns the prepared config and its registration-bound stream entry point.\n   */\n  async prepareCall(\n    config: CallConfig,\n    signal?: AbortSignal,\n    invocationContext?: ModelInvocationContext,\n  ): Promise<PreparedCall> {\n    const registration = this.registration(config.provider)\n    const adapterCall = await registration.adapter.prepareCall(config.provider, config.model, signal, invocationContext)\n    const modelInfo = normalizeResolvedModelInfo(\n      registration.provider.id, config.model, adapterCall.model, this.maxCatalogBytes,\n    )\n    const resolved = resolveCallWithModelInfo(config, modelInfo)\n    const resolvedConfig = deepFreeze(structuredClone(resolved.config))\n    const context = resolved.context === undefined\n      ? undefined\n      : deepFreeze(structuredClone(resolved.context))\n    const adapterDefaults = deepFreeze<CallConfigAdapterDefaults>({\n      ...config.reasoningEffort === undefined && resolvedConfig.reasoningEffort !== undefined\n        ? { reasoningEffort: true as const }\n        : {},\n      ...config.maxTokens === undefined && resolvedConfig.maxTokens !== undefined\n        ? { maxTokens: true as const }\n        : {},\n    })\n\n    let dispatched = false\n    const model = deepFreeze(structuredClone(modelInfo))\n    return Object.freeze({\n      config: resolvedConfig,\n      model,\n      retryPolicy: registration.retryPolicy,\n      adapterDefaults,\n      ...context === undefined ? {} : { context },\n      ...modelInfo.inputModalities === undefined\n        ? {}\n        : { inputModalities: Object.freeze([...modelInfo.inputModalities]) },\n      stream: (options: GenerateOptions, context = invocationContext): ModelCallHandle => {\n        // Both guards below exist so a stale handle fails loudly instead of\n        // quietly dispatching against a configuration nobody vetted.\n        if (dispatched) {\n          throw new ModelError(\n            'a prepared call can only be dispatched once',\n            REGISTRY_ERROR_CODES.INVALID_PREPARED_CALL,\n          )\n        }\n        if (!callConfigEquals(options, resolvedConfig)) {\n          throw new ModelError(\n            'prepared call config changed before adapter dispatch',\n            REGISTRY_ERROR_CODES.INVALID_PREPARED_CALL,\n          )\n        }\n        dispatched = true\n        return this.dispatch(options, context, {\n          registration,\n          config: resolvedConfig,\n          modelInfo,\n          dispatch: (request, activeContext) => adapterCall.stream(request, activeContext),\n        })\n      },\n    })\n  }\n\n  /**\n   * Stream one model call as raw chunks.\n   *\n   * Adapter selection, dispatch, and iteration failures become terminal `error` or\n   * `aborted` finish chunks. Middleware and consumer failures stay THROWN  Ethose\n   * are bugs in code the caller controls, and converting them to a finish reason\n   * would hide them.\n   * @param options - the full request; `options.provider` selects the adapter.\n   * @returns the chunk stream, wrapped by any installed middleware.\n   */\n  stream(options: GenerateOptions, context?: ModelInvocationContext): ModelCallHandle {\n    return this.dispatch(options, context)\n  }\n\n  private dispatch(\n    options: GenerateOptions,\n    context?: ModelInvocationContext,\n    prepared?: PreparedDispatch,\n  ): ModelCallHandle {\n    let dispatchState: 'not-sent' | 'unknown' = 'not-sent'\n    const registration = prepared?.registration ?? this.adapters.get(options.provider)\n    return createModelCallHandle({\n      options,\n      ...(registration?.family === undefined ? {} : { providerFamily: registration.family }),\n      ...(registration?.pluginId === undefined ? {} : { providerPluginId: registration.pluginId }),\n      ...(registration === undefined ? {} : { isRetryable: (code: string) => (\n        registration.retryPolicy.mode === 'always'\n          || registration.retryPolicy.retryableCodes.includes(code)\n      ) }),\n      ...(context === undefined ? {} : { context }),\n      ...(this.observation === undefined ? {} : { defaultObservation: this.observation }),\n      resource: this.observationResource,\n      routePresent: prepared !== undefined || this.adapters.has(options.provider),\n      dispatchState: () => dispatchState,\n      stream: activeContext => this.dispatchRaw(\n        options,\n        activeContext,\n        () => { dispatchState = 'unknown' },\n        prepared,\n      ),\n    })\n  }\n\n  /**\n   * Compose installed middleware around the adapter boundary.\n   *\n   * Composition is deferred to the first iteration rather than done eagerly, so\n   * that `stream()` ALWAYS returns an iterable and every failure — including a\n   * middleware that throws synchronously — surfaces on the same path. Composing\n   * eagerly would give callers two different error channels for the same class of\n   * fault, and they would inevitably handle only one.\n   *\n   * The middleware list is snapshotted here so that installing or removing\n   * middleware mid-stream cannot change the chain of a call already in flight.\n   */\n  private dispatchRaw(\n    options: GenerateOptions,\n    context: ModelInvocationContext,\n    onDispatch: () => void,\n    prepared?: PreparedDispatch,\n  ): AsyncIterable<StreamChunk> {\n    const chain = [...this.middleware]\n    const run = (): AsyncIterable<StreamChunk> => {\n      let next = (): AsyncIterable<StreamChunk> => streamAdapter({\n        options, context, onDispatch, maxCatalogBytes: this.maxCatalogBytes,\n        registration: provider => this.registration(provider),\n        registeredAdapter: provider => this.adapters.get(provider)?.adapter,\n        ...(prepared === undefined ? {} : { prepared }),\n      })\n      for (let index = chain.length - 1; index >= 0; index--) {\n        const middleware = chain[index]\n        if (middleware === undefined) continue\n        const inner = next\n        next = () => middleware(options, inner, context)\n      }\n      return next()\n    }\n    return {\n      async * [Symbol.asyncIterator]() {\n        yield* run()\n      },\n    }\n  }\n\n  private registration(provider: string): AdapterRegistration {\n    const registration = this.adapters.get(provider)\n    if (registration === undefined) {\n      throw new ModelError(\n        `no adapter registered for provider route \"${provider}\"`,\n        REGISTRY_ERROR_CODES.NO_ADAPTER,\n      )\n    }\n    return registration\n  }\n\n}\n\nfunction positiveSafeInteger(value: number, label: string): number {\n  if (!Number.isSafeInteger(value) || value < 1) {\n    throw new RangeError(`ModelRegistry ${label} must be a positive safe integer`)\n  }\n  return value\n}\n"],"mappings":"qoBAuGA,SAAS,EAAgB,EAAyB,CAChD,IAAK,OAAO,GAAU,WAAY,IAAmB,OAAO,GAAU,WAAY,MAAO,GACzF,IAAI,EACJ,GAAI,CACF,EAAO,QAAQ,IAAI,EAAO,MAAM,CAClC,MAAQ,CACN,MAAO,EACT,CACA,GAAI,OAAO,GAAS,WAAY,MAAO,GACvC,GAAI,CAAE,QAAa,QAAQ,CAAK,CAAC,CAAC,UAAY,CAAC,CAAC,CAAE,MAAQ,CAAmC,CAC7F,MAAO,EACT,CAEA,SAAS,EAA0B,EAA0C,CAC3E,GAAI,CAEF,OAAO,EADiB,EACI,CAAC,EAAQ,UAAU,oCAAoC,EAAI,IAAA,EACzF,OAAS,EAAO,CACd,OAAO,CACT,CACF,CASA,IAAa,EAAb,KAA2B,CACzB,SAAmB,IAAI,IACvB,WAAyC,CAAC,EAC1C,UAAoB,IAAI,IACxB,QAAkB,IAAI,IACtB,iBACA,gBACA,YACA,oBAEA,YAAY,EAAgC,CAAC,EAAG,CAC9C,KAAK,iBAAmB,EAAoB,EAAQ,kBAAoB,KAAO,kBAAkB,EACjG,KAAK,gBAAkB,EAAoB,EAAQ,iBAAmB,QAAiB,iBAAiB,EACxG,KAAK,YAAc,EAAQ,YAC3B,KAAK,oBAAsB,EAAW,EAAQ,qBAAuB,CACnE,QAAS,eACT,WAAA,QACA,QAAS,SACX,CAAC,CACH,CAGA,QAAQ,EAAuD,CAC7D,IAAM,EAAW,OAAO,GAAQ,IAAO,SAAW,EAAO,GAAK,GACxD,GAAQ,EAAiB,EAAiB,EAAsC,CAAC,IAAa,CAClG,IAAM,EAAS,CAAC,GAAG,IAAU,IAAA,GAAY,CAAC,EAAI,CAAC,CAAK,EAAG,GAAG,CAAe,EACnE,EAAe,EAAO,QAAU,EAAI,EAAO,GAAS,eAAe,EAAQ,UAAU,EAAS,wBAAwB,EAC5H,MAAM,IAAI,EAAY,EAAS,EAAmB,eAAgB,EAAU,IAAiB,IAAA,GAAY,IAAA,GAAY,CAAE,MAAO,CAAa,CAAC,CAC9I,GACI,EAAS,KAAK,CAAC,CAAC,SAAW,GAAK,IAAa,EAAS,KAAK,IAAG,EAAK,8CAA8C,EACjH,KAAK,QAAQ,IAAI,CAAQ,GAAG,EAAK,WAAW,EAAS,uBAAuB,GAC5E,OAAO,EAAO,aAAgB,UAAY,EAAO,YAAY,KAAK,CAAC,CAAC,SAAW,IAAG,EAAK,WAAW,EAAS,gCAAgC,EAC3I,OAAO,EAAO,OAAU,YAAY,EAAK,WAAW,EAAS,2BAA2B,EAC5F,IAAM,EAAS,EAAO,QAAU,GAC5B,OAAO,GAAW,UAAY,EAAO,KAAK,CAAC,CAAC,SAAW,GAAK,IAAW,EAAO,KAAK,IACrF,EAAK,WAAW,EAAS,4CAA4C,EAEvE,IAAM,EAAQ,OAAO,OAAO,CAAE,WAAU,QAAO,CAAC,EAQ1C,EAAkC,CAAC,EACnC,EAAuC,CAAC,EAC1C,EAAU,GAER,EAAoC,CACxC,iBAAkB,EAAQ,IAAY,CAEpC,GADK,GAAS,EAAK,WAAW,EAAS,8BAA8B,EACjE,EAAO,SAAW,EAAG,MAAM,IAAI,EAAW,uDAAwD,EAAqB,eAAe,EAC1I,IAAM,EAAsB,CAAE,OAAQ,GAAM,OAAQ,CAAC,GAAG,CAAM,EAAG,SAAQ,EAEnE,EAAW,IAAI,IAAI,EAAe,OAAO,GAAS,EAAM,MAAM,CAAC,CAAC,QAAQ,GAAS,EAAM,MAAM,CAAC,EACpG,IAAK,IAAM,KAAS,EAAQ,GAAI,EAAS,IAAI,CAAK,EAChD,MAAM,IAAI,EAAW,kCAAkC,EAAM,qBAAsB,EAAqB,iBAAiB,EAE3H,KAAK,cAAc,EAAQ,EAAS,IAAI,IAAO,CAAK,EACpD,EAAe,KAAK,CAAI,EACxB,IAAM,OAAgB,CAChB,IAAS,EAAK,OAAS,GAC7B,GAUA,MATA,GAAO,QAAW,GAAS,CACzB,GAAI,CAAC,GAAW,CAAC,EAAK,OAAQ,MAAM,IAAI,EAAW,uDAAwD,EAAqB,qBAAqB,EACrJ,IAAM,EAAmB,IAAI,IAAI,EAAe,OAAO,GAAS,EAAM,QAAU,IAAU,CAAI,CAAC,CAAC,QAAQ,GAAS,EAAM,MAAM,CAAC,EAC9H,IAAK,IAAM,KAAS,EAAM,GAAI,EAAiB,IAAI,CAAK,EACtD,MAAM,IAAI,EAAW,kCAAkC,EAAM,qBAAsB,EAAqB,iBAAiB,EAE3H,KAAK,cAAc,EAAM,EAAS,IAAI,IAAO,CAAK,EAClD,EAAK,OAAS,CAAC,GAAG,CAAI,CACxB,EACO,CACT,EACA,IAAM,GAAe,CAEnB,GADK,GAAS,EAAK,WAAW,EAAS,8BAA8B,EACjE,OAAO,GAAe,WAAY,MAAU,UAAU,sCAAsC,EAChG,IAAM,EAAyB,CAAE,OAAQ,GAAM,YAAW,EAE1D,OADA,EAAiB,KAAK,CAAI,MACb,CAAM,IAAS,EAAK,OAAS,GAAM,CAClD,CACF,EAEI,EACJ,GAAI,CACF,IAAM,EAAS,EAAO,MAAM,CAAS,EACjC,EAAgB,CAAM,GAAG,EAAK,WAAW,EAAS,4BAA4B,EAC9E,IAAW,IAAA,IAAa,OAAO,GAAW,YAAY,EAAK,WAAW,EAAS,uDAAuD,EAC1I,EAAU,OAAO,GAAW,WAAa,EAAS,IAAA,EACpD,OAAS,EAAO,CACd,GAAI,aAAiB,GAAe,EAAM,OAAS,EAAmB,eAAgB,MAAM,EAC5F,EAAK,WAAW,EAAS,gBAAiB,CAAK,CACjD,QAAU,CACR,EAAU,EACZ,CAEA,IAAM,EAAuC,CAAC,EACxC,EAAa,IAAI,IACvB,GAAI,CACF,IAAK,IAAM,KAAQ,EACZ,KAAK,OACV,KAAK,IAAM,KAAS,EAAK,OAAQ,CAC/B,GAAI,EAAW,IAAI,CAAK,EAAG,MAAM,IAAI,EAAW,kCAAkC,EAAM,qBAAsB,EAAqB,iBAAiB,EACpJ,EAAW,IAAI,CAAK,CACtB,CACA,EAAc,KAAK,GAAG,KAAK,cAAc,EAAK,OAAQ,EAAK,QAAS,IAAI,IAAO,CAAK,CAAC,CADrF,CAGJ,OAAS,EAAO,CACd,IAAM,EAA6B,CAAC,EACpC,GAAI,EAAS,CACX,IAAM,EAAiB,EAA0B,CAAO,EACpD,IAAmB,IAAA,IAAW,EAAgB,KAAK,CAAc,CACvE,CACA,EAAK,WAAW,EAAS,4BAA6B,EAAO,CAAe,CAC9E,CAEA,IAAM,EAAsB,EAAiB,OAAO,GAAQ,EAAK,MAAM,CAAC,CAAC,IAAI,GAAQ,EAAK,UAAU,EACpG,IAAK,IAAM,KAAgB,EAAe,KAAK,SAAS,IAAI,EAAa,SAAS,GAAI,CAAY,EAClG,KAAK,WAAW,KAAK,GAAG,CAAmB,EAC3C,IAAM,EAA6B,CACjC,OAAQ,EACR,gBACA,WAAY,EACZ,GAAI,IAAY,IAAA,GAAY,CAAC,EAAI,CAAE,SAAQ,CAC7C,EACA,KAAK,QAAQ,IAAI,EAAU,CAAS,EACpC,KAAK,oBAAoB,EAEzB,IAAI,EAAW,GACT,OAAiB,CACrB,GAAI,EAAU,OACd,EAAW,GACX,KAAK,QAAQ,OAAO,CAAQ,EAC5B,IAAK,IAAM,KAAgB,EAAU,cAC/B,KAAK,SAAS,IAAI,EAAa,SAAS,EAAE,IAAM,GAAc,KAAK,SAAS,OAAO,EAAa,SAAS,EAAE,EAEjH,IAAK,IAAI,EAAQ,EAAU,WAAW,OAAS,EAAG,GAAS,EAAG,IAAS,CACrE,IAAM,EAAa,EAAU,WAAW,GAClC,EAAY,IAAe,IAAA,GAAY,GAAK,KAAK,WAAW,YAAY,CAAU,EACpF,GAAa,GAAG,KAAK,WAAW,OAAO,EAAW,CAAC,CACzD,CACA,KAAK,oBAAoB,EACzB,IAAM,EAAsB,CAAC,EAC7B,GAAI,EAAU,QAAS,CACrB,IAAM,EAAiB,EAA0B,EAAU,OAAO,EAC9D,IAAmB,IAAA,IAAW,EAAS,KAAK,CAAc,CAChE,CACA,GAAI,EAAS,OAAS,EACpB,MAAM,IAAI,EACR,WAAW,EAAS,kBACpB,EAAmB,eACnB,EACA,CAAE,MAAW,eAAe,EAAU,WAAW,EAAS,iBAAiB,CAAE,CAC/E,CAEJ,GAEA,OADA,OAAO,eAAe,EAAS,WAAY,CAAE,MAAO,EAAU,WAAY,EAAK,CAAC,EACzE,CACT,CAWA,gBACE,EACA,EAC2B,CAC3B,GAAI,EAAU,SAAW,EACvB,MAAM,IAAI,EACR,uDACA,EAAqB,eACvB,EAGF,IAAM,EAAQ,IAAI,IAGd,EAAW,GAEf,KAAK,aAAa,EAAO,KAAK,cAAc,EAAW,EAAS,CAAK,CAAC,EAEtE,IAAM,OAAgB,CAChB,MACJ,GAAW,GACX,IAAK,IAAM,KAAY,EAAO,KAAK,SAAS,OAAO,CAAQ,EAC3D,EAAM,MAAM,EACZ,KAAK,oBAAoB,CAHd,CAIb,GAaA,MAXA,GAAO,QAAW,GAAkC,CAGlD,GAAI,EACF,MAAM,IAAI,EACR,4DACA,EAAqB,qBACvB,EAEF,KAAK,aAAa,EAAO,KAAK,cAAc,EAAM,EAAS,CAAK,CAAC,CACnE,EACO,CACT,CAOA,cACE,EACA,EACA,EACA,EACuB,CACvB,IAAM,EAAS,IAAI,IACb,EAAuC,CAAC,EAC9C,IAAK,IAAM,KAAY,EAAW,CAChC,GAAI,OAAO,GAAa,UAAY,EAAS,SAAW,EACtD,MAAM,IAAI,EACR,yDACA,EAAqB,eACvB,EAEF,GAAI,EAAO,IAAI,CAAQ,GAAM,KAAK,SAAS,IAAI,CAAQ,GAAK,CAAC,EAAM,IAAI,CAAQ,EAC7E,MAAM,IAAI,EACR,kCAAkC,EAAS,yBAC3C,EAAqB,iBACvB,EAEF,IAAM,EAAO,EAAQ,aAAa,CAAQ,EAC1C,GAAI,OAAO,EAAK,IAAO,UAAY,EAAK,KAAO,GAC1C,OAAO,EAAK,MAAS,UAAY,EAAK,KAAK,SAAW,EACzD,MAAM,IAAI,EACR,+BAA+B,EAAS,mDACxC,EAAqB,eACvB,EAEF,EAAO,IAAI,CAAQ,EACnB,EAAc,KAAK,CACjB,UACA,SAAU,CAAE,GAAI,EAAK,GAAI,KAAM,EAAK,IAAK,EACzC,GAAI,IAAU,IAAA,GAAY,CAAC,EAAI,EAG/B,YAAa,EAAQ,oBAAoB,CAAQ,GAC5C,EAAmB,IAAA,GAAW,aAAa,EAAS,cAAc,CACzE,CAAC,CACH,CACA,OAAO,CACT,CAMA,aACE,EACA,EACM,CACN,IAAK,IAAM,KAAY,EAAO,KAAK,SAAS,OAAO,CAAQ,EAC3D,EAAM,MAAM,EACZ,IAAK,IAAM,KAAgB,EACzB,KAAK,SAAS,IAAI,EAAa,SAAS,GAAI,CAAY,EACxD,EAAM,IAAI,EAAa,SAAS,EAAE,EAEpC,KAAK,oBAAoB,CAC3B,CAOA,IAAI,EAA0C,CAE5C,OADA,KAAK,WAAW,KAAK,CAAU,MAClB,CACX,IAAM,EAAQ,KAAK,WAAW,QAAQ,CAAU,EAC5C,GAAS,GAAG,KAAK,WAAW,OAAO,EAAO,CAAC,CACjD,CACF,CAOA,kBAAkB,EAAkC,CAElD,OADA,KAAK,UAAU,IAAI,CAAQ,MACd,KAAK,KAAK,UAAU,OAAO,CAAQ,CAClD,CASA,qBAAoC,CAClC,IAAK,IAAM,IAAY,CAAC,GAAG,KAAK,SAAS,EACvC,GAAI,CACF,EAAS,CACX,MAAQ,CAER,CAEJ,CAMA,eAAgC,CAC9B,MAAO,CAAC,GAAG,KAAK,SAAS,OAAO,CAAC,CAAC,CAAC,KAAK,CAAE,eAAgB,CAAE,GAAG,CAAS,EAAE,CAC5E,CAUA,MAAM,WAAW,EAAkB,EAA4C,CAE7E,IAAM,EAAS,MADM,KAAK,aAAa,CACP,CAAC,CAAC,QAAQ,WAAW,EAAU,CAAM,EACrE,OAAO,EAAsB,EAAU,EAAQ,KAAK,iBAAkB,KAAK,eAAe,CAC5F,CAGA,MAAM,aAAa,EAAkB,EAA+B,CAAC,EAAkC,CAErG,IAAM,EAAW,MADI,KAAK,aAAa,CACL,CAAC,CAAC,QAAQ,aAAa,EAAU,CAAO,EAC1E,OAAO,EAA6B,EAAU,EAAU,KAAK,iBAAkB,KAAK,eAAe,CACrG,CASA,MAAM,iBACJ,EACA,EACA,EAC4B,CAC5B,IAAM,EAAe,KAAK,aAAa,CAAQ,EACzC,EAAW,MAAM,EAAa,QAAQ,aAAa,EAAU,EAAO,CAAM,EAChF,OAAO,EAA2B,EAAa,SAAS,GAAI,EAAO,EAAU,KAAK,eAAe,CACnG,CAGA,YAAY,EAAuC,CACjD,OAAO,KAAK,aAAa,CAAQ,CAAC,CAAC,WACrC,CASA,MAAM,YACJ,EACA,EACA,EACuB,CACvB,IAAM,EAAe,KAAK,aAAa,EAAO,QAAQ,EAChD,EAAc,MAAM,EAAa,QAAQ,YAAY,EAAO,SAAU,EAAO,MAAO,EAAQ,CAAiB,EAC7G,EAAY,EAChB,EAAa,SAAS,GAAI,EAAO,MAAO,EAAY,MAAO,KAAK,eAClE,EACM,EAAW,EAAyB,EAAQ,CAAS,EACrD,EAAiB,EAAW,gBAAgB,EAAS,MAAM,CAAC,EAC5D,EAAU,EAAS,UAAY,IAAA,GACjC,IAAA,GACA,EAAW,gBAAgB,EAAS,OAAO,CAAC,EAC1C,EAAkB,EAAsC,CAC5D,GAAG,EAAO,kBAAoB,IAAA,IAAa,EAAe,kBAAoB,IAAA,GAC1E,CAAE,gBAAiB,EAAc,EACjC,CAAC,EACL,GAAG,EAAO,YAAc,IAAA,IAAa,EAAe,YAAc,IAAA,GAC9D,CAAE,UAAW,EAAc,EAC3B,CAAC,CACP,CAAC,EAEG,EAAa,GACX,EAAQ,EAAW,gBAAgB,CAAS,CAAC,EACnD,OAAO,OAAO,OAAO,CACnB,OAAQ,EACR,QACA,YAAa,EAAa,YAC1B,kBACA,GAAG,IAAY,IAAA,GAAY,CAAC,EAAI,CAAE,SAAQ,EAC1C,GAAG,EAAU,kBAAoB,IAAA,GAC7B,CAAC,EACD,CAAE,gBAAiB,OAAO,OAAO,CAAC,GAAG,EAAU,eAAe,CAAC,CAAE,EACrE,QAAS,EAA0B,EAAU,IAAuC,CAGlF,GAAI,EACF,MAAM,IAAI,EACR,8CACA,EAAqB,qBACvB,EAEF,GAAI,CAAC,EAAiB,EAAS,CAAc,EAC3C,MAAM,IAAI,EACR,uDACA,EAAqB,qBACvB,EAGF,MADA,GAAa,GACN,KAAK,SAAS,EAAS,EAAS,CACrC,eACA,OAAQ,EACR,YACA,UAAW,EAAS,IAAkB,EAAY,OAAO,EAAS,CAAa,CACjF,CAAC,CACH,CACF,CAAC,CACH,CAYA,OAAO,EAA0B,EAAmD,CAClF,OAAO,KAAK,SAAS,EAAS,CAAO,CACvC,CAEA,SACE,EACA,EACA,EACiB,CACjB,IAAI,EAAwC,WACtC,EAAe,GAAU,cAAgB,KAAK,SAAS,IAAI,EAAQ,QAAQ,EACjF,OAAO,EAAsB,CAC3B,UACA,GAAI,GAAc,SAAW,IAAA,GAAY,CAAC,EAAI,CAAE,eAAgB,EAAa,MAAO,EACpF,GAAI,GAAc,WAAa,IAAA,GAAY,CAAC,EAAI,CAAE,iBAAkB,EAAa,QAAS,EAC1F,GAAI,IAAiB,IAAA,GAAY,CAAC,EAAI,CAAE,YAAc,GACpD,EAAa,YAAY,OAAS,UAC7B,EAAa,YAAY,eAAe,SAAS,CAAI,CAC1D,EACF,GAAI,IAAY,IAAA,GAAY,CAAC,EAAI,CAAE,SAAQ,EAC3C,GAAI,KAAK,cAAgB,IAAA,GAAY,CAAC,EAAI,CAAE,mBAAoB,KAAK,WAAY,EACjF,SAAU,KAAK,oBACf,aAAc,IAAa,IAAA,IAAa,KAAK,SAAS,IAAI,EAAQ,QAAQ,EAC1E,kBAAqB,EACrB,OAAQ,GAAiB,KAAK,YAC5B,EACA,MACM,CAAE,EAAgB,SAAU,EAClC,CACF,CACF,CAAC,CACH,CAcA,YACE,EACA,EACA,EACA,EAC4B,CAC5B,IAAM,EAAQ,CAAC,GAAG,KAAK,UAAU,EAC3B,MAAwC,CAC5C,IAAI,MAAyC,EAAc,CACzD,UAAS,UAAS,aAAY,gBAAiB,KAAK,gBACpD,aAAc,GAAY,KAAK,aAAa,CAAQ,EACpD,kBAAmB,GAAY,KAAK,SAAS,IAAI,CAAQ,CAAC,EAAE,QAC5D,GAAI,IAAa,IAAA,GAAY,CAAC,EAAI,CAAE,UAAS,CAC/C,CAAC,EACD,IAAK,IAAI,EAAQ,EAAM,OAAS,EAAG,GAAS,EAAG,IAAS,CACtD,IAAM,EAAa,EAAM,GACzB,GAAI,IAAe,IAAA,GAAW,SAC9B,IAAM,EAAQ,EACd,MAAa,EAAW,EAAS,EAAO,CAAO,CACjD,CACA,OAAO,EAAK,CACd,EACA,MAAO,CACL,OAAS,OAAO,gBAAiB,CAC/B,MAAO,EAAI,CACb,CACF,CACF,CAEA,aAAqB,EAAuC,CAC1D,IAAM,EAAe,KAAK,SAAS,IAAI,CAAQ,EAC/C,GAAI,IAAiB,IAAA,GACnB,MAAM,IAAI,EACR,6CAA6C,EAAS,GACtD,EAAqB,UACvB,EAEF,OAAO,CACT,CAEF,EAEA,SAAS,EAAoB,EAAe,EAAuB,CACjE,GAAI,CAAC,OAAO,cAAc,CAAK,GAAK,EAAQ,EAC1C,MAAU,WAAW,iBAAiB,EAAM,iCAAiC,EAE/E,OAAO,CACT"}
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/runtime/registry.ts"],"sourcesContent":["/**\n * The adapter registry and the streaming call API.\n *\n * This is the deepseek-harness `LlmRuntime` with its dependency-injection\n * framework removed: a plain `Map` for routes, an ordered array for the\n * interception point that was a cordis waterfall, and a listener set for the\n * topology event. What is kept is everything that made it trustworthy  E * all-or-nothing validating registration, an atomic route swap, prepare/dispatch\n * generation binding, and a single failure funnel at the adapter boundary.\n *\n * @module ai-agent-sdk/core/runtime/registry\n */\n\nimport type { ModelAdapter } from '../contract/adapter.ts'\nimport {\n  callConfigEquals,\n  type CallConfig,\n  type CallConfigAdapterDefaults,\n} from '../contract/call-config.ts'\nimport type { GenerateOptions } from '../contract/generate-options.ts'\nimport type {\n  ModelContext,\n  ModelCatalogOptions,\n  ModelCatalogSnapshot,\n  ModelInfo,\n  ModelModality,\n  ProviderInfo,\n  ResolvedModelInfo,\n  RuntimeDefaults,\n} from '../contract/model-info.ts'\nimport { resolveRetryPolicy, type ResolvedRetryPolicy } from '../contract/retry-policy.ts'\nimport { ModelError, REGISTRY_ERROR_CODES } from '../errors/model-error.ts'\nimport { deepFreeze } from '../primitives/freeze.ts'\nimport { SDK_VERSION } from '../primitives/version.ts'\nimport type { ObservationResource } from '../observation/event.ts'\nimport type { ObservationPort } from '../observation/port.ts'\nimport type { ModelCallHandle, ModelInvocationContext } from '../observation/report.ts'\nimport type { StreamChunk } from '../stream/chunk.ts'\nimport { createModelCallHandle } from './model-call-handle.ts'\nimport { normalizeResolvedModelInfo, resolveCallWithModelInfo,\n  validateCatalogModels, validateModelCatalogSnapshot } from './model-metadata.ts'\nimport { streamAdapter, type PreparedDispatch,\n  type RuntimeAdapterRegistration } from './model-stream.ts'\nimport {\n  PLUGIN_ERROR_CODES,\n  PluginError,\n  type AdapterRegistrationHandle,\n  type ModelProviderPlugin,\n  type ModelProviderRegistrar,\n  type PluginRegistrationHandle,\n  type StreamMiddleware,\n} from '../plugin/provider-plugin.ts'\n\nexport type { AdapterRegistrationHandle, StreamMiddleware } from '../plugin/provider-plugin.ts'\n\n/**\n * Wraps every streaming model call. Call `next()` to reach the adapter, or yield\n * your own chunks to short-circuit it entirely.\n *\n * This is the extension point for retry, caching, request logging, replay, and\n * test doubles. Middleware registered EARLIER sits further out.\n */\n/** One call whose configuration and adapter registration were resolved together. */\nexport interface PreparedCall {\n  /** Detached, deep-frozen config with any adapter-owned default materialized. */\n  readonly config: CallConfig\n  /** Immutable retry policy captured with the adapter registration. */\n  readonly retryPolicy: ResolvedRetryPolicy\n  /** Context capacity resolved with the registration-bound call. */\n  readonly context?: ModelContext\n  /** Exact model modalities captured with the dispatch generation. */\n  readonly inputModalities?: readonly ModelModality[]\n  /** Complete validated capability snapshot bound to this adapter generation. */\n  readonly model: ResolvedModelInfo\n  /** Which config fields the adapter supplied rather than the caller. */\n  readonly adapterDefaults: CallConfigAdapterDefaults\n  /**\n   * Dispatch this call ONCE, through the registration captured at preparation.\n   * @param options - the assembled request, carrying the prepared config.\n   * @returns the chunk stream, including middleware.\n   */\n  stream(options: GenerateOptions, context?: ModelInvocationContext): ModelCallHandle\n}\n\nexport interface ModelRegistryOptions {\n  /** Maximum model rows accepted from one adapter catalog. Defaults to 2,048. */\n  readonly maxCatalogModels?: number\n  /** Maximum serialized bytes accepted from a catalog or model-info record. Defaults to 4 MiB. */\n  readonly maxCatalogBytes?: number\n  /** Default observation port; a per-call invocation context may override it. */\n  readonly observation?: ObservationPort\n  /** Safe SDK/service/runtime identity copied onto observation events. */\n  readonly observationResource?: ObservationResource\n  /**\n   * SDK-wide fallbacks (context window, output cap, accepted modalities) used\n   * only when neither a model nor its route names one. See {@link RuntimeDefaults}.\n   */\n  readonly defaults?: RuntimeDefaults\n}\n\ntype AdapterRegistration = RuntimeAdapterRegistration\n\ninterface InstalledPlugin {\n  readonly routes: ReadonlySet<string>\n  readonly registrations: readonly AdapterRegistration[]\n  readonly middleware: readonly StreamMiddleware[]\n  readonly cleanup?: () => void\n}\n\n\nfunction containThenable(value: unknown): boolean {\n  if ((typeof value !== 'object' || value === null) && typeof value !== 'function') return false\n  let then: unknown\n  try {\n    then = Reflect.get(value, 'then')\n  } catch {\n    return true\n  }\n  if (typeof then !== 'function') return false\n  try { void Promise.resolve(value).catch(() => {}) } catch { /* hostile thenable contained */ }\n  return true\n}\n\nfunction synchronousCleanupFailure(cleanup: () => void): unknown | undefined {\n  try {\n    const result: unknown = cleanup()\n    return containThenable(result) ? new TypeError('plugin cleanup must be synchronous') : undefined\n  } catch (error) {\n    return error\n  }\n}\n\n\n/**\n * Routes model calls to registered adapters.\n *\n * Construct one per application or isolated runtime scope, register the adapters\n * you use, then call {@link stream} or {@link prepareCall}.\n */\nexport class ModelRegistry {\n  private adapters = new Map<string, AdapterRegistration>()\n  private middleware: StreamMiddleware[] = []\n  private listeners = new Set<() => void>()\n  private plugins = new Map<string, InstalledPlugin>()\n  private readonly maxCatalogModels: number\n  private readonly maxCatalogBytes: number\n  private readonly observation: ObservationPort | undefined\n  private readonly observationResource: ObservationResource\n  private readonly defaults: RuntimeDefaults\n\n  constructor(options: ModelRegistryOptions = {}) {\n    this.maxCatalogModels = positiveSafeInteger(options.maxCatalogModels ?? 2_048, 'maxCatalogModels')\n    this.maxCatalogBytes = positiveSafeInteger(options.maxCatalogBytes ?? 4 * 1024 * 1024, 'maxCatalogBytes')\n    this.observation = options.observation\n    this.defaults = validateRuntimeDefaults(options.defaults ?? {})\n    this.observationResource = deepFreeze(options.observationResource ?? {\n      sdkName: 'ai-agent-sdk',\n      sdkVersion: SDK_VERSION,\n      runtime: 'unknown',\n    })\n  }\n\n  /** Install one provider plugin as a single synchronous topology transaction. */\n  install(plugin: ModelProviderPlugin): PluginRegistrationHandle {\n    const pluginId = typeof plugin?.id === 'string' ? plugin.id : ''\n    const fail = (message: string, cause?: unknown, cleanupFailures: readonly unknown[] = []): never => {\n      const causes = [...cause === undefined ? [] : [cause], ...cleanupFailures]\n      const wrappedCause = causes.length <= 1 ? causes[0] : new AggregateError(causes, `plugin ${pluginId} install cleanup failed`)\n      throw new PluginError(message, PLUGIN_ERROR_CODES.INSTALL_FAILED, pluginId, wrappedCause === undefined ? undefined : { cause: wrappedCause })\n    }\n    if (pluginId.trim().length === 0 || pluginId !== pluginId.trim()) fail('plugin id must be a non-empty trimmed string')\n    if (this.plugins.has(pluginId)) fail(`plugin \"${pluginId}\" is already installed`)\n    if (typeof plugin.displayName !== 'string' || plugin.displayName.trim().length === 0) fail(`plugin \"${pluginId}\" displayName must be non-empty`)\n    if (typeof plugin.setup !== 'function') fail(`plugin \"${pluginId}\" setup must be a function`)\n    const family = plugin.family ?? pluginId\n    if (typeof family !== 'string' || family.trim().length === 0 || family !== family.trim()) {\n      fail(`plugin \"${pluginId}\" family must be a non-empty trimmed string`)\n    }\n    const owner = Object.freeze({ pluginId, family })\n\n    interface StagedAdapter {\n      active: boolean\n      routes: string[]\n      readonly adapter: ModelAdapter\n    }\n    interface StagedMiddleware { active: boolean; readonly middleware: StreamMiddleware }\n    const stagedAdapters: StagedAdapter[] = []\n    const stagedMiddleware: StagedMiddleware[] = []\n    let staging = true\n\n    const registrar: ModelProviderRegistrar = {\n      registerAdapter: (routes, adapter) => {\n        if (!staging) fail(`plugin \"${pluginId}\" staging registrar is closed`)\n        if (routes.length === 0) throw new ModelError('an adapter must register at least one provider route', REGISTRY_ERROR_CODES.INVALID_ADAPTER)\n        const item: StagedAdapter = { active: true, routes: [...routes], adapter }\n        // Validate metadata and conflicts without mutating live routes.\n        const occupied = new Set(stagedAdapters.filter(value => value.active).flatMap(value => value.routes))\n        for (const route of routes) if (occupied.has(route)) {\n          throw new ModelError(`an adapter for provider route \"${route}\" is already staged`, REGISTRY_ERROR_CODES.DUPLICATE_ADAPTER)\n        }\n        this.prepareRoutes(routes, adapter, new Set(), owner)\n        stagedAdapters.push(item)\n        const handle = (() => {\n          if (staging) item.active = false\n        }) as AdapterRegistrationHandle\n        handle.replace = (next) => {\n          if (!staging || !item.active) throw new ModelError('a disposed staged registration cannot replace routes', REGISTRY_ERROR_CODES.REGISTRATION_DISPOSED)\n          const occupiedByOthers = new Set(stagedAdapters.filter(value => value.active && value !== item).flatMap(value => value.routes))\n          for (const route of next) if (occupiedByOthers.has(route)) {\n            throw new ModelError(`an adapter for provider route \"${route}\" is already staged`, REGISTRY_ERROR_CODES.DUPLICATE_ADAPTER)\n          }\n          this.prepareRoutes(next, adapter, new Set(), owner)\n          item.routes = [...next]\n        }\n        return handle\n      },\n      use: (middleware) => {\n        if (!staging) fail(`plugin \"${pluginId}\" staging registrar is closed`)\n        if (typeof middleware !== 'function') throw new TypeError('plugin middleware must be a function')\n        const item: StagedMiddleware = { active: true, middleware }\n        stagedMiddleware.push(item)\n        return () => { if (staging) item.active = false }\n      },\n    }\n\n    let cleanup: (() => void) | undefined\n    try {\n      const result = plugin.setup(registrar)\n      if (containThenable(result)) fail(`plugin \"${pluginId}\" setup must be synchronous`)\n      if (result !== undefined && typeof result !== 'function') fail(`plugin \"${pluginId}\" setup must be synchronous and return void or cleanup`)\n      cleanup = typeof result === 'function' ? result : undefined\n    } catch (error) {\n      if (error instanceof PluginError && error.code === PLUGIN_ERROR_CODES.INSTALL_FAILED) throw error\n      fail(`plugin \"${pluginId}\" setup failed`, error)\n    } finally {\n      staging = false\n    }\n\n    const registrations: AdapterRegistration[] = []\n    const routeNames = new Set<string>()\n    try {\n      for (const item of stagedAdapters) {\n        if (!item.active) continue\n        for (const route of item.routes) {\n          if (routeNames.has(route)) throw new ModelError(`an adapter for provider route \"${route}\" is already staged`, REGISTRY_ERROR_CODES.DUPLICATE_ADAPTER)\n          routeNames.add(route)\n        }\n        registrations.push(...this.prepareRoutes(item.routes, item.adapter, new Set(), owner))\n      }\n    } catch (error) {\n      const cleanupFailures: unknown[] = []\n      if (cleanup) {\n        const cleanupFailure = synchronousCleanupFailure(cleanup)\n        if (cleanupFailure !== undefined) cleanupFailures.push(cleanupFailure)\n      }\n      fail(`plugin \"${pluginId}\" commit validation failed`, error, cleanupFailures)\n    }\n\n    const committedMiddleware = stagedMiddleware.filter(item => item.active).map(item => item.middleware)\n    for (const registration of registrations) this.adapters.set(registration.provider.id, registration)\n    this.middleware.push(...committedMiddleware)\n    const installed: InstalledPlugin = {\n      routes: routeNames,\n      registrations,\n      middleware: committedMiddleware,\n      ...(cleanup === undefined ? {} : { cleanup }),\n    }\n    this.plugins.set(pluginId, installed)\n    this.emitAdaptersUpdated()\n\n    let disposed = false\n    const dispose = (() => {\n      if (disposed) return\n      disposed = true\n      this.plugins.delete(pluginId)\n      for (const registration of installed.registrations) {\n        if (this.adapters.get(registration.provider.id) === registration) this.adapters.delete(registration.provider.id)\n      }\n      for (let index = installed.middleware.length - 1; index >= 0; index--) {\n        const middleware = installed.middleware[index]\n        const liveIndex = middleware === undefined ? -1 : this.middleware.lastIndexOf(middleware)\n        if (liveIndex >= 0) this.middleware.splice(liveIndex, 1)\n      }\n      this.emitAdaptersUpdated()\n      const failures: unknown[] = []\n      if (installed.cleanup) {\n        const cleanupFailure = synchronousCleanupFailure(installed.cleanup)\n        if (cleanupFailure !== undefined) failures.push(cleanupFailure)\n      }\n      if (failures.length > 0) {\n        throw new PluginError(\n          `plugin \"${pluginId}\" cleanup failed`,\n          PLUGIN_ERROR_CODES.CLEANUP_FAILED,\n          pluginId,\n          { cause: new AggregateError(failures, `plugin \"${pluginId}\" cleanup failed`) },\n        )\n      }\n    }) as PluginRegistrationHandle\n    Object.defineProperty(dispose, 'pluginId', { value: pluginId, enumerable: true })\n    return dispose\n  }\n\n  /**\n   * Register an adapter for the given routes.\n   *\n   * All-or-nothing: if ANY route conflicts, nothing is registered. A partial\n   * registration would leave the caller believing a route exists when it does not.\n   * @param providers - every route this adapter should serve; must be non-empty.\n   * @param adapter - the adapter that streams calls for those routes.\n   * @returns the disposer, carrying {@link AdapterRegistrationHandle.replace}.\n   */\n  registerAdapter(\n    providers: readonly string[],\n    adapter: ModelAdapter,\n  ): AdapterRegistrationHandle {\n    if (providers.length === 0) {\n      throw new ModelError(\n        'an adapter must register at least one provider route',\n        REGISTRY_ERROR_CODES.INVALID_ADAPTER,\n      )\n    }\n    /** Routes this registration currently holds; `replace` rewrites it. */\n    const owned = new Set<string>()\n    // `owned` being empty cannot signal disposal on its own, because\n    // `replace([])` legally leaves a live registration holding no routes.\n    let released = false\n\n    this.commitRoutes(owned, this.prepareRoutes(providers, adapter, owned))\n\n    const handle = (() => {\n      if (released) return\n      released = true\n      for (const provider of owned) this.adapters.delete(provider)\n      owned.clear()\n      this.emitAdaptersUpdated()\n    }) as AdapterRegistrationHandle\n\n    handle.replace = (next: readonly string[]): void => {\n      // Registering after disposal would leak: nothing remains to release what\n      // this call would put back into the map.\n      if (released) {\n        throw new ModelError(\n          'a disposed adapter registration cannot replace its routes',\n          REGISTRY_ERROR_CODES.REGISTRATION_DISPOSED,\n        )\n      }\n      this.commitRoutes(owned, this.prepareRoutes(next, adapter, owned))\n    }\n    return handle\n  }\n\n  /**\n   * Validate one candidate route set, treating routes this registration already\n   * holds as available. Mutates nothing  Ea rejected candidate leaves the registry\n   * exactly as it was.\n   */\n  private prepareRoutes(\n    providers: readonly string[],\n    adapter: ModelAdapter,\n    owned: ReadonlySet<string>,\n    owner?: Readonly<{ pluginId: string; family: string }>,\n  ): AdapterRegistration[] {\n    const unique = new Set<string>()\n    const registrations: AdapterRegistration[] = []\n    for (const provider of providers) {\n      if (typeof provider !== 'string' || provider.length === 0) {\n        throw new ModelError(\n          'adapter provider route names must be non-empty strings',\n          REGISTRY_ERROR_CODES.INVALID_ADAPTER,\n        )\n      }\n      if (unique.has(provider) || (this.adapters.has(provider) && !owned.has(provider))) {\n        throw new ModelError(\n          `an adapter for provider route \"${provider}\" is already registered`,\n          REGISTRY_ERROR_CODES.DUPLICATE_ADAPTER,\n        )\n      }\n      const info = adapter.providerInfo(provider)\n      if (typeof info.id !== 'string' || info.id !== provider\n        || typeof info.name !== 'string' || info.name.length === 0) {\n        throw new ModelError(\n          `adapter metadata for route \"${provider}\" must preserve its id and carry a non-empty name`,\n          REGISTRY_ERROR_CODES.INVALID_ADAPTER,\n        )\n      }\n      unique.add(provider)\n      registrations.push({\n        adapter,\n        provider: { id: info.id, name: info.name },\n        ...(owner === undefined ? {} : owner),\n        // Captured at REGISTRATION time, not per call. An adapter whose policy\n        // follows mutable configuration re-registers via `handle.replace`.\n        retryPolicy: adapter.providerRetryPolicy(provider)\n          ?? resolveRetryPolicy(undefined, `provider \"${provider}\" retryPolicy`),\n      })\n    }\n    return registrations\n  }\n\n  /**\n   * Swap this registration's routes in ONE synchronous section, so no caller can\n   * observe the registry between the release and the re-registration.\n   */\n  private commitRoutes(\n    owned: Set<string>,\n    registrations: readonly AdapterRegistration[],\n  ): void {\n    for (const provider of owned) this.adapters.delete(provider)\n    owned.clear()\n    for (const registration of registrations) {\n      this.adapters.set(registration.provider.id, registration)\n      owned.add(registration.provider.id)\n    }\n    this.emitAdaptersUpdated()\n  }\n\n  /**\n   * Install streaming middleware.\n   * @param middleware - wrapper invoked around every call; earlier registrations sit further out.\n   * @returns a disposer that removes exactly this middleware.\n   */\n  use(middleware: StreamMiddleware): () => void {\n    this.middleware.push(middleware)\n    return () => {\n      const index = this.middleware.indexOf(middleware)\n      if (index >= 0) this.middleware.splice(index, 1)\n    }\n  }\n\n  /**\n   * Observe route-topology changes (registration, replacement, disposal).\n   * @param listener - payload-free notification; re-read `listProviders()` for new state.\n   * @returns a disposer that removes the listener.\n   */\n  onAdaptersUpdated(listener: () => void): () => void {\n    this.listeners.add(listener)\n    return () => void this.listeners.delete(listener)\n  }\n\n  /**\n   * Notify topology observers.\n   *\n   * Each listener is contained independently: a topology notification is not a\n   * veto, so one broken observer must not starve the others or roll back a\n   * registration that already happened.\n   */\n  private emitAdaptersUpdated(): void {\n    for (const listener of [...this.listeners]) {\n      try {\n        listener()\n      } catch {\n        // Contained deliberately; see above.\n      }\n    }\n  }\n\n  /**\n   * Describe every route with a registered adapter.\n   * @returns detached provider metadata, in registration order.\n   */\n  listProviders(): ProviderInfo[] {\n    return [...this.adapters.values()].map(({ provider }) => ({ ...provider }))\n  }\n\n  /**\n   * List the models one route advertises.\n   *\n   * Re-validated here rather than trusted, because a malformed catalog entry\n   * surfaces in a caller's model picker where its origin is far from obvious.\n   * @param provider - a registered route.\n   * @returns detached, validated model metadata.\n   */\n  async listModels(provider: string, signal?: AbortSignal): Promise<ModelInfo[]> {\n    const registration = this.registration(provider)\n    const models = await registration.adapter.listModels(provider, signal)\n    return validateCatalogModels(provider, models, this.maxCatalogModels, this.maxCatalogBytes)\n  }\n\n  /** Resolve and validate one uncached adapter-level catalog generation. */\n  async modelCatalog(provider: string, options: ModelCatalogOptions = {}): Promise<ModelCatalogSnapshot> {\n    const registration = this.registration(provider)\n    const snapshot = await registration.adapter.modelCatalog(provider, options)\n    return validateModelCatalogSnapshot(provider, snapshot, this.maxCatalogModels, this.maxCatalogBytes)\n  }\n\n  /**\n   * Resolve metadata for one exact model.\n   * @param provider - a registered route.\n   * @param model - exact model id.\n   * @param signal - cancellation for adapter-side resolution.\n   * @returns validated, detached metadata.\n   */\n  async resolveModelInfo(\n    provider: string,\n    model: string,\n    signal?: AbortSignal,\n  ): Promise<ResolvedModelInfo> {\n    const registration = this.registration(provider)\n    const resolved = await registration.adapter.resolveModel(provider, model, signal)\n    return normalizeResolvedModelInfo(registration.provider.id, model, resolved, this.maxCatalogBytes, this.defaults)\n  }\n\n  /** The retry policy captured for one route. */\n  retryPolicy(provider: string): ResolvedRetryPolicy {\n    return this.registration(provider).retryPolicy\n  }\n\n  /**\n   * Resolve one call under its CURRENT adapter registration, returning a one-shot\n   * handle that keeps that registration through to dispatch.\n   * @param config - route, model, and optional request controls.\n   * @param signal - cancellation for adapter-side capability lookup.\n   * @returns the prepared config and its registration-bound stream entry point.\n   */\n  async prepareCall(\n    config: CallConfig,\n    signal?: AbortSignal,\n    invocationContext?: ModelInvocationContext,\n  ): Promise<PreparedCall> {\n    const registration = this.registration(config.provider)\n    const adapterCall = await registration.adapter.prepareCall(config.provider, config.model, signal, invocationContext)\n    const modelInfo = normalizeResolvedModelInfo(\n      registration.provider.id, config.model, adapterCall.model, this.maxCatalogBytes, this.defaults,\n    )\n    const resolved = resolveCallWithModelInfo(config, modelInfo, this.defaults)\n    const resolvedConfig = deepFreeze(structuredClone(resolved.config))\n    const context = resolved.context === undefined\n      ? undefined\n      : deepFreeze(structuredClone(resolved.context))\n    const adapterDefaults = deepFreeze<CallConfigAdapterDefaults>({\n      ...config.maxTokens === undefined && resolvedConfig.maxTokens !== undefined\n        ? { maxTokens: true as const }\n        : {},\n    })\n\n    let dispatched = false\n    const model = deepFreeze(structuredClone(modelInfo))\n    return Object.freeze({\n      config: resolvedConfig,\n      model,\n      retryPolicy: registration.retryPolicy,\n      adapterDefaults,\n      ...context === undefined ? {} : { context },\n      ...resolved.inputModalities === undefined\n        ? {}\n        : { inputModalities: Object.freeze([...resolved.inputModalities]) },\n      stream: (options: GenerateOptions, context = invocationContext): ModelCallHandle => {\n        // Both guards below exist so a stale handle fails loudly instead of\n        // quietly dispatching against a configuration nobody vetted.\n        if (dispatched) {\n          throw new ModelError(\n            'a prepared call can only be dispatched once',\n            REGISTRY_ERROR_CODES.INVALID_PREPARED_CALL,\n          )\n        }\n        if (!callConfigEquals(options, resolvedConfig)) {\n          throw new ModelError(\n            'prepared call config changed before adapter dispatch',\n            REGISTRY_ERROR_CODES.INVALID_PREPARED_CALL,\n          )\n        }\n        dispatched = true\n        return this.dispatch(options, context, {\n          registration,\n          config: resolvedConfig,\n          modelInfo,\n          dispatch: (request, activeContext) => adapterCall.stream(request, activeContext),\n        })\n      },\n    })\n  }\n\n  /**\n   * Stream one model call as raw chunks.\n   *\n   * Adapter selection, dispatch, and iteration failures become terminal `error` or\n   * `aborted` finish chunks. Middleware and consumer failures stay THROWN  Ethose\n   * are bugs in code the caller controls, and converting them to a finish reason\n   * would hide them.\n   * @param options - the full request; `options.provider` selects the adapter.\n   * @returns the chunk stream, wrapped by any installed middleware.\n   */\n  stream(options: GenerateOptions, context?: ModelInvocationContext): ModelCallHandle {\n    return this.dispatch(options, context)\n  }\n\n  private dispatch(\n    options: GenerateOptions,\n    context?: ModelInvocationContext,\n    prepared?: PreparedDispatch,\n  ): ModelCallHandle {\n    let dispatchState: 'not-sent' | 'unknown' = 'not-sent'\n    const registration = prepared?.registration ?? this.adapters.get(options.provider)\n    return createModelCallHandle({\n      options,\n      ...(registration?.family === undefined ? {} : { providerFamily: registration.family }),\n      ...(registration?.pluginId === undefined ? {} : { providerPluginId: registration.pluginId }),\n      ...(registration === undefined ? {} : { isRetryable: (code: string) => (\n        registration.retryPolicy.mode === 'always'\n          || registration.retryPolicy.retryableCodes.includes(code)\n      ) }),\n      ...(context === undefined ? {} : { context }),\n      ...(this.observation === undefined ? {} : { defaultObservation: this.observation }),\n      resource: this.observationResource,\n      routePresent: prepared !== undefined || this.adapters.has(options.provider),\n      dispatchState: () => dispatchState,\n      stream: activeContext => this.dispatchRaw(\n        options,\n        activeContext,\n        () => { dispatchState = 'unknown' },\n        prepared,\n      ),\n    })\n  }\n\n  /**\n   * Compose installed middleware around the adapter boundary.\n   *\n   * Composition is deferred to the first iteration rather than done eagerly, so\n   * that `stream()` ALWAYS returns an iterable and every failure — including a\n   * middleware that throws synchronously — surfaces on the same path. Composing\n   * eagerly would give callers two different error channels for the same class of\n   * fault, and they would inevitably handle only one.\n   *\n   * The middleware list is snapshotted here so that installing or removing\n   * middleware mid-stream cannot change the chain of a call already in flight.\n   */\n  private dispatchRaw(\n    options: GenerateOptions,\n    context: ModelInvocationContext,\n    onDispatch: () => void,\n    prepared?: PreparedDispatch,\n  ): AsyncIterable<StreamChunk> {\n    const chain = [...this.middleware]\n    const run = (): AsyncIterable<StreamChunk> => {\n      let next = (): AsyncIterable<StreamChunk> => streamAdapter({\n        options, context, onDispatch, maxCatalogBytes: this.maxCatalogBytes, defaults: this.defaults,\n        registration: provider => this.registration(provider),\n        registeredAdapter: provider => this.adapters.get(provider)?.adapter,\n        ...(prepared === undefined ? {} : { prepared }),\n      })\n      for (let index = chain.length - 1; index >= 0; index--) {\n        const middleware = chain[index]\n        if (middleware === undefined) continue\n        const inner = next\n        next = () => middleware(options, inner, context)\n      }\n      return next()\n    }\n    return {\n      async * [Symbol.asyncIterator]() {\n        yield* run()\n      },\n    }\n  }\n\n  private registration(provider: string): AdapterRegistration {\n    const registration = this.adapters.get(provider)\n    if (registration === undefined) {\n      throw new ModelError(\n        `no adapter registered for provider route \"${provider}\"`,\n        REGISTRY_ERROR_CODES.NO_ADAPTER,\n      )\n    }\n    return registration\n  }\n\n}\n\nfunction positiveSafeInteger(value: number, label: string): number {\n  if (!Number.isSafeInteger(value) || value < 1) {\n    throw new RangeError(`ModelRegistry ${label} must be a positive safe integer`)\n  }\n  return value\n}\n\nfunction validateRuntimeDefaults(defaults: RuntimeDefaults): RuntimeDefaults {\n  if (defaults.contextWindow !== undefined) positiveSafeInteger(defaults.contextWindow, 'defaults.contextWindow')\n  if (defaults.maxTokens !== undefined) positiveSafeInteger(defaults.maxTokens, 'defaults.maxTokens')\n  if (defaults.inputModalities !== undefined\n    && (defaults.inputModalities.length === 0\n      || new Set(defaults.inputModalities).size !== defaults.inputModalities.length)) {\n    throw new RangeError('ModelRegistry defaults.inputModalities must be non-empty and unique')\n  }\n  return deepFreeze({\n    ...(defaults.contextWindow === undefined ? {} : { contextWindow: defaults.contextWindow }),\n    ...(defaults.maxTokens === undefined ? {} : { maxTokens: defaults.maxTokens }),\n    ...(defaults.inputModalities === undefined ? {} : { inputModalities: [...defaults.inputModalities] }),\n  })\n}\n"],"mappings":"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"}

package/dist/tools.d.ts

@@ -6,10 +6,13 @@ import { MemorySpillStoreLimits, SPILL_TOOL_NAME, SpillRecord, SpillSlice, Spill
 import { ApprovalBroker, ApprovalDecision, ApprovalRequest, ApprovalStateStore, InteractiveApprovalBroker, InteractiveApprovalBrokerOptions, createApprovalBroker, createApprovalRequest, fixedApprovalBroker, withApprovalPersistence } from "./agent/tool/approval.js";
 import { REGISTRY_ERROR_CODES, ToolCatalog, ToolFilter, ToolRegistry } from "./agent/tool/registry.js";
 import { AuthorizationOutcome, AuthorizedToolCall, DispatchToolCallOptions, PostToolDecision, PreToolDecision, PreparedToolCall, ToolCallContext, ToolCallRequest, ToolInterceptor, authorizeToolCall, dispatchAuthorizedToolCall, dispatchToolCall, finalizeToolCall, prepareToolCall, toolFailure } from "./agent/tool/pipeline.js";
+import { ExperimentalProgramGrant, NESTED_TOOL_ERROR_CODES, NestedCallOptions, NestedLoadResult, NestedToolDescriptor, NestedToolPort, NestedToolResult, nestedToolPort } from "./agent/tool/nested.js";
 import { ToolCatalogSnapshot, ToolSource, ToolSourceDefinition, ToolSourceRunReference, ToolSourceSnapshotOptions } from "./agent/tool/source-types.js";
+import { EvidenceLine, EvidenceReducer, EvidenceReductionInput, EvidenceReductionResult, createModelEvidenceReducer, diagnosticLineNumbers, reduceEvidence } from "./agent/tool/evidence-reducer.js";
 import { TOOL_ERROR_CODES, ToolError, ToolErrorDisposition, toolErrorDisposition } from "./agent/tool/errors.js";
 import { RuntimeSchema, defineToolFromSchema } from "./agent/tool/schema.js";
 import { ToolExecutionBackend, ToolExecutionCapabilities, ToolExecutionRequest, ToolExecutionStore, ToolOperation, ToolOperationClaim, createToolExecutionInterceptor, localToolExecutionBackend } from "./agent/tool/execution.js";
+import { ActionFusionStep, defineActionFusion } from "./agent/tool/action-fusion.js";
 import { TOOL_SOURCE_API_VERSION } from "./composition/tool-source/config.js";
 import { defineToolSource } from "./composition/tool-source/definition.js";
-export { type ApprovalBroker, type ApprovalDecision, type ApprovalRequest, type ApprovalStateStore, type AuthorizationOutcome, type AuthorizedToolCall, type DispatchToolCallOptions, type InteractiveApprovalBroker, type InteractiveApprovalBrokerOptions, type JsonObject, type JsonValue, type MemorySpillStoreLimits, type PostToolDecision, type PreToolDecision, type PreparedToolCall, type RuntimeSchema, SPILL_TOOL_NAME, type SdkLogger, type SpillRecord, type SpillSlice, type SpillStore, TOOL_ERROR_CODES, REGISTRY_ERROR_CODES as TOOL_REGISTRY_ERROR_CODES, TOOL_SOURCE_API_VERSION, type ToolCallContext, type ToolCallPosition, type ToolCallRequest, type ToolCatalog, type ToolCatalogSnapshot, type ToolDefinition, ToolError, type ToolErrorDisposition, type ToolExecutionBackend, type ToolExecutionCapabilities, type ToolExecutionMode, type ToolExecutionRequest, type ToolExecutionResult, type ToolExecutionStore, type ToolFailure, type ToolFilter, type ToolInterceptor, type ToolOperation, type ToolOperationClaim, type ToolOutputOverflowPolicy, ToolRegistry, type ToolRunContext, type ToolSchema, type ToolSource, type ToolSourceDefinition, type ToolSourceRunReference, type ToolSourceSnapshotOptions, type ToolSuccess, type TruncatedText, authorizeToolCall, createApprovalBroker, createApprovalRequest, createMemorySpillStore, createToolExecutionInterceptor, defineTool, defineToolFromSchema, defineToolSource, dispatchAuthorizedToolCall, dispatchToolCall, estimateTextBlockTokens, estimateTextTokens, executionModeOf, finalizeToolCall, fixedApprovalBroker, localToolExecutionBackend, prepareToolCall, previewForSpill, readSpillTool, renderJsonValue, toolErrorDisposition, toolFailure, truncateMiddleToTokens, withApprovalPersistence };
+export { type ActionFusionStep, type ApprovalBroker, type ApprovalDecision, type ApprovalRequest, type ApprovalStateStore, type AuthorizationOutcome, type AuthorizedToolCall, type DispatchToolCallOptions, NESTED_TOOL_ERROR_CODES as EXPERIMENTAL_NESTED_TOOL_ERROR_CODES, type EvidenceLine, type EvidenceReducer, type EvidenceReductionInput, type EvidenceReductionResult, type NestedCallOptions as ExperimentalNestedCallOptions, type NestedLoadResult as ExperimentalNestedLoadResult, type NestedToolDescriptor as ExperimentalNestedToolDescriptor, type NestedToolPort as ExperimentalNestedToolPort, type NestedToolResult as ExperimentalNestedToolResult, type ExperimentalProgramGrant, type InteractiveApprovalBroker, type InteractiveApprovalBrokerOptions, type JsonObject, type JsonValue, type MemorySpillStoreLimits, type PostToolDecision, type PreToolDecision, type PreparedToolCall, type RuntimeSchema, SPILL_TOOL_NAME, type SdkLogger, type SpillRecord, type SpillSlice, type SpillStore, TOOL_ERROR_CODES, REGISTRY_ERROR_CODES as TOOL_REGISTRY_ERROR_CODES, TOOL_SOURCE_API_VERSION, type ToolCallContext, type ToolCallPosition, type ToolCallRequest, type ToolCatalog, type ToolCatalogSnapshot, type ToolDefinition, ToolError, type ToolErrorDisposition, type ToolExecutionBackend, type ToolExecutionCapabilities, type ToolExecutionMode, type ToolExecutionRequest, type ToolExecutionResult, type ToolExecutionStore, type ToolFailure, type ToolFilter, type ToolInterceptor, type ToolOperation, type ToolOperationClaim, type ToolOutputOverflowPolicy, ToolRegistry, type ToolRunContext, type ToolSchema, type ToolSource, type ToolSourceDefinition, type ToolSourceRunReference, type ToolSourceSnapshotOptions, type ToolSuccess, type TruncatedText, authorizeToolCall, createApprovalBroker, createApprovalRequest, createMemorySpillStore, createModelEvidenceReducer, createToolExecutionInterceptor, defineActionFusion, defineTool, defineToolFromSchema, defineToolSource, diagnosticLineNumbers, dispatchAuthorizedToolCall, dispatchToolCall, estimateTextBlockTokens, estimateTextTokens, executionModeOf, nestedToolPort as experimentalNestedToolPort, finalizeToolCall, fixedApprovalBroker, localToolExecutionBackend, prepareToolCall, previewForSpill, readSpillTool, reduceEvidence, renderJsonValue, toolErrorDisposition, toolFailure, truncateMiddleToTokens, withApprovalPersistence };

package/dist/tools.js

@@ -1 +1 @@
-import{defineTool as e,executionModeOf as t,renderJsonValue as n}from"./agent/tool/definition.js";import{REGISTRY_ERROR_CODES as r,ToolRegistry as i}from"./agent/tool/registry.js";import{SPILL_TOOL_NAME as a,createMemorySpillStore as o,estimateTextBlockTokens as s,estimateTextTokens as c,previewForSpill as l,readSpillTool as u,truncateMiddleToTokens as d}from"./agent/tool/output-budget.js";import{TOOL_ERROR_CODES as f,ToolError as p,toolErrorDisposition as m}from"./agent/tool/errors.js";import{createApprovalBroker as h,createApprovalRequest as g,fixedApprovalBroker as _,withApprovalPersistence as v}from"./agent/tool/approval.js";import{authorizeToolCall as y,dispatchAuthorizedToolCall as b,dispatchToolCall as x,finalizeToolCall as S,prepareToolCall as C,toolFailure as w}from"./agent/tool/pipeline.js";import{TOOL_SOURCE_API_VERSION as T}from"./composition/tool-source/config.js";import{defineToolSource as E}from"./composition/tool-source/definition.js";import{defineToolFromSchema as D}from"./agent/tool/schema.js";import{createToolExecutionInterceptor as O,localToolExecutionBackend as k}from"./agent/tool/execution.js";export{a as SPILL_TOOL_NAME,f as TOOL_ERROR_CODES,r as TOOL_REGISTRY_ERROR_CODES,T as TOOL_SOURCE_API_VERSION,p as ToolError,i as ToolRegistry,y as authorizeToolCall,h as createApprovalBroker,g as createApprovalRequest,o as createMemorySpillStore,O as createToolExecutionInterceptor,e as defineTool,D as defineToolFromSchema,E as defineToolSource,b as dispatchAuthorizedToolCall,x as dispatchToolCall,s as estimateTextBlockTokens,c as estimateTextTokens,t as executionModeOf,S as finalizeToolCall,_ as fixedApprovalBroker,k as localToolExecutionBackend,C as prepareToolCall,l as previewForSpill,u as readSpillTool,n as renderJsonValue,m as toolErrorDisposition,w as toolFailure,d as truncateMiddleToTokens,v as withApprovalPersistence};
+import{defineTool as e,executionModeOf as t,renderJsonValue as n}from"./agent/tool/definition.js";import{SPILL_TOOL_NAME as r,createMemorySpillStore as i,estimateTextBlockTokens as a,estimateTextTokens as o,previewForSpill as s,readSpillTool as c,truncateMiddleToTokens as l}from"./agent/tool/output-budget.js";import{createModelEvidenceReducer as u,diagnosticLineNumbers as d,reduceEvidence as f}from"./agent/tool/evidence-reducer.js";import{REGISTRY_ERROR_CODES as p,ToolRegistry as m}from"./agent/tool/registry.js";import{TOOL_ERROR_CODES as h,ToolError as g,toolErrorDisposition as _}from"./agent/tool/errors.js";import{createApprovalBroker as v,createApprovalRequest as y,fixedApprovalBroker as b,withApprovalPersistence as x}from"./agent/tool/approval.js";import{NESTED_TOOL_ERROR_CODES as S,nestedToolPort as C}from"./agent/tool/nested.js";import{authorizeToolCall as w,dispatchAuthorizedToolCall as T,dispatchToolCall as E,finalizeToolCall as D,prepareToolCall as O,toolFailure as k}from"./agent/tool/pipeline.js";import{TOOL_SOURCE_API_VERSION as A}from"./composition/tool-source/config.js";import{defineToolSource as j}from"./composition/tool-source/definition.js";import{defineToolFromSchema as M}from"./agent/tool/schema.js";import{createToolExecutionInterceptor as N,localToolExecutionBackend as P}from"./agent/tool/execution.js";import{defineActionFusion as F}from"./agent/tool/action-fusion.js";export{S as EXPERIMENTAL_NESTED_TOOL_ERROR_CODES,r as SPILL_TOOL_NAME,h as TOOL_ERROR_CODES,p as TOOL_REGISTRY_ERROR_CODES,A as TOOL_SOURCE_API_VERSION,g as ToolError,m as ToolRegistry,w as authorizeToolCall,v as createApprovalBroker,y as createApprovalRequest,i as createMemorySpillStore,u as createModelEvidenceReducer,N as createToolExecutionInterceptor,F as defineActionFusion,e as defineTool,M as defineToolFromSchema,j as defineToolSource,d as diagnosticLineNumbers,T as dispatchAuthorizedToolCall,E as dispatchToolCall,a as estimateTextBlockTokens,o as estimateTextTokens,t as executionModeOf,C as experimentalNestedToolPort,D as finalizeToolCall,b as fixedApprovalBroker,P as localToolExecutionBackend,O as prepareToolCall,s as previewForSpill,c as readSpillTool,f as reduceEvidence,n as renderJsonValue,_ as toolErrorDisposition,k as toolFailure,l as truncateMiddleToTokens,x as withApprovalPersistence};

package/package.json

@@ -4,7 +4,7 @@
     "name": "alvin0 - chaulamdinhai",
     "email": "chaulamdinhai@gmail.com"
   },
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Universal contracts and runtime primitives for ai-agent-sdk",
   "license": "MIT",
   "repository": {