@alvin0/ai-agent-sdk-core 0.1.0

package/dist/logging/types.d.ts

@@ -0,0 +1,53 @@
+import { JsonObject } from "../primitives/json.js";
+//#region src/logging/types.d.ts
+type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/** Minimal structured logger contract shared without reversing observation ownership. */
+interface SdkLogger {
+  child(fields: Readonly<JsonObject>): SdkLogger;
+  trace(message: string, fields?: Readonly<JsonObject>): void;
+  debug(message: string, fields?: Readonly<JsonObject>): void;
+  info(message: string, fields?: Readonly<JsonObject>): void;
+  warn(message: string, fields?: Readonly<JsonObject>): void;
+  error(message: string, fields?: Readonly<JsonObject>): void;
+  fatal(message: string, fields?: Readonly<JsonObject>): void;
+}
+type LoggedOperationStatus = 'success' | 'error' | 'aborted' | 'rejected' | 'unknown';
+/** Metadata-only operation envelope shared by runtime-active integrations. */
+type IntegrationOperationEvidenceFields = (JsonObject & {
+  readonly integrationSchemaVersion: 1;
+  readonly integrationFamily: string;
+  readonly integrationOperation: string;
+  readonly operationId: string;
+  readonly kind: 'logical-start';
+}) | (JsonObject & {
+  readonly integrationSchemaVersion: 1;
+  readonly integrationFamily: string;
+  readonly integrationOperation: string;
+  readonly operationId: string;
+  readonly kind: 'attempt-start';
+  readonly attemptId: string;
+  readonly attemptNumber: number;
+}) | (JsonObject & {
+  readonly integrationSchemaVersion: 1;
+  readonly integrationFamily: string;
+  readonly integrationOperation: string;
+  readonly operationId: string;
+  readonly kind: 'attempt-terminal';
+  readonly attemptId: string;
+  readonly attemptNumber: number;
+  readonly status: LoggedOperationStatus;
+  readonly durationMs: number;
+  readonly errorCode?: string;
+}) | (JsonObject & {
+  readonly integrationSchemaVersion: 1;
+  readonly integrationFamily: string;
+  readonly integrationOperation: string;
+  readonly operationId: string;
+  readonly kind: 'logical-terminal';
+  readonly status: LoggedOperationStatus;
+  readonly durationMs: number;
+  readonly errorCode?: string;
+});
+//#endregion
+export { IntegrationOperationEvidenceFields, LogLevel, SdkLogger };
+//# sourceMappingURL=types.d.ts.map

package/dist/logging/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/logging/types.ts"],"mappings":";;KAEY;;UAGK;EACf,MAAM,QAAQ,SAAS,cAAc;EACrC,MAAM,iBAAiB,SAAS,SAAS;EACzC,MAAM,iBAAiB,SAAS,SAAS;EACzC,KAAK,iBAAiB,SAAS,SAAS;EACxC,KAAK,iBAAiB,SAAS,SAAS;EACxC,MAAM,iBAAiB,SAAS,SAAS;EACzC,MAAM,iBAAiB,SAAS,SAAS;;KAGtC;;KAGO,sCACP;WACU;WACA;WACA;WACA;WACA;MAEV;WACU;WACA;WACA;WACA;WACA;WACA;WACA;MAEV;WACU;WACA;WACA;WACA;WACA;WACA;WACA;WACA,QAAQ;WACR;WACA;MAEV;WACU;WACA;WACA;WACA;WACA;WACA,QAAQ;WACR;WACA"}

package/dist/logging/types.js

@@ -0,0 +1,2 @@
+const e=Object.freeze({child:()=>e,trace:()=>void 0,debug:()=>void 0,info:()=>void 0,warn:()=>void 0,error:()=>void 0,fatal:()=>void 0});export{e as CLOSED_RUNTIME_LOGGER};
+//# sourceMappingURL=types.js.map

package/dist/logging/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/logging/types.ts"],"sourcesContent":["import type { JsonObject } from '../primitives/json.ts'\n\nexport type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal'\n\n/** Minimal structured logger contract shared without reversing observation ownership. */\nexport interface SdkLogger {\n  child(fields: Readonly<JsonObject>): SdkLogger\n  trace(message: string, fields?: Readonly<JsonObject>): void\n  debug(message: string, fields?: Readonly<JsonObject>): void\n  info(message: string, fields?: Readonly<JsonObject>): void\n  warn(message: string, fields?: Readonly<JsonObject>): void\n  error(message: string, fields?: Readonly<JsonObject>): void\n  fatal(message: string, fields?: Readonly<JsonObject>): void\n}\n\ntype LoggedOperationStatus = 'success' | 'error' | 'aborted' | 'rejected' | 'unknown'\n\n/** Metadata-only operation envelope shared by runtime-active integrations. */\nexport type IntegrationOperationEvidenceFields =\n  | (JsonObject & {\n      readonly integrationSchemaVersion: 1\n      readonly integrationFamily: string\n      readonly integrationOperation: string\n      readonly operationId: string\n      readonly kind: 'logical-start'\n    })\n  | (JsonObject & {\n      readonly integrationSchemaVersion: 1\n      readonly integrationFamily: string\n      readonly integrationOperation: string\n      readonly operationId: string\n      readonly kind: 'attempt-start'\n      readonly attemptId: string\n      readonly attemptNumber: number\n    })\n  | (JsonObject & {\n      readonly integrationSchemaVersion: 1\n      readonly integrationFamily: string\n      readonly integrationOperation: string\n      readonly operationId: string\n      readonly kind: 'attempt-terminal'\n      readonly attemptId: string\n      readonly attemptNumber: number\n      readonly status: LoggedOperationStatus\n      readonly durationMs: number\n      readonly errorCode?: string\n    })\n  | (JsonObject & {\n      readonly integrationSchemaVersion: 1\n      readonly integrationFamily: string\n      readonly integrationOperation: string\n      readonly operationId: string\n      readonly kind: 'logical-terminal'\n      readonly status: LoggedOperationStatus\n      readonly durationMs: number\n      readonly errorCode?: string\n    })\n\nexport const CLOSED_RUNTIME_LOGGER: SdkLogger = Object.freeze({\n  child: () => CLOSED_RUNTIME_LOGGER,\n  trace: () => undefined, debug: () => undefined, info: () => undefined,\n  warn: () => undefined, error: () => undefined, fatal: () => undefined,\n})\n"],"mappings":"AA0DA,MAAa,EAAmC,OAAO,OAAO,CAC5D,UAAa,EACb,UAAa,IAAA,GAAW,UAAa,IAAA,GAAW,SAAY,IAAA,GAC5D,SAAY,IAAA,GAAW,UAAa,IAAA,GAAW,UAAa,IAAA,EAC9D,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,10 @@
+import { SdkLogger } from "./logging/types.js";
+import { AgentCompactionConfig, AgentCompactionOptions, resolveCompactionConfig } from "./agent/memory/compaction-config.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 { 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 { MEMORY_ERROR_CODES, MEMORY_STORE_API_VERSION } from "./composition/memory/config.js";
+import { defineMemoryStore } from "./composition/memory/definition.js";
+export { type AgentCompactionConfig, type AgentCompactionOptions, AgentMemory, type AgentMemoryConfig, type AgentMemoryConfigInput, type AgentMemoryItem, type AgentMemoryKind, type AgentMemorySeed, type AgentMemorySnapshot, COMPACTION_INSTRUCTION, type CompactionResult, ContextCompactor, type ContextCompactorOptions, MEMORY_ERROR_CODES, MEMORY_STORE_API_VERSION, type MemoryBinding, type MemoryCommitInput, type MemoryCommitResult, type MemoryLoadResult, type MemoryScope, type MemoryStore, type MemoryStoreDefinition, type MemoryStoreOptions, type SdkLogger, defineMemoryStore, estimateContextTokens, estimateMessageTokens, resolveCompactionConfig, resolveMemoryConfig, selectCompactablePrefix };

package/dist/memory.js

@@ -0,0 +1 @@
+import{AgentMemory as e,resolveMemoryConfig as t}from"./agent/memory/memory.js";import{estimateContextTokens as n,estimateMessageTokens as r}from"./agent/memory/token-estimator.js";import{selectCompactablePrefix as i}from"./agent/memory/surface-compaction.js";import{COMPACTION_INSTRUCTION as a,ContextCompactor as o}from"./agent/memory/compaction.js";import{resolveCompactionConfig as s}from"./agent/memory/compaction-config.js";import{MEMORY_ERROR_CODES as c,MEMORY_STORE_API_VERSION as l}from"./composition/memory/config.js";import{defineMemoryStore as u}from"./composition/memory/definition.js";export{e as AgentMemory,a as COMPACTION_INSTRUCTION,o as ContextCompactor,c as MEMORY_ERROR_CODES,l as MEMORY_STORE_API_VERSION,u as defineMemoryStore,n as estimateContextTokens,r as estimateMessageTokens,s as resolveCompactionConfig,t as resolveMemoryConfig,i as selectCompactablePrefix};

package/dist/message/content.d.ts

