@tangle-network/agent-core 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,565 @@
+import { i as isSDKError, n as SDKError, r as isRetryable, t as ErrorCode } from "./index-DiQX9bjq.js";
+import { C as ReadTokenAuth, S as NoAuth, T as StaticTokenAuth, _ as SessionScopedTokenPayloadSchema, a as CreateSessionResponse, b as AuthProvider, c as ProductSchema, d as ProjectScopedTokenPayloadSchema, f as ReadTokenPayload, g as SessionScopedTokenPayload, h as SendMessageRequestSchema, i as CreateSessionRequestSchema, l as ProductSecrets, m as SendMessageRequest, n as BatchScopedTokenPayloadSchema, o as Product, p as ReadTokenPayloadSchema, r as CreateSessionRequest, s as ProductAuthInfo, t as BatchScopedTokenPayload, u as ProjectScopedTokenPayload, v as TokenScope, w as RefreshableTokenAuth, x as CallbackAuth, y as TokenValidationResult } from "./types-DiDSGM8K.js";
+import { ChannelAccessResult, EnvTokenAuth, ProductAuth, ProductTokenIssuer, SidecarAuth, canBatchTokenAccessChannel, canProjectTokenAccessChannel, canSessionTokenAccessChannel, canTokenAccessChannel, decodeToken, extractProjectFromChannel, extractSessionFromChannel, generateApiKey, generateSecureToken, generateSigningSecret, getAllowedChannelPatterns, getTokenScope, getTokenTTL, hashApiKey, isBatchScopedToken, isProjectScopedToken, isSessionScopedToken, isTokenExpiringSoon, issueBatchScopedToken, issueProjectScopedToken, issueReadToken, issueSessionScopedToken, validateChannelSubscription, validateTokenScope, verifyApiKey, verifyReadToken } from "./auth/index.js";
+import { a as EventChannel, c as EventBufferConfig, i as ChannelHandler, n as EventDeduplicator, o as BufferedEvent, r as ChannelConfig, s as EventBuffer, t as DeduplicatorConfig } from "./index-DlPznmKA.js";
+import { S as TransportMode, _ as StreamOptions, a as RecordedRequest, b as TransportEvents, c as TransportAdapter, d as ConnectionQuality, f as ConnectionState, g as SSEEvent, h as RequestOptions, i as MockTransportConfig, l as ConnectionManager, m as ReconnectionConfig, n as MockStreamEvent, o as BaseTransportAdapter, p as DEFAULT_RECONNECTION_CONFIG, r as MockTransportAdapter, s as Subscription, t as MockResponse, u as ConnectionManagerConfig, v as SubscriptionState, x as TransportMetrics, y as TransportConfig } from "./index-CFA8kgHJ.js";
+import { a as ProtectionOptions, c as CircuitBreaker, d as CircuitOpenError, f as CircuitState, i as withTimeout, l as CircuitBreakerConfig, n as createTimeoutController, o as createProtectedFn, r as sleep, s as withProtection, t as TimeoutError, u as CircuitBreakerStats } from "./index-CtebBodu.js";
+import { ParsedSSEEvent, SSEChunkParser, SSEEventData, SSEParserOptions, StreamTokenUsage, StreamUsageAccumulator, StreamUsageExtractor, consumeSSEStream, createStreamUsageExtractor, createUsageCallback, parseSSEData, parseSSEStream } from "./sse/index.js";
+import { A as ToolStateCompleted, C as TerminalDataEvent, D as TextPart, E as TerminalResizeEvent, F as isReasoningPart, I as isSubtaskPart, L as isTextPart, M as ToolStatePending, N as ToolStateRunning, O as ToolPart, P as isFilePart, R as isToolPart, S as SubtaskPart, T as TerminalExitEvent, _ as ReplayEndEvent, a as DoneEvent, b as SessionUpdatedEvent, c as ExecutionCompletedEvent, d as FilePart, f as HeartbeatEvent, g as ReasoningPart, h as PartBase, i as ConnectionInitEvent, j as ToolStateError, k as ToolState, l as ExecutionFailedEvent, m as Part, n as AgentEventType, o as ErrorEvent, p as MessagePartUpdatedEvent, r as AgentEventTypeSchema, s as EventMetadata, t as AgentEvent, u as ExecutionStartedEvent, v as ReplayStartEvent, w as TerminalEvent, x as StatusEvent, y as ResultEvent } from "./index-z2wPdzFb.js";
+
+//#region src/cache/index.d.ts
+/**
+ * Response Caching
+ *
+ * In-memory cache with TTL and cache-control support.
+ */
+/** Cache entry */
+interface CacheEntry<T> {
+  data: T;
+  cachedAt: number;
+  expiresAt: number;
+  etag?: string;
+}
+/** Cache configuration */
+interface CacheConfig {
+  /** Default TTL in ms (default: 60000 = 1 minute) */
+  defaultTtlMs?: number;
+  /** Max entries (default: 1000) */
+  maxEntries?: number;
+  /** Cache key generator */
+  keyGenerator?: (path: string, params?: Record<string, unknown>) => string;
+}
+/** Cache interface for different storage backends */
+interface CacheStorage<T = unknown> {
+  get(key: string): T | undefined | Promise<T | undefined>;
+  set(key: string, value: T, ttlMs?: number): void | Promise<void>;
+  delete(key: string): void | Promise<void>;
+  clear(): void | Promise<void>;
+}
+/** In-memory LRU cache */
+declare class MemoryCache<T = unknown> implements CacheStorage<CacheEntry<T>> {
+  private cache;
+  private readonly maxEntries;
+  constructor(maxEntries?: number);
+  get(key: string): CacheEntry<T> | undefined;
+  set(key: string, value: CacheEntry<T>): void;
+  delete(key: string): void;
+  clear(): void;
+  /** Get cache stats */
+  stats(): {
+    size: number;
+    maxEntries: number;
+  };
+}
+/** Response cache manager */
+declare class ResponseCache<T = unknown> {
+  private storage;
+  private defaultTtlMs;
+  private keyGenerator;
+  constructor(config?: CacheConfig);
+  private defaultKeyGenerator;
+  /** Get cached response */
+  get(path: string, params?: Record<string, unknown>): Promise<T | undefined>;
+  /** Get with stale-while-revalidate support */
+  getWithMeta(path: string, params?: Record<string, unknown>): Promise<{
+    data: T;
+    stale: boolean;
+    etag?: string;
+  } | undefined>;
+  /** Cache response */
+  set(path: string, data: T, options?: {
+    params?: Record<string, unknown>;
+    ttlMs?: number;
+    etag?: string;
+  }): Promise<void>;
+  /** Invalidate cache entry */
+  invalidate(path: string, params?: Record<string, unknown>): Promise<void>;
+  /** Invalidate all entries matching prefix */
+  invalidatePrefix(_prefix: string): Promise<void>;
+  /** Clear entire cache */
+  clear(): Promise<void>;
+  /** Parse Cache-Control header */
+  static parseCacheControl(header: string): {
+    maxAge?: number;
+    noCache?: boolean;
+    noStore?: boolean;
+  };
+}
+//#endregion
+//#region src/middleware/index.d.ts
+/** Request context passed through interceptor chain */
+interface RequestContext {
+  /** Original request options */
+  request: RequestOptions;
+  /** Request start time */
+  startedAt: number;
+  /** Unique request ID */
+  requestId: string;
+  /** Retry attempt number (0 = first attempt) */
+  attempt: number;
+  /** Custom metadata */
+  meta: Record<string, unknown>;
+}
+/** Response context */
+interface ResponseContext<T = unknown> {
+  /** Request context */
+  request: RequestContext;
+  /** Response data */
+  data: T;
+  /** Response time in ms */
+  durationMs: number;
+  /** HTTP status (if available) */
+  status?: number;
+}
+/** Error context */
+interface ErrorContext {
+  /** Request context */
+  request: RequestContext;
+  /** The error */
+  error: SDKError;
+  /** Duration before error */
+  durationMs: number;
+}
+/** Interceptor interface */
+interface Interceptor {
+  /** Modify request before sending */
+  onRequest?(ctx: RequestContext): RequestContext | Promise<RequestContext>;
+  /** Process successful response */
+  onResponse?<T>(ctx: ResponseContext<T>): T | Promise<T>;
+  /** Handle error (can transform or rethrow) */
+  onError?(ctx: ErrorContext): void | Promise<void>;
+}
+/** Interceptor chain executor */
+declare class InterceptorChain {
+  private interceptors;
+  /** Add interceptor to chain */
+  use(interceptor: Interceptor): this;
+  /** Remove interceptor */
+  remove(interceptor: Interceptor): this;
+  /** Run request through interceptors */
+  executeRequest(ctx: RequestContext): Promise<RequestContext>;
+  /** Run response through interceptors (reverse order) */
+  executeResponse<T>(ctx: ResponseContext<T>): Promise<T>;
+  /** Notify interceptors of error */
+  executeError(ctx: ErrorContext): Promise<void>;
+}
+/** Generate unique request ID */
+declare function generateRequestId(): string;
+/** Logging interceptor */
+declare function createLoggingInterceptor(logger?: {
+  debug?(msg: string, data?: unknown): void;
+  info?(msg: string, data?: unknown): void;
+  error?(msg: string, data?: unknown): void;
+}): Interceptor;
+/** Metrics interceptor */
+declare function createMetricsInterceptor(onMetric: (metric: {
+  path: string;
+  method: string;
+  status: "success" | "error";
+  durationMs: number;
+  errorCode?: string;
+}) => void): Interceptor;
+/** Header injection interceptor */
+declare function createHeaderInterceptor(headers: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>)): Interceptor;
+//#endregion
+//#region src/storage/index.d.ts
+/**
+ * Offline Storage Abstraction
+ *
+ * Platform-agnostic storage interface with implementations for different environments.
+ */
+/** Storage interface */
+interface Storage {
+  get<T>(key: string): Promise<T | null>;
+  set<T>(key: string, value: T): Promise<void>;
+  delete(key: string): Promise<void>;
+  clear(): Promise<void>;
+  keys(): Promise<string[]>;
+}
+/** In-memory storage (default fallback) */
+declare class MemoryStorage implements Storage {
+  private data;
+  get<T>(key: string): Promise<T | null>;
+  set<T>(key: string, value: T): Promise<void>;
+  delete(key: string): Promise<void>;
+  clear(): Promise<void>;
+  keys(): Promise<string[]>;
+}
+/** Browser localStorage wrapper */
+declare class LocalStorage implements Storage {
+  private prefix;
+  constructor(prefix?: string);
+  private key;
+  get<T>(key: string): Promise<T | null>;
+  set<T>(key: string, value: T): Promise<void>;
+  delete(key: string): Promise<void>;
+  clear(): Promise<void>;
+  keys(): Promise<string[]>;
+}
+/** Offline request queue */
+interface QueuedRequest {
+  id: string;
+  path: string;
+  method: string;
+  body?: unknown;
+  headers?: Record<string, string>;
+  createdAt: number;
+  attempts: number;
+  idempotencyKey?: string;
+}
+/** Offline queue manager */
+declare class OfflineQueue {
+  private storage;
+  private readonly storageKey;
+  constructor(storage: Storage);
+  /** Add request to queue */
+  enqueue(request: Omit<QueuedRequest, "id" | "createdAt" | "attempts">): Promise<string>;
+  /** Get all queued requests */
+  getQueue(): Promise<QueuedRequest[]>;
+  /** Get next request to process */
+  peek(): Promise<QueuedRequest | null>;
+  /** Remove request from queue */
+  dequeue(id: string): Promise<void>;
+  /** Increment attempt count */
+  incrementAttempts(id: string): Promise<void>;
+  /** Get queue size */
+  size(): Promise<number>;
+  /** Clear queue */
+  clear(): Promise<void>;
+  /** Process queue with handler */
+  process(handler: (request: QueuedRequest) => Promise<boolean>, options?: {
+    maxAttempts?: number;
+    batchSize?: number;
+  }): Promise<{
+    processed: number;
+    failed: number;
+  }>;
+}
+/** Detect available storage */
+declare function detectStorage(): Storage;
+//#endregion
+//#region src/platform/index.d.ts
+/**
+ * Secure credential storage interface.
+ * Implementations should use platform-specific secure storage:
+ * - Web: Encrypted localStorage or IndexedDB
+ * - React Native: react-native-keychain
+ * - Electron: safeStorage + electron-store
+ * - Tauri: tauri-plugin-keyring
+ * - Node: keytar or encrypted file
+ */
+interface SecureStorage {
+  /** Store a credential securely */
+  setCredential(key: string, value: string): Promise<void>;
+  /** Retrieve a credential */
+  getCredential(key: string): Promise<string | null>;
+  /** Delete a credential */
+  deleteCredential(key: string): Promise<void>;
+  /** Check if secure storage is available */
+  isAvailable(): Promise<boolean>;
+}
+/**
+ * Network connectivity information.
+ * Implementations should use platform-specific APIs:
+ * - Web: navigator.onLine + online/offline events
+ * - React Native: @react-native-community/netinfo
+ * - Electron: net.online
+ * - Tauri: network events
+ * - Node/TUI: assume online or use dns lookup
+ */
+interface NetworkInfo {
+  /** Check if device is online */
+  isOnline(): boolean;
+  /** Subscribe to connectivity changes */
+  onConnectivityChange(callback: (online: boolean) => void): () => void;
+  /** Get connection quality hint (optional) */
+  getConnectionType?(): "wifi" | "cellular" | "ethernet" | "unknown";
+}
+/**
+ * State persistence adapter for cross-session state.
+ * Handles syncing SDK state (sessions, queued requests, cache)
+ * to platform-appropriate storage.
+ */
+interface PersistenceAdapter {
+  /** Save state snapshot */
+  saveState<T>(namespace: string, state: T): Promise<void>;
+  /** Load state snapshot */
+  loadState<T>(namespace: string): Promise<T | null>;
+  /** Clear namespace */
+  clearState(namespace: string): Promise<void>;
+  /** Subscribe to external state changes (for multi-window/tab sync) */
+  onExternalChange?(namespace: string, callback: (state: unknown) => void): () => void;
+}
+/**
+ * Platform capabilities descriptor.
+ * Used to adapt SDK behavior to platform constraints.
+ */
+interface PlatformCapabilities {
+  /** Platform identifier */
+  platform: "web" | "react-native" | "electron" | "tauri" | "node";
+  /** Supports background execution */
+  supportsBackground: boolean;
+  /** Supports secure credential storage */
+  supportsSecureStorage: boolean;
+  /** Supports WebSocket */
+  supportsWebSocket: boolean;
+  /** Supports SSE (EventSource) */
+  supportsSSE: boolean;
+  /** Max concurrent connections (browser limits) */
+  maxConnections?: number;
+}
+/**
+ * Platform adapter combining all platform-specific interfaces.
+ * Each platform provides one implementation of this interface.
+ */
+interface PlatformAdapter {
+  /** Platform capabilities */
+  capabilities: PlatformCapabilities;
+  /** General key-value storage */
+  storage: Storage;
+  /** Secure credential storage (optional) */
+  secureStorage?: SecureStorage;
+  /** Network info (optional) */
+  network?: NetworkInfo;
+  /** State persistence (optional) */
+  persistence?: PersistenceAdapter;
+  /** Fetch implementation */
+  fetch: typeof fetch;
+}
+/**
+ * In-memory secure storage fallback.
+ * NOT SECURE - use only for development/testing.
+ */
+declare class MemorySecureStorage implements SecureStorage {
+  private credentials;
+  setCredential(key: string, value: string): Promise<void>;
+  getCredential(key: string): Promise<string | null>;
+  deleteCredential(key: string): Promise<void>;
+  isAvailable(): Promise<boolean>;
+}
+/**
+ * Browser-based network info using navigator.onLine.
+ */
+declare class BrowserNetworkInfo implements NetworkInfo {
+  isOnline(): boolean;
+  onConnectivityChange(callback: (online: boolean) => void): () => void;
+  getConnectionType(): "wifi" | "cellular" | "ethernet" | "unknown";
+}
+/**
+ * Node.js network info (assumes always online).
+ */
+declare class NodeNetworkInfo implements NetworkInfo {
+  isOnline(): boolean;
+  onConnectivityChange(_callback: (online: boolean) => void): () => void;
+}
+/**
+ * Storage-based persistence adapter.
+ * Uses provided Storage implementation for state persistence.
+ */
+declare class StoragePersistence implements PersistenceAdapter {
+  private storage;
+  constructor(storage: Storage);
+  saveState<T>(namespace: string, state: T): Promise<void>;
+  loadState<T>(namespace: string): Promise<T | null>;
+  clearState(namespace: string): Promise<void>;
+}
+/**
+ * Browser persistence with localStorage and storage events for tab sync.
+ */
+declare class BrowserPersistence implements PersistenceAdapter {
+  private prefix;
+  constructor(prefix?: string);
+  saveState<T>(namespace: string, state: T): Promise<void>;
+  loadState<T>(namespace: string): Promise<T | null>;
+  clearState(namespace: string): Promise<void>;
+  onExternalChange(namespace: string, callback: (state: unknown) => void): () => void;
+}
+/**
+ * Detect current platform.
+ */
+declare function detectPlatform(): PlatformCapabilities["platform"];
+/**
+ * Create default platform adapter for current environment.
+ * Override with platform-specific implementations for better integration.
+ */
+declare function createDefaultPlatformAdapter(): PlatformAdapter;
+/**
+ * Type-safe platform adapter factory.
+ * Use this to create platform adapters with proper typing.
+ */
+declare function createPlatformAdapter(config: Partial<PlatformAdapter> & {
+  capabilities: PlatformCapabilities;
+}): PlatformAdapter;
+//#endregion
+//#region src/retry/index.d.ts
+/** Retry configuration */
+interface RetryConfig {
+  /** Max retry attempts (default: 3) */
+  maxAttempts?: number;
+  /** Initial delay in ms (default: 1000) */
+  initialDelayMs?: number;
+  /** Max delay in ms (default: 30000) */
+  maxDelayMs?: number;
+  /** Backoff multiplier (default: 2) */
+  multiplier?: number;
+  /** Jitter factor 0-1 (default: 0.2) */
+  jitter?: number;
+  /** Custom retry predicate */
+  shouldRetry?: (error: SDKError, attempt: number) => boolean;
+  /** Callback before retry */
+  onRetry?: (error: SDKError, attempt: number, delayMs: number) => void;
+}
+/** Calculate delay for attempt with jitter */
+declare function calculateDelay(attempt: number, config: RetryConfig): number;
+/** Execute function with retry */
+declare function withRetry<T>(fn: (attempt: number) => Promise<T>, config?: RetryConfig): Promise<T>;
+/** Idempotency key generator */
+declare function generateIdempotencyKey(): string;
+/** Retry decorator for class methods */
+declare function Retryable(config?: RetryConfig): <T>(_target: object, _propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: unknown[]) => Promise<T>>) => TypedPropertyDescriptor<(...args: unknown[]) => Promise<T>>;
+//#endregion
+//#region src/telemetry/genai-attributes.d.ts
+/**
+ * OpenTelemetry GenAI semantic-convention span attributes — the single
+ * vocabulary every trace producer in the stack emits and the intelligence
+ * ingest reads, so model / token / cost attribution is identical regardless of
+ * which producer lowered the span (workflow emitter, SDK trace sink, …).
+ *
+ * Writers emit the PRIMARY keys (`GEN_AI_*`). The ingest reader accepts the
+ * wider candidate lists (`GEN_AI_*_KEYS`) because foreign SDKs spell the same
+ * field differently (Langfuse, raw OTLP GenAI, our own legacy `model`).
+ * Co-locating writer keys and reader candidates here is the drift guard: a
+ * writer's key and the reader's first candidate can never silently disagree.
+ *
+ * Spec: OpenTelemetry GenAI semantic conventions (`gen_ai.*`).
+ */
+/** Model that served a request — the primary key writers emit. */
+declare const GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+/** Model named on a response — a reader fallback; writers prefer request.model. */
+declare const GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+/** Prompt / input token count. */
+declare const GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+/** Completion / output token count. */
+declare const GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+/** Operation name (e.g. `"invoke_agent"`). */
+declare const GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+/** Conversation / session id grouping a multi-turn agent run. */
+declare const GEN_AI_CONVERSATION_ID = "gen_ai.conversation.id";
+/**
+ * Reader candidate keys for the model, highest priority first. The first entry
+ * is the writers' primary key; the rest accept foreign-SDK spellings.
+ */
+declare const GEN_AI_MODEL_KEYS: readonly string[];
+/** Reader candidate keys for input tokens, highest priority first. These name
+ *  SPAN ATTRIBUTES on a lowered span — for the raw producer `tokenUsage` OBJECT
+ *  field names (a distinct layer) see `TOKEN_USAGE_INPUT_KEYS` in
+ *  `token-usage.ts`; a new producer shape may need an entry in both. */
+declare const GEN_AI_INPUT_TOKEN_KEYS: readonly string[];
+/** Reader candidate keys for output tokens, highest priority first. */
+declare const GEN_AI_OUTPUT_TOKEN_KEYS: readonly string[];
+/** A model/token usage record to lower into the GenAI attribute bag. */
+interface GenAiUsage {
+  /** Model slug; omitted from the attribute bag when absent or empty. */
+  model?: string;
+  /** Prompt tokens; omitted unless a finite, non-negative number. */
+  inputTokens?: number;
+  /** Completion tokens; omitted unless a finite, non-negative number. */
+  outputTokens?: number;
+}
+/**
+ * Lower a usage record to the GenAI semantic-convention attribute bag, OMITTING
+ * any unknown field. A synthesized zero token count or empty model would
+ * corrupt every downstream token/cost aggregate, so absent stays absent — the
+ * ingest then reads "cost not computed", never "free". This is the writer-side
+ * mirror of {@link GEN_AI_MODEL_KEYS} / the `*_TOKEN_KEYS` reader candidates.
+ */
+declare function genAiUsageAttributes(usage: GenAiUsage): Record<string, string | number>;
+//#endregion
+//#region src/telemetry/token-usage.d.ts
+/**
+ * Candidate field names for a producer-supplied `tokenUsage` bag on a
+ * `message.updated` trace event. Agents and SDK layers disagree on the
+ * spelling: `StreamTokenUsage` emits `inputTokens`/`outputTokens`, the eval and
+ * workflow agent.run paths emit `input`/`output`, and persisted / foreign
+ * shapes use snake_case or prompt/completion naming. A reader that wants the
+ * token counts must try all of them, highest-priority first, or it silently
+ * drops usage for the producers it does not name.
+ *
+ * Shared so every `tokenUsage` reader (the trace sink's root-span aggregation,
+ * the signal extractor) keys off the identical set and cannot drift.
+ *
+ * Distinct layer from `genai-attributes.ts`: those keys (`GEN_AI_*_TOKEN_KEYS`)
+ * name OTel SPAN ATTRIBUTES on an already-lowered span; these name the fields of
+ * the raw producer `tokenUsage` OBJECT before lowering. A new producer that
+ * spells token usage differently may need an entry in BOTH places.
+ */
+declare const TOKEN_USAGE_INPUT_KEYS: readonly string[];
+declare const TOKEN_USAGE_OUTPUT_KEYS: readonly string[];
+//#endregion
+//#region src/utils/channel-matching.d.ts
+/**
+ * Channel Pattern Matching
+ *
+ * Generic utility for matching channel patterns with wildcard support.
+ * Used for channel subscriptions and event filtering.
+ *
+ * Pattern syntax:
+ * - "*" matches all channels
+ * - "foo.*" matches "foo.bar", "foo.baz", etc. (dot-separated)
+ * - "foo:*" matches "foo:bar", "foo:baz", etc. (colon-separated)
+ * - "foo.bar" matches exactly "foo.bar"
+ * - "session:abc" matches exactly "session:abc"
+ */
+/**
+ * Check if a pattern matches a channel name.
+ *
+ * @param pattern - The pattern to match against (supports wildcards)
+ * @param channel - The channel name to check
+ * @returns true if the pattern matches the channel
+ */
+declare function matchesChannel(pattern: string, channel: string): boolean;
+/**
+ * Check if any subscribed channel pattern matches the given channel.
+ *
+ * @param subscribedChannels - Set or array of channel patterns
+ * @param channel - The channel to check
+ * @returns true if any pattern matches the channel
+ */
+declare function matchesAnyChannel(subscribedChannels: Set<string> | string[], channel: string): boolean;
+//#endregion
+//#region src/utils/session-translator.d.ts
+/**
+ * Session ID Translator
+ *
+ * Generic utility for translating session IDs in event objects.
+ * Used to map internal session IDs to client-facing session IDs.
+ */
+interface SessionTranslation {
+  /** The internal session ID to replace */
+  from: string;
+  /** The client-facing session ID to use */
+  to: string;
+}
+/**
+ * Translate session IDs in an event object.
+ * Performs a deep string replacement via JSON serialization.
+ *
+ * @param event - The event object to translate
+ * @param translation - The session ID mapping
+ * @returns A new event object with translated session IDs
+ */
+declare function translateSessionId<T>(event: T, translation: SessionTranslation): T;
+/**
+ * Create a reusable translator function for a specific session mapping.
+ * Pre-compiles the regex pattern for better performance when translating
+ * many events with the same mapping.
+ */
+declare function createSessionTranslator(translation: SessionTranslation): <T>(event: T) => T;
+/**
+ * Extract session ID from various event structures.
+ * Handles different event formats that may contain session information.
+ */
+declare function extractSessionId(event: unknown): string | null;
+//#endregion
+export { type AgentEvent, type AgentEventType, AgentEventTypeSchema, type AuthProvider, BaseTransportAdapter, type BatchScopedTokenPayload, BatchScopedTokenPayloadSchema, BrowserNetworkInfo, BrowserPersistence, type BufferedEvent, type CacheConfig, type CacheStorage, CallbackAuth, type ChannelAccessResult, type ChannelConfig, type ChannelHandler, CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerStats, CircuitOpenError, type CircuitState, type ConnectionInitEvent, ConnectionManager, type ConnectionManagerConfig, type ConnectionQuality, type ConnectionState, type CreateSessionRequest, CreateSessionRequestSchema, type CreateSessionResponse, DEFAULT_RECONNECTION_CONFIG, type DeduplicatorConfig, type DoneEvent, EnvTokenAuth, type ErrorCode, type ErrorContext, type ErrorEvent, EventBuffer, type EventBufferConfig, EventChannel, EventDeduplicator, type EventMetadata, type ExecutionCompletedEvent, type ExecutionFailedEvent, type ExecutionStartedEvent, type FilePart, GEN_AI_CONVERSATION_ID, GEN_AI_INPUT_TOKEN_KEYS, GEN_AI_MODEL_KEYS, GEN_AI_OPERATION_NAME, GEN_AI_OUTPUT_TOKEN_KEYS, GEN_AI_REQUEST_MODEL, GEN_AI_RESPONSE_MODEL, GEN_AI_USAGE_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, type GenAiUsage, type HeartbeatEvent, type Interceptor, InterceptorChain, LocalStorage, MemoryCache, MemorySecureStorage, MemoryStorage, type MessagePartUpdatedEvent, type MockResponse, type MockStreamEvent, MockTransportAdapter, type MockTransportConfig, type NetworkInfo, NoAuth, NodeNetworkInfo, OfflineQueue, type ParsedSSEEvent, type Part, type PartBase, type PersistenceAdapter, type PlatformAdapter, type PlatformCapabilities, type Product, ProductAuth, type ProductAuthInfo, ProductSchema, type ProductSecrets, ProductTokenIssuer, type ProjectScopedTokenPayload, ProjectScopedTokenPayloadSchema, type ProtectionOptions, type QueuedRequest, ReadTokenAuth, type ReadTokenPayload, ReadTokenPayloadSchema, type ReasoningPart, type ReconnectionConfig, type RecordedRequest, RefreshableTokenAuth, type ReplayEndEvent, type ReplayStartEvent, type RequestContext, type RequestOptions, ResponseCache, type ResponseContext, type ResultEvent, type RetryConfig, Retryable, SDKError, SSEChunkParser, type SSEEvent, type SSEEventData, type SSEParserOptions, type SecureStorage, type SendMessageRequest, SendMessageRequestSchema, type SessionScopedTokenPayload, SessionScopedTokenPayloadSchema, type SessionTranslation, type SessionUpdatedEvent, SidecarAuth, StaticTokenAuth, type StatusEvent, type Storage, StoragePersistence, type StreamOptions, type StreamTokenUsage, type StreamUsageAccumulator, StreamUsageExtractor, type Subscription, type SubscriptionState, type SubtaskPart, TOKEN_USAGE_INPUT_KEYS, TOKEN_USAGE_OUTPUT_KEYS, type TerminalDataEvent, type TerminalEvent, type TerminalExitEvent, type TerminalResizeEvent, type TextPart, TimeoutError, type TokenScope, type TokenValidationResult, type ToolPart, type ToolState, type ToolStateCompleted, type ToolStateError, type ToolStatePending, type ToolStateRunning, type TransportAdapter, type TransportConfig, type TransportEvents, type TransportMetrics, type TransportMode, calculateDelay, canBatchTokenAccessChannel, canProjectTokenAccessChannel, canSessionTokenAccessChannel, canTokenAccessChannel, consumeSSEStream, createDefaultPlatformAdapter, createHeaderInterceptor, createLoggingInterceptor, createMetricsInterceptor, createPlatformAdapter, createProtectedFn, createSessionTranslator, createStreamUsageExtractor, createTimeoutController, createUsageCallback, decodeToken, detectPlatform, detectStorage, extractProjectFromChannel, extractSessionFromChannel, extractSessionId, genAiUsageAttributes, generateApiKey, generateIdempotencyKey, generateRequestId, generateSecureToken, generateSigningSecret, getAllowedChannelPatterns, getTokenScope, getTokenTTL, hashApiKey, isBatchScopedToken, isFilePart, isProjectScopedToken, isReasoningPart, isRetryable, isSDKError, isSessionScopedToken, isSubtaskPart, isTextPart, isTokenExpiringSoon, isToolPart, issueBatchScopedToken, issueProjectScopedToken, issueReadToken, issueSessionScopedToken, matchesAnyChannel, matchesChannel, parseSSEData, parseSSEStream, sleep, translateSessionId, validateChannelSubscription, validateTokenScope, verifyApiKey, verifyReadToken, withProtection, withRetry, withTimeout };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/cache/index.ts","../src/middleware/index.ts","../src/storage/index.ts","../src/platform/index.ts","../src/retry/index.ts","../src/telemetry/genai-attributes.ts","../src/telemetry/token-usage.ts","../src/utils/channel-matching.ts","../src/utils/session-translator.ts"],"mappings":"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"}