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

package/dist/composition/team/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","names":[],"sources":["../../../src/composition/team/runtime.ts"],"sourcesContent":["import { AgentTeam } from '../../agent/team/team.ts'\nimport type { AgentSessionTeamPort, AgentSessionTeamAttachmentOptions } from '../../agent/define/session/types.ts'\nimport type {\n  AgentTeamEvent, LinkAgentOptions, LinkedAgentResult, LinkedAgentSendInput,\n  SendAgentMessageRequest, SendAgentMessageResult,\n} from '../../agent/team/types.ts'\nimport { memberName } from '../../agent/team/common.ts'\nimport { AgentSdkError } from '../../errors/agent-sdk-error.ts'\nimport { NOT_APPLICABLE_USAGE_COVERAGE } from '../../support-safe/error.ts'\nimport { atDeadline, BoundaryFailure } from '../lifecycle/bounded.ts'\nimport type { RuntimeAgentHost } from '../agent/session.ts'\nimport { createRuntimeTeamMemberSession, preflightRuntimeTeamMember } from '../agent/session.ts'\nimport { captureInvocationOptions } from '../agent/options.ts'\nimport { boundedText, capturedMethod, objectValue, optionalAbortSignal, ownData } from '../common/data.ts'\nimport { COMPOSITION_LIMITS } from '../common/config.ts'\nimport { captureCloseSignal } from '../runtime/config.ts'\nimport { captureRuntimeTeamOptions } from './options.ts'\nimport { RUNTIME_TEAM_ERROR_CODES, RUNTIME_TEAM_LIMITS } from './config.ts'\nimport { TEAM_TOOL_NAMES } from '../../agent/team/common.ts'\nimport type {\n  RuntimeAgentTeam, RuntimeAgentTeamEvent, RuntimeTeamRegistration,\n} from './types.ts'\nimport type { RuntimeAgentInvocationOptions } from '../agent/types.ts'\nimport type { RuntimeAgentSession } from '../agent/types.ts'\nimport type { TeamSessionPort } from '../../agent/team/contracts.ts'\n\nclass RuntimeTeamValue implements RuntimeTeamRegistration {\n  readonly id: string\n  readonly view: RuntimeAgentTeam\n  private closing: Promise<void> | undefined\n  private draining: Promise<void> | undefined\n  private closed = false\n  private readonly activeRuns = new Set<Promise<void>>()\n\n  constructor(\n    private readonly host: RuntimeAgentHost,\n    private readonly team: AgentTeam,\n    private readonly sessions: Map<string, RuntimeAgentSession>,\n    memberNames: readonly string[],\n    private readonly onClosed: (registration: RuntimeTeamRegistration) => void,\n    private readonly lifecycle: AbortController,\n  ) {\n    this.id = team.id\n    this.view = Object.freeze({\n      id: team.id, memberNames,\n      linkAgent: (options: LinkAgentOptions) => this.linkAgent(options),\n      sendMessage: (request: SendAgentMessageRequest) => this.sendMessage(request),\n      session: (name: string) => this.session(name),\n      run: (name: string, input: string, options?: RuntimeAgentInvocationOptions) => this.run(name, input, options),\n      close: (options?: { readonly signal?: AbortSignal }) => this.close(options),\n    })\n  }\n\n  private assertActive(): void {\n    this.host.operations.assertActive()\n    if (this.closed) throw new AgentSdkError('Runtime team is closed', RUNTIME_TEAM_ERROR_CODES.closed)\n  }\n\n  private session(name: string) {\n    this.assertActive()\n    const value = this.sessions.get(memberName(name))\n    if (value === undefined) throw new AgentSdkError('Runtime team member is unavailable', RUNTIME_TEAM_ERROR_CODES.invalid)\n    return value\n  }\n\n  private run(name: string, input: string, rawOptions?: Parameters<RuntimeAgentTeam['run']>[2]) {\n    this.assertActive()\n    if (typeof input !== 'string') throw new TypeError('Runtime team input must be a string')\n    const options = captureInvocationOptions(rawOptions)\n    const session = this.session(name)\n    const signal = options.signal === undefined\n      ? this.lifecycle.signal\n      : AbortSignal.any([options.signal, this.lifecycle.signal])\n    const running = this.host.operations.execute('team-operation', {\n      signal,\n    }, lease => session.run(input, { ...options, signal: lease.signal }))\n    const settled = running.then(() => undefined, () => undefined)\n    this.activeRuns.add(settled)\n    void settled.finally(() => this.activeRuns.delete(settled))\n    return running\n  }\n\n  private sendMessage(raw: SendAgentMessageRequest): Promise<SendAgentMessageResult> {\n    this.assertActive()\n    const request = captureMessage(raw)\n    return this.host.operations.execute('team-operation', {\n      ...(request.signal === undefined ? {} : { signal: request.signal }),\n    }, lease => this.team.sendMessage({ ...request, signal: lease.signal }))\n  }\n\n  private linkAgent(raw: LinkAgentOptions): () => void {\n    this.assertActive()\n    const options = captureLink(raw, this.host, this.team.id)\n    const unlink = this.team.linkAgent(options)\n    let active = true\n    return () => {\n      if (!active) return\n      unlink()\n      active = false\n    }\n  }\n\n  private close(raw?: { readonly signal?: AbortSignal }): Promise<void> {\n    if (this.closing !== undefined) return this.closing\n    const signal = captureCloseSignal(raw)\n    let resolve!: () => void\n    let reject!: (error: unknown) => void\n    this.closing = new Promise<void>((done, fail) => { resolve = done; reject = fail })\n    const shared = this.closing\n    void shared.catch(() => undefined)\n    this.closed = true\n    try {\n      this.lifecycle.abort(new Error('Runtime agent team is closing'))\n      const runs = [...this.activeRuns]\n      const sessions = [...this.sessions.values()]\n      const draining = Promise.all([\n        this.team.dispose(new Error('Runtime agent team is closing')),\n        Promise.all(runs),\n        Promise.all(sessions.map(session => session.whenIdle())),\n      ]).then(() => undefined).finally(() => {\n        // The runtime retains this lightweight registration for close reporting.\n        // Member sessions can contain full histories and must not remain reachable\n        // from a long-lived runtime after the team has settled.\n        this.sessions.clear()\n      })\n      this.draining = draining\n      void draining.then(() => this.onClosed(this), () => undefined)\n      void atDeadline(\n        this.host.resources, this.host.resources.platform.monotonicNow() + RUNTIME_TEAM_LIMITS.closeTimeoutMs,\n        () => draining, signal,\n      ).then(resolve, error => {\n        const aborted = error instanceof BoundaryFailure && error.reason === 'aborted'\n        reject(new AgentSdkError(\n          aborted ? 'Runtime team close wait was aborted' : 'Runtime team did not close within 30000ms',\n          aborted ? 'TEAM_CLOSE_ABORTED' : 'TEAM_DISPOSE_TIMEOUT',\n        ))\n      })\n    } catch (error) { reject(error) }\n    return shared\n  }\n\n  async closeForRuntime(deadlineAt: number) {\n    try {\n      // Cancellation and disposal must start even when quiescence used the entire deadline.\n      this.close()\n      await atDeadline(this.host.resources, deadlineAt, () => this.draining)\n      return Object.freeze({ kind: 'agent-team' as const, id: this.team.id, status: 'closed' as const })\n    } catch {\n      return Object.freeze({ kind: 'agent-team' as const, id: this.team.id, status: 'timed-out' as const,\n        error: Object.freeze({ code: 'CAPABILITY_CLEANUP_TIMEOUT', stage: 'team-cleanup',\n          message: 'Runtime agent team did not close before the shared deadline' }) })\n    }\n  }\n}\n\nexport function createRuntimeAgentTeam(\n  host: RuntimeAgentHost,\n  raw: unknown,\n  onClosed: (registration: RuntimeTeamRegistration) => void = () => undefined,\n): RuntimeTeamRegistration {\n  host.operations.assertActive()\n  const options = captureRuntimeTeamOptions(raw)\n  for (const member of options.members) {\n    preflightRuntimeTeamMember(host, member.agent, member.session,\n      member.tools === false ? [] : Object.values(TEAM_TOOL_NAMES))\n  }\n  const pendingEvents: RuntimeAgentTeamEvent[] = []\n  const lifecycle = new AbortController()\n  let emit = (event: RuntimeAgentTeamEvent): void => { pendingEvents.push(event) }\n  const team = new AgentTeam({ id: options.id, maxMembers: RUNTIME_TEAM_LIMITS.members,\n    ...(options.maxMessages === undefined ? {} : { maxMessages: options.maxMessages }),\n    ...(options.maxMessageBytes === undefined ? {} : { maxMessageBytes: options.maxMessageBytes }),\n    ...(options.operationTimeoutMs === undefined ? {} : { operationTimeoutMs: options.operationTimeoutMs }),\n    ...(options.observerTimeoutMs === undefined ? {} : { observerTimeoutMs: options.observerTimeoutMs }),\n    onEvent: event => {\n      // The composition owns additional direct runs and compactions; its close\n      // event must wait for those too, not just the control-plane wake tasks.\n      if (event.type !== 'team-disposed') emit(projectEvent(event))\n    },\n  }, signal => {\n    const lease = host.operations.acquire('team-operation', { signal })\n    return () => lease.settle()\n  })\n  const sessions = new Map<string, RuntimeAgentSession>()\n  const ports = new Map<string, TeamSessionPort>()\n  const attachments: AgentSessionTeamAttachmentOptions[] = []\n  const stagingTeam: AgentSessionTeamPort = Object.freeze({\n    attach(_session: Parameters<AgentSessionTeamPort['attach']>[0], attachment: AgentSessionTeamAttachmentOptions = {}) {\n      attachments.push(attachment)\n    },\n    toolsFor: (sender: string) => team.toolsFor(sender),\n    instructionsFor: (name: string) => team.instructionsFor(name),\n  })\n  try {\n    for (const member of options.members) {\n      const created = createRuntimeTeamMemberSession(host, member.agent, member.session, {\n        team: stagingTeam, name: member.name, role: member.role,\n        ...(member.description === undefined ? {} : { description: member.description }),\n        ...(member.instructions === undefined ? {} : { instructions: member.instructions }),\n        ...(member.tools === undefined ? {} : { tools: member.tools }),\n      }, lifecycle.signal)\n      sessions.set(member.name, created.view)\n      ports.set(member.name, created.port)\n    }\n    for (const attachment of attachments) {\n      const name = memberName(attachment.name)\n      const port = ports.get(name)\n      if (port === undefined) throw new Error(`Runtime team session '${name}' was not staged`)\n      team.attach(port, attachment)\n    }\n  } catch (error) {\n    lifecycle.abort(new Error('Runtime agent team construction failed'))\n    void team.dispose().catch(() => undefined)\n    throw error\n  }\n  emit = event => {\n    // Physical transport work can outlive bounded runtime shutdown.\n    if (host.operations.status !== 'closed') options.onEvent?.(event)\n  }\n  for (const event of pendingEvents) emit(event)\n  return new RuntimeTeamValue(\n    host, team, sessions, Object.freeze([...sessions.keys()]), registration => {\n      onClosed(registration)\n      try { emit(Object.freeze({ type: 'team-closed', teamId: team.id })) }\n      catch { /* Lifecycle observers cannot change cleanup results. */ }\n    }, lifecycle,\n  )\n}\n\nfunction captureMessage(raw: unknown): SendAgentMessageRequest {\n  const source = objectValue(raw)\n  const allowed = new Set(['from', 'target', 'message', 'delivery', 'signal'])\n  if (Reflect.ownKeys(source).some(key => typeof key !== 'string' || !allowed.has(key))) {\n    throw new TypeError('Runtime team message contains unsupported fields')\n  }\n  const signal = optionalAbortSignal(ownData(source, 'signal', false))\n  const delivery = ownData(source, 'delivery', false)\n  return Object.freeze({ from: memberName(ownData(source, 'from')), target: memberName(ownData(source, 'target')),\n    message: ownData(source, 'message') as SendAgentMessageRequest['message'],\n    ...(delivery === undefined ? {} : { delivery: delivery as NonNullable<SendAgentMessageRequest['delivery']> }),\n    ...(signal === undefined ? {} : { signal }) })\n}\n\nfunction captureLink(raw: unknown, host: RuntimeAgentHost, teamId: string): LinkAgentOptions {\n  const source = objectValue(raw)\n  const name = memberName(ownData(source, 'name'))\n  const descriptionValue = ownData(source, 'description', false)\n  const transport = objectValue(ownData(source, 'transport'))\n  const protocol = boundedText(ownData(transport, 'protocol'), COMPOSITION_LIMITS.identityBytes)\n  const agentId = boundedText(ownData(transport, 'agentId'), COMPOSITION_LIMITS.identityBytes)\n  const send = capturedMethod<[LinkedAgentSendInput], Promise<LinkedAgentResult>>(transport, 'send')\n  const logger = host.observation.logger({ scope: 'sdk.team.transport', fields: { teamId, member: name } })\n  return Object.freeze({ name,\n    ...(descriptionValue === undefined ? {} : {\n      description: boundedText(descriptionValue, 8 * 1_024),\n    }),\n    transport: Object.freeze({ protocol, agentId,\n      send: (input: LinkedAgentSendInput) => send({ ...input, logger }) }),\n  })\n}\n\nfunction projectEvent(event: AgentTeamEvent): RuntimeAgentTeamEvent {\n  if (event.type === 'member-attached') return Object.freeze({ type: event.type, member: event.member.name })\n  if (event.type === 'member-linked') return Object.freeze({ type: event.type, member: event.member.name,\n    protocol: event.member.protocol ?? 'unknown' })\n  if (event.type === 'message-accepted') return Object.freeze({ type: event.type,\n    messageId: event.message.id, target: event.message.target })\n  if (event.type === 'member-run-start' || event.type === 'member-run-end') return Object.freeze(event)\n  if (event.type === 'member-run-error') return Object.freeze({ type: event.type, member: event.member,\n    error: Object.freeze({ code: 'TEAM_MEMBER_RUN_FAILED', stage: 'team-operation',\n      message: 'Runtime team member operation failed', usageCoverage: NOT_APPLICABLE_USAGE_COVERAGE,\n      possiblyBilledAttemptsWithoutUsage: 0 }) })\n  if (event.type === 'team-disposed') return Object.freeze({ type: 'team-closed', teamId: event.teamId })\n  return Object.freeze({ type: 'member-run-end', member: event.member })\n}\n"],"mappings":"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"}
+{"version":3,"file":"runtime.js","names":[],"sources":["../../../src/composition/team/runtime.ts"],"sourcesContent":["import { AgentTeam } from '../../agent/team/team.ts'\nimport type { AgentSessionTeamPort, AgentSessionTeamAttachmentOptions } from '../../agent/define/session/types.ts'\nimport type {\n  AgentTeamEvent, LinkAgentOptions, LinkedAgentResult, LinkedAgentSendInput,\n  SendAgentMessageRequest, SendAgentMessageResult,\n} from '../../agent/team/types.ts'\nimport { memberName } from '../../agent/team/common.ts'\nimport { AgentSdkError } from '../../errors/agent-sdk-error.ts'\nimport { NOT_APPLICABLE_USAGE_COVERAGE } from '../../support-safe/error.ts'\nimport { atDeadline, BoundaryFailure } from '../lifecycle/bounded.ts'\nimport type { RuntimeAgentHost } from '../agent/session.ts'\nimport { createRuntimeTeamMemberSession, preflightRuntimeTeamMember } from '../agent/session.ts'\nimport { captureInvocationOptions } from '../agent/options.ts'\nimport { boundedText, capturedMethod, objectValue, optionalAbortSignal, ownData } from '../common/data.ts'\nimport { COMPOSITION_LIMITS } from '../common/config.ts'\nimport { captureCloseSignal } from '../runtime/config.ts'\nimport { captureRuntimeTeamOptions } from './options.ts'\nimport { RUNTIME_TEAM_ERROR_CODES, RUNTIME_TEAM_LIMITS } from './config.ts'\nimport { TEAM_TOOL_NAMES } from '../../agent/team/common.ts'\nimport type {\n  RuntimeAgentTeam, RuntimeAgentTeamEvent, RuntimeTeamRegistration,\n} from './types.ts'\nimport type { RuntimeAgentInvocationOptions } from '../agent/types.ts'\nimport type { RuntimeAgentSession } from '../agent/types.ts'\nimport type { TeamSessionPort } from '../../agent/team/contracts.ts'\n\nclass RuntimeTeamValue implements RuntimeTeamRegistration {\n  readonly id: string\n  readonly view: RuntimeAgentTeam\n  private closing: Promise<void> | undefined\n  private draining: Promise<void> | undefined\n  private closed = false\n  private readonly activeRuns = new Set<Promise<void>>()\n\n  constructor(\n    private readonly host: RuntimeAgentHost,\n    private readonly team: AgentTeam,\n    private readonly sessions: Map<string, RuntimeAgentSession>,\n    memberNames: readonly string[],\n    private readonly onClosed: (registration: RuntimeTeamRegistration) => void,\n    private readonly lifecycle: AbortController,\n  ) {\n    this.id = team.id\n    this.view = Object.freeze({\n      id: team.id, memberNames,\n      linkAgent: (options: LinkAgentOptions) => this.linkAgent(options),\n      sendMessage: (request: SendAgentMessageRequest) => this.sendMessage(request),\n      session: (name: string) => this.session(name),\n      run: (name: string, input: string, options?: RuntimeAgentInvocationOptions) => this.run(name, input, options),\n      close: (options?: { readonly signal?: AbortSignal }) => this.close(options),\n    })\n  }\n\n  private assertActive(): void {\n    this.host.operations.assertActive()\n    if (this.closed) throw new AgentSdkError('Runtime team is closed', RUNTIME_TEAM_ERROR_CODES.closed)\n  }\n\n  private session(name: string) {\n    this.assertActive()\n    const value = this.sessions.get(memberName(name))\n    if (value === undefined) throw new AgentSdkError('Runtime team member is unavailable', RUNTIME_TEAM_ERROR_CODES.invalid)\n    return value\n  }\n\n  private run(name: string, input: string, rawOptions?: Parameters<RuntimeAgentTeam['run']>[2]) {\n    this.assertActive()\n    if (typeof input !== 'string') throw new TypeError('Runtime team input must be a string')\n    const options = captureInvocationOptions(rawOptions)\n    const session = this.session(name)\n    const signal = options.signal === undefined\n      ? this.lifecycle.signal\n      : AbortSignal.any([options.signal, this.lifecycle.signal])\n    const running = this.host.operations.execute('team-operation', {\n      signal,\n    }, lease => session.run(input, { ...options, signal: lease.signal }))\n    const settled = running.then(() => undefined, () => undefined)\n    this.activeRuns.add(settled)\n    void settled.finally(() => this.activeRuns.delete(settled))\n    return running\n  }\n\n  private sendMessage(raw: SendAgentMessageRequest): Promise<SendAgentMessageResult> {\n    this.assertActive()\n    const request = captureMessage(raw)\n    return this.host.operations.execute('team-operation', {\n      ...(request.signal === undefined ? {} : { signal: request.signal }),\n    }, lease => this.team.sendMessage({ ...request, signal: lease.signal }))\n  }\n\n  private linkAgent(raw: LinkAgentOptions): () => void {\n    this.assertActive()\n    const options = captureLink(raw, this.host, this.team.id)\n    const unlink = this.team.linkAgent(options)\n    let active = true\n    return () => {\n      if (!active) return\n      unlink()\n      active = false\n    }\n  }\n\n  private close(raw?: { readonly signal?: AbortSignal }): Promise<void> {\n    if (this.closing !== undefined) return this.closing\n    const signal = captureCloseSignal(raw)\n    let resolve!: () => void\n    let reject!: (error: unknown) => void\n    this.closing = new Promise<void>((done, fail) => { resolve = done; reject = fail })\n    const shared = this.closing\n    void shared.catch(() => undefined)\n    this.closed = true\n    try {\n      this.lifecycle.abort(new Error('Runtime agent team is closing'))\n      const runs = [...this.activeRuns]\n      const sessions = [...this.sessions.values()]\n      const draining = Promise.all([\n        this.team.dispose(new Error('Runtime agent team is closing')),\n        Promise.all(runs),\n        Promise.all(sessions.map(session => session.whenIdle())),\n      ]).then(() => undefined).finally(() => {\n        // The runtime retains this lightweight registration for close reporting.\n        // Member sessions can contain full histories and must not remain reachable\n        // from a long-lived runtime after the team has settled.\n        this.sessions.clear()\n      })\n      this.draining = draining\n      void draining.then(() => this.onClosed(this), () => undefined)\n      void atDeadline(\n        this.host.resources, this.host.resources.platform.monotonicNow() + RUNTIME_TEAM_LIMITS.closeTimeoutMs,\n        () => draining, signal,\n      ).then(resolve, error => {\n        const aborted = error instanceof BoundaryFailure && error.reason === 'aborted'\n        reject(new AgentSdkError(\n          aborted ? 'Runtime team close wait was aborted' : 'Runtime team did not close within 30000ms',\n          aborted ? 'TEAM_CLOSE_ABORTED' : 'TEAM_DISPOSE_TIMEOUT',\n        ))\n      })\n    } catch (error) { reject(error) }\n    return shared\n  }\n\n  async closeForRuntime(deadlineAt: number) {\n    try {\n      // Cancellation and disposal must start even when quiescence used the entire deadline.\n      this.close()\n      await atDeadline(this.host.resources, deadlineAt, () => this.draining)\n      return Object.freeze({ kind: 'agent-team' as const, id: this.team.id, status: 'closed' as const })\n    } catch {\n      return Object.freeze({ kind: 'agent-team' as const, id: this.team.id, status: 'timed-out' as const,\n        error: Object.freeze({ code: 'CAPABILITY_CLEANUP_TIMEOUT', stage: 'team-cleanup',\n          message: 'Runtime agent team did not close before the shared deadline' }) })\n    }\n  }\n}\n\nexport function createRuntimeAgentTeam(\n  host: RuntimeAgentHost,\n  raw: unknown,\n  onClosed: (registration: RuntimeTeamRegistration) => void = () => undefined,\n): RuntimeTeamRegistration {\n  host.operations.assertActive()\n  const options = captureRuntimeTeamOptions(raw)\n  for (const member of options.members) {\n    preflightRuntimeTeamMember(host, member.agent, member.session,\n      member.tools === false ? [] : Object.values(TEAM_TOOL_NAMES))\n  }\n  const pendingEvents: RuntimeAgentTeamEvent[] = []\n  const lifecycle = new AbortController()\n  let emit = (event: RuntimeAgentTeamEvent): void => { pendingEvents.push(event) }\n  const team = new AgentTeam({ id: options.id, maxMembers: RUNTIME_TEAM_LIMITS.members,\n    ...(options.maxMessages === undefined ? {} : { maxMessages: options.maxMessages }),\n    ...(options.maxMessageBytes === undefined ? {} : { maxMessageBytes: options.maxMessageBytes }),\n    ...(options.operationTimeoutMs === undefined ? {} : { operationTimeoutMs: options.operationTimeoutMs }),\n    ...(options.observerTimeoutMs === undefined ? {} : { observerTimeoutMs: options.observerTimeoutMs }),\n    onEvent: event => {\n      // The composition owns additional direct runs and compactions; its close\n      // event must wait for those too, not just the control-plane wake tasks.\n      if (event.type !== 'team-disposed') emit(projectEvent(event))\n    },\n    ...(options.onAgentEvent === undefined ? {} : { onAgentEvent: options.onAgentEvent }),\n  }, signal => {\n    const lease = host.operations.acquire('team-operation', { signal })\n    return () => lease.settle()\n  })\n  const sessions = new Map<string, RuntimeAgentSession>()\n  const ports = new Map<string, TeamSessionPort>()\n  const attachments: AgentSessionTeamAttachmentOptions[] = []\n  const stagingTeam: AgentSessionTeamPort = Object.freeze({\n    attach(_session: Parameters<AgentSessionTeamPort['attach']>[0], attachment: AgentSessionTeamAttachmentOptions = {}) {\n      attachments.push(attachment)\n    },\n    toolsFor: (sender: string) => team.toolsFor(sender),\n    instructionsFor: (name: string) => team.instructionsFor(name),\n  })\n  try {\n    for (const member of options.members) {\n      const created = createRuntimeTeamMemberSession(host, member.agent, member.session, {\n        team: stagingTeam, name: member.name, role: member.role,\n        ...(member.description === undefined ? {} : { description: member.description }),\n        ...(member.instructions === undefined ? {} : { instructions: member.instructions }),\n        ...(member.tools === undefined ? {} : { tools: member.tools }),\n      }, lifecycle.signal)\n      sessions.set(member.name, created.view)\n      ports.set(member.name, created.port)\n    }\n    for (const attachment of attachments) {\n      const name = memberName(attachment.name)\n      const port = ports.get(name)\n      if (port === undefined) throw new Error(`Runtime team session '${name}' was not staged`)\n      team.attach(port, attachment)\n    }\n  } catch (error) {\n    lifecycle.abort(new Error('Runtime agent team construction failed'))\n    void team.dispose().catch(() => undefined)\n    throw error\n  }\n  emit = event => {\n    // Physical transport work can outlive bounded runtime shutdown.\n    if (host.operations.status !== 'closed') options.onEvent?.(event)\n  }\n  for (const event of pendingEvents) emit(event)\n  return new RuntimeTeamValue(\n    host, team, sessions, Object.freeze([...sessions.keys()]), registration => {\n      onClosed(registration)\n      try { emit(Object.freeze({ type: 'team-closed', teamId: team.id })) }\n      catch { /* Lifecycle observers cannot change cleanup results. */ }\n    }, lifecycle,\n  )\n}\n\nfunction captureMessage(raw: unknown): SendAgentMessageRequest {\n  const source = objectValue(raw)\n  const allowed = new Set(['from', 'target', 'message', 'delivery', 'signal'])\n  if (Reflect.ownKeys(source).some(key => typeof key !== 'string' || !allowed.has(key))) {\n    throw new TypeError('Runtime team message contains unsupported fields')\n  }\n  const signal = optionalAbortSignal(ownData(source, 'signal', false))\n  const delivery = ownData(source, 'delivery', false)\n  return Object.freeze({ from: memberName(ownData(source, 'from')), target: memberName(ownData(source, 'target')),\n    message: ownData(source, 'message') as SendAgentMessageRequest['message'],\n    ...(delivery === undefined ? {} : { delivery: delivery as NonNullable<SendAgentMessageRequest['delivery']> }),\n    ...(signal === undefined ? {} : { signal }) })\n}\n\nfunction captureLink(raw: unknown, host: RuntimeAgentHost, teamId: string): LinkAgentOptions {\n  const source = objectValue(raw)\n  const name = memberName(ownData(source, 'name'))\n  const descriptionValue = ownData(source, 'description', false)\n  const transport = objectValue(ownData(source, 'transport'))\n  const protocol = boundedText(ownData(transport, 'protocol'), COMPOSITION_LIMITS.identityBytes)\n  const agentId = boundedText(ownData(transport, 'agentId'), COMPOSITION_LIMITS.identityBytes)\n  const send = capturedMethod<[LinkedAgentSendInput], Promise<LinkedAgentResult>>(transport, 'send')\n  const logger = host.observation.logger({ scope: 'sdk.team.transport', fields: { teamId, member: name } })\n  return Object.freeze({ name,\n    ...(descriptionValue === undefined ? {} : {\n      description: boundedText(descriptionValue, 8 * 1_024),\n    }),\n    transport: Object.freeze({ protocol, agentId,\n      send: (input: LinkedAgentSendInput) => send({ ...input, logger }) }),\n  })\n}\n\nfunction projectEvent(event: AgentTeamEvent): RuntimeAgentTeamEvent {\n  if (event.type === 'member-attached') return Object.freeze({ type: event.type, member: event.member.name })\n  if (event.type === 'member-linked') return Object.freeze({ type: event.type, member: event.member.name,\n    protocol: event.member.protocol ?? 'unknown' })\n  if (event.type === 'message-accepted') return Object.freeze({ type: event.type,\n    messageId: event.message.id, target: event.message.target })\n  if (event.type === 'member-run-start' || event.type === 'member-run-end') return Object.freeze(event)\n  if (event.type === 'member-run-error') return Object.freeze({ type: event.type, member: event.member,\n    error: Object.freeze({ code: 'TEAM_MEMBER_RUN_FAILED', stage: 'team-operation',\n      message: 'Runtime team member operation failed', usageCoverage: NOT_APPLICABLE_USAGE_COVERAGE,\n      possiblyBilledAttemptsWithoutUsage: 0 }) })\n  if (event.type === 'team-disposed') return Object.freeze({ type: 'team-closed', teamId: event.teamId })\n  return Object.freeze({ type: 'member-run-end', member: event.member })\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 import { SupportSafeError } from "../../support-safe/error.js";
+import { AgentRunEvent } from "../../agent/mode/run-agent.js";
 import { TeamToolAccess } from "../../agent/team/contracts.js";
 import { LinkAgentOptions, SendAgentMessageRequest, SendAgentMessageResult } from "../../agent/team/types.js";
 import { RuntimeAgent, RuntimeAgentInvocationOptions, RuntimeAgentResponse, RuntimeAgentSession, RuntimeAgentSessionOptions } from "../agent/types.js";
@@ -45,6 +46,8 @@ interface RuntimeAgentTeamOptions {
   readonly operationTimeoutMs?: number;
   readonly observerTimeoutMs?: number;
   readonly onEvent?: (event: RuntimeAgentTeamEvent) => void;
+  /** Observe raw model, tool and span events from member wake-up runs. */
+  readonly onAgentEvent?: (member: string, event: AgentRunEvent) => void | Promise<void>;
 }
 interface RuntimeAgentTeam {
   readonly id: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/composition/team/types.ts"],"mappings":";;;;;UASiB;WACN;WACA,OAAO;WACP;WACA;WACA;WACA,kBAAkB;WAClB,UAAU;;KAGT;WACG;WAAkC;;WAClC;WAAgC;WAAyB;;WACzD;WAAmC;WAA4B;;WAC/D;WAAmC;;WACnC;WAAiC;;WACjC;WAAmC;WAAyB,OAAO;;WACnE;WAA8B;;UAE5B;WACN;WACA,kBAAkB;WAClB;WACA;WACA;WACA;WACA,WAAW,OAAO;;UAGZ;WACN;WACA;EACT,UAAU,SAAS;EACnB,YAAY,SAAS,0BAA0B,QAAQ;EACvD,QAAQ,eAAe;EACvB,IAAI,cAAc,eAAe,UAAU,gCAAgC,QAAQ;;EAEnF,MAAM;aAAqB,SAAS;MAAgB"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/composition/team/types.ts"],"mappings":";;;;;;UAUiB;WACN;WACA,OAAO;WACP;WACA;WACA;WACA,kBAAkB;WAClB,UAAU;;KAGT;WACG;WAAkC;;WAClC;WAAgC;WAAyB;;WACzD;WAAmC;WAA4B;;WAC/D;WAAmC;;WACnC;WAAiC;;WACjC;WAAmC;WAAyB,OAAO;;WACnE;WAA8B;;UAE5B;WACN;WACA,kBAAkB;WAClB;WACA;WACA;WACA;WACA,WAAW,OAAO;;WAElB,gBAAgB,gBAAgB,OAAO,yBAAyB;;UAG1D;WACN;WACA;EACT,UAAU,SAAS;EACnB,YAAY,SAAS,0BAA0B,QAAQ;EACvD,QAAQ,eAAe;EACvB,IAAI,cAAc,eAAe,UAAU,gCAAgC,QAAQ;;EAEnF,MAAM;aAAqB,SAAS;MAAgB"}

package/dist/contract/generate-options.d.ts

@@ -7,6 +7,8 @@ import { ModelOutputFormat } from "./output-format.js";
 interface GenerateOptions {
   /** 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';
   /** Registered provider route, selecting the adapter instance. */
   provider: string;
   /**

package/dist/contract/generate-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-options.d.ts","names":[],"sources":["../../src/contract/generate-options.ts"],"mappings":";;;;;;UAYiB;;WAEN;;EAET;;;;;;;;EAQA;;EAEA,kBAAkB;;EAElB,mBAAmB;;EAEnB;;EAEA,iBAAiB;;EAEjB,aAAa;;EAEb,eAAe;EACf;EACA;EACA;;EAEA;EACA,SAAS"}
+{"version":3,"file":"generate-options.d.ts","names":[],"sources":["../../src/contract/generate-options.ts"],"mappings":";;;;;;UAYiB;;WAEN;;WAEA;;EAET;;;;;;;;EAQA;;EAEA,kBAAkB;;EAElB,mBAAmB;;EAEnB;;EAEA,iBAAiB;;EAEjB,aAAa;;EAEb,eAAe;EACf;EACA;EACA;;EAEA;EACA,SAAS"}

package/dist/contract/model-info.d.ts

@@ -13,6 +13,7 @@ interface ProviderInfo {
 interface ModelModalityMap {
   text: 'text';
   image: 'image';
+  document: 'document';
 }
 /** Any declared model input modality. */
 type ModelModality = ModelModalityMap[keyof ModelModalityMap];
@@ -36,7 +37,8 @@ interface ModelInfo {
    * Accepted request modalities.
    *
    * Absent means UNKNOWN; an explicit list that omits a modality is a negative
-   * capability claim, and the registry acts on it by projecting images to text.
+   * capability claim, and the registry acts on it by projecting images and
+   * documents to text.
    */
   inputModalities?: readonly ModelModality[];
   /** Modalities this model route may return, directly or through native tools. */
@@ -46,8 +48,16 @@ interface ModelInfo {
 }
 /** Provider-owned context capacity for one exact model route. */
 interface ModelContext {
-  /** Maximum combined request and response tokens. */
+  /** Operating budget for combined request and response tokens. */
   contextWindow: number;
+  /** Known technical ceiling, independent of the operating budget. */
+  maxContextWindow?: number;
+  /** Provider/model operating default before an explicit override. */
+  defaultContextWindow?: number;
+  /** Input-token threshold above which long-context pricing may apply. */
+  standardPriceInputTokens?: number;
+  /** Advisory warning, not a prediction of actual billed token counts. */
+  pricingWarning?: 'extended-context-may-cost-more';
 }
 /** Display metadata for one adapter-owned reasoning effort. */
 interface ReasoningEffortInfo {

package/dist/contract/model-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-info.d.ts","names":[],"sources":["../../src/contract/model-info.ts"],"mappings":";;;;;UAWiB;;EAEf;;EAEA;;;UAIe;EACf;EACA;;;KAIU,gBAAgB,uBAAuB;;;;;;;;UASlC;;EAEf;;EAEA;;EAEA;;EAEA;;;;;;;EAOA,2BAA2B;;EAE3B,4BAA4B;;EAE5B,uBAAuB;;;UAIR;;EAEf;;;UAIe;;EAEf,IAAI;;EAEJ;;EAEA;;;UAIe;;EAEf,kBAAkB;;;;;EAKlB,gBAAgB;;;UAID,0BAA0B;;EAEzC,UAAU;;EAEV;;EAEA;;EAEA,YAAY;;KAGF;UAEK;WACN,SAAS;WACT;;UAGM;WACN,UAAU;WACV,OAAO;WACP;WACA,iBAAiB;WACjB;WACA;WACA;WACA,QAAQ"}
+{"version":3,"file":"model-info.d.ts","names":[],"sources":["../../src/contract/model-info.ts"],"mappings":";;;;;UAWiB;;EAEf;;EAEA;;;UAIe;EACf;EACA;EACA;;;KAIU,gBAAgB,uBAAuB;;;;;;;;UASlC;;EAEf;;EAEA;;EAEA;;EAEA;;;;;;;;EAQA,2BAA2B;;EAE3B,4BAA4B;;EAE5B,uBAAuB;;;UAIR;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;;UAIe;;EAEf,IAAI;;EAEJ;;EAEA;;;UAIe;;EAEf,kBAAkB;;;;;EAKlB,gBAAgB;;;UAID,0BAA0B;;EAEzC,UAAU;;EAEV;;EAEA;;EAEA,YAAY;;KAGF;UAEK;WACN,SAAS;WACT;;UAGM;WACN,UAAU;WACV,OAAO;WACP;WACA,iBAAiB;WACjB;WACA;WACA;WACA,QAAQ"}

package/dist/embedding/adapter.d.ts

@@ -0,0 +1,104 @@
+import { ModelInvocationContext } from "../observation/report.js";
+import { ProviderInfo } from "../contract/model-info.js";
+import { ResolvedRetryPolicy } from "../contract/retry-policy.js";
+import { EmbeddingProfile, EmbeddingProfileInput, EmbeddingSpaceId } from "./profile.js";
+import { EmbeddingModelInfo, ResolvedEmbeddingModelInfo } from "./catalog.js";
+import { ResolvedEmbeddingBatchLimits } from "./limits.js";
+import { EmbeddingBatchRequest } from "./request.js";
+import { EmbeddingBatchResult } from "./result.js";
+//#region src/embedding/adapter.d.ts
+/** Call configuration handed to {@link EmbeddingAdapter.prepareEmbeddingCall}. */
+interface PrepareEmbeddingOptions extends EmbeddingProfileInput {
+  /** Caller overrides on the catalog's declared batch bounds. */
+  readonly limits?: Partial<ResolvedEmbeddingBatchLimits>;
+}
+/**
+ * One adapter-owned embedding-resolution generation, bound to its dispatch call.
+ *
+ * The embedding counterpart of `PreparedAdapterCall`. Metadata, profile,
+ * `spaceId`, and batch limits all come from the SAME capture as
+ * {@link PreparedEmbeddingCall.embedBatch}, so dimensions can never be checked
+ * against one configuration while the request goes out through another.
+ */
+interface PreparedEmbeddingCall {
+  /** Exact model metadata from the SAME generation as {@link embedBatch}. */
+  readonly model: ResolvedEmbeddingModelInfo;
+  /** The `Embedding_Profile` this generation will actually produce vectors in. */
+  readonly profile: EmbeddingProfile;
+  /** Canonical space identity derived from {@link profile}. */
+  readonly spaceId: EmbeddingSpaceId;
+  /** From `embedding/limits.ts`, never from `composition/`. */
+  readonly limits: ResolvedEmbeddingBatchLimits;
+  /** Dispatch through that generation, without re-reading dynamic connection facts. */
+  embedBatch(batch: EmbeddingBatchRequest, context?: ModelInvocationContext): Promise<EmbeddingBatchResult>;
+}
+/**
+ * Provider-wire adapter for this SDK's embedding vocabulary.
+ *
+ * Contract obligations on implementations:
+ * - exactly one `Provider_Attempt` per `embedBatch()` call; retry is the runtime's;
+ * - honour `batch.signal` promptly;
+ * - carry the original input index onto every returned vector;
+ * - raise a protocol error when a response breaks the contract, never infer;
+ * - include the SDK's attribution headers on every provider request.
+ */
+declare abstract class EmbeddingAdapter {
+  /**
+   * Describe one provider route owned by this adapter.
+   * @param provider - a route this instance was registered under.
+   * @returns detached display metadata whose `id` MUST equal `provider`.
+   */
+  providerInfo(provider: string): ProviderInfo;
+  /**
+   * The retry policy this route owns.
+   * @param _provider - a route this instance was registered under.
+   * @returns a resolved policy, or `undefined` to accept the runtime defaults.
+   */
+  providerRetryPolicy(_provider: string): ResolvedRetryPolicy | undefined;
+  /**
+   * List embedding models this adapter can currently advertise for one route.
+   *
+   * ADVISORY only: absence from this list must never become a reason to reject a
+   * request, because an adapter may accept ids it does not list.
+   * @param _provider - one route owned by this adapter.
+   * @returns discoverable models, in adapter-preferred order.
+   */
+  listEmbeddingModels(_provider: string, _signal?: AbortSignal): Promise<readonly EmbeddingModelInfo[]>;
+  /**
+   * Resolve all metadata available for one exact embedding model.
+   *
+   * NOT request validation — an unknown id resolves to a minimal all-`unknown`
+   * descriptor rather than an error.
+   * @param provider - one route owned by this adapter.
+   * @param model - exact model id.
+   * @param _signal - cancellation; async implementations must settle promptly after abort.
+   */
+  resolveEmbeddingModel(provider: string, model: string, _signal?: AbortSignal): Promise<ResolvedEmbeddingModelInfo>;
+  /**
+   * Declare the `Embedding_Profile` for one concrete call configuration.
+   *
+   * NOT abstract: the default derives a compatibility identity from
+   * `${route}:${modelId}` when the catalog declares none, marks normalization
+   * `'unknown'`, and applies no post-processing. That is what keeps this class at
+   * exactly ONE abstract method. An adapter that owns the provider's real
+   * statement about its embedding space MUST override.
+   */
+  embeddingProfile(model: ResolvedEmbeddingModelInfo, request: EmbeddingProfileInput): EmbeddingProfile;
+  /**
+   * Bind resolved metadata to the exact configuration generation that will dispatch.
+   *
+   * Adapters whose connection facts come from mutable configuration MUST override
+   * and snapshot those facts here.
+   * @returns a frozen single-generation embedding entry point.
+   */
+  prepareEmbeddingCall(provider: string, model: string, options: PrepareEmbeddingOptions, signal?: AbortSignal, context?: ModelInvocationContext): Promise<PreparedEmbeddingCall>;
+  /**
+   * Perform EXACTLY ONE physical embedding request. The only required method.
+   * @param batch - one `Physical_Batch`, already within the resolved limits.
+   * @returns one vector per request item, each carrying its original index.
+   */
+  abstract embedBatch(batch: EmbeddingBatchRequest, context?: ModelInvocationContext): Promise<EmbeddingBatchResult>;
+}
+//#endregion
+export { EmbeddingAdapter, PrepareEmbeddingOptions, PreparedEmbeddingCall };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/embedding/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","names":[],"sources":["../../src/embedding/adapter.ts"],"mappings":";;;;;;;;;;UAkCiB,gCAAgC;;WAEtC,SAAS,QAAQ;;;;;;;;;;UAWX;;WAEN,OAAO;;WAEP,SAAS;;WAET,SAAS;;WAET,QAAQ;;EAEjB,WACE,OAAO,uBACP,UAAU,yBACT,QAAQ;;;;;;;;;;;;uBAaS;;;;;;EAMpB,aAAa,mBAAmB;;;;;;EAShC,oBAAoB,oBAAoB;;;;;;;;;EAYxC,oBACE,mBACA,UAAU,cACT,iBAAiB;;;;;;;;;;EAapB,sBACE,kBACA,eACA,UAAU,cACT,QAAQ;;;;;;;;;;EAaX,iBACE,OAAO,4BACP,SAAS,wBACR;;;;;;;;EAWG,qBACJ,kBACA,eACA,SAAS,yBACT,SAAS,aACT,UAAU,yBACT,QAAQ;;;;;;WAmBF,WACP,OAAO,uBACP,UAAU,yBACT,QAAQ"}

package/dist/embedding/adapter.js

@@ -0,0 +1,2 @@
+import{defaultEmbeddingProfile as e,deriveSpaceId as t}from"./profile.js";import{resolveBatchLimits as n}from"./limits.js";import{unknownEmbeddingModel as r}from"./catalog.js";var i=class{providerInfo(e){return{id:e,name:e}}providerRetryPolicy(e){}listEmbeddingModels(e,t){return Promise.resolve([])}resolveEmbeddingModel(e,t,n){return Promise.resolve(r(e,t))}embeddingProfile(t,n){return e(t,n)}async prepareEmbeddingCall(e,r,i,a,o){let s=await this.resolveEmbeddingModel(e,r,a),c=this.embeddingProfile(s,i);return Object.freeze({model:s,profile:c,spaceId:t(c),limits:n(s,i.limits),embedBatch:(e,t=o)=>this.embedBatch(e,t)})}};export{i as EmbeddingAdapter};
+//# sourceMappingURL=adapter.js.map

package/dist/embedding/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","names":[],"sources":["../../src/embedding/adapter.ts"],"sourcesContent":["/**\n * The contract an embedding provider backend implements.\n *\n * Shape worth noting: ONE abstract method, deliberately mirroring `ModelAdapter`.\n * Everything else has a working default, so a minimal embedding adapter is a\n * single `embedBatch()` implementation, while a mature one overrides metadata,\n * catalog, profile, and call binding. `embeddingProfile()` in particular is NOT\n * abstract — it delegates to {@link defaultEmbeddingProfile} so that a route with\n * no catalog knowledge still produces a usable profile (DD-13).\n *\n * This class does NOT extend `ModelAdapter`. Generation and embedding share no\n * request vocabulary, and inheriting `stream()` would force every embedding\n * backend to implement a method it cannot honour.\n *\n * As with `ModelAdapter`, every metadata method takes the route key as its first\n * argument rather than reading instance state, so one instance can serve many\n * routes with different endpoints and credentials.\n *\n * @module ai-agent-sdk/core/embedding/adapter\n */\n\nimport type { ModelInvocationContext } from '../observation/report.ts'\nimport type { ProviderInfo } from '../contract/model-info.ts'\nimport type { ResolvedRetryPolicy } from '../contract/retry-policy.ts'\nimport type { EmbeddingModelInfo, ResolvedEmbeddingModelInfo } from './catalog.ts'\nimport { unknownEmbeddingModel } from './catalog.ts'\nimport type { ResolvedEmbeddingBatchLimits } from './limits.ts'\nimport { resolveBatchLimits } from './limits.ts'\nimport type { EmbeddingProfile, EmbeddingProfileInput, EmbeddingSpaceId } from './profile.ts'\nimport { defaultEmbeddingProfile, deriveSpaceId } from './profile.ts'\nimport type { EmbeddingBatchRequest } from './request.ts'\nimport type { EmbeddingBatchResult } from './result.ts'\n\n/** Call configuration handed to {@link EmbeddingAdapter.prepareEmbeddingCall}. */\nexport interface PrepareEmbeddingOptions extends EmbeddingProfileInput {\n  /** Caller overrides on the catalog's declared batch bounds. */\n  readonly limits?: Partial<ResolvedEmbeddingBatchLimits>\n}\n\n/**\n * One adapter-owned embedding-resolution generation, bound to its dispatch call.\n *\n * The embedding counterpart of `PreparedAdapterCall`. Metadata, profile,\n * `spaceId`, and batch limits all come from the SAME capture as\n * {@link PreparedEmbeddingCall.embedBatch}, so dimensions can never be checked\n * against one configuration while the request goes out through another.\n */\nexport interface PreparedEmbeddingCall {\n  /** Exact model metadata from the SAME generation as {@link embedBatch}. */\n  readonly model: ResolvedEmbeddingModelInfo\n  /** The `Embedding_Profile` this generation will actually produce vectors in. */\n  readonly profile: EmbeddingProfile\n  /** Canonical space identity derived from {@link profile}. */\n  readonly spaceId: EmbeddingSpaceId\n  /** From `embedding/limits.ts`, never from `composition/`. */\n  readonly limits: ResolvedEmbeddingBatchLimits\n  /** Dispatch through that generation, without re-reading dynamic connection facts. */\n  embedBatch(\n    batch: EmbeddingBatchRequest,\n    context?: ModelInvocationContext,\n  ): Promise<EmbeddingBatchResult>\n}\n\n/**\n * Provider-wire adapter for this SDK's embedding vocabulary.\n *\n * Contract obligations on implementations:\n * - exactly one `Provider_Attempt` per `embedBatch()` call; retry is the runtime's;\n * - honour `batch.signal` promptly;\n * - carry the original input index onto every returned vector;\n * - raise a protocol error when a response breaks the contract, never infer;\n * - include the SDK's attribution headers on every provider request.\n */\nexport abstract class EmbeddingAdapter {\n  /**\n   * Describe one provider route owned by this adapter.\n   * @param provider - a route this instance was registered under.\n   * @returns detached display metadata whose `id` MUST equal `provider`.\n   */\n  providerInfo(provider: string): ProviderInfo {\n    return { id: provider, name: provider }\n  }\n\n  /**\n   * The retry policy this route owns.\n   * @param _provider - a route this instance was registered under.\n   * @returns a resolved policy, or `undefined` to accept the runtime defaults.\n   */\n  providerRetryPolicy(_provider: string): ResolvedRetryPolicy | undefined {\n    return undefined\n  }\n\n  /**\n   * List embedding models this adapter can currently advertise for one route.\n   *\n   * ADVISORY only: absence from this list must never become a reason to reject a\n   * request, because an adapter may accept ids it does not list.\n   * @param _provider - one route owned by this adapter.\n   * @returns discoverable models, in adapter-preferred order.\n   */\n  listEmbeddingModels(\n    _provider: string,\n    _signal?: AbortSignal,\n  ): Promise<readonly EmbeddingModelInfo[]> {\n    return Promise.resolve([])\n  }\n\n  /**\n   * Resolve all metadata available for one exact embedding model.\n   *\n   * NOT request validation — an unknown id resolves to a minimal all-`unknown`\n   * descriptor rather than an error.\n   * @param provider - one route owned by this adapter.\n   * @param model - exact model id.\n   * @param _signal - cancellation; async implementations must settle promptly after abort.\n   */\n  resolveEmbeddingModel(\n    provider: string,\n    model: string,\n    _signal?: AbortSignal,\n  ): Promise<ResolvedEmbeddingModelInfo> {\n    return Promise.resolve(unknownEmbeddingModel(provider, model))\n  }\n\n  /**\n   * Declare the `Embedding_Profile` for one concrete call configuration.\n   *\n   * NOT abstract: the default derives a compatibility identity from\n   * `${route}:${modelId}` when the catalog declares none, marks normalization\n   * `'unknown'`, and applies no post-processing. That is what keeps this class at\n   * exactly ONE abstract method. An adapter that owns the provider's real\n   * statement about its embedding space MUST override.\n   */\n  embeddingProfile(\n    model: ResolvedEmbeddingModelInfo,\n    request: EmbeddingProfileInput,\n  ): EmbeddingProfile {\n    return defaultEmbeddingProfile(model, request)\n  }\n\n  /**\n   * Bind resolved metadata to the exact configuration generation that will dispatch.\n   *\n   * Adapters whose connection facts come from mutable configuration MUST override\n   * and snapshot those facts here.\n   * @returns a frozen single-generation embedding entry point.\n   */\n  async prepareEmbeddingCall(\n    provider: string,\n    model: string,\n    options: PrepareEmbeddingOptions,\n    signal?: AbortSignal,\n    context?: ModelInvocationContext,\n  ): Promise<PreparedEmbeddingCall> {\n    const resolved = await this.resolveEmbeddingModel(provider, model, signal)\n    const profile = this.embeddingProfile(resolved, options)\n    return Object.freeze({\n      model: resolved,\n      profile,\n      // deriveSpaceId is synchronous: a canonical string, not a digest (DD-11).\n      spaceId: deriveSpaceId(profile),\n      limits: resolveBatchLimits(resolved, options.limits),\n      embedBatch: (batch: EmbeddingBatchRequest, invocation = context) =>\n        this.embedBatch(batch, invocation),\n    })\n  }\n\n  /**\n   * Perform EXACTLY ONE physical embedding request. The only required method.\n   * @param batch - one `Physical_Batch`, already within the resolved limits.\n   * @returns one vector per request item, each carrying its original index.\n   */\n  abstract embedBatch(\n    batch: EmbeddingBatchRequest,\n    context?: ModelInvocationContext,\n  ): Promise<EmbeddingBatchResult>\n}\n"],"mappings":"gLAyEA,IAAsB,EAAtB,KAAuC,CAMrC,aAAa,EAAgC,CAC3C,MAAO,CAAE,GAAI,EAAU,KAAM,CAAS,CACxC,CAOA,oBAAoB,EAAoD,CAExE,CAUA,oBACE,EACA,EACwC,CACxC,OAAO,QAAQ,QAAQ,CAAC,CAAC,CAC3B,CAWA,sBACE,EACA,EACA,EACqC,CACrC,OAAO,QAAQ,QAAQ,EAAsB,EAAU,CAAK,CAAC,CAC/D,CAWA,iBACE,EACA,EACkB,CAClB,OAAO,EAAwB,EAAO,CAAO,CAC/C,CASA,MAAM,qBACJ,EACA,EACA,EACA,EACA,EACgC,CAChC,IAAM,EAAW,MAAM,KAAK,sBAAsB,EAAU,EAAO,CAAM,EACnE,EAAU,KAAK,iBAAiB,EAAU,CAAO,EACvD,OAAO,OAAO,OAAO,CACnB,MAAO,EACP,UAEA,QAAS,EAAc,CAAO,EAC9B,OAAQ,EAAmB,EAAU,EAAQ,MAAM,EACnD,YAAa,EAA8B,EAAa,IACtD,KAAK,WAAW,EAAO,CAAU,CACrC,CAAC,CACH,CAWF"}

package/dist/embedding/catalog.d.ts

@@ -0,0 +1,82 @@
+import { EmbeddingNormalization, EmbeddingRepresentation } from "./profile.js";
+import { EmbeddingPurposeHandling } from "./purpose.js";
+//#region src/embedding/catalog.d.ts
+/**
+ * A single catalog capability in one of exactly three states.
+ *
+ * `'unsupported'` is a positive negative claim — the route states it does not
+ * have the thing. `'unknown'` states nothing at all. Collapsing the two would
+ * let a missing declaration masquerade as a denial, which is what Requirement
+ * 10.4 rules out.
+ */
+type EmbeddingCapability<T> = {
+  readonly state: 'supported';
+  readonly value: T;
+} | {
+  readonly state: 'unsupported';
+} | {
+  readonly state: 'unknown';
+};
+/**
+ * Accepted input kinds. v1 declares exactly one.
+ *
+ * There is no value here for images, audio or any other modality, so the v1
+ * text-only scope is readable from the type rather than from prose
+ * (Requirements 8.6, 8.8).
+ */
+type EmbeddingInputType = 'text';
+/**
+ * One embedding model a route can advertise.
+ *
+ * Catalog membership is ADVISORY, exactly as it is for generation: an adapter
+ * may accept an id it does not list.
+ */
+interface EmbeddingModelInfo {
+  /** Provider route that owns this entry. */
+  readonly provider: string;
+  /** Model id passed to `embed()`/`embedMany()`. */
+  readonly id: string;
+  /** Human-readable name for selectors. */
+  readonly name: string;
+  /** Optional user-facing distinction from otherwise similar models. */
+  readonly description?: string;
+  /** Accepted input kinds; v1 has only {@link EmbeddingInputType}. */
+  readonly inputTypes: EmbeddingCapability<readonly EmbeddingInputType[]>;
+  /** Output shape; v1 has only `'dense-float32'`, one dense vector per item. */
+  readonly representation: EmbeddingCapability<EmbeddingRepresentation>;
+  /** Selectable vector widths. */
+  readonly dimensions: EmbeddingCapability<readonly number[]>;
+  /** Width used when the caller requests none. */
+  readonly defaultDimensions: EmbeddingCapability<number>;
+  /** Per-input token ceiling. Only a `supported` value may reject an input. */
+  readonly maxInputTokens: EmbeddingCapability<number>;
+  /** Items accepted in one physical batch. */
+  readonly maxBatchItems: EmbeddingCapability<number>;
+  /** Estimated tokens accepted in one physical batch. */
+  readonly maxBatchTokens: EmbeddingCapability<number>;
+  /** Payload bytes accepted in one physical batch. */
+  readonly maxBatchBytes: EmbeddingCapability<number>;
+  /** How the route expresses purpose on the wire. */
+  readonly purposeHandling: EmbeddingCapability<EmbeddingPurposeHandling>;
+  /** Whether vectors arrive normalized. Never inferred from dimension count. */
+  readonly normalization: EmbeddingCapability<EmbeddingNormalization>;
+  /** The provider's own declaration about the embedding space. */
+  readonly compatibilityIdentity: EmbeddingCapability<string>;
+}
+/** Exact-route embedding metadata, resolved by the adapter that owns the route. */
+interface ResolvedEmbeddingModelInfo extends EmbeddingModelInfo {
+  /** Provider-declared model revision, when the route exposes one. */
+  readonly modelRevision?: string;
+}
+/**
+ * The minimal descriptor for an id the catalog does not describe: identity only,
+ * every capability `unknown`.
+ *
+ * This is what keeps an unlisted model id usable (Requirement 10.3). Consumers
+ * then split by intent: validation must NOT reject on `unknown`, while batching
+ * falls back to `EMBEDDING_BATCH_DEFAULTS` so memory stays bounded (DD-6).
+ */
+declare function unknownEmbeddingModel(provider: string, model: string): ResolvedEmbeddingModelInfo;
+//#endregion
+export { EmbeddingCapability, EmbeddingInputType, EmbeddingModelInfo, ResolvedEmbeddingModelInfo, unknownEmbeddingModel };
+//# sourceMappingURL=catalog.d.ts.map

package/dist/embedding/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","names":[],"sources":["../../src/embedding/catalog.ts"],"mappings":";;;;;;;;;;;KAwBY,oBAAoB;WACjB;WAA6B,OAAO;;WACpC;;WACA;;;;;;;;;KASH;;;;;;;UAWK;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,YAAY,6BAA6B;;WAEzC,gBAAgB,oBAAoB;;WAEpC,YAAY;;WAEZ,mBAAmB;;WAEnB,gBAAgB;;WAEhB,eAAe;;WAEf,gBAAgB;;WAEhB,eAAe;;WAEf,iBAAiB,oBAAoB;;WAErC,eAAe,oBAAoB;;WAEnC,uBAAuB;;;UAIjB,mCAAmC;;WAEzC;;;;;;;;;;iBAWK,sBACd,kBACA,gBACC"}

package/dist/embedding/catalog.js

@@ -0,0 +1,2 @@
+const e=Object.freeze({state:`unknown`});function t(t,n){return{provider:t,id:n,name:n,inputTypes:e,representation:e,dimensions:e,defaultDimensions:e,maxInputTokens:e,maxBatchItems:e,maxBatchTokens:e,maxBatchBytes:e,purposeHandling:e,normalization:e,compatibilityIdentity:e}}export{t as unknownEmbeddingModel};
+//# sourceMappingURL=catalog.js.map

package/dist/embedding/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","names":[],"sources":["../../src/embedding/catalog.ts"],"sourcesContent":["/**\n * `Embedding_Catalog`: embedding-specific model metadata, kept entirely separate\n * from {@link ResolvedModelInfo}.\n *\n * Generation metadata and embedding metadata answer different questions, so this\n * module adds NO field to the generation catalog. Every capability that is not\n * declared explicitly is `unknown`, and `unknown` is never a reason to reject a\n * request: an id outside the catalog stays usable and the provider decides\n * (Requirements 10.1, 10.3, 10.4, 10.5).\n *\n * @module ai-agent-sdk/core/embedding/catalog\n */\n\nimport type { EmbeddingNormalization, EmbeddingRepresentation } from './profile.ts'\nimport type { EmbeddingPurposeHandling } from './purpose.ts'\n\n/**\n * A single catalog capability in one of exactly three states.\n *\n * `'unsupported'` is a positive negative claim — the route states it does not\n * have the thing. `'unknown'` states nothing at all. Collapsing the two would\n * let a missing declaration masquerade as a denial, which is what Requirement\n * 10.4 rules out.\n */\nexport type EmbeddingCapability<T> =\n  | { readonly state: 'supported'; readonly value: T }\n  | { readonly state: 'unsupported' }\n  | { readonly state: 'unknown' }\n\n/**\n * Accepted input kinds. v1 declares exactly one.\n *\n * There is no value here for images, audio or any other modality, so the v1\n * text-only scope is readable from the type rather than from prose\n * (Requirements 8.6, 8.8).\n */\nexport type EmbeddingInputType = 'text'\n\n/** The `unknown` capability, shared so descriptors need not re-allocate it. */\nconst UNKNOWN: EmbeddingCapability<never> = Object.freeze({ state: 'unknown' })\n\n/**\n * One embedding model a route can advertise.\n *\n * Catalog membership is ADVISORY, exactly as it is for generation: an adapter\n * may accept an id it does not list.\n */\nexport interface EmbeddingModelInfo {\n  /** Provider route that owns this entry. */\n  readonly provider: string\n  /** Model id passed to `embed()`/`embedMany()`. */\n  readonly id: string\n  /** Human-readable name for selectors. */\n  readonly name: string\n  /** Optional user-facing distinction from otherwise similar models. */\n  readonly description?: string\n  /** Accepted input kinds; v1 has only {@link EmbeddingInputType}. */\n  readonly inputTypes: EmbeddingCapability<readonly EmbeddingInputType[]>\n  /** Output shape; v1 has only `'dense-float32'`, one dense vector per item. */\n  readonly representation: EmbeddingCapability<EmbeddingRepresentation>\n  /** Selectable vector widths. */\n  readonly dimensions: EmbeddingCapability<readonly number[]>\n  /** Width used when the caller requests none. */\n  readonly defaultDimensions: EmbeddingCapability<number>\n  /** Per-input token ceiling. Only a `supported` value may reject an input. */\n  readonly maxInputTokens: EmbeddingCapability<number>\n  /** Items accepted in one physical batch. */\n  readonly maxBatchItems: EmbeddingCapability<number>\n  /** Estimated tokens accepted in one physical batch. */\n  readonly maxBatchTokens: EmbeddingCapability<number>\n  /** Payload bytes accepted in one physical batch. */\n  readonly maxBatchBytes: EmbeddingCapability<number>\n  /** How the route expresses purpose on the wire. */\n  readonly purposeHandling: EmbeddingCapability<EmbeddingPurposeHandling>\n  /** Whether vectors arrive normalized. Never inferred from dimension count. */\n  readonly normalization: EmbeddingCapability<EmbeddingNormalization>\n  /** The provider's own declaration about the embedding space. */\n  readonly compatibilityIdentity: EmbeddingCapability<string>\n}\n\n/** Exact-route embedding metadata, resolved by the adapter that owns the route. */\nexport interface ResolvedEmbeddingModelInfo extends EmbeddingModelInfo {\n  /** Provider-declared model revision, when the route exposes one. */\n  readonly modelRevision?: string\n}\n\n/**\n * The minimal descriptor for an id the catalog does not describe: identity only,\n * every capability `unknown`.\n *\n * This is what keeps an unlisted model id usable (Requirement 10.3). Consumers\n * then split by intent: validation must NOT reject on `unknown`, while batching\n * falls back to `EMBEDDING_BATCH_DEFAULTS` so memory stays bounded (DD-6).\n */\nexport function unknownEmbeddingModel(\n  provider: string,\n  model: string,\n): ResolvedEmbeddingModelInfo {\n  return {\n    provider,\n    id: model,\n    name: model,\n    inputTypes: UNKNOWN,\n    representation: UNKNOWN,\n    dimensions: UNKNOWN,\n    defaultDimensions: UNKNOWN,\n    maxInputTokens: UNKNOWN,\n    maxBatchItems: UNKNOWN,\n    maxBatchTokens: UNKNOWN,\n    maxBatchBytes: UNKNOWN,\n    purposeHandling: UNKNOWN,\n    normalization: UNKNOWN,\n    compatibilityIdentity: UNKNOWN,\n  }\n}\n"],"mappings":"AAuCA,MAAM,EAAsC,OAAO,OAAO,CAAE,MAAO,SAAU,CAAC,EAuD9E,SAAgB,EACd,EACA,EAC4B,CAC5B,MAAO,CACL,WACA,GAAI,EACJ,KAAM,EACN,WAAY,EACZ,eAAgB,EAChB,WAAY,EACZ,kBAAmB,EACnB,eAAgB,EAChB,cAAe,EACf,eAAgB,EAChB,cAAe,EACf,gBAAiB,EACjB,cAAe,EACf,sBAAuB,CACzB,CACF"}

package/dist/embedding/errors.d.ts

@@ -0,0 +1,98 @@
+import { AgentSdkError } from "../errors/agent-sdk-error.js";
+import { EmbeddingSpaceId } from "./profile.js";
+//#region src/embedding/errors.d.ts
+/**
+ * Codes produced by the embedding contract and runtime.
+ *
+ * A frozen object rather than a TS enum, matching `MODEL_ERROR_CODES`, so a
+ * third-party embedding adapter can emit its own code without this union having
+ * to know about it. Values are prefixed `EMBEDDING_` because they travel beside
+ * generation codes in the same failure envelopes.
+ */
+declare const EMBEDDING_ERROR_CODES: Readonly<{
+  /** No `Embedding_Adapter` is registered for the requested route/model. */
+  readonly ADAPTER_MISSING: 'EMBEDDING_ADAPTER_MISSING';
+  /** Malformed at the SDK boundary: missing purpose, empty values, empty item. */
+  readonly REQUEST_INVALID: 'EMBEDDING_REQUEST_INVALID';
+  /** `dimensions` is not among the widths the route declares support for. */
+  readonly DIMENSIONS_UNSUPPORTED: 'EMBEDDING_DIMENSIONS_UNSUPPORTED';
+  /** Input exceeds the declared max input tokens; carries `itemIndexes` and `limit`. */
+  readonly INPUT_TOO_LARGE: 'EMBEDDING_INPUT_TOO_LARGE';
+  /** The expected `Space_Id` is incompatible with the `Prepared_Embedding_Call`. */
+  readonly SPACE_INCOMPATIBLE: 'EMBEDDING_SPACE_INCOMPATIBLE';
+  /** The route has no way to express this purpose and the caller demands the distinction. */
+  readonly PURPOSE_UNSUPPORTED: 'EMBEDDING_PURPOSE_UNSUPPORTED';
+  /** The caller asked for truncation but the provider has no equivalent parameter. */
+  readonly TRUNCATION_UNSUPPORTED: 'EMBEDDING_TRUNCATION_UNSUPPORTED';
+  /** The response carried a different number of vectors than inputs sent. */
+  readonly VECTOR_COUNT_MISMATCH: 'EMBEDDING_VECTOR_COUNT_MISMATCH';
+  /** A vector index is duplicated, missing, or out of range. */
+  readonly VECTOR_INDEX_INVALID: 'EMBEDDING_VECTOR_INDEX_INVALID';
+  /** A vector contains `NaN` or `Infinity`. */
+  readonly VECTOR_VALUE_INVALID: 'EMBEDDING_VECTOR_VALUE_INVALID';
+  /** A vector's width differs from the requested `dimensions`. */
+  readonly VECTOR_DIMENSIONS_MISMATCH: 'EMBEDDING_VECTOR_DIMENSIONS_MISMATCH';
+  /** The response does not satisfy the embedding contract structurally. */
+  readonly RESPONSE_MALFORMED: 'EMBEDDING_RESPONSE_MALFORMED';
+  /** The caller's signal or a runtime close aborted the call. */
+  readonly ABORTED: 'EMBEDDING_ABORTED';
+  /** Invalid handle configuration: cache enabled without scope, fallback outside the group. */
+  readonly CONFIGURATION_INVALID: 'EMBEDDING_CONFIGURATION_INVALID';
+  /** Nothing in this taxonomy classified the embedding failure. */
+  readonly UNKNOWN: 'EMBEDDING_UNKNOWN';
+}>;
+/** Any value of {@link EMBEDDING_ERROR_CODES}; a foreign adapter may still use its own `string`. */
+type EmbeddingErrorCode = typeof EMBEDDING_ERROR_CODES[keyof typeof EMBEDDING_ERROR_CODES];
+/** Structured embedding facts and cause accepted by {@link EmbeddingError}. */
+interface EmbeddingErrorOptions extends ErrorOptions {
+  /**
+   * Zero-based indexes of the request items this failure belongs to.
+   *
+   * Present only when the fault is attributable to specific inputs, which is
+   * what lets a caller drop or re-chunk those items instead of the whole call.
+   */
+  itemIndexes?: readonly number[];
+  /** The limit that was applied, when the failure is a limit violation. */
+  limit?: number;
+  /** Provider id of the route that produced the failure. */
+  provider?: string;
+  /** Model id of the route that produced the failure. */
+  model?: string;
+  /** The embedding space involved, when the failure concerns space compatibility. */
+  space?: EmbeddingSpaceId;
+}
+/**
+ * Typed error for embedding failures, carrying a stable `code` plus the facts a
+ * caller needs to act without re-deriving them.
+ *
+ * The constructor validates rather than trusts: `itemIndexes` must be
+ * non-negative integers and `limit` a positive finite number. A negative index
+ * or a `limit` of `-1` means a caller upstream miscomputed a bound, and letting
+ * it through would surface a nonsense limit in a message that reads as
+ * authoritative. Indexes are copied and frozen so the array cannot be mutated
+ * after the error is thrown.
+ *
+ * No field carries raw input text or vector values: redaction rules keep those
+ * out of errors and traces alike.
+ */
+declare class EmbeddingError extends AgentSdkError {
+  /** Request item indexes this failure belongs to, when input-specific. */
+  readonly itemIndexes?: readonly number[];
+  /** The applied limit, when the failure is a limit violation. */
+  readonly limit?: number;
+  /** Provider id of the failing route. */
+  readonly provider?: string;
+  /** Model id of the failing route. */
+  readonly model?: string;
+  /** The embedding space involved in the failure. */
+  readonly space?: EmbeddingSpaceId;
+  /**
+   * @param message - non-empty human-readable failure summary, free of credentials and raw input.
+   * @param code - non-empty stable machine code, normally from {@link EMBEDDING_ERROR_CODES}.
+   * @param options - optional cause and validated embedding facts.
+   */
+  constructor(message: string, code: string, options?: EmbeddingErrorOptions);
+}
+//#endregion
+export { EMBEDDING_ERROR_CODES, EmbeddingError, EmbeddingErrorCode, EmbeddingErrorOptions };
+//# sourceMappingURL=errors.d.ts.map

package/dist/embedding/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/embedding/errors.ts"],"mappings":";;;;;;;;;;;cA2Ba,uBAAqB;;WAEf;;WAEA;;WAEO;;WAEP;;WAEG;;WAEC;;WAEG;;WAED;;WAED;;WAEA;;WAEM;;WAER;;WAEX;;WAEc;;WAEd;;;KAIC,4BAA4B,mCAAmC;;UAG1D,8BAA8B;;;;;;;EAO7C;;EAEA;;EAEA;;EAEA;;EAEA,QAAQ;;;;;;;;;;;;;;;;cAiBG,uBAAuB;;WAEzB;;WAEA;;WAEA;;WAEA;;WAEA,QAAQ;;;;;;EAOjB,YAAY,iBAAiB,cAAc,UAAU"}

package/dist/embedding/errors.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"../errors/agent-sdk-error.js";const t=Object.freeze({ADAPTER_MISSING:`EMBEDDING_ADAPTER_MISSING`,REQUEST_INVALID:`EMBEDDING_REQUEST_INVALID`,DIMENSIONS_UNSUPPORTED:`EMBEDDING_DIMENSIONS_UNSUPPORTED`,INPUT_TOO_LARGE:`EMBEDDING_INPUT_TOO_LARGE`,SPACE_INCOMPATIBLE:`EMBEDDING_SPACE_INCOMPATIBLE`,PURPOSE_UNSUPPORTED:`EMBEDDING_PURPOSE_UNSUPPORTED`,TRUNCATION_UNSUPPORTED:`EMBEDDING_TRUNCATION_UNSUPPORTED`,VECTOR_COUNT_MISMATCH:`EMBEDDING_VECTOR_COUNT_MISMATCH`,VECTOR_INDEX_INVALID:`EMBEDDING_VECTOR_INDEX_INVALID`,VECTOR_VALUE_INVALID:`EMBEDDING_VECTOR_VALUE_INVALID`,VECTOR_DIMENSIONS_MISMATCH:`EMBEDDING_VECTOR_DIMENSIONS_MISMATCH`,RESPONSE_MALFORMED:`EMBEDDING_RESPONSE_MALFORMED`,ABORTED:`EMBEDDING_ABORTED`,CONFIGURATION_INVALID:`EMBEDDING_CONFIGURATION_INVALID`,UNKNOWN:`EMBEDDING_UNKNOWN`});var n=class extends e{itemIndexes;limit;provider;model;space;constructor(e,t,n){if(typeof e!=`string`||e.length===0)throw Error(`EmbeddingError message must be a non-empty string`);if(typeof t!=`string`||t.length===0)throw Error(`EmbeddingError code must be a non-empty string`);if(n?.itemIndexes!==void 0&&(!Array.isArray(n.itemIndexes)||n.itemIndexes.some(e=>!Number.isInteger(e)||e<0)))throw Error(`EmbeddingError itemIndexes must be an array of non-negative integers`);if(n?.limit!==void 0&&(!Number.isFinite(n.limit)||n.limit<=0))throw Error(`EmbeddingError limit must be a positive finite number`);if(n?.provider!==void 0&&(typeof n.provider!=`string`||n.provider.length===0))throw Error(`EmbeddingError provider must be a non-empty string`);if(n?.model!==void 0&&(typeof n.model!=`string`||n.model.length===0))throw Error(`EmbeddingError model must be a non-empty string`);if(n?.space!==void 0&&(typeof n.space!=`string`||n.space.length===0))throw Error(`EmbeddingError space must be a non-empty string`);super(e,t,n),this.name=`EmbeddingError`,n?.itemIndexes!==void 0&&(this.itemIndexes=Object.freeze([...n.itemIndexes])),n?.limit!==void 0&&(this.limit=n.limit),n?.provider!==void 0&&(this.provider=n.provider),n?.model!==void 0&&(this.model=n.model),n?.space!==void 0&&(this.space=n.space)}};export{t as EMBEDDING_ERROR_CODES,n as EmbeddingError};
+//# sourceMappingURL=errors.js.map

package/dist/embedding/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/embedding/errors.ts"],"sourcesContent":["/**\n * The stable embedding failure taxonomy, and the error the embedding layers throw.\n *\n * Codes here are owned by two layers only: `Embedding_Runtime` before dispatch\n * (dimensions, limits, space, configuration) and `Embedding_Adapter` when it\n * validates a response (vector count, index, values, width). Transport-level\n * faults keep using `MODEL_ERROR_CODES`, so a caller can tell \"the provider is\n * rate limiting us\" apart from \"the provider returned a vector of the wrong\n * width\" without parsing any message.\n *\n * Both provider adapters emit the SAME codes for mapping, dimensions and vector\n * faults. That is what lets one contract-test suite run against both.\n *\n * @module ai-agent-sdk/core/embedding/errors\n */\n\nimport { AgentSdkError } from '../errors/agent-sdk-error.ts'\nimport type { EmbeddingSpaceId } from './profile.ts'\n\n/**\n * Codes produced by the embedding contract and runtime.\n *\n * A frozen object rather than a TS enum, matching `MODEL_ERROR_CODES`, so a\n * third-party embedding adapter can emit its own code without this union having\n * to know about it. Values are prefixed `EMBEDDING_` because they travel beside\n * generation codes in the same failure envelopes.\n */\nexport const EMBEDDING_ERROR_CODES = Object.freeze({\n  /** No `Embedding_Adapter` is registered for the requested route/model. */\n  ADAPTER_MISSING: 'EMBEDDING_ADAPTER_MISSING',\n  /** Malformed at the SDK boundary: missing purpose, empty values, empty item. */\n  REQUEST_INVALID: 'EMBEDDING_REQUEST_INVALID',\n  /** `dimensions` is not among the widths the route declares support for. */\n  DIMENSIONS_UNSUPPORTED: 'EMBEDDING_DIMENSIONS_UNSUPPORTED',\n  /** Input exceeds the declared max input tokens; carries `itemIndexes` and `limit`. */\n  INPUT_TOO_LARGE: 'EMBEDDING_INPUT_TOO_LARGE',\n  /** The expected `Space_Id` is incompatible with the `Prepared_Embedding_Call`. */\n  SPACE_INCOMPATIBLE: 'EMBEDDING_SPACE_INCOMPATIBLE',\n  /** The route has no way to express this purpose and the caller demands the distinction. */\n  PURPOSE_UNSUPPORTED: 'EMBEDDING_PURPOSE_UNSUPPORTED',\n  /** The caller asked for truncation but the provider has no equivalent parameter. */\n  TRUNCATION_UNSUPPORTED: 'EMBEDDING_TRUNCATION_UNSUPPORTED',\n  /** The response carried a different number of vectors than inputs sent. */\n  VECTOR_COUNT_MISMATCH: 'EMBEDDING_VECTOR_COUNT_MISMATCH',\n  /** A vector index is duplicated, missing, or out of range. */\n  VECTOR_INDEX_INVALID: 'EMBEDDING_VECTOR_INDEX_INVALID',\n  /** A vector contains `NaN` or `Infinity`. */\n  VECTOR_VALUE_INVALID: 'EMBEDDING_VECTOR_VALUE_INVALID',\n  /** A vector's width differs from the requested `dimensions`. */\n  VECTOR_DIMENSIONS_MISMATCH: 'EMBEDDING_VECTOR_DIMENSIONS_MISMATCH',\n  /** The response does not satisfy the embedding contract structurally. */\n  RESPONSE_MALFORMED: 'EMBEDDING_RESPONSE_MALFORMED',\n  /** The caller's signal or a runtime close aborted the call. */\n  ABORTED: 'EMBEDDING_ABORTED',\n  /** Invalid handle configuration: cache enabled without scope, fallback outside the group. */\n  CONFIGURATION_INVALID: 'EMBEDDING_CONFIGURATION_INVALID',\n  /** Nothing in this taxonomy classified the embedding failure. */\n  UNKNOWN: 'EMBEDDING_UNKNOWN',\n} as const)\n\n/** Any value of {@link EMBEDDING_ERROR_CODES}; a foreign adapter may still use its own `string`. */\nexport type EmbeddingErrorCode = typeof EMBEDDING_ERROR_CODES[keyof typeof EMBEDDING_ERROR_CODES]\n\n/** Structured embedding facts and cause accepted by {@link EmbeddingError}. */\nexport interface EmbeddingErrorOptions extends ErrorOptions {\n  /**\n   * Zero-based indexes of the request items this failure belongs to.\n   *\n   * Present only when the fault is attributable to specific inputs, which is\n   * what lets a caller drop or re-chunk those items instead of the whole call.\n   */\n  itemIndexes?: readonly number[]\n  /** The limit that was applied, when the failure is a limit violation. */\n  limit?: number\n  /** Provider id of the route that produced the failure. */\n  provider?: string\n  /** Model id of the route that produced the failure. */\n  model?: string\n  /** The embedding space involved, when the failure concerns space compatibility. */\n  space?: EmbeddingSpaceId\n}\n\n/**\n * Typed error for embedding failures, carrying a stable `code` plus the facts a\n * caller needs to act without re-deriving them.\n *\n * The constructor validates rather than trusts: `itemIndexes` must be\n * non-negative integers and `limit` a positive finite number. A negative index\n * or a `limit` of `-1` means a caller upstream miscomputed a bound, and letting\n * it through would surface a nonsense limit in a message that reads as\n * authoritative. Indexes are copied and frozen so the array cannot be mutated\n * after the error is thrown.\n *\n * No field carries raw input text or vector values: redaction rules keep those\n * out of errors and traces alike.\n */\nexport class EmbeddingError extends AgentSdkError {\n  /** Request item indexes this failure belongs to, when input-specific. */\n  readonly itemIndexes?: readonly number[]\n  /** The applied limit, when the failure is a limit violation. */\n  readonly limit?: number\n  /** Provider id of the failing route. */\n  readonly provider?: string\n  /** Model id of the failing route. */\n  readonly model?: string\n  /** The embedding space involved in the failure. */\n  readonly space?: EmbeddingSpaceId\n\n  /**\n   * @param message - non-empty human-readable failure summary, free of credentials and raw input.\n   * @param code - non-empty stable machine code, normally from {@link EMBEDDING_ERROR_CODES}.\n   * @param options - optional cause and validated embedding facts.\n   */\n  constructor(message: string, code: string, options?: EmbeddingErrorOptions) {\n    if (typeof message !== 'string' || message.length === 0) {\n      throw new Error('EmbeddingError message must be a non-empty string')\n    }\n    if (typeof code !== 'string' || code.length === 0) {\n      throw new Error('EmbeddingError code must be a non-empty string')\n    }\n    if (options?.itemIndexes !== undefined\n      && (!Array.isArray(options.itemIndexes)\n        || options.itemIndexes.some(index => !Number.isInteger(index) || index < 0))) {\n      throw new Error('EmbeddingError itemIndexes must be an array of non-negative integers')\n    }\n    if (options?.limit !== undefined\n      && (!Number.isFinite(options.limit) || options.limit <= 0)) {\n      throw new Error('EmbeddingError limit must be a positive finite number')\n    }\n    if (options?.provider !== undefined\n      && (typeof options.provider !== 'string' || options.provider.length === 0)) {\n      throw new Error('EmbeddingError provider must be a non-empty string')\n    }\n    if (options?.model !== undefined\n      && (typeof options.model !== 'string' || options.model.length === 0)) {\n      throw new Error('EmbeddingError model must be a non-empty string')\n    }\n    if (options?.space !== undefined\n      && (typeof options.space !== 'string' || options.space.length === 0)) {\n      throw new Error('EmbeddingError space must be a non-empty string')\n    }\n    super(message, code, options)\n    this.name = 'EmbeddingError'\n    if (options?.itemIndexes !== undefined) {\n      this.itemIndexes = Object.freeze([...options.itemIndexes])\n    }\n    if (options?.limit !== undefined) this.limit = options.limit\n    if (options?.provider !== undefined) this.provider = options.provider\n    if (options?.model !== undefined) this.model = options.model\n    if (options?.space !== undefined) this.space = options.space\n  }\n}\n"],"mappings":"6DA2BA,MAAa,EAAwB,OAAO,OAAO,CAEjD,gBAAiB,4BAEjB,gBAAiB,4BAEjB,uBAAwB,mCAExB,gBAAiB,4BAEjB,mBAAoB,+BAEpB,oBAAqB,gCAErB,uBAAwB,mCAExB,sBAAuB,kCAEvB,qBAAsB,iCAEtB,qBAAsB,iCAEtB,2BAA4B,uCAE5B,mBAAoB,+BAEpB,QAAS,oBAET,sBAAuB,kCAEvB,QAAS,mBACX,CAAU,EAsCV,IAAa,EAAb,cAAoC,CAAc,CAEhD,YAEA,MAEA,SAEA,MAEA,MAOA,YAAY,EAAiB,EAAc,EAAiC,CAC1E,GAAI,OAAO,GAAY,UAAY,EAAQ,SAAW,EACpD,MAAU,MAAM,mDAAmD,EAErE,GAAI,OAAO,GAAS,UAAY,EAAK,SAAW,EAC9C,MAAU,MAAM,gDAAgD,EAElE,GAAI,GAAS,cAAgB,IAAA,KACvB,CAAC,MAAM,QAAQ,EAAQ,WAAW,GACjC,EAAQ,YAAY,KAAK,GAAS,CAAC,OAAO,UAAU,CAAK,GAAK,EAAQ,CAAC,GAC5E,MAAU,MAAM,sEAAsE,EAExF,GAAI,GAAS,QAAU,IAAA,KACjB,CAAC,OAAO,SAAS,EAAQ,KAAK,GAAK,EAAQ,OAAS,GACxD,MAAU,MAAM,uDAAuD,EAEzE,GAAI,GAAS,WAAa,IAAA,KACpB,OAAO,EAAQ,UAAa,UAAY,EAAQ,SAAS,SAAW,GACxE,MAAU,MAAM,oDAAoD,EAEtE,GAAI,GAAS,QAAU,IAAA,KACjB,OAAO,EAAQ,OAAU,UAAY,EAAQ,MAAM,SAAW,GAClE,MAAU,MAAM,iDAAiD,EAEnE,GAAI,GAAS,QAAU,IAAA,KACjB,OAAO,EAAQ,OAAU,UAAY,EAAQ,MAAM,SAAW,GAClE,MAAU,MAAM,iDAAiD,EAEnE,MAAM,EAAS,EAAM,CAAO,EAC5B,KAAK,KAAO,iBACR,GAAS,cAAgB,IAAA,KAC3B,KAAK,YAAc,OAAO,OAAO,CAAC,GAAG,EAAQ,WAAW,CAAC,GAEvD,GAAS,QAAU,IAAA,KAAW,KAAK,MAAQ,EAAQ,OACnD,GAAS,WAAa,IAAA,KAAW,KAAK,SAAW,EAAQ,UACzD,GAAS,QAAU,IAAA,KAAW,KAAK,MAAQ,EAAQ,OACnD,GAAS,QAAU,IAAA,KAAW,KAAK,MAAQ,EAAQ,MACzD,CACF"}