@alvin0/ai-agent-sdk-core 0.1.0 → 0.1.1

package/dist/composition/agent/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","names":[],"sources":["../../../src/composition/agent/session.ts"],"sourcesContent":["import { publicMessage } from './public-message.ts'\nimport type { AgentInput } from '../../agent/define/session/types.ts'\nimport { isJsonValue, detachedFrozen, type JsonValue } from '../../primitives/index.ts'\nimport { freezeMessage } from '../../message/index.ts'\nimport { AgentRunError } from '../../agent/accounting/error.ts'\nimport type { RunReport } from '../exporter/delivery-types.ts'\nimport { configureRuntimeSessionModel, streamRuntimeSession, type AgentSession } from '../../agent/define/session.ts'\nimport {\n  compactRuntimeSession, streamPendingRuntimeSession, type RuntimeSessionRunHandle,\n} from '../../agent/define/session/runtime-binding.ts'\nimport type { AgentRunHandle as LegacyRunHandle } from '../../agent/define/session/types.ts'\nimport type { AgentRunEvent } from '../../agent/mode/run-agent.ts'\nimport type { ToolExecutionResult } from '../../agent/tool/definition.ts'\nimport { TOOL_ERROR_CODES } from '../../agent/tool/errors.ts'\nimport { AgentSdkError } from '../../errors/agent-sdk-error.ts'\nimport type { ModelRegistry } from '../../runtime/registry.ts'\nimport { atDeadline } from '../lifecycle/bounded.ts'\nimport type { RuntimeOperations } from '../lifecycle/operations.ts'\nimport type { RuntimeObservationPort } from '../observation/port.ts'\nimport { createRunTerminalRecord } from '../delivery/terminal.ts'\nimport { finalizeRuntimeRunReport, type RuntimeRunReport } from '../observation/final-report.ts'\nimport type { RuntimeObservationResource } from '../delivery/resource.ts'\nimport type { RuntimeResources } from '../../platform/resources.ts'\nimport { snapshotToolSources } from '../tool-source/snapshot.ts'\nimport { capabilityIdentityError, inheritCapabilityIdentityConflict } from '../identity/error.ts'\nimport type { CapturedToolSource } from '../tool-source/types.ts'\nimport type { ToolSourceRunReference } from '../tool-source/types.ts'\nimport { createRuntimeMemoryPersistence } from '../memory/run.ts'\nimport { validateMemoryResumeBinding } from '../memory/resume.ts'\nimport type { BoundRuntimeAgentDefinition } from './definition.ts'\nimport { captureInvocationOptions, captureRuntimeSessionOptions } from './options.ts'\nimport { projectNativeToolEvent } from './native-event.ts'\nimport type {\n  RuntimeAgent, RuntimeAgentInvocationOptions, RuntimeAgentResponse, RuntimeAgentRunEvent,\n  RuntimeAgentRunHandle, RuntimeAgentSession, RuntimeAgentSessionOptions, RuntimeAgentSessionSnapshot,\n} from './types.ts'\nimport type { CompactionResult } from '../../agent/memory/compaction.ts'\nimport type { AgentTeamMemberOptions } from '../../agent/define/session/types.ts'\nimport type { TeamSessionPort } from '../../agent/team/contracts.ts'\nimport { assertAgentIdentitySnapshot } from '../identity/agent.ts'\n\nexport interface RuntimeAgentHost {\n  readonly registry: ModelRegistry\n  readonly operations: RuntimeOperations\n  readonly observation: RuntimeObservationPort\n  readonly resource: RuntimeObservationResource\n  readonly resources: RuntimeResources\n}\n\ninterface RuntimeAgentBinding {\n  readonly host: RuntimeAgentHost\n  readonly definition: BoundRuntimeAgentDefinition\n}\n\nconst runtimeAgentBindings = new WeakMap<RuntimeAgent, RuntimeAgentBinding>()\n\nexport function createRuntimeAgent(host: RuntimeAgentHost, definition: BoundRuntimeAgentDefinition): RuntimeAgent {\n  const agent = Object.freeze({\n    model: definition.model,\n    generate(input: AgentInput, options?: RuntimeAgentInvocationOptions) { return createRuntimeSession(host, definition).run(input, options) },\n    stream(input: AgentInput, options?: RuntimeAgentInvocationOptions) { return createRuntimeSession(host, definition).stream(input, options) },\n    createSession(options?: RuntimeAgentSessionOptions) { return createRuntimeSession(host, definition, options) },\n    resumeSession(snapshot: RuntimeAgentSessionSnapshot, options?: RuntimeAgentSessionOptions) {\n      return createRuntimeSession(host, definition, options, snapshot)\n    },\n  })\n  runtimeAgentBindings.set(agent, Object.freeze({ host, definition }))\n  return agent\n}\n\nexport function createRuntimeTeamMemberSession(\n  host: RuntimeAgentHost,\n  agent: RuntimeAgent,\n  options: RuntimeAgentSessionOptions,\n  team: AgentTeamMemberOptions,\n  ownerSignal: AbortSignal,\n): { readonly view: RuntimeAgentSession; readonly port: TeamSessionPort } {\n  const binding = runtimeAgentBindings.get(agent)\n  if (binding?.host !== host) throw new AgentSdkError(\n    'Runtime team members must be agents from the same runtime', 'TEAM_AGENT_OWNERSHIP_INVALID',\n  )\n  const view = createRuntimeSession(host, binding.definition, options, undefined, team, ownerSignal)\n  return Object.freeze({ view, port: view.teamPort })\n}\n\nexport function preflightRuntimeTeamMember(\n  host: RuntimeAgentHost,\n  agent: RuntimeAgent,\n  options: RuntimeAgentSessionOptions,\n  additionalToolNames: readonly string[],\n): void {\n  const binding = runtimeAgentBindings.get(agent)\n  if (binding?.host !== host) throw new AgentSdkError(\n    'Runtime team members must be agents from the same runtime', 'TEAM_AGENT_OWNERSHIP_INVALID',\n  )\n  assertAgentIdentitySnapshot({\n    tools: [...binding.definition.legacy.tools, ...options.tools ?? []],\n    nativeTools: binding.definition.legacy.nativeTools,\n    skills: [...binding.definition.legacy.skills, ...options.skills ?? []] as never,\n    ...(binding.definition.legacy.skillIds === undefined ? {} : {\n      allowedSkillIds: binding.definition.legacy.skillIds,\n    }),\n    additionalToolNames,\n  })\n}\n\nexport function runtimeOwnsAgent(host: RuntimeAgentHost, agent: unknown): agent is RuntimeAgent {\n  return typeof agent === 'object' && agent !== null && runtimeAgentBindings.get(agent as RuntimeAgent)?.host === host\n}\n\nclass RuntimeAgentSessionValue implements RuntimeAgentSession {\n  private active: SessionOperation | undefined\n  private readonly observerTimeoutMs: number\n  readonly teamPort: TeamSessionPort\n\n  constructor(\n    private readonly host: RuntimeAgentHost,\n    private readonly session: AgentSession,\n    private readonly nativeProvider: string,\n    definitionId: string,\n    observerTimeoutMs = 30_000,\n    private readonly ownerSignal?: AbortSignal,\n  ) {\n    this.observerTimeoutMs = observerTimeoutMs\n    const owner = this\n    this.teamPort = Object.freeze({\n      definition: Object.freeze({ id: definitionId }),\n      get conversationId() { return owner.conversationId },\n      get isRunning() { return owner.isRunning },\n      inject(input: Parameters<TeamSessionPort['inject']>[0]) { return owner.injectForTeam(input) },\n      whenIdle(signal?: AbortSignal) { return owner.whenIdle(signal) },\n      runPending(invocation = {}) { return owner.runPendingForTeam(invocation) },\n    })\n  }\n\n  get conversationId(): string { return this.session.conversationId }\n  get isRunning(): boolean { return this.active !== undefined }\n\n  stream(input: AgentInput, rawOptions?: RuntimeAgentInvocationOptions): RuntimeAgentRunHandle {\n    if (typeof input !== 'string') {\n      if (input === null || typeof input !== 'object' || input.role !== 'user') throw new TypeError('Runtime input must be text or a user message')\n      input = freezeMessage(input)\n    }\n    const options = captureInvocationOptions(rawOptions)\n    const started = this.start(input, options)\n    return runtimeHandle(started.legacy, started.report, started.result, this.nativeProvider)\n  }\n\n  private start(input: AgentInput | undefined, options: RuntimeAgentInvocationOptions): StartedRuntimeRun {\n    const operation = this.beginOperation()\n    let lease: ReturnType<RuntimeOperations['acquire']>\n    try {\n      const signal = this.ownerSignal === undefined\n        ? options.signal\n        : options.signal === undefined ? this.ownerSignal : AbortSignal.any([options.signal, this.ownerSignal])\n      lease = this.host.operations.acquire('agent-run', {\n        ...(signal === undefined ? {} : { signal }),\n      })\n    } catch (error) { this.finishOperation(operation); throw error }\n    let output: JsonValue | undefined\n    const structured = options.structuredOutput\n    let legacy: RuntimeSessionRunHandle\n    try {\n      legacy = input === undefined\n        ? streamPendingRuntimeSession(this.session, { signal: lease.signal })\n        : streamRuntimeSession(this.session, input, { signal: lease.signal, ...(structured === undefined ? {} : {\n          outputFormat: { type: 'json_schema' as const, name: structured.name, schema: structured.schema.jsonSchema },\n          validateOutput: (value: unknown) => {\n            const parsed = structured.schema.parse(value)\n            if (!isJsonValue(parsed)) throw new TypeError('structured output parser must return lossless JSON synchronously')\n            output = detachedFrozen(parsed)\n          },\n        }), ...(options.imagePolicy === undefined ? {} : { imagePolicy: options.imagePolicy }) }, options.additionalInstructions)\n    } catch (error) { lease.settle(); this.finishOperation(operation); throw error }\n    const abort = (): void => legacy.abort()\n    lease.signal.addEventListener('abort', abort, { once: true })\n    if (lease.signal.aborted) abort()\n    void lease.whenSealed.then(() => legacy.seal()).catch(() => undefined)\n    const report = this.runtimeReport(legacy.report, legacy.toolSourceSnapshots, lease.signal)\n    const internalResult = this.runtimeResult(legacy.result, report, () => output)\n    const eventsSettled = Promise.race([legacy.eventsSettled, lease.whenSealed])\n    const released = Promise.allSettled([eventsSettled, internalResult, report]).then(() => {\n      lease.signal.removeEventListener('abort', abort)\n      lease.settle()\n      this.finishOperation(operation)\n    })\n    const result = released.then(() => internalResult)\n    void result.catch(() => undefined)\n    void report.catch(() => undefined)\n    return Object.freeze({ legacy, report, result })\n  }\n\n  async run(input: AgentInput, rawOptions?: RuntimeAgentInvocationOptions): Promise<RuntimeAgentResponse> {\n    const options = captureInvocationOptions(rawOptions)\n    const handle = this.stream(input, options)\n    try {\n      for await (const event of handle) {\n        if (options.onEvent !== undefined) {\n          try { await this.observe(options.onEvent, event, handle) }\n          catch (error) {\n            handle.abort()\n            const report = await handle.report\n            throw runtimeFailure(error, report, 'RUN_EVENT_OBSERVER_FAILED')\n          }\n        }\n      }\n    } catch (error) { if (codeOf(error) === 'RUN_EVENT_OBSERVER_FAILED') throw error; return await handle.result }\n    return await handle.result\n  }\n\n  inject(input: AgentInput): number {\n    this.host.operations.assertActive()\n    this.assertOwnerActive()\n    if (this.active !== undefined) throw new Error('Cannot inject while a runtime session is active')\n    return this.session.inject(input)\n  }\n\n  private injectForTeam(input: Parameters<TeamSessionPort['inject']>[0]): number {\n    this.host.operations.assertActive()\n    this.assertOwnerActive()\n    return this.session.inject(input)\n  }\n\n  snapshot(): RuntimeAgentSessionSnapshot { return this.session.snapshot() }\n\n  compact(rawOptions?: RuntimeAgentInvocationOptions): Promise<CompactionResult | null> {\n    const options = captureInvocationOptions(rawOptions)\n    const operation = this.beginOperation()\n    let pending: Promise<CompactionResult | null>\n    try {\n      pending = this.host.operations.execute('manual-compaction', {\n        ...(this.ownerSignal === undefined\n          ? options.signal === undefined ? {} : { signal: options.signal }\n          : { signal: options.signal === undefined ? this.ownerSignal : AbortSignal.any([options.signal, this.ownerSignal]) }),\n      }, async lease => {\n        const outcome = await compactRuntimeSession(this.session, { signal: lease.signal })\n        const record = createRunTerminalRecord(outcome.report)\n        const terminal = await this.host.observation.checkpointTerminal(record, lease.signal)\n        const report = finalizeRuntimeRunReport(record, outcome.report.delivery, terminal,\n          this.host.observation.mode, this.host.observation.requiredBoundary)\n        if (outcome.failure !== undefined) throw runtimeFailure(\n          outcome.failure,\n          report,\n          report.errors.at(-1)?.code ?? codeOf(outcome.failure),\n        )\n        return outcome.result === null ? null : Object.freeze({ ...outcome.result, status: 'completed' as const, report })\n      })\n    } catch (error) { this.finishOperation(operation); throw error }\n    return pending.finally(() => this.finishOperation(operation))\n  }\n\n  reset(): void {\n    this.host.operations.assertActive()\n    this.assertOwnerActive()\n    if (this.active !== undefined) throw new Error('Cannot reset while a runtime session is active')\n    this.session.reset()\n  }\n\n  whenIdle(signal?: AbortSignal): Promise<void> {\n    const pending = this.active?.done\n    if (pending === undefined) return Promise.resolve()\n    if (signal?.aborted) return Promise.reject(new AgentSdkError('Runtime idle wait was aborted', 'RUNTIME_OPERATION_ABORTED'))\n    return new Promise((resolve, reject) => {\n      let release = (): void => undefined\n      const finish = (error?: Error): void => { release(); error === undefined ? resolve() : reject(error) }\n      if (signal !== undefined) release = this.host.resources.onAbort(signal,\n        () => finish(new AgentSdkError('Runtime idle wait was aborted', 'RUNTIME_OPERATION_ABORTED')))\n      void pending.then(() => finish())\n    })\n  }\n\n  private async runPendingForTeam(invocation: {\n    readonly signal?: AbortSignal\n    readonly onEvent?: (event: AgentRunEvent) => void | Promise<void>\n  }): Promise<unknown> {\n    const started = this.start(undefined, {\n      ...(invocation.signal === undefined ? {} : { signal: invocation.signal }),\n    })\n    try {\n      for await (const event of started.legacy) await invocation.onEvent?.(event)\n    } catch (error) {\n      started.legacy.abort()\n      await started.result.catch(() => undefined)\n      throw error\n    }\n    return await started.result\n  }\n\n  private beginOperation(): SessionOperation {\n    this.assertOwnerActive()\n    if (this.active !== undefined) throw new Error('Cannot start while a runtime session is active')\n    let resolve!: () => void\n    const operation: SessionOperation = { done: new Promise(done => { resolve = done }), resolve }\n    this.active = operation\n    return operation\n  }\n\n  private finishOperation(operation: SessionOperation): void {\n    if (this.active !== operation) return\n    this.active = undefined\n    operation.resolve()\n  }\n\n  private assertOwnerActive(): void {\n    if (this.ownerSignal?.aborted === true) {\n      throw new AgentSdkError('Runtime team session is closed', 'TEAM_CLOSED')\n    }\n  }\n\n  private async runtimeReport(\n    legacy: Promise<RunReport>,\n    sourceSnapshots: Promise<readonly ToolSourceRunReference[]>,\n    signal: AbortSignal,\n  ): Promise<RuntimeRunReport> {\n    const [previous, sources] = await Promise.all([legacy, sourceSnapshots])\n    const record = createRunTerminalRecord(previous, sources)\n    const terminal = await this.host.observation.checkpointTerminal(record, signal)\n    return finalizeRuntimeRunReport(record, previous.delivery, terminal,\n      this.host.observation.mode, this.host.observation.requiredBoundary)\n  }\n\n  private async runtimeResult(\n    legacy: Promise<Awaited<LegacyRunHandle['result']>>,\n    report: Promise<RuntimeRunReport>,\n    output: () => JsonValue | undefined,\n  ): Promise<RuntimeAgentResponse> {\n    try {\n      const response = await legacy\n      const final = await report\n      if (final.status !== 'success') {\n        throw runtimeFailure(undefined, final, final.errors.at(-1)?.code ?? 'AGENT_RUN_FAILED')\n      }\n      const parsedOutput = output()\n      return Object.freeze({ runId: final.runId, traceId: final.traceId,\n        completed: response.outcome.completed, stopReason: response.outcome.reason.kind,\n        text: response.text, ...(parsedOutput === undefined ? {} : { output: parsedOutput }),\n        ...(response.message === undefined ? {} : { message: publicMessage(response.message) }),\n        usage: final.usage, report: final })\n    } catch (error) {\n      const final = await report\n      throw runtimeFailure(error, final, codeOf(error))\n    }\n  }\n\n  private async observe(\n    observer: NonNullable<RuntimeAgentInvocationOptions['onEvent']>,\n    event: RuntimeAgentRunEvent,\n    handle: RuntimeAgentRunHandle,\n  ): Promise<void> {\n    const deadlineAt = this.host.resources.platform.monotonicNow() + this.observerTimeoutMs\n    try { await atDeadline(this.host.resources, deadlineAt, () => observer(event), undefined) }\n    catch { handle.abort(); throw new AgentSdkError('Runtime event observer did not complete', 'RUN_EVENT_OBSERVER_FAILED') }\n  }\n}\n\nfunction createRuntimeSession(\n  host: RuntimeAgentHost,\n  definition: BoundRuntimeAgentDefinition,\n  options: RuntimeAgentSessionOptions = {},\n  snapshot?: RuntimeAgentSessionSnapshot,\n  team?: AgentTeamMemberOptions,\n  ownerSignal?: AbortSignal,\n): RuntimeAgentSessionValue {\n  host.operations.assertActive()\n  options = captureRuntimeSessionOptions(options)\n  assertAgentIdentitySnapshot({\n    tools: [...definition.legacy.tools, ...options.tools ?? []],\n    nativeTools: definition.legacy.nativeTools,\n    skills: [...definition.legacy.skills, ...options.skills ?? []] as never,\n    ...(definition.legacy.skillIds === undefined ? {} : { allowedSkillIds: definition.legacy.skillIds }),\n  })\n  const memory = options.memory === false ? undefined : options.memory ?? definition.memory\n  if (snapshot !== undefined) validateMemoryResumeBinding(snapshot, memory)\n  const toolSources = combineToolSources(definition.toolSources, options.toolSources ?? [])\n  const limits = options.runtimeLimits\n  const { maxSteps: _maxSteps, maxToolCalls: _maxToolCalls, ...agentRuntimeLimits } = limits ?? {}\n  const selected = limits?.maxSteps === undefined && limits?.maxToolCalls === undefined\n    ? definition.legacy : definition.legacy.with({\n      ...(limits.maxSteps === undefined ? {} : { maxTurns: limits.maxSteps }),\n      ...(limits.maxToolCalls === undefined ? {} : { maxToolCalls: limits.maxToolCalls }),\n    })\n  const shared = { registry: host.registry, observation: host.observation, observationResource: host.resource,\n    ...(options.tools === undefined ? {} : { tools: options.tools }),\n    ...(options.skills === undefined ? {} : { skills: options.skills as never }),\n    ...(options.skillCwd === undefined ? {} : { skillCwd: options.skillCwd }),\n    ...(options.userInput === undefined ? {} : { userInput: options.userInput }),\n    ...(options.approvals === undefined ? {} : { approvals: options.approvals }),\n    ...(options.spillStore === undefined ? {} : { spillStore: options.spillStore }),\n    ...(options.interceptors === undefined ? {} : { interceptors: options.interceptors }),\n    ...(options.contextSections === undefined ? {} : { contextSections: options.contextSections }),\n    ...(options.hooks === undefined ? {} : { hooks: options.hooks }),\n    ...(options.usagePolicy === undefined ? {} : { usagePolicy: options.usagePolicy }),\n    ...(options.historyLimits === undefined ? {} : { historyLimits: options.historyLimits }),\n    ...(options.ledgerLimits === undefined ? {} : { ledgerLimits: options.ledgerLimits }),\n    ...(options.eventBufferLimits === undefined ? {} : { eventBufferLimits: options.eventBufferLimits }),\n    ...(options.compaction === undefined ? {} : { compaction: options.compaction }),\n    ...(team === undefined ? {} : { team }),\n    ...(Object.keys(agentRuntimeLimits).length === 0 ? {} : { runtimeLimits: agentRuntimeLimits }),\n  }\n  const session = snapshot === undefined\n    ? selected.createSession({ ...shared, ...(options.conversationId === undefined ? {} : { conversationId: options.conversationId }) })\n    : selected.resumeSession({ ...shared, snapshot })\n  configureRuntimeSessionModel(session, { provider: definition.model.provider, model: definition.model.id,\n    ...(definition.effort === undefined ? {} : { reasoningEffort: definition.effort }),\n    ...(definition.maxTokens === undefined ? {} : { maxTokens: definition.maxTokens }),\n    logger: correlation => host.observation.correlatedLogger(correlation, { scope: 'sdk.agent.run' }),\n    ...(toolSources.length === 0 ? {} : {\n      prepareTools: (signal, logger, occupiedNames) => snapshotToolSources(\n        toolSources, signal, logger, occupiedNames,\n      ),\n    }),\n    ...(memory === undefined ? {} : {\n      memory: createRuntimeMemoryPersistence(\n        memory,\n        definition.legacy.id,\n        agentRuntimeLimits.memoryOperationTimeoutMs,\n      ),\n    }),\n  })\n  return new RuntimeAgentSessionValue(\n    host, session, definition.model.provider, definition.legacy.id, limits?.observerTimeoutMs, ownerSignal,\n  )\n}\n\ninterface SessionOperation {\n  readonly done: Promise<void>\n  readonly resolve: () => void\n}\n\ninterface StartedRuntimeRun {\n  readonly legacy: RuntimeSessionRunHandle\n  readonly report: Promise<RuntimeRunReport>\n  readonly result: Promise<RuntimeAgentResponse>\n}\n\nfunction combineToolSources(\n  defined: readonly CapturedToolSource[],\n  additional: readonly CapturedToolSource[],\n): readonly CapturedToolSource[] {\n  const all = [...defined, ...additional]\n  const seen = new Map<string, number>()\n  for (const [index, source] of all.entries()) {\n    const first = seen.get(source.id)\n    if (first !== undefined) throw capabilityIdentityError(\n      'TOOL_SOURCE_ID_CONFLICT', 'tool-source-id', first, index,\n    )\n    seen.set(source.id, index)\n  }\n  return Object.freeze(all)\n}\n\nfunction runtimeHandle(\n  source: LegacyRunHandle & { readonly traceId: string; abort(reason?: unknown): void },\n  report: Promise<RuntimeRunReport>, result: Promise<RuntimeAgentResponse>, nativeProvider: string,\n): RuntimeAgentRunHandle {\n  let iterated = false\n  return Object.freeze({ runId: source.runId, report, result, abort: () => source.abort(),\n    [Symbol.asyncIterator](): AsyncIterator<RuntimeAgentRunEvent> {\n      if (iterated) return (async function* () { throw new Error('A runtime run handle can only be iterated once') })()\n      iterated = true\n      return projectEvents(source, report, nativeProvider)\n    } })\n}\n\nasync function* projectEvents(\n  source: LegacyRunHandle & { readonly traceId: string; abort(reason?: unknown): void },\n  report: Promise<RuntimeRunReport>,\n  nativeProvider: string,\n): AsyncGenerator<RuntimeAgentRunEvent> {\n  let sequence = 0, completed = false\n  const context = () => ({ runId: source.runId, traceId: source.traceId, sequence: ++sequence, schemaVersion: 1 as const })\n  try {\n    for await (const event of source) {\n      const projected = projectEvent(event, nativeProvider)\n      if (projected !== undefined) yield Object.freeze({ ...context(), ...projected }) as RuntimeAgentRunEvent\n    }\n    const terminal = await report\n    if (terminal.status === 'success') {\n      yield Object.freeze({ ...context(), type: 'usage', usage: terminal.usage, report: terminal })\n    } else {\n      const error = terminal.errors.at(-1) ?? fallbackError(terminal)\n      yield Object.freeze({ ...context(), type: 'error', error, report: terminal })\n    }\n    completed = true\n  } catch {\n    const terminal = await report\n    const error = terminal.errors.at(-1) ?? fallbackError(terminal)\n    yield Object.freeze({ ...context(), type: 'error', error, report: terminal })\n    completed = true\n  } finally { if (!completed) source.abort() }\n}\n\ntype WithoutEventContext<T> = T extends unknown ? Omit<T, 'runId' | 'traceId' | 'sequence' | 'schemaVersion'> : never\ntype ProjectedEvent = WithoutEventContext<RuntimeAgentRunEvent>\n\nfunction projectEvent(event: AgentRunEvent, nativeProvider: string): ProjectedEvent | undefined {\n  if (event.type === 'text-delta') return {\n    type: event.phase === 'commentary' ? 'commentary-delta' : 'assistant-delta',\n    text: event.text, index: event.index, phase: event.phase, blockId: `${event.trace.spanId}:${event.index}`,\n  }\n  if (event.type === 'assistant-message') return { type: 'assistant-message', message: publicMessage(event.message) }\n  if (event.type === 'text-end' || event.type === 'reasoning-delta') {\n    const { trace, ...content } = event\n    return { ...content, blockId: `${trace.spanId}:${event.index}` }\n  }\n  if (event.type === 'image-delta') {\n    const { trace, ...content } = event\n    return { ...content, blockId: `${trace.spanId}:${event.itemId}` }\n  }\n  if (event.type === 'compaction-start' || event.type === 'compaction-end'\n    || event.type === 'turn-start' || event.type === 'step-start' || event.type === 'step-end'\n    || event.type === 'assistant-text' || event.type === 'assistant-reasoning') {\n    const { trace: _trace, ...content } = event\n    return content\n  }\n  if (event.type === 'tool-call') return { type: 'tool-call', callId: event.call.callId,\n    name: event.call.toolName, input: parseInput(event.call.rawArguments) }\n  if (event.type === 'tool-result') return { type: 'tool-result', callId: event.call.callId,\n    name: event.call.toolName, status: toolResultStatus(event.result), output: event.result }\n  if (event.type === 'assistant-native-tool') return projectNativeToolEvent(event.call, nativeProvider)\n  if (event.type === 'approval-request') return { type: 'approval-request', request: event.request }\n  if (event.type === 'user-input-request') return { type: 'user-input-request', request: event.request }\n  if (event.type === 'user-input-response') return { type: 'user-input-response', requestId: event.request.requestId,\n    response: event.response }\n  return undefined\n}\n\nfunction toolResultStatus(\n  result: ToolExecutionResult,\n): 'completed' | 'failed' | 'aborted' | 'rejected' | 'declined' {\n  // A call the loop refused to run is neither success nor failure: nothing\n  // broke, and nothing was done. Reporting it as either misleads a UI — and a\n  // red row for a budget decision is what makes a finished run look crashed.\n  if (!result.isError) return result.meta?.['declined'] === true ? 'declined' : 'completed'\n  if (result.error.code === TOOL_ERROR_CODES.ABORTED\n    || result.error.code === TOOL_ERROR_CODES.ABORTED_BEFORE_DISPATCH) return 'aborted'\n  if (result.error.code === TOOL_ERROR_CODES.UNKNOWN_TOOL\n    || result.error.code === TOOL_ERROR_CODES.INVALID_ARGUMENTS\n    || result.error.code === TOOL_ERROR_CODES.MALFORMED_ARGUMENTS\n    || result.error.code === TOOL_ERROR_CODES.DENIED\n    || result.error.code === TOOL_ERROR_CODES.BUDGET_EXHAUSTED\n    || result.error.code === TOOL_ERROR_CODES.CHECKPOINT_FAILED) return 'rejected'\n  return 'failed'\n}\n\nfunction parseInput(value: string): unknown { try { return JSON.parse(value) as unknown } catch { return value } }\nfunction codeOf(value: unknown): string {\n  return value instanceof AgentSdkError ? value.code : 'AGENT_RUN_FAILED'\n}\nfunction runtimeFailure(value: unknown, report: RuntimeRunReport, code: string): AgentRunError {\n  return inheritCapabilityIdentityConflict(\n    new AgentRunError('Agent run did not complete', code, report as never), value,\n  )\n}\nfunction fallbackError(report: RuntimeRunReport): RuntimeRunReport['errors'][number] {\n  return Object.freeze({ code: 'AGENT_RUN_FAILED', stage: 'agent-run', message: 'Agent operation failed',\n    usageCoverage: report.usage.coverage,\n    possiblyBilledAttemptsWithoutUsage: report.usage.coverage.possiblyBilledAttemptsWithoutUsage })\n}\n"],"mappings":"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"}
+{"version":3,"file":"session.js","names":[],"sources":["../../../src/composition/agent/session.ts"],"sourcesContent":["import { publicMessage } from './public-message.ts'\nimport type { AgentInput } from '../../agent/define/session/types.ts'\nimport { isJsonValue, detachedFrozen, type JsonValue } from '../../primitives/index.ts'\nimport { freezeMessage } from '../../message/index.ts'\nimport { AgentRunError } from '../../agent/accounting/error.ts'\nimport type { RunReport } from '../exporter/delivery-types.ts'\nimport { configureRuntimeSessionModel, streamRuntimeSession, type AgentSession } from '../../agent/define/session.ts'\nimport {\n  compactRuntimeSession, streamPendingRuntimeSession, type RuntimeSessionRunHandle,\n} from '../../agent/define/session/runtime-binding.ts'\nimport type { AgentRunHandle as LegacyRunHandle } from '../../agent/define/session/types.ts'\nimport type { AgentRunEvent } from '../../agent/mode/run-agent.ts'\nimport type { ToolExecutionResult } from '../../agent/tool/definition.ts'\nimport { TOOL_ERROR_CODES } from '../../agent/tool/errors.ts'\nimport { AgentSdkError } from '../../errors/agent-sdk-error.ts'\nimport type { ModelRegistry } from '../../runtime/registry.ts'\nimport type { ProviderSelection } from '../provider/types.ts'\nimport type { ReasoningEffortId } from '../../primitives/brand.ts'\nimport { atDeadline } from '../lifecycle/bounded.ts'\nimport type { RuntimeOperations } from '../lifecycle/operations.ts'\nimport type { RuntimeObservationPort } from '../observation/port.ts'\nimport { createRunTerminalRecord } from '../delivery/terminal.ts'\nimport { finalizeRuntimeRunReport, type RuntimeRunReport } from '../observation/final-report.ts'\nimport type { RuntimeObservationResource } from '../delivery/resource.ts'\nimport type { RuntimeResources } from '../../platform/resources.ts'\nimport { snapshotToolSources } from '../tool-source/snapshot.ts'\nimport { capabilityIdentityError, inheritCapabilityIdentityConflict } from '../identity/error.ts'\nimport type { CapturedToolSource } from '../tool-source/types.ts'\nimport type { ToolSourceRunReference } from '../tool-source/types.ts'\nimport { createRuntimeMemoryPersistence } from '../memory/run.ts'\nimport { validateMemoryResumeBinding } from '../memory/resume.ts'\nimport type { BoundRuntimeAgentDefinition } from './definition.ts'\nimport { captureInvocationOptions, captureRuntimeSessionOptions, type CapturedInvocationOptions } from './options.ts'\nimport { projectNativeToolEvent } from './native-event.ts'\nimport type {\n  RuntimeAgent, RuntimeAgentInvocationOptions, RuntimeAgentResponse, RuntimeAgentRunEvent,\n  RuntimeAgentRunHandle, RuntimeAgentSession, RuntimeAgentSessionOptions, RuntimeAgentSessionSnapshot,\n} from './types.ts'\nimport type { CompactionResult } from '../../agent/memory/compaction.ts'\nimport type { AgentTeamMemberOptions } from '../../agent/define/session/types.ts'\nimport type { TeamSessionPort } from '../../agent/team/contracts.ts'\nimport { assertAgentIdentitySnapshot } from '../identity/agent.ts'\n\nexport interface RuntimeAgentHost {\n  readonly registry: ModelRegistry\n  /**\n   * The runtime's captured provider routes.\n   *\n   * Held so a per-invocation model override resolves against exactly the same\n   * configuration the agent binding used, rather than a second view of it.\n   */\n  readonly selection: ProviderSelection\n  readonly operations: RuntimeOperations\n  readonly observation: RuntimeObservationPort\n  readonly resource: RuntimeObservationResource\n  readonly resources: RuntimeResources\n}\n\ninterface RuntimeAgentBinding {\n  readonly host: RuntimeAgentHost\n  readonly definition: BoundRuntimeAgentDefinition\n}\n\nconst runtimeAgentBindings = new WeakMap<RuntimeAgent, RuntimeAgentBinding>()\n\nexport function createRuntimeAgent(host: RuntimeAgentHost, definition: BoundRuntimeAgentDefinition): RuntimeAgent {\n  const agent = Object.freeze({\n    model: definition.model,\n    generate(input: AgentInput, options?: RuntimeAgentInvocationOptions) { return createRuntimeSession(host, definition).run(input, options) },\n    stream(input: AgentInput, options?: RuntimeAgentInvocationOptions) { return createRuntimeSession(host, definition).stream(input, options) },\n    createSession(options?: RuntimeAgentSessionOptions) { return createRuntimeSession(host, definition, options) },\n    resumeSession(snapshot: RuntimeAgentSessionSnapshot, options?: RuntimeAgentSessionOptions) {\n      return createRuntimeSession(host, definition, options, snapshot)\n    },\n  })\n  runtimeAgentBindings.set(agent, Object.freeze({ host, definition }))\n  return agent\n}\n\nexport function createRuntimeTeamMemberSession(\n  host: RuntimeAgentHost,\n  agent: RuntimeAgent,\n  options: RuntimeAgentSessionOptions,\n  team: AgentTeamMemberOptions,\n  ownerSignal: AbortSignal,\n): { readonly view: RuntimeAgentSession; readonly port: TeamSessionPort } {\n  const binding = runtimeAgentBindings.get(agent)\n  if (binding?.host !== host) throw new AgentSdkError(\n    'Runtime team members must be agents from the same runtime', 'TEAM_AGENT_OWNERSHIP_INVALID',\n  )\n  const view = createRuntimeSession(host, binding.definition, options, undefined, team, ownerSignal)\n  return Object.freeze({ view, port: view.teamPort })\n}\n\nexport function preflightRuntimeTeamMember(\n  host: RuntimeAgentHost,\n  agent: RuntimeAgent,\n  options: RuntimeAgentSessionOptions,\n  additionalToolNames: readonly string[],\n): void {\n  const binding = runtimeAgentBindings.get(agent)\n  if (binding?.host !== host) throw new AgentSdkError(\n    'Runtime team members must be agents from the same runtime', 'TEAM_AGENT_OWNERSHIP_INVALID',\n  )\n  assertAgentIdentitySnapshot({\n    tools: [...binding.definition.legacy.tools, ...options.tools ?? []],\n    nativeTools: binding.definition.legacy.nativeTools,\n    skills: [...binding.definition.legacy.skills, ...options.skills ?? []] as never,\n    ...(binding.definition.legacy.skillIds === undefined ? {} : {\n      allowedSkillIds: binding.definition.legacy.skillIds,\n    }),\n    additionalToolNames,\n  })\n}\n\nexport function runtimeOwnsAgent(host: RuntimeAgentHost, agent: unknown): agent is RuntimeAgent {\n  return typeof agent === 'object' && agent !== null && runtimeAgentBindings.get(agent as RuntimeAgent)?.host === host\n}\n\nclass RuntimeAgentSessionValue implements RuntimeAgentSession {\n  private active: SessionOperation | undefined\n  private readonly observerTimeoutMs: number\n  readonly teamPort: TeamSessionPort\n\n  constructor(\n    private readonly host: RuntimeAgentHost,\n    private readonly session: AgentSession,\n    private readonly nativeProvider: string,\n    definitionId: string,\n    observerTimeoutMs = 30_000,\n    private readonly ownerSignal?: AbortSignal,\n  ) {\n    this.observerTimeoutMs = observerTimeoutMs\n    const owner = this\n    this.teamPort = Object.freeze({\n      definition: Object.freeze({ id: definitionId }),\n      get conversationId() { return owner.conversationId },\n      get isRunning() { return owner.isRunning },\n      inject(input: Parameters<TeamSessionPort['inject']>[0]) { return owner.injectForTeam(input) },\n      whenIdle(signal?: AbortSignal) { return owner.whenIdle(signal) },\n      runPending(invocation = {}) { return owner.runPendingForTeam(invocation) },\n    })\n  }\n\n  get conversationId(): string { return this.session.conversationId }\n  get isRunning(): boolean { return this.active !== undefined }\n\n  stream(input: AgentInput, rawOptions?: RuntimeAgentInvocationOptions): RuntimeAgentRunHandle {\n    if (typeof input !== 'string') {\n      if (input === null || typeof input !== 'object' || input.role !== 'user') throw new TypeError('Runtime input must be text or a user message')\n      input = freezeMessage(input)\n    }\n    const options = captureInvocationOptions(rawOptions, this.host.selection)\n    const started = this.start(input, options)\n    return runtimeHandle(started.legacy, started.report, started.result, this.nativeProvider, options.includeTraceEvents === true)\n  }\n\n  private start(input: AgentInput | undefined, options: CapturedInvocationOptions): StartedRuntimeRun {\n    const operation = this.beginOperation()\n    let lease: ReturnType<RuntimeOperations['acquire']>\n    try {\n      const signal = this.ownerSignal === undefined\n        ? options.signal\n        : options.signal === undefined ? this.ownerSignal : AbortSignal.any([options.signal, this.ownerSignal])\n      lease = this.host.operations.acquire('agent-run', {\n        ...(signal === undefined ? {} : { signal }),\n      })\n    } catch (error) { this.finishOperation(operation); throw error }\n    let output: JsonValue | undefined\n    const structured = options.structuredOutput\n    let legacy: RuntimeSessionRunHandle\n    try {\n      legacy = input === undefined\n        ? streamPendingRuntimeSession(this.session, { signal: lease.signal, ...modelOverlay(options) })\n        : streamRuntimeSession(this.session, input, { signal: lease.signal, ...modelOverlay(options),\n          ...(structured === undefined ? {} : {\n          outputFormat: { type: 'json_schema' as const, name: structured.name, schema: structured.schema.jsonSchema },\n          validateOutput: (value: unknown) => {\n            const parsed = structured.schema.parse(value)\n            if (!isJsonValue(parsed)) throw new TypeError('structured output parser must return lossless JSON synchronously')\n            output = detachedFrozen(parsed)\n          },\n        }), ...(options.imagePolicy === undefined ? {} : { imagePolicy: options.imagePolicy }),\n        ...(options.documentPolicy === undefined ? {} : { documentPolicy: options.documentPolicy }) }, options.additionalInstructions)\n    } catch (error) { lease.settle(); this.finishOperation(operation); throw error }\n    const abort = (): void => legacy.abort()\n    lease.signal.addEventListener('abort', abort, { once: true })\n    if (lease.signal.aborted) abort()\n    void lease.whenSealed.then(() => legacy.seal()).catch(() => undefined)\n    const report = this.runtimeReport(legacy.report, legacy.toolSourceSnapshots, lease.signal)\n    const internalResult = this.runtimeResult(legacy.result, report, () => output)\n    const eventsSettled = Promise.race([legacy.eventsSettled, lease.whenSealed])\n    const released = Promise.allSettled([eventsSettled, internalResult, report]).then(() => {\n      lease.signal.removeEventListener('abort', abort)\n      lease.settle()\n      this.finishOperation(operation)\n    })\n    const result = released.then(() => internalResult)\n    void result.catch(() => undefined)\n    void report.catch(() => undefined)\n    return Object.freeze({ legacy, report, result })\n  }\n\n  async run(input: AgentInput, rawOptions?: RuntimeAgentInvocationOptions): Promise<RuntimeAgentResponse> {\n    const options = captureInvocationOptions(rawOptions, this.host.selection)\n    const handle = this.stream(input, options)\n    try {\n      for await (const event of handle) {\n        if (options.onEvent !== undefined) {\n          try { await this.observe(options.onEvent, event, handle) }\n          catch (error) {\n            handle.abort()\n            const report = await handle.report\n            throw runtimeFailure(error, report, 'RUN_EVENT_OBSERVER_FAILED')\n          }\n        }\n      }\n    } catch (error) { if (codeOf(error) === 'RUN_EVENT_OBSERVER_FAILED') throw error; return await handle.result }\n    return await handle.result\n  }\n\n  inject(input: AgentInput): number {\n    this.host.operations.assertActive()\n    this.assertOwnerActive()\n    if (this.active !== undefined) throw new Error('Cannot inject while a runtime session is active')\n    return this.session.inject(input)\n  }\n\n  private injectForTeam(input: Parameters<TeamSessionPort['inject']>[0]): number {\n    this.host.operations.assertActive()\n    this.assertOwnerActive()\n    return this.session.inject(input)\n  }\n\n  snapshot(): RuntimeAgentSessionSnapshot { return this.session.snapshot() }\n\n  compact(rawOptions?: RuntimeAgentInvocationOptions): Promise<CompactionResult | null> {\n    const options = captureInvocationOptions(rawOptions, this.host.selection)\n    const operation = this.beginOperation()\n    let pending: Promise<CompactionResult | null>\n    try {\n      pending = this.host.operations.execute('manual-compaction', {\n        ...(this.ownerSignal === undefined\n          ? options.signal === undefined ? {} : { signal: options.signal }\n          : { signal: options.signal === undefined ? this.ownerSignal : AbortSignal.any([options.signal, this.ownerSignal]) }),\n      }, async lease => {\n        const outcome = await compactRuntimeSession(this.session, { signal: lease.signal, ...modelOverlay(options) })\n        const record = createRunTerminalRecord(outcome.report)\n        const terminal = await this.host.observation.checkpointTerminal(record, lease.signal)\n        const report = finalizeRuntimeRunReport(record, outcome.report.delivery, terminal,\n          this.host.observation.mode, this.host.observation.requiredBoundary)\n        if (outcome.failure !== undefined) throw runtimeFailure(\n          outcome.failure,\n          report,\n          report.errors.at(-1)?.code ?? codeOf(outcome.failure),\n        )\n        return outcome.result === null ? null : Object.freeze({ ...outcome.result, status: 'completed' as const, report })\n      })\n    } catch (error) { this.finishOperation(operation); throw error }\n    return pending.finally(() => this.finishOperation(operation))\n  }\n\n  reset(): void {\n    this.host.operations.assertActive()\n    this.assertOwnerActive()\n    if (this.active !== undefined) throw new Error('Cannot reset while a runtime session is active')\n    this.session.reset()\n  }\n\n  whenIdle(signal?: AbortSignal): Promise<void> {\n    const pending = this.active?.done\n    if (pending === undefined) return Promise.resolve()\n    if (signal?.aborted) return Promise.reject(new AgentSdkError('Runtime idle wait was aborted', 'RUNTIME_OPERATION_ABORTED'))\n    return new Promise((resolve, reject) => {\n      let release = (): void => undefined\n      const finish = (error?: Error): void => { release(); error === undefined ? resolve() : reject(error) }\n      if (signal !== undefined) release = this.host.resources.onAbort(signal,\n        () => finish(new AgentSdkError('Runtime idle wait was aborted', 'RUNTIME_OPERATION_ABORTED')))\n      void pending.then(() => finish())\n    })\n  }\n\n  private async runPendingForTeam(invocation: {\n    readonly signal?: AbortSignal\n    readonly onEvent?: (event: AgentRunEvent) => void | Promise<void>\n  }): Promise<unknown> {\n    const started = this.start(undefined, {\n      ...(invocation.signal === undefined ? {} : { signal: invocation.signal }),\n    })\n    try {\n      for await (const event of started.legacy) await invocation.onEvent?.(event)\n    } catch (error) {\n      started.legacy.abort()\n      await started.result.catch(() => undefined)\n      throw error\n    }\n    return await started.result\n  }\n\n  private beginOperation(): SessionOperation {\n    this.assertOwnerActive()\n    if (this.active !== undefined) throw new Error('Cannot start while a runtime session is active')\n    let resolve!: () => void\n    const operation: SessionOperation = { done: new Promise(done => { resolve = done }), resolve }\n    this.active = operation\n    return operation\n  }\n\n  private finishOperation(operation: SessionOperation): void {\n    if (this.active !== operation) return\n    this.active = undefined\n    operation.resolve()\n  }\n\n  private assertOwnerActive(): void {\n    if (this.ownerSignal?.aborted === true) {\n      throw new AgentSdkError('Runtime team session is closed', 'TEAM_CLOSED')\n    }\n  }\n\n  private async runtimeReport(\n    legacy: Promise<RunReport>,\n    sourceSnapshots: Promise<readonly ToolSourceRunReference[]>,\n    signal: AbortSignal,\n  ): Promise<RuntimeRunReport> {\n    const [previous, sources] = await Promise.all([legacy, sourceSnapshots])\n    const record = createRunTerminalRecord(previous, sources)\n    const terminal = await this.host.observation.checkpointTerminal(record, signal)\n    return finalizeRuntimeRunReport(record, previous.delivery, terminal,\n      this.host.observation.mode, this.host.observation.requiredBoundary)\n  }\n\n  private async runtimeResult(\n    legacy: Promise<Awaited<LegacyRunHandle['result']>>,\n    report: Promise<RuntimeRunReport>,\n    output: () => JsonValue | undefined,\n  ): Promise<RuntimeAgentResponse> {\n    try {\n      const response = await legacy\n      const final = await report\n      if (final.status !== 'success') {\n        throw runtimeFailure(undefined, final, final.errors.at(-1)?.code ?? 'AGENT_RUN_FAILED')\n      }\n      const parsedOutput = output()\n      return Object.freeze({ runId: final.runId, traceId: final.traceId,\n        completed: response.outcome.completed, stopReason: response.outcome.reason.kind,\n        text: response.text, ...(parsedOutput === undefined ? {} : { output: parsedOutput }),\n        ...(response.message === undefined ? {} : { message: publicMessage(response.message) }),\n        usage: final.usage, report: final })\n    } catch (error) {\n      const final = await report\n      throw runtimeFailure(error, final, codeOf(error))\n    }\n  }\n\n  private async observe(\n    observer: NonNullable<RuntimeAgentInvocationOptions['onEvent']>,\n    event: RuntimeAgentRunEvent,\n    handle: RuntimeAgentRunHandle,\n  ): Promise<void> {\n    const deadlineAt = this.host.resources.platform.monotonicNow() + this.observerTimeoutMs\n    try { await atDeadline(this.host.resources, deadlineAt, () => observer(event), undefined) }\n    catch { handle.abort(); throw new AgentSdkError('Runtime event observer did not complete', 'RUN_EVENT_OBSERVER_FAILED') }\n  }\n}\n\nfunction createRuntimeSession(\n  host: RuntimeAgentHost,\n  definition: BoundRuntimeAgentDefinition,\n  options: RuntimeAgentSessionOptions = {},\n  snapshot?: RuntimeAgentSessionSnapshot,\n  team?: AgentTeamMemberOptions,\n  ownerSignal?: AbortSignal,\n): RuntimeAgentSessionValue {\n  host.operations.assertActive()\n  options = captureRuntimeSessionOptions(options)\n  assertAgentIdentitySnapshot({\n    tools: [...definition.legacy.tools, ...options.tools ?? []],\n    nativeTools: definition.legacy.nativeTools,\n    skills: [...definition.legacy.skills, ...options.skills ?? []] as never,\n    ...(definition.legacy.skillIds === undefined ? {} : { allowedSkillIds: definition.legacy.skillIds }),\n  })\n  const memory = options.memory === false ? undefined : options.memory ?? definition.memory\n  if (snapshot !== undefined) validateMemoryResumeBinding(snapshot, memory)\n  const toolSources = combineToolSources(definition.toolSources, options.toolSources ?? [])\n  const limits = options.runtimeLimits\n  const { maxSteps: _maxSteps, maxToolCalls: _maxToolCalls, ...agentRuntimeLimits } = limits ?? {}\n  const selected = limits?.maxSteps === undefined && limits?.maxToolCalls === undefined\n    ? definition.legacy : definition.legacy.with({\n      ...(limits.maxSteps === undefined ? {} : { maxTurns: limits.maxSteps }),\n      ...(limits.maxToolCalls === undefined ? {} : { maxToolCalls: limits.maxToolCalls }),\n    })\n  const shared = { registry: host.registry, observation: host.observation, observationResource: host.resource,\n    ...(options.tools === undefined ? {} : { tools: options.tools }),\n    ...(options.skills === undefined ? {} : { skills: options.skills as never }),\n    ...(options.skillCwd === undefined ? {} : { skillCwd: options.skillCwd }),\n    ...(options.userInput === undefined ? {} : { userInput: options.userInput }),\n    ...(options.approvals === undefined ? {} : { approvals: options.approvals }),\n    ...(options.spillStore === undefined ? {} : { spillStore: options.spillStore }),\n    ...(options.interceptors === undefined ? {} : { interceptors: options.interceptors }),\n    ...(options.contextSections === undefined ? {} : { contextSections: options.contextSections }),\n    ...(options.hooks === undefined ? {} : { hooks: options.hooks }),\n    ...(options.usagePolicy === undefined ? {} : { usagePolicy: options.usagePolicy }),\n    ...(options.historyLimits === undefined ? {} : { historyLimits: options.historyLimits }),\n    ...(options.ledgerLimits === undefined ? {} : { ledgerLimits: options.ledgerLimits }),\n    ...(options.eventBufferLimits === undefined ? {} : { eventBufferLimits: options.eventBufferLimits }),\n    ...(options.compaction === undefined ? {} : { compaction: options.compaction }),\n    ...(team === undefined ? {} : { team }),\n    ...(Object.keys(agentRuntimeLimits).length === 0 ? {} : { runtimeLimits: agentRuntimeLimits }),\n  }\n  const session = snapshot === undefined\n    ? selected.createSession({ ...shared, ...(options.conversationId === undefined ? {} : { conversationId: options.conversationId }) })\n    : selected.resumeSession({ ...shared, snapshot })\n  configureRuntimeSessionModel(session, { provider: definition.model.provider, model: definition.model.id,\n    ...(definition.effort === undefined ? {} : { reasoningEffort: definition.effort }),\n    ...(definition.maxTokens === undefined ? {} : { maxTokens: definition.maxTokens }),\n    logger: correlation => host.observation.correlatedLogger(correlation, { scope: 'sdk.agent.run' }),\n    ...(toolSources.length === 0 ? {} : {\n      prepareTools: (signal, logger, occupiedNames) => snapshotToolSources(\n        toolSources, signal, logger, occupiedNames,\n      ),\n    }),\n    ...(memory === undefined ? {} : {\n      memory: createRuntimeMemoryPersistence(\n        memory,\n        definition.legacy.id,\n        agentRuntimeLimits.memoryOperationTimeoutMs,\n      ),\n    }),\n  })\n  return new RuntimeAgentSessionValue(\n    host, session, definition.model.provider, definition.legacy.id, limits?.observerTimeoutMs, ownerSignal,\n  )\n}\n\n/** Project one captured invocation onto the low-level per-run model overlay. */\nfunction modelOverlay(options: CapturedInvocationOptions): {\n  readonly model?: { readonly provider: string; readonly model: string }\n  readonly reasoningEffort?: ReturnType<typeof ReasoningEffortId>\n  readonly maxTokens?: number\n} {\n  return {\n    ...(options.model === undefined ? {} : { model: { provider: options.model.provider, model: options.model.id } }),\n    ...(options.effort === undefined ? {} : { reasoningEffort: options.effort }),\n    ...(options.maxTokens === undefined ? {} : { maxTokens: options.maxTokens }),\n  }\n}\n\ninterface SessionOperation {\n  readonly done: Promise<void>\n  readonly resolve: () => void\n}\n\ninterface StartedRuntimeRun {\n  readonly legacy: RuntimeSessionRunHandle\n  readonly report: Promise<RuntimeRunReport>\n  readonly result: Promise<RuntimeAgentResponse>\n}\n\nfunction combineToolSources(\n  defined: readonly CapturedToolSource[],\n  additional: readonly CapturedToolSource[],\n): readonly CapturedToolSource[] {\n  const all = [...defined, ...additional]\n  const seen = new Map<string, number>()\n  for (const [index, source] of all.entries()) {\n    const first = seen.get(source.id)\n    if (first !== undefined) throw capabilityIdentityError(\n      'TOOL_SOURCE_ID_CONFLICT', 'tool-source-id', first, index,\n    )\n    seen.set(source.id, index)\n  }\n  return Object.freeze(all)\n}\n\nfunction runtimeHandle(\n  source: LegacyRunHandle & { readonly traceId: string; abort(reason?: unknown): void },\n  report: Promise<RuntimeRunReport>, result: Promise<RuntimeAgentResponse>, nativeProvider: string,\n  includeTraceEvents: boolean,\n): RuntimeAgentRunHandle {\n  let iterated = false\n  return Object.freeze({ runId: source.runId, report, result, abort: () => source.abort(),\n    [Symbol.asyncIterator](): AsyncIterator<RuntimeAgentRunEvent> {\n      if (iterated) return (async function* () { throw new Error('A runtime run handle can only be iterated once') })()\n      iterated = true\n      return projectEvents(source, report, nativeProvider, includeTraceEvents)\n    } })\n}\n\nasync function* projectEvents(\n  source: LegacyRunHandle & { readonly traceId: string; abort(reason?: unknown): void },\n  report: Promise<RuntimeRunReport>,\n  nativeProvider: string,\n  includeTraceEvents: boolean,\n): AsyncGenerator<RuntimeAgentRunEvent> {\n  let sequence = 0, completed = false\n  const context = () => ({ runId: source.runId, traceId: source.traceId, sequence: ++sequence, schemaVersion: 1 as const })\n  try {\n    for await (const event of source) {\n      const projected = projectEvent(event, nativeProvider, includeTraceEvents)\n      if (projected !== undefined) yield Object.freeze({ ...context(), ...projected }) as RuntimeAgentRunEvent\n    }\n    const terminal = await report\n    if (terminal.status === 'success') {\n      yield Object.freeze({ ...context(), type: 'usage', usage: terminal.usage, report: terminal })\n    } else {\n      const error = terminal.errors.at(-1) ?? fallbackError(terminal)\n      yield Object.freeze({ ...context(), type: 'error', error, report: terminal })\n    }\n    completed = true\n  } catch {\n    const terminal = await report\n    const error = terminal.errors.at(-1) ?? fallbackError(terminal)\n    yield Object.freeze({ ...context(), type: 'error', error, report: terminal })\n    completed = true\n  } finally { if (!completed) source.abort() }\n}\n\ntype WithoutEventContext<T> = T extends unknown ? Omit<T, 'runId' | 'traceId' | 'sequence' | 'schemaVersion'> : never\ntype ProjectedEvent = WithoutEventContext<RuntimeAgentRunEvent>\n\nfunction projectEvent(event: AgentRunEvent, nativeProvider: string, includeTraceEvents: boolean): ProjectedEvent | undefined {\n  if (event.type === 'usage-progress') return { type: 'usage-progress', usage: event.usage,\n    ...(event.attemptId === undefined ? {} : { attemptId: event.attemptId }) }\n  // Runtime consumers such as Edge hosts may persist an execution trace. Keep\n  // the SDK's span lifecycle intact; unlike transcript events, spans carry the\n  // identity and nesting needed to reconstruct the call tree.\n  if (includeTraceEvents && (event.type === 'span-start' || event.type === 'span-end')) return event\n  if (event.type === 'text-delta') return {\n    type: event.phase === 'commentary' ? 'commentary-delta' : 'assistant-delta',\n    text: event.text, index: event.index, phase: event.phase, blockId: `${event.trace.spanId}:${event.index}`,\n  }\n  if (event.type === 'assistant-message') return { type: 'assistant-message', message: publicMessage(event.message) }\n  if (event.type === 'text-end' || event.type === 'reasoning-delta') {\n    const { trace, ...content } = event\n    return { ...content, blockId: `${trace.spanId}:${event.index}` }\n  }\n  if (event.type === 'image-delta') {\n    const { trace, ...content } = event\n    return { ...content, blockId: `${trace.spanId}:${event.itemId}` }\n  }\n  if (event.type === 'compaction-start' || event.type === 'compaction-end'\n    || event.type === 'turn-start' || event.type === 'step-start' || event.type === 'step-end'\n    || event.type === 'assistant-text' || event.type === 'assistant-reasoning') {\n    const { trace: _trace, ...content } = event\n    return content\n  }\n  if (event.type === 'tool-call') return { type: 'tool-call', callId: event.call.callId,\n    name: event.call.toolName, input: parseInput(event.call.rawArguments) }\n  if (event.type === 'tool-result') return { type: 'tool-result', callId: event.call.callId,\n    name: event.call.toolName, status: toolResultStatus(event.result), output: event.result }\n  if (event.type === 'assistant-native-tool') return projectNativeToolEvent(event.call, nativeProvider)\n  if (event.type === 'approval-request') return { type: 'approval-request', request: event.request }\n  if (event.type === 'user-input-request') return { type: 'user-input-request', request: event.request }\n  if (event.type === 'user-input-response') return { type: 'user-input-response', requestId: event.request.requestId,\n    response: event.response }\n  return undefined\n}\n\nfunction toolResultStatus(\n  result: ToolExecutionResult,\n): 'completed' | 'failed' | 'aborted' | 'rejected' | 'declined' {\n  // A call the loop refused to run is neither success nor failure: nothing\n  // broke, and nothing was done. Reporting it as either misleads a UI — and a\n  // red row for a budget decision is what makes a finished run look crashed.\n  if (!result.isError) return result.meta?.['declined'] === true ? 'declined' : 'completed'\n  if (result.error.code === TOOL_ERROR_CODES.ABORTED\n    || result.error.code === TOOL_ERROR_CODES.ABORTED_BEFORE_DISPATCH) return 'aborted'\n  if (result.error.code === TOOL_ERROR_CODES.UNKNOWN_TOOL\n    || result.error.code === TOOL_ERROR_CODES.INVALID_ARGUMENTS\n    || result.error.code === TOOL_ERROR_CODES.MALFORMED_ARGUMENTS\n    || result.error.code === TOOL_ERROR_CODES.DENIED\n    || result.error.code === TOOL_ERROR_CODES.BUDGET_EXHAUSTED\n    || result.error.code === TOOL_ERROR_CODES.CHECKPOINT_FAILED) return 'rejected'\n  return 'failed'\n}\n\nfunction parseInput(value: string): unknown { try { return JSON.parse(value) as unknown } catch { return value } }\nfunction codeOf(value: unknown): string {\n  return value instanceof AgentSdkError ? value.code : 'AGENT_RUN_FAILED'\n}\nfunction runtimeFailure(value: unknown, report: RuntimeRunReport, code: string): AgentRunError {\n  return inheritCapabilityIdentityConflict(\n    new AgentRunError('Agent run did not complete', code, report as never), value,\n  )\n}\nfunction fallbackError(report: RuntimeRunReport): RuntimeRunReport['errors'][number] {\n  return Object.freeze({ code: 'AGENT_RUN_FAILED', stage: 'agent-run', message: 'Agent operation failed',\n    usageCoverage: report.usage.coverage,\n    possiblyBilledAttemptsWithoutUsage: report.usage.coverage.possiblyBilledAttemptsWithoutUsage })\n}\n"],"mappings":"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"}

package/dist/composition/agent/types.d.ts

@@ -1,4 +1,5 @@
 import { JsonValue } from "../../primitives/json.js";
+import { UsageCounters } from "../../observation/usage.js";
 import { Message } from "../../message/message.js";
 import { NativeToolSchema, ToolChoice } from "../../contract/tool.js";
 import { ModelOutputFormat } from "../../contract/output-format.js";
@@ -100,6 +101,36 @@ interface RuntimeAgentSessionOptions {
   readonly compaction?: AgentCompactionOptions | false;
 }
 interface RuntimeAgentInvocationOptions {
+  /**
+   * Model for THIS invocation only.
+   *
+   * The agent's bound target is unchanged — `agent.model` still reports it, and
+   * the next call without an override uses it again — so one session can put
+   * successive turns on different models without becoming a different agent.
+   * Resolved against the same configured routes as the binding, with the same
+   * failures (`MODEL_ROUTE_UNKNOWN`, `MODEL_DEFAULT_MISSING`), and resolved
+   * before the run acquires anything, so a bad target costs no I/O. Route-only
+   * (`{ provider }`) takes that route's configured default model.
+   *
+   * The target is frozen for the run it starts: every step of that turn reaches
+   * the same model. There is deliberately no fallback to another model when the
+   * chosen one fails — the failure is raised to the caller.
+   */
+  readonly model?: {
+    readonly provider: string;
+    readonly id?: string;
+  };
+  /**
+   * Reasoning effort for this invocation only.
+   *
+   * Alone it re-runs the agent's own model at a different effort. With `model`
+   * it applies to that model. Omitted alongside a `model` that differs from the
+   * binding, the agent's effort is NOT carried over: an effort belongs to the
+   * ladder of the model that offers it, and the route decides the default.
+   */
+  readonly effort?: string;
+  /** Output ceiling for this invocation only; dropped like `effort` on a model switch. */
+  readonly maxTokens?: number;
   /** One schema adapter supplies the provider schema and a synchronous runtime validator. */
   readonly structuredOutput?: {
     readonly name: string;
@@ -107,8 +138,12 @@ interface RuntimeAgentInvocationOptions {
   };
   /** strict rejects known text-only models when request history contains images; project permits lossy conversion. */
   readonly imagePolicy?: 'strict' | 'project';
+  /** strict rejects models that decline document input when history contains documents; project permits lossy conversion. */
+  readonly documentPolicy?: 'strict' | 'project';
   readonly signal?: AbortSignal;
   readonly additionalInstructions?: string;
+  /** Include raw span lifecycle events in the public stream for host tracing. */
+  readonly includeTraceEvents?: boolean;
   readonly onEvent?: (event: RuntimeAgentRunEvent) => void | Promise<void>;
 }
 interface RuntimeAgentRunEventContext {
@@ -122,7 +157,10 @@ type PublicContentEvent = AgentRunEvent extends (infer E) ? E extends {
 } ? Omit<E, 'trace'> & {
   readonly blockId?: string;
 } : never : never;
-type RuntimeAgentRunEvent = RuntimeAgentRunEventContext & (PublicContentEvent | {
+type PublicTraceEvent = Extract<AgentRunEvent, {
+  type: 'span-start' | 'span-end';
+}>;
+type RuntimeAgentRunEvent = RuntimeAgentRunEventContext & (PublicContentEvent | PublicTraceEvent | {
   readonly type: 'commentary-delta';
   readonly text: string;
   readonly index: number;
@@ -167,6 +205,10 @@ type RuntimeAgentRunEvent = RuntimeAgentRunEventContext & (PublicContentEvent |
   readonly type: 'usage';
   readonly usage: RuntimeRunReport['usage'];
   readonly report: RuntimeRunReport;
+} | {
+  readonly type: 'usage-progress';
+  readonly usage: UsageCounters;
+  readonly attemptId?: string;
 } | {
   readonly type: 'error';
   readonly error: RuntimeRunReport['errors'][number];

package/dist/composition/agent/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/composition/agent/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;UAyBiB;WACN;WACA;WACA;WACA,OAAO;WACP;WACA;WACA;WACA;WACA,iBAAiB;WACjB,uBAAuB;WACvB,aAAa;WACb,eAAe;WACf,uBAAuB;WACvB,kBAAkB;WAClB;WACA,SAAS;;;;;;;;WAQT,2BAA2B;WAC3B,aAAa;;WAEb;WACA;WACA;;UAGM,+BAA+B;UAE/B,iCAAiC,KAAK;WAC5C;aAAmB;aAA2B;;;UAGxC,2BAA2B;WACjC;WACA;;UAGM;WACN;WACA,iBAAiB;WACjB,uBAAuB;WACvB,kBAAkB;WAClB,SAAS;WACT;WACA,YAAY;WACZ,YAAY;;;;;;;WAOZ,aAAa;WACb,wBAAwB;;;;;;;WAOxB,2BAA2B;WAC3B,QAAQ;WACR,cAAc;;WAEd,gBAAgB;;WAEhB,eAAe;;WAEf,oBAAoB;WACpB,gBAAgB;WAChB,aAAa;;UAGP;;WAEN;aACE;aACA,QAA2D,cAAA;;;WAG7D;WACA,SAAS;WACT;WACA,WAAW,OAAO,gCAAgC;;UAG5C;WACN;WACA;WACA;WACA;;KAGN,qBAAqB,6BAA4B,KAClD;EAAY;IACV,KAAK;WAAyB;;KAGxB,uBAAuB,+BAC/B;WACW;WAAmC;WAAuB;WAAwB;WAA0B,OADvH;;WAEW;WAAkC;WAAuB;WAAwB;WAA0B,OAD6C;;WAExJ;WAA4B;WAAyB;WAAuB;;WAC5E;WAA8B;WAAyB;WACvD;WACA;;WACA;WAAwC;WAAyB;WACjE;WAAuB;WACvB,QAAQ;WAAoB,SAAS;;WACrC;WAAmC,SAAS;;WAC5C;WAAqC,SAAS;;WAC9C;WAAsC;WAA4B,UAAU;;WAC5E;WAAwB,OAAO;WAAoC,QAAQ;;WAC3E;WAAwB,OAAO;WAA6C,QAAQ;;UAGlF;;WAEN;;WAEA,YAJM;WAKN;WACA;WACA;WACA,SAAS;WACT,UAAU;WACV,OAAO;WACP,QAAQ;;UAGF,8BAA8B,cAAc;WAClD;;WAEA,QAAQ,QAAQ;WAChB,QAAQ,QAAQ;EACzB,MAAM;;UAGS,oCAAoC;WAC1C;;UAGM;WACN;WACA;EACT,IAAI,OAAO,YAAY,UAAU,gCAAgC,QAAQ;EACzE,OAAO,OAAO,YAAY,UAAU,gCAAgC;EACpE,OAAO,OAAO;EACd,YAAY;EACZ,QAAQ,UAAU,gCAAgC,QAAQ;EAC1D;EACA,SAAS,SAAS,cAAc;;UAGjB;WACN,OAAO;EAChB,SAAS,OAAO,YAAY,UAAU,gCAAgC,QAAQ;EAC9E,OAAO,OAAO,YAAY,UAAU,gCAAgC;EACpE,cAAc,UAAU,6BAA6B;EACrD,cAAc,UAAU,6BAA6B,UAAU,6BAA6B"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/composition/agent/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;UAyBiB;WACN;WACA;WACA;WACA,OAAO;WACP;WACA;WACA;WACA;WACA,iBAAiB;WACjB,uBAAuB;WACvB,aAAa;WACb,eAAe;WACf,uBAAuB;WACvB,kBAAkB;WAClB;WACA,SAAS;;;;;;;;WAQT,2BAA2B;WAC3B,aAAa;;WAEb;WACA;WACA;;UAGM,+BAA+B;UAE/B,iCAAiC,KAAK;WAC5C;aAAmB;aAA2B;;;UAGxC,2BAA2B;WACjC;WACA;;UAGM;WACN;WACA,iBAAiB;WACjB,uBAAuB;WACvB,kBAAkB;WAClB,SAAS;WACT;WACA,YAAY;WACZ,YAAY;;;;;;;WAOZ,aAAa;WACb,wBAAwB;;;;;;;WAOxB,2BAA2B;WAC3B,QAAQ;WACR,cAAc;;WAEd,gBAAgB;;WAEhB,eAAe;;WAEf,oBAAoB;WACpB,gBAAgB;WAChB,aAAa;;UAGP;;;;;;;;;;;;;;;;WAgBN;aAAmB;aAA2B;;;;;;;;;;WAS9C;;WAEA;;WAEA;aACE;aACA,QAA2D,cAAA;;;WAG7D;;WAEA;WACA,SAAS;WACT;;WAEA;WACA,WAAW,OAAO,gCAAgC;;UAG5C;WACN;WACA;WACA;WACA;;KAGN,qBAAqB,6BAA4B,KAClD;EAAY;IACV,KAAK;WAAyB;;KAG/B,mBAAmB,QAAQ;EAAiB;;KAErC,uBAAuB,+BAC/B,qBACA;WACW;WAAmC;WAAuB;WAAwB;WAA0B,OADvH;;WAEW;WAAkC;WAAuB;WAAwB;WAA0B,OAD6C;;WAExJ;WAA4B;WAAyB;WAAuB;;WAC5E;WAA8B;WAAyB;WACvD;WACA;;WACA;WAAwC;WAAyB;WACjE;WAAuB;WACvB,QAAQ;WAAoB,SAAS;;WACrC;WAAmC,SAAS;;WAC5C;WAAqC,SAAS;;WAC9C;WAAsC;WAA4B,UAAU;;WAC5E;WAAwB,OAAO;WAAoC,QAAQ;;WAC3E;WAAiC,OAD0C;WAC0B;;WACrG;WAAwB,OAAO;WAA6C,QAAQ;;UAGlF;;WAEN;;WAEA,YAJM;WAKN;WACA;WACA;WACA,SAAS;WACT,UAAU;WACV,OAAO;WACP,QAAQ;;UAGF,8BAA8B,cAAc;WAClD;;WAEA,QAAQ,QAAQ;WAChB,QAAQ,QAAQ;EACzB,MAAM;;UAGS,oCAAoC;WAC1C;;UAGM;WACN;WACA;EACT,IAAI,OAAO,YAAY,UAAU,gCAAgC,QAAQ;EACzE,OAAO,OAAO,YAAY,UAAU,gCAAgC;EACpE,OAAO,OAAO;EACd,YAAY;EACZ,QAAQ,UAAU,gCAAgC,QAAQ;EAC1D;EACA,SAAS,SAAS,cAAc;;UAGjB;WACN,OAAO;EAChB,SAAS,OAAO,YAAY,UAAU,gCAAgC,QAAQ;EAC9E,OAAO,OAAO,YAAY,UAAU,gCAAgC;EACpE,cAAc,UAAU,6BAA6B;EACrD,cAAc,UAAU,6BAA6B,UAAU,6BAA6B"}

package/dist/composition/common/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../../src/composition/common/errors.ts"],"mappings":";;UAoBiB;WACN;WACA;WACA;WACA;aAAmB;aAAuB;aAAwB"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../../src/composition/common/errors.ts"],"mappings":";;UAsBiB;WACN;WACA;WACA;WACA;aAAmB;aAAuB;aAAwB"}

package/dist/composition/common/errors.js

@@ -1,2 +1,2 @@
-var e=class extends Error{code=`RUNTIME_CONSTRUCTION_FAILED`;failureCode;stage;reason;component;conflict;cleanup;constructor(e){super(`Agent runtime construction did not complete`),this.name=`AgentRuntimeConstructionError`,this.failureCode=e.failureCode,this.stage=e.stage,this.reason=e.reason,e.component!==void 0&&(this.component=Object.freeze({...e.component})),e.conflict!==void 0&&(this.conflict=Object.freeze({...e.conflict})),this.cleanup=Object.freeze((e.cleanup??[]).map(e=>Object.freeze({...e,...e.error===void 0?{}:{error:Object.freeze({...e.error})}})))}};function t(t=`CAPABILITY_STARTUP_FAILED`,n){return new e({failureCode:t,stage:`preflight`,reason:`invalid`,...n===void 0?{}:{conflict:n}})}function n(t){if(t?.aborted)throw new e({failureCode:`CAPABILITY_STARTUP_ABORTED`,stage:`preflight`,reason:`aborted`})}export{e as AgentRuntimeConstructionError,n as checkPreflightAbort,t as invalidPreflight};
+var e=class extends Error{code=`RUNTIME_CONSTRUCTION_FAILED`;failureCode;stage;reason;component;conflict;cleanup;aggregate;constructor(e){super(`Agent runtime construction did not complete`),this.name=`AgentRuntimeConstructionError`,this.failureCode=e.failureCode,this.stage=e.stage,this.reason=e.reason,e.component!==void 0&&(this.component=Object.freeze({...e.component})),e.conflict!==void 0&&(this.conflict=Object.freeze({...e.conflict})),this.cleanup=Object.freeze((e.cleanup??[]).map(e=>Object.freeze({...e,...e.error===void 0?{}:{error:Object.freeze({...e.error})}}))),this.aggregate=Object.freeze((e.aggregate??[]).map(e=>Object.freeze({...e})))}};function t(t=`CAPABILITY_STARTUP_FAILED`,n){return new e({failureCode:t,stage:`preflight`,reason:`invalid`,...n===void 0?{}:{conflict:n}})}function n(t){if(t?.aborted)throw new e({failureCode:`CAPABILITY_STARTUP_ABORTED`,stage:`preflight`,reason:`aborted`})}export{e as AgentRuntimeConstructionError,n as checkPreflightAbort,t as invalidPreflight};
 //# sourceMappingURL=errors.js.map

package/dist/composition/common/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../../src/composition/common/errors.ts"],"sourcesContent":["export type RuntimeConstructionFailureReason = 'invalid' | 'failed' | 'timed-out' | 'aborted'\n\nexport type RuntimeConstructionFailureCode =\n  | 'CAPABILITY_KIND_MISMATCH'\n  | 'CAPABILITY_API_UNSUPPORTED'\n  | 'CAPABILITY_ID_CONFLICT'\n  | 'PROVIDER_ROUTE_CONFLICT'\n  | 'PROVIDER_SETUP_ASYNC_UNSUPPORTED'\n  | 'OBSERVATION_BOUNDARY_UNSUPPORTED'\n  | 'CAPABILITY_STARTUP_FAILED'\n  | 'CAPABILITY_STARTUP_TIMEOUT'\n  | 'CAPABILITY_STARTUP_ABORTED'\n\nimport type { CapabilityIdentityConflict } from '../../errors/capability-identity.ts'\nexport type { CapabilityIdentityConflict } from '../../errors/capability-identity.ts'\n\nexport type RuntimeConstructionComponent =\n  | { readonly kind: 'provider-plugin'; readonly id: string }\n  | { readonly kind: 'observation-exporter'; readonly id: string }\n\nexport interface RuntimeComponentCloseReport {\n  readonly kind: 'provider-registration' | 'observation-exporter' | 'agent-team'\n  readonly id: string\n  readonly status: 'closed' | 'failed' | 'timed-out'\n  readonly error?: { readonly code: string; readonly stage: string; readonly message: string }\n}\n\nexport interface ConstructionFailure {\n  readonly failureCode: RuntimeConstructionFailureCode\n  readonly stage: 'preflight' | 'provider-setup' | 'exporter-ready' | 'activation'\n  readonly reason: RuntimeConstructionFailureReason\n  readonly component?: RuntimeConstructionComponent\n  readonly conflict?: CapabilityIdentityConflict\n  readonly cleanup?: readonly RuntimeComponentCloseReport[]\n}\n\n/** Support-safe envelope: deliberately carries no raw input, exception or cause. */\nexport class AgentRuntimeConstructionError extends Error {\n  readonly code = 'RUNTIME_CONSTRUCTION_FAILED' as const\n  readonly failureCode: RuntimeConstructionFailureCode\n  readonly stage: ConstructionFailure['stage']\n  readonly reason: RuntimeConstructionFailureReason\n  readonly component?: RuntimeConstructionComponent\n  readonly conflict?: CapabilityIdentityConflict\n  readonly cleanup: readonly RuntimeComponentCloseReport[]\n\n  constructor(failure: ConstructionFailure) {\n    super('Agent runtime construction did not complete')\n    this.name = 'AgentRuntimeConstructionError'\n    this.failureCode = failure.failureCode\n    this.stage = failure.stage\n    this.reason = failure.reason\n    if (failure.component !== undefined) this.component = Object.freeze({ ...failure.component })\n    if (failure.conflict !== undefined) this.conflict = Object.freeze({ ...failure.conflict })\n    this.cleanup = Object.freeze((failure.cleanup ?? []).map(row => Object.freeze({\n      ...row,\n      ...(row.error === undefined ? {} : { error: Object.freeze({ ...row.error }) }),\n    })))\n  }\n}\n\nexport function invalidPreflight(\n  failureCode: RuntimeConstructionFailureCode = 'CAPABILITY_STARTUP_FAILED',\n  conflict?: CapabilityIdentityConflict,\n): AgentRuntimeConstructionError {\n  return new AgentRuntimeConstructionError({\n    failureCode, stage: 'preflight', reason: 'invalid',\n    ...(conflict === undefined ? {} : { conflict }),\n  })\n}\n\nexport function checkPreflightAbort(signal?: AbortSignal): void {\n  if (signal?.aborted) throw new AgentRuntimeConstructionError({\n    failureCode: 'CAPABILITY_STARTUP_ABORTED', stage: 'preflight', reason: 'aborted',\n  })\n}\n"],"mappings":"AAqCA,IAAa,EAAb,cAAmD,KAAM,CACvD,KAAgB,8BAChB,YACA,MACA,OACA,UACA,SACA,QAEA,YAAY,EAA8B,CACxC,MAAM,6CAA6C,EACnD,KAAK,KAAO,gCACZ,KAAK,YAAc,EAAQ,YAC3B,KAAK,MAAQ,EAAQ,MACrB,KAAK,OAAS,EAAQ,OAClB,EAAQ,YAAc,IAAA,KAAW,KAAK,UAAY,OAAO,OAAO,CAAE,GAAG,EAAQ,SAAU,CAAC,GACxF,EAAQ,WAAa,IAAA,KAAW,KAAK,SAAW,OAAO,OAAO,CAAE,GAAG,EAAQ,QAAS,CAAC,GACzF,KAAK,QAAU,OAAO,QAAQ,EAAQ,SAAW,CAAC,EAAA,CAAG,IAAI,GAAO,OAAO,OAAO,CAC5E,GAAG,EACH,GAAI,EAAI,QAAU,IAAA,GAAY,CAAC,EAAI,CAAE,MAAO,OAAO,OAAO,CAAE,GAAG,EAAI,KAAM,CAAC,CAAE,CAC9E,CAAC,CAAC,CAAC,CACL,CACF,EAEA,SAAgB,EACd,EAA8C,4BAC9C,EAC+B,CAC/B,OAAO,IAAI,EAA8B,CACvC,cAAa,MAAO,YAAa,OAAQ,UACzC,GAAI,IAAa,IAAA,GAAY,CAAC,EAAI,CAAE,UAAS,CAC/C,CAAC,CACH,CAEA,SAAgB,EAAoB,EAA4B,CAC9D,GAAI,GAAQ,QAAS,MAAM,IAAI,EAA8B,CAC3D,YAAa,6BAA8B,MAAO,YAAa,OAAQ,SACzE,CAAC,CACH"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../../src/composition/common/errors.ts"],"sourcesContent":["export type RuntimeConstructionFailureReason = 'invalid' | 'failed' | 'timed-out' | 'aborted'\n\nexport type RuntimeConstructionFailureCode =\n  | 'CAPABILITY_KIND_MISMATCH'\n  | 'CAPABILITY_API_UNSUPPORTED'\n  | 'CAPABILITY_ID_CONFLICT'\n  | 'PROVIDER_ROUTE_CONFLICT'\n  /** Two plugins of the SAME operation claim one route (Requirement 11.6). */\n  | 'PROVIDER_OPERATION_CONFLICT'\n  | 'PROVIDER_SETUP_ASYNC_UNSUPPORTED'\n  | 'OBSERVATION_BOUNDARY_UNSUPPORTED'\n  | 'CAPABILITY_STARTUP_FAILED'\n  | 'CAPABILITY_STARTUP_TIMEOUT'\n  | 'CAPABILITY_STARTUP_ABORTED'\n\nimport type { CapabilityIdentityConflict } from '../../errors/capability-identity.ts'\nexport type { CapabilityIdentityConflict } from '../../errors/capability-identity.ts'\n\nexport type RuntimeConstructionComponent =\n  | { readonly kind: 'provider-plugin'; readonly id: string }\n  | { readonly kind: 'observation-exporter'; readonly id: string }\n\nexport interface RuntimeComponentCloseReport {\n  readonly kind: 'provider-registration' | 'observation-exporter' | 'agent-team'\n  readonly id: string\n  readonly status: 'closed' | 'failed' | 'timed-out'\n  readonly error?: { readonly code: string; readonly stage: string; readonly message: string }\n}\n\n/**\n * One entry of a whole-input failure sweep.\n *\n * Declared here rather than beside the preflight that produces it so\n * {@link ConstructionFailure} can carry it without importing a composition\n * phase. `ProviderPreflightFailure` narrows `code` to the subset a provider\n * sweep can produce.\n */\nexport interface RuntimeConstructionAggregateEntry {\n  /** Position in the caller's input list. */\n  readonly index: number\n  readonly code: RuntimeConstructionFailureCode\n  /** Present only when the id was readable as inert, bounded data. */\n  readonly pluginId?: string\n  /** The earlier index this entry collides with, for conflict codes. */\n  readonly conflictsWithIndex?: number\n}\n\nexport interface ConstructionFailure {\n  readonly failureCode: RuntimeConstructionFailureCode\n  readonly stage: 'preflight' | 'provider-setup' | 'exporter-ready' | 'activation'\n  readonly reason: RuntimeConstructionFailureReason\n  readonly component?: RuntimeConstructionComponent\n  readonly conflict?: CapabilityIdentityConflict\n  readonly cleanup?: readonly RuntimeComponentCloseReport[]\n  /**\n   * Every failure the sweep found, not just the reported one.\n   *\n   * `failureCode` stays the FIRST failure's code so existing assertions keep\n   * their meaning; this list is purely additive (DD-3).\n   */\n  readonly aggregate?: readonly RuntimeConstructionAggregateEntry[]\n}\n\n/** Support-safe envelope: deliberately carries no raw input, exception or cause. */\nexport class AgentRuntimeConstructionError extends Error {\n  readonly code = 'RUNTIME_CONSTRUCTION_FAILED' as const\n  readonly failureCode: RuntimeConstructionFailureCode\n  readonly stage: ConstructionFailure['stage']\n  readonly reason: RuntimeConstructionFailureReason\n  readonly component?: RuntimeConstructionComponent\n  readonly conflict?: CapabilityIdentityConflict\n  readonly cleanup: readonly RuntimeComponentCloseReport[]\n  /** Empty unless the failure came from a whole-input sweep. */\n  readonly aggregate: readonly RuntimeConstructionAggregateEntry[]\n\n  constructor(failure: ConstructionFailure) {\n    super('Agent runtime construction did not complete')\n    this.name = 'AgentRuntimeConstructionError'\n    this.failureCode = failure.failureCode\n    this.stage = failure.stage\n    this.reason = failure.reason\n    if (failure.component !== undefined) this.component = Object.freeze({ ...failure.component })\n    if (failure.conflict !== undefined) this.conflict = Object.freeze({ ...failure.conflict })\n    this.cleanup = Object.freeze((failure.cleanup ?? []).map(row => Object.freeze({\n      ...row,\n      ...(row.error === undefined ? {} : { error: Object.freeze({ ...row.error }) }),\n    })))\n    this.aggregate = Object.freeze((failure.aggregate ?? []).map(entry => Object.freeze({ ...entry })))\n  }\n}\n\nexport function invalidPreflight(\n  failureCode: RuntimeConstructionFailureCode = 'CAPABILITY_STARTUP_FAILED',\n  conflict?: CapabilityIdentityConflict,\n): AgentRuntimeConstructionError {\n  return new AgentRuntimeConstructionError({\n    failureCode, stage: 'preflight', reason: 'invalid',\n    ...(conflict === undefined ? {} : { conflict }),\n  })\n}\n\nexport function checkPreflightAbort(signal?: AbortSignal): void {\n  if (signal?.aborted) throw new AgentRuntimeConstructionError({\n    failureCode: 'CAPABILITY_STARTUP_ABORTED', stage: 'preflight', reason: 'aborted',\n  })\n}\n"],"mappings":"AAgEA,IAAa,EAAb,cAAmD,KAAM,CACvD,KAAgB,8BAChB,YACA,MACA,OACA,UACA,SACA,QAEA,UAEA,YAAY,EAA8B,CACxC,MAAM,6CAA6C,EACnD,KAAK,KAAO,gCACZ,KAAK,YAAc,EAAQ,YAC3B,KAAK,MAAQ,EAAQ,MACrB,KAAK,OAAS,EAAQ,OAClB,EAAQ,YAAc,IAAA,KAAW,KAAK,UAAY,OAAO,OAAO,CAAE,GAAG,EAAQ,SAAU,CAAC,GACxF,EAAQ,WAAa,IAAA,KAAW,KAAK,SAAW,OAAO,OAAO,CAAE,GAAG,EAAQ,QAAS,CAAC,GACzF,KAAK,QAAU,OAAO,QAAQ,EAAQ,SAAW,CAAC,EAAA,CAAG,IAAI,GAAO,OAAO,OAAO,CAC5E,GAAG,EACH,GAAI,EAAI,QAAU,IAAA,GAAY,CAAC,EAAI,CAAE,MAAO,OAAO,OAAO,CAAE,GAAG,EAAI,KAAM,CAAC,CAAE,CAC9E,CAAC,CAAC,CAAC,EACH,KAAK,UAAY,OAAO,QAAQ,EAAQ,WAAa,CAAC,EAAA,CAAG,IAAI,GAAS,OAAO,OAAO,CAAE,GAAG,CAAM,CAAC,CAAC,CAAC,CACpG,CACF,EAEA,SAAgB,EACd,EAA8C,4BAC9C,EAC+B,CAC/B,OAAO,IAAI,EAA8B,CACvC,cAAa,MAAO,YAAa,OAAQ,UACzC,GAAI,IAAa,IAAA,GAAY,CAAC,EAAI,CAAE,UAAS,CAC/C,CAAC,CACH,CAEA,SAAgB,EAAoB,EAA4B,CAC9D,GAAI,GAAQ,QAAS,MAAM,IAAI,EAA8B,CAC3D,YAAa,6BAA8B,MAAO,YAAa,OAAQ,SACzE,CAAC,CACH"}

package/dist/composition/embedding/activation.js

@@ -0,0 +1,2 @@
+import{arrayData as e,boundedText as t}from"../../capability/common/data.js";import{beginCoreCapabilityOperation as n}from"../../platform/capability-operation.js";import{COMPOSITION_LIMITS as r}from"../../capability/common/config.js";import{AgentRuntimeConstructionError as i,checkPreflightAbort as a}from"../common/errors.js";import{activateProviders as o,asynchronous as s,closeRow as c,providerClaimError as l,providerLifecycleError as u}from"../provider/activation.js";function d(o,d,f,p,m,h){a(p);let g=h?.installed??[],_=g.length;for(let[h,v]of d.entries()){let d=n(f.child({providerIndex:_+h}),`core-provider`,`setup`),y=`setup`,b=`CAPABILITY_STARTUP_FAILED`,x,S,C=!1,w=!1,T,E,D=[],O=`provider-${_+h}`,k=()=>{for(let e of[...D].reverse())if(e.active){e.active=!1;try{e.handle()}catch{}}},A=()=>{if(C)return x??c(O);w||(E??=p?.aborted===!0),C=!0,y=`cleanup`;let e;try{w||(T??=m?.rollback());let t=T!==void 0&&T.now()>=T.at;t&&(e=`CAPABILITY_CLEANUP_TIMEOUT`),k(),S!==void 0&&!t&&s(S())&&(e=`PROVIDER_CLEANUP_ASYNC_UNSUPPORTED`)}catch{e=`CAPABILITY_CLEANUP_FAILED`}finally{y=`closed`}let t=c(O,e);return x=t,t};try{if(a(p),m!==void 0&&m.startup.now()>=m.startup.at)throw b=`CAPABILITY_STARTUP_TIMEOUT`,Error(`Provider startup deadline exhausted`);let n=()=>{if(y!==`setup`)throw u();a(p)},i=()=>{if(y!==`setup`&&y!==`cleanup`&&y!==`closed`)throw u()},c=i=>{n();let a=e(i,r.routesPerProvider).map(e=>t(e,r.identityBytes));if(a.length===0||new Set(a).size!==a.length)throw l();for(let e of a)if(!v.routes.includes(e))throw l();return Object.freeze(a)},h=Object.freeze({logger:f,registerEmbeddingAdapter(e,t,n){let r=c(e),a=o.registerEmbeddingAdapter(r,t,n),s={active:!0,routes:r,handle:a};D.push(s);let l=(()=>{i(),s.active&&=(a(),!1)});return l.replace=e=>{if(!s.active)throw u();let t=c(e);a.replace(t),s.routes=t},Object.freeze(l)}});try{let e=v.setup(h);if(y=`sealed`,S=typeof e==`function`?e:void 0,s(e))throw b=`PROVIDER_SETUP_ASYNC_UNSUPPORTED`,Error(`Asynchronous provider setup is unsupported`);if(e!==void 0&&typeof e!=`function`)throw Error(`Invalid provider setup result`);a(p);let t=new Set(D.filter(e=>e.active).flatMap(e=>e.routes));if(v.routes.some(e=>!t.has(e)))throw l()}catch(e){throw p?.aborted===!0?d.abort():d.fail(e),E=p?.aborted===!0,y=`sealed`,(S!==void 0||D.some(e=>e.active))&&(x=A()),e}finally{y===`setup`&&(y=`sealed`)}d.success(),w=!0;let _;g.push(Object.freeze({id:v.id,close(e){return _===void 0?(T=e,_=A(),_):_}})),a(p)}catch(e){let t=E??p?.aborted===!0;t?d.abort():d.fail(e);let n=[];x!==void 0&&n.push(x);let r=m?.rollback();for(let e of[...g].reverse())n.push(e.close(r));throw new i({failureCode:t?`CAPABILITY_STARTUP_ABORTED`:b,stage:`provider-setup`,reason:t?`aborted`:b===`CAPABILITY_STARTUP_TIMEOUT`?`timed-out`:`failed`,component:{kind:`provider-plugin`,id:O},cleanup:n})}}return Object.freeze([...g])}function f(e){let t={installed:[]};return o(e.registry,e.providers,e.logger,e.signal,e.deadlines,t),d(e.embeddingRegistry,e.embeddingProviders,e.logger,e.signal,e.deadlines,t)}export{d as activateEmbeddingProviders,f as activateRuntimeProviders};
+//# sourceMappingURL=activation.js.map

package/dist/composition/embedding/activation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.js","names":[],"sources":["../../../src/composition/embedding/activation.ts"],"sourcesContent":["/**\n * Activation for the embedding plugin kind, sharing ONE rollback list with generation.\n *\n * The shape mirrors `activateProviders` on purpose — same phase machine, same\n * cleanup accounting, same `provider-N` report ids — because the two kinds must be\n * indistinguishable from the outside once startup either succeeded or unwound\n * (Requirement 11.7). What differs is only where a registration lands:\n * `EmbeddingRegistry` is itself the registrar, so there is no `install()`\n * transaction to borrow and this module releases the route handles it took.\n *\n * Rollback is not atomic per route — two kinds are two plugin objects and two\n * `setup()` calls. Two other layers make that safe: the whole-input preflight\n * rejects every route–operation conflict BEFORE any plugin is committed, and the\n * `installed[]` list swept here spans both kinds, so a failing embedding plugin\n * releases the generation registrations that went in before it.\n *\n * Both edge configurations are first-class, not special cases: a `providers` list\n * of only generation plugins never constructs an embedding registration\n * (Requirement 11.8), and a list of only embedding plugins activates, serves and\n * closes with an empty generation registry (Requirement 11.9).\n *\n * @module ai-agent-sdk/core/composition/embedding/activation\n */\n\nimport type { SdkLogger } from '../../logging/types.ts'\nimport type { AdapterRegistrationHandle } from '../../plugin/provider-plugin.ts'\nimport type { ModelRegistry } from '../../runtime/registry.ts'\nimport type { EmbeddingAdapter } from '../../embedding/adapter.ts'\nimport { COMPOSITION_LIMITS } from '../common/config.ts'\nimport { arrayData, boundedText } from '../common/data.ts'\nimport { AgentRuntimeConstructionError, checkPreflightAbort } from '../common/errors.ts'\nimport type { RuntimeComponentCloseReport, RuntimeConstructionFailureCode } from '../common/errors.ts'\nimport { beginCoreCapabilityOperation } from '../logging/capability.ts'\nimport {\n  activateProviders, asynchronous, closeRow, providerClaimError, providerLifecycleError,\n  type CleanupCode, type ProviderActivationDeadlines, type ProviderCleanupDeadline,\n  type ProviderRegistration, type SharedProviderActivation,\n} from '../provider/activation.ts'\nimport type { CapturedProvider } from '../provider/types.ts'\nimport type { CapturedEmbeddingProvider } from './preflight.ts'\nimport type { EmbeddingProviderRegistrar } from './plugin-types.ts'\nimport { EmbeddingRegistry } from './registry.ts'\n\n/** What an embedding plugin's `setup()` receives, logger included. */\nexport interface RuntimeEmbeddingProviderRegistrar extends EmbeddingProviderRegistrar {\n  readonly logger: SdkLogger\n}\n\ninterface RouteRegistration {\n  active: boolean\n  routes: readonly string[]\n  readonly handle: AdapterRegistrationHandle\n}\n\n/**\n * Activate already-captured embedding plugins against one runtime registry.\n *\n * @param registry - the runtime's embedding registry, never the `ModelRegistry`.\n * @param providers - plugins whose `setup` was captured by the preflight.\n * @param shared - the cross-kind rollback list; omit for a private one.\n * @returns every registration in the shared list, this activation's included.\n * @throws AgentRuntimeConstructionError after rolling back the WHOLE shared list.\n */\nexport function activateEmbeddingProviders(\n  registry: EmbeddingRegistry,\n  providers: readonly CapturedEmbeddingProvider[],\n  logger: SdkLogger,\n  signal?: AbortSignal,\n  deadlines?: ProviderActivationDeadlines,\n  shared?: SharedProviderActivation,\n): readonly ProviderRegistration[] {\n  checkPreflightAbort(signal)\n  const installed: ProviderRegistration[] = shared?.installed ?? []\n  const idOffset = installed.length\n  for (const [index, provider] of providers.entries()) {\n    const setupOperation = beginCoreCapabilityOperation(\n      logger.child({ providerIndex: idOffset + index }), 'core-provider', 'setup',\n    )\n    let phase: 'setup' | 'sealed' | 'cleanup' | 'closed' = 'setup'\n    let failureCode: RuntimeConstructionFailureCode = 'CAPABILITY_STARTUP_FAILED'\n    let failureCleanup: RuntimeComponentCloseReport | undefined\n    let cleanup: (() => void) | undefined\n    let cleaned = false\n    let committed = false\n    let cleanupDeadline: ProviderCleanupDeadline | undefined\n    let failureWasAbort: boolean | undefined\n    const registrations: RouteRegistration[] = []\n    // Support reports do not echo an arbitrary user-supplied identity.\n    const reportId = `provider-${idOffset + index}`\n    /** Topology leaves the registry BEFORE user cleanup runs, as it does for generation. */\n    const release = (): void => {\n      for (const row of [...registrations].reverse()) {\n        if (!row.active) continue\n        row.active = false\n        try { row.handle() } catch { /* a broken disposer must not strand the others */ }\n      }\n    }\n    const finishCleanup = (): RuntimeComponentCloseReport => {\n      if (cleaned) return failureCleanup ?? closeRow(reportId)\n      if (!committed) failureWasAbort ??= signal?.aborted === true\n      cleaned = true\n      phase = 'cleanup'\n      let code: CleanupCode | undefined\n      try {\n        if (!committed) cleanupDeadline ??= deadlines?.rollback()\n        const expired = cleanupDeadline !== undefined && cleanupDeadline.now() >= cleanupDeadline.at\n        // An expired budget still removes topology; only the plugin's own\n        // disposer is skipped, matching the generation contract exactly.\n        if (expired) code = 'CAPABILITY_CLEANUP_TIMEOUT'\n        release()\n        if (cleanup !== undefined && !expired && asynchronous(cleanup())) {\n          code = 'PROVIDER_CLEANUP_ASYNC_UNSUPPORTED'\n        }\n      } catch { code = 'CAPABILITY_CLEANUP_FAILED' }\n      finally { phase = 'closed' }\n      const row = closeRow(reportId, code)\n      failureCleanup = row\n      return row\n    }\n    try {\n      checkPreflightAbort(signal)\n      if (deadlines !== undefined && deadlines.startup.now() >= deadlines.startup.at) {\n        failureCode = 'CAPABILITY_STARTUP_TIMEOUT'\n        throw new Error('Provider startup deadline exhausted')\n      }\n      const setupOnly = (): void => {\n        if (phase !== 'setup') throw providerLifecycleError()\n        checkPreflightAbort(signal)\n      }\n      const disposeOnly = (): void => {\n        if (phase !== 'setup' && phase !== 'cleanup' && phase !== 'closed') throw providerLifecycleError()\n      }\n      /**\n       * Route claims are checked here, not in the registry: the registry owns\n       * cross-plugin vacancy, this owns \"inside what this plugin predeclared\".\n       */\n      const routesFor = (input: unknown): readonly string[] => {\n        setupOnly()\n        const routes = arrayData(input, COMPOSITION_LIMITS.routesPerProvider)\n          .map(route => boundedText(route, COMPOSITION_LIMITS.identityBytes))\n        if (routes.length === 0 || new Set(routes).size !== routes.length) throw providerClaimError()\n        for (const route of routes) if (!provider.routes.includes(route)) throw providerClaimError()\n        return Object.freeze(routes)\n      }\n      const registrar: RuntimeEmbeddingProviderRegistrar = Object.freeze({\n        logger,\n        registerEmbeddingAdapter(\n          input: readonly string[], adapter: EmbeddingAdapter, models?: readonly string[],\n        ) {\n          const routes = routesFor(input)\n          // Model-scoped and route-wide claims coexist by design, so same-route\n          // duplication is the registry's call, not this layer's.\n          const handle = registry.registerEmbeddingAdapter(routes, adapter, models)\n          const row: RouteRegistration = { active: true, routes, handle }\n          registrations.push(row)\n          const dispose = (() => {\n            disposeOnly()\n            if (!row.active) return\n            handle()\n            row.active = false\n          }) as AdapterRegistrationHandle\n          dispose.replace = next => {\n            if (!row.active) throw providerLifecycleError()\n            const replacement = routesFor(next)\n            handle.replace(replacement)\n            row.routes = replacement\n          }\n          return Object.freeze(dispose)\n        },\n      })\n      try {\n        const result = provider.setup(registrar)\n        phase = 'sealed'\n        cleanup = typeof result === 'function' ? result : undefined\n        if (asynchronous(result)) {\n          failureCode = 'PROVIDER_SETUP_ASYNC_UNSUPPORTED'\n          throw new Error('Asynchronous provider setup is unsupported')\n        }\n        if (result !== undefined && typeof result !== 'function') throw new Error('Invalid provider setup result')\n        checkPreflightAbort(signal)\n        const claimed = new Set(registrations.filter(row => row.active).flatMap(row => row.routes))\n        if (provider.routes.some(route => !claimed.has(route))) throw providerClaimError()\n      } catch (error) {\n        if (signal?.aborted === true) setupOperation.abort(); else setupOperation.fail(error)\n        failureWasAbort = signal?.aborted === true\n        phase = 'sealed'\n        // Nothing else will release what this setup already put into the\n        // registry: it never became a registration in `installed`.\n        if (cleanup !== undefined || registrations.some(row => row.active)) failureCleanup = finishCleanup()\n        throw error\n      } finally {\n        if (phase === 'setup') phase = 'sealed'\n      }\n      setupOperation.success()\n      committed = true\n      let report: RuntimeComponentCloseReport | undefined\n      installed.push(Object.freeze({\n        id: provider.id,\n        close(deadline?: ProviderCleanupDeadline) {\n          if (report !== undefined) return report\n          cleanupDeadline = deadline\n          report = finishCleanup()\n          return report\n        },\n      }))\n      checkPreflightAbort(signal)\n    } catch (error: unknown) {\n      const aborted = failureWasAbort ?? signal?.aborted === true\n      if (aborted) setupOperation.abort(); else setupOperation.fail(error)\n      const cleanupRows: RuntimeComponentCloseReport[] = []\n      if (failureCleanup !== undefined) cleanupRows.push(failureCleanup)\n      const deadline = deadlines?.rollback()\n      for (const registration of [...installed].reverse()) cleanupRows.push(registration.close(deadline))\n      throw new AgentRuntimeConstructionError({\n        failureCode: aborted ? 'CAPABILITY_STARTUP_ABORTED' : failureCode,\n        stage: 'provider-setup',\n        reason: aborted ? 'aborted' : failureCode === 'CAPABILITY_STARTUP_TIMEOUT' ? 'timed-out' : 'failed',\n        component: { kind: 'provider-plugin', id: reportId }, cleanup: cleanupRows,\n      })\n    }\n  }\n  return Object.freeze([...installed])\n}\n\n/** Both halves of one validated `providers` list, ready to activate. */\nexport interface RuntimeProviderActivationInput {\n  readonly registry: ModelRegistry\n  readonly embeddingRegistry: EmbeddingRegistry\n  readonly providers: readonly CapturedProvider[]\n  readonly embeddingProviders: readonly CapturedEmbeddingProvider[]\n  readonly logger: SdkLogger\n  readonly signal?: AbortSignal\n  readonly deadlines?: ProviderActivationDeadlines\n}\n\n/**\n * Activate generation first, then embedding, over ONE rollback list.\n *\n * Order matters only for reporting: whichever step fails, the failure unwinds the\n * complete list, so the runtime either owns every registration or none.\n *\n * @returns the combined registration list, in installation order.\n */\nexport function activateRuntimeProviders(\n  input: RuntimeProviderActivationInput,\n): readonly ProviderRegistration[] {\n  const shared: SharedProviderActivation = { installed: [] }\n  activateProviders(input.registry, input.providers, input.logger, input.signal, input.deadlines, shared)\n  return activateEmbeddingProviders(input.embeddingRegistry, input.embeddingProviders,\n    input.logger, input.signal, input.deadlines, shared)\n}\n"],"mappings":"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"}

package/dist/composition/embedding/cache.js

@@ -0,0 +1,2 @@
+import{EMBEDDING_ERROR_CODES as e,EmbeddingError as t}from"../../embedding/errors.js";function n(e){return e.replace(/\\/g,`\\\\`).replace(/\|/g,`\\|`)}async function r(e){let t=await crypto.subtle.digest(`SHA-256`,new TextEncoder().encode(e)),n=``;for(let e of new Uint8Array(t))n+=e.toString(16).padStart(2,`0`);return n}function i(n){if(n!==void 0){if(typeof n.scope!=`string`||n.scope.length===0)throw new t("Embedding cache requires a non-empty `scope`; there is no default security scope",e.CONFIGURATION_INVALID);if(n.store===null||typeof n.store!=`object`||typeof n.store.get!=`function`||typeof n.store.set!=`function`)throw new t("Embedding cache requires a `store` exposing `get` and `set`",e.CONFIGURATION_INVALID);return n}}async function a(e){let{profile:t}=e,i=e.purpose===`retrieval-query`?t.queryRecipeRevision:t.documentRecipeRevision,a=t.postProcessing===void 0?`none`:`${t.postProcessing.kind}:${t.postProcessing.revision}`,o=await r(e.contentParts.map(e=>`${e.type}:${n(e.text)}`).join(`|`));return r([`embcache:1`,e.scope,`${t.modelIdentity}#${t.modelRevision??`none`}#${t.profileRevision}`,`${e.purpose}#${i}`,`${String(t.dimensions)}#${a}`,o].map(n).join(`|`))}async function o(e,t,n,r){try{let i=await e.store.get(t);if(typeof i!=`object`||!i||i.space!==n)return;let a=i.values;if(!Array.isArray(a)||a.length===0||r!==void 0&&r>0&&a.length!==r)return;let o=[];for(let e of a){if(typeof e!=`number`||!Number.isFinite(e))return;o.push(e)}return Object.freeze({space:n,values:Object.freeze(o)})}catch{return}}async function s(e,t,n){try{await e.store.set(t,Object.freeze({space:n.space,values:Object.freeze([...n.values])}))}catch{}}export{a as embeddingCacheKey,o as readEmbeddingCacheEntry,i as resolveEmbeddingCache,s as writeEmbeddingCacheEntry};
+//# sourceMappingURL=cache.js.map

package/dist/composition/embedding/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","names":[],"sources":["../../../src/composition/embedding/cache.ts"],"sourcesContent":["/**\n * The optional `Embedding_Cache`: key derivation plus the two gates a read must\n * pass before its vector is reused.\n *\n * DISABLED BY DEFAULT (Requirement 5.1). Nothing here runs unless the caller\n * supplies `EmbeddingModelOptions.cache`, which is what keeps `crypto.subtle`\n * off every mandatory code path of `packages/core` (DD-11).\n *\n * `EmbeddingCacheOptions`, `EmbeddingCacheStore` and `EmbeddingCacheEntry` are\n * declared in `embedding/handle.ts` because `EmbeddingModelOptions.cache` needs\n * them and `embedding/` may not import `composition/` (DD-8). This module\n * CONSUMES those types and redeclares none of them; the only new type here is\n * {@link EmbeddingCacheKeyInput}, which is an input of this module alone.\n *\n * @module ai-agent-sdk/core/composition/embedding/cache\n */\n\nimport { EMBEDDING_ERROR_CODES, EmbeddingError } from '../../embedding/errors.ts'\nimport type {\n  EmbeddingCacheEntry,\n  EmbeddingCacheOptions,\n} from '../../embedding/handle.ts'\nimport type { EmbeddingProfile, EmbeddingSpaceId } from '../../embedding/profile.ts'\nimport type { EmbeddingPurpose } from '../../embedding/purpose.ts'\nimport type { EmbeddingContentPart } from '../../embedding/request.ts'\n\n/** Version prefix of the canonical pre-image, so key format changes never collide. */\nconst CACHE_KEY_VERSION = 'embcache:1'\n\n/** Everything a cache key depends on, for exactly one item of one call. */\nexport interface EmbeddingCacheKeyInput {\n  /** REQUIRED security scope from {@link EmbeddingCacheOptions.scope}. */\n  readonly scope: string\n  /** Resolved profile of the `Prepared_Embedding_Call`. */\n  readonly profile: EmbeddingProfile\n  /** Purpose of this call; it selects which recipe revision enters the key. */\n  readonly purpose: EmbeddingPurpose\n  /**\n   * The EFFECTIVE input, i.e. the content parts as the adapter normalized them.\n   * Hashing anything earlier would key on text the provider never saw.\n   */\n  readonly contentParts: readonly EmbeddingContentPart[]\n}\n\n/** Escapes `|` and `\\` so two distinct component tuples cannot join to one string. */\nfunction escapeComponent(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/\\|/g, '\\\\|')\n}\n\n/** Lowercase hex of a SHA-256 digest over the UTF-8 bytes of `value`. */\nasync function sha256Hex(value: string): Promise<string> {\n  const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(value))\n  let hex = ''\n  for (const byte of new Uint8Array(digest)) {\n    hex += byte.toString(16).padStart(2, '0')\n  }\n  return hex\n}\n\n/**\n * Validates the cache configuration and reports whether the cache is on.\n *\n * `scope` is REQUIRED with no default: there is no safe default answer to \"may\n * two tenants share a cache entry\", so a missing or empty scope is\n * `EMBEDDING_CONFIGURATION_INVALID` rather than something the runtime fills in\n * (DD-8, Requirement 5.2). Absent options mean the cache is simply off, which is\n * not an error (Requirement 5.1).\n *\n * @throws {EmbeddingError} `EMBEDDING_CONFIGURATION_INVALID` when a cache is\n * supplied without a usable `store` or without a non-empty `scope`.\n */\nexport function resolveEmbeddingCache(\n  options: EmbeddingCacheOptions | undefined,\n): EmbeddingCacheOptions | undefined {\n  if (options === undefined) return undefined\n\n  if (typeof options.scope !== 'string' || options.scope.length === 0) {\n    throw new EmbeddingError(\n      'Embedding cache requires a non-empty `scope`; there is no default security scope',\n      EMBEDDING_ERROR_CODES.CONFIGURATION_INVALID,\n    )\n  }\n  if (\n    options.store === null\n    || typeof options.store !== 'object'\n    || typeof options.store.get !== 'function'\n    || typeof options.store.set !== 'function'\n  ) {\n    throw new EmbeddingError(\n      'Embedding cache requires a `store` exposing `get` and `set`',\n      EMBEDDING_ERROR_CODES.CONFIGURATION_INVALID,\n    )\n  }\n  return options\n}\n\n/**\n * Derives the cache key of one input from the five components of Requirement 5.2:\n *\n * 1. security scope,\n * 2. model identity + model revision + profile revision,\n * 3. purpose + the recipe revision that purpose selects,\n * 4. dimensions + post-processing (kind and revision),\n * 5. the digest of the effective input content.\n *\n * ASYNC on purpose, and the ONLY digest in this design. A cache key must\n * compress an unbounded amount of input content into a fixed-length string, so a\n * hash is required. `deriveSpaceId` is the opposite case: it joins a finite set\n * of short metadata fields, so it stays synchronous and unhashed (DD-11).\n *\n * Changing any one of the five components yields a different key; keeping all\n * five yields an equal key.\n */\nexport async function embeddingCacheKey(input: EmbeddingCacheKeyInput): Promise<string> {\n  const { profile } = input\n  const recipeRevision =\n    input.purpose === 'retrieval-query'\n      ? profile.queryRecipeRevision\n      : profile.documentRecipeRevision\n  const postProcessing =\n    profile.postProcessing === undefined\n      ? 'none'\n      : `${profile.postProcessing.kind}:${profile.postProcessing.revision}`\n\n  // The effective input is hashed FIRST and separately: it is the only unbounded\n  // component, and pre-hashing it keeps the outer pre-image a fixed size.\n  const contentDigest = await sha256Hex(\n    input.contentParts.map(part => `${part.type}:${escapeComponent(part.text)}`).join('|'),\n  )\n\n  const components = [\n    CACHE_KEY_VERSION,\n    input.scope,\n    `${profile.modelIdentity}#${profile.modelRevision ?? 'none'}#${profile.profileRevision}`,\n    `${input.purpose}#${recipeRevision}`,\n    `${String(profile.dimensions)}#${postProcessing}`,\n    contentDigest,\n  ]\n\n  return sha256Hex(components.map(escapeComponent).join('|'))\n}\n\n/**\n * Reads one entry and applies the SECOND gate: an entry whose `Space_Id` differs\n * from the prepared call's `Space_Id` is ignored, so the item falls through to a\n * new `Physical_Batch` (Requirement 5.3).\n *\n * This defends against a key collision caused by a configuration change that was\n * never reflected in `profileRevision`. A store fault is also treated as a miss:\n * a cache is an optimisation and must not be able to fail a call.\n */\nexport async function readEmbeddingCacheEntry(\n  cache: EmbeddingCacheOptions,\n  key: string,\n  space: EmbeddingSpaceId,\n  dimensions?: number,\n): Promise<EmbeddingCacheEntry | undefined> {\n  try {\n    const entry = await cache.store.get(key)\n    if (entry === null || typeof entry !== 'object' || entry.space !== space) return undefined\n    const values = entry.values\n    if (!Array.isArray(values) || values.length === 0\n      || (dimensions !== undefined && dimensions > 0 && values.length !== dimensions)) return undefined\n    const snapshot: number[] = []\n    for (const value of values) {\n      if (typeof value !== 'number' || !Number.isFinite(value)) return undefined\n      snapshot.push(value)\n    }\n    return Object.freeze({ space, values: Object.freeze(snapshot) })\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * Writes one vector together with the space it was produced in, so the second\n * gate has something to check on the way back out.\n *\n * A store fault is swallowed for the same reason as on read: a cache write must\n * not turn a successful embedding call into a failure.\n */\nexport async function writeEmbeddingCacheEntry(\n  cache: EmbeddingCacheOptions,\n  key: string,\n  entry: EmbeddingCacheEntry,\n): Promise<void> {\n  try {\n    await cache.store.set(key, Object.freeze({ space: entry.space, values: Object.freeze([...entry.values]) }))\n  } catch {\n    // Intentionally ignored: the vector is already computed and returned.\n  }\n}\n"],"mappings":"sFA6CA,SAAS,EAAgB,EAAuB,CAC9C,OAAO,EAAM,QAAQ,MAAO,MAAM,CAAC,CAAC,QAAQ,MAAO,KAAK,CAC1D,CAGA,eAAe,EAAU,EAAgC,CACvD,IAAM,EAAS,MAAM,OAAO,OAAO,OAAO,UAAW,IAAI,YAAY,CAAC,CAAC,OAAO,CAAK,CAAC,EAChF,EAAM,GACV,IAAK,IAAM,KAAQ,IAAI,WAAW,CAAM,EACtC,GAAO,EAAK,SAAS,EAAE,CAAC,CAAC,SAAS,EAAG,GAAG,EAE1C,OAAO,CACT,CAcA,SAAgB,EACd,EACmC,CAC/B,OAAY,IAAA,GAEhB,IAAI,OAAO,EAAQ,OAAU,UAAY,EAAQ,MAAM,SAAW,EAChE,MAAM,IAAI,EACR,mFACA,EAAsB,qBACxB,EAEF,GACE,EAAQ,QAAU,MACf,OAAO,EAAQ,OAAU,UACzB,OAAO,EAAQ,MAAM,KAAQ,YAC7B,OAAO,EAAQ,MAAM,KAAQ,WAEhC,MAAM,IAAI,EACR,8DACA,EAAsB,qBACxB,EAEF,OAAO,CAbL,CAcJ,CAmBA,eAAsB,EAAkB,EAAgD,CACtF,GAAM,CAAE,WAAY,EACd,EACJ,EAAM,UAAY,kBACd,EAAQ,oBACR,EAAQ,uBACR,EACJ,EAAQ,iBAAmB,IAAA,GACvB,OACA,GAAG,EAAQ,eAAe,KAAK,GAAG,EAAQ,eAAe,WAIzD,EAAgB,MAAM,EAC1B,EAAM,aAAa,IAAI,GAAQ,GAAG,EAAK,KAAK,GAAG,EAAgB,EAAK,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,CACvF,EAWA,OAAO,EAAU,CARf,aACA,EAAM,MACN,GAAG,EAAQ,cAAc,GAAG,EAAQ,eAAiB,OAAO,GAAG,EAAQ,kBACvE,GAAG,EAAM,QAAQ,GAAG,IACpB,GAAG,OAAO,EAAQ,UAAU,EAAE,GAAG,IACjC,CAGwB,CAAC,CAAC,IAAI,CAAe,CAAC,CAAC,KAAK,GAAG,CAAC,CAC5D,CAWA,eAAsB,EACpB,EACA,EACA,EACA,EAC0C,CAC1C,GAAI,CACF,IAAM,EAAQ,MAAM,EAAM,MAAM,IAAI,CAAG,EACvC,GAAsB,OAAO,GAAU,WAAnC,GAA+C,EAAM,QAAU,EAAO,OAC1E,IAAM,EAAS,EAAM,OACrB,GAAI,CAAC,MAAM,QAAQ,CAAM,GAAK,EAAO,SAAW,GAC1C,IAAe,IAAA,IAAa,EAAa,GAAK,EAAO,SAAW,EAAa,OACnF,IAAM,EAAqB,CAAC,EAC5B,IAAK,IAAM,KAAS,EAAQ,CAC1B,GAAI,OAAO,GAAU,UAAY,CAAC,OAAO,SAAS,CAAK,EAAG,OAC1D,EAAS,KAAK,CAAK,CACrB,CACA,OAAO,OAAO,OAAO,CAAE,QAAO,OAAQ,OAAO,OAAO,CAAQ,CAAE,CAAC,CACjE,MAAQ,CACN,MACF,CACF,CASA,eAAsB,EACpB,EACA,EACA,EACe,CACf,GAAI,CACF,MAAM,EAAM,MAAM,IAAI,EAAK,OAAO,OAAO,CAAE,MAAO,EAAM,MAAO,OAAQ,OAAO,OAAO,CAAC,GAAG,EAAM,MAAM,CAAC,CAAE,CAAC,CAAC,CAC5G,MAAQ,CAER,CACF"}

package/dist/composition/embedding/definition.d.ts

@@ -0,0 +1,7 @@
+import { ComposableEmbeddingProviderPlugin, EmbeddingProviderPluginDefinition } from "./plugin-types.js";
+//#region src/composition/embedding/definition.d.ts
+/** Create an inert embedding plugin wrapper; setup and cleanup stay deferred to activation. */
+declare function defineEmbeddingProviderPlugin(definition: EmbeddingProviderPluginDefinition): ComposableEmbeddingProviderPlugin;
+//#endregion
+export { defineEmbeddingProviderPlugin };
+//# sourceMappingURL=definition.d.ts.map

package/dist/composition/embedding/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","names":[],"sources":["../../../src/composition/embedding/definition.ts"],"mappings":";;;iBAYgB,8BACd,YAAY,oCACX"}

package/dist/composition/embedding/definition.js

@@ -0,0 +1,2 @@
+import{arrayData as e,boundedText as t,capturedMethod as n,objectValue as r,ownData as i}from"../../capability/common/data.js";import{COMPOSITION_LIMITS as a}from"../../capability/common/config.js";import{captureModelTarget as o}from"../provider/model-selection.js";import"./plugin-types.js";function s(s){let d=r(s),f=t(i(d,`id`),a.identityBytes),p=t(i(d,`displayName`),a.displayNameBytes),m=i(d,`family`,!1),h=m===void 0?void 0:t(m,a.identityBytes),g=e(i(d,`routes`),a.routesPerProvider).map(e=>t(e,a.identityBytes));if(g.length===0||new Set(g).size!==g.length)throw TypeError(`Provider route claims must be non-empty and unique`);let _=i(d,`defaultModel`,!1),v=_===void 0?void 0:o(_,!1);if(v!==void 0&&!g.includes(v.provider))throw TypeError(`Provider default model route is not claimed`);let y=n(d,`setup`),b=Object.freeze(g),x=e=>{let t=u(e),n=Object.freeze({logger:t,registerEmbeddingAdapter(t,n){let r=n?.routes===void 0?b:c(n.routes,b),i=n?.models===void 0?void 0:l(n.models);return e.registerEmbeddingAdapter(r,t,i)}}),r=y(n);if(r!==void 0)return typeof r==`function`?()=>{r()}:r};return Object.freeze({kind:`embedding-provider-plugin`,apiVersion:1,id:f,displayName:p,routes:b,...h===void 0?{}:{family:h},...v===void 0?{}:{defaultModel:v},setup:x})}function c(n,r){let i=e(n,a.routesPerProvider).map(e=>t(e,a.identityBytes));if(i.length===0||new Set(i).size!==i.length)throw TypeError(`Embedding adapter route selection must be non-empty and unique`);for(let e of i)if(!r.includes(e))throw TypeError(`Embedding adapter route is not claimed by this plugin`);return Object.freeze(i)}function l(n){let r=e(n,a.routesPerProvider).map(e=>t(e,a.modelIdBytes));if(r.length===0||new Set(r).size!==r.length)throw TypeError(`Embedding adapter model selection must be non-empty and unique`);return Object.freeze(r)}function u(e){let t=Reflect.get(e,`logger`);if(t===void 0||typeof t.child!=`function`||typeof t.info!=`function`||typeof t.error!=`function`)throw TypeError(`Composable embedding provider setup requires a runtime-bound logger`);return t}export{s as defineEmbeddingProviderPlugin};
+//# sourceMappingURL=definition.js.map

package/dist/composition/embedding/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","names":[],"sources":["../../../src/composition/embedding/definition.ts"],"sourcesContent":["import type { EmbeddingAdapter } from '../../embedding/adapter.ts'\nimport type { SdkLogger } from '../../logging/types.ts'\nimport { COMPOSITION_LIMITS } from '../common/config.ts'\nimport { arrayData, boundedText, capturedMethod, objectValue, ownData } from '../common/data.ts'\nimport { captureModelTarget } from '../provider/model-selection.ts'\nimport {\n  EMBEDDING_PROVIDER_PLUGIN_API_VERSION, type ComposableEmbeddingProviderPlugin,\n  type ComposableEmbeddingProviderRegistrar, type EmbeddingProviderPluginCleanupDefinition,\n  type EmbeddingProviderPluginDefinition, type EmbeddingProviderRegistrar,\n} from './plugin-types.ts'\n\n/** Create an inert embedding plugin wrapper; setup and cleanup stay deferred to activation. */\nexport function defineEmbeddingProviderPlugin(\n  definition: EmbeddingProviderPluginDefinition,\n): ComposableEmbeddingProviderPlugin {\n  const source = objectValue(definition)\n  const id = boundedText(ownData(source, 'id'), COMPOSITION_LIMITS.identityBytes)\n  const displayName = boundedText(ownData(source, 'displayName'), COMPOSITION_LIMITS.displayNameBytes)\n  const familyValue = ownData(source, 'family', false)\n  const family = familyValue === undefined ? undefined\n    : boundedText(familyValue, COMPOSITION_LIMITS.identityBytes)\n  const routes = arrayData(ownData(source, 'routes'), COMPOSITION_LIMITS.routesPerProvider)\n    .map(route => boundedText(route, COMPOSITION_LIMITS.identityBytes))\n  if (routes.length === 0 || new Set(routes).size !== routes.length) {\n    throw new TypeError('Provider route claims must be non-empty and unique')\n  }\n  const defaultValue = ownData(source, 'defaultModel', false)\n  const defaultModel = defaultValue === undefined ? undefined : captureModelTarget(defaultValue, false)\n  if (defaultModel !== undefined && !routes.includes(defaultModel.provider)) {\n    throw new TypeError('Provider default model route is not claimed')\n  }\n  const authorSetup = capturedMethod<\n    [ComposableEmbeddingProviderRegistrar], undefined | EmbeddingProviderPluginCleanupDefinition\n  >(source, 'setup')\n  const claims = Object.freeze(routes)\n  const setup = (registrar: EmbeddingProviderRegistrar): void | (() => void) => {\n    const logger = boundLogger(registrar)\n    const scoped: ComposableEmbeddingProviderRegistrar = Object.freeze({\n      logger,\n      registerEmbeddingAdapter(\n        adapter: EmbeddingAdapter,\n        options?: { readonly routes?: readonly string[]; readonly models?: readonly string[] },\n      ) {\n        const selected = options?.routes === undefined ? claims : capturedRoutes(options.routes, claims)\n        const models = options?.models === undefined ? undefined : capturedModels(options.models)\n        return registrar.registerEmbeddingAdapter(selected, adapter, models)\n      },\n    })\n    const cleanup = authorSetup(scoped)\n    if (cleanup === undefined) return\n    if (typeof cleanup !== 'function') return cleanup as never\n    return () => { cleanup() }\n  }\n  return Object.freeze({\n    kind: 'embedding-provider-plugin', apiVersion: EMBEDDING_PROVIDER_PLUGIN_API_VERSION,\n    id, displayName, routes: claims, ...(family === undefined ? {} : { family }),\n    ...(defaultModel === undefined ? {} : { defaultModel }), setup,\n  })\n}\n\n/** Registration cannot reach outside the predeclared claims (Requirement 11.5). */\nfunction capturedRoutes(\n  value: readonly string[],\n  claims: readonly string[],\n): readonly string[] {\n  const selected = arrayData(value, COMPOSITION_LIMITS.routesPerProvider)\n    .map(route => boundedText(route, COMPOSITION_LIMITS.identityBytes))\n  if (selected.length === 0 || new Set(selected).size !== selected.length) {\n    throw new TypeError('Embedding adapter route selection must be non-empty and unique')\n  }\n  for (const route of selected) {\n    if (!claims.includes(route)) {\n      throw new TypeError('Embedding adapter route is not claimed by this plugin')\n    }\n  }\n  return Object.freeze(selected)\n}\n\nfunction capturedModels(value: readonly string[]): readonly string[] {\n  const models = arrayData(value, COMPOSITION_LIMITS.routesPerProvider)\n    .map(model => boundedText(model, COMPOSITION_LIMITS.modelIdBytes))\n  if (models.length === 0 || new Set(models).size !== models.length) {\n    throw new TypeError('Embedding adapter model selection must be non-empty and unique')\n  }\n  return Object.freeze(models)\n}\n\nfunction boundLogger(registrar: EmbeddingProviderRegistrar): SdkLogger {\n  const logger = Reflect.get(registrar, 'logger') as Partial<SdkLogger> | undefined\n  if (logger === undefined || typeof logger.child !== 'function'\n    || typeof logger.info !== 'function' || typeof logger.error !== 'function') {\n    throw new TypeError('Composable embedding provider setup requires a runtime-bound logger')\n  }\n  return logger as SdkLogger\n}\n"],"mappings":"oSAYA,SAAgB,EACd,EACmC,CACnC,IAAM,EAAS,EAAY,CAAU,EAC/B,EAAK,EAAY,EAAQ,EAAQ,IAAI,EAAG,EAAmB,aAAa,EACxE,EAAc,EAAY,EAAQ,EAAQ,aAAa,EAAG,EAAmB,gBAAgB,EAC7F,EAAc,EAAQ,EAAQ,SAAU,EAAK,EAC7C,EAAS,IAAgB,IAAA,GAAY,IAAA,GACvC,EAAY,EAAa,EAAmB,aAAa,EACvD,EAAS,EAAU,EAAQ,EAAQ,QAAQ,EAAG,EAAmB,iBAAiB,CAAC,CACtF,IAAI,GAAS,EAAY,EAAO,EAAmB,aAAa,CAAC,EACpE,GAAI,EAAO,SAAW,GAAK,IAAI,IAAI,CAAM,CAAC,CAAC,OAAS,EAAO,OACzD,MAAU,UAAU,oDAAoD,EAE1E,IAAM,EAAe,EAAQ,EAAQ,eAAgB,EAAK,EACpD,EAAe,IAAiB,IAAA,GAAY,IAAA,GAAY,EAAmB,EAAc,EAAK,EACpG,GAAI,IAAiB,IAAA,IAAa,CAAC,EAAO,SAAS,EAAa,QAAQ,EACtE,MAAU,UAAU,6CAA6C,EAEnE,IAAM,EAAc,EAElB,EAAQ,OAAO,EACX,EAAS,OAAO,OAAO,CAAM,EAC7B,EAAS,GAA+D,CAC5E,IAAM,EAAS,EAAY,CAAS,EAC9B,EAA+C,OAAO,OAAO,CACjE,SACA,yBACE,EACA,EACA,CACA,IAAM,EAAW,GAAS,SAAW,IAAA,GAAY,EAAS,EAAe,EAAQ,OAAQ,CAAM,EACzF,EAAS,GAAS,SAAW,IAAA,GAAY,IAAA,GAAY,EAAe,EAAQ,MAAM,EACxF,OAAO,EAAU,yBAAyB,EAAU,EAAS,CAAM,CACrE,CACF,CAAC,EACK,EAAU,EAAY,CAAM,EAC9B,OAAY,IAAA,GAEhB,OADI,OAAO,GAAY,eACV,CAAE,EAAQ,CAAE,EADiB,CAE5C,EACA,OAAO,OAAO,OAAO,CACnB,KAAM,4BAA6B,WAAA,EACnC,KAAI,cAAa,OAAQ,EAAQ,GAAI,IAAW,IAAA,GAAY,CAAC,EAAI,CAAE,QAAO,EAC1E,GAAI,IAAiB,IAAA,GAAY,CAAC,EAAI,CAAE,cAAa,EAAI,OAC3D,CAAC,CACH,CAGA,SAAS,EACP,EACA,EACmB,CACnB,IAAM,EAAW,EAAU,EAAO,EAAmB,iBAAiB,CAAC,CACpE,IAAI,GAAS,EAAY,EAAO,EAAmB,aAAa,CAAC,EACpE,GAAI,EAAS,SAAW,GAAK,IAAI,IAAI,CAAQ,CAAC,CAAC,OAAS,EAAS,OAC/D,MAAU,UAAU,gEAAgE,EAEtF,IAAK,IAAM,KAAS,EAClB,GAAI,CAAC,EAAO,SAAS,CAAK,EACxB,MAAU,UAAU,uDAAuD,EAG/E,OAAO,OAAO,OAAO,CAAQ,CAC/B,CAEA,SAAS,EAAe,EAA6C,CACnE,IAAM,EAAS,EAAU,EAAO,EAAmB,iBAAiB,CAAC,CAClE,IAAI,GAAS,EAAY,EAAO,EAAmB,YAAY,CAAC,EACnE,GAAI,EAAO,SAAW,GAAK,IAAI,IAAI,CAAM,CAAC,CAAC,OAAS,EAAO,OACzD,MAAU,UAAU,gEAAgE,EAEtF,OAAO,OAAO,OAAO,CAAM,CAC7B,CAEA,SAAS,EAAY,EAAkD,CACrE,IAAM,EAAS,QAAQ,IAAI,EAAW,QAAQ,EAC9C,GAAI,IAAW,IAAA,IAAa,OAAO,EAAO,OAAU,YAC/C,OAAO,EAAO,MAAS,YAAc,OAAO,EAAO,OAAU,WAChE,MAAU,UAAU,qEAAqE,EAE3F,OAAO,CACT"}

package/dist/composition/embedding/handle.js

@@ -0,0 +1,2 @@
+import{MODEL_ERROR_CODES as e}from"../../errors/model-error.js";import{normalizeModelFailure as t}from"../../errors/failure.js";import{EMBEDDING_ERROR_CODES as n,EmbeddingError as r}from"../../embedding/errors.js";import"../../embedding/request.js";import{validateBatchResult as i,validatePreDispatch as a}from"../../embedding/validation.js";import{beginEmbeddingCallObservation as o}from"./observation.js";import{embeddingCacheKey as s,readEmbeddingCacheEntry as c,resolveEmbeddingCache as l,writeEmbeddingCacheEntry as u}from"./cache.js";import{resolveEmbeddingConcurrency as d,runBatchesWithConcurrency as f}from"./limiter.js";import{planEmbeddingBatches as p}from"./planner.js";import{createEmbeddingRetryLedger as m}from"./retry.js";import{aggregateEmbeddingUsage as h}from"./usage.js";function g(e){return new r(e,n.CONFIGURATION_INVALID)}const _=new Set([n.ABORTED,e.ABORTED,`RUNTIME_OPERATION_ABORTED`,`RUNTIME_CLOSING`,`RUNTIME_CLOSED`]);function v(e){return _.has(t(e).code)?`aborted`:`error`}function y(e,t){if(typeof e!=`string`||e.length===0)throw g(`embedding handle requires a non-empty \`${t}\``);return e}function b(e){let t=e.compatibilityIdentity===void 0?void 0:y(e.compatibilityIdentity,`compatibilityIdentity`),n=e.fallback;if(n===void 0)return t;if(!Array.isArray(n)||n.length===0)throw g(`embedding fallback declaration must be a non-empty array`);let r=t;for(let e of n){if(typeof e!=`object`||!e)throw g(`each embedding fallback entry must declare a model and an identity`);y(e.model,`fallback.model`);let t=y(e.compatibilityIdentity,`fallback.compatibilityIdentity`);if(r===void 0)r=t;else if(r!==t)throw g(`embedding fallback models must all declare the same compatibilityIdentity`)}return r}function x(e,t){if(typeof e==`string`)return[{type:`text`,text:e}];if(Array.isArray(e)){let i=[];for(let a of e){if(typeof a!=`object`||!a||a.type!==`text`||typeof a.text!=`string`)throw new r(`embedding content parts must have type "text" and a string text value`,n.REQUEST_INVALID,{itemIndexes:[t]});i.push(Object.freeze({type:`text`,text:a.text}))}return Object.freeze(i)}throw new r(`embedding input must be a string or an array of content parts`,n.REQUEST_INVALID,{itemIndexes:[t]})}function S(e){if(!Array.isArray(e))throw new r(`embedding input values must be an array`,n.REQUEST_INVALID);return Array.from(e,(e,t)=>({index:t,contentParts:x(e,t)}))}function C(e,t){return e!==`allow`||t.length===0?[]:[Object.freeze({code:`input-truncated`,itemIndexes:Object.freeze([...t]),message:`provider reported that it truncated the input before embedding it`})]}function w(e){let{adapter:t,context:_,operations:x,options:w,retryPolicy:T}=e,E=y(w.provider,`provider`),D=y(w.model,`model`),O=w.truncation??`reject`,k=d(w.concurrency),A=l(w.cache),j=b(w),M=e=>{if(j!==void 0&&e.profile.compatibilityIdentity!==j)throw g(`embedding fallback group declares compatibility identity "${j}" but route "${E}" resolved "${e.profile.compatibilityIdentity}"`)},N=async(e,t,n,r,i,a)=>{let o=[];for(let l of t){let t=await s({scope:e.scope,profile:n.profile,purpose:r,contentParts:l.contentParts}),u=await c(e,t,n.spaceId,n.profile.dimensions);if(u===void 0){a.set(l.index,t),o.push(l);continue}i[l.index]=u.values}return o},P=async(t,n,r,i)=>{let a=S(n),s=o({route:E,model:D,purpose:t,itemCount:a.length},{..._===void 0?{}:{context:_},...e.observation===void 0?{}:{observation:e.observation},...e.resource===void 0?{}:{resource:e.resource}}),c=0,l=0,u;try{let e=await F(s,t,a,r,i,e=>{c=e.cacheHits??c,l=e.providerAttempts??l,u=e.space??u});return s.end({status:`success`,spaceId:e.space,cacheHits:c,providerAttempts:e.usage.providerAttempts}),e}catch(e){throw s.end({status:v(e),...u===void 0?{}:{spaceId:u},cacheHits:c,providerAttempts:l,error:e}),e}},F=async(e,o,s,c,l,d)=>x.execute(`embedding-call`,c===void 0?{}:{signal:c},async c=>{let g=await t.prepareEmbeddingCall(E,D,{...w.dimensions===void 0?{}:{dimensions:w.dimensions},...w.batchLimits===void 0?{}:{limits:w.batchLimits}},c.signal,e.context);M(g),d({space:g.spaceId}),a({purpose:o,items:s,...w.dimensions===void 0?{}:{dimensions:w.dimensions},truncation:O,...l===void 0?{}:{expectedSpace:l}},g);let _=Array(s.length),y=new Map,b=A===void 0?s:await N(A,s,g,o,_,y);d({cacheHits:s.length-b.length});let x=m(g,{...T===void 0?{}:{policy:T},signal:c.signal,...e.context===void 0?{}:{context:e.context}}),S=0,j=new Map;if((await f(p(b,g.limits),async t=>{let a={provider:E,model:D,purpose:o,items:t.items,...w.dimensions===void 0?{}:{dimensions:w.dimensions},truncation:O,signal:c.signal},s=e.beginBatch({batchIndex:t.batchIndex,itemCount:t.items.length,byteCount:t.bytes,estimatedTokens:t.estimatedTokens,...w.dimensions===void 0?{}:{dimensions:w.dimensions}});try{let e=await x.dispatch(t.batchIndex,a,s.context);S+=e.attempts,d({providerAttempts:S});let o=e.state;if(o.phase===`failed`)throw o.error;if(o.phase!==`succeeded`)throw new r(`embedding batch ${t.batchIndex} settled in a non-terminal state`,n.RESPONSE_MALFORMED,{provider:E,model:D,itemIndexes:[...e.itemIndexes]});let c=o.vectors;i(a,{vectors:c});let l=[];for(let e of c)_[e.index]=e.values,e.truncated===!0&&l.push(e.index);if(j.set(t.batchIndex,{evidence:{itemIndexes:e.itemIndexes,attempts:e.attempts,...e.usage===void 0?{}:{usage:e.usage}},warnings:[...e.warnings,...C(O,l)]}),A!==void 0)for(let e of c){let t=y.get(e.index);t!==void 0&&await u(A,t,{values:e.values,space:g.spaceId})}s.end(`success`)}catch(e){throw s.end(v(e),e),e}},{concurrency:k,signal:c.signal})).aborted)throw new r(`embedding call aborted before every batch was dispatched`,n.ABORTED,{provider:E,model:D,space:g.spaceId});let P=[...j.keys()].sort((e,t)=>e-t),F=h({inputCount:s.length,batches:P.map(e=>j.get(e).evidence)}),I=[...P.flatMap(e=>j.get(e).warnings),...F.warnings];return{vectors:_.map((e,t)=>{if(e!==void 0)return e;throw new r(`embedding call produced no vector for an input`,n.RESPONSE_MALFORMED,{provider:E,model:D,itemIndexes:[t]})}),space:g.spaceId,prepared:g,usage:F.report,warnings:Object.freeze(I)}});return Object.freeze({async embed(e){let t=await P(e.purpose,[e.value],e.signal,e.expectedSpace??w.expectedSpace);return Object.freeze({embedding:t.vectors[0],space:t.space,profile:t.prepared.profile,usage:t.usage,warnings:t.warnings})},async embedMany(e){let t=await P(e.purpose,e.values,e.signal,e.expectedSpace??w.expectedSpace);return Object.freeze({embeddings:Object.freeze(t.vectors),space:t.space,profile:t.prepared.profile,usage:t.usage,warnings:t.warnings})}})}export{w as createEmbeddingModelHandle};
+//# sourceMappingURL=handle.js.map

package/dist/composition/embedding/handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","names":[],"sources":["../../../src/composition/embedding/handle.ts"],"sourcesContent":["/**\n * `embed()` and `embedMany()`: the composition root of one `Logical_Call`.\n *\n * This module owns nothing new. Every mechanism it needs already exists and has\n * exactly one owner — `prepareEmbeddingCall()` for the configuration snapshot,\n * `validatePreDispatch()` for pre-dispatch rejection, `embeddingCacheKey()` for\n * the optional cache, `planEmbeddingBatches()` for splitting,\n * `runBatchesWithConcurrency()` for the in-flight bound,\n * `createEmbeddingRetryLedger()` for retry, `aggregateEmbeddingUsage()` for\n * honest usage. What is left here is the ORDER those pieces run in, and the four\n * decisions that only a `Logical_Call` is in a position to make:\n *\n * 1. **One snapshot per logical call.** `prepareEmbeddingCall()` is called ONCE,\n *    and every `Physical_Batch` — first attempt or fifth retry — dispatches\n *    through that same generation. Validation reads its metadata and the result\n *    reports its `Space_Id`, so a provider reconfiguration mid-call cannot make\n *    the call report a space it did not produce vectors in (Requirements 2.2,\n *    2.3, 2.4).\n * 2. **Order comes from `item.index`, never from settlement time.** Vectors are\n *    written into a pre-allocated array at `results[item.index]`. Batches may\n *    settle in any order, retries may reorder them further, and a provider may\n *    return the vectors of one batch permuted; none of that is observable in the\n *    output (Requirement 4.6).\n * 3. **`expectedSpace` is a rejection, not a warning.** An incompatible expected\n *    space fails with `EMBEDDING_SPACE_INCOMPATIBLE` before the first attempt,\n *    which `validatePreDispatch()` performs against the prepared call\n *    (Requirements 6.2, 6.5).\n * 4. **A fallback group is checked when it is configured, not after a failure.**\n *    A declared fallback outside the group sharing one `compatibilityIdentity`\n *    is `EMBEDDING_CONFIGURATION_INVALID`. There is no fallback DISPATCH here at\n *    all: a failure of the primary model propagates (Requirements 6.6, 6.7).\n *\n * Memory: nothing per-batch survives the batch. The run callback writes vectors,\n * records a few numbers of evidence, and drops the request — so peak payload\n * memory stays `concurrency × maxBytes` rather than scaling with the corpus.\n *\n * Observation is opened here because this is the only scope that knows all three\n * levels at once: `observation.ts` owns the record shapes, and this file owns\n * WHEN each level opens and closes. One `sdk.embedding.call` per logical call,\n * one `sdk.embedding.batch` per `Physical_Batch`, and provider attempts through\n * the existing `context.startProviderAttempt` / `attempt.end` pair, so embedding\n * retries land in the same ledger as generation retries (Requirements 16.1,\n * 16.4, 16.5).\n *\n * @module ai-agent-sdk/core/composition/embedding/handle\n */\n\nimport type { ResolvedRetryPolicy } from '../../contract/retry-policy.ts'\nimport type { EmbeddingAdapter, PreparedEmbeddingCall } from '../../embedding/adapter.ts'\nimport { EMBEDDING_ERROR_CODES, EmbeddingError } from '../../embedding/errors.ts'\nimport type {\n  EmbedManyInput,\n  EmbedOneInput,\n  EmbeddingCacheOptions,\n  EmbeddingModelHandle,\n  EmbeddingModelOptions,\n} from '../../embedding/handle.ts'\nimport type { EmbeddingSpaceId } from '../../embedding/profile.ts'\nimport type { EmbeddingPurpose } from '../../embedding/purpose.ts'\nimport type {\n  EmbeddingBatchRequest,\n  EmbeddingContentPart,\n  EmbeddingItem,\n  EmbeddingTruncation,\n} from '../../embedding/request.ts'\nimport { DEFAULT_EMBEDDING_TRUNCATION } from '../../embedding/request.ts'\nimport type {\n  EmbeddingManyResult,\n  EmbeddingResult,\n  EmbeddingWarning,\n} from '../../embedding/result.ts'\nimport type { EmbeddingUsageReport } from '../../embedding/usage.ts'\nimport { validateBatchResult, validatePreDispatch } from '../../embedding/validation.ts'\nimport { normalizeModelFailure } from '../../errors/failure.ts'\nimport { MODEL_ERROR_CODES } from '../../errors/model-error.ts'\nimport type { ObservationResource, OperationStatus } from '../../observation/event.ts'\nimport type { ObservationPort } from '../../observation/port.ts'\nimport type { ModelInvocationContext } from '../../observation/report.ts'\nimport type { OperationLease, OperationOptions } from '../lifecycle/types.ts'\nimport {\n  beginEmbeddingCallObservation,\n  type EmbeddingCallObservation,\n} from './observation.ts'\nimport {\n  embeddingCacheKey,\n  readEmbeddingCacheEntry,\n  resolveEmbeddingCache,\n  writeEmbeddingCacheEntry,\n} from './cache.ts'\nimport { resolveEmbeddingConcurrency, runBatchesWithConcurrency } from './limiter.ts'\nimport { planEmbeddingBatches } from './planner.ts'\nimport { createEmbeddingRetryLedger } from './retry.ts'\nimport {\n  aggregateEmbeddingUsage,\n  type EmbeddingBatchUsageEvidence,\n} from './usage.ts'\n\n/**\n * The admission surface this handle needs from `RuntimeOperations`.\n *\n * Structural on purpose: the handle needs a lease whose signal already fuses the\n * runtime root controller with the caller's signal, and nothing else. Declaring\n * the dependency this narrowly is what lets a test drive one `Logical_Call`\n * without standing up a whole runtime.\n */\nexport interface EmbeddingOperationScheduler {\n  execute<T>(\n    kind: 'embedding-call',\n    options: OperationOptions,\n    work: (lease: OperationLease) => Promise<T>,\n  ): Promise<T>\n}\n\n/**\n * One member of a declared fallback group.\n *\n * `compatibilityIdentity` is REQUIRED, and that is the whole point: a fallback is\n * only legitimate when the provider has declared that the two models share an\n * embedding space. Naming a model id alone would ask the runtime to infer\n * compatibility from a name, which is exactly what Requirement 6.3 forbids.\n */\nexport interface EmbeddingFallbackDeclaration {\n  readonly model: string\n  /** The provider's declaration that this model shares the primary's space. */\n  readonly compatibilityIdentity: string\n}\n\n/**\n * Handle configuration: the public {@link EmbeddingModelOptions} plus the two\n * fields that only exist to make a fallback group checkable.\n *\n * These live here rather than on `EmbeddingModelOptions` because they are\n * runtime configuration of one handle, not part of the type-only public surface\n * that `embedding/handle.ts` owns.\n */\nexport interface EmbeddingHandleOptions extends EmbeddingModelOptions {\n  /**\n   * The `compatibilityIdentity` the caller believes this route resolves to.\n   *\n   * When present it is enforced against the prepared call, so a route whose\n   * declared identity has changed fails loudly instead of quietly producing\n   * vectors in another space.\n   */\n  readonly compatibilityIdentity?: string\n  /** Models declared to share this call's embedding space. */\n  readonly fallback?: readonly EmbeddingFallbackDeclaration[]\n}\n\n/** Everything {@link createEmbeddingModelHandle} needs, resolved by the manager. */\nexport interface EmbeddingHandleDependencies {\n  /** Runtime admission; supplies the lease whose signal covers `close()`. */\n  readonly operations: EmbeddingOperationScheduler\n  /** The adapter the registry resolved for this route + model. */\n  readonly adapter: Pick<EmbeddingAdapter, 'prepareEmbeddingCall'>\n  readonly options: EmbeddingHandleOptions\n  /** Route policy captured at registration; omission takes the SDK defaults. */\n  readonly retryPolicy?: ResolvedRetryPolicy\n  /**\n   * Caller invocation context.\n   *\n   * Its port, resource, correlation and scope are adopted so an embedding call\n   * nested in a larger trace joins that trace. When it already performs attempt\n   * accounting, that accounting is kept and this handle adds none of its own.\n   */\n  readonly context?: ModelInvocationContext\n  /** Runtime default observation port, used when the context carries none. */\n  readonly observation?: ObservationPort\n  /** Runtime resource identity, used when the context carries none. */\n  readonly resource?: ObservationResource\n}\n\n/** One settled batch's small, order-independent residue. */\ninterface BatchResidue {\n  readonly evidence: EmbeddingBatchUsageEvidence\n  readonly warnings: readonly EmbeddingWarning[]\n}\n\n/**\n * Facts a `Logical_Call` learns as it progresses, reported outward so the\n * terminal observation record is accurate even when the call fails.\n *\n * Every field is optional because each becomes known at a different point, and a\n * field that is not yet known must stay absent rather than be reported as zero.\n */\ninterface LogicalCallEvidence {\n  readonly space?: EmbeddingSpaceId\n  readonly cacheHits?: number\n  readonly providerAttempts?: number\n}\n\n/** What one `Logical_Call` produces, before it is shaped into one of two results. */\ninterface LogicalCallOutcome {\n  readonly vectors: readonly (readonly number[])[]\n  readonly space: EmbeddingSpaceId\n  readonly prepared: PreparedEmbeddingCall\n  readonly usage: EmbeddingUsageReport\n  readonly warnings: readonly EmbeddingWarning[]\n}\n\nfunction configurationError(message: string): EmbeddingError {\n  return new EmbeddingError(message, EMBEDDING_ERROR_CODES.CONFIGURATION_INVALID)\n}\n\n/** Codes that mean the caller or the runtime stopped this, not that it broke. */\nconst ABORT_CODES: ReadonlySet<string> = new Set([\n  EMBEDDING_ERROR_CODES.ABORTED,\n  MODEL_ERROR_CODES.ABORTED,\n  'RUNTIME_OPERATION_ABORTED',\n  'RUNTIME_CLOSING',\n  'RUNTIME_CLOSED',\n])\n\n/**\n * Terminal status of one failed span.\n *\n * A cancellation is reported as `aborted` rather than `error` so an operator\n * reading a trace can tell a broken provider from a caller that changed its mind\n * — the two have very different follow-ups.\n */\nfunction terminalStatus(error: unknown): OperationStatus {\n  return ABORT_CODES.has(normalizeModelFailure(error).code) ? 'aborted' : 'error'\n}\n\n/** A non-empty string, or a configuration failure naming the field. */\nfunction requireIdentifier(value: unknown, field: string): string {\n  if (typeof value !== 'string' || value.length === 0) {\n    throw configurationError(`embedding handle requires a non-empty \\`${field}\\``)\n  }\n  return value\n}\n\n/**\n * Validates a declared fallback group and reduces it to the ONE identity every\n * member must share.\n *\n * Rejecting at construction rather than at failure time is deliberate: a group\n * that spans two embedding spaces is misconfigured whether or not the primary\n * model ever fails, and discovering it only during an incident is the worst\n * possible moment (Requirement 6.7).\n */\nfunction resolveFallbackIdentity(options: EmbeddingHandleOptions): string | undefined {\n  const declared = options.compatibilityIdentity === undefined\n    ? undefined\n    : requireIdentifier(options.compatibilityIdentity, 'compatibilityIdentity')\n  const fallback = options.fallback\n  if (fallback === undefined) return declared\n  if (!Array.isArray(fallback) || fallback.length === 0) {\n    throw configurationError('embedding fallback declaration must be a non-empty array')\n  }\n\n  let identity = declared\n  for (const entry of fallback) {\n    if (entry === null || typeof entry !== 'object') {\n      throw configurationError('each embedding fallback entry must declare a model and an identity')\n    }\n    requireIdentifier(entry.model, 'fallback.model')\n    const entryIdentity = requireIdentifier(entry.compatibilityIdentity, 'fallback.compatibilityIdentity')\n    if (identity === undefined) identity = entryIdentity\n    else if (identity !== entryIdentity) {\n      // Two identities in one group means at least one member produces vectors\n      // in a different space, so the group is not a fallback group at all.\n      throw configurationError(\n        'embedding fallback models must all declare the same compatibilityIdentity',\n      )\n    }\n  }\n  return identity\n}\n\n/** Normalises one caller value into the content parts of a single item. */\nfunction toContentParts(\n  value: string | readonly EmbeddingContentPart[],\n  index: number,\n): readonly EmbeddingContentPart[] {\n  if (typeof value === 'string') return [{ type: 'text', text: value }]\n  if (Array.isArray(value)) {\n    const parts: EmbeddingContentPart[] = []\n    for (const part of value) {\n      if (part === null || typeof part !== 'object' || part.type !== 'text' || typeof part.text !== 'string') {\n        throw new EmbeddingError(\n          'embedding content parts must have type \"text\" and a string text value',\n          EMBEDDING_ERROR_CODES.REQUEST_INVALID,\n          { itemIndexes: [index] },\n        )\n      }\n      parts.push(Object.freeze({ type: 'text', text: part.text }))\n    }\n    return Object.freeze(parts)\n  }\n  throw new EmbeddingError(\n    'embedding input must be a string or an array of content parts',\n    EMBEDDING_ERROR_CODES.REQUEST_INVALID,\n    { itemIndexes: [index] },\n  )\n}\n\n/**\n * Builds the items of one `Logical_Call`.\n *\n * `index` is the caller's position and is the ONLY coordinate that matters\n * downstream: batching, retry and out-of-order settlement all preserve it, and\n * output order is restored from it.\n */\nfunction toItems(\n  values: readonly (string | readonly EmbeddingContentPart[])[],\n): readonly EmbeddingItem[] {\n  if (!Array.isArray(values)) {\n    throw new EmbeddingError(\n      'embedding input values must be an array',\n      EMBEDDING_ERROR_CODES.REQUEST_INVALID,\n    )\n  }\n  return Array.from(values, (value, index) => ({ index, contentParts: toContentParts(value, index) }))\n}\n\n/** The truncation warning of one batch, when the caller allowed truncation. */\nfunction truncationWarnings(\n  truncation: EmbeddingTruncation,\n  indexes: readonly number[],\n): readonly EmbeddingWarning[] {\n  if (truncation !== 'allow' || indexes.length === 0) return []\n  return [Object.freeze<EmbeddingWarning>({\n    code: 'input-truncated',\n    itemIndexes: Object.freeze([...indexes]),\n    message: 'provider reported that it truncated the input before embedding it',\n  })]\n}\n\n/**\n * Creates one `EmbeddingModelHandle`.\n *\n * Everything that can be decided without the provider IS decided here, at\n * construction: route identity, the concurrency bound, the cache configuration,\n * and the fallback group. `embeddingModel()` is synchronous, so a caller learns\n * about a misconfiguration at the call that made it rather than at the first\n * `embed()`.\n *\n * @throws {EmbeddingError} `EMBEDDING_CONFIGURATION_INVALID` for an unusable\n * route, concurrency, cache, or fallback declaration.\n */\nexport function createEmbeddingModelHandle(\n  dependencies: EmbeddingHandleDependencies,\n): EmbeddingModelHandle {\n  const { adapter, context, operations, options, retryPolicy } = dependencies\n  const provider = requireIdentifier(options.provider, 'provider')\n  const model = requireIdentifier(options.model, 'model')\n  const truncation = options.truncation ?? DEFAULT_EMBEDDING_TRUNCATION\n  // Both throw EMBEDDING_CONFIGURATION_INVALID; both belong at construction.\n  const concurrency = resolveEmbeddingConcurrency(options.concurrency)\n  const cache = resolveEmbeddingCache(options.cache)\n  const groupIdentity = resolveFallbackIdentity(options)\n\n  /**\n   * Enforces the declared group against what the route actually resolved to.\n   *\n   * The declaration is checked at construction; this is the second half of the\n   * same check, and it is the earliest point at which the route's real identity\n   * is known.\n   */\n  const assertDeclaredIdentity = (prepared: PreparedEmbeddingCall): void => {\n    if (groupIdentity === undefined) return\n    if (prepared.profile.compatibilityIdentity === groupIdentity) return\n    throw configurationError(\n      `embedding fallback group declares compatibility identity \"${groupIdentity}\" `\n      + `but route \"${provider}\" resolved \"${prepared.profile.compatibilityIdentity}\"`,\n    )\n  }\n\n  /**\n   * Reads the cache for every item, returning the misses in input order.\n   *\n   * A hit is written straight into `results`, so a fully cached call plans zero\n   * batches and spends zero `Provider_Attempt`s. Two gates apply: the key covers\n   * the five components of Requirement 5.2, and `readEmbeddingCacheEntry`\n   * discards an entry from another `Space_Id` (Requirement 5.3).\n   */\n  const partitionByCache = async (\n    active: EmbeddingCacheOptions,\n    items: readonly EmbeddingItem[],\n    prepared: PreparedEmbeddingCall,\n    purpose: EmbeddingPurpose,\n    results: (readonly number[] | undefined)[],\n    keys: Map<number, string>,\n  ): Promise<readonly EmbeddingItem[]> => {\n    const misses: EmbeddingItem[] = []\n    for (const item of items) {\n      const key = await embeddingCacheKey({\n        scope: active.scope,\n        profile: prepared.profile,\n        purpose,\n        contentParts: item.contentParts,\n      })\n      const entry = await readEmbeddingCacheEntry(active, key, prepared.spaceId, prepared.profile.dimensions)\n      if (entry === undefined) {\n        keys.set(item.index, key)\n        misses.push(item)\n        continue\n      }\n      results[item.index] = entry.values\n    }\n    return misses\n  }\n\n  /** One `Logical_Call`, from admission to a fully ordered vector array. */\n  const runLogicalCall = async (\n    purpose: EmbeddingPurpose,\n    values: readonly (string | readonly EmbeddingContentPart[])[],\n    signal: AbortSignal | undefined,\n    expectedSpace: EmbeddingSpaceId | undefined,\n  ): Promise<LogicalCallOutcome> => {\n    const items = toItems(values)\n\n    // Opened before admission, so even a call rejected by a closing runtime or by\n    // pre-dispatch validation leaves one record showing zero provider attempts.\n    const observation = beginEmbeddingCallObservation({\n      route: provider,\n      model,\n      purpose,\n      itemCount: items.length,\n    }, {\n      ...(context === undefined ? {} : { context }),\n      ...(dependencies.observation === undefined ? {} : { observation: dependencies.observation }),\n      ...(dependencies.resource === undefined ? {} : { resource: dependencies.resource }),\n    })\n    // Filled in as the call learns them; whatever is known when the call ends is\n    // what the terminal record carries, and nothing is defaulted to a lie.\n    let cacheHits = 0\n    let providerAttempts = 0\n    let space: EmbeddingSpaceId | undefined\n\n    try {\n      const outcome = await runAdmitted(\n        observation,\n        purpose,\n        items,\n        signal,\n        expectedSpace,\n        (evidence) => {\n          cacheHits = evidence.cacheHits ?? cacheHits\n          providerAttempts = evidence.providerAttempts ?? providerAttempts\n          space = evidence.space ?? space\n        },\n      )\n      observation.end({\n        status: 'success',\n        spaceId: outcome.space,\n        cacheHits,\n        providerAttempts: outcome.usage.providerAttempts,\n      })\n      return outcome\n    } catch (error: unknown) {\n      observation.end({\n        status: terminalStatus(error),\n        ...(space === undefined ? {} : { spaceId: space }),\n        cacheHits,\n        providerAttempts,\n        error,\n      })\n      throw error\n    }\n  }\n\n  /** The admitted body of one `Logical_Call`; see {@link runLogicalCall}. */\n  const runAdmitted = async (\n    observation: EmbeddingCallObservation,\n    purpose: EmbeddingPurpose,\n    items: readonly EmbeddingItem[],\n    signal: AbortSignal | undefined,\n    expectedSpace: EmbeddingSpaceId | undefined,\n    report: (evidence: LogicalCallEvidence) => void,\n  ): Promise<LogicalCallOutcome> => {\n    return operations.execute(\n      'embedding-call',\n      signal === undefined ? {} : { signal },\n      async (lease): Promise<LogicalCallOutcome> => {\n        // ONE snapshot for the whole logical call: validation below and every\n        // dispatch further down read this same generation (Requirements 2.2-2.4).\n        const prepared = await adapter.prepareEmbeddingCall(\n          provider,\n          model,\n          {\n            ...(options.dimensions === undefined ? {} : { dimensions: options.dimensions }),\n            ...(options.batchLimits === undefined ? {} : { limits: options.batchLimits }),\n          },\n          lease.signal,\n          observation.context,\n        )\n        assertDeclaredIdentity(prepared)\n        // Known from here on, so a later failure still reports the space the call\n        // would have produced vectors in.\n        report({ space: prepared.spaceId })\n\n        // Rejects purpose, empty inputs, dimensions, truncation, expectedSpace and\n        // over-long inputs with 0 `Provider_Attempt` spent.\n        validatePreDispatch({\n          purpose,\n          items,\n          ...(options.dimensions === undefined ? {} : { dimensions: options.dimensions }),\n          truncation,\n          ...(expectedSpace === undefined ? {} : { expectedSpace }),\n        }, prepared)\n\n        // Pre-allocated to the INPUT length: the one mechanism behind order\n        // restoration, independent of batch settlement order (Requirement 4.6).\n        const results: (readonly number[] | undefined)[] = new Array<readonly number[] | undefined>(items.length)\n        const cacheKeys = new Map<number, string>()\n        const pending = cache === undefined\n          ? items\n          : await partitionByCache(cache, items, prepared, purpose, results, cacheKeys)\n        report({ cacheHits: items.length - pending.length })\n\n        const ledger = createEmbeddingRetryLedger(prepared, {\n          ...(retryPolicy === undefined ? {} : { policy: retryPolicy }),\n          signal: lease.signal,\n          ...(observation.context === undefined ? {} : { context: observation.context }),\n        })\n        // Running total, so a call that fails mid-flight still reports the cost of\n        // the attempts it already spent (Requirement 16.6).\n        let attemptsSpent = 0\n        // Keyed by `batchIndex` so warnings and usage evidence are reported in\n        // plan order no matter which batch settled first.\n        const residues = new Map<number, BatchResidue>()\n\n        const outcome = await runBatchesWithConcurrency(\n          planEmbeddingBatches(pending, prepared.limits),\n          async (plan): Promise<void> => {\n            const request: EmbeddingBatchRequest = {\n              provider,\n              model,\n              purpose,\n              items: plan.items,\n              ...(options.dimensions === undefined ? {} : { dimensions: options.dimensions }),\n              truncation,\n              signal: lease.signal,\n            }\n            // Size only: the planner already measured this batch, so describing it\n            // costs nothing and reveals nothing (Requirement 16.4).\n            const batchObservation = observation.beginBatch({\n              batchIndex: plan.batchIndex,\n              itemCount: plan.items.length,\n              byteCount: plan.bytes,\n              estimatedTokens: plan.estimatedTokens,\n              ...(options.dimensions === undefined ? {} : { dimensions: options.dimensions }),\n            })\n            try {\n              // The batch context is what parents each `Provider_Attempt` under\n              // the batch that provoked it; retry accounting is unchanged.\n              const settled = await ledger.dispatch(\n                plan.batchIndex,\n                request,\n                batchObservation.context,\n              )\n              attemptsSpent += settled.attempts\n              report({ providerAttempts: attemptsSpent })\n              const state = settled.state\n              if (state.phase === 'failed') {\n                // No fallback model: the primary's failure IS the call's failure\n                // (Requirement 6.6).\n                throw state.error\n              }\n              if (state.phase !== 'succeeded') {\n                // The ledger only ever returns a terminal state. A non-terminal one\n                // means the ledger contract was violated, and guessing which half of\n                // the batch exists would be worse than saying so.\n                throw new EmbeddingError(\n                  `embedding batch ${plan.batchIndex} settled in a non-terminal state`,\n                  EMBEDDING_ERROR_CODES.RESPONSE_MALFORMED,\n                  { provider, model, itemIndexes: [...settled.itemIndexes] },\n                )\n              }\n\n              const vectors = state.vectors\n              // Guards the write below. A permuted order is fine — indexes carry\n              // the mapping — but a duplicate or foreign index is a protocol fault,\n              // never something to reconcile by position.\n              validateBatchResult(request, { vectors })\n\n              const truncated: number[] = []\n              for (const vector of vectors) {\n                results[vector.index] = vector.values\n                if (vector.truncated === true) truncated.push(vector.index)\n              }\n\n              residues.set(plan.batchIndex, {\n                evidence: {\n                  itemIndexes: settled.itemIndexes,\n                  attempts: settled.attempts,\n                  ...(settled.usage === undefined ? {} : { usage: settled.usage }),\n                },\n                warnings: [...settled.warnings, ...truncationWarnings(truncation, truncated)],\n              })\n\n              if (cache !== undefined) {\n                for (const vector of vectors) {\n                  const key = cacheKeys.get(vector.index)\n                  if (key === undefined) continue\n                  await writeEmbeddingCacheEntry(cache, key, {\n                    values: vector.values,\n                    space: prepared.spaceId,\n                  })\n                }\n              }\n              batchObservation.end('success')\n            } catch (error: unknown) {\n              batchObservation.end(terminalStatus(error), error)\n              throw error\n            }\n          },\n          { concurrency, signal: lease.signal },\n        )\n\n        if (outcome.aborted) {\n          throw new EmbeddingError(\n            'embedding call aborted before every batch was dispatched',\n            EMBEDDING_ERROR_CODES.ABORTED,\n            { provider, model, space: prepared.spaceId },\n          )\n        }\n\n        const ordered = [...residues.keys()].sort((left, right) => left - right)\n        const usage = aggregateEmbeddingUsage({\n          inputCount: items.length,\n          batches: ordered.map(index => residues.get(index)!.evidence),\n        })\n        const warnings = [\n          ...ordered.flatMap(index => residues.get(index)!.warnings),\n          ...usage.warnings,\n        ]\n\n        const vectors = results.map((values, index) => {\n          if (values !== undefined) return values\n          // Unreachable through the paths above: a settled plan covers every\n          // pending item and the cache covers the rest. Kept as a hard failure\n          // rather than a hole in the output, because a silently missing vector\n          // would be indistinguishable from a zero vector downstream.\n          throw new EmbeddingError(\n            'embedding call produced no vector for an input',\n            EMBEDDING_ERROR_CODES.RESPONSE_MALFORMED,\n            { provider, model, itemIndexes: [index] },\n          )\n        })\n\n        return {\n          vectors,\n          space: prepared.spaceId,\n          prepared,\n          usage: usage.report,\n          warnings: Object.freeze(warnings),\n        }\n      },\n    )\n  }\n\n  return Object.freeze<EmbeddingModelHandle>({\n    async embed(input: EmbedOneInput): Promise<EmbeddingResult> {\n      // One item is a `Logical_Call` like any other; nothing about batching,\n      // cache or usage aggregation is special-cased for it.\n      const outcome = await runLogicalCall(\n        input.purpose,\n        [input.value],\n        input.signal,\n        input.expectedSpace ?? options.expectedSpace,\n      )\n      return Object.freeze<EmbeddingResult>({\n        embedding: outcome.vectors[0]!,\n        space: outcome.space,\n        profile: outcome.prepared.profile,\n        usage: outcome.usage,\n        warnings: outcome.warnings,\n      })\n    },\n\n    async embedMany(input: EmbedManyInput): Promise<EmbeddingManyResult> {\n      const outcome = await runLogicalCall(\n        input.purpose,\n        input.values,\n        input.signal,\n        input.expectedSpace ?? options.expectedSpace,\n      )\n      return Object.freeze<EmbeddingManyResult>({\n        embeddings: Object.freeze(outcome.vectors),\n        space: outcome.space,\n        profile: outcome.prepared.profile,\n        usage: outcome.usage,\n        warnings: outcome.warnings,\n      })\n    },\n  })\n}\n"],"mappings":"uxBAuMA,SAAS,EAAmB,EAAiC,CAC3D,OAAO,IAAI,EAAe,EAAS,EAAsB,qBAAqB,CAChF,CAGA,MAAM,EAAmC,IAAI,IAAI,CAC/C,EAAsB,QACtB,EAAkB,QAClB,4BACA,kBACA,gBACF,CAAC,EASD,SAAS,EAAe,EAAiC,CACvD,OAAO,EAAY,IAAI,EAAsB,CAAK,CAAC,CAAC,IAAI,EAAI,UAAY,OAC1E,CAGA,SAAS,EAAkB,EAAgB,EAAuB,CAChE,GAAI,OAAO,GAAU,UAAY,EAAM,SAAW,EAChD,MAAM,EAAmB,2CAA2C,EAAM,GAAG,EAE/E,OAAO,CACT,CAWA,SAAS,EAAwB,EAAqD,CACpF,IAAM,EAAW,EAAQ,wBAA0B,IAAA,GAC/C,IAAA,GACA,EAAkB,EAAQ,sBAAuB,uBAAuB,EACtE,EAAW,EAAQ,SACzB,GAAI,IAAa,IAAA,GAAW,OAAO,EACnC,GAAI,CAAC,MAAM,QAAQ,CAAQ,GAAK,EAAS,SAAW,EAClD,MAAM,EAAmB,0DAA0D,EAGrF,IAAI,EAAW,EACf,IAAK,IAAM,KAAS,EAAU,CAC5B,GAAsB,OAAO,GAAU,WAAnC,EACF,MAAM,EAAmB,oEAAoE,EAE/F,EAAkB,EAAM,MAAO,gBAAgB,EAC/C,IAAM,EAAgB,EAAkB,EAAM,sBAAuB,gCAAgC,EACrG,GAAI,IAAa,IAAA,GAAW,EAAW,OAClC,GAAI,IAAa,EAGpB,MAAM,EACJ,2EACF,CAEJ,CACA,OAAO,CACT,CAGA,SAAS,EACP,EACA,EACiC,CACjC,GAAI,OAAO,GAAU,SAAU,MAAO,CAAC,CAAE,KAAM,OAAQ,KAAM,CAAM,CAAC,EACpE,GAAI,MAAM,QAAQ,CAAK,EAAG,CACxB,IAAM,EAAgC,CAAC,EACvC,IAAK,IAAM,KAAQ,EAAO,CACxB,GAAqB,OAAO,GAAS,WAAjC,GAA6C,EAAK,OAAS,QAAU,OAAO,EAAK,MAAS,SAC5F,MAAM,IAAI,EACR,wEACA,EAAsB,gBACtB,CAAE,YAAa,CAAC,CAAK,CAAE,CACzB,EAEF,EAAM,KAAK,OAAO,OAAO,CAAE,KAAM,OAAQ,KAAM,EAAK,IAAK,CAAC,CAAC,CAC7D,CACA,OAAO,OAAO,OAAO,CAAK,CAC5B,CACA,MAAM,IAAI,EACR,gEACA,EAAsB,gBACtB,CAAE,YAAa,CAAC,CAAK,CAAE,CACzB,CACF,CASA,SAAS,EACP,EAC0B,CAC1B,GAAI,CAAC,MAAM,QAAQ,CAAM,EACvB,MAAM,IAAI,EACR,0CACA,EAAsB,eACxB,EAEF,OAAO,MAAM,KAAK,GAAS,EAAO,KAAW,CAAE,QAAO,aAAc,EAAe,EAAO,CAAK,CAAE,EAAE,CACrG,CAGA,SAAS,EACP,EACA,EAC6B,CAE7B,OADI,IAAe,SAAW,EAAQ,SAAW,EAAU,CAAC,EACrD,CAAC,OAAO,OAAyB,CACtC,KAAM,kBACN,YAAa,OAAO,OAAO,CAAC,GAAG,CAAO,CAAC,EACvC,QAAS,mEACX,CAAC,CAAC,CACJ,CAcA,SAAgB,EACd,EACsB,CACtB,GAAM,CAAE,UAAS,UAAS,aAAY,UAAS,eAAgB,EACzD,EAAW,EAAkB,EAAQ,SAAU,UAAU,EACzD,EAAQ,EAAkB,EAAQ,MAAO,OAAO,EAChD,EAAa,EAAQ,YAAA,SAErB,EAAc,EAA4B,EAAQ,WAAW,EAC7D,EAAQ,EAAsB,EAAQ,KAAK,EAC3C,EAAgB,EAAwB,CAAO,EAS/C,EAA0B,GAA0C,CACpE,OAAkB,IAAA,IAClB,EAAS,QAAQ,wBAA0B,EAC/C,MAAM,EACJ,6DAA6D,EAAc,eAC3D,EAAS,cAAc,EAAS,QAAQ,sBAAsB,EAChF,CACF,EAUM,EAAmB,MACvB,EACA,EACA,EACA,EACA,EACA,IACsC,CACtC,IAAM,EAA0B,CAAC,EACjC,IAAK,IAAM,KAAQ,EAAO,CACxB,IAAM,EAAM,MAAM,EAAkB,CAClC,MAAO,EAAO,MACd,QAAS,EAAS,QAClB,UACA,aAAc,EAAK,YACrB,CAAC,EACK,EAAQ,MAAM,EAAwB,EAAQ,EAAK,EAAS,QAAS,EAAS,QAAQ,UAAU,EACtG,GAAI,IAAU,IAAA,GAAW,CACvB,EAAK,IAAI,EAAK,MAAO,CAAG,EACxB,EAAO,KAAK,CAAI,EAChB,QACF,CACA,EAAQ,EAAK,OAAS,EAAM,MAC9B,CACA,OAAO,CACT,EAGM,EAAiB,MACrB,EACA,EACA,EACA,IACgC,CAChC,IAAM,EAAQ,EAAQ,CAAM,EAItB,EAAc,EAA8B,CAChD,MAAO,EACP,QACA,UACA,UAAW,EAAM,MACnB,EAAG,CACD,GAAI,IAAY,IAAA,GAAY,CAAC,EAAI,CAAE,SAAQ,EAC3C,GAAI,EAAa,cAAgB,IAAA,GAAY,CAAC,EAAI,CAAE,YAAa,EAAa,WAAY,EAC1F,GAAI,EAAa,WAAa,IAAA,GAAY,CAAC,EAAI,CAAE,SAAU,EAAa,QAAS,CACnF,CAAC,EAGG,EAAY,EACZ,EAAmB,EACnB,EAEJ,GAAI,CACF,IAAM,EAAU,MAAM,EACpB,EACA,EACA,EACA,EACA,EACC,GAAa,CACZ,EAAY,EAAS,WAAa,EAClC,EAAmB,EAAS,kBAAoB,EAChD,EAAQ,EAAS,OAAS,CAC5B,CACF,EAOA,OANA,EAAY,IAAI,CACd,OAAQ,UACR,QAAS,EAAQ,MACjB,YACA,iBAAkB,EAAQ,MAAM,gBAClC,CAAC,EACM,CACT,OAAS,EAAgB,CAQvB,MAPA,EAAY,IAAI,CACd,OAAQ,EAAe,CAAK,EAC5B,GAAI,IAAU,IAAA,GAAY,CAAC,EAAI,CAAE,QAAS,CAAM,EAChD,YACA,mBACA,OACF,CAAC,EACK,CACR,CACF,EAGM,EAAc,MAClB,EACA,EACA,EACA,EACA,EACA,IAEO,EAAW,QAChB,iBACA,IAAW,IAAA,GAAY,CAAC,EAAI,CAAE,QAAO,EACrC,KAAO,IAAuC,CAG5C,IAAM,EAAW,MAAM,EAAQ,qBAC7B,EACA,EACA,CACE,GAAI,EAAQ,aAAe,IAAA,GAAY,CAAC,EAAI,CAAE,WAAY,EAAQ,UAAW,EAC7E,GAAI,EAAQ,cAAgB,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,EAAQ,WAAY,CAC7E,EACA,EAAM,OACN,EAAY,OACd,EACA,EAAuB,CAAQ,EAG/B,EAAO,CAAE,MAAO,EAAS,OAAQ,CAAC,EAIlC,EAAoB,CAClB,UACA,QACA,GAAI,EAAQ,aAAe,IAAA,GAAY,CAAC,EAAI,CAAE,WAAY,EAAQ,UAAW,EAC7E,aACA,GAAI,IAAkB,IAAA,GAAY,CAAC,EAAI,CAAE,eAAc,CACzD,EAAG,CAAQ,EAIX,IAAM,EAAiD,MAAqC,EAAM,MAAM,EAClG,EAAY,IAAI,IAChB,EAAU,IAAU,IAAA,GACtB,EACA,MAAM,EAAiB,EAAO,EAAO,EAAU,EAAS,EAAS,CAAS,EAC9E,EAAO,CAAE,UAAW,EAAM,OAAS,EAAQ,MAAO,CAAC,EAEnD,IAAM,EAAS,EAA2B,EAAU,CAClD,GAAI,IAAgB,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,CAAY,EAC3D,OAAQ,EAAM,OACd,GAAI,EAAY,UAAY,IAAA,GAAY,CAAC,EAAI,CAAE,QAAS,EAAY,OAAQ,CAC9E,CAAC,EAGG,EAAgB,EAGd,EAAW,IAAI,IA0FrB,IAAI,MAxFkB,EACpB,EAAqB,EAAS,EAAS,MAAM,EAC7C,KAAO,IAAwB,CAC7B,IAAM,EAAiC,CACrC,WACA,QACA,UACA,MAAO,EAAK,MACZ,GAAI,EAAQ,aAAe,IAAA,GAAY,CAAC,EAAI,CAAE,WAAY,EAAQ,UAAW,EAC7E,aACA,OAAQ,EAAM,MAChB,EAGM,EAAmB,EAAY,WAAW,CAC9C,WAAY,EAAK,WACjB,UAAW,EAAK,MAAM,OACtB,UAAW,EAAK,MAChB,gBAAiB,EAAK,gBACtB,GAAI,EAAQ,aAAe,IAAA,GAAY,CAAC,EAAI,CAAE,WAAY,EAAQ,UAAW,CAC/E,CAAC,EACD,GAAI,CAGF,IAAM,EAAU,MAAM,EAAO,SAC3B,EAAK,WACL,EACA,EAAiB,OACnB,EACA,GAAiB,EAAQ,SACzB,EAAO,CAAE,iBAAkB,CAAc,CAAC,EAC1C,IAAM,EAAQ,EAAQ,MACtB,GAAI,EAAM,QAAU,SAGlB,MAAM,EAAM,MAEd,GAAI,EAAM,QAAU,YAIlB,MAAM,IAAI,EACR,mBAAmB,EAAK,WAAW,kCACnC,EAAsB,mBACtB,CAAE,WAAU,QAAO,YAAa,CAAC,GAAG,EAAQ,WAAW,CAAE,CAC3D,EAGF,IAAM,EAAU,EAAM,QAItB,EAAoB,EAAS,CAAE,SAAQ,CAAC,EAExC,IAAM,EAAsB,CAAC,EAC7B,IAAK,IAAM,KAAU,EACnB,EAAQ,EAAO,OAAS,EAAO,OAC3B,EAAO,YAAc,IAAM,EAAU,KAAK,EAAO,KAAK,EAY5D,GATA,EAAS,IAAI,EAAK,WAAY,CAC5B,SAAU,CACR,YAAa,EAAQ,YACrB,SAAU,EAAQ,SAClB,GAAI,EAAQ,QAAU,IAAA,GAAY,CAAC,EAAI,CAAE,MAAO,EAAQ,KAAM,CAChE,EACA,SAAU,CAAC,GAAG,EAAQ,SAAU,GAAG,EAAmB,EAAY,CAAS,CAAC,CAC9E,CAAC,EAEG,IAAU,IAAA,GACZ,IAAK,IAAM,KAAU,EAAS,CAC5B,IAAM,EAAM,EAAU,IAAI,EAAO,KAAK,EAClC,IAAQ,IAAA,IACZ,MAAM,EAAyB,EAAO,EAAK,CACzC,OAAQ,EAAO,OACf,MAAO,EAAS,OAClB,CAAC,CACH,CAEF,EAAiB,IAAI,SAAS,CAChC,OAAS,EAAgB,CAEvB,MADA,EAAiB,IAAI,EAAe,CAAK,EAAG,CAAK,EAC3C,CACR,CACF,EACA,CAAE,cAAa,OAAQ,EAAM,MAAO,CACtC,EAAA,CAEY,QACV,MAAM,IAAI,EACR,2DACA,EAAsB,QACtB,CAAE,WAAU,QAAO,MAAO,EAAS,OAAQ,CAC7C,EAGF,IAAM,EAAU,CAAC,GAAG,EAAS,KAAK,CAAC,CAAC,CAAC,MAAM,EAAM,IAAU,EAAO,CAAK,EACjE,EAAQ,EAAwB,CACpC,WAAY,EAAM,OAClB,QAAS,EAAQ,IAAI,GAAS,EAAS,IAAI,CAAK,CAAC,CAAE,QAAQ,CAC7D,CAAC,EACK,EAAW,CACf,GAAG,EAAQ,QAAQ,GAAS,EAAS,IAAI,CAAK,CAAC,CAAE,QAAQ,EACzD,GAAG,EAAM,QACX,EAeA,MAAO,CACL,QAdc,EAAQ,KAAK,EAAQ,IAAU,CAC7C,GAAI,IAAW,IAAA,GAAW,OAAO,EAKjC,MAAM,IAAI,EACR,iDACA,EAAsB,mBACtB,CAAE,WAAU,QAAO,YAAa,CAAC,CAAK,CAAE,CAC1C,CACF,CAGQ,EACN,MAAO,EAAS,QAChB,WACA,MAAO,EAAM,OACb,SAAU,OAAO,OAAO,CAAQ,CAClC,CACF,CACF,EAGF,OAAO,OAAO,OAA6B,CACzC,MAAM,MAAM,EAAgD,CAG1D,IAAM,EAAU,MAAM,EACpB,EAAM,QACN,CAAC,EAAM,KAAK,EACZ,EAAM,OACN,EAAM,eAAiB,EAAQ,aACjC,EACA,OAAO,OAAO,OAAwB,CACpC,UAAW,EAAQ,QAAQ,GAC3B,MAAO,EAAQ,MACf,QAAS,EAAQ,SAAS,QAC1B,MAAO,EAAQ,MACf,SAAU,EAAQ,QACpB,CAAC,CACH,EAEA,MAAM,UAAU,EAAqD,CACnE,IAAM,EAAU,MAAM,EACpB,EAAM,QACN,EAAM,OACN,EAAM,OACN,EAAM,eAAiB,EAAQ,aACjC,EACA,OAAO,OAAO,OAA4B,CACxC,WAAY,OAAO,OAAO,EAAQ,OAAO,EACzC,MAAO,EAAQ,MACf,QAAS,EAAQ,SAAS,QAC1B,MAAO,EAAQ,MACf,SAAU,EAAQ,QACpB,CAAC,CACH,CACF,CAAC,CACH"}

package/dist/composition/embedding/limiter.js

@@ -0,0 +1,2 @@
+import{EMBEDDING_ERROR_CODES as e,EmbeddingError as t}from"../../embedding/errors.js";function n(n){if(n===void 0)return 4;if(!Number.isInteger(n)||n<=0)throw new t(`embedding concurrency must be a positive integer`,e.CONFIGURATION_INVALID);return n}async function r(e,t,r){let o=n(r?.concurrency),s=r?.signal,c=()=>s?.aborted===!0,l=i(e),u=0,d=!1,f=!1,p,m=Promise.resolve(),h=async()=>{for(;;){if(p!==void 0||f)return;if(c()){d=!0;return}let e=m.then(async()=>{if(p!==void 0||f||c())return;let e=await l.next();if(c()){d=!0;return}if(p===void 0){if(e.done===!0){f=!0;return}return{batch:e.value}}});m=e.then(()=>void 0,()=>void 0);let n;try{n=await e}catch(e){p??={error:e};return}if(n!==void 0){if(p!==void 0)return;if(c()){d=!0;return}try{await t(n.batch,u++)}catch(e){p??={error:e};return}}}},g=[];for(let e=0;e<o;e+=1)g.push(h());if(await Promise.all(g),p!==void 0)throw await a(l),p.error;return d||!f?(await a(l),{started:u,aborted:d||!f}):{started:u,aborted:!1}}function i(n){let r=n[Symbol.asyncIterator];if(typeof r==`function`)return r.call(n);let i=n[Symbol.iterator];if(typeof i==`function`)return i.call(n);throw new t(`embedding batch source must be iterable`,e.CONFIGURATION_INVALID)}async function a(e){try{await e.return?.(void 0)}catch{}}export{n as resolveEmbeddingConcurrency,r as runBatchesWithConcurrency};
+//# sourceMappingURL=limiter.js.map