@@ -0,0 +1,125 @@
+import { ToolCallId } from "../primitives/brand.js";
+import { JsonValue } from "../primitives/json.js";
+//#region src/message/content.d.ts
+/** Whether assistant text is interim narration or the terminal answer. */
+type AssistantTextPhase = 'commentary' | 'final-answer';
+/** Plain text visible to the end user. */
+interface TextBlock {
+  type: 'text';
+  text: string;
+  /** Provider-supplied or loop-inferred phase for assistant text. */
+  phase?: AssistantTextPhase;
+  /** Provider-returned citations and other public annotations. */
+  annotations?: readonly TextAnnotation[];
+}
+interface UrlCitationAnnotation {
+  type: 'url-citation';
+  url: string;
+  title?: string;
+  startIndex?: number;
+  endIndex?: number;
+  /** Adapter-private citation payload needed for byte-faithful replay. */
+  providerState?: unknown;
+}
+interface TextAnnotationMap {
+  'url-citation': UrlCitationAnnotation;
+}
+type TextAnnotation = TextAnnotationMap[keyof TextAnnotationMap];
+/**
+ * Reasoning / thinking content, kept distinct from visible text.
+ *
+ * `providerState` exists for a concrete reason: Anthropic requires a response's
+ * thinking block to be echoed back byte-identically, with its signature, on the
+ * next request of a tool-use loop. Dropping it degrades quality and can be
+ * rejected outright, so the block carries whatever the adapter needs to
+ * reconstruct itself. The value is adapter-private and opaque above that layer.
+ */
+interface ReasoningBlock {
+  type: 'reasoning';
+  text: string;
+  /** Adapter-private lossless state needed to replay this block on a later request. */
+  providerState?: unknown;
+}
+/** Raster image media types both supported providers accept. */
+type ImageMediaType = 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp';
+/**
+ * Where an image's bytes come from.
+ *
+ * Inline rather than a handle into a durable attachment store, because an SDK
+ * cannot assume its host has one. A consumer that does have durable storage
+ * resolves its own reference into one of these before building the request.
+ */
+type ImageSource = {
+  kind: 'base64';
+  mediaType: ImageMediaType;
+  data: string;
+} | {
+  kind: 'url';
+  url: string;
+} | {
+  kind: 'file';
+  fileId: string;
+};
+type ImageDetail = 'auto' | 'low' | 'high' | 'original';
+/** An image, valid in user content and echoed in assistant content. */
+interface ImageBlock {
+  type: 'image';
+  source: ImageSource;
+  detail?: ImageDetail;
+}
+/** A tool the provider ran internally, such as web search or image generation. */
+interface NativeToolCallBlock {
+  type: 'native-tool-call';
+  /** Provider item id, used for replay and GUI correlation. */
+  id: string;
+  /** Neutral tool name (`web-search`, `image-generation`, or an extension). */
+  name: string;
+  status?: string;
+  arguments?: JsonValue;
+  /** Public result content, including generated images. */
+  content: ContentBlock[];
+  /** Adapter-private item needed for stateless replay. */
+  providerState?: unknown;
+}
+/** A tool invocation requested by the model. */
+interface ToolCallBlock {
+  type: 'tool-call';
+  /** Provider-issued call id; correlates with the matching tool result. */
+  id: ToolCallId;
+  name: string;
+  /**
+   * Arguments as the RAW JSON string the model produced.
+   *
+   * Deliberately not parsed here. Models emit invalid JSON often enough that
+   * parsing at the transport boundary would turn a recoverable "tell the model it
+   * sent bad arguments" into an unrecoverable stream failure. The tool layer
+   * parses, and reports any error back into the conversation.
+   */
+  arguments: string;
+}
+/** The result of a tool invocation, sent back to the model. */
+interface ToolResultBlock {
+  type: 'tool-result';
+  toolCallId: ToolCallId;
+  content: ContentBlock[];
+  isError?: boolean;
+}
+/**
+ * Merge-extensible content blocks keyed by `type`. Widen by declaration merging
+ * this interface; a new CORE block must land with support in every adapter.
+ */
+interface ContentBlockMap {
+  'text': TextBlock;
+  'reasoning': ReasoningBlock;
+  'image': ImageBlock;
+  'native-tool-call': NativeToolCallBlock;
+  'tool-call': ToolCallBlock;
+  'tool-result': ToolResultBlock;
+}
+/** The block `type` tag vocabulary; widens with {@link ContentBlockMap}. */
+type ContentBlockType = keyof ContentBlockMap;
+/** Any known content block. Switch on `type` and fall through unknowns. */
+type ContentBlock = ContentBlockMap[ContentBlockType];
+//#endregion
+export { AssistantTextPhase, ContentBlock, ContentBlockMap, ContentBlockType, ImageBlock, ImageDetail, ImageMediaType, ImageSource, NativeToolCallBlock, ReasoningBlock, TextAnnotation, TextAnnotationMap, TextBlock, ToolCallBlock, ToolResultBlock, UrlCitationAnnotation };
+//# sourceMappingURL=content.d.ts.map

package/dist/message/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","names":[],"sources":["../../src/message/content.ts"],"mappings":";;;;KAgBY;;UAGK;EACf;EACA;;EAEA,QAAQ;;EAER,uBAAuB;;UAGR;EACf;EACA;EACA;EACA;EACA;;EAEA;;UAGe;EACf,gBAAgB;;KAGN,iBAAiB,wBAAwB;;;;;;;;;;UAWpC;EACf;EACA;;EAEA;;;KAIU;;;;;;;;KASA;EACN;EAAgB,WAAW;EAAgB;;EAC3C;EAAa;;EACb;EAAc;;KAER;;UAGK;EACf;EACA,QAAQ;EACR,SAAS;;;UAIM;EACf;;EAEA;;EAEA;EACA;EACA,YAAY;;EAEZ,SAAS;;EAET;;;UAIe;EACf;;EAEA,IAAI;EACJ;;;;;;;;;EASA;;;UAIe;EACf;EACA,YAAY;EACZ,SAAS;EACT;;;;;;UAOe;EACf,QAAQ;EACR,aAAa;EACb,SAAS;EACT,oBAAoB;EACpB,aAAa;EACb,eAAe;;;KAIL,yBAAyB;;KAGzB,eAAe,gBAAgB"}

package/dist/message/message.d.ts

@@ -0,0 +1,154 @@
+import { MessageId, ToolCallId } from "../primitives/brand.js";
+import { ContentBlock, ToolResultBlock } from "./content.js";
+//#region src/message/message.d.ts
+/** Provider/model identity and adapter-private replay data for an assistant message. */
+interface AssistantProvenance {
+  /** Provider route that produced the message. */
+  provider: string;
+  /** Model id that produced the message. */
+  model: string;
+  /**
+   * Lossless-JSON adapter state needed to replay the provider response.
+   *
+   * Exposed to an adapter only when that same adapter instance owns both this
+   * historical route and the route being called, because one provider's opaque
+   * state is meaningless  Eand possibly rejected  Eat another's endpoint.
+   */
+  replayState?: unknown;
+}
+/** Source of an assistant message produced by a routed model. */
+interface ModelMessageSource extends AssistantProvenance {
+  kind: 'model';
+}
+/** Source of a message carrying one tool result. */
+interface ToolMessageSource {
+  kind: 'tool';
+  callId: ToolCallId;
+}
+/** Source of a user-role message sent by another long-lived agent session. */
+interface AgentMessageSource {
+  readonly kind: 'agent-message';
+  readonly teamId: string;
+  readonly messageId: string;
+  readonly sender: string;
+  readonly senderAgentId: string;
+}
+/** Source of a message received from an interoperable A2A protocol peer. */
+interface A2AMessageSource {
+  readonly kind: 'a2a-message';
+  readonly contextId: string;
+  readonly messageId: string;
+  readonly taskId?: string;
+}
+/**
+ * Merge-extensible record of where a message came from. Widen by declaration
+ * merging; switch on `kind` and fall through unknowns.
+ */
+interface MessageSourceMap {
+  /** Typed or supplied by the end user. */
+  user: {
+    kind: 'user';
+  };
+  /** Injected by the application rather than the user (assembled context, notices). */
+  app: {
+    kind: 'app';
+    producer: string;
+  };
+  /** Produced by a model through a provider route. */
+  model: ModelMessageSource;
+  /** The result of one tool call. */
+  tool: ToolMessageSource;
+  /** Attributed context delivered through the in-process A2A control plane. */
+  'agent-message': AgentMessageSource;
+  /** Input received through an A2A protocol server transport. */
+  'a2a-message': A2AMessageSource;
+}
+/** Any known message source. */
+type MessageSource = MessageSourceMap[keyof MessageSourceMap];
+/** One immutable message, shared by history, requests, and consumers. */
+interface Message {
+  /** Stable identity, preserved across every representation boundary. */
+  readonly id: MessageId;
+  /** Provider-neutral conversation role. */
+  readonly role: 'system' | 'user' | 'assistant';
+  /** The exact model-facing blocks. */
+  readonly content: readonly ContentBlock[];
+  /** Who produced this message. */
+  readonly source: MessageSource;
+}
+/** A user-role message. */
+interface UserMessage extends Message {
+  readonly role: 'user';
+}
+/** A model-produced assistant message. */
+interface AssistantMessage extends Message {
+  readonly role: 'assistant';
+  readonly source: ModelMessageSource;
+}
+/** A tool result, carried as a user-role message with a single tool-result block. */
+interface ToolResultMessage extends Message {
+  readonly role: 'user';
+  readonly content: readonly [ToolResultBlock];
+  readonly source: ToolMessageSource;
+}
+type NewMessage = Omit<Message, 'id'>;
+type NewUserMessage = Omit<UserMessage, 'id' | 'role'>;
+type NewAssistantMessage = Omit<AssistantMessage, 'id' | 'role' | 'source'> & {
+  readonly source: Omit<ModelMessageSource, 'kind'> & {
+    readonly kind?: never;
+  };
+};
+/**
+ * Detach and deep-freeze a message whose identity already exists.
+ *
+ * Clones first, so freezing cannot reach back into a caller's live object graph.
+ * @param message - a complete message, including its identity.
+ * @returns an immutable snapshot preserving that identity.
+ */
+declare function freezeMessage<T extends Message>(message: T): T;
+/**
+ * Create one identified message and freeze it before publication.
+ *
+ * The `id?: never` phantom parameter is what stops a caller from supplying an
+ * identity: identity is minted here so it cannot be duplicated across messages.
+ * @param input - complete role, content, and source.
+ * @returns an immutable message with a fresh identity.
+ */
+declare function createMessage<T extends NewMessage>(input: T & {
+  readonly id?: never;
+}): T & Pick<Message, 'id'>;
+/**
+ * Create one identified user-role message.
+ * @param input - complete content and source.
+ * @returns an immutable user message with a fresh identity.
+ */
+declare function createUserMessage<T extends NewUserMessage>(input: T & {
+  readonly id?: never;
+  readonly role?: never;
+}): T & Pick<UserMessage, 'id' | 'role'>;
+/**
+ * Create one identified model-produced assistant message.
+ * @param input - content plus the provider, model, and optional replay state.
+ * @returns an immutable assistant message with fixed role/source tags.
+ */
+declare function createAssistantMessage(input: NewAssistantMessage & {
+  readonly id?: never;
+  readonly role?: never;
+}): AssistantMessage;
+/** Convenience shape for the common "user typed some text" case. */
+declare function createTextMessage(text: string): UserMessage;
+/** Input whose acceptance creates one tool-result message. */
+interface ToolResultMessageInput {
+  readonly callId: ToolCallId;
+  readonly content: readonly ContentBlock[];
+  readonly isError: boolean;
+}
+/**
+ * Create and freeze one identified tool-result message.
+ * @param input - call identity, result blocks, and outcome.
+ * @returns an immutable user-role tool-result message.
+ */
+declare function createToolResultMessage(input: ToolResultMessageInput): ToolResultMessage;
+//#endregion
+export { A2AMessageSource, AgentMessageSource, AssistantMessage, AssistantProvenance, Message, MessageSource, MessageSourceMap, ModelMessageSource, ToolMessageSource, ToolResultMessage, ToolResultMessageInput, UserMessage, createAssistantMessage, createMessage, createTextMessage, createToolResultMessage, createUserMessage, freezeMessage };
+//# sourceMappingURL=message.d.ts.map

