@alvin0/ai-agent-sdk-core 0.1.0

package/dist/observation/report.d.ts

@@ -0,0 +1,117 @@
+import { StreamChunk } from "../stream/chunk.js";
+import { AgentSdkError } from "../errors/agent-sdk-error.js";
+import { CorrelationContext, ObservationRunScope, SpanId, TraceId } from "./context.js";
+import { ObservationResource, OperationStatus, SafeErrorRecord } from "./event.js";
+import { ObservationDeliverySummary, ObservationPort } from "./port.js";
+import { AttemptUsageReport, DispatchState, UsageCounters, UsageCoverage } from "./usage.js";
+import { SdkLogger } from "../logging/types.js";
+//#region src/observation/report.d.ts
+interface ModelCallReport {
+  readonly runId: string;
+  readonly traceId: TraceId;
+  readonly modelCallId: string;
+  readonly spanId: SpanId;
+  readonly provider: string;
+  /** Provider family independently of the selected route, when installed as a plugin. */
+  readonly providerFamily?: string;
+  /** Exact plugin installation that owned the selected route. */
+  readonly providerPluginId?: string;
+  readonly model: string;
+  readonly status: OperationStatus;
+  readonly startedAt: string;
+  readonly endedAt: string;
+  readonly durationMs: number;
+  readonly finishReason?: string;
+  /** Logical dispatch state, retained even when an adapter did not expose physical attempts. */
+  readonly dispatchState?: DispatchState;
+  readonly coverage: UsageCoverage;
+  readonly reported: UsageCounters;
+  readonly estimated?: UsageCounters;
+  readonly attempts: readonly AttemptUsageReport[];
+  readonly possiblyBilledAttemptsWithoutUsage: number;
+  readonly authoritative: boolean;
+  readonly delivery: ObservationDeliverySummary;
+  readonly error?: SafeErrorRecord;
+}
+interface ModelCallHandle extends AsyncIterable<StreamChunk> {
+  readonly runId: string;
+  readonly modelCallId: string;
+  readonly report: Promise<ModelCallReport>;
+}
+/** Safe facts known immediately before one physical provider dispatch. */
+interface StartProviderAttemptInput {
+  readonly provider: string;
+  readonly model: string;
+  readonly method: string;
+  /** Scheme, host, and explicit non-default port only; never a path or query. */
+  readonly origin: string;
+}
+/** Terminal facts supplied by a transport after exactly one dispatch boundary. */
+interface EndProviderAttemptInput {
+  readonly status: OperationStatus;
+  readonly dispatchState: DispatchState;
+  readonly reported?: UsageCounters;
+  readonly httpStatus?: number;
+  readonly providerRequestId?: string;
+  /** Must already be safe for support reports; raw response bodies are forbidden. */
+  readonly error?: SafeErrorRecord;
+}
+/** Safe scheduling facts between two physical provider attempts. */
+interface ProviderRetryScheduledInput {
+  readonly nextAttemptNumber: number;
+  readonly delayMs: number;
+  readonly failureCode: string;
+}
+/** One physical provider-attempt lifecycle owned by the model-call handle. */
+interface ProviderAttemptHandle {
+  readonly attemptId: string;
+  readonly attemptNumber: number;
+  readonly traceparent: string;
+  end(input: EndProviderAttemptInput): AttemptUsageReport;
+}
+interface ModelInvocationContext {
+  readonly observation?: ObservationPort;
+  /** Safe SDK/service/runtime identity copied onto nested provider operations. */
+  readonly resource?: ObservationResource;
+  readonly correlation?: Partial<CorrelationContext>;
+  readonly terminalCheckpointOwner?: 'model-call' | 'agent-run';
+  /** Shared sequence/monotonic scope when this call belongs to a larger agent run. */
+  readonly scope?: ObservationRunScope;
+  /** Always present on AgentRuntime calls; optional for preserved low-level callers. */
+  readonly logger?: SdkLogger;
+  /** Declares that the adapter will report the real network boundary itself. */
+  readonly declareProviderAttemptAccounting?: () => void;
+  /**
+   * Internal transport accounting boundary. HTTP providers call this immediately
+   * before dispatch; audit mode may reject before any network request is invoked.
+   */
+  readonly startProviderAttempt?: (input: StartProviderAttemptInput, signal?: AbortSignal) => Promise<ProviderAttemptHandle>;
+  readonly recordProviderRetry?: (input: ProviderRetryScheduledInput) => void;
+}
+declare const OBSERVATION_ERROR_CODES: Readonly<{
+  readonly AUDIT_UNAVAILABLE: 'OBSERVABILITY_AUDIT_UNAVAILABLE';
+  readonly CAPTURE_REJECTED: 'OBSERVABILITY_CAPTURE_REJECTED';
+  readonly PROCESSOR_FAILED: 'OBSERVABILITY_PROCESSOR_FAILED';
+  readonly EXPORT_FAILED: 'OBSERVABILITY_EXPORT_FAILED';
+  readonly FLUSH_TIMEOUT: 'OBSERVABILITY_FLUSH_TIMEOUT';
+  readonly JOURNAL_CORRUPT: 'OBSERVABILITY_JOURNAL_CORRUPT';
+  readonly JOURNAL_IO: 'OBSERVABILITY_JOURNAL_IO';
+  readonly BROWSER_QUOTA: 'OBSERVABILITY_BROWSER_QUOTA';
+  readonly OTEL_PROVIDER_UNCONFIGURED: 'OTEL_PROVIDER_UNCONFIGURED';
+  readonly OPERATION_TERMINAL_MISSING: 'OPERATION_TERMINAL_MISSING';
+  readonly LEDGER_LIMIT_EXCEEDED: 'LEDGER_LIMIT_EXCEEDED';
+  readonly USAGE_MISSING: 'USAGE_MISSING';
+  readonly USAGE_REQUIRED: 'USAGE_REQUIRED';
+  readonly USAGE_INVALID: 'USAGE_INVALID';
+  readonly USAGE_COUNTER_OVERFLOW: 'USAGE_COUNTER_OVERFLOW';
+}>;
+declare class ModelCallObservationError extends AgentSdkError {
+  readonly runId: string;
+  readonly modelCallId: string;
+  readonly traceId: TraceId;
+  readonly report: ModelCallReport;
+  constructor(message: string, report: ModelCallReport, options?: ErrorOptions);
+}
+//#endregion
+export { EndProviderAttemptInput, ModelCallHandle, ModelCallObservationError, ModelCallReport, ModelInvocationContext, OBSERVATION_ERROR_CODES, ProviderAttemptHandle, ProviderRetryScheduledInput, StartProviderAttemptInput };
+//# sourceMappingURL=report.d.ts.map

package/dist/observation/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","names":[],"sources":["../../src/observation/report.ts"],"mappings":";;;;;;;;UAQiB;WACN;WACA,SAAS;WACT;WACA,QAAQ;WACR;;WAEA;;WAEA;WACA;WACA,QAAQ;WACR;WACA;WACA;WACA;;WAEA,gBAAgB;WAChB,UAAU;WACV,UAAU;WACV,YAAY;WACZ,mBAAmB;WACnB;WACA;WACA,UAAU;WACV,QAAQ;;UAGF,wBAAwB,cAAc;WAC5C;WACA;WACA,QAAQ,QAAQ;;;UAIV;WACN;WACA;WACA;;WAEA;;;UAIM;WACN,QAAQ;WACR,eAAe;WACf,WAAW;WACX;WACA;;WAEA,QAAQ;;;UAIF;WACN;WACA;WACA;;;UAIM;WACN;WACA;WACA;EACT,IAAI,OAAO,0BAA0B;;UAGtB;WACN,cAAc;;WAEd,WAAW;WACX,cAAc,QAAQ;WACtB;;WAEA,QAAQ;;WAER,SAAS;;WAET;;;;;WAKA,wBACP,OAAO,2BACP,SAAS,gBACN,QAAQ;WACJ,uBAAuB,OAAO;;cAG5B,yBAAuB;WACf;WACD;WACA;WACH;WACA;WACE;WACL;WACG;WACa;WACA;WACL;WACR;WACC;WACD;WACS;;cAGb,kCAAkC;WACpC;WACA;WACA,SAAS;WACT,QAAQ;EAEjB,YAAY,iBAAiB,QAAQ,iBAAiB,UAAU"}

package/dist/observation/report.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"../errors/agent-sdk-error.js";const t=Object.freeze({AUDIT_UNAVAILABLE:`OBSERVABILITY_AUDIT_UNAVAILABLE`,CAPTURE_REJECTED:`OBSERVABILITY_CAPTURE_REJECTED`,PROCESSOR_FAILED:`OBSERVABILITY_PROCESSOR_FAILED`,EXPORT_FAILED:`OBSERVABILITY_EXPORT_FAILED`,FLUSH_TIMEOUT:`OBSERVABILITY_FLUSH_TIMEOUT`,JOURNAL_CORRUPT:`OBSERVABILITY_JOURNAL_CORRUPT`,JOURNAL_IO:`OBSERVABILITY_JOURNAL_IO`,BROWSER_QUOTA:`OBSERVABILITY_BROWSER_QUOTA`,OTEL_PROVIDER_UNCONFIGURED:`OTEL_PROVIDER_UNCONFIGURED`,OPERATION_TERMINAL_MISSING:`OPERATION_TERMINAL_MISSING`,LEDGER_LIMIT_EXCEEDED:`LEDGER_LIMIT_EXCEEDED`,USAGE_MISSING:`USAGE_MISSING`,USAGE_REQUIRED:`USAGE_REQUIRED`,USAGE_INVALID:`USAGE_INVALID`,USAGE_COUNTER_OVERFLOW:`USAGE_COUNTER_OVERFLOW`});var n=class extends e{runId;modelCallId;traceId;report;constructor(e,n,r){super(e,t.AUDIT_UNAVAILABLE,r),this.name=`ModelCallObservationError`,this.runId=n.runId,this.modelCallId=n.modelCallId,this.traceId=n.traceId,this.report=n}};export{n as ModelCallObservationError,t as OBSERVATION_ERROR_CODES};
+//# sourceMappingURL=report.js.map

