@alvin0/ai-agent-sdk-core 0.1.0

package/dist/errors/agent-sdk-error.d.ts

@@ -0,0 +1,88 @@
+//#region src/errors/agent-sdk-error.d.ts
+/**
+ * Error taxonomy: a stable machine-routable `code` beside the human-readable
+ * `message`, plus the wording classifiers adapters share.
+ *
+ * The taxonomy is a string `code`, deliberately NOT a TypeScript enum, so a
+ * third-party adapter can introduce its own code without a core release. Route
+ * on `code`; never parse `message`.
+ *
+ * @module ai-agent-sdk/core/errors/agent-sdk-error
+ */
+/**
+ * Base class for every error this SDK raises. Carries a stable `code` and
+ * supports `cause` chaining through the standard `ErrorOptions`.
+ */
+declare class AgentSdkError extends Error {
+  /** Stable machine-routable failure class (e.g. `RATE_LIMIT`); route on this, never on `message`. */
+  readonly code: string;
+  constructor(message: string, code: string, options?: ErrorOptions);
+}
+/** A request was rejected because it exceeded the model's context window. */
+declare const CONTEXT_WINDOW_EXCEEDED_CODE = "CONTEXT_WINDOW_EXCEEDED";
+/** The account's quota, balance, or credit is exhausted  Enot a transient rate limit. */
+declare const QUOTA_EXCEEDED_CODE = "QUOTA";
+/**
+ * The response completed normally but carried no content at all.
+ *
+ * Providers occasionally emit a degenerate completion: a terminal stop with
+ * zero output. Adapters classify that as this failure rather than yielding an
+ * empty assistant message, because an empty message silently ends the turn with
+ * nothing for the caller or the agent loop to act on. Nothing durable was
+ * produced, so this IS in the default retryable set.
+ */
+declare const EMPTY_RESPONSE_CODE = "EMPTY_RESPONSE";
+/** No credential was available anywhere for the request. */
+declare const MISSING_CREDENTIAL_CODE = "MISSING_CREDENTIAL";
+/**
+ * A credential was supplied but cannot be used  Emalformed, not absent.
+ *
+ * Distinct from {@link MISSING_CREDENTIAL_CODE} because the fix differs: correct
+ * the stored value rather than supply one. Deliberately outside the default
+ * retryable set, since a malformed credential fails identically every time.
+ */
+declare const INVALID_CREDENTIAL_CODE = "INVALID_CREDENTIAL";
+/**
+ * Recognize context-overflow wording.
+ *
+ * Both providers report this as a generic HTTP 400, so status alone cannot
+ * separate "your prompt is too long" (worth compacting and retrying) from
+ * "your request is malformed" (worth failing). The classifier is deliberately
+ * narrow: it only fires when the wording names the context window, because a
+ * false positive would make the caller compact history to fix a schema bug.
+ * @param detail - provider error code/type/message text joined into one string.
+ * @returns true when the detail identifies a request exceeding the model context window.
+ */
+declare function isContextWindowExceededError(detail: string): boolean;
+/**
+ * Recognize an exhausted account quota rather than a transient request-rate limit.
+ *
+ * The distinction matters because both can arrive as HTTP 429 and their retry
+ * behaviour is opposite: a rate limit clears on its own, a spent balance never
+ * does. Checked BEFORE the 429 mapping for that reason.
+ * @param detail - provider error code/type/message text joined into one string.
+ * @returns true only for terminal quota, balance, credit, budget, or usage-limit wording.
+ */
+declare function isQuotaExceededError(detail: string): boolean;
+/**
+ * Render a thrown value with its full `cause` chain and `AggregateError` members.
+ *
+ * Transport wrappers are the motivation: undici surfaces a bare
+ * `TypeError: fetch failed` whose actual reason (DNS, TLS, ECONNRESET) lives
+ * only in `cause`. Diagnostic surfaces only  Enever parse the result; route on
+ * {@link AgentSdkError.code}.
+ * @param value - the caught value (`unknown` in catch clauses).
+ * @returns the outermost message first, each cause appended with `: ` (skipped
+ *   when it repeats the wrapper message verbatim), and AggregateError members
+ *   bracketed and `; `-joined.
+ */
+declare function errorChain(value: unknown): string;
+/**
+ * Narrow an arbitrary thrown value to an {@link AgentSdkError}.
+ * @param value - the caught value (`unknown` in catch clauses).
+ * @returns true only for real instances; duck-typed or cross-realm errors do not narrow.
+ */
+declare function isAgentSdkError(value: unknown): value is AgentSdkError;
+//#endregion
+export { AgentSdkError, CONTEXT_WINDOW_EXCEEDED_CODE, EMPTY_RESPONSE_CODE, INVALID_CREDENTIAL_CODE, MISSING_CREDENTIAL_CODE, QUOTA_EXCEEDED_CODE, errorChain, isAgentSdkError, isContextWindowExceededError, isQuotaExceededError };
+//# sourceMappingURL=agent-sdk-error.d.ts.map

package/dist/errors/agent-sdk-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-sdk-error.d.ts","names":[],"sources":["../../src/errors/agent-sdk-error.ts"],"mappings":";;;;;;;;;;;;;;;cAea,sBAAsB;;WAExB;EAET,YAAY,iBAAiB,cAAc,UAAU;;;cAQ1C;;cAGA;;;;;;;;;;cAWA;;cAGA;;;;;;;;cASA;;;;;;;;;;;;iBAoCG,6BAA6B;;;;;;;;;;iBAiB7B,qBAAqB;;;;;;;;;;;;;iBAoBrB,WAAW;;;;;;iBA+CX,gBAAgB,iBAAiB,SAAS"}

package/dist/errors/agent-sdk-error.js

@@ -0,0 +1,2 @@
+var e=class extends Error{code;constructor(e,t,n){super(e,n),this.code=t,this.name=new.target.name}};const t=`CONTEXT_WINDOW_EXCEEDED`,n=`QUOTA`,r=`EMPTY_RESPONSE`,i=`MISSING_CREDENTIAL`,a=`INVALID_CREDENTIAL`,o=new RegExp(String.raw`(?:^|[^a-z0-9])context[\s_-](?:length|window)[\s_-]`+String.raw`(?:exceed(?:ed|s)?|overflow(?:ed)?|limit[\s_-]exceeded)(?:$|[^a-z0-9])`,`i`),s=new RegExp(String.raw`\b(?:request|prompt|input|messages?)\s+(?:is\s+|are\s+)?`+String.raw`too\s+(?:large|long)\s+for\s+(?:(?:this|the)\s+)?`+String.raw`(?:model(?:'s)?\s+)?context(?:\s+window)?\b`,`i`),c=new RegExp(String.raw`\b(?:input|prompt|request|messages?)\b.{0,40}`+String.raw`\b(?:exceed(?:s|ed)?|overflows?|is\s+larger\s+than)\b.{0,40}`+String.raw`\b(?:the\s+)?(?:model(?:'s)?\s+)?context(?:\s+(?:length|window))?\b`,`i`);function l(e){return o.test(e)||/\b(?:maximum|max)(?:\s+(?:allowed|supported))?\s+context\s+(?:length|window)\b/i.test(e)||s.test(e)||/\b(?:input|prompt|request)\s+(?:is\s+)?too\s+(?:long|large)\s+for\s+(?:this|the)\s+model\b/i.test(e)||c.test(e)}function u(e){return/\binsufficient[\s_-]+(?:quota|balance|credits?)\b/i.test(e)||/\b(?:quota|usage[\s_-]+limit)[\s_-]+(?:exceeded|exhausted|reached)\b/i.test(e)||/\bexceed(?:ed|s)?[\s_-]+(?:(?:your|the)[\s_-]+)?(?:current[\s_-]+)?quota\b/i.test(e)||/\b(?:balance|credits?)[\s_-]+(?:exhausted|depleted)\b/i.test(e)||/\bout[\s_-]+of[\s_-]+(?:credits?|budget)\b/i.test(e)}function d(e){let t=new Set,n=e=>{if(t.has(e))return`<circular cause>`;t.add(e);try{if(!(e instanceof Error)){if(typeof e==`object`&&e){let t=Object.getOwnPropertyDescriptor(e,`message`);if(t!==void 0&&`value`in t&&typeof t.value==`string`)return t.value}return String(e)}let t=e.message===``?e.name:e.message,r=e instanceof AggregateError&&e.errors.length>0?` [${e.errors.map(n).join(`; `)}]`:``,i=e.cause===void 0||e.cause===null?``:n(e.cause);return`${t}${r}${i===``||i===t?``:`: ${i}`}`}catch{return`<unrenderable value>`}finally{t.delete(e)}};return n(e)}function f(t){return t instanceof e}export{e as AgentSdkError,t as CONTEXT_WINDOW_EXCEEDED_CODE,r as EMPTY_RESPONSE_CODE,a as INVALID_CREDENTIAL_CODE,i as MISSING_CREDENTIAL_CODE,n as QUOTA_EXCEEDED_CODE,d as errorChain,f as isAgentSdkError,l as isContextWindowExceededError,u as isQuotaExceededError};
+//# sourceMappingURL=agent-sdk-error.js.map