package/dist/message/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","names":[],"sources":["../../src/message/message.ts"],"mappings":";;;;UAsBiB;;EAEf;;EAEA;;;;;;;;EAQA;;;UAIe,2BAA2B;EAC1C;;;UAIe;EACf;EACA,QAAQ;;;UAIO;WACN;WACA;WACA;WACA;WACA;;;UAIM;WACN;WACA;WACA;WACA;;;;;;UAOM;;EAEf;IAAQ;;;EAER;IAAO;IAAa;;;EAEpB,OAAO;;EAEP,MAAM;;EAEN,iBAAiB;;EAEjB,eAAe;;;KAIL,gBAAgB,uBAAuB;;UAGlC;;WAEN,IAAI;;WAEJ;;WAEA,kBAAkB;;WAElB,QAAQ;;;UAIF,oBAAoB;WAC1B;;;UAIM,yBAAyB;WAC/B;WACA,QAAQ;;;UAIF,0BAA0B;WAChC;WACA,mBAAmB;WACnB,QAAQ;;KAGd,aAAa,KAAK;KAClB,iBAAiB,KAAK;KACtB,sBAAsB,KAAK;WACrB,QAAQ,KAAK;aAAyC;;;;;;;;;;iBAejD,cAAc,UAAU,SAAS,SAAS,IAAI;;;;;;;;;iBAY9C,cAAc,UAAU,YACtC,OAAO;WAAe;IACrB,IAAI,KAAK;;;;;;iBASI,kBAAkB,UAAU,gBAC1C,OAAO;WAAe;WAAqB;IAC1C,IAAI,KAAK;;;;;;iBASI,uBACd,OAAO;WAAiC;WAAqB;IAC5D;;iBASa,kBAAkB,eAAe;;UAKhC;WACN,QAAQ;WACR,kBAAkB;WAClB;;;;;;;iBAQK,wBAAwB,OAAO,yBAAyB"}

package/dist/message/message.js

@@ -0,0 +1,2 @@
+import{MessageId as e}from"../primitives/brand.js";import{deepFreeze as t}from"../primitives/freeze.js";import{systemRandomId as n}from"../platform/adapter.js";function r(){return e(n())}function i(e){return t(structuredClone(e))}function a(e){return i({...e,id:r()})}function o(e){return a({...e,role:`user`})}function s(e){return a({role:`assistant`,content:e.content,source:{kind:`model`,...e.source}})}function c(e){return o({content:[{type:`text`,text:e}],source:{kind:`user`}})}function l(e){return o({source:{kind:`tool`,callId:e.callId},content:[{type:`tool-result`,toolCallId:e.callId,content:[...e.content],isError:e.isError}]})}export{s as createAssistantMessage,a as createMessage,c as createTextMessage,l as createToolResultMessage,o as createUserMessage,i as freezeMessage};
+//# sourceMappingURL=message.js.map

package/dist/message/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","names":[],"sources":["../../src/message/message.ts"],"sourcesContent":["import { systemRandomId } from '../platform/adapter.ts'\n/**\n * The message value type, its identity, and immutable construction helpers.\n *\n * Two decisions carry most of the weight here:\n *\n * 1. `role` is a neutral three-value enum, and WHO produced a message lives in\n *    `source` instead. Providers disagree about roles  Ea tool result is its own\n *    role in one API and a user-role block in another  Eso provenance is kept on\n *    a separate axis that no provider dictates.\n * 2. Messages are frozen before publication. History is shared by reference\n *    across turns, retries, and (for the caller) any UI; a single in-place edit\n *    would silently rewrite the past, and cache-prefix reuse with it.\n *\n * @module ai-agent-sdk/core/message/message\n */\n\nimport { deepFreeze } from '../primitives/freeze.ts'\nimport { MessageId, type ToolCallId } from '../primitives/brand.ts'\nimport type { ContentBlock, ToolResultBlock } from './content.ts'\n\n/** Provider/model identity and adapter-private replay data for an assistant message. */\nexport interface AssistantProvenance {\n  /** Provider route that produced the message. */\n  provider: string\n  /** Model id that produced the message. */\n  model: string\n  /**\n   * Lossless-JSON adapter state needed to replay the provider response.\n   *\n   * Exposed to an adapter only when that same adapter instance owns both this\n   * historical route and the route being called, because one provider's opaque\n   * state is meaningless  Eand possibly rejected  Eat another's endpoint.\n   */\n  replayState?: unknown\n}\n\n/** Source of an assistant message produced by a routed model. */\nexport interface ModelMessageSource extends AssistantProvenance {\n  kind: 'model'\n}\n\n/** Source of a message carrying one tool result. */\nexport interface ToolMessageSource {\n  kind: 'tool'\n  callId: ToolCallId\n}\n\n/** Source of a user-role message sent by another long-lived agent session. */\nexport interface AgentMessageSource {\n  readonly kind: 'agent-message'\n  readonly teamId: string\n  readonly messageId: string\n  readonly sender: string\n  readonly senderAgentId: string\n}\n\n/** Source of a message received from an interoperable A2A protocol peer. */\nexport interface A2AMessageSource {\n  readonly kind: 'a2a-message'\n  readonly contextId: string\n  readonly messageId: string\n  readonly taskId?: string\n}\n\n/**\n * Merge-extensible record of where a message came from. Widen by declaration\n * merging; switch on `kind` and fall through unknowns.\n */\nexport interface MessageSourceMap {\n  /** Typed or supplied by the end user. */\n  user: { kind: 'user' }\n  /** Injected by the application rather than the user (assembled context, notices). */\n  app: { kind: 'app'; producer: string }\n  /** Produced by a model through a provider route. */\n  model: ModelMessageSource\n  /** The result of one tool call. */\n  tool: ToolMessageSource\n  /** Attributed context delivered through the in-process A2A control plane. */\n  'agent-message': AgentMessageSource\n  /** Input received through an A2A protocol server transport. */\n  'a2a-message': A2AMessageSource\n}\n\n/** Any known message source. */\nexport type MessageSource = MessageSourceMap[keyof MessageSourceMap]\n\n/** One immutable message, shared by history, requests, and consumers. */\nexport interface Message {\n  /** Stable identity, preserved across every representation boundary. */\n  readonly id: MessageId\n  /** Provider-neutral conversation role. */\n  readonly role: 'system' | 'user' | 'assistant'\n  /** The exact model-facing blocks. */\n  readonly content: readonly ContentBlock[]\n  /** Who produced this message. */\n  readonly source: MessageSource\n}\n\n/** A user-role message. */\nexport interface UserMessage extends Message {\n  readonly role: 'user'\n}\n\n/** A model-produced assistant message. */\nexport interface AssistantMessage extends Message {\n  readonly role: 'assistant'\n  readonly source: ModelMessageSource\n}\n\n/** A tool result, carried as a user-role message with a single tool-result block. */\nexport interface ToolResultMessage extends Message {\n  readonly role: 'user'\n  readonly content: readonly [ToolResultBlock]\n  readonly source: ToolMessageSource\n}\n\ntype NewMessage = Omit<Message, 'id'>\ntype NewUserMessage = Omit<UserMessage, 'id' | 'role'>\ntype NewAssistantMessage = Omit<AssistantMessage, 'id' | 'role' | 'source'> & {\n  readonly source: Omit<ModelMessageSource, 'kind'> & { readonly kind?: never }\n}\n\n/** Generate a UUID from the required Web Crypto source. */\nfunction newMessageId(): MessageId {\n  return MessageId(systemRandomId())\n}\n\n/**\n * Detach and deep-freeze a message whose identity already exists.\n *\n * Clones first, so freezing cannot reach back into a caller's live object graph.\n * @param message - a complete message, including its identity.\n * @returns an immutable snapshot preserving that identity.\n */\nexport function freezeMessage<T extends Message>(message: T): T {\n  return deepFreeze(structuredClone(message))\n}\n\n/**\n * Create one identified message and freeze it before publication.\n *\n * The `id?: never` phantom parameter is what stops a caller from supplying an\n * identity: identity is minted here so it cannot be duplicated across messages.\n * @param input - complete role, content, and source.\n * @returns an immutable message with a fresh identity.\n */\nexport function createMessage<T extends NewMessage>(\n  input: T & { readonly id?: never },\n): T & Pick<Message, 'id'> {\n  return freezeMessage({ ...input, id: newMessageId() })\n}\n\n/**\n * Create one identified user-role message.\n * @param input - complete content and source.\n * @returns an immutable user message with a fresh identity.\n */\nexport function createUserMessage<T extends NewUserMessage>(\n  input: T & { readonly id?: never; readonly role?: never },\n): T & Pick<UserMessage, 'id' | 'role'> {\n  return createMessage({ ...input, role: 'user' })\n}\n\n/**\n * Create one identified model-produced assistant message.\n * @param input - content plus the provider, model, and optional replay state.\n * @returns an immutable assistant message with fixed role/source tags.\n */\nexport function createAssistantMessage(\n  input: NewAssistantMessage & { readonly id?: never; readonly role?: never },\n): AssistantMessage {\n  return createMessage({\n    role: 'assistant',\n    content: input.content,\n    source: { kind: 'model', ...input.source },\n  })\n}\n\n/** Convenience shape for the common \"user typed some text\" case. */\nexport function createTextMessage(text: string): UserMessage {\n  return createUserMessage({ content: [{ type: 'text', text }], source: { kind: 'user' } })\n}\n\n/** Input whose acceptance creates one tool-result message. */\nexport interface ToolResultMessageInput {\n  readonly callId: ToolCallId\n  readonly content: readonly ContentBlock[]\n  readonly isError: boolean\n}\n\n/**\n * Create and freeze one identified tool-result message.\n * @param input - call identity, result blocks, and outcome.\n * @returns an immutable user-role tool-result message.\n */\nexport function createToolResultMessage(input: ToolResultMessageInput): ToolResultMessage {\n  return createUserMessage({\n    source: { kind: 'tool', callId: input.callId },\n    content: [{\n      type: 'tool-result',\n      toolCallId: input.callId,\n      content: [...input.content],\n      isError: input.isError,\n    }] as const,\n  })\n}\n"],"mappings":"gKA4HA,SAAS,GAA0B,CACjC,OAAO,EAAU,EAAe,CAAC,CACnC,CASA,SAAgB,EAAiC,EAAe,CAC9D,OAAO,EAAW,gBAAgB,CAAO,CAAC,CAC5C,CAUA,SAAgB,EACd,EACyB,CACzB,OAAO,EAAc,CAAE,GAAG,EAAO,GAAI,EAAa,CAAE,CAAC,CACvD,CAOA,SAAgB,EACd,EACsC,CACtC,OAAO,EAAc,CAAE,GAAG,EAAO,KAAM,MAAO,CAAC,CACjD,CAOA,SAAgB,EACd,EACkB,CAClB,OAAO,EAAc,CACnB,KAAM,YACN,QAAS,EAAM,QACf,OAAQ,CAAE,KAAM,QAAS,GAAG,EAAM,MAAO,CAC3C,CAAC,CACH,CAGA,SAAgB,EAAkB,EAA2B,CAC3D,OAAO,EAAkB,CAAE,QAAS,CAAC,CAAE,KAAM,OAAQ,MAAK,CAAC,EAAG,OAAQ,CAAE,KAAM,MAAO,CAAE,CAAC,CAC1F,CAcA,SAAgB,EAAwB,EAAkD,CACxF,OAAO,EAAkB,CACvB,OAAQ,CAAE,KAAM,OAAQ,OAAQ,EAAM,MAAO,EAC7C,QAAS,CAAC,CACR,KAAM,cACN,WAAY,EAAM,OAClB,QAAS,CAAC,GAAG,EAAM,OAAO,EAC1B,QAAS,EAAM,OACjB,CAAC,CACH,CAAC,CACH"}