package/dist/observation/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","names":[],"sources":["../../src/observation/report.ts"],"sourcesContent":["import type { StreamChunk } from '../stream/chunk.ts'\nimport { AgentSdkError } from '../errors/agent-sdk-error.ts'\nimport type { CorrelationContext, ObservationRunScope, SpanId, TraceId } from './context.ts'\nimport type { ObservationResource, OperationStatus, SafeErrorRecord } from './event.ts'\nimport type { ObservationDeliverySummary, ObservationPort } from './port.ts'\nimport type { AttemptUsageReport, DispatchState, UsageCounters, UsageCoverage } from './usage.ts'\nimport type { SdkLogger } from '../logging/types.ts'\n\nexport interface ModelCallReport {\n  readonly runId: string\n  readonly traceId: TraceId\n  readonly modelCallId: string\n  readonly spanId: SpanId\n  readonly provider: string\n  /** Provider family independently of the selected route, when installed as a plugin. */\n  readonly providerFamily?: string\n  /** Exact plugin installation that owned the selected route. */\n  readonly providerPluginId?: string\n  readonly model: string\n  readonly status: OperationStatus\n  readonly startedAt: string\n  readonly endedAt: string\n  readonly durationMs: number\n  readonly finishReason?: string\n  /** Logical dispatch state, retained even when an adapter did not expose physical attempts. */\n  readonly dispatchState?: DispatchState\n  readonly coverage: UsageCoverage\n  readonly reported: UsageCounters\n  readonly estimated?: UsageCounters\n  readonly attempts: readonly AttemptUsageReport[]\n  readonly possiblyBilledAttemptsWithoutUsage: number\n  readonly authoritative: boolean\n  readonly delivery: ObservationDeliverySummary\n  readonly error?: SafeErrorRecord\n}\n\nexport interface ModelCallHandle extends AsyncIterable<StreamChunk> {\n  readonly runId: string\n  readonly modelCallId: string\n  readonly report: Promise<ModelCallReport>\n}\n\n/** Safe facts known immediately before one physical provider dispatch. */\nexport interface StartProviderAttemptInput {\n  readonly provider: string\n  readonly model: string\n  readonly method: string\n  /** Scheme, host, and explicit non-default port only; never a path or query. */\n  readonly origin: string\n}\n\n/** Terminal facts supplied by a transport after exactly one dispatch boundary. */\nexport interface EndProviderAttemptInput {\n  readonly status: OperationStatus\n  readonly dispatchState: DispatchState\n  readonly reported?: UsageCounters\n  readonly httpStatus?: number\n  readonly providerRequestId?: string\n  /** Must already be safe for support reports; raw response bodies are forbidden. */\n  readonly error?: SafeErrorRecord\n}\n\n/** Safe scheduling facts between two physical provider attempts. */\nexport interface ProviderRetryScheduledInput {\n  readonly nextAttemptNumber: number\n  readonly delayMs: number\n  readonly failureCode: string\n}\n\n/** One physical provider-attempt lifecycle owned by the model-call handle. */\nexport interface ProviderAttemptHandle {\n  readonly attemptId: string\n  readonly attemptNumber: number\n  readonly traceparent: string\n  end(input: EndProviderAttemptInput): AttemptUsageReport\n}\n\nexport interface ModelInvocationContext {\n  readonly observation?: ObservationPort\n  /** Safe SDK/service/runtime identity copied onto nested provider operations. */\n  readonly resource?: ObservationResource\n  readonly correlation?: Partial<CorrelationContext>\n  readonly terminalCheckpointOwner?: 'model-call' | 'agent-run'\n  /** Shared sequence/monotonic scope when this call belongs to a larger agent run. */\n  readonly scope?: ObservationRunScope\n  /** Always present on AgentRuntime calls; optional for preserved low-level callers. */\n  readonly logger?: SdkLogger\n  /** Declares that the adapter will report the real network boundary itself. */\n  readonly declareProviderAttemptAccounting?: () => void\n  /**\n   * Internal transport accounting boundary. HTTP providers call this immediately\n   * before dispatch; audit mode may reject before any network request is invoked.\n   */\n  readonly startProviderAttempt?: (\n    input: StartProviderAttemptInput,\n    signal?: AbortSignal,\n  ) => Promise<ProviderAttemptHandle>\n  readonly recordProviderRetry?: (input: ProviderRetryScheduledInput) => void\n}\n\nexport const OBSERVATION_ERROR_CODES = Object.freeze({\n  AUDIT_UNAVAILABLE: 'OBSERVABILITY_AUDIT_UNAVAILABLE',\n  CAPTURE_REJECTED: 'OBSERVABILITY_CAPTURE_REJECTED',\n  PROCESSOR_FAILED: 'OBSERVABILITY_PROCESSOR_FAILED',\n  EXPORT_FAILED: 'OBSERVABILITY_EXPORT_FAILED',\n  FLUSH_TIMEOUT: 'OBSERVABILITY_FLUSH_TIMEOUT',\n  JOURNAL_CORRUPT: 'OBSERVABILITY_JOURNAL_CORRUPT',\n  JOURNAL_IO: 'OBSERVABILITY_JOURNAL_IO',\n  BROWSER_QUOTA: 'OBSERVABILITY_BROWSER_QUOTA',\n  OTEL_PROVIDER_UNCONFIGURED: 'OTEL_PROVIDER_UNCONFIGURED',\n  OPERATION_TERMINAL_MISSING: 'OPERATION_TERMINAL_MISSING',\n  LEDGER_LIMIT_EXCEEDED: 'LEDGER_LIMIT_EXCEEDED',\n  USAGE_MISSING: 'USAGE_MISSING',\n  USAGE_REQUIRED: 'USAGE_REQUIRED',\n  USAGE_INVALID: 'USAGE_INVALID',\n  USAGE_COUNTER_OVERFLOW: 'USAGE_COUNTER_OVERFLOW',\n} as const)\n\nexport class ModelCallObservationError extends AgentSdkError {\n  readonly runId: string\n  readonly modelCallId: string\n  readonly traceId: TraceId\n  readonly report: ModelCallReport\n\n  constructor(message: string, report: ModelCallReport, options?: ErrorOptions) {\n    super(message, OBSERVATION_ERROR_CODES.AUDIT_UNAVAILABLE, options)\n    this.name = 'ModelCallObservationError'\n    this.runId = report.runId\n    this.modelCallId = report.modelCallId\n    this.traceId = report.traceId\n    this.report = report\n  }\n}\n"],"mappings":"6DAoGA,MAAa,EAA0B,OAAO,OAAO,CACnD,kBAAmB,kCACnB,iBAAkB,iCAClB,iBAAkB,iCAClB,cAAe,8BACf,cAAe,8BACf,gBAAiB,gCACjB,WAAY,2BACZ,cAAe,8BACf,2BAA4B,6BAC5B,2BAA4B,6BAC5B,sBAAuB,wBACvB,cAAe,gBACf,eAAgB,iBAChB,cAAe,gBACf,uBAAwB,wBAC1B,CAAU,EAEV,IAAa,EAAb,cAA+C,CAAc,CAC3D,MACA,YACA,QACA,OAEA,YAAY,EAAiB,EAAyB,EAAwB,CAC5E,MAAM,EAAS,EAAwB,kBAAmB,CAAO,EACjE,KAAK,KAAO,4BACZ,KAAK,MAAQ,EAAO,MACpB,KAAK,YAAc,EAAO,YAC1B,KAAK,QAAU,EAAO,QACtB,KAAK,OAAS,CAChB,CACF"}

package/dist/observation/telemetry-types.d.ts

@@ -0,0 +1,29 @@
+import { ObservationEvent, SafeErrorRecord } from "./event.js";
+//#region src/observation/telemetry-types.d.ts
+type ObservationContentPolicy = 'none' | 'metadata' | 'redacted' | 'full';
+interface ObservationHealthSnapshot {
+  readonly state: 'disabled' | 'healthy' | 'degraded' | 'failed' | 'closed';
+  readonly queuedEvents: number;
+  readonly queuedBytes: number;
+  readonly accepted: number;
+  readonly exported: number;
+  readonly droppedVerbose: number;
+  readonly droppedNormal: number;
+  readonly criticalRejected: number;
+  readonly processorFailures: number;
+  readonly exporterFailures: number;
+  readonly flushTimeouts: number;
+  readonly lastExportAt?: string;
+  readonly lastFailure?: SafeErrorRecord;
+}
+interface ObservationProcessor {
+  readonly id: string;
+  transform(event: ObservationEvent): ObservationEvent | undefined;
+}
+interface ContentRedactor {
+  readonly id: string;
+  redact(value: string, path: readonly string[]): string;
+}
+//#endregion
+export { ContentRedactor, ObservationContentPolicy, ObservationHealthSnapshot, ObservationProcessor };
+//# sourceMappingURL=telemetry-types.d.ts.map

package/dist/observation/telemetry-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-types.d.ts","names":[],"sources":["../../src/observation/telemetry-types.ts"],"mappings":";;KAEY;UAEK;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA,cAAc;;UAGR;WACN;EACT,UAAU,OAAO,mBAAmB;;UAGrB;WACN;EACT,OAAO,eAAe"}

package/dist/observation/usage.d.ts

@@ -0,0 +1,52 @@
+import { SpanId } from "./context.js";
+import { OperationStatus, SafeErrorRecord } from "./event.js";
+//#region src/observation/usage.d.ts
+type UsageCoverage = 'complete' | 'partial' | 'estimated' | 'missing' | 'not-applicable';
+type DispatchState = 'not-sent' | 'sent' | 'unknown';
+interface UsageCounters {
+  readonly inputTokens?: number;
+  readonly outputTokens?: number;
+  readonly totalTokens?: number;
+  readonly cacheReadTokens?: number;
+  readonly cacheWriteTokens?: number;
+  readonly reasoningTokens?: number;
+}
+interface AttemptUsageReport {
+  readonly attemptId: string;
+  readonly spanId: SpanId;
+  readonly attemptNumber: number;
+  readonly status: OperationStatus;
+  readonly startedAt: string;
+  readonly endedAt: string;
+  readonly durationMs: number;
+  readonly dispatchState: DispatchState;
+  readonly coverage: UsageCoverage;
+  readonly reported: UsageCounters;
+  readonly estimated?: UsageCounters;
+  /** Scheme, host and explicit non-default port retained without path/query. */
+  readonly origin?: string;
+  readonly httpStatus?: number;
+  readonly providerRequestId?: string;
+  readonly error?: SafeErrorRecord;
+}
+declare const COUNTER_KEYS: readonly ['inputTokens', 'outputTokens', 'totalTokens', 'cacheReadTokens', 'cacheWriteTokens', 'reasoningTokens'];
+type CounterKey = typeof COUNTER_KEYS[number];
+interface UsageValidationResult {
+  readonly reported: UsageCounters;
+  readonly invalidFields: readonly CounterKey[];
+  readonly complete: boolean;
+  readonly overflow: boolean;
+}
+/** Rejects invalid fields individually and derives a total only from valid disjoint buckets. */
+declare function validateUsageCounters(value: unknown, normalizedProviderReport?: boolean): UsageValidationResult;
+interface UsageAdditionResult {
+  readonly counters: UsageCounters;
+  readonly overflow: boolean;
+}
+declare function addUsageCounters(values: readonly UsageCounters[]): UsageAdditionResult;
+declare function hasUsageCounters(value: UsageCounters | undefined): boolean;
+declare function classifyUsageCoverage(attempts: readonly Pick<AttemptUsageReport, 'dispatchState' | 'coverage' | 'reported'>[], estimated?: UsageCounters): UsageCoverage;
+declare function possiblyBilledAttemptsWithoutUsage(attempts: readonly Pick<AttemptUsageReport, 'dispatchState' | 'reported'>[]): number;
+//#endregion
+export { AttemptUsageReport, DispatchState, UsageAdditionResult, UsageCounters, UsageCoverage, UsageValidationResult, addUsageCounters, classifyUsageCoverage, hasUsageCounters, possiblyBilledAttemptsWithoutUsage, validateUsageCounters };
+//# sourceMappingURL=usage.d.ts.map

package/dist/observation/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","names":[],"sources":["../../src/observation/usage.ts"],"mappings":";;;KAGY;KACA;UAEK;WACN;WACA;WACA;WACA;WACA;WACA;;UAGM;WACN;WACA,QAAQ;WACR;WACA,QAAQ;WACR;WACA;WACA;WACA,eAAe;WACf,UAAU;WACV,UAAU;WACV,YAAY;;WAEZ;WACA;WACA;WACA,QAAQ;;cAGb;KACD,oBAAoB;UAER;WACN,UAAU;WACV,wBAAwB;WACxB;WACA;;;iBAgBK,sBAAsB,gBAAgB,qCAAmC;UA6CxE;WACN,UAAU;WACV;;iBAGK,iBAAiB,iBAAiB,kBAAkB;iBAiCpD,iBAAiB,OAAO;iBAIxB,sBACd,mBAAmB,KAAK,kEACxB,YAAY,gBACX;iBASa,mCACd,mBAAmB,KAAK"}

package/dist/observation/usage.js