package/dist/errors/agent-sdk-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-sdk-error.js","names":[],"sources":["../../src/errors/agent-sdk-error.ts"],"sourcesContent":["/**\n * Error taxonomy: a stable machine-routable `code` beside the human-readable\n * `message`, plus the wording classifiers adapters share.\n *\n * The taxonomy is a string `code`, deliberately NOT a TypeScript enum, so a\n * third-party adapter can introduce its own code without a core release. Route\n * on `code`; never parse `message`.\n *\n * @module ai-agent-sdk/core/errors/agent-sdk-error\n */\n\n/**\n * Base class for every error this SDK raises. Carries a stable `code` and\n * supports `cause` chaining through the standard `ErrorOptions`.\n */\nexport class AgentSdkError extends Error {\n  /** Stable machine-routable failure class (e.g. `RATE_LIMIT`); route on this, never on `message`. */\n  readonly code: string\n\n  constructor(message: string, code: string, options?: ErrorOptions) {\n    super(message, options)\n    this.code = code\n    this.name = new.target.name\n  }\n}\n\n/** A request was rejected because it exceeded the model's context window. */\nexport const CONTEXT_WINDOW_EXCEEDED_CODE = 'CONTEXT_WINDOW_EXCEEDED'\n\n/** The account's quota, balance, or credit is exhausted  Enot a transient rate limit. */\nexport const QUOTA_EXCEEDED_CODE = 'QUOTA'\n\n/**\n * The response completed normally but carried no content at all.\n *\n * Providers occasionally emit a degenerate completion: a terminal stop with\n * zero output. Adapters classify that as this failure rather than yielding an\n * empty assistant message, because an empty message silently ends the turn with\n * nothing for the caller or the agent loop to act on. Nothing durable was\n * produced, so this IS in the default retryable set.\n */\nexport const EMPTY_RESPONSE_CODE = 'EMPTY_RESPONSE'\n\n/** No credential was available anywhere for the request. */\nexport const MISSING_CREDENTIAL_CODE = 'MISSING_CREDENTIAL'\n\n/**\n * A credential was supplied but cannot be used  Emalformed, not absent.\n *\n * Distinct from {@link MISSING_CREDENTIAL_CODE} because the fix differs: correct\n * the stored value rather than supply one. Deliberately outside the default\n * retryable set, since a malformed credential fails identically every time.\n */\nexport const INVALID_CREDENTIAL_CODE = 'INVALID_CREDENTIAL'\n\n/** Structured codes and phrases that explicitly name a context bound being exceeded. */\nconst STRUCTURED_CONTEXT_OVERFLOW = new RegExp(\n  String.raw`(?:^|[^a-z0-9])context[\\s_-](?:length|window)[\\s_-]`\n  + String.raw`(?:exceed(?:ed|s)?|overflow(?:ed)?|limit[\\s_-]exceeded)(?:$|[^a-z0-9])`,\n  'i',\n)\n\n/** Request-size wording that ties \"too large\" directly to model context capacity. */\nconst TOO_LARGE_FOR_CONTEXT = new RegExp(\n  String.raw`\\b(?:request|prompt|input|messages?)\\s+(?:is\\s+|are\\s+)?`\n  + String.raw`too\\s+(?:large|long)\\s+for\\s+(?:(?:this|the)\\s+)?`\n  + String.raw`(?:model(?:'s)?\\s+)?context(?:\\s+window)?\\b`,\n  'i',\n)\n\n/** \"Exceeds\" wording is only safe to classify when its object is explicitly the model context. */\nconst EXCEEDS_MODEL_CONTEXT = new RegExp(\n  String.raw`\\b(?:input|prompt|request|messages?)\\b.{0,40}`\n  + String.raw`\\b(?:exceed(?:s|ed)?|overflows?|is\\s+larger\\s+than)\\b.{0,40}`\n  + String.raw`\\b(?:the\\s+)?(?:model(?:'s)?\\s+)?context(?:\\s+(?:length|window))?\\b`,\n  'i',\n)\n\n/**\n * Recognize context-overflow wording.\n *\n * Both providers report this as a generic HTTP 400, so status alone cannot\n * separate \"your prompt is too long\" (worth compacting and retrying) from\n * \"your request is malformed\" (worth failing). The classifier is deliberately\n * narrow: it only fires when the wording names the context window, because a\n * false positive would make the caller compact history to fix a schema bug.\n * @param detail - provider error code/type/message text joined into one string.\n * @returns true when the detail identifies a request exceeding the model context window.\n */\nexport function isContextWindowExceededError(detail: string): boolean {\n  return STRUCTURED_CONTEXT_OVERFLOW.test(detail)\n    || /\\b(?:maximum|max)(?:\\s+(?:allowed|supported))?\\s+context\\s+(?:length|window)\\b/i.test(detail)\n    || TOO_LARGE_FOR_CONTEXT.test(detail)\n    || /\\b(?:input|prompt|request)\\s+(?:is\\s+)?too\\s+(?:long|large)\\s+for\\s+(?:this|the)\\s+model\\b/i.test(detail)\n    || EXCEEDS_MODEL_CONTEXT.test(detail)\n}\n\n/**\n * Recognize an exhausted account quota rather than a transient request-rate limit.\n *\n * The distinction matters because both can arrive as HTTP 429 and their retry\n * behaviour is opposite: a rate limit clears on its own, a spent balance never\n * does. Checked BEFORE the 429 mapping for that reason.\n * @param detail - provider error code/type/message text joined into one string.\n * @returns true only for terminal quota, balance, credit, budget, or usage-limit wording.\n */\nexport function isQuotaExceededError(detail: string): boolean {\n  return /\\binsufficient[\\s_-]+(?:quota|balance|credits?)\\b/i.test(detail)\n    || /\\b(?:quota|usage[\\s_-]+limit)[\\s_-]+(?:exceeded|exhausted|reached)\\b/i.test(detail)\n    || /\\bexceed(?:ed|s)?[\\s_-]+(?:(?:your|the)[\\s_-]+)?(?:current[\\s_-]+)?quota\\b/i.test(detail)\n    || /\\b(?:balance|credits?)[\\s_-]+(?:exhausted|depleted)\\b/i.test(detail)\n    || /\\bout[\\s_-]+of[\\s_-]+(?:credits?|budget)\\b/i.test(detail)\n}\n\n/**\n * Render a thrown value with its full `cause` chain and `AggregateError` members.\n *\n * Transport wrappers are the motivation: undici surfaces a bare\n * `TypeError: fetch failed` whose actual reason (DNS, TLS, ECONNRESET) lives\n * only in `cause`. Diagnostic surfaces only  Enever parse the result; route on\n * {@link AgentSdkError.code}.\n * @param value - the caught value (`unknown` in catch clauses).\n * @returns the outermost message first, each cause appended with `: ` (skipped\n *   when it repeats the wrapper message verbatim), and AggregateError members\n *   bracketed and `; `-joined.\n */\nexport function errorChain(value: unknown): string {\n  // Tracks the ACTIVE recursion path (entries removed on exit), so only true\n  // cycles are flagged and a diamond-shared cause still renders in full.\n  const path = new Set<unknown>()\n  const render = (current: unknown): string => {\n    if (path.has(current)) return '<circular cause>'\n    path.add(current)\n    try {\n      if (!(current instanceof Error)) {\n        if (typeof current === 'object' && current !== null) {\n          const descriptor = Object.getOwnPropertyDescriptor(current, 'message')\n          if (descriptor !== undefined && 'value' in descriptor && typeof descriptor.value === 'string') {\n            return descriptor.value\n          }\n        }\n        return String(current)\n      }\n      const message = current.message === '' ? current.name : current.message\n      const members = current instanceof AggregateError && current.errors.length > 0\n        ? ` [${current.errors.map(render).join('; ')}]`\n        : ''\n      const causeText = current.cause === undefined || current.cause === null\n        ? ''\n        : render(current.cause)\n      // Wrappers built as `new AgentSdkError(String(value), code, { cause: value })`\n      // repeat their cause verbatim; rendering it twice would only add noise.\n      const cause = causeText === '' || causeText === message ? '' : `: ${causeText}`\n      return `${message}${members}${cause}`\n    } catch {\n      // Only hostile coercion reaches here: a throwing toString/Symbol.toPrimitive\n      // on a non-Error, or a throwing message/name/cause getter on an Error\n      // subclass from a third-party SDK. This renderer feeds logs and user-facing\n      // notices, so nothing may escape it. Inner frames catch their own throws,\n      // so one hostile node collapses without taking the whole chain with it.\n      return '<unrenderable value>'\n    } finally {\n      path.delete(current)\n    }\n  }\n  return render(value)\n}\n\n/**\n * Narrow an arbitrary thrown value to an {@link AgentSdkError}.\n * @param value - the caught value (`unknown` in catch clauses).\n * @returns true only for real instances; duck-typed or cross-realm errors do not narrow.\n */\nexport function isAgentSdkError(value: unknown): value is AgentSdkError {\n  return value instanceof AgentSdkError\n}\n"],"mappings":"AAeA,IAAa,EAAb,cAAmC,KAAM,CAEvC,KAEA,YAAY,EAAiB,EAAc,EAAwB,CACjE,MAAM,EAAS,CAAO,EACtB,KAAK,KAAO,EACZ,KAAK,KAAO,WAAW,IACzB,CACF,EAGA,MAAa,EAA+B,0BAG/B,EAAsB,QAWtB,EAAsB,iBAGtB,EAA0B,qBAS1B,EAA0B,qBAGjC,EAA8B,IAAI,OACtC,OAAO,GAAG,sDACR,OAAO,GAAG,yEACZ,GACF,EAGM,EAAwB,IAAI,OAChC,OAAO,GAAG,2DACR,OAAO,GAAG,oDACV,OAAO,GAAG,8CACZ,GACF,EAGM,EAAwB,IAAI,OAChC,OAAO,GAAG,gDACR,OAAO,GAAG,+DACV,OAAO,GAAG,sEACZ,GACF,EAaA,SAAgB,EAA6B,EAAyB,CACpE,OAAO,EAA4B,KAAK,CAAM,GACzC,kFAAkF,KAAK,CAAM,GAC7F,EAAsB,KAAK,CAAM,GACjC,8FAA8F,KAAK,CAAM,GACzG,EAAsB,KAAK,CAAM,CACxC,CAWA,SAAgB,EAAqB,EAAyB,CAC5D,MAAO,qDAAqD,KAAK,CAAM,GAClE,wEAAwE,KAAK,CAAM,GACnF,8EAA8E,KAAK,CAAM,GACzF,yDAAyD,KAAK,CAAM,GACpE,8CAA8C,KAAK,CAAM,CAChE,CAcA,SAAgB,EAAW,EAAwB,CAGjD,IAAM,EAAO,IAAI,IACX,EAAU,GAA6B,CAC3C,GAAI,EAAK,IAAI,CAAO,EAAG,MAAO,mBAC9B,EAAK,IAAI,CAAO,EAChB,GAAI,CACF,GAAI,EAAE,aAAmB,OAAQ,CAC/B,GAAI,OAAO,GAAY,UAAY,EAAkB,CACnD,IAAM,EAAa,OAAO,yBAAyB,EAAS,SAAS,EACrE,GAAI,IAAe,IAAA,IAAa,UAAW,GAAc,OAAO,EAAW,OAAU,SACnF,OAAO,EAAW,KAEtB,CACA,OAAO,OAAO,CAAO,CACvB,CACA,IAAM,EAAU,EAAQ,UAAY,GAAK,EAAQ,KAAO,EAAQ,QAC1D,EAAU,aAAmB,gBAAkB,EAAQ,OAAO,OAAS,EACzE,KAAK,EAAQ,OAAO,IAAI,CAAM,CAAC,CAAC,KAAK,IAAI,EAAE,GAC3C,GACE,EAAY,EAAQ,QAAU,IAAA,IAAa,EAAQ,QAAU,KAC/D,GACA,EAAO,EAAQ,KAAK,EAIxB,MAAO,GAAG,IAAU,IADN,IAAc,IAAM,IAAc,EAAU,GAAK,KAAK,KAEtE,MAAQ,CAMN,MAAO,sBACT,QAAU,CACR,EAAK,OAAO,CAAO,CACrB,CACF,EACA,OAAO,EAAO,CAAK,CACrB,CAOA,SAAgB,EAAgB,EAAwC,CACtE,OAAO,aAAiB,CAC1B"}

package/dist/errors/capability-identity.d.ts

@@ -0,0 +1,10 @@
+//#region src/errors/capability-identity.d.ts
+interface CapabilityIdentityConflict {
+  readonly namespace: 'provider-plugin-id' | 'provider-route' | 'observation-exporter-id' | 'tool-source-id' | 'tool-name' | 'skill-provider-id' | 'skill-id' | 'team-member-name';
+  readonly key: string;
+  readonly firstIndex: number;
+  readonly secondIndex: number;
+}
+//#endregion
+export { CapabilityIdentityConflict };
+//# sourceMappingURL=capability-identity.d.ts.map

package/dist/errors/capability-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-identity.d.ts","names":[],"sources":["../../src/errors/capability-identity.ts"],"mappings":";UAEiB;WACN;WAEA;WACA;WACA"}

package/dist/errors/capability-identity.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"./agent-sdk-error.js";const t=`[redacted]`,n=new WeakMap;function r(e,n,r){return Object.freeze({namespace:e,key:t,firstIndex:n,secondIndex:r})}function i(t,n,i,a){return c(new e(`Capability identity conflicts in this scope`,t),r(n,i,a))}function a(e,t,n){let r=new Map;for(let[a,o]of n.entries()){let n=r.get(o);if(n!==void 0)throw i(e,t,n,a);r.set(o,a)}}function o(e,t){if(typeof t!=`object`&&typeof t!=`function`||t===null)return e;let r=n.get(t);return r===void 0?e:c(e,r)}function s(e){return(typeof e==`object`||typeof e==`function`)&&e!==null&&n.has(e)}function c(e,t){return Object.defineProperty(e,"conflict",{value:t,enumerable:!0,configurable:!1,writable:!1}),n.set(e,t),e}export{t as REDACTED_IDENTITY_KEY,a as assertCapabilityIdentityNamespace,r as capabilityIdentityConflict,i as capabilityIdentityError,o as inheritCapabilityIdentityConflict,s as isCapabilityIdentityError};
+//# sourceMappingURL=capability-identity.js.map

package/dist/errors/capability-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-identity.js","names":[],"sources":["../../src/errors/capability-identity.ts"],"sourcesContent":["import { AgentSdkError } from './agent-sdk-error.ts'\n\nexport interface CapabilityIdentityConflict {\n  readonly namespace: 'provider-plugin-id' | 'provider-route' | 'observation-exporter-id'\n    | 'tool-source-id' | 'tool-name' | 'skill-provider-id' | 'skill-id' | 'team-member-name'\n  readonly key: string\n  readonly firstIndex: number\n  readonly secondIndex: number\n}\n\nexport const REDACTED_IDENTITY_KEY = '[redacted]'\n\nexport type CapabilityIdentityError = AgentSdkError & {\n  readonly conflict: CapabilityIdentityConflict\n}\n\nconst conflicts = new WeakMap<object, CapabilityIdentityConflict>()\n\nexport function capabilityIdentityConflict(\n  namespace: CapabilityIdentityConflict['namespace'],\n  firstIndex: number,\n  secondIndex: number,\n): CapabilityIdentityConflict {\n  return Object.freeze({ namespace, key: REDACTED_IDENTITY_KEY, firstIndex, secondIndex })\n}\n\nexport function capabilityIdentityError(\n  code: string,\n  namespace: CapabilityIdentityConflict['namespace'],\n  firstIndex: number,\n  secondIndex: number,\n): CapabilityIdentityError {\n  const error = new AgentSdkError('Capability identity conflicts in this scope', code) as CapabilityIdentityError\n  return attachCapabilityIdentityConflict(error, capabilityIdentityConflict(namespace, firstIndex, secondIndex))\n}\n\nexport function assertCapabilityIdentityNamespace(\n  code: string,\n  namespace: CapabilityIdentityConflict['namespace'],\n  identities: readonly string[],\n): void {\n  const seen = new Map<string, number>()\n  for (const [index, identity] of identities.entries()) {\n    const first = seen.get(identity)\n    if (first !== undefined) throw capabilityIdentityError(code, namespace, first, index)\n    seen.set(identity, index)\n  }\n}\n\nexport function inheritCapabilityIdentityConflict<T extends Error>(target: T, source: unknown): T {\n  if ((typeof source !== 'object' && typeof source !== 'function') || source === null) return target\n  const conflict = conflicts.get(source)\n  return conflict === undefined ? target : attachCapabilityIdentityConflict(target, conflict)\n}\n\nexport function isCapabilityIdentityError(value: unknown): value is CapabilityIdentityError {\n  return (typeof value === 'object' || typeof value === 'function')\n    && value !== null && conflicts.has(value)\n}\n\nfunction attachCapabilityIdentityConflict<T extends Error>(\n  error: T,\n  conflict: CapabilityIdentityConflict,\n): T {\n  Object.defineProperty(error, 'conflict', {\n    value: conflict, enumerable: true, configurable: false, writable: false,\n  })\n  conflicts.set(error, conflict)\n  return error\n}\n"],"mappings":"qDAUA,MAAa,EAAwB,aAM/B,EAAY,IAAI,QAEtB,SAAgB,EACd,EACA,EACA,EAC4B,CAC5B,OAAO,OAAO,OAAO,CAAE,YAAW,IAAK,EAAuB,aAAY,aAAY,CAAC,CACzF,CAEA,SAAgB,EACd,EACA,EACA,EACA,EACyB,CAEzB,OAAO,EAAiC,IADtB,EAAc,8CAA+C,CACnC,EAAG,EAA2B,EAAW,EAAY,CAAW,CAAC,CAC/G,CAEA,SAAgB,EACd,EACA,EACA,EACM,CACN,IAAM,EAAO,IAAI,IACjB,IAAK,GAAM,CAAC,EAAO,KAAa,EAAW,QAAQ,EAAG,CACpD,IAAM,EAAQ,EAAK,IAAI,CAAQ,EAC/B,GAAI,IAAU,IAAA,GAAW,MAAM,EAAwB,EAAM,EAAW,EAAO,CAAK,EACpF,EAAK,IAAI,EAAU,CAAK,CAC1B,CACF,CAEA,SAAgB,EAAmD,EAAW,EAAoB,CAChG,GAAK,OAAO,GAAW,UAAY,OAAO,GAAW,YAAe,IAAW,KAAM,OAAO,EAC5F,IAAM,EAAW,EAAU,IAAI,CAAM,EACrC,OAAO,IAAa,IAAA,GAAY,EAAS,EAAiC,EAAQ,CAAQ,CAC5F,CAEA,SAAgB,EAA0B,EAAkD,CAC1F,OAAQ,OAAO,GAAU,UAAY,OAAO,GAAU,aACjD,IAAU,MAAQ,EAAU,IAAI,CAAK,CAC5C,CAEA,SAAS,EACP,EACA,EACG,CAKH,OAJA,OAAO,eAAe,EAAO,WAAY,CACvC,MAAO,EAAU,WAAY,GAAM,aAAc,GAAO,SAAU,EACpE,CAAC,EACD,EAAU,IAAI,EAAO,CAAQ,EACtB,CACT"}

package/dist/errors/failure.d.ts

@@ -0,0 +1,33 @@
+import { ProviderRequestId } from "../primitives/brand.js";
+//#region src/errors/failure.d.ts
+/**
+ * Serializable facts about a provider or transport failure.
+ *
+ * The live `Error` is what you throw; this is its data twin, safe to log, persist,
+ * or send across a process boundary — an `Error` survives neither
+ * `structuredClone` nor JSON with its class intact.
+ *
+ * Note what is deliberately absent: any judgement about whether to retry. These
+ * are facts; policy decides.
+ */
+interface ModelFailure {
+  /** Human-readable provider or transport failure summary. */
+  readonly message: string;
+  /** Stable provider-neutral machine-routing code. */
+  readonly code: string;
+  /** HTTP status returned by the provider, when available. */
+  readonly status?: number;
+  /** Provider-requested delay in milliseconds, when valid and available. */
+  readonly providerRetryAfterMs?: number;
+  /** Opaque provider-issued request identifier, for support escalation. */
+  readonly requestId?: ProviderRequestId;
+}
+/**
+ * Detach serializable provider facts from a value thrown by an adapter.
+ * @param value - arbitrary value thrown during adapter dispatch or iteration.
+ * @returns immutable provider-neutral facts, suitable for a terminal finish chunk.
+ */
+declare function normalizeModelFailure(value: unknown): ModelFailure;
+//#endregion
+export { ModelFailure, normalizeModelFailure };
+//# sourceMappingURL=failure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"failure.d.ts","names":[],"sources":["../../src/errors/failure.ts"],"mappings":";;;;;;;;;;;;UAoCiB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,YAAY;;;;;;;iBAQP,sBAAsB,iBAAiB"}

package/dist/errors/failure.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"./agent-sdk-error.js";import{MODEL_ERROR_CODES as t}from"./model-error.js";const n=new TextEncoder,r=Symbol(`invalid failure data`),i=Object.freeze({messageBytes:2048,codeBytes:128,requestIdBytes:1024});function a(n){let r=o(n)?n:void 0,i=r===void 0?void 0:u(r);if(r!==void 0&&i!==void 0&&i.code===l(r))return i;let a=s(n)?n:new e(c(n),t.UNKNOWN,{cause:n});return Object.freeze({message:m(a),code:h(a)})}function o(e){return typeof e==`object`&&!!e||typeof e==`function`}function s(e){try{return e instanceof Error}catch{return!1}}function c(e){try{let t=String(e);return t.length>0?t:`model adapter failed`}catch{return`model adapter failed`}}function l(e){try{let t=Object.getOwnPropertyDescriptor(e,`code`);return t!==void 0&&`value`in t?t.value:void 0}catch{return}}function u(e){try{let t=Object.getOwnPropertyDescriptor(e,`failure`);return t!==void 0&&`value`in t?d(t.value):void 0}catch{return}}function d(e){if(!o(e)||Array.isArray(e))return;let t=f(e,`message`),n=f(e,`code`),a=f(e,`status`),s=f(e,`providerRetryAfterMs`),c=f(e,`requestId`);if(!(t===r||n===r||a===r||s===r||c===r||!p(t,i.messageBytes)||!p(n,i.codeBytes)||a!==void 0&&(!Number.isSafeInteger(a)||a<100||a>599)||s!==void 0&&(!Number.isFinite(s)||s<=0)||c!==void 0&&!p(c,i.requestIdBytes)))return Object.freeze({message:t,code:n,...a===void 0?{}:{status:a},...s===void 0?{}:{providerRetryAfterMs:s},...c===void 0?{}:{requestId:c}})}function f(e,t){try{let n=Object.getOwnPropertyDescriptor(e,t);return n===void 0?void 0:`value`in n?n.value:r}catch{return r}}function p(e,t){return typeof e==`string`&&e.length>0&&n.encode(e).byteLength<=t}function m(e){let t=f(e,`message`);return p(t,i.messageBytes)?t:`model adapter failed`}function h(n){try{let r=l(n);return n instanceof e&&p(r,i.codeBytes)?r:t.UNKNOWN}catch{return t.UNKNOWN}}export{a as normalizeModelFailure};
+//# sourceMappingURL=failure.js.map

package/dist/errors/failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.js","names":[],"sources":["../../src/errors/failure.ts"],"sourcesContent":["/**\n * The serializable twin of a failure, and the hardened boundary that produces one\n * from an arbitrary thrown value.\n *\n * This module is written defensively on purpose. The value being normalized may\n * come from a third-party SDK, and such objects can define `message`, `code`, or\n * `failure` as GETTERS that throw, or sit behind a Proxy. If normalization itself\n * threw, the original failure would be replaced by a confusing secondary one — so\n * every read goes through `getOwnPropertyDescriptor`, checks for a data property,\n * and is individually contained.\n *\n * @module ai-agent-sdk/core/errors/failure\n */\n\nimport type { ProviderRequestId } from '../primitives/brand.ts'\nimport { AgentSdkError } from './agent-sdk-error.ts'\nimport { MODEL_ERROR_CODES } from './model-error.ts'\n\nconst ENCODER = new TextEncoder()\nconst INVALID_DATA = Symbol('invalid failure data')\nconst FAILURE_ENVELOPE_LIMITS = Object.freeze({\n  messageBytes: 2_048,\n  codeBytes: 128,\n  requestIdBytes: 1_024,\n})\n\n/**\n * Serializable facts about a provider or transport failure.\n *\n * The live `Error` is what you throw; this is its data twin, safe to log, persist,\n * or send across a process boundary — an `Error` survives neither\n * `structuredClone` nor JSON with its class intact.\n *\n * Note what is deliberately absent: any judgement about whether to retry. These\n * are facts; policy decides.\n */\nexport interface ModelFailure {\n  /** Human-readable provider or transport failure summary. */\n  readonly message: string\n  /** Stable provider-neutral machine-routing code. */\n  readonly code: string\n  /** HTTP status returned by the provider, when available. */\n  readonly status?: number\n  /** Provider-requested delay in milliseconds, when valid and available. */\n  readonly providerRetryAfterMs?: number\n  /** Opaque provider-issued request identifier, for support escalation. */\n  readonly requestId?: ProviderRequestId\n}\n\n/**\n * Detach serializable provider facts from a value thrown by an adapter.\n * @param value - arbitrary value thrown during adapter dispatch or iteration.\n * @returns immutable provider-neutral facts, suitable for a terminal finish chunk.\n */\nexport function normalizeModelFailure(value: unknown): ModelFailure {\n  const source = objectLike(value) ? value : undefined\n  // A ModelError from a DIFFERENT copy of this package keeps its own data but not\n  // its class identity, so `instanceof` misses it. Trust the carried facts only\n  // when both own properties survive validation and agree with each other.\n  const carried = source === undefined ? undefined : ownFailureSnapshot(source)\n  if (source !== undefined && carried !== undefined && carried.code === ownErrorCode(source)) return carried\n  const error = isError(value)\n    ? value\n    : new AgentSdkError(thrownMessage(value), MODEL_ERROR_CODES.UNKNOWN, { cause: value })\n  return Object.freeze({\n    message: errorMessage(error),\n    code: agentSdkErrorCode(error),\n  })\n}\n\nfunction objectLike(value: unknown): value is object {\n  return (typeof value === 'object' && value !== null) || typeof value === 'function'\n}\n\nfunction isError(value: unknown): value is Error {\n  try { return value instanceof Error } catch { return false }\n}\n\n/** Render a non-Error throw without letting hostile coercion escape. */\nfunction thrownMessage(value: unknown): string {\n  try {\n    const message = String(value)\n    return message.length > 0 ? message : 'model adapter failed'\n  } catch {\n    return 'model adapter failed'\n  }\n}\n\n/** Read a foreign error's own data-backed `code` without invoking accessors. */\nfunction ownErrorCode(error: object): unknown {\n  try {\n    const descriptor = Object.getOwnPropertyDescriptor(error, 'code')\n    return descriptor !== undefined && 'value' in descriptor ? descriptor.value : undefined\n  } catch {\n    return undefined\n  }\n}\n\n/** Snapshot an own data property without invoking an SDK-defined accessor. */\nfunction ownFailureSnapshot(error: object): ModelFailure | undefined {\n  try {\n    const descriptor = Object.getOwnPropertyDescriptor(error, 'failure')\n    return descriptor !== undefined && 'value' in descriptor\n      ? failureSnapshot(descriptor.value)\n      : undefined\n  } catch {\n    return undefined\n  }\n}\n\n/** Validate and detach an arbitrary serializable failure payload. */\nfunction failureSnapshot(value: unknown): ModelFailure | undefined {\n  if (!objectLike(value) || Array.isArray(value)) return undefined\n  const message = ownFailureData(value, 'message')\n  const code = ownFailureData(value, 'code')\n  const status = ownFailureData(value, 'status')\n  const providerRetryAfterMs = ownFailureData(value, 'providerRetryAfterMs')\n  const requestId = ownFailureData(value, 'requestId')\n  if (message === INVALID_DATA || code === INVALID_DATA || status === INVALID_DATA\n    || providerRetryAfterMs === INVALID_DATA || requestId === INVALID_DATA\n    || !boundedString(message, FAILURE_ENVELOPE_LIMITS.messageBytes)\n    || !boundedString(code, FAILURE_ENVELOPE_LIMITS.codeBytes)\n    || (status !== undefined && (!Number.isSafeInteger(status) || (status as number) < 100 || (status as number) > 599))\n    || (providerRetryAfterMs !== undefined\n      && (!Number.isFinite(providerRetryAfterMs) || (providerRetryAfterMs as number) <= 0))\n    || (requestId !== undefined && !boundedString(requestId, FAILURE_ENVELOPE_LIMITS.requestIdBytes))) {\n    return undefined\n  }\n  return Object.freeze({\n    message,\n    code,\n    ...status === undefined ? {} : { status: status as number },\n    ...providerRetryAfterMs === undefined ? {} : { providerRetryAfterMs: providerRetryAfterMs as number },\n    ...requestId === undefined ? {} : { requestId: requestId as ProviderRequestId },\n  })\n}\n\nfunction ownFailureData(source: object, key: PropertyKey): unknown {\n  try {\n    const descriptor = Object.getOwnPropertyDescriptor(source, key)\n    if (descriptor === undefined) return undefined\n    return 'value' in descriptor ? descriptor.value : INVALID_DATA\n  } catch {\n    return INVALID_DATA\n  }\n}\n\nfunction boundedString(value: unknown, maxBytes: number): value is string {\n  return typeof value === 'string' && value.length > 0\n    && ENCODER.encode(value).byteLength <= maxBytes\n}\n\n/** Read an error message without letting an accessor replace the primary failure. */\nfunction errorMessage(error: Error): string {\n  const message = ownFailureData(error, 'message')\n  if (boundedString(message, FAILURE_ENVELOPE_LIMITS.messageBytes)) return message\n  return 'model adapter failed'\n}\n\n/**\n * Trust only codes from this SDK's taxonomy.\n *\n * A third-party SDK's `code` is not our vocabulary — adopting it could let an\n * unrelated string like `ERR_BAD_REQUEST` collide with a retry allow-list entry.\n */\nfunction agentSdkErrorCode(error: Error): string {\n  try {\n    const code = ownErrorCode(error)\n    return error instanceof AgentSdkError\n      && boundedString(code, FAILURE_ENVELOPE_LIMITS.codeBytes)\n      ? code\n      : MODEL_ERROR_CODES.UNKNOWN\n  } catch {\n    return MODEL_ERROR_CODES.UNKNOWN\n  }\n}\n"],"mappings":"0GAkBA,MAAM,EAAU,IAAI,YACd,EAAe,OAAO,sBAAsB,EAC5C,EAA0B,OAAO,OAAO,CAC5C,aAAc,KACd,UAAW,IACX,eAAgB,IAClB,CAAC,EA8BD,SAAgB,EAAsB,EAA8B,CAClE,IAAM,EAAS,EAAW,CAAK,EAAI,EAAQ,IAAA,GAIrC,EAAU,IAAW,IAAA,GAAY,IAAA,GAAY,EAAmB,CAAM,EAC5E,GAAI,IAAW,IAAA,IAAa,IAAY,IAAA,IAAa,EAAQ,OAAS,EAAa,CAAM,EAAG,OAAO,EACnG,IAAM,EAAQ,EAAQ,CAAK,EACvB,EACA,IAAI,EAAc,EAAc,CAAK,EAAG,EAAkB,QAAS,CAAE,MAAO,CAAM,CAAC,EACvF,OAAO,OAAO,OAAO,CACnB,QAAS,EAAa,CAAK,EAC3B,KAAM,EAAkB,CAAK,CAC/B,CAAC,CACH,CAEA,SAAS,EAAW,EAAiC,CACnD,OAAQ,OAAO,GAAU,YAAY,GAAmB,OAAO,GAAU,UAC3E,CAEA,SAAS,EAAQ,EAAgC,CAC/C,GAAI,CAAE,OAAO,aAAiB,KAAM,MAAQ,CAAE,MAAO,EAAM,CAC7D,CAGA,SAAS,EAAc,EAAwB,CAC7C,GAAI,CACF,IAAM,EAAU,OAAO,CAAK,EAC5B,OAAO,EAAQ,OAAS,EAAI,EAAU,sBACxC,MAAQ,CACN,MAAO,sBACT,CACF,CAGA,SAAS,EAAa,EAAwB,CAC5C,GAAI,CACF,IAAM,EAAa,OAAO,yBAAyB,EAAO,MAAM,EAChE,OAAO,IAAe,IAAA,IAAa,UAAW,EAAa,EAAW,MAAQ,IAAA,EAChF,MAAQ,CACN,MACF,CACF,CAGA,SAAS,EAAmB,EAAyC,CACnE,GAAI,CACF,IAAM,EAAa,OAAO,yBAAyB,EAAO,SAAS,EACnE,OAAO,IAAe,IAAA,IAAa,UAAW,EAC1C,EAAgB,EAAW,KAAK,EAChC,IAAA,EACN,MAAQ,CACN,MACF,CACF,CAGA,SAAS,EAAgB,EAA0C,CACjE,GAAI,CAAC,EAAW,CAAK,GAAK,MAAM,QAAQ,CAAK,EAAG,OAChD,IAAM,EAAU,EAAe,EAAO,SAAS,EACzC,EAAO,EAAe,EAAO,MAAM,EACnC,EAAS,EAAe,EAAO,QAAQ,EACvC,EAAuB,EAAe,EAAO,sBAAsB,EACnE,EAAY,EAAe,EAAO,WAAW,EAC/C,SAAY,GAAgB,IAAS,GAAgB,IAAW,GAC/D,IAAyB,GAAgB,IAAc,GACvD,CAAC,EAAc,EAAS,EAAwB,YAAY,GAC5D,CAAC,EAAc,EAAM,EAAwB,SAAS,GACrD,IAAW,IAAA,KAAc,CAAC,OAAO,cAAc,CAAM,GAAM,EAAoB,KAAQ,EAAoB,MAC3G,IAAyB,IAAA,KACvB,CAAC,OAAO,SAAS,CAAoB,GAAM,GAAmC,IAChF,IAAc,IAAA,IAAa,CAAC,EAAc,EAAW,EAAwB,cAAc,GAGjG,OAAO,OAAO,OAAO,CACnB,UACA,OACA,GAAG,IAAW,IAAA,GAAY,CAAC,EAAI,CAAU,QAAiB,EAC1D,GAAG,IAAyB,IAAA,GAAY,CAAC,EAAI,CAAwB,sBAA+B,EACpG,GAAG,IAAc,IAAA,GAAY,CAAC,EAAI,CAAa,WAA+B,CAChF,CAAC,CACH,CAEA,SAAS,EAAe,EAAgB,EAA2B,CACjE,GAAI,CACF,IAAM,EAAa,OAAO,yBAAyB,EAAQ,CAAG,EAE9D,OADI,IAAe,IAAA,GAAW,OACvB,UAAW,EAAa,EAAW,MAAQ,CACpD,MAAQ,CACN,OAAO,CACT,CACF,CAEA,SAAS,EAAc,EAAgB,EAAmC,CACxE,OAAO,OAAO,GAAU,UAAY,EAAM,OAAS,GAC9C,EAAQ,OAAO,CAAK,CAAC,CAAC,YAAc,CAC3C,CAGA,SAAS,EAAa,EAAsB,CAC1C,IAAM,EAAU,EAAe,EAAO,SAAS,EAE/C,OADI,EAAc,EAAS,EAAwB,YAAY,EAAU,EAClE,sBACT,CAQA,SAAS,EAAkB,EAAsB,CAC/C,GAAI,CACF,IAAM,EAAO,EAAa,CAAK,EAC/B,OAAO,aAAiB,GACnB,EAAc,EAAM,EAAwB,SAAS,EACtD,EACA,EAAkB,OACxB,MAAQ,CACN,OAAO,EAAkB,OAC3B,CACF"}

package/dist/errors/model-error.d.ts

@@ -0,0 +1,83 @@
+import { ProviderRequestId } from "../primitives/brand.js";
+import { ModelFailure } from "./failure.js";
+import { AgentSdkError } from "./agent-sdk-error.js";
+//#region src/errors/model-error.d.ts
+/** Structured provider facts and cause accepted by {@link ModelError}. */
+interface ModelErrorOptions extends ErrorOptions {
+  /** Valid HTTP status observed at the provider boundary. */
+  status?: number;
+  /** Positive finite provider-requested delay in milliseconds. */
+  providerRetryAfterMs?: number;
+  /** Non-empty opaque provider request id. */
+  requestId?: ProviderRequestId;
+}
+/**
+ * Typed error for model-call failures, carrying a stable `code` from the shared
+ * taxonomy plus the serializable {@link failure} twin.
+ *
+ * The constructor validates rather than trusts. An out-of-range `status` or a
+ * negative `providerRetryAfterMs` means an adapter misread a header, and letting
+ * that through would put a retry to sleep for a nonsense duration.
+ */
+declare class ModelError extends AgentSdkError {
+  /** Serializable facts retained beside this live Error. */
+  readonly failure: ModelFailure;
+  /**
+   * @param message - non-empty human-readable failure summary.
+   * @param code - non-empty stable provider-neutral machine code.
+   * @param options - optional cause and validated serializable provider facts.
+   */
+  constructor(message: string, code: string, options?: ModelErrorOptions);
+}
+/**
+ * Codes produced at the provider boundary.
+ *
+ * Exported as a frozen object rather than a TS enum so that a third-party
+ * adapter can emit its own code without this union having to know about it.
+ * Retry eligibility is decided by policy against these values, never by the
+ * adapter that assigns them  Esee `retry-policy.ts`.
+ */
+declare const MODEL_ERROR_CODES: Readonly<{
+  /** Credentials were rejected (401/403). */
+  readonly AUTH: 'AUTH';
+  /** Transient request-rate limiting (429). */
+  readonly RATE_LIMIT: 'RATE_LIMIT';
+  /** Provider-side fault (5xx). */
+  readonly SERVER: 'SERVER';
+  /** The provider stopped producing output for longer than the idle bound. */
+  readonly TIMEOUT: 'TIMEOUT';
+  /** The request never completed at the network layer. */
+  readonly TRANSPORT: 'TRANSPORT';
+  /** The caller's signal aborted the request. */
+  readonly ABORTED: 'ABORTED';
+  /** An adapter ignored cancellation and may still own live work. */
+  readonly TEARDOWN_TIMEOUT: 'MODEL_TEARDOWN_TIMEOUT';
+  /** The provider rejected the request as malformed (400/413). */
+  readonly INVALID_REQUEST: 'INVALID_REQUEST';
+  /** A well-formed response could not be parsed. */
+  readonly MALFORMED_RESPONSE: 'MALFORMED_RESPONSE';
+  /** The response body ended before its terminating sentinel. */
+  readonly STREAM_CLOSED: 'STREAM_CLOSED';
+  /** The request carried content the selected model cannot accept. */
+  readonly UNSUPPORTED_CONTENT: 'UNSUPPORTED_CONTENT';
+  /** The request set an option this provider has no equivalent for. */
+  readonly UNSUPPORTED_OPTION: 'UNSUPPORTED_OPTION';
+  /** Nothing classified it; treated as non-retryable. */
+  readonly UNKNOWN: 'UNKNOWN';
+}>;
+/** Registry-level codes, raised before any provider I/O happens. */
+declare const REGISTRY_ERROR_CODES: Readonly<{
+  readonly NO_ADAPTER: 'NO_ADAPTER';
+  readonly DUPLICATE_ADAPTER: 'DUPLICATE_ADAPTER';
+  readonly INVALID_ADAPTER: 'INVALID_ADAPTER';
+  readonly INVALID_CATALOG: 'INVALID_CATALOG';
+  readonly INVALID_MODEL_INFO: 'INVALID_MODEL_INFO';
+  readonly UNSUPPORTED_REASONING_EFFORT: 'UNSUPPORTED_REASONING_EFFORT';
+  readonly UNSUPPORTED_NATIVE_TOOL: 'UNSUPPORTED_NATIVE_TOOL';
+  readonly OUTPUT_TOKEN_LIMIT_EXCEEDED: 'OUTPUT_TOKEN_LIMIT_EXCEEDED';
+  readonly INVALID_PREPARED_CALL: 'INVALID_PREPARED_CALL';
+  readonly REGISTRATION_DISPOSED: 'REGISTRATION_DISPOSED';
+}>;
+//#endregion
+export { MODEL_ERROR_CODES, ModelError, ModelErrorOptions, REGISTRY_ERROR_CODES };
+//# sourceMappingURL=model-error.d.ts.map

package/dist/errors/model-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-error.d.ts","names":[],"sources":["../../src/errors/model-error.ts"],"mappings":";;;;;UAiBiB,0BAA0B;;EAEzC;;EAEA;;EAEA,YAAY;;;;;;;;;;cAWD,mBAAmB;;WAErB,SAAS;;;;;;EAOlB,YAAY,iBAAiB,cAAc,UAAU;;;;;;;;;;cAyC1C,mBAAiB;;WAEtB;;WAEM;;WAEJ;;WAEC;;WAEE;;WAEF;;WAES;;WAED;;WAEG;;WAEL;;WAEM;;WAED;;WAEX;;;cAIE,sBAAoB;WACnB;WACO;WACF;WACA;WACG;WACU;WACL;WACI;WACN;WACA"}

package/dist/errors/model-error.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"./agent-sdk-error.js";var t=class extends e{failure;constructor(e,t,n){if(typeof e!=`string`||e.length===0)throw Error(`ModelError message must be a non-empty string`);if(typeof t!=`string`||t.length===0)throw Error(`ModelError code must be a non-empty string`);if(n?.status!==void 0&&(!Number.isInteger(n.status)||n.status<100||n.status>599))throw Error(`ModelError status must be an integer from 100 through 599`);if(n?.providerRetryAfterMs!==void 0&&(!Number.isFinite(n.providerRetryAfterMs)||n.providerRetryAfterMs<=0))throw Error(`ModelError providerRetryAfterMs must be a positive finite number`);if(n?.requestId!==void 0&&(typeof n.requestId!=`string`||n.requestId.length===0))throw Error(`ModelError requestId must be a non-empty string`);super(e,t,n),this.name=`ModelError`,this.failure=Object.freeze({message:e,code:t,...n?.status===void 0?{}:{status:n.status},...n?.providerRetryAfterMs===void 0?{}:{providerRetryAfterMs:n.providerRetryAfterMs},...n?.requestId===void 0?{}:{requestId:n.requestId}})}};const n=Object.freeze({AUTH:`AUTH`,RATE_LIMIT:`RATE_LIMIT`,SERVER:`SERVER`,TIMEOUT:`TIMEOUT`,TRANSPORT:`TRANSPORT`,ABORTED:`ABORTED`,TEARDOWN_TIMEOUT:`MODEL_TEARDOWN_TIMEOUT`,INVALID_REQUEST:`INVALID_REQUEST`,MALFORMED_RESPONSE:`MALFORMED_RESPONSE`,STREAM_CLOSED:`STREAM_CLOSED`,UNSUPPORTED_CONTENT:`UNSUPPORTED_CONTENT`,UNSUPPORTED_OPTION:`UNSUPPORTED_OPTION`,UNKNOWN:`UNKNOWN`}),r=Object.freeze({NO_ADAPTER:`NO_ADAPTER`,DUPLICATE_ADAPTER:`DUPLICATE_ADAPTER`,INVALID_ADAPTER:`INVALID_ADAPTER`,INVALID_CATALOG:`INVALID_CATALOG`,INVALID_MODEL_INFO:`INVALID_MODEL_INFO`,UNSUPPORTED_REASONING_EFFORT:`UNSUPPORTED_REASONING_EFFORT`,UNSUPPORTED_NATIVE_TOOL:`UNSUPPORTED_NATIVE_TOOL`,OUTPUT_TOKEN_LIMIT_EXCEEDED:`OUTPUT_TOKEN_LIMIT_EXCEEDED`,INVALID_PREPARED_CALL:`INVALID_PREPARED_CALL`,REGISTRATION_DISPOSED:`REGISTRATION_DISPOSED`});export{n as MODEL_ERROR_CODES,t as ModelError,r as REGISTRY_ERROR_CODES};
+//# sourceMappingURL=model-error.js.map

package/dist/errors/model-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-error.js","names":[],"sources":["../../src/errors/model-error.ts"],"sourcesContent":["/**\n * The error adapters throw, and the codes they classify failures into.\n *\n * {@link ModelError} validates its own inputs and exposes a frozen serializable\n * twin ({@link ModelFailure}). The pairing is the point: a live `Error` is what\n * you throw, and a plain data object is what you log, persist, or send across a\n * process boundary  Ean `Error` does not survive `structuredClone` or JSON with\n * its class intact.\n *\n * @module ai-agent-sdk/core/errors/model-error\n */\n\nimport type { ProviderRequestId } from '../primitives/brand.ts'\nimport { AgentSdkError } from './agent-sdk-error.ts'\nimport type { ModelFailure } from './failure.ts'\n\n/** Structured provider facts and cause accepted by {@link ModelError}. */\nexport interface ModelErrorOptions extends ErrorOptions {\n  /** Valid HTTP status observed at the provider boundary. */\n  status?: number\n  /** Positive finite provider-requested delay in milliseconds. */\n  providerRetryAfterMs?: number\n  /** Non-empty opaque provider request id. */\n  requestId?: ProviderRequestId\n}\n\n/**\n * Typed error for model-call failures, carrying a stable `code` from the shared\n * taxonomy plus the serializable {@link failure} twin.\n *\n * The constructor validates rather than trusts. An out-of-range `status` or a\n * negative `providerRetryAfterMs` means an adapter misread a header, and letting\n * that through would put a retry to sleep for a nonsense duration.\n */\nexport class ModelError extends AgentSdkError {\n  /** Serializable facts retained beside this live Error. */\n  readonly failure: ModelFailure\n\n  /**\n   * @param message - non-empty human-readable failure summary.\n   * @param code - non-empty stable provider-neutral machine code.\n   * @param options - optional cause and validated serializable provider facts.\n   */\n  constructor(message: string, code: string, options?: ModelErrorOptions) {\n    if (typeof message !== 'string' || message.length === 0) {\n      throw new Error('ModelError message must be a non-empty string')\n    }\n    if (typeof code !== 'string' || code.length === 0) {\n      throw new Error('ModelError code must be a non-empty string')\n    }\n    if (options?.status !== undefined\n      && (!Number.isInteger(options.status) || options.status < 100 || options.status > 599)) {\n      throw new Error('ModelError status must be an integer from 100 through 599')\n    }\n    if (options?.providerRetryAfterMs !== undefined\n      && (!Number.isFinite(options.providerRetryAfterMs) || options.providerRetryAfterMs <= 0)) {\n      throw new Error('ModelError providerRetryAfterMs must be a positive finite number')\n    }\n    if (options?.requestId !== undefined\n      && (typeof options.requestId !== 'string' || options.requestId.length === 0)) {\n      throw new Error('ModelError requestId must be a non-empty string')\n    }\n    super(message, code, options)\n    this.name = 'ModelError'\n    this.failure = Object.freeze({\n      message,\n      code,\n      ...options?.status === undefined ? {} : { status: options.status },\n      ...options?.providerRetryAfterMs === undefined\n        ? {}\n        : { providerRetryAfterMs: options.providerRetryAfterMs },\n      ...options?.requestId === undefined ? {} : { requestId: options.requestId },\n    })\n  }\n}\n\n/**\n * Codes produced at the provider boundary.\n *\n * Exported as a frozen object rather than a TS enum so that a third-party\n * adapter can emit its own code without this union having to know about it.\n * Retry eligibility is decided by policy against these values, never by the\n * adapter that assigns them  Esee `retry-policy.ts`.\n */\nexport const MODEL_ERROR_CODES = Object.freeze({\n  /** Credentials were rejected (401/403). */\n  AUTH: 'AUTH',\n  /** Transient request-rate limiting (429). */\n  RATE_LIMIT: 'RATE_LIMIT',\n  /** Provider-side fault (5xx). */\n  SERVER: 'SERVER',\n  /** The provider stopped producing output for longer than the idle bound. */\n  TIMEOUT: 'TIMEOUT',\n  /** The request never completed at the network layer. */\n  TRANSPORT: 'TRANSPORT',\n  /** The caller's signal aborted the request. */\n  ABORTED: 'ABORTED',\n  /** An adapter ignored cancellation and may still own live work. */\n  TEARDOWN_TIMEOUT: 'MODEL_TEARDOWN_TIMEOUT',\n  /** The provider rejected the request as malformed (400/413). */\n  INVALID_REQUEST: 'INVALID_REQUEST',\n  /** A well-formed response could not be parsed. */\n  MALFORMED_RESPONSE: 'MALFORMED_RESPONSE',\n  /** The response body ended before its terminating sentinel. */\n  STREAM_CLOSED: 'STREAM_CLOSED',\n  /** The request carried content the selected model cannot accept. */\n  UNSUPPORTED_CONTENT: 'UNSUPPORTED_CONTENT',\n  /** The request set an option this provider has no equivalent for. */\n  UNSUPPORTED_OPTION: 'UNSUPPORTED_OPTION',\n  /** Nothing classified it; treated as non-retryable. */\n  UNKNOWN: 'UNKNOWN',\n} as const)\n\n/** Registry-level codes, raised before any provider I/O happens. */\nexport const REGISTRY_ERROR_CODES = Object.freeze({\n  NO_ADAPTER: 'NO_ADAPTER',\n  DUPLICATE_ADAPTER: 'DUPLICATE_ADAPTER',\n  INVALID_ADAPTER: 'INVALID_ADAPTER',\n  INVALID_CATALOG: 'INVALID_CATALOG',\n  INVALID_MODEL_INFO: 'INVALID_MODEL_INFO',\n  UNSUPPORTED_REASONING_EFFORT: 'UNSUPPORTED_REASONING_EFFORT',\n  UNSUPPORTED_NATIVE_TOOL: 'UNSUPPORTED_NATIVE_TOOL',\n  OUTPUT_TOKEN_LIMIT_EXCEEDED: 'OUTPUT_TOKEN_LIMIT_EXCEEDED',\n  INVALID_PREPARED_CALL: 'INVALID_PREPARED_CALL',\n  REGISTRATION_DISPOSED: 'REGISTRATION_DISPOSED',\n} as const)\n"],"mappings":"qDAkCA,IAAa,EAAb,cAAgC,CAAc,CAE5C,QAOA,YAAY,EAAiB,EAAc,EAA6B,CACtE,GAAI,OAAO,GAAY,UAAY,EAAQ,SAAW,EACpD,MAAU,MAAM,+CAA+C,EAEjE,GAAI,OAAO,GAAS,UAAY,EAAK,SAAW,EAC9C,MAAU,MAAM,4CAA4C,EAE9D,GAAI,GAAS,SAAW,IAAA,KAClB,CAAC,OAAO,UAAU,EAAQ,MAAM,GAAK,EAAQ,OAAS,KAAO,EAAQ,OAAS,KAClF,MAAU,MAAM,2DAA2D,EAE7E,GAAI,GAAS,uBAAyB,IAAA,KAChC,CAAC,OAAO,SAAS,EAAQ,oBAAoB,GAAK,EAAQ,sBAAwB,GACtF,MAAU,MAAM,kEAAkE,EAEpF,GAAI,GAAS,YAAc,IAAA,KACrB,OAAO,EAAQ,WAAc,UAAY,EAAQ,UAAU,SAAW,GAC1E,MAAU,MAAM,iDAAiD,EAEnE,MAAM,EAAS,EAAM,CAAO,EAC5B,KAAK,KAAO,aACZ,KAAK,QAAU,OAAO,OAAO,CAC3B,UACA,OACA,GAAG,GAAS,SAAW,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,EAAQ,MAAO,EACjE,GAAG,GAAS,uBAAyB,IAAA,GACjC,CAAC,EACD,CAAE,qBAAsB,EAAQ,oBAAqB,EACzD,GAAG,GAAS,YAAc,IAAA,GAAY,CAAC,EAAI,CAAE,UAAW,EAAQ,SAAU,CAC5E,CAAC,CACH,CACF,EAUA,MAAa,EAAoB,OAAO,OAAO,CAE7C,KAAM,OAEN,WAAY,aAEZ,OAAQ,SAER,QAAS,UAET,UAAW,YAEX,QAAS,UAET,iBAAkB,yBAElB,gBAAiB,kBAEjB,mBAAoB,qBAEpB,cAAe,gBAEf,oBAAqB,sBAErB,mBAAoB,qBAEpB,QAAS,SACX,CAAU,EAGG,EAAuB,OAAO,OAAO,CAChD,WAAY,aACZ,kBAAmB,oBACnB,gBAAiB,kBACjB,gBAAiB,kBACjB,mBAAoB,qBACpB,6BAA8B,+BAC9B,wBAAyB,0BACzB,4BAA6B,8BAC7B,sBAAuB,wBACvB,sBAAuB,uBACzB,CAAU"}

package/dist/http/api-key.d.ts

@@ -0,0 +1,47 @@
+//#region src/http/api-key.d.ts
+/**
+ * The one definition of a well-formed provider API key, shared by every adapter
+ * that puts one into an HTTP header.
+ *
+ * @module ai-agent-sdk/core/http/api-key
+ */
+/** Why a supplied API key cannot be used. */
+type ApiKeyRejection = 'empty' | 'illegalCharacters';
+/** The verdict on one supplied API key. */
+type ApiKeyCheck = {
+  readonly ok: true;
+  readonly value: string;
+} | {
+  readonly ok: false;
+  readonly reason: ApiKeyRejection;
+};
+/**
+ * Judge one SUPPLIED API key, trimming surrounding whitespace first.
+ *
+ * Trimming is silent because a padded key has exactly one sensible reading, and
+ * keys routinely pick up whitespace from `.env` files and shell exports. Every
+ * other defect is reported rather than repaired.
+ *
+ * Absence is a state this function never sees: a route may legitimately
+ * authenticate through ambient provider credential discovery, so the caller
+ * decides whether a value was supplied at all before asking.
+ * @param raw - the key exactly as configured, stored, or typed.
+ * @returns the trimmed key, or why it cannot be used.
+ */
+declare function normalizeApiKey(raw: string): ApiKeyCheck;
+/**
+ * Accept one supplied credential, or refuse it with a diagnosis.
+ *
+ * Fails here rather than inside `fetch`, whose ByteString refusal names a UTF-16
+ * code point instead of the setting to change. The key itself NEVER enters the
+ * message: `ref` names where to fix it, and echoing any part of a secret into a
+ * log or a UI is precisely the failure this avoids.
+ * @param raw - the credential exactly as supplied.
+ * @param provider - the refusing provider name, prefixed to the diagnostic.
+ * @param ref - how the credential was referenced (e.g. an env var name).
+ * @returns the trimmed, usable key.
+ */
+declare function assertUsableApiKey(raw: string, provider: string, ref: string): string;
+//#endregion
+export { ApiKeyCheck, ApiKeyRejection, assertUsableApiKey, normalizeApiKey };
+//# sourceMappingURL=api-key.d.ts.map

package/dist/http/api-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.d.ts","names":[],"sources":["../../src/http/api-key.ts"],"mappings":";;;;;;;;KAsBY;;KAGA;WACG;WAAmB;;WACnB;WAAoB,QAAQ;;;;;;;;;;;;;;;iBAe3B,gBAAgB,cAAc;;;;;;;;;;;;;iBAmB9B,mBAAmB,aAAa,kBAAkB"}

package/dist/http/api-key.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e,INVALID_CREDENTIAL_CODE as t}from"../errors/agent-sdk-error.js";const n=/^[\x21-\x7E]+$/;function r(e){let t=e.trim();return t.length===0?{ok:!1,reason:`empty`}:n.test(t)?{ok:!0,value:t}:{ok:!1,reason:`illegalCharacters`}}function i(n,i,a){let o=r(n);if(o.ok)return o.value;throw new e(o.reason===`empty`?`${i}: the API key resolved from ${a} is blank; set ${a} to the raw key`:`${i}: the API key resolved from ${a} contains characters no HTTP header can carry; set ${a} to the raw key alone`,t)}export{i as assertUsableApiKey,r as normalizeApiKey};
+//# sourceMappingURL=api-key.js.map

package/dist/http/api-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.js","names":[],"sources":["../../src/http/api-key.ts"],"sourcesContent":["/**\n * The one definition of a well-formed provider API key, shared by every adapter\n * that puts one into an HTTP header.\n *\n * @module ai-agent-sdk/core/http/api-key\n */\n\nimport { AgentSdkError, INVALID_CREDENTIAL_CODE } from '../errors/agent-sdk-error.ts'\n\n/**\n * Characters an HTTP header value carries verbatim and every known provider key\n * uses: printable ASCII, space excluded.\n *\n * A key outside this set cannot reach ANY provider, because `fetch` refuses to\n * build the header  Eso this is a transport invariant, not one vendor's policy.\n * Latin-1 is excluded on purpose: a header could carry it, but no provider\n * issues it, and admitting it would trade a local explained refusal for an\n * opaque 401 much later.\n */\nconst LEGAL_API_KEY = /^[\\x21-\\x7E]+$/\n\n/** Why a supplied API key cannot be used. */\nexport type ApiKeyRejection = 'empty' | 'illegalCharacters'\n\n/** The verdict on one supplied API key. */\nexport type ApiKeyCheck =\n  | { readonly ok: true; readonly value: string }\n  | { readonly ok: false; readonly reason: ApiKeyRejection }\n\n/**\n * Judge one SUPPLIED API key, trimming surrounding whitespace first.\n *\n * Trimming is silent because a padded key has exactly one sensible reading, and\n * keys routinely pick up whitespace from `.env` files and shell exports. Every\n * other defect is reported rather than repaired.\n *\n * Absence is a state this function never sees: a route may legitimately\n * authenticate through ambient provider credential discovery, so the caller\n * decides whether a value was supplied at all before asking.\n * @param raw - the key exactly as configured, stored, or typed.\n * @returns the trimmed key, or why it cannot be used.\n */\nexport function normalizeApiKey(raw: string): ApiKeyCheck {\n  const value = raw.trim()\n  if (value.length === 0) return { ok: false, reason: 'empty' }\n  if (!LEGAL_API_KEY.test(value)) return { ok: false, reason: 'illegalCharacters' }\n  return { ok: true, value }\n}\n\n/**\n * Accept one supplied credential, or refuse it with a diagnosis.\n *\n * Fails here rather than inside `fetch`, whose ByteString refusal names a UTF-16\n * code point instead of the setting to change. The key itself NEVER enters the\n * message: `ref` names where to fix it, and echoing any part of a secret into a\n * log or a UI is precisely the failure this avoids.\n * @param raw - the credential exactly as supplied.\n * @param provider - the refusing provider name, prefixed to the diagnostic.\n * @param ref - how the credential was referenced (e.g. an env var name).\n * @returns the trimmed, usable key.\n */\nexport function assertUsableApiKey(raw: string, provider: string, ref: string): string {\n  const checked = normalizeApiKey(raw)\n  if (checked.ok) return checked.value\n  throw new AgentSdkError(\n    checked.reason === 'empty'\n      ? `${provider}: the API key resolved from ${ref} is blank; set ${ref} to the raw key`\n      : `${provider}: the API key resolved from ${ref} contains characters no HTTP header can carry;`\n        + ` set ${ref} to the raw key alone`,\n    INVALID_CREDENTIAL_CODE,\n  )\n}\n"],"mappings":"0FAmBA,MAAM,EAAgB,iBAuBtB,SAAgB,EAAgB,EAA0B,CACxD,IAAM,EAAQ,EAAI,KAAK,EAGvB,OAFI,EAAM,SAAW,EAAU,CAAE,GAAI,GAAO,OAAQ,OAAQ,EACvD,EAAc,KAAK,CAAK,EACtB,CAAE,GAAI,GAAM,OAAM,EADc,CAAE,GAAI,GAAO,OAAQ,mBAAoB,CAElF,CAcA,SAAgB,EAAmB,EAAa,EAAkB,EAAqB,CACrF,IAAM,EAAU,EAAgB,CAAG,EACnC,GAAI,EAAQ,GAAI,OAAO,EAAQ,MAC/B,MAAM,IAAI,EACR,EAAQ,SAAW,QACf,GAAG,EAAS,8BAA8B,EAAI,iBAAiB,EAAI,iBACnE,GAAG,EAAS,8BAA8B,EAAI,qDACpC,EAAI,uBAClB,CACF,CACF"}

package/dist/http/attribution.d.ts

@@ -0,0 +1,51 @@
+import { SDK_VERSION } from "../primitives/version.js";
+//#region src/http/attribution.d.ts
+/**
+ * This package's version, mirrored from `package.json`.
+ *
+ * A literal rather than a runtime manifest read, because the bundle targets
+ * neutral platforms where no module loader is guaranteed. Keep it in step with
+ * `package.json` on release.
+ */
+/**
+ * Static PUBLIC application identity sent to providers.
+ *
+ * Every field is a public product fact, safe on every request. No secrets, local
+ * paths, prompt text, or per-user identifiers belong here, and nothing
+ * per-request may influence the values.
+ */
+interface AppIdentity {
+  /** `User-Agent` product token (lowercase, hyphenated). */
+  product: string;
+  /** Product version. */
+  version: string;
+  /** Home URL of the app, used as the `User-Agent` comment. */
+  url: string;
+}
+/**
+ * This SDK's own identity: the default every adapter sends.
+ *
+ * An application that needs its own identity passes one to
+ * {@link attributionHeaders}; omission falls back here.
+ */
+declare const APP_IDENTITY: AppIdentity;
+/**
+ * The standard `User-Agent` value: `product/version (+url)`.
+ *
+ * The parenthesized `+url` comment is the conventional self-identification form
+ * (RFC 9110 §10.1.5 product-plus-comment syntax).
+ * @param identity - the identity to render; defaults to {@link APP_IDENTITY}.
+ * @returns the ready-to-send header value.
+ */
+declare function userAgent(identity?: AppIdentity): string;
+/**
+ * Build the attribution headers an adapter sends on every provider request.
+ *
+ * Header names are lowercase; HTTP field names are case-insensitive on the wire.
+ * @param identity - the identity to send; defaults to {@link APP_IDENTITY}.
+ * @returns headers to merge into the provider request.
+ */
+declare function attributionHeaders(identity?: AppIdentity): Record<string, string>;
+//#endregion
+export { APP_IDENTITY, AppIdentity, attributionHeaders, userAgent };
+//# sourceMappingURL=attribution.d.ts.map

package/dist/http/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","names":[],"sources":["../../src/http/attribution.ts"],"mappings":";;;;;;;;;;;;;;;;UA2BiB;;EAEf;;EAEA;;EAEA;;;;;;;;cASW,cAAc;;;;;;;;;iBAcX,UAAU,WAAU;;;;;;;;iBAWpB,mBAAmB,WAAU,cAA6B"}

package/dist/http/attribution.js

@@ -0,0 +1,2 @@
+import{SDK_VERSION as e}from"../primitives/version.js";const t={product:`ai-agent-sdk`,version:e,url:`https://github.com/dinh-ai/ai-agent-sdk`};function n(e=t){return`${e.product}/${e.version} (+${e.url})`}function r(e=t){return{"user-agent":n(e)}}export{t as APP_IDENTITY,e as SDK_VERSION,r as attributionHeaders,n as userAgent};
+//# sourceMappingURL=attribution.js.map

package/dist/http/attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.js","names":[],"sources":["../../src/http/attribution.ts"],"sourcesContent":["/**\n * The non-secret product identity every provider request sends as `User-Agent`.\n *\n * Centralized so adapters cannot drift apart, and defaulted so that omitting the\n * argument cannot silently suppress attribution.\n *\n * @module ai-agent-sdk/core/http/attribution\n */\n\nimport { SDK_VERSION } from '../primitives/version.ts'\n\nexport { SDK_VERSION }\n\n/**\n * This package's version, mirrored from `package.json`.\n *\n * A literal rather than a runtime manifest read, because the bundle targets\n * neutral platforms where no module loader is guaranteed. Keep it in step with\n * `package.json` on release.\n */\n/**\n * Static PUBLIC application identity sent to providers.\n *\n * Every field is a public product fact, safe on every request. No secrets, local\n * paths, prompt text, or per-user identifiers belong here, and nothing\n * per-request may influence the values.\n */\nexport interface AppIdentity {\n  /** `User-Agent` product token (lowercase, hyphenated). */\n  product: string\n  /** Product version. */\n  version: string\n  /** Home URL of the app, used as the `User-Agent` comment. */\n  url: string\n}\n\n/**\n * This SDK's own identity: the default every adapter sends.\n *\n * An application that needs its own identity passes one to\n * {@link attributionHeaders}; omission falls back here.\n */\nexport const APP_IDENTITY: AppIdentity = {\n  product: 'ai-agent-sdk',\n  version: SDK_VERSION,\n  url: 'https://github.com/dinh-ai/ai-agent-sdk',\n}\n\n/**\n * The standard `User-Agent` value: `product/version (+url)`.\n *\n * The parenthesized `+url` comment is the conventional self-identification form\n * (RFC 9110 §10.1.5 product-plus-comment syntax).\n * @param identity - the identity to render; defaults to {@link APP_IDENTITY}.\n * @returns the ready-to-send header value.\n */\nexport function userAgent(identity: AppIdentity = APP_IDENTITY): string {\n  return `${identity.product}/${identity.version} (+${identity.url})`\n}\n\n/**\n * Build the attribution headers an adapter sends on every provider request.\n *\n * Header names are lowercase; HTTP field names are case-insensitive on the wire.\n * @param identity - the identity to send; defaults to {@link APP_IDENTITY}.\n * @returns headers to merge into the provider request.\n */\nexport function attributionHeaders(identity: AppIdentity = APP_IDENTITY): Record<string, string> {\n  return { 'user-agent': userAgent(identity) }\n}\n"],"mappings":"uDA0CA,MAAa,EAA4B,CACvC,QAAS,eACT,QAAS,EACT,IAAK,yCACP,EAUA,SAAgB,EAAU,EAAwB,EAAsB,CACtE,MAAO,GAAG,EAAS,QAAQ,GAAG,EAAS,QAAQ,KAAK,EAAS,IAAI,EACnE,CASA,SAAgB,EAAmB,EAAwB,EAAsC,CAC/F,MAAO,CAAE,aAAc,EAAU,CAAQ,CAAE,CAC7C"}

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+import { Branded, MessageId, ProviderRequestId, ReasoningEffortId, ToolCallId } from "./primitives/brand.js";
+import { ModelFailure, normalizeModelFailure } from "./errors/failure.js";
+import { JsonObject, JsonValue, isJsonValue } from "./primitives/json.js";
+import { AssistantTextPhase, ContentBlock, ContentBlockMap, ContentBlockType, ImageBlock, ImageDetail, ImageMediaType, ImageSource, NativeToolCallBlock, ReasoningBlock, TextAnnotation, TextAnnotationMap, TextBlock, ToolCallBlock, ToolResultBlock, UrlCitationAnnotation } from "./message/content.js";
+import { FinishReason, FinishReasonMap, ReplayEnvelope, StreamChunk, TokenUsage } from "./stream/chunk.js";
+import { AgentSdkError, CONTEXT_WINDOW_EXCEEDED_CODE, EMPTY_RESPONSE_CODE, INVALID_CREDENTIAL_CODE, MISSING_CREDENTIAL_CODE, QUOTA_EXCEEDED_CODE, errorChain, isAgentSdkError, isContextWindowExceededError, isQuotaExceededError } from "./errors/agent-sdk-error.js";
+import { CorrelationContext, ObservationRunScope, SpanId, TraceId, createObservationRunScope, createOperationId, createSpanId, createTraceId, freezeCorrelation, isSpanId, isTraceId, traceparent } from "./observation/context.js";
+import { ObservationEvent, ObservationEventName, ObservationPhase, ObservationPriority, ObservationResource, ObservationResourceInput, OperationStatus, SafeErrorRecord, safeErrorRecord } from "./observation/event.js";
+import { CaptureReceipt, DeliveryMode, NOOP_OBSERVATION_PORT, ObservationBoundary, ObservationDeliverySummary, ObservationPort, ObservationSpan, ObservationSpanName, OpenObservationSpanInput, createCoreSpan, disabledDeliverySummary, snapshotObservationSpan, validObservationSpan, validateCaptureReceipt } from "./observation/port.js";
+import { AttemptUsageReport, DispatchState, UsageAdditionResult, UsageCounters, UsageCoverage, UsageValidationResult, addUsageCounters, classifyUsageCoverage, hasUsageCounters, possiblyBilledAttemptsWithoutUsage, validateUsageCounters } from "./observation/usage.js";
+import { LogLevel, SdkLogger } from "./logging/types.js";
+import { EndProviderAttemptInput, ModelCallHandle, ModelCallObservationError, ModelCallReport, ModelInvocationContext, OBSERVATION_ERROR_CODES, ProviderAttemptHandle, ProviderRetryScheduledInput, StartProviderAttemptInput } from "./observation/report.js";
+import { A2AMessageSource, AgentMessageSource, AssistantMessage, AssistantProvenance, Message, MessageSource, MessageSourceMap, ModelMessageSource, ToolMessageSource, ToolResultMessage, ToolResultMessageInput, UserMessage, createAssistantMessage, createMessage, createTextMessage, createToolResultMessage, createUserMessage, freezeMessage } from "./message/message.js";
+import { ModelToolSchema, NativeImageGenerationTool, NativeToolName, NativeToolSchema, NativeToolSchemaMap, NativeWebSearchTool, ToolChoice, ToolSchema, WebSearchLocation, isNativeToolSchema } from "./contract/tool.js";
+import { JsonSchemaOutputFormat, ModelOutputFormat, TextOutputFormat } from "./contract/output-format.js";
+import { GenerateOptions } from "./contract/generate-options.js";
+import { SupportSafeError } from "./support-safe/error.js";
+import { ModelCatalogOptions, ModelCatalogSnapshot, ModelCatalogState, ModelContext, ModelInfo, ModelModality, ModelModalityMap, ModelReasoningInfo, ProviderInfo, ReasoningEffortInfo, ResolvedModelInfo } from "./contract/model-info.js";
+import { AlwaysRetryPolicyConfig, BackoffConfig, MAX_TIMER_DELAY_MS, NormalRetryPolicyConfig, ResolvedAlwaysRetryPolicy, ResolvedNormalRetryPolicy, ResolvedRetryBackoff, ResolvedRetryPolicy, RetryPolicyConfig, backoffDelayMs, isRetryable, resolveRetryPolicy } from "./contract/retry-policy.js";
+import { ModelAdapter, PreparedAdapterCall } from "./contract/adapter.js";
+import { CallConfig, CallConfigAdapterDefaults, callConfigEquals } from "./contract/call-config.js";
+import { contentHasImage, projectImagesForTextModel, textOnlyImageText } from "./message/projection.js";
+import { deepFreeze } from "./primitives/freeze.js";
+import { assertNever } from "./primitives/never.js";
+import { detachedFrozen } from "./primitives/snapshot.js";
+import { SDK_VERSION } from "./primitives/version.js";
+import { ToolDefinition, ToolRunContext, defineTool } from "./agent/tool/definition.js";
+import { MODEL_ERROR_CODES, ModelError, ModelErrorOptions, REGISTRY_ERROR_CODES } from "./errors/model-error.js";
+import { BlockAssembler } from "./stream/assembler.js";
+import { withIdleTimeout } from "./stream/idle-timeout.js";
+import { ApprovalBroker, ApprovalDecision, ApprovalRequest, ApprovalStateStore, InteractiveApprovalBroker, InteractiveApprovalBrokerOptions, createApprovalBroker, createApprovalRequest, fixedApprovalBroker, withApprovalPersistence } from "./agent/tool/approval.js";
+import { AdapterRegistrationHandle, ModelProviderPlugin, ModelProviderRegistrar, PLUGIN_ERROR_CODES, PluginError, PluginRegistrationHandle, StreamMiddleware } from "./plugin/provider-plugin.js";
+import { ModelRegistry, ModelRegistryOptions, PreparedCall } from "./runtime/registry.js";
+import { RetryAttempt, WithRetryOptions, withRetry } from "./runtime/with-retry.js";
+import { ContextSection, ContextSectionResolveInput, ContextSectionScope, ContextSectionState, ContextToolTouch } from "./agent/context/types.js";
+import { InteractiveUserInputBroker, InteractiveUserInputBrokerOptions, UserInputAnswer, UserInputBroker, UserInputDecision, UserInputOption, UserInputQuestion, UserInputRequest, UserInputResponse, createUserInputBroker, fixedUserInputBroker } from "./agent/mode/user-input.js";
+import { AgentCompactionConfig, AgentCompactionOptions, resolveCompactionConfig } from "./agent/memory/compaction-config.js";
+import { ObservationDeliveryAck, ObservationDeliveryBatch, ObservationExportItem, RunReport, RunTerminalRecord } from "./agent/accounting/delivery-types.js";
+import { COMPACTION_INSTRUCTION, CompactionResult, ContextCompactor, ContextCompactorOptions } from "./agent/memory/compaction.js";
+import { AgentMemory, AgentMemoryConfig, AgentMemoryConfigInput, AgentMemoryItem, AgentMemoryKind, AgentMemorySeed, AgentMemorySnapshot, resolveMemoryConfig } from "./agent/memory/memory.js";
+import { MAX_SKILL_DESCRIPTION_CHARS, MAX_SKILL_ID_CHARS, MAX_SKILL_INSTRUCTIONS_CHARS, MAX_SKILL_NAME_CHARS, MAX_SKILL_RESOURCE_CHARS, MAX_SKILL_RESOURCE_PATH_CHARS, SKILL_ID_PATTERN, SkillCandidate, SkillDefinition, SkillDefinitionInput, SkillInvocationPolicy, SkillLookupOptions, SkillProvider, SkillProviderListOptions, SkillResourceBase, SkillResourceSummary, SkillSource, SkillSummary, defineSkill, defineSkillProvider, validateCandidate, validateSkillId, validateSkillResourcePath, validateSkillSource } from "./agent/skill/definition.js";
+import { SKILL_ERROR_CODES, SKILL_PROVIDER_API_VERSION } from "./agent/skill/provider/config.js";
+import { ActivatedSkillSnapshot, RuntimeSkillCandidate, RuntimeSkillLookupOptions, RuntimeSkillSource, SkillCatalogSnapshot, SkillProviderDefinition, SkillProviderPlugin, SkillProviderPluginDefinition, SkillReference } from "./agent/skill/provider/types.js";
+import { SkillCatalog, SkillCatalogOptions } from "./agent/skill/catalog.js";
+import { AgentSkillOptions, ResolvedAgentSkillOptions, SKILL_TOOL_NAMES, createSkillTools, renderSkillCatalog, resolveSkillOptions } from "./agent/skill/tools.js";
+import { AgentDefinition, AgentDefinitionInput, AgentDefinitionOverrides, CloneAgentOverrides, DefinedAgent } from "./agent/define/definition.js";
+import { AgentInput } from "./agent/define/session/types.js";
+import { MemoryBinding, MemoryCommitInput, MemoryCommitResult, MemoryLoadResult, MemoryScope, MemoryStore, MemoryStoreDefinition, MemoryStoreOptions } from "./agent/memory/persistence-types.js";
+import { estimateContextTokens, estimateMessageTokens } from "./agent/memory/token-estimator.js";
+import { selectCompactablePrefix } from "./agent/memory/surface-compaction.js";
+import { RuntimeSchema, defineToolFromSchema } from "./agent/tool/schema.js";
+import { ToolExecutionBackend, ToolExecutionCapabilities, ToolExecutionRequest, ToolExecutionStore, ToolOperation, ToolOperationClaim, createToolExecutionInterceptor, localToolExecutionBackend } from "./agent/tool/execution.js";
+import { RuntimeProviderInfo } from "./composition/provider/types.js";
+import { OBSERVATION_EXPORTER_API_VERSION, ObservationExporterPlugin, ObservationExporterPluginDefinition, RuntimeObservationExporterRegistration } from "./composition/exporter/types.js";
+import { RuntimeAgent, RuntimeAgentBindingInput, RuntimeAgentDefinition, RuntimeAgentDefinitionInput, RuntimeAgentInvocationOptions, RuntimeAgentLimits, RuntimeAgentResponse, RuntimeAgentRunEvent, RuntimeAgentRunEventContext, RuntimeAgentRunHandle, RuntimeAgentSession, RuntimeAgentSessionOptions, RuntimeAgentSessionSnapshot } from "./composition/agent/types.js";
+import { cloneAgent, defineAgent } from "./composition/agent/author.js";
+import { CapabilityIdentityConflict } from "./errors/capability-identity.js";
+import { RuntimeModelCatalogSnapshot } from "./composition/model-catalog/types.js";
+import { AgentTeamMemberInput, RuntimeAgentTeam, RuntimeAgentTeamEvent, RuntimeAgentTeamOptions } from "./composition/team/types.js";
+import { AgentRuntime, AgentRuntimeOptions, DiagnosticSnapshot, RuntimeCloseReport, RuntimeObservationResourceInput, RuntimeOwnerObservabilityOptions } from "./composition/runtime/types.js";
+import { createAgentRuntime } from "./composition/runtime/public.js";
+import { waitForSettlement } from "./async/settlement.js";
+import { ApiKeyCheck, ApiKeyRejection, assertUsableApiKey, normalizeApiKey } from "./http/api-key.js";
+import { APP_IDENTITY, AppIdentity, attributionHeaders, userAgent } from "./http/attribution.js";
+import { MEMORY_ERROR_CODES, MEMORY_STORE_API_VERSION } from "./composition/memory/config.js";
+import { defineMemoryStore } from "./composition/memory/definition.js";
+import { defineSkillProviderPlugin } from "./agent/skill/provider/definition.js";
+import { defineObservationExporter } from "./composition/exporter/definition.js";
+import { CONTEXT_SECTION_ID_PATTERN, CONTEXT_SECTION_INVALID, MAX_CONTEXT_SECTION_TEXT_BYTES, defineContextSection } from "./agent/context/section.js";
+export { type A2AMessageSource, APP_IDENTITY, type ActivatedSkillSnapshot, type AdapterRegistrationHandle, type AgentCompactionConfig, type AgentCompactionOptions, type AgentDefinition, type AgentDefinitionInput, type AgentDefinitionOverrides, type AgentInput, AgentMemory, type AgentMemoryConfig, type AgentMemoryConfigInput, type AgentMemoryItem, type AgentMemoryKind, type AgentMemorySeed, type AgentMemorySnapshot, type AgentMessageSource, type AgentRuntime, type AgentRuntimeOptions, AgentSdkError, type AgentSkillOptions, type AgentTeamMemberInput, type AlwaysRetryPolicyConfig, type ApiKeyCheck, type ApiKeyRejection, type AppIdentity, type ApprovalBroker, type ApprovalDecision, type ApprovalRequest, type ApprovalStateStore, type AssistantMessage, type AssistantProvenance, type AssistantTextPhase, type AttemptUsageReport, type BackoffConfig, BlockAssembler, type Branded, COMPACTION_INSTRUCTION, CONTEXT_SECTION_ID_PATTERN, CONTEXT_SECTION_INVALID, CONTEXT_WINDOW_EXCEEDED_CODE, type CallConfig, type CallConfigAdapterDefaults, type CapabilityIdentityConflict, type CaptureReceipt, type CloneAgentOverrides, type CompactionResult, type ContentBlock, type ContentBlockMap, type ContentBlockType, ContextCompactor, type ContextCompactorOptions, type ContextSection, type ContextSectionResolveInput, type ContextSectionScope, type ContextSectionState, type ContextToolTouch, type CorrelationContext, type DefinedAgent, type DeliveryMode, type DiagnosticSnapshot, type DispatchState, EMPTY_RESPONSE_CODE, type EndProviderAttemptInput, type FinishReason, type FinishReasonMap, type GenerateOptions, INVALID_CREDENTIAL_CODE, type ImageBlock, type ImageDetail, type ImageMediaType, type ImageSource, type InteractiveApprovalBroker, type InteractiveApprovalBrokerOptions, type InteractiveUserInputBroker, type InteractiveUserInputBrokerOptions, type JsonObject, type JsonSchemaOutputFormat, type JsonValue, type LogLevel, MAX_CONTEXT_SECTION_TEXT_BYTES, MAX_SKILL_DESCRIPTION_CHARS, MAX_SKILL_ID_CHARS, MAX_SKILL_INSTRUCTIONS_CHARS, MAX_SKILL_NAME_CHARS, MAX_SKILL_RESOURCE_CHARS, MAX_SKILL_RESOURCE_PATH_CHARS, MAX_TIMER_DELAY_MS, MEMORY_ERROR_CODES, MEMORY_STORE_API_VERSION, MISSING_CREDENTIAL_CODE, MODEL_ERROR_CODES, type MemoryBinding, type MemoryCommitInput, type MemoryCommitResult, type MemoryLoadResult, type MemoryScope, type MemoryStore, type MemoryStoreDefinition, type MemoryStoreOptions, type Message, MessageId, type MessageSource, type MessageSourceMap, ModelAdapter, type ModelCallHandle, ModelCallObservationError, type ModelCallReport, type ModelCatalogOptions, type ModelCatalogSnapshot, type ModelCatalogState, type ModelContext, ModelError, type ModelErrorOptions, type ModelFailure, type ModelInfo, type ModelInvocationContext, type ModelMessageSource, type ModelModality, type ModelModalityMap, type ModelOutputFormat, type ModelProviderPlugin, type ModelProviderRegistrar, type ModelReasoningInfo, ModelRegistry, type ModelRegistryOptions, type ModelToolSchema, NOOP_OBSERVATION_PORT, type NativeImageGenerationTool, type NativeToolCallBlock, type NativeToolName, type NativeToolSchema, type NativeToolSchemaMap, type NativeWebSearchTool, type NormalRetryPolicyConfig, OBSERVATION_ERROR_CODES, OBSERVATION_EXPORTER_API_VERSION, type ObservationBoundary, type ObservationDeliveryAck, type ObservationDeliveryBatch, type ObservationDeliverySummary, type ObservationEvent, type ObservationEventName, type ObservationExportItem, type ObservationExporterPlugin, type ObservationExporterPluginDefinition, type ObservationPhase, type ObservationPort, type ObservationPriority, type ObservationResource, type ObservationResourceInput, type ObservationRunScope, type ObservationSpan, type ObservationSpanName, type OpenObservationSpanInput, type OperationStatus, PLUGIN_ERROR_CODES, PluginError, type PluginRegistrationHandle, type PreparedAdapterCall, type PreparedCall, type ProviderAttemptHandle, type ProviderInfo, ProviderRequestId, type ProviderRetryScheduledInput, QUOTA_EXCEEDED_CODE, REGISTRY_ERROR_CODES, type ReasoningBlock, ReasoningEffortId, type ReasoningEffortInfo, type ReplayEnvelope, type ResolvedAgentSkillOptions, type ResolvedAlwaysRetryPolicy, type ResolvedModelInfo, type ResolvedNormalRetryPolicy, type ResolvedRetryBackoff, type ResolvedRetryPolicy, type RetryAttempt, type RetryPolicyConfig, type RunReport, type RunTerminalRecord, type RuntimeAgent, type RuntimeAgentBindingInput, type RuntimeAgentDefinition, type RuntimeAgentDefinitionInput, type RuntimeAgentInvocationOptions, type RuntimeAgentLimits, type RuntimeAgentResponse, type RuntimeAgentRunEvent, type RuntimeAgentRunEventContext, type RuntimeAgentRunHandle, type RuntimeAgentSession, type RuntimeAgentSessionOptions, type RuntimeAgentSessionSnapshot, type RuntimeAgentTeam, type RuntimeAgentTeamEvent, type RuntimeAgentTeamOptions, type RuntimeCloseReport, type RuntimeModelCatalogSnapshot, type RuntimeObservationExporterRegistration, type RuntimeObservationResourceInput, type RuntimeOwnerObservabilityOptions, type RuntimeProviderInfo, type RuntimeSchema, type RuntimeSkillCandidate, type RuntimeSkillLookupOptions, type RuntimeSkillSource, SDK_VERSION, SKILL_ERROR_CODES, SKILL_ID_PATTERN, SKILL_PROVIDER_API_VERSION, SKILL_TOOL_NAMES, type SafeErrorRecord, type SdkLogger, type SkillCandidate, SkillCatalog, type SkillCatalogOptions, type SkillCatalogSnapshot, type SkillDefinition, type SkillDefinitionInput, type SkillInvocationPolicy, type SkillLookupOptions, type SkillProvider, type SkillProviderDefinition, type SkillProviderListOptions, type SkillProviderPlugin, type SkillProviderPluginDefinition, type SkillReference, type SkillResourceBase, type SkillResourceSummary, type SkillSource, type SkillSummary, type SpanId, type StartProviderAttemptInput, type StreamChunk, type StreamMiddleware, type SupportSafeError, type TextAnnotation, type TextAnnotationMap, type TextBlock, type TextOutputFormat, type TokenUsage, type ToolCallBlock, ToolCallId, type ToolChoice, type ToolDefinition, type ToolExecutionBackend, type ToolExecutionCapabilities, type ToolExecutionRequest, type ToolExecutionStore, type ToolMessageSource, type ToolOperation, type ToolOperationClaim, type ToolResultBlock, type ToolResultMessage, type ToolResultMessageInput, type ToolRunContext, type ToolSchema, type TraceId, type UrlCitationAnnotation, type UsageAdditionResult, type UsageCounters, type UsageCoverage, type UsageValidationResult, type UserInputAnswer, type UserInputBroker, type UserInputDecision, type UserInputOption, type UserInputQuestion, type UserInputRequest, type UserInputResponse, type UserMessage, type WebSearchLocation, type WithRetryOptions, addUsageCounters, assertNever, assertUsableApiKey, attributionHeaders, backoffDelayMs, callConfigEquals, classifyUsageCoverage, cloneAgent, contentHasImage, createAgentRuntime, createApprovalBroker, createApprovalRequest, createAssistantMessage, createCoreSpan, createMessage, createObservationRunScope, createOperationId, createSkillTools, createSpanId, createTextMessage, createToolExecutionInterceptor, createToolResultMessage, createTraceId, createUserInputBroker, createUserMessage, deepFreeze, defineAgent, defineContextSection, defineMemoryStore, defineObservationExporter, defineSkill, defineSkillProvider, defineSkillProviderPlugin, defineTool, defineToolFromSchema, detachedFrozen, disabledDeliverySummary, errorChain, estimateContextTokens, estimateMessageTokens, fixedApprovalBroker, fixedUserInputBroker, freezeCorrelation, freezeMessage, hasUsageCounters, isAgentSdkError, isContextWindowExceededError, isJsonValue, isNativeToolSchema, isQuotaExceededError, isRetryable, isSpanId, isTraceId, localToolExecutionBackend, normalizeApiKey, normalizeModelFailure, possiblyBilledAttemptsWithoutUsage, projectImagesForTextModel, renderSkillCatalog, resolveCompactionConfig, resolveMemoryConfig, resolveRetryPolicy, resolveSkillOptions, safeErrorRecord, selectCompactablePrefix, snapshotObservationSpan, textOnlyImageText, traceparent, userAgent, validObservationSpan, validateCandidate, validateCaptureReceipt, validateSkillId, validateSkillResourcePath, validateSkillSource, validateUsageCounters, waitForSettlement, withApprovalPersistence, withIdleTimeout, withRetry };

package/dist/index.js

@@ -0,0 +1 @@
+import{MessageId as e,ProviderRequestId as t,ReasoningEffortId as n,ToolCallId as r}from"./primitives/brand.js";import{deepFreeze as i}from"./primitives/freeze.js";import{isJsonValue as a}from"./primitives/json.js";import{assertNever as o}from"./primitives/never.js";import{detachedFrozen as s}from"./primitives/snapshot.js";import{SDK_VERSION as c}from"./primitives/version.js";import{waitForSettlement as l}from"./async/settlement.js";import{createObservationRunScope as u,createOperationId as d,createSpanId as f,createTraceId as p,freezeCorrelation as m,isSpanId as h,isTraceId as g,traceparent as _}from"./observation/context.js";import{safeErrorRecord as v}from"./observation/event.js";import{NOOP_OBSERVATION_PORT as y,createCoreSpan as b,disabledDeliverySummary as x,snapshotObservationSpan as S,validObservationSpan as C,validateCaptureReceipt as w}from"./observation/port.js";import{AgentSdkError as T,CONTEXT_WINDOW_EXCEEDED_CODE as E,EMPTY_RESPONSE_CODE as D,INVALID_CREDENTIAL_CODE as O,MISSING_CREDENTIAL_CODE as k,QUOTA_EXCEEDED_CODE as A,errorChain as j,isAgentSdkError as M,isContextWindowExceededError as N,isQuotaExceededError as P}from"./errors/agent-sdk-error.js";import{ModelCallObservationError as F,OBSERVATION_ERROR_CODES as I}from"./observation/report.js";import{addUsageCounters as L,classifyUsageCoverage as R,hasUsageCounters as z,possiblyBilledAttemptsWithoutUsage as B,validateUsageCounters as V}from"./observation/usage.js";import{PLUGIN_ERROR_CODES as H,PluginError as U}from"./plugin/provider-plugin.js";import{MODEL_ERROR_CODES as W,ModelError as G,REGISTRY_ERROR_CODES as K}from"./errors/model-error.js";import{normalizeModelFailure as q}from"./errors/failure.js";import{createAssistantMessage as J,createMessage as Y,createTextMessage as X,createToolResultMessage as Z,createUserMessage as Q,freezeMessage as $}from"./message/message.js";import{contentHasImage as ee,projectImagesForTextModel as te,textOnlyImageText as ne}from"./message/projection.js";import{BlockAssembler as re}from"./stream/assembler.js";import{withIdleTimeout as ie}from"./stream/idle-timeout.js";import{ModelAdapter as ae}from"./contract/adapter.js";import{callConfigEquals as oe}from"./contract/call-config.js";import{MAX_TIMER_DELAY_MS as se,backoffDelayMs as ce,isRetryable as le,resolveRetryPolicy as ue}from"./contract/retry-policy.js";import{isNativeToolSchema as de}from"./contract/tool.js";import{ModelRegistry as fe}from"./runtime/registry.js";import{withRetry as pe}from"./runtime/with-retry.js";import{assertUsableApiKey as me,normalizeApiKey as he}from"./http/api-key.js";import{APP_IDENTITY as ge,attributionHeaders as _e,userAgent as ve}from"./http/attribution.js";import{AgentMemory as ye,resolveMemoryConfig as be}from"./agent/memory/memory.js";import{estimateContextTokens as xe,estimateMessageTokens as Se}from"./agent/memory/token-estimator.js";import{selectCompactablePrefix as Ce}from"./agent/memory/surface-compaction.js";import{COMPACTION_INSTRUCTION as we,ContextCompactor as Te}from"./agent/memory/compaction.js";import{resolveCompactionConfig as Ee}from"./agent/memory/compaction-config.js";import{MEMORY_ERROR_CODES as De,MEMORY_STORE_API_VERSION as Oe}from"./composition/memory/config.js";import{defineMemoryStore as ke}from"./composition/memory/definition.js";import{MAX_SKILL_DESCRIPTION_CHARS as Ae,MAX_SKILL_ID_CHARS as je,MAX_SKILL_INSTRUCTIONS_CHARS as Me,MAX_SKILL_NAME_CHARS as Ne,MAX_SKILL_RESOURCE_CHARS as Pe,MAX_SKILL_RESOURCE_PATH_CHARS as Fe,SKILL_ID_PATTERN as Ie,defineSkill as Le,defineSkillProvider as Re,validateCandidate as ze,validateSkillId as Be,validateSkillResourcePath as Ve,validateSkillSource as He}from"./agent/skill/definition.js";import{SKILL_ERROR_CODES as Ue,SKILL_PROVIDER_API_VERSION as We}from"./agent/skill/provider/config.js";import{defineSkillProviderPlugin as Ge}from"./agent/skill/provider/definition.js";import{SkillCatalog as Ke}from"./agent/skill/catalog.js";import{defineTool as qe}from"./agent/tool/definition.js";import{SKILL_TOOL_NAMES as Je,createSkillTools as Ye,renderSkillCatalog as Xe,resolveSkillOptions as Ze}from"./agent/skill/tools.js";import{OBSERVATION_EXPORTER_API_VERSION as Qe}from"./composition/exporter/types.js";import{CONTEXT_SECTION_ID_PATTERN as $e,CONTEXT_SECTION_INVALID as et,MAX_CONTEXT_SECTION_TEXT_BYTES as tt,defineContextSection as nt}from"./agent/context/section.js";import{createApprovalBroker as rt,createApprovalRequest as it,fixedApprovalBroker as at,withApprovalPersistence as ot}from"./agent/tool/approval.js";import{createAgentRuntime as st}from"./composition/runtime/public.js";import{cloneAgent as ct,defineAgent as lt}from"./composition/agent/author.js";import{defineObservationExporter as ut}from"./composition/exporter/definition.js";import{createUserInputBroker as dt,fixedUserInputBroker as ft}from"./agent/mode/user-input.js";import{defineToolFromSchema as pt}from"./agent/tool/schema.js";import{createToolExecutionInterceptor as mt,localToolExecutionBackend as ht}from"./agent/tool/execution.js";export{ge as APP_IDENTITY,ye as AgentMemory,T as AgentSdkError,re as BlockAssembler,we as COMPACTION_INSTRUCTION,$e as CONTEXT_SECTION_ID_PATTERN,et as CONTEXT_SECTION_INVALID,E as CONTEXT_WINDOW_EXCEEDED_CODE,Te as ContextCompactor,D as EMPTY_RESPONSE_CODE,O as INVALID_CREDENTIAL_CODE,tt as MAX_CONTEXT_SECTION_TEXT_BYTES,Ae as MAX_SKILL_DESCRIPTION_CHARS,je as MAX_SKILL_ID_CHARS,Me as MAX_SKILL_INSTRUCTIONS_CHARS,Ne as MAX_SKILL_NAME_CHARS,Pe as MAX_SKILL_RESOURCE_CHARS,Fe as MAX_SKILL_RESOURCE_PATH_CHARS,se as MAX_TIMER_DELAY_MS,De as MEMORY_ERROR_CODES,Oe as MEMORY_STORE_API_VERSION,k as MISSING_CREDENTIAL_CODE,W as MODEL_ERROR_CODES,e as MessageId,ae as ModelAdapter,F as ModelCallObservationError,G as ModelError,fe as ModelRegistry,y as NOOP_OBSERVATION_PORT,I as OBSERVATION_ERROR_CODES,Qe as OBSERVATION_EXPORTER_API_VERSION,H as PLUGIN_ERROR_CODES,U as PluginError,t as ProviderRequestId,A as QUOTA_EXCEEDED_CODE,K as REGISTRY_ERROR_CODES,n as ReasoningEffortId,c as SDK_VERSION,Ue as SKILL_ERROR_CODES,Ie as SKILL_ID_PATTERN,We as SKILL_PROVIDER_API_VERSION,Je as SKILL_TOOL_NAMES,Ke as SkillCatalog,r as ToolCallId,L as addUsageCounters,o as assertNever,me as assertUsableApiKey,_e as attributionHeaders,ce as backoffDelayMs,oe as callConfigEquals,R as classifyUsageCoverage,ct as cloneAgent,ee as contentHasImage,st as createAgentRuntime,rt as createApprovalBroker,it as createApprovalRequest,J as createAssistantMessage,b as createCoreSpan,Y as createMessage,u as createObservationRunScope,d as createOperationId,Ye as createSkillTools,f as createSpanId,X as createTextMessage,mt as createToolExecutionInterceptor,Z as createToolResultMessage,p as createTraceId,dt as createUserInputBroker,Q as createUserMessage,i as deepFreeze,lt as defineAgent,nt as defineContextSection,ke as defineMemoryStore,ut as defineObservationExporter,Le as defineSkill,Re as defineSkillProvider,Ge as defineSkillProviderPlugin,qe as defineTool,pt as defineToolFromSchema,s as detachedFrozen,x as disabledDeliverySummary,j as errorChain,xe as estimateContextTokens,Se as estimateMessageTokens,at as fixedApprovalBroker,ft as fixedUserInputBroker,m as freezeCorrelation,$ as freezeMessage,z as hasUsageCounters,M as isAgentSdkError,N as isContextWindowExceededError,a as isJsonValue,de as isNativeToolSchema,P as isQuotaExceededError,le as isRetryable,h as isSpanId,g as isTraceId,ht as localToolExecutionBackend,he as normalizeApiKey,q as normalizeModelFailure,B as possiblyBilledAttemptsWithoutUsage,te as projectImagesForTextModel,Xe as renderSkillCatalog,Ee as resolveCompactionConfig,be as resolveMemoryConfig,ue as resolveRetryPolicy,Ze as resolveSkillOptions,v as safeErrorRecord,Ce as selectCompactablePrefix,S as snapshotObservationSpan,ne as textOnlyImageText,_ as traceparent,ve as userAgent,C as validObservationSpan,ze as validateCandidate,w as validateCaptureReceipt,Be as validateSkillId,Ve as validateSkillResourcePath,He as validateSkillSource,V as validateUsageCounters,l as waitForSettlement,ot as withApprovalPersistence,ie as withIdleTimeout,pe as withRetry};