package/dist/message/projection.d.ts

@@ -0,0 +1,34 @@
+import { ContentBlock, ImageBlock } from "./content.js";
+import { Message } from "./message.js";
+//#region src/message/projection.d.ts
+/**
+ * Whether any block in this content is (or contains) an image.
+ *
+ * Recurses into tool results, because a tool that returns a screenshot puts the
+ * image one level down where a shallow scan would miss it.
+ * @param content - the blocks to inspect.
+ * @returns true when at least one image block is present at any depth.
+ */
+declare function contentHasImage(content: readonly ContentBlock[]): boolean;
+/**
+ * The deterministic text that stands in for one omitted image.
+ *
+ * Deterministic on purpose: a stable string keeps the request prefix
+ * byte-identical across turns, which is what lets provider prompt caching keep
+ * working on the unchanged part of a long history.
+ * @param block - the image being replaced.
+ * @returns model-visible replacement text.
+ */
+declare function textOnlyImageText(block: ImageBlock): string;
+/**
+ * Project every image in a message list into text.
+ *
+ * Returns the SAME array identity when nothing changed, so callers can use a
+ * reference check to skip re-freezing and re-cloning an untouched history.
+ * @param messages - the conversation as assembled.
+ * @returns an equivalent list whose images have become text.
+ */
+declare function projectImagesForTextModel(messages: readonly Message[]): readonly Message[];
+//#endregion
+export { contentHasImage, projectImagesForTextModel, textOnlyImageText };
+//# sourceMappingURL=projection.d.ts.map

package/dist/message/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","names":[],"sources":["../../src/message/projection.ts"],"mappings":";;;;;;;;;;;iBAyBgB,gBAAgB,kBAAkB;;;;;;;;;;iBAelC,kBAAkB,OAAO;;;;;;;;;iBA6BzB,0BACd,mBAAmB,qBACT"}

package/dist/message/projection.js

@@ -0,0 +1,2 @@
+import{freezeMessage as e}from"./message.js";function t(e){return e.some(e=>e.type===`image`||(e.type===`tool-result`||e.type===`native-tool-call`)&&t(e.content))}function n(e){return`[image omitted: the selected model does not accept image input (${e.source.kind===`url`?e.source.url:e.source.kind===`file`?e.source.fileId:e.source.mediaType})]`}function r(e){return e.map(e=>e.type===`image`?{type:`text`,text:n(e)}:(e.type===`tool-result`||e.type===`native-tool-call`)&&t(e.content)?{...e,content:r(e.content)}:e)}function i(n){let i=!1,a=n.map(n=>t(n.content)?(i=!0,e({...n,content:r(n.content)})):n);return i?a:n}export{t as contentHasImage,i as projectImagesForTextModel,n as textOnlyImageText};
+//# sourceMappingURL=projection.js.map

package/dist/message/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","names":[],"sources":["../../src/message/projection.ts"],"sourcesContent":["/**\n * Content inspection and the text-only-model projection.\n *\n * Why the projection exists: conversation history outlives any single model\n * choice. A user attaches an image, the conversation continues, and later the\n * caller switches to a cheaper text-only model  Eor a summarizer runs on the same\n * history. Sending the image would be rejected by the provider, and silently\n * deleting it would leave the model reading a conversation that references\n * something invisible. Replacing it with a deterministic textual stand-in keeps\n * the history coherent and the request valid.\n *\n * @module ai-agent-sdk/core/message/projection\n */\n\nimport type { ContentBlock, ImageBlock } from './content.ts'\nimport { freezeMessage, type Message } from './message.ts'\n\n/**\n * Whether any block in this content is (or contains) an image.\n *\n * Recurses into tool results, because a tool that returns a screenshot puts the\n * image one level down where a shallow scan would miss it.\n * @param content - the blocks to inspect.\n * @returns true when at least one image block is present at any depth.\n */\nexport function contentHasImage(content: readonly ContentBlock[]): boolean {\n  return content.some(block => block.type === 'image'\n    || ((block.type === 'tool-result' || block.type === 'native-tool-call')\n      && contentHasImage(block.content)))\n}\n\n/**\n * The deterministic text that stands in for one omitted image.\n *\n * Deterministic on purpose: a stable string keeps the request prefix\n * byte-identical across turns, which is what lets provider prompt caching keep\n * working on the unchanged part of a long history.\n * @param block - the image being replaced.\n * @returns model-visible replacement text.\n */\nexport function textOnlyImageText(block: ImageBlock): string {\n  const detail = block.source.kind === 'url'\n    ? block.source.url\n    : block.source.kind === 'file' ? block.source.fileId : block.source.mediaType\n  return `[image omitted: the selected model does not accept image input (${detail})]`\n}\n\n/** Replace image blocks with their textual stand-in, recursing into tool results. */\nfunction projectContent(content: readonly ContentBlock[]): ContentBlock[] {\n  return content.map((block) => {\n    if (block.type === 'image') {\n      return { type: 'text', text: textOnlyImageText(block) } satisfies ContentBlock\n    }\n    if ((block.type === 'tool-result' || block.type === 'native-tool-call')\n      && contentHasImage(block.content)) {\n      return { ...block, content: projectContent(block.content) } satisfies ContentBlock\n    }\n    return block\n  })\n}\n\n/**\n * Project every image in a message list into text.\n *\n * Returns the SAME array identity when nothing changed, so callers can use a\n * reference check to skip re-freezing and re-cloning an untouched history.\n * @param messages - the conversation as assembled.\n * @returns an equivalent list whose images have become text.\n */\nexport function projectImagesForTextModel(\n  messages: readonly Message[],\n): readonly Message[] {\n  let changed = false\n  const projected = messages.map((message) => {\n    if (!contentHasImage(message.content)) return message\n    changed = true\n    return freezeMessage({ ...message, content: projectContent(message.content) })\n  })\n  return changed ? projected : messages\n}\n"],"mappings":"6CAyBA,SAAgB,EAAgB,EAA2C,CACzE,OAAO,EAAQ,KAAK,GAAS,EAAM,OAAS,UACrC,EAAM,OAAS,eAAiB,EAAM,OAAS,qBAC/C,EAAgB,EAAM,OAAO,CAAE,CACxC,CAWA,SAAgB,EAAkB,EAA2B,CAI3D,MAAO,mEAHQ,EAAM,OAAO,OAAS,MACjC,EAAM,OAAO,IACb,EAAM,OAAO,OAAS,OAAS,EAAM,OAAO,OAAS,EAAM,OAAO,UACW,GACnF,CAGA,SAAS,EAAe,EAAkD,CACxE,OAAO,EAAQ,IAAK,GACd,EAAM,OAAS,QACV,CAAE,KAAM,OAAQ,KAAM,EAAkB,CAAK,CAAE,GAEnD,EAAM,OAAS,eAAiB,EAAM,OAAS,qBAC/C,EAAgB,EAAM,OAAO,EACzB,CAAE,GAAG,EAAO,QAAS,EAAe,EAAM,OAAO,CAAE,EAErD,CACR,CACH,CAUA,SAAgB,EACd,EACoB,CACpB,IAAI,EAAU,GACR,EAAY,EAAS,IAAK,GACzB,EAAgB,EAAQ,OAAO,GACpC,EAAU,GACH,EAAc,CAAE,GAAG,EAAS,QAAS,EAAe,EAAQ,OAAO,CAAE,CAAC,GAF/B,CAG/C,EACD,OAAO,EAAU,EAAY,CAC/B"}

package/dist/observability/bus.d.ts

@@ -0,0 +1,7 @@
+import { Observability, ObservabilityOptions } from "./types.js";
+//#region src/observability/bus.d.ts
+/** Create one Universal observation bus. Construction validates every durability claim. */
+declare function createObservability(options?: ObservabilityOptions): Observability;
+//#endregion
+export { createObservability };
+//# sourceMappingURL=bus.d.ts.map

package/dist/observability/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","names":[],"sources":["../../src/observability/bus.ts"],"mappings":";;;iBA8nBgB,oBAAoB,UAAS,uBAA4B"}

package/dist/observability/bus.js