@@ -0,0 +1,2 @@
+const e=[`inputTokens`,`outputTokens`,`totalTokens`,`cacheReadTokens`,`cacheWriteTokens`,`reasoningTokens`];function t(e){return typeof e==`number`&&Number.isSafeInteger(e)&&e>=0}function n(e,t){try{return{value:Reflect.get(e,t),unreadable:!1}}catch{return{unreadable:!0}}}function r(r,i=!1){let a=typeof r==`object`&&r?r:{},o={},s=[];for(let r of e){let e=n(a,r);if(e.unreadable){s.push(r);continue}let i=e.value;i!==void 0&&(t(i)?o[r]=i:s.push(r))}let c=0,l=!1;for(let e of[`inputTokens`,`cacheReadTokens`,`cacheWriteTokens`,`outputTokens`]){let t=c+(o[e]??0);Number.isSafeInteger(t)?c=t:(l=!0,c=2**53-1)}!l&&o.totalTokens!==void 0&&o.totalTokens<c&&(delete o.totalTokens,s.push(`totalTokens`)),o.reasoningTokens!==void 0&&o.outputTokens!==void 0&&o.reasoningTokens>o.outputTokens&&(delete o.reasoningTokens,s.push(`reasoningTokens`));let u=o.inputTokens!==void 0&&o.outputTokens!==void 0;return i&&u&&o.totalTokens===void 0&&!l&&s.length===0&&(o.totalTokens=c),Object.freeze({reported:Object.freeze({...o}),invalidFields:Object.freeze([...new Set(s)]),complete:u&&s.length===0&&!l,overflow:l})}function i(t){let n={},i=!1,o=!0;for(let s of t){let t=r(s);if(t.invalidFields.length>0)throw TypeError(`usage counters must be validated before aggregation`);i||=t.overflow,a(t.reported)&&t.reported.totalTokens===void 0&&(o=!1);for(let r of e){let e=t.reported[r];if(e===void 0)continue;let a=(n[r]??0)+e;!Number.isSafeInteger(a)||a>2**53-1?(n[r]=2**53-1,i=!0):n[r]=a}}o||delete n.totalTokens;let s=r(n);return i||=s.overflow,Object.freeze({counters:s.reported,overflow:i})}function a(t){return t!==void 0&&e.some(e=>t[e]!==void 0)}function o(e,t){if(e.length===0||e.every(e=>e.dispatchState===`not-sent`))return`not-applicable`;let n=e.filter(e=>e.dispatchState!==`not-sent`);return n.length>0&&n.every(e=>e.coverage===`complete`)?`complete`:n.some(e=>a(e.reported))?`partial`:a(t)?`estimated`:`missing`}function s(e){return e.filter(e=>e.dispatchState!==`not-sent`&&!a(e.reported)).length}export{i as addUsageCounters,o as classifyUsageCoverage,a as hasUsageCounters,s as possiblyBilledAttemptsWithoutUsage,r as validateUsageCounters};
+//# sourceMappingURL=usage.js.map

