@tangle-network/agent-core 0.12.0 → 0.13.1

package/dist/index.d.ts

@@ -451,6 +451,10 @@ export declare function matchesChannel(pattern: string, channel: string): boolea
  */
 export declare function matchesAnyChannel(subscribedChannels: Set<string> | string[], channel: string): boolean;
 //#endregion
+//#region src/utils/record.d.ts
+/** True for a non-null, non-array object, the shape parsed JSON objects take. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//#endregion
 //#region src/utils/session-translator.d.ts
 /**
  * Session ID Translator

package/dist/index.d.ts.map

@@ -1 +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/utils/channel-matching.ts","../src/utils/session-translator.ts"],"mappings":"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"}
+{"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/utils/channel-matching.ts","../src/utils/record.ts","../src/utils/session-translator.ts"],"mappings":"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"}

package/dist/index.js

@@ -650,6 +650,12 @@ function matchesAnyChannel(subscribedChannels, channel) {
 	return (Array.isArray(subscribedChannels) ? subscribedChannels : Array.from(subscribedChannels)).some((pattern) => matchesChannel(pattern, channel));
 }
 //#endregion
+//#region src/utils/record.ts
+/** True for a non-null, non-array object, the shape parsed JSON objects take. */
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region src/utils/session-translator.ts
 /**
 * Escape special regex characters in a string.
@@ -718,6 +724,6 @@ function extractSessionId(event) {
 	return null;
 }
 //#endregion
-export { AgentEventTypeSchema, BaseTransportAdapter, BatchScopedTokenPayloadSchema, BrowserNetworkInfo, BrowserPersistence, CONTENT_COMPLETION_KEY, CONTENT_KEYS, CONTENT_KEY_FIELD, CONTENT_PROMPT_KEY, CONTENT_TOOL_ARGS_KEY, CONTENT_TOOL_NAME_KEY, CONTENT_TOOL_RESULT_KEY, CallbackAuth, CircuitBreaker, CircuitOpenError, ConnectionManager, CreateSessionRequestSchema, DEFAULT_RECONNECTION_CONFIG, EnvTokenAuth, EventBuffer, EventChannel, EventDeduplicator, 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_CACHE_CREATION_INPUT_TOKENS, GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS, GEN_AI_USAGE_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, INDEXED_CONTENT_KEY_LIKE_PATTERNS, InterceptorChain, LocalStorage, MemoryCache, MemorySecureStorage, MemoryStorage, MockTransportAdapter, NoAuth, NodeNetworkInfo, OfflineQueue, PARENT_RUN_KEY_ATTRS, ProductAuth, ProductSchema, ProductTokenIssuer, ProjectScopedTokenPayloadSchema, RUN_KEY_ATTRS, RUN_KIND_ATTRS, ReadTokenAuth, ReadTokenPayloadSchema, RefreshableTokenAuth, ResponseCache, Retryable, SDKError, SSEChunkParser, SUBJECT_KEY_ATTRS, SendMessageRequestSchema, SessionScopedTokenPayloadSchema, SidecarAuth, StaticTokenAuth, StoragePersistence, StreamUsageExtractor, TANGLE_RUN_ID_CAMEL_KEY, TANGLE_RUN_ID_KEY, TANGLE_RUN_KIND_KEY, TANGLE_RUN_PARENT_ID_KEY, TANGLE_SUBJECT_KEY, TANGLE_TRIGGER_ID_KEY, TANGLE_TRIGGER_KIND_KEY, TANGLE_TRIGGER_SOURCE_KEY, TANGLE_WORKFLOW_ID_KEY, TOKEN_USAGE_CACHE_BAG_KEYS, TOKEN_USAGE_CACHE_BAG_READ_KEYS, TOKEN_USAGE_CACHE_BAG_WRITE_KEYS, TOKEN_USAGE_CACHE_READ_EXCLUSIVE_KEYS, TOKEN_USAGE_CACHE_READ_INCLUSIVE_KEYS, TOKEN_USAGE_CACHE_WRITE_EXCLUSIVE_KEYS, TOKEN_USAGE_CACHE_WRITE_INCLUSIVE_KEYS, TOKEN_USAGE_COST_KEYS, TOKEN_USAGE_DETAIL_KEYS, TOKEN_USAGE_INPUT_KEYS, TOKEN_USAGE_OUTPUT_KEYS, TRIGGER_ID_ATTRS, TRIGGER_SOURCE_ATTRS, TimeoutError, WORKFLOW_MARKER_ATTRS, addTokenUsage, asContentField, asContentString, cacheHitRate, calculateDelay, canBatchTokenAccessChannel, canProjectTokenAccessChannel, canSessionTokenAccessChannel, canTokenAccessChannel, classifyAgent, consumeSSEStream, createDefaultPlatformAdapter, createHeaderInterceptor, createLoggingInterceptor, createMetricsInterceptor, createPlatformAdapter, createProtectedFn, createSessionTranslator, createStreamUsageExtractor, createTimeoutController, createUsageCallback, declaredTaskText, decodeToken, detectPlatform, detectStorage, extractContent, extractProjectFromChannel, extractSessionFromChannel, extractSessionId, firstTokenCount, firstUsageCostUsd, genAiUsageAttributes, generateApiKey, generateIdempotencyKey, generateRequestId, generateSecureToken, generateSigningSecret, getAllowedChannelPatterns, getTokenScope, getTokenTTL, hasContent, hashApiKey, isBatchScopedToken, isFilePart, isProjectScopedToken, isReasoningPart, isRetryable, isSDKError, isSessionScopedToken, isSubtaskPart, isTextPart, isTokenExpiringSoon, isToolPart, issueBatchScopedToken, issueProjectScopedToken, issueReadToken, issueSessionScopedToken, logRecordContentBag, matchesAnyChannel, matchesChannel, normalizeContentAttributes, parseSSEData, parseSSEStream, promptTokens, readTokenCostUsd, readTokenUsage, resolveDeclaredIntent, sleep, tokenCount, tokenUsageSource, translateSessionId, validateChannelSubscription, validateTokenScope, verifyApiKey, verifyReadToken, withProtection, withRetry, withTimeout };
+export { AgentEventTypeSchema, BaseTransportAdapter, BatchScopedTokenPayloadSchema, BrowserNetworkInfo, BrowserPersistence, CONTENT_COMPLETION_KEY, CONTENT_KEYS, CONTENT_KEY_FIELD, CONTENT_PROMPT_KEY, CONTENT_TOOL_ARGS_KEY, CONTENT_TOOL_NAME_KEY, CONTENT_TOOL_RESULT_KEY, CallbackAuth, CircuitBreaker, CircuitOpenError, ConnectionManager, CreateSessionRequestSchema, DEFAULT_RECONNECTION_CONFIG, EnvTokenAuth, EventBuffer, EventChannel, EventDeduplicator, 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_CACHE_CREATION_INPUT_TOKENS, GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS, GEN_AI_USAGE_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, INDEXED_CONTENT_KEY_LIKE_PATTERNS, InterceptorChain, LocalStorage, MemoryCache, MemorySecureStorage, MemoryStorage, MockTransportAdapter, NoAuth, NodeNetworkInfo, OfflineQueue, PARENT_RUN_KEY_ATTRS, ProductAuth, ProductSchema, ProductTokenIssuer, ProjectScopedTokenPayloadSchema, RUN_KEY_ATTRS, RUN_KIND_ATTRS, ReadTokenAuth, ReadTokenPayloadSchema, RefreshableTokenAuth, ResponseCache, Retryable, SDKError, SSEChunkParser, SUBJECT_KEY_ATTRS, SendMessageRequestSchema, SessionScopedTokenPayloadSchema, SidecarAuth, StaticTokenAuth, StoragePersistence, StreamUsageExtractor, TANGLE_RUN_ID_CAMEL_KEY, TANGLE_RUN_ID_KEY, TANGLE_RUN_KIND_KEY, TANGLE_RUN_PARENT_ID_KEY, TANGLE_SUBJECT_KEY, TANGLE_TRIGGER_ID_KEY, TANGLE_TRIGGER_KIND_KEY, TANGLE_TRIGGER_SOURCE_KEY, TANGLE_WORKFLOW_ID_KEY, TOKEN_USAGE_CACHE_BAG_KEYS, TOKEN_USAGE_CACHE_BAG_READ_KEYS, TOKEN_USAGE_CACHE_BAG_WRITE_KEYS, TOKEN_USAGE_CACHE_READ_EXCLUSIVE_KEYS, TOKEN_USAGE_CACHE_READ_INCLUSIVE_KEYS, TOKEN_USAGE_CACHE_WRITE_EXCLUSIVE_KEYS, TOKEN_USAGE_CACHE_WRITE_INCLUSIVE_KEYS, TOKEN_USAGE_COST_KEYS, TOKEN_USAGE_DETAIL_KEYS, TOKEN_USAGE_INPUT_KEYS, TOKEN_USAGE_OUTPUT_KEYS, TRIGGER_ID_ATTRS, TRIGGER_SOURCE_ATTRS, TimeoutError, WORKFLOW_MARKER_ATTRS, addTokenUsage, asContentField, asContentString, cacheHitRate, calculateDelay, canBatchTokenAccessChannel, canProjectTokenAccessChannel, canSessionTokenAccessChannel, canTokenAccessChannel, classifyAgent, consumeSSEStream, createDefaultPlatformAdapter, createHeaderInterceptor, createLoggingInterceptor, createMetricsInterceptor, createPlatformAdapter, createProtectedFn, createSessionTranslator, createStreamUsageExtractor, createTimeoutController, createUsageCallback, declaredTaskText, decodeToken, detectPlatform, detectStorage, extractContent, extractProjectFromChannel, extractSessionFromChannel, extractSessionId, firstTokenCount, firstUsageCostUsd, genAiUsageAttributes, generateApiKey, generateIdempotencyKey, generateRequestId, generateSecureToken, generateSigningSecret, getAllowedChannelPatterns, getTokenScope, getTokenTTL, hasContent, hashApiKey, isBatchScopedToken, isFilePart, isProjectScopedToken, isReasoningPart, isRecord, isRetryable, isSDKError, isSessionScopedToken, isSubtaskPart, isTextPart, isTokenExpiringSoon, isToolPart, issueBatchScopedToken, issueProjectScopedToken, issueReadToken, issueSessionScopedToken, logRecordContentBag, matchesAnyChannel, matchesChannel, normalizeContentAttributes, parseSSEData, parseSSEStream, promptTokens, readTokenCostUsd, readTokenUsage, resolveDeclaredIntent, sleep, tokenCount, tokenUsageSource, translateSessionId, validateChannelSubscription, validateTokenScope, verifyApiKey, verifyReadToken, withProtection, withRetry, withTimeout };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/cache/index.ts","../src/middleware/index.ts","../src/storage/index.ts","../src/platform/index.ts","../src/retry/index.ts","../src/utils/channel-matching.ts","../src/utils/session-translator.ts"],"sourcesContent":["/**\n * Response Caching\n *\n * In-memory cache with TTL and cache-control support.\n */\n\n/** Cache entry */\ninterface CacheEntry<T> {\n  data: T;\n  cachedAt: number;\n  expiresAt: number;\n  etag?: string;\n}\n\n/** Cache configuration */\nexport interface CacheConfig {\n  /** Default TTL in ms (default: 60000 = 1 minute) */\n  defaultTtlMs?: number;\n  /** Max entries (default: 1000) */\n  maxEntries?: number;\n  /** Cache key generator */\n  keyGenerator?: (path: string, params?: Record<string, unknown>) => string;\n}\n\n/** Cache interface for different storage backends */\nexport interface CacheStorage<T = unknown> {\n  get(key: string): T | undefined | Promise<T | undefined>;\n  set(key: string, value: T, ttlMs?: number): void | Promise<void>;\n  delete(key: string): void | Promise<void>;\n  clear(): void | Promise<void>;\n}\n\n/** In-memory LRU cache */\nexport class MemoryCache<T = unknown> implements CacheStorage<CacheEntry<T>> {\n  private cache = new Map<string, CacheEntry<T>>();\n  private readonly maxEntries: number;\n\n  constructor(maxEntries = 1000) {\n    this.maxEntries = maxEntries;\n  }\n\n  get(key: string): CacheEntry<T> | undefined {\n    const entry = this.cache.get(key);\n    if (!entry) return undefined;\n\n    // Check expiration\n    if (Date.now() > entry.expiresAt) {\n      this.cache.delete(key);\n      return undefined;\n    }\n\n    // Move to end (most recently used)\n    this.cache.delete(key);\n    this.cache.set(key, entry);\n\n    return entry;\n  }\n\n  set(key: string, value: CacheEntry<T>): void {\n    // Evict oldest if at capacity\n    if (this.cache.size >= this.maxEntries) {\n      const oldest = this.cache.keys().next().value;\n      if (oldest) this.cache.delete(oldest);\n    }\n\n    this.cache.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.cache.delete(key);\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /** Get cache stats */\n  stats(): { size: number; maxEntries: number } {\n    return { size: this.cache.size, maxEntries: this.maxEntries };\n  }\n}\n\n/** Response cache manager */\nexport class ResponseCache<T = unknown> {\n  private storage: CacheStorage<CacheEntry<T>>;\n  private defaultTtlMs: number;\n  private keyGenerator: (\n    path: string,\n    params?: Record<string, unknown>,\n  ) => string;\n\n  constructor(config: CacheConfig = {}) {\n    this.storage = new MemoryCache<T>(config.maxEntries);\n    this.defaultTtlMs = config.defaultTtlMs ?? 60000;\n    this.keyGenerator = config.keyGenerator ?? this.defaultKeyGenerator;\n  }\n\n  private defaultKeyGenerator(\n    path: string,\n    params?: Record<string, unknown>,\n  ): string {\n    if (!params || Object.keys(params).length === 0) return path;\n    const sorted = Object.keys(params).sort();\n    const qs = sorted.map((k) => `${k}=${JSON.stringify(params[k])}`).join(\"&\");\n    return `${path}?${qs}`;\n  }\n\n  /** Get cached response */\n  async get(\n    path: string,\n    params?: Record<string, unknown>,\n  ): Promise<T | undefined> {\n    const key = this.keyGenerator(path, params);\n    const entry = await this.storage.get(key);\n    return entry?.data;\n  }\n\n  /** Get with stale-while-revalidate support */\n  async getWithMeta(\n    path: string,\n    params?: Record<string, unknown>,\n  ): Promise<{ data: T; stale: boolean; etag?: string } | undefined> {\n    const key = this.keyGenerator(path, params);\n    const entry = await this.storage.get(key);\n\n    if (!entry) return undefined;\n\n    const now = Date.now();\n    const stale = now > entry.expiresAt;\n\n    return { data: entry.data, stale, etag: entry.etag };\n  }\n\n  /** Cache response */\n  async set(\n    path: string,\n    data: T,\n    options?: {\n      params?: Record<string, unknown>;\n      ttlMs?: number;\n      etag?: string;\n    },\n  ): Promise<void> {\n    const key = this.keyGenerator(path, options?.params);\n    const now = Date.now();\n    const ttl = options?.ttlMs ?? this.defaultTtlMs;\n\n    await this.storage.set(key, {\n      data,\n      cachedAt: now,\n      expiresAt: now + ttl,\n      etag: options?.etag,\n    });\n  }\n\n  /** Invalidate cache entry */\n  async invalidate(\n    path: string,\n    params?: Record<string, unknown>,\n  ): Promise<void> {\n    const key = this.keyGenerator(path, params);\n    await this.storage.delete(key);\n  }\n\n  /** Invalidate all entries matching prefix */\n  async invalidatePrefix(_prefix: string): Promise<void> {\n    // Only works with MemoryCache\n    if (this.storage instanceof MemoryCache) {\n      // Need to iterate - not ideal but works for in-memory\n      const cache = this.storage as MemoryCache<T>;\n      // Can't iterate Map while modifying, so just clear for now\n      cache.clear();\n    }\n  }\n\n  /** Clear entire cache */\n  async clear(): Promise<void> {\n    await this.storage.clear();\n  }\n\n  /** Parse Cache-Control header */\n  static parseCacheControl(header: string): {\n    maxAge?: number;\n    noCache?: boolean;\n    noStore?: boolean;\n  } {\n    const result: { maxAge?: number; noCache?: boolean; noStore?: boolean } =\n      {};\n\n    const parts = header.split(\",\").map((p) => p.trim().toLowerCase());\n\n    for (const part of parts) {\n      if (part === \"no-cache\") result.noCache = true;\n      if (part === \"no-store\") result.noStore = true;\n      if (part.startsWith(\"max-age=\")) {\n        const age = Number.parseInt(part.slice(8), 10);\n        if (!Number.isNaN(age)) result.maxAge = age * 1000; // Convert to ms\n      }\n    }\n\n    return result;\n  }\n}\n","/**\n * Request/Response Interceptors\n *\n * Middleware for modifying requests, responses, and handling errors.\n */\n\nimport type { SDKError } from \"../errors/index.js\";\nimport type { RequestOptions } from \"../transport/types.js\";\n\n/** Request context passed through interceptor chain */\nexport interface RequestContext {\n  /** Original request options */\n  request: RequestOptions;\n  /** Request start time */\n  startedAt: number;\n  /** Unique request ID */\n  requestId: string;\n  /** Retry attempt number (0 = first attempt) */\n  attempt: number;\n  /** Custom metadata */\n  meta: Record<string, unknown>;\n}\n\n/** Response context */\nexport interface ResponseContext<T = unknown> {\n  /** Request context */\n  request: RequestContext;\n  /** Response data */\n  data: T;\n  /** Response time in ms */\n  durationMs: number;\n  /** HTTP status (if available) */\n  status?: number;\n}\n\n/** Error context */\nexport interface ErrorContext {\n  /** Request context */\n  request: RequestContext;\n  /** The error */\n  error: SDKError;\n  /** Duration before error */\n  durationMs: number;\n}\n\n/** Interceptor interface */\nexport interface Interceptor {\n  /** Modify request before sending */\n  onRequest?(ctx: RequestContext): RequestContext | Promise<RequestContext>;\n  /** Process successful response */\n  onResponse?<T>(ctx: ResponseContext<T>): T | Promise<T>;\n  /** Handle error (can transform or rethrow) */\n  onError?(ctx: ErrorContext): void | Promise<void>;\n}\n\n/** Interceptor chain executor */\nexport class InterceptorChain {\n  private interceptors: Interceptor[] = [];\n\n  /** Add interceptor to chain */\n  use(interceptor: Interceptor): this {\n    this.interceptors.push(interceptor);\n    return this;\n  }\n\n  /** Remove interceptor */\n  remove(interceptor: Interceptor): this {\n    const idx = this.interceptors.indexOf(interceptor);\n    if (idx >= 0) this.interceptors.splice(idx, 1);\n    return this;\n  }\n\n  /** Run request through interceptors */\n  async executeRequest(ctx: RequestContext): Promise<RequestContext> {\n    let current = ctx;\n    for (const interceptor of this.interceptors) {\n      if (interceptor.onRequest) {\n        current = await interceptor.onRequest(current);\n      }\n    }\n    return current;\n  }\n\n  /** Run response through interceptors (reverse order) */\n  async executeResponse<T>(ctx: ResponseContext<T>): Promise<T> {\n    let data = ctx.data;\n    for (let i = this.interceptors.length - 1; i >= 0; i--) {\n      const interceptor = this.interceptors[i];\n      if (interceptor.onResponse) {\n        data = await interceptor.onResponse({ ...ctx, data });\n      }\n    }\n    return data;\n  }\n\n  /** Notify interceptors of error */\n  async executeError(ctx: ErrorContext): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.onError) {\n        await interceptor.onError(ctx);\n      }\n    }\n  }\n}\n\n/** Generate unique request ID */\nexport function generateRequestId(): string {\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;\n}\n\n// Built-in interceptors\n\n/** Logging interceptor */\nexport function createLoggingInterceptor(\n  logger: {\n    debug?(msg: string, data?: unknown): void;\n    info?(msg: string, data?: unknown): void;\n    error?(msg: string, data?: unknown): void;\n  } = console,\n): Interceptor {\n  return {\n    onRequest(ctx) {\n      logger.debug?.(\n        `[${ctx.requestId}] ${ctx.request.method ?? \"GET\"} ${ctx.request.path}`,\n        {\n          attempt: ctx.attempt,\n        },\n      );\n      return ctx;\n    },\n    onResponse(ctx) {\n      logger.info?.(\n        `[${ctx.request.requestId}] ${ctx.request.request.method ?? \"GET\"} ${ctx.request.request.path} ${ctx.status ?? 200} (${ctx.durationMs}ms)`,\n      );\n      return ctx.data;\n    },\n    onError(ctx) {\n      logger.error?.(\n        `[${ctx.request.requestId}] ${ctx.request.request.method ?? \"GET\"} ${ctx.request.request.path} ${ctx.error.code} (${ctx.durationMs}ms)`,\n        {\n          error: ctx.error.message,\n        },\n      );\n    },\n  };\n}\n\n/** Metrics interceptor */\nexport function createMetricsInterceptor(\n  onMetric: (metric: {\n    path: string;\n    method: string;\n    status: \"success\" | \"error\";\n    durationMs: number;\n    errorCode?: string;\n  }) => void,\n): Interceptor {\n  return {\n    onResponse(ctx) {\n      onMetric({\n        path: ctx.request.request.path,\n        method: ctx.request.request.method ?? \"GET\",\n        status: \"success\",\n        durationMs: ctx.durationMs,\n      });\n      return ctx.data;\n    },\n    onError(ctx) {\n      onMetric({\n        path: ctx.request.request.path,\n        method: ctx.request.request.method ?? \"GET\",\n        status: \"error\",\n        durationMs: ctx.durationMs,\n        errorCode: ctx.error.code,\n      });\n    },\n  };\n}\n\n/** Header injection interceptor */\nexport function createHeaderInterceptor(\n  headers:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>),\n): Interceptor {\n  return {\n    async onRequest(ctx) {\n      const h = typeof headers === \"function\" ? await headers() : headers;\n      return {\n        ...ctx,\n        request: {\n          ...ctx.request,\n          headers: { ...ctx.request.headers, ...h },\n        },\n      };\n    },\n  };\n}\n","/**\n * Offline Storage Abstraction\n *\n * Platform-agnostic storage interface with implementations for different environments.\n */\n\n/** Storage interface */\nexport interface Storage {\n  get<T>(key: string): Promise<T | null>;\n  set<T>(key: string, value: T): Promise<void>;\n  delete(key: string): Promise<void>;\n  clear(): Promise<void>;\n  keys(): Promise<string[]>;\n}\n\n/** In-memory storage (default fallback) */\nexport class MemoryStorage implements Storage {\n  private data = new Map<string, string>();\n\n  async get<T>(key: string): Promise<T | null> {\n    const value = this.data.get(key);\n    if (!value) return null;\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    this.data.set(key, JSON.stringify(value));\n  }\n\n  async delete(key: string): Promise<void> {\n    this.data.delete(key);\n  }\n\n  async clear(): Promise<void> {\n    this.data.clear();\n  }\n\n  async keys(): Promise<string[]> {\n    return Array.from(this.data.keys());\n  }\n}\n\n/** Browser localStorage wrapper */\nexport class LocalStorage implements Storage {\n  constructor(private prefix = \"sdk_\") {}\n\n  private key(k: string): string {\n    return `${this.prefix}${k}`;\n  }\n\n  async get<T>(key: string): Promise<T | null> {\n    if (typeof localStorage === \"undefined\") return null;\n    const value = localStorage.getItem(this.key(key));\n    if (!value) return null;\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    localStorage.setItem(this.key(key), JSON.stringify(value));\n  }\n\n  async delete(key: string): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    localStorage.removeItem(this.key(key));\n  }\n\n  async clear(): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    const keys = await this.keys();\n    for (const key of keys) {\n      localStorage.removeItem(this.key(key));\n    }\n  }\n\n  async keys(): Promise<string[]> {\n    if (typeof localStorage === \"undefined\") return [];\n    const result: string[] = [];\n    for (let i = 0; i < localStorage.length; i++) {\n      const key = localStorage.key(i);\n      if (key?.startsWith(this.prefix)) {\n        result.push(key.slice(this.prefix.length));\n      }\n    }\n    return result;\n  }\n}\n\n/** Offline request queue */\nexport interface QueuedRequest {\n  id: string;\n  path: string;\n  method: string;\n  body?: unknown;\n  headers?: Record<string, string>;\n  createdAt: number;\n  attempts: number;\n  idempotencyKey?: string;\n}\n\n/** Offline queue manager */\nexport class OfflineQueue {\n  private readonly storageKey = \"offline_queue\";\n\n  constructor(private storage: Storage) {}\n\n  /** Add request to queue */\n  async enqueue(\n    request: Omit<QueuedRequest, \"id\" | \"createdAt\" | \"attempts\">,\n  ): Promise<string> {\n    const queue = await this.getQueue();\n    const id = `req_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;\n\n    queue.push({\n      ...request,\n      id,\n      createdAt: Date.now(),\n      attempts: 0,\n    });\n\n    await this.storage.set(this.storageKey, queue);\n    return id;\n  }\n\n  /** Get all queued requests */\n  async getQueue(): Promise<QueuedRequest[]> {\n    return (await this.storage.get<QueuedRequest[]>(this.storageKey)) ?? [];\n  }\n\n  /** Get next request to process */\n  async peek(): Promise<QueuedRequest | null> {\n    const queue = await this.getQueue();\n    return queue[0] ?? null;\n  }\n\n  /** Remove request from queue */\n  async dequeue(id: string): Promise<void> {\n    const queue = await this.getQueue();\n    const filtered = queue.filter((r) => r.id !== id);\n    await this.storage.set(this.storageKey, filtered);\n  }\n\n  /** Increment attempt count */\n  async incrementAttempts(id: string): Promise<void> {\n    const queue = await this.getQueue();\n    const request = queue.find((r) => r.id === id);\n    if (request) {\n      request.attempts++;\n      await this.storage.set(this.storageKey, queue);\n    }\n  }\n\n  /** Get queue size */\n  async size(): Promise<number> {\n    const queue = await this.getQueue();\n    return queue.length;\n  }\n\n  /** Clear queue */\n  async clear(): Promise<void> {\n    await this.storage.delete(this.storageKey);\n  }\n\n  /** Process queue with handler */\n  async process(\n    handler: (request: QueuedRequest) => Promise<boolean>,\n    options?: { maxAttempts?: number; batchSize?: number },\n  ): Promise<{ processed: number; failed: number }> {\n    const maxAttempts = options?.maxAttempts ?? 3;\n    const batchSize = options?.batchSize ?? 10;\n\n    const queue = await this.getQueue();\n    let processed = 0;\n    let failed = 0;\n\n    for (let i = 0; i < Math.min(queue.length, batchSize); i++) {\n      const request = queue[i];\n\n      if (request.attempts >= maxAttempts) {\n        await this.dequeue(request.id);\n        failed++;\n        continue;\n      }\n\n      try {\n        const success = await handler(request);\n        if (success) {\n          await this.dequeue(request.id);\n          processed++;\n        } else {\n          await this.incrementAttempts(request.id);\n        }\n      } catch {\n        await this.incrementAttempts(request.id);\n      }\n    }\n\n    return { processed, failed };\n  }\n}\n\n/** Detect available storage */\nexport function detectStorage(): Storage {\n  // Browser with localStorage\n  if (typeof localStorage !== \"undefined\") {\n    return new LocalStorage();\n  }\n\n  // Fallback to memory\n  return new MemoryStorage();\n}\n","/**\n * Platform Abstraction Layer\n *\n * Interfaces and adapters that enable the SDK to run across\n * mobile, desktop, TUI, and web without vendor lock-in.\n *\n * Each platform provides its own implementations:\n * - Web: localStorage, navigator.onLine, fetch\n * - React Native: AsyncStorage, NetInfo, fetch polyfill\n * - Electron: electron-store, net module, node-fetch\n * - Tauri: tauri-plugin-store, tauri events, fetch\n * - Node/TUI: fs-based, always online, node-fetch\n */\n\nimport { detectStorage, type Storage } from \"../storage/index.js\";\n\n/**\n * Secure credential storage interface.\n * Implementations should use platform-specific secure storage:\n * - Web: Encrypted localStorage or IndexedDB\n * - React Native: react-native-keychain\n * - Electron: safeStorage + electron-store\n * - Tauri: tauri-plugin-keyring\n * - Node: keytar or encrypted file\n */\nexport interface SecureStorage {\n  /** Store a credential securely */\n  setCredential(key: string, value: string): Promise<void>;\n  /** Retrieve a credential */\n  getCredential(key: string): Promise<string | null>;\n  /** Delete a credential */\n  deleteCredential(key: string): Promise<void>;\n  /** Check if secure storage is available */\n  isAvailable(): Promise<boolean>;\n}\n\n/**\n * Network connectivity information.\n * Implementations should use platform-specific APIs:\n * - Web: navigator.onLine + online/offline events\n * - React Native: @react-native-community/netinfo\n * - Electron: net.online\n * - Tauri: network events\n * - Node/TUI: assume online or use dns lookup\n */\nexport interface NetworkInfo {\n  /** Check if device is online */\n  isOnline(): boolean;\n  /** Subscribe to connectivity changes */\n  onConnectivityChange(callback: (online: boolean) => void): () => void;\n  /** Get connection quality hint (optional) */\n  getConnectionType?(): \"wifi\" | \"cellular\" | \"ethernet\" | \"unknown\";\n}\n\n/**\n * State persistence adapter for cross-session state.\n * Handles syncing SDK state (sessions, queued requests, cache)\n * to platform-appropriate storage.\n */\nexport interface PersistenceAdapter {\n  /** Save state snapshot */\n  saveState<T>(namespace: string, state: T): Promise<void>;\n  /** Load state snapshot */\n  loadState<T>(namespace: string): Promise<T | null>;\n  /** Clear namespace */\n  clearState(namespace: string): Promise<void>;\n  /** Subscribe to external state changes (for multi-window/tab sync) */\n  onExternalChange?(\n    namespace: string,\n    callback: (state: unknown) => void,\n  ): () => void;\n}\n\n/**\n * Platform capabilities descriptor.\n * Used to adapt SDK behavior to platform constraints.\n */\nexport interface PlatformCapabilities {\n  /** Platform identifier */\n  platform: \"web\" | \"react-native\" | \"electron\" | \"tauri\" | \"node\";\n  /** Supports background execution */\n  supportsBackground: boolean;\n  /** Supports secure credential storage */\n  supportsSecureStorage: boolean;\n  /** Supports WebSocket */\n  supportsWebSocket: boolean;\n  /** Supports SSE (EventSource) */\n  supportsSSE: boolean;\n  /** Max concurrent connections (browser limits) */\n  maxConnections?: number;\n}\n\n/**\n * Platform adapter combining all platform-specific interfaces.\n * Each platform provides one implementation of this interface.\n */\nexport interface PlatformAdapter {\n  /** Platform capabilities */\n  capabilities: PlatformCapabilities;\n  /** General key-value storage */\n  storage: Storage;\n  /** Secure credential storage (optional) */\n  secureStorage?: SecureStorage;\n  /** Network info (optional) */\n  network?: NetworkInfo;\n  /** State persistence (optional) */\n  persistence?: PersistenceAdapter;\n  /** Fetch implementation */\n  fetch: typeof fetch;\n}\n\n// ============================================================================\n// Default Implementations\n// ============================================================================\n\n/**\n * In-memory secure storage fallback.\n * NOT SECURE - use only for development/testing.\n */\nexport class MemorySecureStorage implements SecureStorage {\n  private credentials = new Map<string, string>();\n\n  async setCredential(key: string, value: string): Promise<void> {\n    this.credentials.set(key, value);\n  }\n\n  async getCredential(key: string): Promise<string | null> {\n    return this.credentials.get(key) ?? null;\n  }\n\n  async deleteCredential(key: string): Promise<void> {\n    this.credentials.delete(key);\n  }\n\n  async isAvailable(): Promise<boolean> {\n    return true;\n  }\n}\n\n/**\n * Browser-based network info using navigator.onLine.\n */\nexport class BrowserNetworkInfo implements NetworkInfo {\n  isOnline(): boolean {\n    return typeof navigator !== \"undefined\" ? navigator.onLine : true;\n  }\n\n  onConnectivityChange(callback: (online: boolean) => void): () => void {\n    if (typeof window === \"undefined\") {\n      return () => {};\n    }\n\n    const onOnline = () => callback(true);\n    const onOffline = () => callback(false);\n\n    window.addEventListener(\"online\", onOnline);\n    window.addEventListener(\"offline\", onOffline);\n\n    return () => {\n      window.removeEventListener(\"online\", onOnline);\n      window.removeEventListener(\"offline\", onOffline);\n    };\n  }\n\n  getConnectionType(): \"wifi\" | \"cellular\" | \"ethernet\" | \"unknown\" {\n    // Use Network Information API if available\n    const nav = navigator as Navigator & {\n      connection?: { effectiveType?: string; type?: string };\n    };\n    if (nav.connection?.type) {\n      const type = nav.connection.type;\n      if (type === \"wifi\") return \"wifi\";\n      if (type === \"cellular\") return \"cellular\";\n      if (type === \"ethernet\") return \"ethernet\";\n    }\n    return \"unknown\";\n  }\n}\n\n/**\n * Node.js network info (assumes always online).\n */\nexport class NodeNetworkInfo implements NetworkInfo {\n  isOnline(): boolean {\n    return true;\n  }\n\n  onConnectivityChange(_callback: (online: boolean) => void): () => void {\n    // Node doesn't have native connectivity events\n    return () => {};\n  }\n}\n\n/**\n * Storage-based persistence adapter.\n * Uses provided Storage implementation for state persistence.\n */\nexport class StoragePersistence implements PersistenceAdapter {\n  constructor(private storage: Storage) {}\n\n  async saveState<T>(namespace: string, state: T): Promise<void> {\n    await this.storage.set(`state:${namespace}`, state);\n  }\n\n  async loadState<T>(namespace: string): Promise<T | null> {\n    return this.storage.get<T>(`state:${namespace}`);\n  }\n\n  async clearState(namespace: string): Promise<void> {\n    await this.storage.delete(`state:${namespace}`);\n  }\n}\n\n/**\n * Browser persistence with localStorage and storage events for tab sync.\n */\nexport class BrowserPersistence implements PersistenceAdapter {\n  private prefix: string;\n\n  constructor(prefix = \"sdk_state:\") {\n    this.prefix = prefix;\n  }\n\n  async saveState<T>(namespace: string, state: T): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    localStorage.setItem(`${this.prefix}${namespace}`, JSON.stringify(state));\n  }\n\n  async loadState<T>(namespace: string): Promise<T | null> {\n    if (typeof localStorage === \"undefined\") return null;\n    const value = localStorage.getItem(`${this.prefix}${namespace}`);\n    if (!value) return null;\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async clearState(namespace: string): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    localStorage.removeItem(`${this.prefix}${namespace}`);\n  }\n\n  onExternalChange(\n    namespace: string,\n    callback: (state: unknown) => void,\n  ): () => void {\n    if (typeof window === \"undefined\") {\n      return () => {};\n    }\n\n    const key = `${this.prefix}${namespace}`;\n    const handler = (event: StorageEvent) => {\n      if (event.key === key && event.newValue) {\n        try {\n          callback(JSON.parse(event.newValue));\n        } catch {\n          // Ignore parse errors\n        }\n      }\n    };\n\n    window.addEventListener(\"storage\", handler);\n    return () => window.removeEventListener(\"storage\", handler);\n  }\n}\n\n// ============================================================================\n// Platform Detection and Default Adapter\n// ============================================================================\n\n/**\n * Detect current platform.\n */\nexport function detectPlatform(): PlatformCapabilities[\"platform\"] {\n  // Check for Tauri\n  if (\n    typeof window !== \"undefined\" &&\n    \"__TAURI__\" in (window as unknown as Record<string, unknown>)\n  ) {\n    return \"tauri\";\n  }\n\n  // Check for Electron\n  if (\n    typeof process !== \"undefined\" &&\n    process.versions &&\n    \"electron\" in process.versions\n  ) {\n    return \"electron\";\n  }\n\n  // Check for React Native\n  if (typeof navigator !== \"undefined\" && navigator.product === \"ReactNative\") {\n    return \"react-native\";\n  }\n\n  // Check for browser\n  if (typeof window !== \"undefined\" && typeof document !== \"undefined\") {\n    return \"web\";\n  }\n\n  // Default to Node\n  return \"node\";\n}\n\n/**\n * Create default platform adapter for current environment.\n * Override with platform-specific implementations for better integration.\n */\nexport function createDefaultPlatformAdapter(): PlatformAdapter {\n  const platform = detectPlatform();\n  const isBrowser = platform === \"web\" || platform === \"tauri\";\n  const storage = detectStorage();\n\n  const capabilities: PlatformCapabilities = {\n    platform,\n    supportsBackground: platform === \"node\" || platform === \"electron\",\n    supportsSecureStorage: false, // Requires platform-specific impl\n    supportsWebSocket: true,\n    supportsSSE: true,\n    maxConnections: isBrowser ? 6 : undefined,\n  };\n\n  return {\n    capabilities,\n    storage,\n    secureStorage: new MemorySecureStorage(), // Fallback, not secure\n    network: isBrowser ? new BrowserNetworkInfo() : new NodeNetworkInfo(),\n    persistence: isBrowser\n      ? new BrowserPersistence()\n      : new StoragePersistence(storage),\n    fetch: globalThis.fetch.bind(globalThis),\n  };\n}\n\n/**\n * Type-safe platform adapter factory.\n * Use this to create platform adapters with proper typing.\n */\nexport function createPlatformAdapter(\n  config: Partial<PlatformAdapter> & { capabilities: PlatformCapabilities },\n): PlatformAdapter {\n  const defaults = createDefaultPlatformAdapter();\n  return {\n    ...defaults,\n    ...config,\n  };\n}\n","/**\n * Request Retry Logic\n *\n * Per-request retry with exponential backoff and idempotency.\n */\n\nimport { isRetryable, SDKError } from \"../errors/index.js\";\nimport { sleep } from \"../resilience/timeout.js\";\n\n/** Retry configuration */\nexport interface RetryConfig {\n  /** Max retry attempts (default: 3) */\n  maxAttempts?: number;\n  /** Initial delay in ms (default: 1000) */\n  initialDelayMs?: number;\n  /** Max delay in ms (default: 30000) */\n  maxDelayMs?: number;\n  /** Backoff multiplier (default: 2) */\n  multiplier?: number;\n  /** Jitter factor 0-1 (default: 0.2) */\n  jitter?: number;\n  /** Custom retry predicate */\n  shouldRetry?: (error: SDKError, attempt: number) => boolean;\n  /** Callback before retry */\n  onRetry?: (error: SDKError, attempt: number, delayMs: number) => void;\n  /** Cancels pending backoff and prevents another attempt. */\n  signal?: AbortSignal;\n}\n\nconst DEFAULT_RETRY_CONFIG: Required<\n  Omit<RetryConfig, \"shouldRetry\" | \"onRetry\" | \"signal\">\n> = {\n  maxAttempts: 3,\n  initialDelayMs: 1000,\n  maxDelayMs: 30000,\n  multiplier: 2,\n  jitter: 0.2,\n};\n\n/** Calculate delay for attempt with jitter */\nexport function calculateDelay(attempt: number, config: RetryConfig): number {\n  const { initialDelayMs, maxDelayMs, multiplier, jitter } = {\n    ...DEFAULT_RETRY_CONFIG,\n    ...config,\n  };\n\n  const baseDelay = Math.min(\n    initialDelayMs * multiplier ** attempt,\n    maxDelayMs,\n  );\n\n  const jitterRange = baseDelay * jitter;\n  const jitterValue = Math.random() * jitterRange * 2 - jitterRange;\n\n  return Math.max(0, Math.floor(baseDelay + jitterValue));\n}\n\n/** Execute function with retry */\nexport async function withRetry<T>(\n  fn: (attempt: number) => Promise<T>,\n  config: RetryConfig = {},\n): Promise<T> {\n  const maxAttempts = config.maxAttempts ?? DEFAULT_RETRY_CONFIG.maxAttempts;\n  let lastError: SDKError | null = null;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    config.signal?.throwIfAborted();\n    try {\n      return await fn(attempt);\n    } catch (error) {\n      config.signal?.throwIfAborted();\n      lastError = SDKError.fromError(error);\n\n      // Check if we should retry\n      const shouldRetry = config.shouldRetry\n        ? config.shouldRetry(lastError, attempt)\n        : isRetryable(lastError);\n\n      if (!shouldRetry || attempt >= maxAttempts - 1) {\n        throw lastError;\n      }\n\n      // Calculate delay (use server's retry-after if provided)\n      const delay = lastError.retryAfterMs ?? calculateDelay(attempt, config);\n\n      config.onRetry?.(lastError, attempt + 1, delay);\n\n      await sleep(delay, config.signal);\n    }\n  }\n\n  throw lastError ?? new SDKError(\"Max retries exceeded\", { code: \"UNKNOWN\" });\n}\n\n/** Idempotency key generator */\nexport function generateIdempotencyKey(): string {\n  return `idem_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/** Retry decorator for class methods */\nexport function Retryable(config: RetryConfig = {}) {\n  return <T>(\n    _target: object,\n    _propertyKey: string,\n    descriptor: TypedPropertyDescriptor<(...args: unknown[]) => Promise<T>>,\n  ): TypedPropertyDescriptor<(...args: unknown[]) => Promise<T>> => {\n    const original = descriptor.value;\n    if (!original) return descriptor;\n\n    descriptor.value = async function (\n      this: unknown,\n      ...args: unknown[]\n    ): Promise<T> {\n      return withRetry((_attempt) => {\n        // Inject attempt count if function accepts it\n        return original.apply(this, args);\n      }, config);\n    };\n\n    return descriptor;\n  };\n}\n","/**\n * Channel Pattern Matching\n *\n * Generic utility for matching channel patterns with wildcard support.\n * Used for channel subscriptions and event filtering.\n *\n * Pattern syntax:\n * - \"*\" matches all channels\n * - \"foo.*\" matches \"foo.bar\", \"foo.baz\", etc. (dot-separated)\n * - \"foo:*\" matches \"foo:bar\", \"foo:baz\", etc. (colon-separated)\n * - \"foo.bar\" matches exactly \"foo.bar\"\n * - \"session:abc\" matches exactly \"session:abc\"\n */\n\n/**\n * Check if a pattern matches a channel name.\n *\n * @param pattern - The pattern to match against (supports wildcards)\n * @param channel - The channel name to check\n * @returns true if the pattern matches the channel\n */\nexport function matchesChannel(pattern: string, channel: string): boolean {\n  // Wildcard matches everything\n  if (pattern === \"*\") {\n    return true;\n  }\n\n  // Prefix wildcard with dot separator: \"foo.*\" matches \"foo.bar\", \"foo.baz\", etc.\n  // Does NOT match the exact prefix (e.g., \"foo.*\" does NOT match \"foo\")\n  if (pattern.endsWith(\".*\")) {\n    const prefix = pattern.slice(0, -2);\n    return channel.startsWith(`${prefix}.`);\n  }\n\n  // Prefix wildcard with colon separator: \"session:*\" matches \"session:abc\", etc.\n  // Used for session/project/agent channel patterns\n  // Does NOT match the exact prefix (e.g., \"session:*\" does NOT match \"session:\")\n  if (pattern.endsWith(\":*\")) {\n    const prefix = pattern.slice(0, -2);\n    return (\n      channel.startsWith(`${prefix}:`) && channel.length > prefix.length + 1\n    );\n  }\n\n  // Exact match\n  return pattern === channel;\n}\n\n/**\n * Check if any subscribed channel pattern matches the given channel.\n *\n * @param subscribedChannels - Set or array of channel patterns\n * @param channel - The channel to check\n * @returns true if any pattern matches the channel\n */\nexport function matchesAnyChannel(\n  subscribedChannels: Set<string> | string[],\n  channel: string,\n): boolean {\n  const patterns = Array.isArray(subscribedChannels)\n    ? subscribedChannels\n    : Array.from(subscribedChannels);\n\n  return patterns.some((pattern) => matchesChannel(pattern, channel));\n}\n","/**\n * Session ID Translator\n *\n * Generic utility for translating session IDs in event objects.\n * Used to map internal session IDs to client-facing session IDs.\n */\n\nexport interface SessionTranslation {\n  /** The internal session ID to replace */\n  from: string;\n  /** The client-facing session ID to use */\n  to: string;\n}\n\n/**\n * Escape special regex characters in a string.\n */\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\n/**\n * Translate session IDs in an event object.\n * Performs a deep string replacement via JSON serialization.\n *\n * @param event - The event object to translate\n * @param translation - The session ID mapping\n * @returns A new event object with translated session IDs\n */\nexport function translateSessionId<T>(\n  event: T,\n  translation: SessionTranslation,\n): T {\n  if (!event || typeof event !== \"object\") {\n    return event;\n  }\n\n  // Skip if from/to are the same\n  if (translation.from === translation.to) {\n    return event;\n  }\n\n  // Skip if from is empty\n  if (!translation.from) {\n    return event;\n  }\n\n  try {\n    const json = JSON.stringify(event);\n\n    // Use global replace to handle multiple occurrences\n    const pattern = new RegExp(escapeRegex(translation.from), \"g\");\n    const translated = json.replace(pattern, translation.to);\n\n    // Only parse if we actually made changes\n    if (translated !== json) {\n      return JSON.parse(translated);\n    }\n\n    return event;\n  } catch {\n    // If serialization fails, return original\n    return event;\n  }\n}\n\n/**\n * Create a reusable translator function for a specific session mapping.\n * Pre-compiles the regex pattern for better performance when translating\n * many events with the same mapping.\n */\nexport function createSessionTranslator(\n  translation: SessionTranslation,\n): <T>(event: T) => T {\n  // Pre-compile the regex for performance\n  const pattern = new RegExp(escapeRegex(translation.from), \"g\");\n\n  return <T>(event: T): T => {\n    if (!event || typeof event !== \"object\") {\n      return event;\n    }\n\n    if (translation.from === translation.to || !translation.from) {\n      return event;\n    }\n\n    try {\n      const json = JSON.stringify(event);\n      const translated = json.replace(pattern, translation.to);\n\n      if (translated !== json) {\n        return JSON.parse(translated);\n      }\n\n      return event;\n    } catch {\n      return event;\n    }\n  };\n}\n\n/**\n * Extract session ID from various event structures.\n * Handles different event formats that may contain session information.\n */\nexport function extractSessionId(event: unknown): string | null {\n  if (!event || typeof event !== \"object\") {\n    return null;\n  }\n\n  const obj = event as Record<string, unknown>;\n\n  // Direct sessionId field\n  if (typeof obj.sessionId === \"string\") {\n    return obj.sessionId;\n  }\n\n  // Nested in properties\n  if (obj.properties && typeof obj.properties === \"object\") {\n    const props = obj.properties as Record<string, unknown>;\n    if (typeof props.sessionId === \"string\") {\n      return props.sessionId;\n    }\n  }\n\n  // Nested in data\n  if (obj.data && typeof obj.data === \"object\") {\n    const data = obj.data as Record<string, unknown>;\n    if (typeof data.sessionId === \"string\") {\n      return data.sessionId;\n    }\n  }\n\n  return null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/cache/index.ts","../src/middleware/index.ts","../src/storage/index.ts","../src/platform/index.ts","../src/retry/index.ts","../src/utils/channel-matching.ts","../src/utils/record.ts","../src/utils/session-translator.ts"],"sourcesContent":["/**\n * Response Caching\n *\n * In-memory cache with TTL and cache-control support.\n */\n\n/** Cache entry */\ninterface CacheEntry<T> {\n  data: T;\n  cachedAt: number;\n  expiresAt: number;\n  etag?: string;\n}\n\n/** Cache configuration */\nexport interface CacheConfig {\n  /** Default TTL in ms (default: 60000 = 1 minute) */\n  defaultTtlMs?: number;\n  /** Max entries (default: 1000) */\n  maxEntries?: number;\n  /** Cache key generator */\n  keyGenerator?: (path: string, params?: Record<string, unknown>) => string;\n}\n\n/** Cache interface for different storage backends */\nexport interface CacheStorage<T = unknown> {\n  get(key: string): T | undefined | Promise<T | undefined>;\n  set(key: string, value: T, ttlMs?: number): void | Promise<void>;\n  delete(key: string): void | Promise<void>;\n  clear(): void | Promise<void>;\n}\n\n/** In-memory LRU cache */\nexport class MemoryCache<T = unknown> implements CacheStorage<CacheEntry<T>> {\n  private cache = new Map<string, CacheEntry<T>>();\n  private readonly maxEntries: number;\n\n  constructor(maxEntries = 1000) {\n    this.maxEntries = maxEntries;\n  }\n\n  get(key: string): CacheEntry<T> | undefined {\n    const entry = this.cache.get(key);\n    if (!entry) return undefined;\n\n    // Check expiration\n    if (Date.now() > entry.expiresAt) {\n      this.cache.delete(key);\n      return undefined;\n    }\n\n    // Move to end (most recently used)\n    this.cache.delete(key);\n    this.cache.set(key, entry);\n\n    return entry;\n  }\n\n  set(key: string, value: CacheEntry<T>): void {\n    // Evict oldest if at capacity\n    if (this.cache.size >= this.maxEntries) {\n      const oldest = this.cache.keys().next().value;\n      if (oldest) this.cache.delete(oldest);\n    }\n\n    this.cache.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.cache.delete(key);\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /** Get cache stats */\n  stats(): { size: number; maxEntries: number } {\n    return { size: this.cache.size, maxEntries: this.maxEntries };\n  }\n}\n\n/** Response cache manager */\nexport class ResponseCache<T = unknown> {\n  private storage: CacheStorage<CacheEntry<T>>;\n  private defaultTtlMs: number;\n  private keyGenerator: (\n    path: string,\n    params?: Record<string, unknown>,\n  ) => string;\n\n  constructor(config: CacheConfig = {}) {\n    this.storage = new MemoryCache<T>(config.maxEntries);\n    this.defaultTtlMs = config.defaultTtlMs ?? 60000;\n    this.keyGenerator = config.keyGenerator ?? this.defaultKeyGenerator;\n  }\n\n  private defaultKeyGenerator(\n    path: string,\n    params?: Record<string, unknown>,\n  ): string {\n    if (!params || Object.keys(params).length === 0) return path;\n    const sorted = Object.keys(params).sort();\n    const qs = sorted.map((k) => `${k}=${JSON.stringify(params[k])}`).join(\"&\");\n    return `${path}?${qs}`;\n  }\n\n  /** Get cached response */\n  async get(\n    path: string,\n    params?: Record<string, unknown>,\n  ): Promise<T | undefined> {\n    const key = this.keyGenerator(path, params);\n    const entry = await this.storage.get(key);\n    return entry?.data;\n  }\n\n  /** Get with stale-while-revalidate support */\n  async getWithMeta(\n    path: string,\n    params?: Record<string, unknown>,\n  ): Promise<{ data: T; stale: boolean; etag?: string } | undefined> {\n    const key = this.keyGenerator(path, params);\n    const entry = await this.storage.get(key);\n\n    if (!entry) return undefined;\n\n    const now = Date.now();\n    const stale = now > entry.expiresAt;\n\n    return { data: entry.data, stale, etag: entry.etag };\n  }\n\n  /** Cache response */\n  async set(\n    path: string,\n    data: T,\n    options?: {\n      params?: Record<string, unknown>;\n      ttlMs?: number;\n      etag?: string;\n    },\n  ): Promise<void> {\n    const key = this.keyGenerator(path, options?.params);\n    const now = Date.now();\n    const ttl = options?.ttlMs ?? this.defaultTtlMs;\n\n    await this.storage.set(key, {\n      data,\n      cachedAt: now,\n      expiresAt: now + ttl,\n      etag: options?.etag,\n    });\n  }\n\n  /** Invalidate cache entry */\n  async invalidate(\n    path: string,\n    params?: Record<string, unknown>,\n  ): Promise<void> {\n    const key = this.keyGenerator(path, params);\n    await this.storage.delete(key);\n  }\n\n  /** Invalidate all entries matching prefix */\n  async invalidatePrefix(_prefix: string): Promise<void> {\n    // Only works with MemoryCache\n    if (this.storage instanceof MemoryCache) {\n      // Need to iterate - not ideal but works for in-memory\n      const cache = this.storage as MemoryCache<T>;\n      // Can't iterate Map while modifying, so just clear for now\n      cache.clear();\n    }\n  }\n\n  /** Clear entire cache */\n  async clear(): Promise<void> {\n    await this.storage.clear();\n  }\n\n  /** Parse Cache-Control header */\n  static parseCacheControl(header: string): {\n    maxAge?: number;\n    noCache?: boolean;\n    noStore?: boolean;\n  } {\n    const result: { maxAge?: number; noCache?: boolean; noStore?: boolean } =\n      {};\n\n    const parts = header.split(\",\").map((p) => p.trim().toLowerCase());\n\n    for (const part of parts) {\n      if (part === \"no-cache\") result.noCache = true;\n      if (part === \"no-store\") result.noStore = true;\n      if (part.startsWith(\"max-age=\")) {\n        const age = Number.parseInt(part.slice(8), 10);\n        if (!Number.isNaN(age)) result.maxAge = age * 1000; // Convert to ms\n      }\n    }\n\n    return result;\n  }\n}\n","/**\n * Request/Response Interceptors\n *\n * Middleware for modifying requests, responses, and handling errors.\n */\n\nimport type { SDKError } from \"../errors/index.js\";\nimport type { RequestOptions } from \"../transport/types.js\";\n\n/** Request context passed through interceptor chain */\nexport interface RequestContext {\n  /** Original request options */\n  request: RequestOptions;\n  /** Request start time */\n  startedAt: number;\n  /** Unique request ID */\n  requestId: string;\n  /** Retry attempt number (0 = first attempt) */\n  attempt: number;\n  /** Custom metadata */\n  meta: Record<string, unknown>;\n}\n\n/** Response context */\nexport interface ResponseContext<T = unknown> {\n  /** Request context */\n  request: RequestContext;\n  /** Response data */\n  data: T;\n  /** Response time in ms */\n  durationMs: number;\n  /** HTTP status (if available) */\n  status?: number;\n}\n\n/** Error context */\nexport interface ErrorContext {\n  /** Request context */\n  request: RequestContext;\n  /** The error */\n  error: SDKError;\n  /** Duration before error */\n  durationMs: number;\n}\n\n/** Interceptor interface */\nexport interface Interceptor {\n  /** Modify request before sending */\n  onRequest?(ctx: RequestContext): RequestContext | Promise<RequestContext>;\n  /** Process successful response */\n  onResponse?<T>(ctx: ResponseContext<T>): T | Promise<T>;\n  /** Handle error (can transform or rethrow) */\n  onError?(ctx: ErrorContext): void | Promise<void>;\n}\n\n/** Interceptor chain executor */\nexport class InterceptorChain {\n  private interceptors: Interceptor[] = [];\n\n  /** Add interceptor to chain */\n  use(interceptor: Interceptor): this {\n    this.interceptors.push(interceptor);\n    return this;\n  }\n\n  /** Remove interceptor */\n  remove(interceptor: Interceptor): this {\n    const idx = this.interceptors.indexOf(interceptor);\n    if (idx >= 0) this.interceptors.splice(idx, 1);\n    return this;\n  }\n\n  /** Run request through interceptors */\n  async executeRequest(ctx: RequestContext): Promise<RequestContext> {\n    let current = ctx;\n    for (const interceptor of this.interceptors) {\n      if (interceptor.onRequest) {\n        current = await interceptor.onRequest(current);\n      }\n    }\n    return current;\n  }\n\n  /** Run response through interceptors (reverse order) */\n  async executeResponse<T>(ctx: ResponseContext<T>): Promise<T> {\n    let data = ctx.data;\n    for (let i = this.interceptors.length - 1; i >= 0; i--) {\n      const interceptor = this.interceptors[i];\n      if (interceptor.onResponse) {\n        data = await interceptor.onResponse({ ...ctx, data });\n      }\n    }\n    return data;\n  }\n\n  /** Notify interceptors of error */\n  async executeError(ctx: ErrorContext): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.onError) {\n        await interceptor.onError(ctx);\n      }\n    }\n  }\n}\n\n/** Generate unique request ID */\nexport function generateRequestId(): string {\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;\n}\n\n// Built-in interceptors\n\n/** Logging interceptor */\nexport function createLoggingInterceptor(\n  logger: {\n    debug?(msg: string, data?: unknown): void;\n    info?(msg: string, data?: unknown): void;\n    error?(msg: string, data?: unknown): void;\n  } = console,\n): Interceptor {\n  return {\n    onRequest(ctx) {\n      logger.debug?.(\n        `[${ctx.requestId}] ${ctx.request.method ?? \"GET\"} ${ctx.request.path}`,\n        {\n          attempt: ctx.attempt,\n        },\n      );\n      return ctx;\n    },\n    onResponse(ctx) {\n      logger.info?.(\n        `[${ctx.request.requestId}] ${ctx.request.request.method ?? \"GET\"} ${ctx.request.request.path} ${ctx.status ?? 200} (${ctx.durationMs}ms)`,\n      );\n      return ctx.data;\n    },\n    onError(ctx) {\n      logger.error?.(\n        `[${ctx.request.requestId}] ${ctx.request.request.method ?? \"GET\"} ${ctx.request.request.path} ${ctx.error.code} (${ctx.durationMs}ms)`,\n        {\n          error: ctx.error.message,\n        },\n      );\n    },\n  };\n}\n\n/** Metrics interceptor */\nexport function createMetricsInterceptor(\n  onMetric: (metric: {\n    path: string;\n    method: string;\n    status: \"success\" | \"error\";\n    durationMs: number;\n    errorCode?: string;\n  }) => void,\n): Interceptor {\n  return {\n    onResponse(ctx) {\n      onMetric({\n        path: ctx.request.request.path,\n        method: ctx.request.request.method ?? \"GET\",\n        status: \"success\",\n        durationMs: ctx.durationMs,\n      });\n      return ctx.data;\n    },\n    onError(ctx) {\n      onMetric({\n        path: ctx.request.request.path,\n        method: ctx.request.request.method ?? \"GET\",\n        status: \"error\",\n        durationMs: ctx.durationMs,\n        errorCode: ctx.error.code,\n      });\n    },\n  };\n}\n\n/** Header injection interceptor */\nexport function createHeaderInterceptor(\n  headers:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>),\n): Interceptor {\n  return {\n    async onRequest(ctx) {\n      const h = typeof headers === \"function\" ? await headers() : headers;\n      return {\n        ...ctx,\n        request: {\n          ...ctx.request,\n          headers: { ...ctx.request.headers, ...h },\n        },\n      };\n    },\n  };\n}\n","/**\n * Offline Storage Abstraction\n *\n * Platform-agnostic storage interface with implementations for different environments.\n */\n\n/** Storage interface */\nexport interface Storage {\n  get<T>(key: string): Promise<T | null>;\n  set<T>(key: string, value: T): Promise<void>;\n  delete(key: string): Promise<void>;\n  clear(): Promise<void>;\n  keys(): Promise<string[]>;\n}\n\n/** In-memory storage (default fallback) */\nexport class MemoryStorage implements Storage {\n  private data = new Map<string, string>();\n\n  async get<T>(key: string): Promise<T | null> {\n    const value = this.data.get(key);\n    if (!value) return null;\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    this.data.set(key, JSON.stringify(value));\n  }\n\n  async delete(key: string): Promise<void> {\n    this.data.delete(key);\n  }\n\n  async clear(): Promise<void> {\n    this.data.clear();\n  }\n\n  async keys(): Promise<string[]> {\n    return Array.from(this.data.keys());\n  }\n}\n\n/** Browser localStorage wrapper */\nexport class LocalStorage implements Storage {\n  constructor(private prefix = \"sdk_\") {}\n\n  private key(k: string): string {\n    return `${this.prefix}${k}`;\n  }\n\n  async get<T>(key: string): Promise<T | null> {\n    if (typeof localStorage === \"undefined\") return null;\n    const value = localStorage.getItem(this.key(key));\n    if (!value) return null;\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    localStorage.setItem(this.key(key), JSON.stringify(value));\n  }\n\n  async delete(key: string): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    localStorage.removeItem(this.key(key));\n  }\n\n  async clear(): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    const keys = await this.keys();\n    for (const key of keys) {\n      localStorage.removeItem(this.key(key));\n    }\n  }\n\n  async keys(): Promise<string[]> {\n    if (typeof localStorage === \"undefined\") return [];\n    const result: string[] = [];\n    for (let i = 0; i < localStorage.length; i++) {\n      const key = localStorage.key(i);\n      if (key?.startsWith(this.prefix)) {\n        result.push(key.slice(this.prefix.length));\n      }\n    }\n    return result;\n  }\n}\n\n/** Offline request queue */\nexport interface QueuedRequest {\n  id: string;\n  path: string;\n  method: string;\n  body?: unknown;\n  headers?: Record<string, string>;\n  createdAt: number;\n  attempts: number;\n  idempotencyKey?: string;\n}\n\n/** Offline queue manager */\nexport class OfflineQueue {\n  private readonly storageKey = \"offline_queue\";\n\n  constructor(private storage: Storage) {}\n\n  /** Add request to queue */\n  async enqueue(\n    request: Omit<QueuedRequest, \"id\" | \"createdAt\" | \"attempts\">,\n  ): Promise<string> {\n    const queue = await this.getQueue();\n    const id = `req_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;\n\n    queue.push({\n      ...request,\n      id,\n      createdAt: Date.now(),\n      attempts: 0,\n    });\n\n    await this.storage.set(this.storageKey, queue);\n    return id;\n  }\n\n  /** Get all queued requests */\n  async getQueue(): Promise<QueuedRequest[]> {\n    return (await this.storage.get<QueuedRequest[]>(this.storageKey)) ?? [];\n  }\n\n  /** Get next request to process */\n  async peek(): Promise<QueuedRequest | null> {\n    const queue = await this.getQueue();\n    return queue[0] ?? null;\n  }\n\n  /** Remove request from queue */\n  async dequeue(id: string): Promise<void> {\n    const queue = await this.getQueue();\n    const filtered = queue.filter((r) => r.id !== id);\n    await this.storage.set(this.storageKey, filtered);\n  }\n\n  /** Increment attempt count */\n  async incrementAttempts(id: string): Promise<void> {\n    const queue = await this.getQueue();\n    const request = queue.find((r) => r.id === id);\n    if (request) {\n      request.attempts++;\n      await this.storage.set(this.storageKey, queue);\n    }\n  }\n\n  /** Get queue size */\n  async size(): Promise<number> {\n    const queue = await this.getQueue();\n    return queue.length;\n  }\n\n  /** Clear queue */\n  async clear(): Promise<void> {\n    await this.storage.delete(this.storageKey);\n  }\n\n  /** Process queue with handler */\n  async process(\n    handler: (request: QueuedRequest) => Promise<boolean>,\n    options?: { maxAttempts?: number; batchSize?: number },\n  ): Promise<{ processed: number; failed: number }> {\n    const maxAttempts = options?.maxAttempts ?? 3;\n    const batchSize = options?.batchSize ?? 10;\n\n    const queue = await this.getQueue();\n    let processed = 0;\n    let failed = 0;\n\n    for (let i = 0; i < Math.min(queue.length, batchSize); i++) {\n      const request = queue[i];\n\n      if (request.attempts >= maxAttempts) {\n        await this.dequeue(request.id);\n        failed++;\n        continue;\n      }\n\n      try {\n        const success = await handler(request);\n        if (success) {\n          await this.dequeue(request.id);\n          processed++;\n        } else {\n          await this.incrementAttempts(request.id);\n        }\n      } catch {\n        await this.incrementAttempts(request.id);\n      }\n    }\n\n    return { processed, failed };\n  }\n}\n\n/** Detect available storage */\nexport function detectStorage(): Storage {\n  // Browser with localStorage\n  if (typeof localStorage !== \"undefined\") {\n    return new LocalStorage();\n  }\n\n  // Fallback to memory\n  return new MemoryStorage();\n}\n","/**\n * Platform Abstraction Layer\n *\n * Interfaces and adapters that enable the SDK to run across\n * mobile, desktop, TUI, and web without vendor lock-in.\n *\n * Each platform provides its own implementations:\n * - Web: localStorage, navigator.onLine, fetch\n * - React Native: AsyncStorage, NetInfo, fetch polyfill\n * - Electron: electron-store, net module, node-fetch\n * - Tauri: tauri-plugin-store, tauri events, fetch\n * - Node/TUI: fs-based, always online, node-fetch\n */\n\nimport { detectStorage, type Storage } from \"../storage/index.js\";\n\n/**\n * Secure credential storage interface.\n * Implementations should use platform-specific secure storage:\n * - Web: Encrypted localStorage or IndexedDB\n * - React Native: react-native-keychain\n * - Electron: safeStorage + electron-store\n * - Tauri: tauri-plugin-keyring\n * - Node: keytar or encrypted file\n */\nexport interface SecureStorage {\n  /** Store a credential securely */\n  setCredential(key: string, value: string): Promise<void>;\n  /** Retrieve a credential */\n  getCredential(key: string): Promise<string | null>;\n  /** Delete a credential */\n  deleteCredential(key: string): Promise<void>;\n  /** Check if secure storage is available */\n  isAvailable(): Promise<boolean>;\n}\n\n/**\n * Network connectivity information.\n * Implementations should use platform-specific APIs:\n * - Web: navigator.onLine + online/offline events\n * - React Native: @react-native-community/netinfo\n * - Electron: net.online\n * - Tauri: network events\n * - Node/TUI: assume online or use dns lookup\n */\nexport interface NetworkInfo {\n  /** Check if device is online */\n  isOnline(): boolean;\n  /** Subscribe to connectivity changes */\n  onConnectivityChange(callback: (online: boolean) => void): () => void;\n  /** Get connection quality hint (optional) */\n  getConnectionType?(): \"wifi\" | \"cellular\" | \"ethernet\" | \"unknown\";\n}\n\n/**\n * State persistence adapter for cross-session state.\n * Handles syncing SDK state (sessions, queued requests, cache)\n * to platform-appropriate storage.\n */\nexport interface PersistenceAdapter {\n  /** Save state snapshot */\n  saveState<T>(namespace: string, state: T): Promise<void>;\n  /** Load state snapshot */\n  loadState<T>(namespace: string): Promise<T | null>;\n  /** Clear namespace */\n  clearState(namespace: string): Promise<void>;\n  /** Subscribe to external state changes (for multi-window/tab sync) */\n  onExternalChange?(\n    namespace: string,\n    callback: (state: unknown) => void,\n  ): () => void;\n}\n\n/**\n * Platform capabilities descriptor.\n * Used to adapt SDK behavior to platform constraints.\n */\nexport interface PlatformCapabilities {\n  /** Platform identifier */\n  platform: \"web\" | \"react-native\" | \"electron\" | \"tauri\" | \"node\";\n  /** Supports background execution */\n  supportsBackground: boolean;\n  /** Supports secure credential storage */\n  supportsSecureStorage: boolean;\n  /** Supports WebSocket */\n  supportsWebSocket: boolean;\n  /** Supports SSE (EventSource) */\n  supportsSSE: boolean;\n  /** Max concurrent connections (browser limits) */\n  maxConnections?: number;\n}\n\n/**\n * Platform adapter combining all platform-specific interfaces.\n * Each platform provides one implementation of this interface.\n */\nexport interface PlatformAdapter {\n  /** Platform capabilities */\n  capabilities: PlatformCapabilities;\n  /** General key-value storage */\n  storage: Storage;\n  /** Secure credential storage (optional) */\n  secureStorage?: SecureStorage;\n  /** Network info (optional) */\n  network?: NetworkInfo;\n  /** State persistence (optional) */\n  persistence?: PersistenceAdapter;\n  /** Fetch implementation */\n  fetch: typeof fetch;\n}\n\n// ============================================================================\n// Default Implementations\n// ============================================================================\n\n/**\n * In-memory secure storage fallback.\n * NOT SECURE - use only for development/testing.\n */\nexport class MemorySecureStorage implements SecureStorage {\n  private credentials = new Map<string, string>();\n\n  async setCredential(key: string, value: string): Promise<void> {\n    this.credentials.set(key, value);\n  }\n\n  async getCredential(key: string): Promise<string | null> {\n    return this.credentials.get(key) ?? null;\n  }\n\n  async deleteCredential(key: string): Promise<void> {\n    this.credentials.delete(key);\n  }\n\n  async isAvailable(): Promise<boolean> {\n    return true;\n  }\n}\n\n/**\n * Browser-based network info using navigator.onLine.\n */\nexport class BrowserNetworkInfo implements NetworkInfo {\n  isOnline(): boolean {\n    return typeof navigator !== \"undefined\" ? navigator.onLine : true;\n  }\n\n  onConnectivityChange(callback: (online: boolean) => void): () => void {\n    if (typeof window === \"undefined\") {\n      return () => {};\n    }\n\n    const onOnline = () => callback(true);\n    const onOffline = () => callback(false);\n\n    window.addEventListener(\"online\", onOnline);\n    window.addEventListener(\"offline\", onOffline);\n\n    return () => {\n      window.removeEventListener(\"online\", onOnline);\n      window.removeEventListener(\"offline\", onOffline);\n    };\n  }\n\n  getConnectionType(): \"wifi\" | \"cellular\" | \"ethernet\" | \"unknown\" {\n    // Use Network Information API if available\n    const nav = navigator as Navigator & {\n      connection?: { effectiveType?: string; type?: string };\n    };\n    if (nav.connection?.type) {\n      const type = nav.connection.type;\n      if (type === \"wifi\") return \"wifi\";\n      if (type === \"cellular\") return \"cellular\";\n      if (type === \"ethernet\") return \"ethernet\";\n    }\n    return \"unknown\";\n  }\n}\n\n/**\n * Node.js network info (assumes always online).\n */\nexport class NodeNetworkInfo implements NetworkInfo {\n  isOnline(): boolean {\n    return true;\n  }\n\n  onConnectivityChange(_callback: (online: boolean) => void): () => void {\n    // Node doesn't have native connectivity events\n    return () => {};\n  }\n}\n\n/**\n * Storage-based persistence adapter.\n * Uses provided Storage implementation for state persistence.\n */\nexport class StoragePersistence implements PersistenceAdapter {\n  constructor(private storage: Storage) {}\n\n  async saveState<T>(namespace: string, state: T): Promise<void> {\n    await this.storage.set(`state:${namespace}`, state);\n  }\n\n  async loadState<T>(namespace: string): Promise<T | null> {\n    return this.storage.get<T>(`state:${namespace}`);\n  }\n\n  async clearState(namespace: string): Promise<void> {\n    await this.storage.delete(`state:${namespace}`);\n  }\n}\n\n/**\n * Browser persistence with localStorage and storage events for tab sync.\n */\nexport class BrowserPersistence implements PersistenceAdapter {\n  private prefix: string;\n\n  constructor(prefix = \"sdk_state:\") {\n    this.prefix = prefix;\n  }\n\n  async saveState<T>(namespace: string, state: T): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    localStorage.setItem(`${this.prefix}${namespace}`, JSON.stringify(state));\n  }\n\n  async loadState<T>(namespace: string): Promise<T | null> {\n    if (typeof localStorage === \"undefined\") return null;\n    const value = localStorage.getItem(`${this.prefix}${namespace}`);\n    if (!value) return null;\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async clearState(namespace: string): Promise<void> {\n    if (typeof localStorage === \"undefined\") return;\n    localStorage.removeItem(`${this.prefix}${namespace}`);\n  }\n\n  onExternalChange(\n    namespace: string,\n    callback: (state: unknown) => void,\n  ): () => void {\n    if (typeof window === \"undefined\") {\n      return () => {};\n    }\n\n    const key = `${this.prefix}${namespace}`;\n    const handler = (event: StorageEvent) => {\n      if (event.key === key && event.newValue) {\n        try {\n          callback(JSON.parse(event.newValue));\n        } catch {\n          // Ignore parse errors\n        }\n      }\n    };\n\n    window.addEventListener(\"storage\", handler);\n    return () => window.removeEventListener(\"storage\", handler);\n  }\n}\n\n// ============================================================================\n// Platform Detection and Default Adapter\n// ============================================================================\n\n/**\n * Detect current platform.\n */\nexport function detectPlatform(): PlatformCapabilities[\"platform\"] {\n  // Check for Tauri\n  if (\n    typeof window !== \"undefined\" &&\n    \"__TAURI__\" in (window as unknown as Record<string, unknown>)\n  ) {\n    return \"tauri\";\n  }\n\n  // Check for Electron\n  if (\n    typeof process !== \"undefined\" &&\n    process.versions &&\n    \"electron\" in process.versions\n  ) {\n    return \"electron\";\n  }\n\n  // Check for React Native\n  if (typeof navigator !== \"undefined\" && navigator.product === \"ReactNative\") {\n    return \"react-native\";\n  }\n\n  // Check for browser\n  if (typeof window !== \"undefined\" && typeof document !== \"undefined\") {\n    return \"web\";\n  }\n\n  // Default to Node\n  return \"node\";\n}\n\n/**\n * Create default platform adapter for current environment.\n * Override with platform-specific implementations for better integration.\n */\nexport function createDefaultPlatformAdapter(): PlatformAdapter {\n  const platform = detectPlatform();\n  const isBrowser = platform === \"web\" || platform === \"tauri\";\n  const storage = detectStorage();\n\n  const capabilities: PlatformCapabilities = {\n    platform,\n    supportsBackground: platform === \"node\" || platform === \"electron\",\n    supportsSecureStorage: false, // Requires platform-specific impl\n    supportsWebSocket: true,\n    supportsSSE: true,\n    maxConnections: isBrowser ? 6 : undefined,\n  };\n\n  return {\n    capabilities,\n    storage,\n    secureStorage: new MemorySecureStorage(), // Fallback, not secure\n    network: isBrowser ? new BrowserNetworkInfo() : new NodeNetworkInfo(),\n    persistence: isBrowser\n      ? new BrowserPersistence()\n      : new StoragePersistence(storage),\n    fetch: globalThis.fetch.bind(globalThis),\n  };\n}\n\n/**\n * Type-safe platform adapter factory.\n * Use this to create platform adapters with proper typing.\n */\nexport function createPlatformAdapter(\n  config: Partial<PlatformAdapter> & { capabilities: PlatformCapabilities },\n): PlatformAdapter {\n  const defaults = createDefaultPlatformAdapter();\n  return {\n    ...defaults,\n    ...config,\n  };\n}\n","/**\n * Request Retry Logic\n *\n * Per-request retry with exponential backoff and idempotency.\n */\n\nimport { isRetryable, SDKError } from \"../errors/index.js\";\nimport { sleep } from \"../resilience/timeout.js\";\n\n/** Retry configuration */\nexport interface RetryConfig {\n  /** Max retry attempts (default: 3) */\n  maxAttempts?: number;\n  /** Initial delay in ms (default: 1000) */\n  initialDelayMs?: number;\n  /** Max delay in ms (default: 30000) */\n  maxDelayMs?: number;\n  /** Backoff multiplier (default: 2) */\n  multiplier?: number;\n  /** Jitter factor 0-1 (default: 0.2) */\n  jitter?: number;\n  /** Custom retry predicate */\n  shouldRetry?: (error: SDKError, attempt: number) => boolean;\n  /** Callback before retry */\n  onRetry?: (error: SDKError, attempt: number, delayMs: number) => void;\n  /** Cancels pending backoff and prevents another attempt. */\n  signal?: AbortSignal;\n}\n\nconst DEFAULT_RETRY_CONFIG: Required<\n  Omit<RetryConfig, \"shouldRetry\" | \"onRetry\" | \"signal\">\n> = {\n  maxAttempts: 3,\n  initialDelayMs: 1000,\n  maxDelayMs: 30000,\n  multiplier: 2,\n  jitter: 0.2,\n};\n\n/** Calculate delay for attempt with jitter */\nexport function calculateDelay(attempt: number, config: RetryConfig): number {\n  const { initialDelayMs, maxDelayMs, multiplier, jitter } = {\n    ...DEFAULT_RETRY_CONFIG,\n    ...config,\n  };\n\n  const baseDelay = Math.min(\n    initialDelayMs * multiplier ** attempt,\n    maxDelayMs,\n  );\n\n  const jitterRange = baseDelay * jitter;\n  const jitterValue = Math.random() * jitterRange * 2 - jitterRange;\n\n  return Math.max(0, Math.floor(baseDelay + jitterValue));\n}\n\n/** Execute function with retry */\nexport async function withRetry<T>(\n  fn: (attempt: number) => Promise<T>,\n  config: RetryConfig = {},\n): Promise<T> {\n  const maxAttempts = config.maxAttempts ?? DEFAULT_RETRY_CONFIG.maxAttempts;\n  let lastError: SDKError | null = null;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    config.signal?.throwIfAborted();\n    try {\n      return await fn(attempt);\n    } catch (error) {\n      config.signal?.throwIfAborted();\n      lastError = SDKError.fromError(error);\n\n      // Check if we should retry\n      const shouldRetry = config.shouldRetry\n        ? config.shouldRetry(lastError, attempt)\n        : isRetryable(lastError);\n\n      if (!shouldRetry || attempt >= maxAttempts - 1) {\n        throw lastError;\n      }\n\n      // Calculate delay (use server's retry-after if provided)\n      const delay = lastError.retryAfterMs ?? calculateDelay(attempt, config);\n\n      config.onRetry?.(lastError, attempt + 1, delay);\n\n      await sleep(delay, config.signal);\n    }\n  }\n\n  throw lastError ?? new SDKError(\"Max retries exceeded\", { code: \"UNKNOWN\" });\n}\n\n/** Idempotency key generator */\nexport function generateIdempotencyKey(): string {\n  return `idem_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/** Retry decorator for class methods */\nexport function Retryable(config: RetryConfig = {}) {\n  return <T>(\n    _target: object,\n    _propertyKey: string,\n    descriptor: TypedPropertyDescriptor<(...args: unknown[]) => Promise<T>>,\n  ): TypedPropertyDescriptor<(...args: unknown[]) => Promise<T>> => {\n    const original = descriptor.value;\n    if (!original) return descriptor;\n\n    descriptor.value = async function (\n      this: unknown,\n      ...args: unknown[]\n    ): Promise<T> {\n      return withRetry((_attempt) => {\n        // Inject attempt count if function accepts it\n        return original.apply(this, args);\n      }, config);\n    };\n\n    return descriptor;\n  };\n}\n","/**\n * Channel Pattern Matching\n *\n * Generic utility for matching channel patterns with wildcard support.\n * Used for channel subscriptions and event filtering.\n *\n * Pattern syntax:\n * - \"*\" matches all channels\n * - \"foo.*\" matches \"foo.bar\", \"foo.baz\", etc. (dot-separated)\n * - \"foo:*\" matches \"foo:bar\", \"foo:baz\", etc. (colon-separated)\n * - \"foo.bar\" matches exactly \"foo.bar\"\n * - \"session:abc\" matches exactly \"session:abc\"\n */\n\n/**\n * Check if a pattern matches a channel name.\n *\n * @param pattern - The pattern to match against (supports wildcards)\n * @param channel - The channel name to check\n * @returns true if the pattern matches the channel\n */\nexport function matchesChannel(pattern: string, channel: string): boolean {\n  // Wildcard matches everything\n  if (pattern === \"*\") {\n    return true;\n  }\n\n  // Prefix wildcard with dot separator: \"foo.*\" matches \"foo.bar\", \"foo.baz\", etc.\n  // Does NOT match the exact prefix (e.g., \"foo.*\" does NOT match \"foo\")\n  if (pattern.endsWith(\".*\")) {\n    const prefix = pattern.slice(0, -2);\n    return channel.startsWith(`${prefix}.`);\n  }\n\n  // Prefix wildcard with colon separator: \"session:*\" matches \"session:abc\", etc.\n  // Used for session/project/agent channel patterns\n  // Does NOT match the exact prefix (e.g., \"session:*\" does NOT match \"session:\")\n  if (pattern.endsWith(\":*\")) {\n    const prefix = pattern.slice(0, -2);\n    return (\n      channel.startsWith(`${prefix}:`) && channel.length > prefix.length + 1\n    );\n  }\n\n  // Exact match\n  return pattern === channel;\n}\n\n/**\n * Check if any subscribed channel pattern matches the given channel.\n *\n * @param subscribedChannels - Set or array of channel patterns\n * @param channel - The channel to check\n * @returns true if any pattern matches the channel\n */\nexport function matchesAnyChannel(\n  subscribedChannels: Set<string> | string[],\n  channel: string,\n): boolean {\n  const patterns = Array.isArray(subscribedChannels)\n    ? subscribedChannels\n    : Array.from(subscribedChannels);\n\n  return patterns.some((pattern) => matchesChannel(pattern, channel));\n}\n","/** True for a non-null, non-array object, the shape parsed JSON objects take. */\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n","/**\n * Session ID Translator\n *\n * Generic utility for translating session IDs in event objects.\n * Used to map internal session IDs to client-facing session IDs.\n */\n\nexport interface SessionTranslation {\n  /** The internal session ID to replace */\n  from: string;\n  /** The client-facing session ID to use */\n  to: string;\n}\n\n/**\n * Escape special regex characters in a string.\n */\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\n/**\n * Translate session IDs in an event object.\n * Performs a deep string replacement via JSON serialization.\n *\n * @param event - The event object to translate\n * @param translation - The session ID mapping\n * @returns A new event object with translated session IDs\n */\nexport function translateSessionId<T>(\n  event: T,\n  translation: SessionTranslation,\n): T {\n  if (!event || typeof event !== \"object\") {\n    return event;\n  }\n\n  // Skip if from/to are the same\n  if (translation.from === translation.to) {\n    return event;\n  }\n\n  // Skip if from is empty\n  if (!translation.from) {\n    return event;\n  }\n\n  try {\n    const json = JSON.stringify(event);\n\n    // Use global replace to handle multiple occurrences\n    const pattern = new RegExp(escapeRegex(translation.from), \"g\");\n    const translated = json.replace(pattern, translation.to);\n\n    // Only parse if we actually made changes\n    if (translated !== json) {\n      return JSON.parse(translated);\n    }\n\n    return event;\n  } catch {\n    // If serialization fails, return original\n    return event;\n  }\n}\n\n/**\n * Create a reusable translator function for a specific session mapping.\n * Pre-compiles the regex pattern for better performance when translating\n * many events with the same mapping.\n */\nexport function createSessionTranslator(\n  translation: SessionTranslation,\n): <T>(event: T) => T {\n  // Pre-compile the regex for performance\n  const pattern = new RegExp(escapeRegex(translation.from), \"g\");\n\n  return <T>(event: T): T => {\n    if (!event || typeof event !== \"object\") {\n      return event;\n    }\n\n    if (translation.from === translation.to || !translation.from) {\n      return event;\n    }\n\n    try {\n      const json = JSON.stringify(event);\n      const translated = json.replace(pattern, translation.to);\n\n      if (translated !== json) {\n        return JSON.parse(translated);\n      }\n\n      return event;\n    } catch {\n      return event;\n    }\n  };\n}\n\n/**\n * Extract session ID from various event structures.\n * Handles different event formats that may contain session information.\n */\nexport function extractSessionId(event: unknown): string | null {\n  if (!event || typeof event !== \"object\") {\n    return null;\n  }\n\n  const obj = event as Record<string, unknown>;\n\n  // Direct sessionId field\n  if (typeof obj.sessionId === \"string\") {\n    return obj.sessionId;\n  }\n\n  // Nested in properties\n  if (obj.properties && typeof obj.properties === \"object\") {\n    const props = obj.properties as Record<string, unknown>;\n    if (typeof props.sessionId === \"string\") {\n      return props.sessionId;\n    }\n  }\n\n  // Nested in data\n  if (obj.data && typeof obj.data === \"object\") {\n    const data = obj.data as Record<string, unknown>;\n    if (typeof data.sessionId === \"string\") {\n      return data.sessionId;\n    }\n  }\n\n  return null;\n}\n"],"mappings":"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"}

package/dist/node/index.d.ts

@@ -0,0 +1,7 @@
+//#region src/node/index.d.ts
+/** Lowercase hex SHA-256 of a string or bytes. */
+export declare function sha256Hex(value: string | Uint8Array): string;
+/** Quote one argument for a POSIX shell: single quotes, embedded `'` as `'\''`. */
+export declare function shellQuote(value: string): string;
+//#endregion
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/node/index.ts"],"mappings":";;wBAOgB,UAAU,gBAAgB;;wBAK1B,WAAW"}

package/dist/node/index.js

@@ -0,0 +1,18 @@
+import { createHash } from "node:crypto";
+//#region src/node/index.ts
+/**
+* Node-only primitives. Kept off the root entry so browser bundles of
+* `@tangle-network/agent-core` never pull in `node:crypto`.
+*/
+/** Lowercase hex SHA-256 of a string or bytes. */
+function sha256Hex(value) {
+	return createHash("sha256").update(value).digest("hex");
+}
+/** Quote one argument for a POSIX shell: single quotes, embedded `'` as `'\''`. */
+function shellQuote(value) {
+	return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+//#endregion
+export { sha256Hex, shellQuote };
+
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/node/index.ts"],"sourcesContent":["/**\n * Node-only primitives. Kept off the root entry so browser bundles of\n * `@tangle-network/agent-core` never pull in `node:crypto`.\n */\nimport { createHash } from \"node:crypto\";\n\n/** Lowercase hex SHA-256 of a string or bytes. */\nexport function sha256Hex(value: string | Uint8Array): string {\n  return createHash(\"sha256\").update(value).digest(\"hex\");\n}\n\n/** Quote one argument for a POSIX shell: single quotes, embedded `'` as `'\\''`. */\nexport function shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,UAAU,OAAoC;CAC5D,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;AACxD;;AAGA,SAAgB,WAAW,OAAuB;CAChD,OAAO,IAAI,MAAM,QAAQ,MAAM,OAAO,EAAE;AAC1C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-core",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "Core transport interfaces, event utilities, auth, SSE parsing, and resilience primitives for talking to Tangle agents",
   "type": "module",
   "license": "MIT",
@@ -66,6 +66,11 @@
       "import": "./dist/interactions/mcp-server.js",
       "types": "./dist/interactions/mcp-server.d.ts",
       "default": "./dist/interactions/mcp-server.js"
+    },
+    "./node": {
+      "import": "./dist/node/index.js",
+      "types": "./dist/node/index.d.ts",
+      "default": "./dist/node/index.js"
     }
   },
   "typesVersions": {
@@ -120,6 +125,9 @@
       ],
       "*": [
         "src/index.ts"
+      ],
+      "node": [
+        "src/node/index.ts"
       ]
     }
   },