@@ -0,0 +1,2 @@
+import{deepFreeze as e}from"../primitives/freeze.js";import"../primitives/version.js";import{createObservationRunScope as t,createOperationId as n}from"../observation/context.js";import{safeErrorRecord as r}from"../observation/event.js";import{createCoreSpan as i,snapshotObservationSpan as a}from"../observation/port.js";import{sanitizeObservationEvent as o,serializedEventBytes as s}from"../observation/privacy.js";import{createBusLogger as c}from"./logger.js";const l={none:0,"local-durable":1,"remote-acknowledged":2},u=new Set([`ABORT_ERR`,`ECONNREFUSED`,`ECONNRESET`,`EHOSTUNREACH`,`ENETUNREACH`,`ETIMEDOUT`,`OBSERVABILITY_EXPORT_FAILED`,`OBSERVABILITY_FLUSH_TIMEOUT`,`OBSERVABILITY_PROCESSOR_FAILED`,`OTEL_PROVIDER_UNCONFIGURED`]),d=/^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,63})$/,f=new Set([`none`,`metadata`,`redacted`,`full`]),p=new Set([`trace`,`debug`,`info`,`warn`,`error`,`fatal`]);function m(e,t){if(!Number.isSafeInteger(e)||e<1)throw RangeError(`${t} must be a positive safe integer`);return e}function h(t,n){let i=r(t);return e({type:[`AbortError`,`Error`,`RangeError`,`TypeError`].includes(i.type)?i.type:`Error`,message:n,...i.code!==void 0&&u.has(i.code)?{code:i.code}:{},...i.retryable===void 0?{}:{retryable:i.retryable},...i.status===void 0?{}:{status:i.status}})}function g(e,t,n=`none`,r){return Object.freeze({eventId:e,status:t,durable:t===`accepted`&&n!==`none`,boundary:n,...r===void 0?{}:{reason:r}})}function _(e){try{let t=Reflect.get(e,`eventId`);return typeof t==`string`&&t.length>0?t:n()}catch{return n()}}function v(e){let t=`none`;for(let n of e)n.requirement===`required`&&l[n.boundary]>l[t]&&(t=n.boundary);return t}function y(e,t){let n=new Set;for(let r of t){let t=r.exporter?.id;if(typeof t!=`string`||!d.test(t))throw TypeError(`observation exporter id must be a safe 1-64 character identifier`);if(n.has(t))throw TypeError(`duplicate observation exporter id: ${t}`);if(n.add(t),r.requirement!==`required`&&r.requirement!==`best-effort`)throw TypeError(`observation exporter ${t} has an invalid requirement`);if(!(r.boundary in l))throw TypeError(`observation exporter ${t} has an invalid boundary`);let i=r.exporter.supportedBoundaries??[`none`];if(typeof r.exporter.export!=`function`)throw TypeError(`observation exporter ${t} has no export function`);if(!i.includes(r.boundary))throw TypeError(`observation exporter ${t} does not support ${r.boundary}`);if(e===`operational`&&r.requirement===`required`)throw TypeError(`operational observation exporters must be best-effort`)}if(e!==`operational`&&!t.some(e=>e.requirement===`required`&&e.boundary!==`none`))throw TypeError(`${e} observability requires a durable required exporter`);return Object.freeze(t.map(e=>Object.freeze({...e})))}function b(e,t){let n=new AbortController,r=setTimeout(()=>n.abort(new DOMException(`observation deadline exceeded`,`TimeoutError`)),e),i=()=>n.abort(t?.reason??new DOMException(`observation aborted`,`AbortError`));return t?.aborted===!0?i():t?.addEventListener(`abort`,i,{once:!0}),{signal:n.signal,clear(){clearTimeout(r),t?.removeEventListener(`abort`,i)}}}function x(e,t){return t.aborted?Promise.reject(t.reason??Error(`observation aborted`)):new Promise((n,r)=>{let i=()=>{a(),r(t.reason??Error(`observation aborted`))},a=()=>t.removeEventListener(`abort`,i);t.addEventListener(`abort`,i,{once:!0}),e.then(e=>{a(),n(e)},e=>{a(),r(e)})})}function S(e){try{let t=e.reason;return typeof t==`object`&&!!t&&Reflect.get(t,`name`)===`TimeoutError`}catch{return!1}}function C(e){return Object.freeze({complete:e.complete,exportedEvents:e.exportedEvents,pendingEvents:e.pendingEvents,rejectedCritical:e.rejectedCritical,timedOut:e.timedOut})}function w(e,t){return e.eventId===t.eventId&&e.sequence===t.sequence&&e.name===t.name&&e.phase===t.phase&&e.occurredAt===t.occurredAt&&e.monotonicMs===t.monotonicMs&&e.priority===t.priority&&JSON.stringify(e.resource)===JSON.stringify(t.resource)&&JSON.stringify(e.correlation)===JSON.stringify(t.correlation)}var T=class{mode;resource;registrations;processors;options;queue=[];queueBytes=0;closing=!1;closed=!1;shutdownPromise;flushChain=Promise.resolve();protectedFailures=new Set;healthScope=t();healthRunId=n();healthCorrelation=i({name:`sdk.integration.request`,runId:this.healthRunId,startedAt:new Date().toISOString(),monotonicMs:this.healthScope.monotonicMs()}).correlation;counters={accepted:0,exported:0,droppedVerbose:0,droppedNormal:0,criticalRejected:0,processorFailures:0,exporterFailures:0,flushTimeouts:0,requiredFailure:!1};constructor(t){if(this.mode=t.mode??`operational`,![`operational`,`reliable`,`audit`].includes(this.mode))throw TypeError(`invalid observation mode`);this.resource=e({sdkName:`ai-agent-sdk`,sdkVersion:t.resource?.sdkVersion??`0.1.0`,...t.resource?.serviceName===void 0?{}:{serviceName:t.resource.serviceName},...t.resource?.serviceVersion===void 0?{}:{serviceVersion:t.resource.serviceVersion},runtime:t.resource?.runtime??`unknown`}),this.registrations=y(this.mode,t.exporters??[]);let n=new Set;for(let e of t.processors??[]){if(typeof e.id!=`string`||!d.test(e.id))throw TypeError(`processor id must be a safe 1-64 character identifier`);if(n.has(e.id))throw TypeError(`duplicate observation processor id: ${e.id}`);if(typeof e.transform!=`function`)throw TypeError(`observation processor ${e.id} is invalid`);n.add(e.id)}if(this.processors=Object.freeze([...t.processors??[]]),!f.has(t.content??`none`))throw TypeError(`invalid observation content policy`);if(!p.has(t.minimumLogLevel??`info`))throw TypeError(`invalid minimum log level`);let r=new Set;for(let e of t.redactors??[]){if(typeof e.id!=`string`||!d.test(e.id)||typeof e.redact!=`function`)throw TypeError(`invalid observation content redactor`);if(r.has(e.id))throw TypeError(`duplicate observation redactor id: ${e.id}`);r.add(e.id)}this.options={content:t.content??`none`,includeErrorStacks:t.includeErrorStacks??!1,minimumLogLevel:t.minimumLogLevel??`info`,maxQueueEvents:m(t.maxQueueEvents??1e4,`maxQueueEvents`),maxQueueBytes:m(t.maxQueueBytes??16777216,`maxQueueBytes`),maxBatchEvents:m(t.maxBatchEvents??256,`maxBatchEvents`),maxBatchBytes:m(t.maxBatchBytes??524288,`maxBatchBytes`),flushTimeoutMs:m(t.flushTimeoutMs??1e4,`flushTimeoutMs`),shutdownTimeoutMs:m(t.shutdownTimeoutMs??3e4,`shutdownTimeoutMs`),redactors:Object.freeze([...t.redactors??[]]),...t.onHealthChange===void 0?{}:{onHealthChange:t.onHealthChange},...t.openSpan===void 0?{}:{openSpan:t.openSpan}}}openSpan(e){let t=this.options.openSpan;if(t===void 0)return i(e);try{let n=a(t(e));if(n!==void 0)return n;this.counters.processorFailures++,this.recordFailure(`span:invalid`,TypeError(`invalid span`),`observation span backend returned an invalid span`,!1)}catch(e){this.counters.processorFailures++,this.recordFailure(`span:throw`,e,`observation span backend failed`,!1)}return i(e)}capture(e){let t=_(e);if(this.closing||this.closed)return g(t,`rejected`,`none`,`closed`);let n;try{n=this.prepareEvent(e,!1)}catch(e){return this.counters.processorFailures++,this.counters.lastFailure=h(e,`observation processor failed`),this.notifyHealth(),this.recordFailure(`processor:capture`,e,`observation processor failed`,!0),g(t,`rejected`,`none`,`processor-failed`)}let r=this.enqueue(n,!1);return r.status===`accepted`?this.stageExporters(n,r):r}async checkpoint(e,t){let n=this.capture(e);if(n.status!==`accepted`||this.mode===`operational`)return n;let r=this.queue.find(e=>e.event.eventId===n.eventId)?.event;if(r===void 0)return g(n.eventId,`rejected`,`none`,`exporter-unavailable`);let i=new Set(this.queue.filter(e=>e.event.priority===`critical`&&e.event.correlation.runId===r.correlation.runId&&e.event.sequence<=r.sequence).map(e=>e.event.eventId));return(await this.scheduleFlush(i,this.options.flushTimeoutMs,t)).requiredComplete?g(n.eventId,`accepted`,v(this.registrations)):g(n.eventId,`rejected`,`none`,`exporter-unavailable`)}logger(e){return c({minimumLevel:this.options.minimumLogLevel,resource:this.resource,emit:e=>{this.capture(e)}},e)}health(){let t=this.closed?`closed`:this.counters.requiredFailure||this.counters.criticalRejected>0||this.counters.flushTimeouts>0?`failed`:this.counters.processorFailures>0||this.counters.exporterFailures>0||this.counters.droppedVerbose>0||this.counters.droppedNormal>0?`degraded`:`healthy`;return e({state:t,queuedEvents:this.queue.length,queuedBytes:this.queueBytes,accepted:this.counters.accepted,exported:this.counters.exported,droppedVerbose:this.counters.droppedVerbose,droppedNormal:this.counters.droppedNormal,criticalRejected:this.counters.criticalRejected,processorFailures:this.counters.processorFailures,exporterFailures:this.counters.exporterFailures,flushTimeouts:this.counters.flushTimeouts,...this.counters.lastExportAt===void 0?{}:{lastExportAt:this.counters.lastExportAt},...this.counters.lastFailure===void 0?{}:{lastFailure:this.counters.lastFailure}})}flush(e){if(this.closed||this.closing)throw TypeError(`observability is closed`);return this.scheduleFlush(new Set(this.queue.map(e=>e.event.eventId)),this.options.flushTimeoutMs,e).then(C)}shutdown(e){if(this.shutdownPromise!==void 0)return this.shutdownPromise;this.closing=!0;let t=new Set(this.queue.map(e=>e.event.eventId));return this.shutdownPromise=(async()=>{let n=b(this.options.shutdownTimeoutMs,e),r;try{r=C(await this.scheduleFlush(t,this.options.shutdownTimeoutMs,n.signal));for(let e of[...this.registrations].reverse()){let t=e.exporter.shutdown;if(t!==void 0)try{await x(Promise.resolve(t.call(e.exporter,n.signal)),n.signal)}catch(t){this.recordExporterFailure(e,t,!1),r=Object.freeze({...r,complete:!1})}}}finally{n.clear(),this.closed=!0,this.notifyHealth()}return r})(),this.shutdownPromise}prepareEvent(e,t){let n={content:this.options.content,redactors:this.options.redactors??[],includeErrorStacks:this.options.includeErrorStacks},r=o(e,n);if(t)return r;for(let e of this.processors){let t=e.transform(r);if(t===void 0)throw TypeError(`observation processor ${e.id} returned undefined`);let i=o(t,n);if(!w(r,i))throw TypeError(`observation processor ${e.id} changed the immutable event envelope`);r=i}return r}enqueue(e,t){let n=s(e);return n>this.options.maxBatchBytes||n>this.options.maxQueueBytes||!this.makeCapacity(n,t)?(!t&&e.priority===`critical`&&this.counters.criticalRejected++,t||(this.counters.lastFailure=h(RangeError(`capacity`),`observation queue capacity exhausted`),this.notifyHealth()),g(e.eventId,`rejected`,`none`,`capacity`)):(this.queue.push({event:e,bytes:n,protected:t,pending:new Set(this.registrations.map(e=>e.exporter.id))}),this.queueBytes+=n,this.counters.accepted++,this.notifyHealth(),g(e.eventId,`accepted`))}stageExporters(e,t){let n=this.queue.find(t=>t.event.eventId===e.eventId);if(n===void 0)return g(e.eventId,`rejected`,`none`,`exporter-unavailable`);let r=!1;for(let t of this.registrations){let i=t.exporter.stage;if(i!==void 0)try{let n=i.call(t.exporter,e);n!==void 0&&Promise.resolve(n).catch(()=>void 0)}catch(i){if(this.recordExporterFailure(t,i,!1),n.pending.delete(t.exporter.id),r=!0,t.requirement===`required`)return this.removeEntry(n,!1),e.priority===`critical`&&this.counters.criticalRejected++,this.notifyHealth(),g(e.eventId,`rejected`,`none`,`exporter-unavailable`)}}return r&&n.pending.size===0&&this.removeEntry(n,!1),t}makeCapacity(e,t){for(;this.queue.length+1>this.options.maxQueueEvents||this.queueBytes+e>this.options.maxQueueBytes;){let e=this.queue.findIndex(e=>e.event.priority===`verbose`);if(e===-1&&(e=this.queue.findIndex(e=>e.event.priority===`normal`)),e===-1)return!1;let[n]=this.queue.splice(e,1);if(n===void 0)return!1;this.queueBytes-=n.bytes,t||(n.event.priority===`verbose`?this.counters.droppedVerbose++:this.counters.droppedNormal++)}return!0}scheduleFlush(e,t,n){let r,i,a=new Promise((e,t)=>{r=e,i=t}),o=async()=>{try{r(await this.flushInternal(e,t,n))}catch(e){i(e)}};return this.flushChain=this.flushChain.then(o,o),a}async flushInternal(t,r,i){let a=this.counters.exported,o=b(r,i),s=!1,c=!1;try{if(this.registrations.length===0)for(let e of[...this.queue])t.has(e.event.eventId)&&this.removeEntry(e,!1);for(let r of this.registrations)for(;;){let i=this.queue.filter(e=>t.has(e.event.eventId)&&e.pending.has(r.exporter.id));if(i.length===0)break;let a=[],l=0;for(let e of i){if(a.length>=this.options.maxBatchEvents||l+e.bytes>this.options.maxBatchBytes)break;a.push(e),l+=e.bytes}if(a.length===0)break;let u=e({schemaVersion:1,batchId:n(),createdAt:new Date().toISOString(),events:a.map(e=>e.event)}),d;try{if(d=await x(Promise.resolve(r.exporter.export(u,o.signal)),o.signal),d.batchId!==u.batchId||d.accepted!==!0)throw TypeError(`observation exporter ${r.exporter.id} returned an invalid acknowledgment`)}catch(e){if(s=!0,c||=S(o.signal),this.recordExporterFailure(r,e,!0),r.requirement===`best-effort`)for(let e of a)e.pending.delete(r.exporter.id),e.pending.size===0&&this.removeEntry(e,!1);break}this.counters.lastExportAt=new Date().toISOString();for(let e of a)e.pending.delete(r.exporter.id),e.pending.size===0&&this.removeEntry(e,!0);this.notifyHealth()}}finally{S(o.signal)&&(c=!0,this.counters.flushTimeouts++,this.counters.lastFailure=h(o.signal.reason,`observation flush timed out`),this.notifyHealth()),o.clear()}let l=this.queue.filter(e=>t.has(e.event.eventId)),u=this.registrations.filter(e=>e.requirement===`required`).map(e=>e.exporter.id),d=l.every(e=>u.every(t=>!e.pending.has(t)));return Object.freeze({complete:!s&&!c&&l.length===0,requiredComplete:d,exportedEvents:this.counters.exported-a,pendingEvents:l.length,rejectedCritical:this.counters.criticalRejected,timedOut:c})}removeEntry(e,t){let n=this.queue.indexOf(e);n!==-1&&(this.queue.splice(n,1),this.queueBytes-=e.bytes,t&&this.counters.exported++)}recordExporterFailure(e,t,n){this.counters.exporterFailures++,e.requirement===`required`&&(this.counters.requiredFailure=!0),this.counters.lastFailure=h(t,`observation exporter failed`),this.notifyHealth(),n&&this.recordFailure(`exporter:${e.exporter.id}`,t,`observation exporter failed`,!0)}recordFailure(e,t,r,i){if(this.counters.lastFailure=h(t,r),this.notifyHealth(),!(!i||this.protectedFailures.has(e)||this.closing||this.closed)){this.protectedFailures.add(e);try{let t=this.prepareEvent({schemaVersion:1,eventId:n(),sequence:this.healthScope.nextSequence(),name:`sdk.observer.failure`,phase:`point`,occurredAt:new Date().toISOString(),monotonicMs:this.healthScope.monotonicMs(),priority:`critical`,resource:this.resource,correlation:this.healthCorrelation,data:{observerId:e,failureKind:`contained`,count:1,error:{...this.counters.lastFailure}}},!0);this.enqueue(t,!0)}catch{}}}notifyHealth(){let e=this.options.onHealthChange;if(e!==void 0)try{e(this.health())}catch{}}};function E(e={}){return new T(e)}export{E as createObservability};
+//# sourceMappingURL=bus.js.map