package/dist/observation/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","names":[],"sources":["../../src/observation/usage.ts"],"sourcesContent":["import type { SpanId } from './context.ts'\nimport type { OperationStatus, SafeErrorRecord } from './event.ts'\n\nexport type UsageCoverage = 'complete' | 'partial' | 'estimated' | 'missing' | 'not-applicable'\nexport type DispatchState = 'not-sent' | 'sent' | 'unknown'\n\nexport interface UsageCounters {\n  readonly inputTokens?: number\n  readonly outputTokens?: number\n  readonly totalTokens?: number\n  readonly cacheReadTokens?: number\n  readonly cacheWriteTokens?: number\n  readonly reasoningTokens?: number\n}\n\nexport interface AttemptUsageReport {\n  readonly attemptId: string\n  readonly spanId: SpanId\n  readonly attemptNumber: number\n  readonly status: OperationStatus\n  readonly startedAt: string\n  readonly endedAt: string\n  readonly durationMs: number\n  readonly dispatchState: DispatchState\n  readonly coverage: UsageCoverage\n  readonly reported: UsageCounters\n  readonly estimated?: UsageCounters\n  /** Scheme, host and explicit non-default port retained without path/query. */\n  readonly origin?: string\n  readonly httpStatus?: number\n  readonly providerRequestId?: string\n  readonly error?: SafeErrorRecord\n}\n\nconst COUNTER_KEYS = ['inputTokens', 'outputTokens', 'totalTokens', 'cacheReadTokens', 'cacheWriteTokens', 'reasoningTokens'] as const\ntype CounterKey = typeof COUNTER_KEYS[number]\n\nexport interface UsageValidationResult {\n  readonly reported: UsageCounters\n  readonly invalidFields: readonly CounterKey[]\n  readonly complete: boolean\n  readonly overflow: boolean\n}\n\nfunction validCounter(value: unknown): value is number {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0\n}\n\nfunction readCounter(source: Readonly<Record<string, unknown>>, key: CounterKey): { value?: unknown; unreadable: boolean } {\n  try {\n    return { value: Reflect.get(source, key), unreadable: false }\n  } catch {\n    return { unreadable: true }\n  }\n}\n\n/** Rejects invalid fields individually and derives a total only from valid disjoint buckets. */\nexport function validateUsageCounters(value: unknown, normalizedProviderReport = false): UsageValidationResult {\n  const source = typeof value === 'object' && value !== null ? value as Readonly<Record<string, unknown>> : {}\n  const counters: Partial<Record<CounterKey, number>> = {}\n  const invalid: CounterKey[] = []\n  for (const key of COUNTER_KEYS) {\n    const read = readCounter(source, key)\n    if (read.unreadable) {\n      invalid.push(key)\n      continue\n    }\n    const field = read.value\n    if (field === undefined) continue\n    if (validCounter(field)) counters[key] = field\n    else invalid.push(key)\n  }\n  let disjoint = 0\n  let overflow = false\n  for (const key of ['inputTokens', 'cacheReadTokens', 'cacheWriteTokens', 'outputTokens'] as const) {\n    const next = disjoint + (counters[key] ?? 0)\n    if (!Number.isSafeInteger(next)) {\n      overflow = true\n      disjoint = Number.MAX_SAFE_INTEGER\n    } else disjoint = next\n  }\n  if (!overflow && counters.totalTokens !== undefined && counters.totalTokens < disjoint) {\n    delete counters.totalTokens\n    invalid.push('totalTokens')\n  }\n  if (counters.reasoningTokens !== undefined && counters.outputTokens !== undefined\n    && counters.reasoningTokens > counters.outputTokens) {\n    delete counters.reasoningTokens\n    invalid.push('reasoningTokens')\n  }\n  const completeBuckets = counters.inputTokens !== undefined && counters.outputTokens !== undefined\n  if (normalizedProviderReport && completeBuckets && counters.totalTokens === undefined && !overflow && invalid.length === 0) {\n    counters.totalTokens = disjoint\n  }\n  return Object.freeze({\n    reported: Object.freeze({ ...counters }),\n    invalidFields: Object.freeze([...new Set(invalid)]),\n    complete: completeBuckets && invalid.length === 0 && !overflow,\n    overflow,\n  })\n}\n\nexport interface UsageAdditionResult {\n  readonly counters: UsageCounters\n  readonly overflow: boolean\n}\n\nexport function addUsageCounters(values: readonly UsageCounters[]): UsageAdditionResult {\n  const output: Partial<Record<CounterKey, number>> = {}\n  let overflow = false\n  let comparableTotal = true\n  for (const value of values) {\n    const validated = validateUsageCounters(value)\n    if (validated.invalidFields.length > 0) {\n      throw new TypeError('usage counters must be validated before aggregation')\n    }\n    // Individually valid buckets remain known even when their disjoint total\n    // exceeds safe integer precision. Keep them and report loss of authority.\n    overflow ||= validated.overflow\n    if (hasUsageCounters(validated.reported) && validated.reported.totalTokens === undefined) {\n      comparableTotal = false\n    }\n    for (const key of COUNTER_KEYS) {\n      const addend = validated.reported[key]\n      if (addend === undefined) continue\n      const sum = (output[key] ?? 0) + addend\n      if (!Number.isSafeInteger(sum) || sum > Number.MAX_SAFE_INTEGER) {\n        output[key] = Number.MAX_SAFE_INTEGER\n        overflow = true\n      } else output[key] = sum\n    }\n  }\n  // A subset's total cannot describe buckets summed over a wider scope.\n  // Leaf reports retain the original evidence; do not invent missing buckets.\n  if (!comparableTotal) delete output.totalTokens\n  const validated = validateUsageCounters(output)\n  overflow ||= validated.overflow\n  return Object.freeze({ counters: validated.reported, overflow })\n}\n\nexport function hasUsageCounters(value: UsageCounters | undefined): boolean {\n  return value !== undefined && COUNTER_KEYS.some(key => value[key] !== undefined)\n}\n\nexport function classifyUsageCoverage(\n  attempts: readonly Pick<AttemptUsageReport, 'dispatchState' | 'coverage' | 'reported'>[],\n  estimated?: UsageCounters,\n): UsageCoverage {\n  if (attempts.length === 0 || attempts.every(attempt => attempt.dispatchState === 'not-sent')) return 'not-applicable'\n  const dispatched = attempts.filter(attempt => attempt.dispatchState !== 'not-sent')\n  if (dispatched.length > 0 && dispatched.every(attempt => attempt.coverage === 'complete')) return 'complete'\n  if (dispatched.some(attempt => hasUsageCounters(attempt.reported))) return 'partial'\n  if (hasUsageCounters(estimated)) return 'estimated'\n  return 'missing'\n}\n\nexport function possiblyBilledAttemptsWithoutUsage(\n  attempts: readonly Pick<AttemptUsageReport, 'dispatchState' | 'reported'>[],\n): number {\n  return attempts.filter(attempt => attempt.dispatchState !== 'not-sent' && !hasUsageCounters(attempt.reported)).length\n}\n"],"mappings":"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"}

package/dist/platform/adapter.js

@@ -0,0 +1,2 @@
+import{PLATFORM_LIMITS as e,timeoutValue as t}from"./config.js";var n=class extends Error{feature;code=`UNSUPPORTED_RUNTIME`;constructor(e){super(`Required Web Platform feature is unavailable: ${e}`),this.feature=e,this.name=`UnsupportedRuntimeError`}};function r(e,t){try{let e=t();if(typeof e!=`function`)throw Error(`not callable`);return e}catch{throw new n(e)}}function i(t,r){if(!Number.isSafeInteger(t)||t<1||t>e.maxRandomBytes)throw RangeError(`Random identifier size exceeds its bound`);for(let i=0;i<e.randomAttempts;i++){let e=new Uint8Array(t);try{r(e)}catch{throw new n(`crypto.getRandomValues`)}if(e.some(e=>e!==0))return[...e].map(e=>e.toString(16).padStart(2,`0`)).join(``)}throw new n(`crypto.getRandomValues`)}function a(e){let t,n=r(`crypto.getRandomValues`,()=>(t=globalThis.crypto,t.getRandomValues));return i(e,e=>Reflect.apply(n,t,[e]))}function o(){let e=a(16),t=(Number.parseInt(e[16],16)&3|8).toString(16);return`${e.slice(0,8)}-${e.slice(8,12)}-4${e.slice(13,16)}-${t}${e.slice(17,20)}-${e.slice(20)}`}function s(e,t){let r;try{r=Reflect.apply(t,e,[])}catch{throw new n(`performance.now`)}if(!Number.isFinite(r)||r<0)throw new n(`performance.now`);return r}function c(){let e,t=r(`performance.now`,()=>(e=globalThis.performance,e.now));return s(e,t)}function l(e=globalThis){let n=r(`AbortController`,()=>e.AbortController);r(`AbortSignal.any`,()=>e.AbortSignal.any),r(`AbortSignal.timeout`,()=>e.AbortSignal.timeout),r(`DOMException`,()=>e.DOMException),r(`ReadableStream`,()=>e.ReadableStream),r(`TextDecoder`,()=>e.TextDecoder),r(`TextEncoder`,()=>e.TextEncoder),r(`URL`,()=>e.URL);let a,o=r(`crypto.getRandomValues`,()=>(a=e.crypto,a.getRandomValues)),c,l=r(`performance.now`,()=>(c=e.performance,c.now));r(`structuredClone`,()=>e.structuredClone);let u=r(`timers`,()=>e.setTimeout),d=r(`timers`,()=>e.clearTimeout),f=Date.now;return Object.freeze({monotonicNow(){return s(c,l)},wallNow:()=>f(),randomHex:e=>i(e,e=>Reflect.apply(o,a,[e])),controller:()=>new n,after(n,r){t(n,!0);let i=!0,a=Reflect.apply(u,e,[()=>{i&&(i=!1,r())},n]);return()=>{i&&(i=!1,Reflect.apply(d,e,[a]))}}})}export{n as UnsupportedRuntimeError,l as createRuntimePlatform,c as systemMonotonicNow,a as systemRandomHex,o as systemRandomId};
+//# sourceMappingURL=adapter.js.map

package/dist/platform/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","names":[],"sources":["../../src/platform/adapter.ts"],"sourcesContent":["import { PLATFORM_LIMITS, timeoutValue, type UniversalFeature } from './config.ts'\n\nexport class UnsupportedRuntimeError extends Error {\n  readonly code = 'UNSUPPORTED_RUNTIME' as const\n  constructor(readonly feature: UniversalFeature) {\n    super(`Required Web Platform feature is unavailable: ${feature}`)\n    this.name = 'UnsupportedRuntimeError'\n  }\n}\n\nexport interface RuntimePlatform {\n  monotonicNow(): number\n  wallNow(): number\n  randomHex(bytes: number): string\n  controller(): AbortController\n  after(milliseconds: number, callback: () => void): () => void\n}\n\nfunction feature<T>(name: UniversalFeature, read: () => T): T {\n  try {\n    const value = read()\n    if (typeof value !== 'function') throw new Error('not callable')\n    return value\n  } catch { throw new UnsupportedRuntimeError(name) }\n}\n\nfunction randomHex(bytes: number, fill: (data: Uint8Array) => Uint8Array): string {\n  if (!Number.isSafeInteger(bytes) || bytes < 1 || bytes > PLATFORM_LIMITS.maxRandomBytes) {\n    throw new RangeError('Random identifier size exceeds its bound')\n  }\n  for (let attempt = 0; attempt < PLATFORM_LIMITS.randomAttempts; attempt++) {\n    const values = new Uint8Array(bytes)\n    try { fill(values) } catch { throw new UnsupportedRuntimeError('crypto.getRandomValues') }\n    if (values.some(value => value !== 0)) {\n      return [...values].map(value => value.toString(16).padStart(2, '0')).join('')\n    }\n  }\n  throw new UnsupportedRuntimeError('crypto.getRandomValues')\n}\n\n/** Advanced standalone entrypoints share ID generation without allocating a runtime. */\nexport function systemRandomHex(bytes: number): string {\n  let receiver: Crypto\n  const fill = feature('crypto.getRandomValues', () => {\n    receiver = globalThis.crypto\n    return receiver.getRandomValues\n  })\n  return randomHex(bytes, data => Reflect.apply(fill, receiver!, [data]) as Uint8Array)\n}\n\nexport function systemRandomId(): string {\n  const hex = systemRandomHex(16)\n  const variant = ((Number.parseInt(hex[16]!, 16) & 3) | 8).toString(16)\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-4${hex.slice(13, 16)}-${variant}${hex.slice(17, 20)}-${hex.slice(20)}`\n}\n\nfunction monotonicNow(receiver: Performance, now: Performance['now']): number {\n  let value: number\n  try { value = Reflect.apply(now, receiver, []) as number }\n  catch { throw new UnsupportedRuntimeError('performance.now') }\n  if (!Number.isFinite(value) || value < 0) throw new UnsupportedRuntimeError('performance.now')\n  return value\n}\n\nexport function systemMonotonicNow(): number {\n  let receiver: Performance\n  const now = feature('performance.now', () => {\n    receiver = globalThis.performance\n    return receiver.now\n  })\n  return monotonicNow(receiver!, now)\n}\n\n/** Validate and capture the Universal baseline without constructing resources or reading plugins. */\nexport function createRuntimePlatform(host: typeof globalThis = globalThis): RuntimePlatform {\n  const Controller = feature('AbortController', () => host.AbortController)\n  feature('AbortSignal.any', () => host.AbortSignal.any)\n  feature('AbortSignal.timeout', () => host.AbortSignal.timeout)\n  feature('DOMException', () => host.DOMException)\n  feature('ReadableStream', () => host.ReadableStream)\n  feature('TextDecoder', () => host.TextDecoder)\n  feature('TextEncoder', () => host.TextEncoder)\n  feature('URL', () => host.URL)\n  let randomReceiver: Crypto\n  const fill = feature('crypto.getRandomValues', () => {\n    randomReceiver = host.crypto\n    return randomReceiver.getRandomValues\n  })\n  let clockReceiver: Performance\n  const now = feature('performance.now', () => {\n    clockReceiver = host.performance\n    return clockReceiver.now\n  })\n  feature('structuredClone', () => host.structuredClone)\n  const schedule = feature('timers', () => host.setTimeout)\n  const cancel = feature('timers', () => host.clearTimeout)\n  const wall = Date.now\n  return Object.freeze({\n    monotonicNow(): number {\n      return monotonicNow(clockReceiver!, now)\n    },\n    wallNow: () => wall(),\n    randomHex: (bytes: number) => randomHex(bytes, data => Reflect.apply(fill, randomReceiver!, [data]) as Uint8Array),\n    controller: () => new Controller(),\n    after(milliseconds: number, callback: () => void): () => void {\n      timeoutValue(milliseconds, true)\n      let active = true\n      const handle = Reflect.apply(schedule, host, [() => {\n        if (!active) return\n        active = false\n        callback()\n      }, milliseconds]) as ReturnType<typeof setTimeout>\n      return () => {\n        if (!active) return\n        active = false\n        Reflect.apply(cancel, host, [handle])\n      }\n    },\n  })\n}\n"],"mappings":"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"}

package/dist/platform/capability-operation.js

@@ -0,0 +1,2 @@
+import{systemMonotonicNow as e,systemRandomHex as t}from"./adapter.js";import{runtimePlatformForLogger as n}from"./logger-platform.js";const r=Object.freeze({"core-provider":Object.freeze([`setup`]),"core-credential":Object.freeze([`resolve`,`read`,`commit`]),"core-tool-source":Object.freeze([`snapshot`]),"core-skill-provider":Object.freeze([`list`,`load`,`read-resource`]),"core-memory-store":Object.freeze([`load`,`commit`])});function i(e,t,n){d(t,n);let r=l(e),i=r.randomHex(16),a=r.monotonicNow();s(e,`info`,`SDK capability operation started`,{integrationSchemaVersion:1,integrationFamily:t,integrationOperation:n,operationId:i,kind:`logical-start`});let o=r.randomHex(16),f=r.monotonicNow();s(e,`info`,`SDK capability attempt started`,{integrationSchemaVersion:1,integrationFamily:t,integrationOperation:n,operationId:i,kind:`attempt-start`,attemptId:o,attemptNumber:1});let m=!1,h=(l,d)=>{if(m)return;m=!0;let h=l===`error`?c(d):void 0;s(e,l===`error`?`error`:`info`,p(l),{integrationSchemaVersion:1,integrationFamily:t,integrationOperation:n,operationId:i,kind:`attempt-terminal`,attemptId:o,attemptNumber:1,status:l,durationMs:u(r,f),...h===void 0?{}:{errorCode:h}}),s(e,l===`error`?`error`:`info`,p(l),{integrationSchemaVersion:1,integrationFamily:t,integrationOperation:n,operationId:i,kind:`logical-terminal`,status:l,durationMs:u(r,a),...h===void 0?{}:{errorCode:h}})};return Object.freeze({success:()=>h(`success`),fail:e=>h(`error`,e),abort:()=>h(`aborted`)})}async function a(e,t,n,r,a){let o=i(e,t,n);try{r?.throwIfAborted();let e=await a();return r?.throwIfAborted(),o.success(),e}catch(e){throw r?.aborted===!0?o.abort():o.fail(e),e}}function o(e,t,n,r,a){let o=i(e,t,n);try{r?.throwIfAborted();let e=a(),t=f(e);return t===void 0?(o.success(),e):t.then(e=>(r?.aborted===!0&&(o.abort(),r.throwIfAborted()),o.success(),e),e=>{throw r?.aborted===!0?o.abort():o.fail(e),e})}catch(e){throw r?.aborted===!0?o.abort():o.fail(e),e}}function s(e,t,n,r){try{e[t](n,r)}catch{}}function c(e){if(typeof e==`object`&&e)for(let t of[`code`,`name`]){let n=Object.getOwnPropertyDescriptor(e,t);if(n!==void 0&&`value`in n&&typeof n.value==`string`){let e=n.value.replace(/[^A-Za-z0-9_.:-]/g,`_`).slice(0,128);if(e.length>0)return e}}return`CAPABILITY_OPERATION_FAILED`}function l(r){return n(r)??Object.freeze({monotonicNow:e,randomHex:t})}function u(e,t){let n=e.monotonicNow()-t;return Number.isFinite(n)?Math.max(0,n):0}function d(e,t){let n=r[e];if(typeof e!=`string`||e.length<1||e.length>64||typeof t!=`string`||t.length<1||t.length>64||n===void 0||!n.includes(t))throw TypeError(`Invalid core capability operation`)}function f(e){if((typeof e!=`object`||!e)&&typeof e!=`function`)return;let t=Reflect.get(e,`then`);if(typeof t==`function`)return new Promise((n,r)=>{try{Reflect.apply(t,e,[n,r])}catch(e){r(e)}})}function p(e){return e===`success`?`SDK capability operation completed`:e===`error`?`SDK capability operation failed`:`SDK capability operation aborted`}export{r as CORE_CAPABILITY_OPERATIONS,i as beginCoreCapabilityOperation,a as runCoreCapabilityAsync,o as runCoreCapabilityMaybeAsync};
+//# sourceMappingURL=capability-operation.js.map

package/dist/platform/capability-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-operation.js","names":[],"sources":["../../src/platform/capability-operation.ts"],"sourcesContent":["import type { IntegrationOperationEvidenceFields, SdkLogger } from '../logging/types.ts'\nimport { systemMonotonicNow, systemRandomHex, type RuntimePlatform } from './adapter.ts'\nimport { runtimePlatformForLogger } from './logger-platform.ts'\n\nexport const CORE_CAPABILITY_OPERATIONS = Object.freeze({\n  'core-provider': Object.freeze(['setup']),\n  'core-credential': Object.freeze(['resolve', 'read', 'commit']),\n  'core-tool-source': Object.freeze(['snapshot']),\n  'core-skill-provider': Object.freeze(['list', 'load', 'read-resource']),\n  'core-memory-store': Object.freeze(['load', 'commit']),\n} as const)\n\nexport type CoreCapabilityFamily = keyof typeof CORE_CAPABILITY_OPERATIONS\nexport type CoreCapabilityOperationName = (typeof CORE_CAPABILITY_OPERATIONS)[CoreCapabilityFamily][number]\ntype TerminalStatus = 'success' | 'error' | 'aborted'\n\nexport interface CoreCapabilityOperation {\n  success(): void\n  fail(error?: unknown): void\n  abort(): void\n}\n\nexport function beginCoreCapabilityOperation(\n  logger: SdkLogger,\n  family: CoreCapabilityFamily,\n  name: CoreCapabilityOperationName,\n): CoreCapabilityOperation {\n  validateOperation(family, name)\n  const platform = operationPlatform(logger)\n  const operationId = platform.randomHex(16), startedAt = platform.monotonicNow()\n  emit(logger, 'info', 'SDK capability operation started', {\n    integrationSchemaVersion: 1, integrationFamily: family,\n    integrationOperation: name, operationId, kind: 'logical-start',\n  })\n  const attemptId = platform.randomHex(16), attemptStartedAt = platform.monotonicNow()\n  emit(logger, 'info', 'SDK capability attempt started', {\n    integrationSchemaVersion: 1, integrationFamily: family,\n    integrationOperation: name, operationId, kind: 'attempt-start', attemptId, attemptNumber: 1,\n  })\n  let terminal = false\n  const finish = (status: TerminalStatus, error?: unknown): void => {\n    if (terminal) return\n    terminal = true\n    const errorCode = status === 'error' ? safeErrorCode(error) : undefined\n    emit(logger, status === 'error' ? 'error' : 'info', terminalMessage(status), {\n      integrationSchemaVersion: 1, integrationFamily: family,\n      integrationOperation: name, operationId, kind: 'attempt-terminal', attemptId, attemptNumber: 1,\n      status, durationMs: duration(platform, attemptStartedAt),\n      ...(errorCode === undefined ? {} : { errorCode }),\n    })\n    emit(logger, status === 'error' ? 'error' : 'info', terminalMessage(status), {\n      integrationSchemaVersion: 1, integrationFamily: family,\n      integrationOperation: name, operationId, kind: 'logical-terminal',\n      status, durationMs: duration(platform, startedAt),\n      ...(errorCode === undefined ? {} : { errorCode }),\n    })\n  }\n  return Object.freeze({ success: () => finish('success'), fail: (error: unknown) => finish('error', error),\n    abort: () => finish('aborted') })\n}\n\nexport function runCoreCapabilitySync<T>(\n  logger: SdkLogger, family: CoreCapabilityFamily, name: CoreCapabilityOperationName,\n  signal: AbortSignal | undefined, invoke: () => T,\n): T {\n  const operation = beginCoreCapabilityOperation(logger, family, name)\n  try {\n    signal?.throwIfAborted()\n    const value = invoke()\n    operation.success()\n    return value\n  } catch (error: unknown) {\n    if (signal?.aborted === true) operation.abort()\n    else operation.fail(error)\n    throw error\n  }\n}\n\nexport async function runCoreCapabilityAsync<T>(\n  logger: SdkLogger, family: CoreCapabilityFamily, name: CoreCapabilityOperationName,\n  signal: AbortSignal | undefined, invoke: () => Promise<T>,\n): Promise<T> {\n  const operation = beginCoreCapabilityOperation(logger, family, name)\n  try {\n    signal?.throwIfAborted()\n    const value = await invoke()\n    signal?.throwIfAborted()\n    operation.success()\n    return value\n  } catch (error: unknown) {\n    if (signal?.aborted === true) operation.abort()\n    else operation.fail(error)\n    throw error\n  }\n}\n\nexport function runCoreCapabilityMaybeAsync<T>(\n  logger: SdkLogger, family: CoreCapabilityFamily, name: CoreCapabilityOperationName,\n  signal: AbortSignal | undefined, invoke: () => T,\n): T {\n  const operation = beginCoreCapabilityOperation(logger, family, name)\n  try {\n    signal?.throwIfAborted()\n    const value = invoke()\n    const pending = captureThenable(value)\n    if (pending !== undefined) {\n      return pending.then(result => {\n        if (signal?.aborted === true) {\n          operation.abort()\n          signal.throwIfAborted()\n        }\n        operation.success()\n        return result\n      }, error => {\n        if (signal?.aborted === true) operation.abort(); else operation.fail(error)\n        throw error\n      }) as T\n    }\n    operation.success()\n    return value\n  } catch (error: unknown) {\n    if (signal?.aborted === true) operation.abort(); else operation.fail(error)\n    throw error\n  }\n}\n\nfunction emit(logger: SdkLogger, level: 'info' | 'error', message: string,\n  fields: IntegrationOperationEvidenceFields): void {\n  try { logger[level](message, fields) } catch { /* diagnostics never replace capability results */ }\n}\n\nfunction safeErrorCode(error: unknown): string {\n  if (typeof error === 'object' && error !== null) {\n    for (const key of ['code', 'name']) {\n      const descriptor = Object.getOwnPropertyDescriptor(error, key)\n      if (descriptor !== undefined && 'value' in descriptor && typeof descriptor.value === 'string') {\n        const clean = descriptor.value.replace(/[^A-Za-z0-9_.:-]/g, '_').slice(0, 128)\n        if (clean.length > 0) return clean\n      }\n    }\n  }\n  return 'CAPABILITY_OPERATION_FAILED'\n}\n\nfunction operationPlatform(logger: SdkLogger): Pick<RuntimePlatform, 'monotonicNow' | 'randomHex'> {\n  return runtimePlatformForLogger(logger) ?? Object.freeze({\n    monotonicNow: systemMonotonicNow,\n    randomHex: systemRandomHex,\n  })\n}\n\nfunction duration(platform: Pick<RuntimePlatform, 'monotonicNow'>, startedAt: number): number {\n  const value = platform.monotonicNow() - startedAt\n  return Number.isFinite(value) ? Math.max(0, value) : 0\n}\n\nfunction validateOperation(family: CoreCapabilityFamily, name: CoreCapabilityOperationName): void {\n  const operations = CORE_CAPABILITY_OPERATIONS[family] as readonly string[] | undefined\n  if (typeof family !== 'string' || family.length < 1 || family.length > 64\n    || typeof name !== 'string' || name.length < 1 || name.length > 64\n    || operations === undefined || !operations.includes(name)) {\n    throw new TypeError('Invalid core capability operation')\n  }\n}\n\nfunction captureThenable<T>(value: T): Promise<Awaited<T>> | undefined {\n  if ((typeof value !== 'object' || value === null) && typeof value !== 'function') return undefined\n  const then = Reflect.get(value as object, 'then')\n  if (typeof then !== 'function') return undefined\n  return new Promise<Awaited<T>>((resolve, reject) => {\n    try { Reflect.apply(then, value, [resolve, reject]) }\n    catch (error) { reject(error) }\n  })\n}\n\nfunction terminalMessage(status: TerminalStatus): string {\n  return status === 'success' ? 'SDK capability operation completed'\n    : status === 'error' ? 'SDK capability operation failed' : 'SDK capability operation aborted'\n}\n"],"mappings":"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"}

package/dist/platform/config.js

@@ -0,0 +1,2 @@
+const e=Object.freeze({maxTimeoutMs:2147483647,randomAttempts:8,maxRandomBytes:32});Object.freeze([`AbortController`,`AbortSignal.any`,`AbortSignal.timeout`,`DOMException`,`ReadableStream`,`TextDecoder`,`TextEncoder`,`URL`,`crypto.getRandomValues`,`performance.now`,`structuredClone`,`timers`]);function t(t,n=!1){if(!Number.isSafeInteger(t)||t<+!n||t>e.maxTimeoutMs)throw RangeError(`Timeout must be a bounded integer number of milliseconds`);return t}export{e as PLATFORM_LIMITS,t as timeoutValue};
+//# sourceMappingURL=config.js.map

package/dist/platform/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../src/platform/config.ts"],"sourcesContent":["/** Internal Web Platform bounds. Runtime-owned deadlines never overflow host timers. */\nexport const PLATFORM_LIMITS = Object.freeze({\n  maxTimeoutMs: 2_147_483_647,\n  randomAttempts: 8,\n  maxRandomBytes: 32,\n})\n\nexport const UNIVERSAL_FEATURES = Object.freeze([\n  'AbortController', 'AbortSignal.any', 'AbortSignal.timeout', 'DOMException',\n  'ReadableStream', 'TextDecoder', 'TextEncoder', 'URL', 'crypto.getRandomValues',\n  'performance.now', 'structuredClone', 'timers',\n] as const)\n\nexport type UniversalFeature = typeof UNIVERSAL_FEATURES[number]\n\nexport function timeoutValue(value: number, allowZero = false): number {\n  if (!Number.isSafeInteger(value) || value < (allowZero ? 0 : 1) || value > PLATFORM_LIMITS.maxTimeoutMs) {\n    throw new RangeError('Timeout must be a bounded integer number of milliseconds')\n  }\n  return value\n}\n"],"mappings":"AACA,MAAa,EAAkB,OAAO,OAAO,CAC3C,aAAc,WACd,eAAgB,EAChB,eAAgB,EAClB,CAAC,EAEiC,OAAO,OAAO,CAC9C,kBAAmB,kBAAmB,sBAAuB,eAC7D,iBAAkB,cAAe,cAAe,MAAO,yBACvD,kBAAmB,kBAAmB,QACxC,CAAU,EAIV,SAAgB,EAAa,EAAe,EAAY,GAAe,CACrE,GAAI,CAAC,OAAO,cAAc,CAAK,GAAK,EAAS,KAAsB,EAAQ,EAAgB,aACzF,MAAU,WAAW,0DAA0D,EAEjF,OAAO,CACT"}

package/dist/platform/logger-platform.js

@@ -0,0 +1,2 @@
+const e=new WeakMap;function t(t,n){e.set(t,n)}function n(t){return e.get(t)}export{t as bindRuntimeLoggerPlatform,n as runtimePlatformForLogger};
+//# sourceMappingURL=logger-platform.js.map

package/dist/platform/logger-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-platform.js","names":[],"sources":["../../src/platform/logger-platform.ts"],"sourcesContent":["import type { SdkLogger } from '../logging/types.ts'\nimport type { RuntimePlatform } from './adapter.ts'\n\nconst LOGGER_PLATFORMS = new WeakMap<object, RuntimePlatform>()\n\nexport function bindRuntimeLoggerPlatform(logger: SdkLogger, platform: RuntimePlatform): void {\n  LOGGER_PLATFORMS.set(logger, platform)\n}\n\nexport function runtimePlatformForLogger(logger: SdkLogger): RuntimePlatform | undefined {\n  return LOGGER_PLATFORMS.get(logger)\n}\n"],"mappings":"AAGA,MAAM,EAAmB,IAAI,QAE7B,SAAgB,EAA0B,EAAmB,EAAiC,CAC5F,EAAiB,IAAI,EAAQ,CAAQ,CACvC,CAEA,SAAgB,EAAyB,EAAgD,CACvF,OAAO,EAAiB,IAAI,CAAM,CACpC"}

package/dist/platform/resources.js

@@ -0,0 +1,2 @@
+import{timeoutValue as e}from"./config.js";var t=class{platform;closed=!1;timers=new Set;listeners=new Set;scopes=new Set;constructor(e){this.platform=e}get pendingTimers(){return this.timers.size}get isClosed(){return this.closed}get pendingListeners(){return this.listeners.size}assertOpen(){if(this.closed)throw Error(`Runtime resources are closed`)}after(t,n){this.assertOpen(),e(t,!0);let r=!0,i=()=>void 0,a=()=>{r&&(r=!1,this.timers.delete(a),i())};this.timers.add(a);try{i=this.platform.after(t,()=>{r&&(a(),n())})}catch(e){throw a(),e}return a}onAbort(e,t){this.assertOpen();let n=!0,r=()=>{n&&(n=!1,this.listeners.delete(r),e.removeEventListener(`abort`,i))},i=()=>{n&&(r(),t())};this.listeners.add(r);try{e.addEventListener(`abort`,i,{once:!0}),e.aborted&&i()}catch(e){throw r(),e}return r}cancellation(t,n){this.assertOpen(),n!==void 0&&e(n);let r=this.platform.controller(),i=[],a=!1,o=()=>{if(!a){a=!0,this.scopes.delete(c);for(let e of i.splice(0).reverse())e()}},s=()=>{r.abort(Error(`Runtime operation was cancelled`)),o()},c=()=>{s()};this.scopes.add(c);try{for(let e of t){if(a)break;let t=this.onAbort(e,s);a?t():i.push(t)}!a&&n!==void 0&&i.push(this.after(n,s))}catch(e){throw o(),e}return Object.freeze({signal:r.signal,cancel:s,dispose:o})}close(){if(!this.closed){this.closed=!0;for(let e of[...this.scopes])e();for(let e of[...this.timers])e();for(let e of[...this.listeners])e()}}};export{t as RuntimeResources};
+//# sourceMappingURL=resources.js.map

package/dist/platform/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","names":[],"sources":["../../src/platform/resources.ts"],"sourcesContent":["import type { RuntimePlatform } from './adapter.ts'\nimport { timeoutValue } from './config.ts'\n\nexport interface CancellationScope {\n  readonly signal: AbortSignal\n  cancel(): void\n  dispose(): void\n}\n\n/** One owner for cancelable timers/listeners. No interval or native timeout-signal can outlive it. */\nexport class RuntimeResources {\n  private closed = false\n  private readonly timers = new Set<() => void>()\n  private readonly listeners = new Set<() => void>()\n  private readonly scopes = new Set<() => void>()\n\n  constructor(readonly platform: RuntimePlatform) {}\n\n  get pendingTimers(): number { return this.timers.size }\n  get isClosed(): boolean { return this.closed }\n  get pendingListeners(): number { return this.listeners.size }\n\n  private assertOpen(): void {\n    if (this.closed) throw new Error('Runtime resources are closed')\n  }\n\n  after(milliseconds: number, callback: () => void): () => void {\n    this.assertOpen()\n    timeoutValue(milliseconds, true)\n    let active = true\n    let cancel = (): void => undefined\n    const release = (): void => {\n      if (!active) return\n      active = false\n      this.timers.delete(release)\n      cancel()\n    }\n    this.timers.add(release)\n    try {\n      cancel = this.platform.after(milliseconds, () => {\n        if (!active) return\n        release()\n        callback()\n      })\n    } catch (error) { release(); throw error }\n    return release\n  }\n\n  onAbort(signal: AbortSignal, callback: () => void): () => void {\n    this.assertOpen()\n    let active = true\n    const release = (): void => {\n      if (!active) return\n      active = false\n      this.listeners.delete(release)\n      signal.removeEventListener('abort', abort)\n    }\n    const abort = (): void => { if (active) { release(); callback() } }\n    this.listeners.add(release)\n    try {\n      signal.addEventListener('abort', abort, { once: true })\n      if (signal.aborted) abort()\n    } catch (error) { release(); throw error }\n    return release\n  }\n\n  cancellation(signals: readonly AbortSignal[], timeoutMs?: number): CancellationScope {\n    this.assertOpen()\n    if (timeoutMs !== undefined) timeoutValue(timeoutMs)\n    const controller = this.platform.controller()\n    const releases: (() => void)[] = []\n    let disposed = false\n    const dispose = (): void => {\n      if (disposed) return\n      disposed = true\n      this.scopes.delete(shutdown)\n      for (const release of releases.splice(0).reverse()) release()\n    }\n    const abort = (): void => {\n      controller.abort(new Error('Runtime operation was cancelled'))\n      dispose()\n    }\n    const shutdown = (): void => { abort() }\n    this.scopes.add(shutdown)\n    try {\n      for (const signal of signals) {\n        if (disposed) break\n        const release = this.onAbort(signal, abort)\n        if (disposed) release()\n        else releases.push(release)\n      }\n      if (!disposed && timeoutMs !== undefined) releases.push(this.after(timeoutMs, abort))\n    } catch (error) { dispose(); throw error }\n    return Object.freeze({ signal: controller.signal, cancel: abort, dispose })\n  }\n\n  close(): void {\n    if (this.closed) return\n    this.closed = true\n    for (const shutdown of [...this.scopes]) shutdown()\n    for (const release of [...this.timers]) release()\n    for (const release of [...this.listeners]) release()\n  }\n}\n"],"mappings":"2CAUA,IAAa,EAAb,KAA8B,CAMP,SALrB,OAAiB,GACjB,OAA0B,IAAI,IAC9B,UAA6B,IAAI,IACjC,OAA0B,IAAI,IAE9B,YAAY,EAAoC,CAA3B,KAAA,SAAA,CAA4B,CAEjD,IAAI,eAAwB,CAAE,OAAO,KAAK,OAAO,IAAK,CACtD,IAAI,UAAoB,CAAE,OAAO,KAAK,MAAO,CAC7C,IAAI,kBAA2B,CAAE,OAAO,KAAK,UAAU,IAAK,CAE5D,YAA2B,CACzB,GAAI,KAAK,OAAQ,MAAU,MAAM,8BAA8B,CACjE,CAEA,MAAM,EAAsB,EAAkC,CAC5D,KAAK,WAAW,EAChB,EAAa,EAAc,EAAI,EAC/B,IAAI,EAAS,GACT,MAAqB,IAAA,GACnB,MAAsB,CACrB,IACL,EAAS,GACT,KAAK,OAAO,OAAO,CAAO,EAC1B,EAAO,EACT,EACA,KAAK,OAAO,IAAI,CAAO,EACvB,GAAI,CACF,EAAS,KAAK,SAAS,MAAM,MAAoB,CAC1C,IACL,EAAQ,EACR,EAAS,EACX,CAAC,CACH,OAAS,EAAO,CAAa,MAAX,EAAQ,EAAS,CAAM,CACzC,OAAO,CACT,CAEA,QAAQ,EAAqB,EAAkC,CAC7D,KAAK,WAAW,EAChB,IAAI,EAAS,GACP,MAAsB,CACrB,IACL,EAAS,GACT,KAAK,UAAU,OAAO,CAAO,EAC7B,EAAO,oBAAoB,QAAS,CAAK,EAC3C,EACM,MAAoB,CAAM,IAAU,EAAQ,EAAG,EAAS,EAAI,EAClE,KAAK,UAAU,IAAI,CAAO,EAC1B,GAAI,CACF,EAAO,iBAAiB,QAAS,EAAO,CAAE,KAAM,EAAK,CAAC,EAClD,EAAO,SAAS,EAAM,CAC5B,OAAS,EAAO,CAAa,MAAX,EAAQ,EAAS,CAAM,CACzC,OAAO,CACT,CAEA,aAAa,EAAiC,EAAuC,CACnF,KAAK,WAAW,EACZ,IAAc,IAAA,IAAW,EAAa,CAAS,EACnD,IAAM,EAAa,KAAK,SAAS,WAAW,EACtC,EAA2B,CAAC,EAC9B,EAAW,GACT,MAAsB,CACtB,MAEJ,CADA,EAAW,GACX,KAAK,OAAO,OAAO,CAAQ,EAC3B,IAAK,IAAM,KAAW,EAAS,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAG,EAAQ,CADjC,CAE7B,EACM,MAAoB,CACxB,EAAW,MAAU,MAAM,iCAAiC,CAAC,EAC7D,EAAQ,CACV,EACM,MAAuB,CAAE,EAAM,CAAE,EACvC,KAAK,OAAO,IAAI,CAAQ,EACxB,GAAI,CACF,IAAK,IAAM,KAAU,EAAS,CAC5B,GAAI,EAAU,MACd,IAAM,EAAU,KAAK,QAAQ,EAAQ,CAAK,EACtC,EAAU,EAAQ,EACjB,EAAS,KAAK,CAAO,CAC5B,CACI,CAAC,GAAY,IAAc,IAAA,IAAW,EAAS,KAAK,KAAK,MAAM,EAAW,CAAK,CAAC,CACtF,OAAS,EAAO,CAAa,MAAX,EAAQ,EAAS,CAAM,CACzC,OAAO,OAAO,OAAO,CAAE,OAAQ,EAAW,OAAQ,OAAQ,EAAO,SAAQ,CAAC,CAC5E,CAEA,OAAc,CACR,SAAK,OACT,MAAK,OAAS,GACd,IAAK,IAAM,IAAY,CAAC,GAAG,KAAK,MAAM,EAAG,EAAS,EAClD,IAAK,IAAM,IAAW,CAAC,GAAG,KAAK,MAAM,EAAG,EAAQ,EAChD,IAAK,IAAM,IAAW,CAAC,GAAG,KAAK,SAAS,EAAG,EAAQ,CAHrC,CAIhB,CACF"}

package/dist/plugin/provider-plugin.d.ts

@@ -0,0 +1,37 @@
+import { StreamChunk } from "../stream/chunk.js";
+import { AgentSdkError } from "../errors/agent-sdk-error.js";
+import { ModelInvocationContext } from "../observation/report.js";
+import { GenerateOptions } from "../contract/generate-options.js";
+import { ModelAdapter } from "../contract/adapter.js";
+//#region src/plugin/provider-plugin.d.ts
+type StreamMiddleware = (options: GenerateOptions, next: () => AsyncIterable<StreamChunk>, context: ModelInvocationContext) => AsyncIterable<StreamChunk>;
+interface AdapterRegistrationHandle {
+  (): void;
+  replace(providers: readonly string[]): void;
+}
+interface ModelProviderRegistrar {
+  registerAdapter(routes: readonly string[], adapter: ModelAdapter): AdapterRegistrationHandle;
+  use(middleware: StreamMiddleware): () => void;
+}
+interface ModelProviderPlugin {
+  readonly id: string;
+  readonly displayName: string;
+  /** Stable provider family; legacy plugins default to their plugin id. */
+  readonly family?: string;
+  setup(registrar: ModelProviderRegistrar): void | (() => void);
+}
+interface PluginRegistrationHandle {
+  (): void;
+  readonly pluginId: string;
+}
+declare const PLUGIN_ERROR_CODES: Readonly<{
+  readonly INSTALL_FAILED: 'PLUGIN_INSTALL_FAILED';
+  readonly CLEANUP_FAILED: 'PLUGIN_CLEANUP_FAILED';
+}>;
+declare class PluginError extends AgentSdkError {
+  readonly pluginId: string;
+  constructor(message: string, code: string, pluginId: string, options?: ErrorOptions);
+}
+//#endregion
+export { AdapterRegistrationHandle, ModelProviderPlugin, ModelProviderRegistrar, PLUGIN_ERROR_CODES, PluginError, PluginRegistrationHandle, StreamMiddleware };
+//# sourceMappingURL=provider-plugin.d.ts.map

package/dist/plugin/provider-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-plugin.d.ts","names":[],"sources":["../../src/plugin/provider-plugin.ts"],"mappings":";;;;;;KAMY,oBACV,SAAS,iBACT,YAAY,cAAc,cAC1B,SAAS,2BACN,cAAc;UAEF;;EAEf,QAAQ;;UAGO;EACf,gBAAgB,2BAA2B,SAAS,eAAe;EACnE,IAAI,YAAY;;UAGD;WACN;WACA;;WAEA;EACT,MAAM,WAAW;;UAGF;;WAEN;;cAGE,oBAAkB;WACb;WACA;;cAGL,oBAAoB;WACtB;EAET,YAAY,iBAAiB,cAAc,kBAAkB,UAAU"}

package/dist/plugin/provider-plugin.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"../errors/agent-sdk-error.js";const t=Object.freeze({INSTALL_FAILED:`PLUGIN_INSTALL_FAILED`,CLEANUP_FAILED:`PLUGIN_CLEANUP_FAILED`});var n=class extends e{pluginId;constructor(e,t,n,r){super(e,t,r),this.name=`PluginError`,this.pluginId=n}};export{t as PLUGIN_ERROR_CODES,n as PluginError};
+//# sourceMappingURL=provider-plugin.js.map

package/dist/plugin/provider-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-plugin.js","names":[],"sources":["../../src/plugin/provider-plugin.ts"],"sourcesContent":["import type { ModelAdapter } from '../contract/adapter.ts'\nimport type { GenerateOptions } from '../contract/generate-options.ts'\nimport { AgentSdkError } from '../errors/agent-sdk-error.ts'\nimport type { ModelInvocationContext } from '../observation/report.ts'\nimport type { StreamChunk } from '../stream/chunk.ts'\n\nexport type StreamMiddleware = (\n  options: GenerateOptions,\n  next: () => AsyncIterable<StreamChunk>,\n  context: ModelInvocationContext,\n) => AsyncIterable<StreamChunk>\n\nexport interface AdapterRegistrationHandle {\n  (): void\n  replace(providers: readonly string[]): void\n}\n\nexport interface ModelProviderRegistrar {\n  registerAdapter(routes: readonly string[], adapter: ModelAdapter): AdapterRegistrationHandle\n  use(middleware: StreamMiddleware): () => void\n}\n\nexport interface ModelProviderPlugin {\n  readonly id: string\n  readonly displayName: string\n  /** Stable provider family; legacy plugins default to their plugin id. */\n  readonly family?: string\n  setup(registrar: ModelProviderRegistrar): void | (() => void)\n}\n\nexport interface PluginRegistrationHandle {\n  (): void\n  readonly pluginId: string\n}\n\nexport const PLUGIN_ERROR_CODES = Object.freeze({\n  INSTALL_FAILED: 'PLUGIN_INSTALL_FAILED',\n  CLEANUP_FAILED: 'PLUGIN_CLEANUP_FAILED',\n} as const)\n\nexport class PluginError extends AgentSdkError {\n  readonly pluginId: string\n\n  constructor(message: string, code: string, pluginId: string, options?: ErrorOptions) {\n    super(message, code, options)\n    this.name = 'PluginError'\n    this.pluginId = pluginId\n  }\n}\n"],"mappings":"6DAmCA,MAAa,EAAqB,OAAO,OAAO,CAC9C,eAAgB,wBAChB,eAAgB,uBAClB,CAAU,EAEV,IAAa,EAAb,cAAiC,CAAc,CAC7C,SAEA,YAAY,EAAiB,EAAc,EAAkB,EAAwB,CACnF,MAAM,EAAS,EAAM,CAAO,EAC5B,KAAK,KAAO,cACZ,KAAK,SAAW,CAClB,CACF"}

package/dist/primitives/brand.d.ts

@@ -0,0 +1,61 @@
+//#region src/primitives/brand.d.ts
+/**
+ * Nominal typing over strings, at zero runtime cost.
+ *
+ * The point is to stop a value from silently crossing a boundary it does not
+ * belong to  Epassing a model id where a tool-call id is expected is a real bug
+ * that plain `string` cannot catch. Each brand function is an identity cast and
+ * performs NO validation; it asserts intent, not well-formedness.
+ *
+ * @module ai-agent-sdk/core/primitives/brand
+ */
+declare const BRAND: unique symbol;
+/** A string carrying a compile-time-only nominal tag `B`. */
+type Branded<B extends string> = string & {
+  readonly [BRAND]: B;
+};
+/** Stable identity of one message across construction, history, and requests. */
+type MessageId = Branded<'MessageId'>;
+/**
+ * Brand a message identifier.
+ * @param id - the opaque message identifier.
+ * @returns the same string, branded; no validation is performed.
+ */
+declare function MessageId(id: string): MessageId;
+/**
+ * Correlates a model-issued tool call with the result sent back for it.
+ * Provider-issued in real adapters; synthesized by assembler fallbacks.
+ */
+type ToolCallId = Branded<'ToolCallId'>;
+/**
+ * Brand a tool-call identifier.
+ * @param id - the provider-issued (or synthesized) call id.
+ * @returns the same string, branded; no validation is performed.
+ */
+declare function ToolCallId(id: string): ToolCallId;
+/** Provider-issued request identifier, retained only for diagnostics. */
+type ProviderRequestId = Branded<'ProviderRequestId'>;
+/**
+ * Brand a provider-issued request identifier.
+ * @param id - the opaque provider-issued string.
+ * @returns the same string, branded; no validation is performed.
+ */
+declare function ProviderRequestId(id: string): ProviderRequestId;
+/**
+ * Adapter-owned identifier for one model's selectable reasoning effort.
+ *
+ * Deliberately opaque rather than a fixed union: "how hard should this model
+ * think" is spelled differently by every provider (OpenAI takes an effort
+ * level, Anthropic takes a thinking token budget), and freezing one vendor's
+ * vocabulary into the core would make the other one lie.
+ */
+type ReasoningEffortId = Branded<'ReasoningEffortId'>;
+/**
+ * Brand a reasoning-effort identifier.
+ * @param id - the opaque identifier exposed by one model's capabilities.
+ * @returns the same string, branded; no validation is performed.
+ */
+declare function ReasoningEffortId(id: string): ReasoningEffortId;
+//#endregion
+export { Branded, MessageId, ProviderRequestId, ReasoningEffortId, ToolCallId };
+//# sourceMappingURL=brand.d.ts.map

package/dist/primitives/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","names":[],"sources":["../../src/primitives/brand.ts"],"mappings":";;;;;;;;;;;cAWc;;KAGF,QAAQ;YAAyC,QAAQ;;;KAGzD,YAAY;;;;;;iBAOR,UAAU,aAAa;;;;;KAQ3B,aAAa;;;;;;iBAOT,WAAW,aAAa;;KAK5B,oBAAoB;;;;;;iBAOhB,kBAAkB,aAAa;;;;;;;;;KAYnC,oBAAoB;;;;;;iBAOhB,kBAAkB,aAAa"}

package/dist/primitives/brand.js

@@ -0,0 +1,2 @@
+function e(e){return e}function t(e){return e}function n(e){return e}function r(e){return e}export{e as MessageId,n as ProviderRequestId,r as ReasoningEffortId,t as ToolCallId};
+//# sourceMappingURL=brand.js.map

package/dist/primitives/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","names":[],"sources":["../../src/primitives/brand.ts"],"sourcesContent":["/**\n * Nominal typing over strings, at zero runtime cost.\n *\n * The point is to stop a value from silently crossing a boundary it does not\n * belong to  Epassing a model id where a tool-call id is expected is a real bug\n * that plain `string` cannot catch. Each brand function is an identity cast and\n * performs NO validation; it asserts intent, not well-formedness.\n *\n * @module ai-agent-sdk/core/primitives/brand\n */\n\ndeclare const BRAND: unique symbol\n\n/** A string carrying a compile-time-only nominal tag `B`. */\nexport type Branded<B extends string> = string & { readonly [BRAND]: B }\n\n/** Stable identity of one message across construction, history, and requests. */\nexport type MessageId = Branded<'MessageId'>\n\n/**\n * Brand a message identifier.\n * @param id - the opaque message identifier.\n * @returns the same string, branded; no validation is performed.\n */\nexport function MessageId(id: string): MessageId {\n  return id as MessageId\n}\n\n/**\n * Correlates a model-issued tool call with the result sent back for it.\n * Provider-issued in real adapters; synthesized by assembler fallbacks.\n */\nexport type ToolCallId = Branded<'ToolCallId'>\n\n/**\n * Brand a tool-call identifier.\n * @param id - the provider-issued (or synthesized) call id.\n * @returns the same string, branded; no validation is performed.\n */\nexport function ToolCallId(id: string): ToolCallId {\n  return id as ToolCallId\n}\n\n/** Provider-issued request identifier, retained only for diagnostics. */\nexport type ProviderRequestId = Branded<'ProviderRequestId'>\n\n/**\n * Brand a provider-issued request identifier.\n * @param id - the opaque provider-issued string.\n * @returns the same string, branded; no validation is performed.\n */\nexport function ProviderRequestId(id: string): ProviderRequestId {\n  return id as ProviderRequestId\n}\n\n/**\n * Adapter-owned identifier for one model's selectable reasoning effort.\n *\n * Deliberately opaque rather than a fixed union: \"how hard should this model\n * think\" is spelled differently by every provider (OpenAI takes an effort\n * level, Anthropic takes a thinking token budget), and freezing one vendor's\n * vocabulary into the core would make the other one lie.\n */\nexport type ReasoningEffortId = Branded<'ReasoningEffortId'>\n\n/**\n * Brand a reasoning-effort identifier.\n * @param id - the opaque identifier exposed by one model's capabilities.\n * @returns the same string, branded; no validation is performed.\n */\nexport function ReasoningEffortId(id: string): ReasoningEffortId {\n  return id as ReasoningEffortId\n}\n"],"mappings":"AAwBA,SAAgB,EAAU,EAAuB,CAC/C,OAAO,CACT,CAaA,SAAgB,EAAW,EAAwB,CACjD,OAAO,CACT,CAUA,SAAgB,EAAkB,EAA+B,CAC/D,OAAO,CACT,CAiBA,SAAgB,EAAkB,EAA+B,CAC/D,OAAO,CACT"}

package/dist/primitives/freeze.d.ts

@@ -0,0 +1,20 @@
+//#region src/primitives/freeze.d.ts
+/**
+ * In-place deep freeze used to publish immutable messages and configs.
+ *
+ * @module ai-agent-sdk/core/primitives/freeze
+ */
+/**
+ * Deep-freeze a value in place with an ITERATIVE traversal, guarding cycles.
+ *
+ * Iterative rather than recursive so that a deeply nested message (a long tool
+ * result chain, say) cannot blow the JavaScript call stack. {@link AbortSignal}
+ * is skipped deliberately: it is the request's live cancellation channel and
+ * freezing it breaks abort.
+ * @param value - the value to freeze in place.
+ * @returns the same value, frozen.
+ */
+declare function deepFreeze<T>(value: T): T;
+//#endregion
+export { deepFreeze };
+//# sourceMappingURL=freeze.d.ts.map

package/dist/primitives/freeze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeze.d.ts","names":[],"sources":["../../src/primitives/freeze.ts"],"mappings":";;;;;;;;;;;;;;;;iBAgBgB,WAAW,GAAG,OAAO,IAAI"}

package/dist/primitives/freeze.js

@@ -0,0 +1,2 @@
+function e(e){let t=new WeakSet,n=[{kind:`visit`,node:e}];for(;n.length>0;){let e=n.pop();if(e===void 0)continue;if(e.kind===`property`){n.push({kind:`visit`,node:e.source[e.key]});continue}let r=e.node;if(typeof r!=`object`||!r||r instanceof AbortSignal||t.has(r))continue;t.add(r),Object.freeze(r);let i=Object.keys(r);for(let e=i.length-1;e>=0;e--){let t=i[e];t!==void 0&&n.push({kind:`property`,source:r,key:t})}}return e}export{e as deepFreeze};
+//# sourceMappingURL=freeze.js.map

package/dist/primitives/freeze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeze.js","names":[],"sources":["../../src/primitives/freeze.ts"],"sourcesContent":["/**\n * In-place deep freeze used to publish immutable messages and configs.\n *\n * @module ai-agent-sdk/core/primitives/freeze\n */\n\n/**\n * Deep-freeze a value in place with an ITERATIVE traversal, guarding cycles.\n *\n * Iterative rather than recursive so that a deeply nested message (a long tool\n * result chain, say) cannot blow the JavaScript call stack. {@link AbortSignal}\n * is skipped deliberately: it is the request's live cancellation channel and\n * freezing it breaks abort.\n * @param value - the value to freeze in place.\n * @returns the same value, frozen.\n */\nexport function deepFreeze<T>(value: T): T {\n  const seen = new WeakSet<object>()\n  const pending: (\n    | { kind: 'visit'; node: unknown }\n    | { kind: 'property'; source: Record<string, unknown>; key: string }\n  )[] = [{ kind: 'visit', node: value }]\n  while (pending.length > 0) {\n    const task = pending.pop()\n    if (task === undefined) continue\n    if (task.kind === 'property') {\n      pending.push({ kind: 'visit', node: task.source[task.key] })\n      continue\n    }\n    const node = task.node\n    if (node === null || typeof node !== 'object') continue\n    if (node instanceof AbortSignal) continue\n    if (seen.has(node)) continue\n    seen.add(node)\n    Object.freeze(node)\n    const keys = Object.keys(node)\n    for (let index = keys.length - 1; index >= 0; index--) {\n      const key = keys[index]\n      if (key === undefined) continue\n      pending.push({ kind: 'property', source: node as Record<string, unknown>, key })\n    }\n  }\n  return value\n}\n"],"mappings":"AAgBA,SAAgB,EAAc,EAAa,CACzC,IAAM,EAAO,IAAI,QACX,EAGA,CAAC,CAAE,KAAM,QAAS,KAAM,CAAM,CAAC,EACrC,KAAO,EAAQ,OAAS,GAAG,CACzB,IAAM,EAAO,EAAQ,IAAI,EACzB,GAAI,IAAS,IAAA,GAAW,SACxB,GAAI,EAAK,OAAS,WAAY,CAC5B,EAAQ,KAAK,CAAE,KAAM,QAAS,KAAM,EAAK,OAAO,EAAK,IAAK,CAAC,EAC3D,QACF,CACA,IAAM,EAAO,EAAK,KAGlB,GAFqB,OAAO,GAAS,WAAjC,GACA,aAAgB,aAChB,EAAK,IAAI,CAAI,EAAG,SACpB,EAAK,IAAI,CAAI,EACb,OAAO,OAAO,CAAI,EAClB,IAAM,EAAO,OAAO,KAAK,CAAI,EAC7B,IAAK,IAAI,EAAQ,EAAK,OAAS,EAAG,GAAS,EAAG,IAAS,CACrD,IAAM,EAAM,EAAK,GACb,IAAQ,IAAA,IACZ,EAAQ,KAAK,CAAE,KAAM,WAAY,OAAQ,EAAiC,KAAI,CAAC,CACjF,CACF,CACA,OAAO,CACT"}

package/dist/primitives/json-snapshot.js

@@ -0,0 +1,2 @@
+import{deepFreeze as e}from"./freeze.js";function t(e,t){let r=n(e,t);if(r===null||Array.isArray(r)||typeof r!=`object`)throw TypeError(`Expected a JSON object`);return r}function n(t,n){let i=0,a=new Set,o=new TextEncoder,s=(e,t)=>{if(i++,i>n.maxNodes||t>n.maxDepth)throw TypeError(`JSON data exceeds its bound`);if(e===null||typeof e==`boolean`||typeof e==`string`)return e;if(typeof e==`number`){if(!Number.isFinite(e))throw TypeError(`JSON number must be finite`);return e}if(Array.isArray(e))return c(e,t);if(typeof e!=`object`||!e)throw TypeError(`JSON data contains an unsupported value`);return l(e,t)},c=(e,t)=>{if(a.has(e))throw TypeError(`JSON data is cyclic`);let i=r(e,`length`);if(!Number.isSafeInteger(i)||Number(i)<0||Number(i)>n.maxArrayItems)throw TypeError(`JSON array exceeds its bound`);a.add(e);try{let n=[];for(let a=0;a<Number(i);a++)n.push(s(r(e,String(a)),t+1));return Object.freeze(n)}finally{a.delete(e)}},l=(e,t)=>{let i=Object.getPrototypeOf(e);if(i!==Object.prototype&&i!==null)throw TypeError(`JSON object must be plain`);if(a.has(e))throw TypeError(`JSON data is cyclic`);let c=Reflect.ownKeys(e);if(c.some(e=>typeof e!=`string`)||c.length>n.maxObjectFields)throw TypeError(`JSON object fields exceed their bound`);a.add(e);try{let i=Object.create(null);for(let a of c){if(o.encode(a).byteLength>n.maxKeyBytes)throw TypeError(`JSON object key exceeds its bound`);i[a]=s(r(e,a),t+1)}return Object.freeze(i)}finally{a.delete(e)}},u=s(t,0);if(o.encode(JSON.stringify(u)).byteLength>n.maxBytes)throw TypeError(`JSON data exceeds its byte bound`);return e(u)}function r(e,t){let n=Object.getOwnPropertyDescriptor(e,t);if(n===void 0)throw TypeError(`JSON arrays must not be sparse`);if(!(`value`in n))throw TypeError(`JSON data must not use accessors`);return n.value}export{t as snapshotJsonObject,n as snapshotJsonValue};
+//# sourceMappingURL=json-snapshot.js.map

package/dist/primitives/json-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-snapshot.js","names":[],"sources":["../../src/primitives/json-snapshot.ts"],"sourcesContent":["import { deepFreeze } from './freeze.ts'\nimport type { JsonObject, JsonValue } from './json.ts'\n\nexport interface JsonSnapshotLimits {\n  readonly maxObjectFields: number\n  readonly maxArrayItems: number\n  readonly maxDepth: number\n  readonly maxNodes: number\n  readonly maxKeyBytes: number\n  readonly maxBytes: number\n}\n\n/** Clone bounded lossless JSON without invoking accessors or serialization hooks. */\nexport function snapshotJsonObject(value: unknown, limits: JsonSnapshotLimits): Readonly<JsonObject> {\n  const snapshot = snapshotJsonValue(value, limits)\n  if (snapshot === null || Array.isArray(snapshot) || typeof snapshot !== 'object') {\n    throw new TypeError('Expected a JSON object')\n  }\n  return snapshot as Readonly<JsonObject>\n}\n\n/** Clone any bounded lossless JSON value, including primitive and array locators. */\nexport function snapshotJsonValue(value: unknown, limits: JsonSnapshotLimits): JsonValue {\n  let nodes = 0\n  const seen = new Set<object>()\n  const encoder = new TextEncoder()\n\n  const clone = (input: unknown, depth: number): JsonValue => {\n    nodes++\n    if (nodes > limits.maxNodes || depth > limits.maxDepth) throw new TypeError('JSON data exceeds its bound')\n    if (input === null || typeof input === 'boolean' || typeof input === 'string') return input\n    if (typeof input === 'number') {\n      if (!Number.isFinite(input)) throw new TypeError('JSON number must be finite')\n      return input\n    }\n    if (Array.isArray(input)) return cloneArray(input, depth)\n    if (typeof input !== 'object' || input === null) throw new TypeError('JSON data contains an unsupported value')\n    return cloneObject(input, depth)\n  }\n\n  const cloneArray = (source: readonly unknown[], depth: number): readonly JsonValue[] => {\n    if (seen.has(source)) throw new TypeError('JSON data is cyclic')\n    const length = ownData(source, 'length')\n    if (!Number.isSafeInteger(length) || Number(length) < 0 || Number(length) > limits.maxArrayItems) {\n      throw new TypeError('JSON array exceeds its bound')\n    }\n    seen.add(source)\n    try {\n      const result: JsonValue[] = []\n      for (let index = 0; index < Number(length); index++) result.push(clone(ownData(source, String(index)), depth + 1))\n      return Object.freeze(result)\n    } finally { seen.delete(source) }\n  }\n\n  const cloneObject = (source: object, depth: number): Readonly<JsonObject> => {\n    const prototype: unknown = Object.getPrototypeOf(source)\n    if (prototype !== Object.prototype && prototype !== null) throw new TypeError('JSON object must be plain')\n    if (seen.has(source)) throw new TypeError('JSON data is cyclic')\n    const keys = Reflect.ownKeys(source)\n    if (keys.some(key => typeof key !== 'string') || keys.length > limits.maxObjectFields) {\n      throw new TypeError('JSON object fields exceed their bound')\n    }\n    seen.add(source)\n    try {\n      const result: Record<string, JsonValue> = Object.create(null) as Record<string, JsonValue>\n      for (const key of keys as string[]) {\n        if (encoder.encode(key).byteLength > limits.maxKeyBytes) throw new TypeError('JSON object key exceeds its bound')\n        result[key] = clone(ownData(source, key), depth + 1)\n      }\n      return Object.freeze(result)\n    } finally { seen.delete(source) }\n  }\n\n  const snapshot = clone(value, 0)\n  if (encoder.encode(JSON.stringify(snapshot)).byteLength > limits.maxBytes) {\n    throw new TypeError('JSON data exceeds its byte bound')\n  }\n  return deepFreeze(snapshot)\n}\n\nfunction ownData(source: object, key: string): unknown {\n  const descriptor = Object.getOwnPropertyDescriptor(source, key)\n  if (descriptor === undefined) throw new TypeError('JSON arrays must not be sparse')\n  if (!('value' in descriptor)) throw new TypeError('JSON data must not use accessors')\n  return descriptor.value\n}\n"],"mappings":"yCAaA,SAAgB,EAAmB,EAAgB,EAAkD,CACnG,IAAM,EAAW,EAAkB,EAAO,CAAM,EAChD,GAAI,IAAa,MAAQ,MAAM,QAAQ,CAAQ,GAAK,OAAO,GAAa,SACtE,MAAU,UAAU,wBAAwB,EAE9C,OAAO,CACT,CAGA,SAAgB,EAAkB,EAAgB,EAAuC,CACvF,IAAI,EAAQ,EACN,EAAO,IAAI,IACX,EAAU,IAAI,YAEd,GAAS,EAAgB,IAA6B,CAE1D,GADA,IACI,EAAQ,EAAO,UAAY,EAAQ,EAAO,SAAU,MAAU,UAAU,6BAA6B,EACzG,GAAI,IAAU,MAAQ,OAAO,GAAU,WAAa,OAAO,GAAU,SAAU,OAAO,EACtF,GAAI,OAAO,GAAU,SAAU,CAC7B,GAAI,CAAC,OAAO,SAAS,CAAK,EAAG,MAAU,UAAU,4BAA4B,EAC7E,OAAO,CACT,CACA,GAAI,MAAM,QAAQ,CAAK,EAAG,OAAO,EAAW,EAAO,CAAK,EACxD,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAU,UAAU,yCAAyC,EAC9G,OAAO,EAAY,EAAO,CAAK,CACjC,EAEM,GAAc,EAA4B,IAAwC,CACtF,GAAI,EAAK,IAAI,CAAM,EAAG,MAAU,UAAU,qBAAqB,EAC/D,IAAM,EAAS,EAAQ,EAAQ,QAAQ,EACvC,GAAI,CAAC,OAAO,cAAc,CAAM,GAAK,OAAO,CAAM,EAAI,GAAK,OAAO,CAAM,EAAI,EAAO,cACjF,MAAU,UAAU,8BAA8B,EAEpD,EAAK,IAAI,CAAM,EACf,GAAI,CACF,IAAM,EAAsB,CAAC,EAC7B,IAAK,IAAI,EAAQ,EAAG,EAAQ,OAAO,CAAM,EAAG,IAAS,EAAO,KAAK,EAAM,EAAQ,EAAQ,OAAO,CAAK,CAAC,EAAG,EAAQ,CAAC,CAAC,EACjH,OAAO,OAAO,OAAO,CAAM,CAC7B,QAAU,CAAE,EAAK,OAAO,CAAM,CAAE,CAClC,EAEM,GAAe,EAAgB,IAAwC,CAC3E,IAAM,EAAqB,OAAO,eAAe,CAAM,EACvD,GAAI,IAAc,OAAO,WAAa,IAAc,KAAM,MAAU,UAAU,2BAA2B,EACzG,GAAI,EAAK,IAAI,CAAM,EAAG,MAAU,UAAU,qBAAqB,EAC/D,IAAM,EAAO,QAAQ,QAAQ,CAAM,EACnC,GAAI,EAAK,KAAK,GAAO,OAAO,GAAQ,QAAQ,GAAK,EAAK,OAAS,EAAO,gBACpE,MAAU,UAAU,uCAAuC,EAE7D,EAAK,IAAI,CAAM,EACf,GAAI,CACF,IAAM,EAAoC,OAAO,OAAO,IAAI,EAC5D,IAAK,IAAM,KAAO,EAAkB,CAClC,GAAI,EAAQ,OAAO,CAAG,CAAC,CAAC,WAAa,EAAO,YAAa,MAAU,UAAU,mCAAmC,EAChH,EAAO,GAAO,EAAM,EAAQ,EAAQ,CAAG,EAAG,EAAQ,CAAC,CACrD,CACA,OAAO,OAAO,OAAO,CAAM,CAC7B,QAAU,CAAE,EAAK,OAAO,CAAM,CAAE,CAClC,EAEM,EAAW,EAAM,EAAO,CAAC,EAC/B,GAAI,EAAQ,OAAO,KAAK,UAAU,CAAQ,CAAC,CAAC,CAAC,WAAa,EAAO,SAC/D,MAAU,UAAU,kCAAkC,EAExD,OAAO,EAAW,CAAQ,CAC5B,CAEA,SAAS,EAAQ,EAAgB,EAAsB,CACrD,IAAM,EAAa,OAAO,yBAAyB,EAAQ,CAAG,EAC9D,GAAI,IAAe,IAAA,GAAW,MAAU,UAAU,gCAAgC,EAClF,GAAI,EAAE,UAAW,GAAa,MAAU,UAAU,kCAAkC,EACpF,OAAO,EAAW,KACpB"}

package/dist/primitives/json.d.ts

@@ -0,0 +1,32 @@
+//#region src/primitives/json.d.ts
+/**
+ * Lossless-JSON values.
+ *
+ * Used wherever a value has to survive being logged, persisted, replayed, or sent
+ * across a process boundary. Typing it explicitly rather than using `unknown`
+ * makes the constraint checkable: a tool that returns a `Map`, a `Date`, or a
+ * class instance cannot silently produce a log entry that fails to round-trip.
+ *
+ * @module ai-agent-sdk/core/primitives/json
+ */
+/** A value that survives `JSON.parse(JSON.stringify(x))` unchanged. */
+type JsonValue = string | number | boolean | null | readonly JsonValue[] | {
+  readonly [key: string]: JsonValue;
+};
+/** A JSON object, when the top level must not be a primitive or array. */
+type JsonObject = {
+  readonly [key: string]: JsonValue;
+};
+/**
+ * Whether a value round-trips through JSON unchanged.
+ *
+ * Rejects `undefined`, functions, symbols, and any non-plain object — including
+ * `Date` and `Map`, which `JSON.stringify` accepts but corrupts (a `Date` becomes
+ * a string, a `Map` becomes `{}`). Cycles are rejected rather than throwing.
+ * @param value - the value to check.
+ * @returns true when the value is losslessly JSON.
+ */
+declare function isJsonValue(value: unknown): value is JsonValue;
+//#endregion
+export { JsonObject, JsonValue, isJsonValue };
+//# sourceMappingURL=json.d.ts.map

package/dist/primitives/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","names":[],"sources":["../../src/primitives/json.ts"],"mappings":";;;;;;;;;;;;KAYY,wDAKC;YACG,cAAc;;;KAGlB;YAAyB,cAAc;;;;;;;;;;;iBAWnC,YAAY,iBAAiB,SAAS"}