package/dist/observability/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","names":[],"sources":["../../src/observability/bus.ts"],"sourcesContent":["import {\n  SDK_VERSION,\n  deepFreeze,\n} from '../primitives/index.ts'\nimport {\n  createCoreSpan,\n  createObservationRunScope,\n  createOperationId,\n  safeErrorRecord,\n  snapshotObservationSpan,\n  type CaptureReceipt,\n  type ObservationBoundary,\n  type ObservationEvent,\n  type ObservationResource,\n  type ObservationSpan,\n  type OpenObservationSpanInput,\n  type SafeErrorRecord,\n} from '../observation/index.ts'\nimport { createBusLogger } from './logger.ts'\nimport { sanitizeObservationEvent, serializedEventBytes } from './privacy.ts'\nimport type {\n  ExportAck,\n  FlushResult,\n  LoggerContext,\n  LogLevel,\n  ObservationBatch,\n  ObservationExporterRegistration,\n  ObservationHealthSnapshot,\n  ObservationProcessor,\n  Observability,\n  ObservabilityOptions,\n  SdkLogger,\n} from './types.ts'\n\nconst DEFAULT_MAX_QUEUE_EVENTS = 10_000\nconst DEFAULT_MAX_QUEUE_BYTES = 16 * 1024 * 1024\nconst DEFAULT_MAX_BATCH_EVENTS = 256\nconst DEFAULT_MAX_BATCH_BYTES = 512 * 1024\nconst DEFAULT_FLUSH_TIMEOUT_MS = 10_000\nconst DEFAULT_SHUTDOWN_TIMEOUT_MS = 30_000\n\ninterface QueueEntry {\n  readonly event: ObservationEvent\n  readonly bytes: number\n  readonly pending: Set<string>\n  readonly protected: boolean\n}\n\ninterface MutableHealth {\n  accepted: number\n  exported: number\n  droppedVerbose: number\n  droppedNormal: number\n  criticalRejected: number\n  processorFailures: number\n  exporterFailures: number\n  flushTimeouts: number\n  lastExportAt?: string\n  lastFailure?: SafeErrorRecord\n  requiredFailure: boolean\n}\n\ninterface FlushOutcome extends FlushResult {\n  readonly requiredComplete: boolean\n}\n\nconst BOUNDARY_RANK: Readonly<Record<ObservationBoundary, number>> = {\n  none: 0, 'local-durable': 1, 'remote-acknowledged': 2,\n}\nconst SAFE_FAILURE_CODES = new Set([\n  'ABORT_ERR', 'ECONNREFUSED', 'ECONNRESET', 'EHOSTUNREACH', 'ENETUNREACH',\n  'ETIMEDOUT', 'OBSERVABILITY_EXPORT_FAILED', 'OBSERVABILITY_FLUSH_TIMEOUT',\n  'OBSERVABILITY_PROCESSOR_FAILED', 'OTEL_PROVIDER_UNCONFIGURED',\n])\nconst COMPONENT_ID_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,63})$/\nconst CONTENT_POLICIES = new Set(['none', 'metadata', 'redacted', 'full'])\nconst LOG_LEVELS = new Set(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])\n\nfunction positiveSafeInteger(value: number, field: string): number {\n  if (!Number.isSafeInteger(value) || value < 1) throw new RangeError(`${field} must be a positive safe integer`)\n  return value\n}\n\nfunction safeFailure(error: unknown, message: string): SafeErrorRecord {\n  const source = safeErrorRecord(error)\n  return deepFreeze({\n    type: ['AbortError', 'Error', 'RangeError', 'TypeError'].includes(source.type) ? source.type : 'Error',\n    message,\n    ...source.code !== undefined && SAFE_FAILURE_CODES.has(source.code) ? { code: source.code } : {},\n    ...source.retryable === undefined ? {} : { retryable: source.retryable },\n    ...source.status === undefined ? {} : { status: source.status },\n  })\n}\n\nfunction receipt(\n  eventId: string,\n  status: CaptureReceipt['status'],\n  boundary: ObservationBoundary = 'none',\n  reason?: CaptureReceipt['reason'],\n): CaptureReceipt {\n  return Object.freeze({\n    eventId, status, durable: status === 'accepted' && boundary !== 'none', boundary,\n    ...reason === undefined ? {} : { reason },\n  })\n}\n\nfunction eventIdOf(event: unknown): string {\n  try {\n    const value = Reflect.get(event as object, 'eventId')\n    return typeof value === 'string' && value.length > 0 ? value : createOperationId()\n  } catch { return createOperationId() }\n}\n\nfunction requiredBoundary(registrations: readonly ObservationExporterRegistration[]): ObservationBoundary {\n  let result: ObservationBoundary = 'none'\n  for (const registration of registrations) {\n    if (registration.requirement === 'required'\n      && BOUNDARY_RANK[registration.boundary] > BOUNDARY_RANK[result]) result = registration.boundary\n  }\n  return result\n}\n\nfunction validateRegistrations(\n  mode: Observability['mode'],\n  registrations: readonly ObservationExporterRegistration[],\n): readonly ObservationExporterRegistration[] {\n  const ids = new Set<string>()\n  for (const registration of registrations) {\n    const id = registration.exporter?.id\n    if (typeof id !== 'string' || !COMPONENT_ID_PATTERN.test(id)) {\n      throw new TypeError('observation exporter id must be a safe 1-64 character identifier')\n    }\n    if (ids.has(id)) throw new TypeError(`duplicate observation exporter id: ${id}`)\n    ids.add(id)\n    if (registration.requirement !== 'required' && registration.requirement !== 'best-effort') {\n      throw new TypeError(`observation exporter ${id} has an invalid requirement`)\n    }\n    if (!(registration.boundary in BOUNDARY_RANK)) throw new TypeError(`observation exporter ${id} has an invalid boundary`)\n    const supported = registration.exporter.supportedBoundaries ?? ['none']\n    if (typeof registration.exporter.export !== 'function') {\n      throw new TypeError(`observation exporter ${id} has no export function`)\n    }\n    if (!supported.includes(registration.boundary)) {\n      throw new TypeError(`observation exporter ${id} does not support ${registration.boundary}`)\n    }\n    if (mode === 'operational' && registration.requirement === 'required') {\n      throw new TypeError('operational observation exporters must be best-effort')\n    }\n  }\n  if (mode !== 'operational' && !registrations.some(registration => (\n    registration.requirement === 'required' && registration.boundary !== 'none'\n  ))) throw new TypeError(`${mode} observability requires a durable required exporter`)\n  return Object.freeze(registrations.map(registration => Object.freeze({ ...registration })))\n}\n\nfunction deadlineSignal(timeoutMs: number, external?: AbortSignal): { signal: AbortSignal; clear(): void } {\n  const controller = new AbortController()\n  const timeout = setTimeout(() => controller.abort(new DOMException('observation deadline exceeded', 'TimeoutError')), timeoutMs)\n  const abort = () => controller.abort(external?.reason ?? new DOMException('observation aborted', 'AbortError'))\n  if (external?.aborted === true) abort()\n  else external?.addEventListener('abort', abort, { once: true })\n  return {\n    signal: controller.signal,\n    clear() { clearTimeout(timeout); external?.removeEventListener('abort', abort) },\n  }\n}\n\nfunction raceAbort<T>(pending: Promise<T>, signal: AbortSignal): Promise<T> {\n  if (signal.aborted) return Promise.reject(signal.reason ?? new Error('observation aborted'))\n  return new Promise<T>((resolve, reject) => {\n    const abort = () => { cleanup(); reject(signal.reason ?? new Error('observation aborted')) }\n    const cleanup = () => signal.removeEventListener('abort', abort)\n    signal.addEventListener('abort', abort, { once: true })\n    void pending.then(\n      value => { cleanup(); resolve(value) },\n      error => { cleanup(); reject(error) },\n    )\n  })\n}\n\nfunction isTimeoutAbort(signal: AbortSignal): boolean {\n  try {\n    const reason = signal.reason\n    return typeof reason === 'object' && reason !== null\n      && Reflect.get(reason, 'name') === 'TimeoutError'\n  } catch { return false }\n}\n\nfunction publicFlushResult(outcome: FlushOutcome): FlushResult {\n  return Object.freeze({\n    complete: outcome.complete,\n    exportedEvents: outcome.exportedEvents,\n    pendingEvents: outcome.pendingEvents,\n    rejectedCritical: outcome.rejectedCritical,\n    timedOut: outcome.timedOut,\n  })\n}\n\nfunction sameEnvelope(left: ObservationEvent, right: ObservationEvent): boolean {\n  return left.eventId === right.eventId && left.sequence === right.sequence\n    && left.name === right.name && left.phase === right.phase\n    && left.occurredAt === right.occurredAt && left.monotonicMs === right.monotonicMs\n    && left.priority === right.priority\n    && JSON.stringify(left.resource) === JSON.stringify(right.resource)\n    && JSON.stringify(left.correlation) === JSON.stringify(right.correlation)\n}\n\nclass ObservationBus implements Observability {\n  readonly mode: Observability['mode']\n  readonly resource: ObservationResource\n  private readonly registrations: readonly ObservationExporterRegistration[]\n  private readonly processors: readonly ObservationProcessor[]\n  private readonly options: Required<Pick<ObservabilityOptions,\n    'content' | 'includeErrorStacks' | 'minimumLogLevel' | 'maxQueueEvents' | 'maxQueueBytes'\n    | 'maxBatchEvents' | 'maxBatchBytes' | 'flushTimeoutMs' | 'shutdownTimeoutMs'>>\n    & Pick<ObservabilityOptions, 'redactors' | 'onHealthChange' | 'openSpan'>\n  private readonly queue: QueueEntry[] = []\n  private queueBytes = 0\n  private closing = false\n  private closed = false\n  private shutdownPromise: Promise<FlushResult> | undefined\n  private flushChain: Promise<void> = Promise.resolve()\n  private readonly protectedFailures = new Set<string>()\n  private readonly healthScope = createObservationRunScope()\n  private readonly healthRunId = createOperationId()\n  private readonly healthCorrelation = createCoreSpan({\n    name: 'sdk.integration.request', runId: this.healthRunId,\n    startedAt: new Date().toISOString(), monotonicMs: this.healthScope.monotonicMs(),\n  }).correlation\n  private readonly counters: MutableHealth = {\n    accepted: 0, exported: 0, droppedVerbose: 0, droppedNormal: 0,\n    criticalRejected: 0, processorFailures: 0, exporterFailures: 0,\n    flushTimeouts: 0, requiredFailure: false,\n  }\n\n  constructor(input: ObservabilityOptions) {\n    this.mode = input.mode ?? 'operational'\n    if (!['operational', 'reliable', 'audit'].includes(this.mode)) throw new TypeError('invalid observation mode')\n    this.resource = deepFreeze({\n      sdkName: 'ai-agent-sdk',\n      sdkVersion: input.resource?.sdkVersion ?? SDK_VERSION,\n      ...input.resource?.serviceName === undefined ? {} : { serviceName: input.resource.serviceName },\n      ...input.resource?.serviceVersion === undefined ? {} : { serviceVersion: input.resource.serviceVersion },\n      runtime: input.resource?.runtime ?? 'unknown',\n    })\n    this.registrations = validateRegistrations(this.mode, input.exporters ?? [])\n    const processorIds = new Set<string>()\n    for (const processor of input.processors ?? []) {\n      if (typeof processor.id !== 'string' || !COMPONENT_ID_PATTERN.test(processor.id)) {\n        throw new TypeError('processor id must be a safe 1-64 character identifier')\n      }\n      if (processorIds.has(processor.id)) throw new TypeError(`duplicate observation processor id: ${processor.id}`)\n      if (typeof processor.transform !== 'function') throw new TypeError(`observation processor ${processor.id} is invalid`)\n      processorIds.add(processor.id)\n    }\n    this.processors = Object.freeze([...(input.processors ?? [])])\n    if (!CONTENT_POLICIES.has(input.content ?? 'none')) throw new TypeError('invalid observation content policy')\n    if (!LOG_LEVELS.has(input.minimumLogLevel ?? 'info')) throw new TypeError('invalid minimum log level')\n    const redactorIds = new Set<string>()\n    for (const redactor of input.redactors ?? []) {\n      if (typeof redactor.id !== 'string' || !COMPONENT_ID_PATTERN.test(redactor.id)\n        || typeof redactor.redact !== 'function') throw new TypeError('invalid observation content redactor')\n      if (redactorIds.has(redactor.id)) throw new TypeError(`duplicate observation redactor id: ${redactor.id}`)\n      redactorIds.add(redactor.id)\n    }\n    this.options = {\n      content: input.content ?? 'none',\n      includeErrorStacks: input.includeErrorStacks ?? false,\n      minimumLogLevel: input.minimumLogLevel ?? 'info',\n      maxQueueEvents: positiveSafeInteger(input.maxQueueEvents ?? DEFAULT_MAX_QUEUE_EVENTS, 'maxQueueEvents'),\n      maxQueueBytes: positiveSafeInteger(input.maxQueueBytes ?? DEFAULT_MAX_QUEUE_BYTES, 'maxQueueBytes'),\n      maxBatchEvents: positiveSafeInteger(input.maxBatchEvents ?? DEFAULT_MAX_BATCH_EVENTS, 'maxBatchEvents'),\n      maxBatchBytes: positiveSafeInteger(input.maxBatchBytes ?? DEFAULT_MAX_BATCH_BYTES, 'maxBatchBytes'),\n      flushTimeoutMs: positiveSafeInteger(input.flushTimeoutMs ?? DEFAULT_FLUSH_TIMEOUT_MS, 'flushTimeoutMs'),\n      shutdownTimeoutMs: positiveSafeInteger(input.shutdownTimeoutMs ?? DEFAULT_SHUTDOWN_TIMEOUT_MS, 'shutdownTimeoutMs'),\n      redactors: Object.freeze([...(input.redactors ?? [])]),\n      ...input.onHealthChange === undefined ? {} : { onHealthChange: input.onHealthChange },\n      ...input.openSpan === undefined ? {} : { openSpan: input.openSpan },\n    }\n  }\n\n  openSpan(input: OpenObservationSpanInput): ObservationSpan {\n    const backend = this.options.openSpan\n    if (backend === undefined) return createCoreSpan(input)\n    try {\n      const span = snapshotObservationSpan(backend(input))\n      if (span !== undefined) return span\n      this.counters.processorFailures++\n      this.recordFailure('span:invalid', new TypeError('invalid span'), 'observation span backend returned an invalid span', false)\n    } catch (error) {\n      this.counters.processorFailures++\n      this.recordFailure('span:throw', error, 'observation span backend failed', false)\n    }\n    return createCoreSpan(input)\n  }\n\n  capture(event: ObservationEvent): CaptureReceipt {\n    const eventId = eventIdOf(event)\n    if (this.closing || this.closed) return receipt(eventId, 'rejected', 'none', 'closed')\n    let processed: ObservationEvent\n    try {\n      processed = this.prepareEvent(event, false)\n    } catch (error) {\n      this.counters.processorFailures++\n      this.counters.lastFailure = safeFailure(error, 'observation processor failed')\n      this.notifyHealth()\n      this.recordFailure('processor:capture', error, 'observation processor failed', true)\n      return receipt(eventId, 'rejected', 'none', 'processor-failed')\n    }\n    const captured = this.enqueue(processed, false)\n    if (captured.status !== 'accepted') return captured\n    return this.stageExporters(processed, captured)\n  }\n\n  async checkpoint(event: ObservationEvent, signal?: AbortSignal): Promise<CaptureReceipt> {\n    const captured = this.capture(event)\n    if (captured.status !== 'accepted') return captured\n    if (this.mode === 'operational') return captured\n    const terminal = this.queue.find(entry => entry.event.eventId === captured.eventId)?.event\n    if (terminal === undefined) return receipt(captured.eventId, 'rejected', 'none', 'exporter-unavailable')\n    const targetIds = new Set(this.queue\n      .filter(entry => entry.event.priority === 'critical'\n        && entry.event.correlation.runId === terminal.correlation.runId\n        && entry.event.sequence <= terminal.sequence)\n      .map(entry => entry.event.eventId))\n    const outcome = await this.scheduleFlush(targetIds, this.options.flushTimeoutMs, signal)\n    if (!outcome.requiredComplete) return receipt(captured.eventId, 'rejected', 'none', 'exporter-unavailable')\n    return receipt(captured.eventId, 'accepted', requiredBoundary(this.registrations))\n  }\n\n  logger(context?: LoggerContext): SdkLogger {\n    return createBusLogger({\n      minimumLevel: this.options.minimumLogLevel as LogLevel,\n      resource: this.resource,\n      emit: event => { this.capture(event) },\n    }, context)\n  }\n\n  health(): ObservationHealthSnapshot {\n    const state: ObservationHealthSnapshot['state'] = this.closed\n      ? 'closed'\n      : this.counters.requiredFailure || this.counters.criticalRejected > 0 || this.counters.flushTimeouts > 0\n        ? 'failed'\n        : this.counters.processorFailures > 0 || this.counters.exporterFailures > 0\n          || this.counters.droppedVerbose > 0 || this.counters.droppedNormal > 0\n          ? 'degraded'\n          : 'healthy'\n    return deepFreeze({\n      state,\n      queuedEvents: this.queue.length,\n      queuedBytes: this.queueBytes,\n      accepted: this.counters.accepted,\n      exported: this.counters.exported,\n      droppedVerbose: this.counters.droppedVerbose,\n      droppedNormal: this.counters.droppedNormal,\n      criticalRejected: this.counters.criticalRejected,\n      processorFailures: this.counters.processorFailures,\n      exporterFailures: this.counters.exporterFailures,\n      flushTimeouts: this.counters.flushTimeouts,\n      ...this.counters.lastExportAt === undefined ? {} : { lastExportAt: this.counters.lastExportAt },\n      ...this.counters.lastFailure === undefined ? {} : { lastFailure: this.counters.lastFailure },\n    })\n  }\n\n  flush(signal?: AbortSignal): Promise<FlushResult> {\n    if (this.closed || this.closing) throw new TypeError('observability is closed')\n    return this.scheduleFlush(\n      new Set(this.queue.map(entry => entry.event.eventId)), this.options.flushTimeoutMs, signal,\n    ).then(publicFlushResult)\n  }\n\n  shutdown(signal?: AbortSignal): Promise<FlushResult> {\n    if (this.shutdownPromise !== undefined) return this.shutdownPromise\n    this.closing = true\n    const targetIds = new Set(this.queue.map(entry => entry.event.eventId))\n    this.shutdownPromise = (async () => {\n      const deadline = deadlineSignal(this.options.shutdownTimeoutMs, signal)\n      let result: FlushResult\n      try {\n        result = publicFlushResult(await this.scheduleFlush(\n          targetIds, this.options.shutdownTimeoutMs, deadline.signal,\n        ))\n        for (const registration of [...this.registrations].reverse()) {\n          const shutdown = registration.exporter.shutdown\n          if (shutdown === undefined) continue\n          try { await raceAbort(Promise.resolve(shutdown.call(registration.exporter, deadline.signal)), deadline.signal) }\n          catch (error) {\n            this.recordExporterFailure(registration, error, false)\n            result = Object.freeze({ ...result, complete: false })\n          }\n        }\n      } finally {\n        deadline.clear()\n        this.closed = true\n        this.notifyHealth()\n      }\n      return result\n    })()\n    return this.shutdownPromise\n  }\n\n  private prepareEvent(event: ObservationEvent, protectedPath: boolean): ObservationEvent {\n    const privacy = {\n      content: this.options.content,\n      redactors: this.options.redactors ?? [],\n      includeErrorStacks: this.options.includeErrorStacks,\n    }\n    let current = sanitizeObservationEvent(event, privacy)\n    if (protectedPath) return current\n    for (const processor of this.processors) {\n      const next = processor.transform(current)\n      if (next === undefined) throw new TypeError(`observation processor ${processor.id} returned undefined`)\n      const sanitized = sanitizeObservationEvent(next, privacy)\n      if (!sameEnvelope(current, sanitized)) {\n        throw new TypeError(`observation processor ${processor.id} changed the immutable event envelope`)\n      }\n      current = sanitized\n    }\n    return current\n  }\n\n  private enqueue(event: ObservationEvent, protectedPath: boolean): CaptureReceipt {\n    const bytes = serializedEventBytes(event)\n    if (bytes > this.options.maxBatchBytes || bytes > this.options.maxQueueBytes\n      || !this.makeCapacity(bytes, protectedPath)) {\n      if (!protectedPath && event.priority === 'critical') this.counters.criticalRejected++\n      if (!protectedPath) {\n        this.counters.lastFailure = safeFailure(new RangeError('capacity'), 'observation queue capacity exhausted')\n        this.notifyHealth()\n      }\n      return receipt(event.eventId, 'rejected', 'none', 'capacity')\n    }\n    this.queue.push({\n      event, bytes, protected: protectedPath,\n      pending: new Set(this.registrations.map(registration => registration.exporter.id)),\n    })\n    this.queueBytes += bytes\n    this.counters.accepted++\n    this.notifyHealth()\n    return receipt(event.eventId, 'accepted')\n  }\n\n  private stageExporters(event: ObservationEvent, captured: CaptureReceipt): CaptureReceipt {\n    const entry = this.queue.find(candidate => candidate.event.eventId === event.eventId)\n    if (entry === undefined) return receipt(event.eventId, 'rejected', 'none', 'exporter-unavailable')\n    let removedPending = false\n    for (const registration of this.registrations) {\n      const stage = registration.exporter.stage\n      if (stage === undefined) continue\n      try {\n        const pending = stage.call(registration.exporter, event)\n        if (pending !== undefined) void Promise.resolve(pending).catch(() => undefined)\n      } catch (error) {\n        this.recordExporterFailure(registration, error, false)\n        entry.pending.delete(registration.exporter.id)\n        removedPending = true\n        if (registration.requirement === 'required') {\n          this.removeEntry(entry, false)\n          if (event.priority === 'critical') this.counters.criticalRejected++\n          this.notifyHealth()\n          return receipt(event.eventId, 'rejected', 'none', 'exporter-unavailable')\n        }\n      }\n    }\n    if (removedPending && entry.pending.size === 0) this.removeEntry(entry, false)\n    return captured\n  }\n\n  private makeCapacity(incomingBytes: number, protectedPath: boolean): boolean {\n    while (this.queue.length + 1 > this.options.maxQueueEvents\n      || this.queueBytes + incomingBytes > this.options.maxQueueBytes) {\n      let index = this.queue.findIndex(entry => entry.event.priority === 'verbose')\n      if (index === -1) index = this.queue.findIndex(entry => entry.event.priority === 'normal')\n      if (index === -1) return false\n      const [removed] = this.queue.splice(index, 1)\n      if (removed === undefined) return false\n      this.queueBytes -= removed.bytes\n      if (!protectedPath) {\n        if (removed.event.priority === 'verbose') this.counters.droppedVerbose++\n        else this.counters.droppedNormal++\n      }\n    }\n    return true\n  }\n\n  private scheduleFlush(targetIds: ReadonlySet<string>, timeoutMs: number, signal?: AbortSignal): Promise<FlushOutcome> {\n    let resolveResult!: (result: FlushOutcome) => void\n    let rejectResult!: (error: unknown) => void\n    const result = new Promise<FlushOutcome>((resolve, reject) => { resolveResult = resolve; rejectResult = reject })\n    const task = async () => {\n      try { resolveResult(await this.flushInternal(targetIds, timeoutMs, signal)) }\n      catch (error) { rejectResult(error) }\n    }\n    this.flushChain = this.flushChain.then(task, task)\n    return result\n  }\n\n  private async flushInternal(\n    targetIds: ReadonlySet<string>,\n    timeoutMs: number,\n    external?: AbortSignal,\n  ): Promise<FlushOutcome> {\n    const beforeExported = this.counters.exported\n    const deadline = deadlineSignal(timeoutMs, external)\n    let failed = false\n    let timedOut = false\n    try {\n      if (this.registrations.length === 0) {\n        for (const entry of [...this.queue]) if (targetIds.has(entry.event.eventId)) this.removeEntry(entry, false)\n      }\n      for (const registration of this.registrations) {\n        while (true) {\n          const candidates = this.queue.filter(entry => (\n            targetIds.has(entry.event.eventId) && entry.pending.has(registration.exporter.id)\n          ))\n          if (candidates.length === 0) break\n          const entries: QueueEntry[] = []\n          let bytes = 0\n          for (const entry of candidates) {\n            if (entries.length >= this.options.maxBatchEvents || bytes + entry.bytes > this.options.maxBatchBytes) break\n            entries.push(entry)\n            bytes += entry.bytes\n          }\n          if (entries.length === 0) break\n          const batch: ObservationBatch = deepFreeze({\n            schemaVersion: 1,\n            batchId: createOperationId(),\n            createdAt: new Date().toISOString(),\n            events: entries.map(entry => entry.event),\n          })\n          let ack: ExportAck\n          try {\n            ack = await raceAbort(Promise.resolve(registration.exporter.export(batch, deadline.signal)), deadline.signal)\n            if (ack.batchId !== batch.batchId || ack.accepted !== true) {\n              throw new TypeError(`observation exporter ${registration.exporter.id} returned an invalid acknowledgment`)\n            }\n          } catch (error) {\n            failed = true\n            timedOut ||= isTimeoutAbort(deadline.signal)\n            this.recordExporterFailure(registration, error, true)\n            if (registration.requirement === 'best-effort') {\n              for (const entry of entries) {\n                entry.pending.delete(registration.exporter.id)\n                if (entry.pending.size === 0) this.removeEntry(entry, false)\n              }\n            }\n            break\n          }\n          this.counters.lastExportAt = new Date().toISOString()\n          for (const entry of entries) {\n            entry.pending.delete(registration.exporter.id)\n            if (entry.pending.size === 0) this.removeEntry(entry, true)\n          }\n          this.notifyHealth()\n        }\n      }\n    } finally {\n      if (isTimeoutAbort(deadline.signal)) {\n        timedOut = true\n        this.counters.flushTimeouts++\n        this.counters.lastFailure = safeFailure(deadline.signal.reason, 'observation flush timed out')\n        this.notifyHealth()\n      }\n      deadline.clear()\n    }\n    const pendingEntries = this.queue.filter(entry => targetIds.has(entry.event.eventId))\n    const requiredIds = this.registrations\n      .filter(registration => registration.requirement === 'required')\n      .map(registration => registration.exporter.id)\n    const requiredComplete = pendingEntries.every(entry => requiredIds.every(id => !entry.pending.has(id)))\n    return Object.freeze({\n      complete: !failed && !timedOut && pendingEntries.length === 0,\n      requiredComplete,\n      exportedEvents: this.counters.exported - beforeExported,\n      pendingEvents: pendingEntries.length,\n      rejectedCritical: this.counters.criticalRejected,\n      timedOut,\n    })\n  }\n\n  private removeEntry(entry: QueueEntry, exported: boolean): void {\n    const index = this.queue.indexOf(entry)\n    if (index === -1) return\n    this.queue.splice(index, 1)\n    this.queueBytes -= entry.bytes\n    if (exported) this.counters.exported++\n  }\n\n  private recordExporterFailure(\n    registration: ObservationExporterRegistration,\n    error: unknown,\n    emitProtected: boolean,\n  ): void {\n    this.counters.exporterFailures++\n    if (registration.requirement === 'required') this.counters.requiredFailure = true\n    this.counters.lastFailure = safeFailure(error, 'observation exporter failed')\n    this.notifyHealth()\n    if (emitProtected) this.recordFailure(\n      `exporter:${registration.exporter.id}`, error, 'observation exporter failed', true,\n    )\n  }\n\n  private recordFailure(key: string, error: unknown, message: string, emit: boolean): void {\n    this.counters.lastFailure = safeFailure(error, message)\n    this.notifyHealth()\n    if (!emit || this.protectedFailures.has(key) || this.closing || this.closed) return\n    this.protectedFailures.add(key)\n    try {\n      const event = this.prepareEvent({\n        schemaVersion: 1,\n        eventId: createOperationId(),\n        sequence: this.healthScope.nextSequence(),\n        name: 'sdk.observer.failure',\n        phase: 'point',\n        occurredAt: new Date().toISOString(),\n        monotonicMs: this.healthScope.monotonicMs(),\n        priority: 'critical',\n        resource: this.resource,\n        correlation: this.healthCorrelation,\n        data: {\n          observerId: key,\n          failureKind: 'contained',\n          count: 1,\n          error: { ...this.counters.lastFailure },\n        },\n      }, true)\n      this.enqueue(event, true)\n    } catch { /* health counters are the final protected path */ }\n  }\n\n  private notifyHealth(): void {\n    const callback = this.options.onHealthChange\n    if (callback === undefined) return\n    try { callback(this.health()) } catch { /* emergency callback is separately contained */ }\n  }\n}\n\n/** Create one Universal observation bus. Construction validates every durability claim. */\nexport function createObservability(options: ObservabilityOptions = {}): Observability {\n  return new ObservationBus(options)\n}\n"],"mappings":"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"}