@tangle-network/agent-core 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/auth/browser.d.ts +1 -1
- package/dist/auth/index.d.ts +12 -91
- package/dist/auth/index.d.ts.map +1 -1
- package/dist/auth/index.js +1 -129
- package/dist/auth/index.js.map +1 -1
- package/dist/events/index.d.ts +1 -1
- package/dist/{index-CtebBodu.d.ts → index-BOD4IhTr.d.ts} +2 -2
- package/dist/{index-CtebBodu.d.ts.map → index-BOD4IhTr.d.ts.map} +1 -1
- package/dist/{index-DiQX9bjq.d.ts → index-BRyMBSkE.d.ts} +1 -1
- package/dist/{index-DiQX9bjq.d.ts.map → index-BRyMBSkE.d.ts.map} +1 -1
- package/dist/{index-DlPznmKA.d.ts → index-C7zlWVGc.d.ts} +1 -1
- package/dist/{index-DlPznmKA.d.ts.map → index-C7zlWVGc.d.ts.map} +1 -1
- package/dist/index-CBGkvDtv.d.ts +303 -0
- package/dist/index-CBGkvDtv.d.ts.map +1 -0
- package/dist/{index-z2wPdzFb.d.ts → index-Dz1ZLn3K.d.ts} +2 -2
- package/dist/{index-z2wPdzFb.d.ts.map → index-Dz1ZLn3K.d.ts.map} +1 -1
- package/dist/{index-CFA8kgHJ.d.ts → index-VcOZI9jN.d.ts} +1 -1
- package/dist/{index-CFA8kgHJ.d.ts.map → index-VcOZI9jN.d.ts.map} +1 -1
- package/dist/index.d.ts +8 -85
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -106
- package/dist/index.js.map +1 -1
- package/dist/resilience/index.d.ts +1 -1
- package/dist/telemetry/index.d.ts +2 -0
- package/dist/telemetry/index.js +2 -0
- package/dist/telemetry-D2XGH5UL.js +699 -0
- package/dist/telemetry-D2XGH5UL.js.map +1 -0
- package/dist/transport/index.d.ts +1 -1
- package/dist/transport/index.js +1 -1
- package/dist/{transport-mKLoQep5.js → transport-XLxpQmUW.js} +1 -1
- package/dist/{transport-mKLoQep5.js.map → transport-XLxpQmUW.js.map} +1 -1
- package/dist/types/index.d.ts +1 -1
- package/dist/types/index.js +1 -1
- package/dist/{types-D5VLaol0.js → types-Ci7hcTnp.js} +1 -1
- package/dist/{types-D5VLaol0.js.map → types-Ci7hcTnp.js.map} +1 -1
- package/dist/{types-DiDSGM8K.d.ts → types-D32txapu.d.ts} +2 -2
- package/dist/{types-DiDSGM8K.d.ts.map → types-D32txapu.d.ts.map} +1 -1
- package/package.json +7 -2
package/dist/index.js
CHANGED
|
@@ -4,8 +4,9 @@ import { EnvTokenAuth, ProductAuth, ProductTokenIssuer, SidecarAuth, canBatchTok
|
|
|
4
4
|
import { n as EventChannel, r as EventBuffer, t as EventDeduplicator } from "./events-CUWh9qrv.js";
|
|
5
5
|
import { a as sleep, c as CircuitOpenError, i as createTimeoutController, n as withProtection, o as withTimeout, r as TimeoutError, s as CircuitBreaker, t as createProtectedFn } from "./resilience-BQzDfw_C.js";
|
|
6
6
|
import { SSEChunkParser, StreamUsageExtractor, consumeSSEStream, createStreamUsageExtractor, createUsageCallback, parseSSEData, parseSSEStream } from "./sse/index.js";
|
|
7
|
-
import { i as
|
|
8
|
-
import {
|
|
7
|
+
import { A as GEN_AI_OPERATION_NAME, B as CONTENT_PROMPT_KEY, C as TANGLE_WORKFLOW_ID_KEY, D as GEN_AI_CONVERSATION_ID, E as WORKFLOW_MARKER_ATTRS, F as GEN_AI_USAGE_OUTPUT_TOKENS, G as asContentString, H as CONTENT_TOOL_NAME_KEY, I as genAiUsageAttributes, J as extractContent, K as classifyAgent, L as CONTENT_COMPLETION_KEY, M as GEN_AI_REQUEST_MODEL, N as GEN_AI_RESPONSE_MODEL, O as GEN_AI_INPUT_TOKEN_KEYS, P as GEN_AI_USAGE_INPUT_TOKENS, R as CONTENT_KEYS, S as TANGLE_TRIGGER_SOURCE_KEY, T as TRIGGER_SOURCE_ATTRS, U as CONTENT_TOOL_RESULT_KEY, V as CONTENT_TOOL_ARGS_KEY, W as asContentField, X as logRecordContentBag, Y as hasContent, Z as resolveDeclaredIntent, _ as TANGLE_RUN_KIND_KEY, a as firstTokenCount, b as TANGLE_TRIGGER_ID_KEY, c as readTokenUsage, d as PARENT_RUN_KEY_ATTRS, f as RUN_KEY_ATTRS, g as TANGLE_RUN_ID_KEY, h as TANGLE_RUN_ID_CAMEL_KEY, i as addTokenUsage, j as GEN_AI_OUTPUT_TOKEN_KEYS, k as GEN_AI_MODEL_KEYS, l as tokenCount, m as SUBJECT_KEY_ATTRS, n as TOKEN_USAGE_INPUT_KEYS, o as firstUsageCostUsd, p as RUN_KIND_ATTRS, q as declaredTaskText, r as TOKEN_USAGE_OUTPUT_KEYS, s as readTokenCostUsd, t as TOKEN_USAGE_COST_KEYS, u as tokenUsageSource, v as TANGLE_RUN_PARENT_ID_KEY, w as TRIGGER_ID_ATTRS, x as TANGLE_TRIGGER_KIND_KEY, y as TANGLE_SUBJECT_KEY, z as CONTENT_KEY_FIELD } from "./telemetry-D2XGH5UL.js";
|
|
8
|
+
import { i as DEFAULT_RECONNECTION_CONFIG, n as BaseTransportAdapter, r as ConnectionManager, t as MockTransportAdapter } from "./transport-XLxpQmUW.js";
|
|
9
|
+
import { a as isTextPart, i as isSubtaskPart, n as isFilePart, o as isToolPart, r as isReasoningPart, t as AgentEventTypeSchema } from "./types-Ci7hcTnp.js";
|
|
9
10
|
//#region src/cache/index.ts
|
|
10
11
|
/** In-memory LRU cache */
|
|
11
12
|
var MemoryCache = class {
|
|
@@ -602,109 +603,6 @@ function Retryable(config = {}) {
|
|
|
602
603
|
};
|
|
603
604
|
}
|
|
604
605
|
//#endregion
|
|
605
|
-
//#region src/telemetry/genai-attributes.ts
|
|
606
|
-
/**
|
|
607
|
-
* OpenTelemetry GenAI semantic-convention span attributes — the single
|
|
608
|
-
* vocabulary every trace producer in the stack emits and the intelligence
|
|
609
|
-
* ingest reads, so model / token / cost attribution is identical regardless of
|
|
610
|
-
* which producer lowered the span (workflow emitter, SDK trace sink, …).
|
|
611
|
-
*
|
|
612
|
-
* Writers emit the PRIMARY keys (`GEN_AI_*`). The ingest reader accepts the
|
|
613
|
-
* wider candidate lists (`GEN_AI_*_KEYS`) because foreign SDKs spell the same
|
|
614
|
-
* field differently (Langfuse, raw OTLP GenAI, our own legacy `model`).
|
|
615
|
-
* Co-locating writer keys and reader candidates here is the drift guard: a
|
|
616
|
-
* writer's key and the reader's first candidate can never silently disagree.
|
|
617
|
-
*
|
|
618
|
-
* Spec: OpenTelemetry GenAI semantic conventions (`gen_ai.*`).
|
|
619
|
-
*/
|
|
620
|
-
/** Model that served a request — the primary key writers emit. */
|
|
621
|
-
const GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
|
|
622
|
-
/** Model named on a response — a reader fallback; writers prefer request.model. */
|
|
623
|
-
const GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
|
|
624
|
-
/** Prompt / input token count. */
|
|
625
|
-
const GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
|
|
626
|
-
/** Completion / output token count. */
|
|
627
|
-
const GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
|
|
628
|
-
/** Operation name (e.g. `"invoke_agent"`). */
|
|
629
|
-
const GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
|
|
630
|
-
/** Conversation / session id grouping a multi-turn agent run. */
|
|
631
|
-
const GEN_AI_CONVERSATION_ID = "gen_ai.conversation.id";
|
|
632
|
-
/**
|
|
633
|
-
* Reader candidate keys for the model, highest priority first. The first entry
|
|
634
|
-
* is the writers' primary key; the rest accept foreign-SDK spellings.
|
|
635
|
-
*/
|
|
636
|
-
const GEN_AI_MODEL_KEYS = Object.freeze([
|
|
637
|
-
GEN_AI_REQUEST_MODEL,
|
|
638
|
-
GEN_AI_RESPONSE_MODEL,
|
|
639
|
-
"llm.model_name",
|
|
640
|
-
"model"
|
|
641
|
-
]);
|
|
642
|
-
/** Reader candidate keys for input tokens, highest priority first. These name
|
|
643
|
-
* SPAN ATTRIBUTES on a lowered span — for the raw producer `tokenUsage` OBJECT
|
|
644
|
-
* field names (a distinct layer) see `TOKEN_USAGE_INPUT_KEYS` in
|
|
645
|
-
* `token-usage.ts`; a new producer shape may need an entry in both. */
|
|
646
|
-
const GEN_AI_INPUT_TOKEN_KEYS = Object.freeze([
|
|
647
|
-
GEN_AI_USAGE_INPUT_TOKENS,
|
|
648
|
-
"gen_ai.usage.prompt_tokens",
|
|
649
|
-
"llm.token_count.prompt"
|
|
650
|
-
]);
|
|
651
|
-
/** Reader candidate keys for output tokens, highest priority first. */
|
|
652
|
-
const GEN_AI_OUTPUT_TOKEN_KEYS = Object.freeze([
|
|
653
|
-
GEN_AI_USAGE_OUTPUT_TOKENS,
|
|
654
|
-
"gen_ai.usage.completion_tokens",
|
|
655
|
-
"llm.token_count.completion"
|
|
656
|
-
]);
|
|
657
|
-
function isNonNegativeFinite(n) {
|
|
658
|
-
return typeof n === "number" && Number.isFinite(n) && n >= 0;
|
|
659
|
-
}
|
|
660
|
-
/**
|
|
661
|
-
* Lower a usage record to the GenAI semantic-convention attribute bag, OMITTING
|
|
662
|
-
* any unknown field. A synthesized zero token count or empty model would
|
|
663
|
-
* corrupt every downstream token/cost aggregate, so absent stays absent — the
|
|
664
|
-
* ingest then reads "cost not computed", never "free". This is the writer-side
|
|
665
|
-
* mirror of {@link GEN_AI_MODEL_KEYS} / the `*_TOKEN_KEYS` reader candidates.
|
|
666
|
-
*/
|
|
667
|
-
function genAiUsageAttributes(usage) {
|
|
668
|
-
const attrs = {};
|
|
669
|
-
if (typeof usage.model === "string" && usage.model.length > 0) attrs[GEN_AI_REQUEST_MODEL] = usage.model;
|
|
670
|
-
if (isNonNegativeFinite(usage.inputTokens)) attrs[GEN_AI_USAGE_INPUT_TOKENS] = usage.inputTokens;
|
|
671
|
-
if (isNonNegativeFinite(usage.outputTokens)) attrs[GEN_AI_USAGE_OUTPUT_TOKENS] = usage.outputTokens;
|
|
672
|
-
return attrs;
|
|
673
|
-
}
|
|
674
|
-
//#endregion
|
|
675
|
-
//#region src/telemetry/token-usage.ts
|
|
676
|
-
/**
|
|
677
|
-
* Candidate field names for a producer-supplied `tokenUsage` bag on a
|
|
678
|
-
* `message.updated` trace event. Agents and SDK layers disagree on the
|
|
679
|
-
* spelling: `StreamTokenUsage` emits `inputTokens`/`outputTokens`, the eval and
|
|
680
|
-
* workflow agent.run paths emit `input`/`output`, and persisted / foreign
|
|
681
|
-
* shapes use snake_case or prompt/completion naming. A reader that wants the
|
|
682
|
-
* token counts must try all of them, highest-priority first, or it silently
|
|
683
|
-
* drops usage for the producers it does not name.
|
|
684
|
-
*
|
|
685
|
-
* Shared so every `tokenUsage` reader (the trace sink's root-span aggregation,
|
|
686
|
-
* the signal extractor) keys off the identical set and cannot drift.
|
|
687
|
-
*
|
|
688
|
-
* Distinct layer from `genai-attributes.ts`: those keys (`GEN_AI_*_TOKEN_KEYS`)
|
|
689
|
-
* name OTel SPAN ATTRIBUTES on an already-lowered span; these name the fields of
|
|
690
|
-
* the raw producer `tokenUsage` OBJECT before lowering. A new producer that
|
|
691
|
-
* spells token usage differently may need an entry in BOTH places.
|
|
692
|
-
*/
|
|
693
|
-
const TOKEN_USAGE_INPUT_KEYS = Object.freeze([
|
|
694
|
-
"inputTokens",
|
|
695
|
-
"input",
|
|
696
|
-
"input_tokens",
|
|
697
|
-
"promptTokens",
|
|
698
|
-
"prompt_tokens"
|
|
699
|
-
]);
|
|
700
|
-
const TOKEN_USAGE_OUTPUT_KEYS = Object.freeze([
|
|
701
|
-
"outputTokens",
|
|
702
|
-
"output",
|
|
703
|
-
"output_tokens",
|
|
704
|
-
"completionTokens",
|
|
705
|
-
"completion_tokens"
|
|
706
|
-
]);
|
|
707
|
-
//#endregion
|
|
708
606
|
//#region src/utils/channel-matching.ts
|
|
709
607
|
/**
|
|
710
608
|
* Channel Pattern Matching
|
|
@@ -817,6 +715,6 @@ function extractSessionId(event) {
|
|
|
817
715
|
return null;
|
|
818
716
|
}
|
|
819
717
|
//#endregion
|
|
820
|
-
export { AgentEventTypeSchema, BaseTransportAdapter, BatchScopedTokenPayloadSchema, BrowserNetworkInfo, BrowserPersistence, 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_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, InterceptorChain, LocalStorage, MemoryCache, MemorySecureStorage, MemoryStorage, MockTransportAdapter, NoAuth, NodeNetworkInfo, OfflineQueue, ProductAuth, ProductSchema, ProductTokenIssuer, ProjectScopedTokenPayloadSchema, ReadTokenAuth, ReadTokenPayloadSchema, RefreshableTokenAuth, ResponseCache, Retryable, SDKError, SSEChunkParser, SendMessageRequestSchema, SessionScopedTokenPayloadSchema, SidecarAuth, StaticTokenAuth, StoragePersistence, StreamUsageExtractor, TOKEN_USAGE_INPUT_KEYS, TOKEN_USAGE_OUTPUT_KEYS, TimeoutError, 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 };
|
|
718
|
+
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_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, 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_COST_KEYS, TOKEN_USAGE_INPUT_KEYS, TOKEN_USAGE_OUTPUT_KEYS, TRIGGER_ID_ATTRS, TRIGGER_SOURCE_ATTRS, TimeoutError, WORKFLOW_MARKER_ATTRS, addTokenUsage, asContentField, asContentString, 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, parseSSEData, parseSSEStream, readTokenCostUsd, readTokenUsage, resolveDeclaredIntent, sleep, tokenCount, tokenUsageSource, translateSessionId, validateChannelSubscription, validateTokenScope, verifyApiKey, verifyReadToken, withProtection, withRetry, withTimeout };
|
|
821
719
|
|
|
822
720
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":["sleep"],"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"],"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\";\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}\n\nconst DEFAULT_RETRY_CONFIG: Required<\n Omit<RetryConfig, \"shouldRetry\" | \"onRetry\">\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 try {\n return await fn(attempt);\n } catch (error) {\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);\n }\n }\n\n throw lastError ?? new SDKError(\"Max retries exceeded\", { code: \"UNKNOWN\" });\n}\n\n/** Sleep utility */\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\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 * OpenTelemetry GenAI semantic-convention span attributes — the single\n * vocabulary every trace producer in the stack emits and the intelligence\n * ingest reads, so model / token / cost attribution is identical regardless of\n * which producer lowered the span (workflow emitter, SDK trace sink, …).\n *\n * Writers emit the PRIMARY keys (`GEN_AI_*`). The ingest reader accepts the\n * wider candidate lists (`GEN_AI_*_KEYS`) because foreign SDKs spell the same\n * field differently (Langfuse, raw OTLP GenAI, our own legacy `model`).\n * Co-locating writer keys and reader candidates here is the drift guard: a\n * writer's key and the reader's first candidate can never silently disagree.\n *\n * Spec: OpenTelemetry GenAI semantic conventions (`gen_ai.*`).\n */\n\n/** Model that served a request — the primary key writers emit. */\nexport const GEN_AI_REQUEST_MODEL = \"gen_ai.request.model\";\n/** Model named on a response — a reader fallback; writers prefer request.model. */\nexport const GEN_AI_RESPONSE_MODEL = \"gen_ai.response.model\";\n/** Prompt / input token count. */\nexport const GEN_AI_USAGE_INPUT_TOKENS = \"gen_ai.usage.input_tokens\";\n/** Completion / output token count. */\nexport const GEN_AI_USAGE_OUTPUT_TOKENS = \"gen_ai.usage.output_tokens\";\n/** Operation name (e.g. `\"invoke_agent\"`). */\nexport const GEN_AI_OPERATION_NAME = \"gen_ai.operation.name\";\n/** Conversation / session id grouping a multi-turn agent run. */\nexport const GEN_AI_CONVERSATION_ID = \"gen_ai.conversation.id\";\n\n/**\n * Reader candidate keys for the model, highest priority first. The first entry\n * is the writers' primary key; the rest accept foreign-SDK spellings.\n */\nexport const GEN_AI_MODEL_KEYS: readonly string[] = Object.freeze([\n GEN_AI_REQUEST_MODEL,\n GEN_AI_RESPONSE_MODEL,\n \"llm.model_name\",\n \"model\",\n]);\n\n/** Reader candidate keys for input tokens, highest priority first. These name\n * SPAN ATTRIBUTES on a lowered span — for the raw producer `tokenUsage` OBJECT\n * field names (a distinct layer) see `TOKEN_USAGE_INPUT_KEYS` in\n * `token-usage.ts`; a new producer shape may need an entry in both. */\nexport const GEN_AI_INPUT_TOKEN_KEYS: readonly string[] = Object.freeze([\n GEN_AI_USAGE_INPUT_TOKENS,\n \"gen_ai.usage.prompt_tokens\",\n \"llm.token_count.prompt\",\n]);\n\n/** Reader candidate keys for output tokens, highest priority first. */\nexport const GEN_AI_OUTPUT_TOKEN_KEYS: readonly string[] = Object.freeze([\n GEN_AI_USAGE_OUTPUT_TOKENS,\n \"gen_ai.usage.completion_tokens\",\n \"llm.token_count.completion\",\n]);\n\n/** A model/token usage record to lower into the GenAI attribute bag. */\nexport interface GenAiUsage {\n /** Model slug; omitted from the attribute bag when absent or empty. */\n model?: string;\n /** Prompt tokens; omitted unless a finite, non-negative number. */\n inputTokens?: number;\n /** Completion tokens; omitted unless a finite, non-negative number. */\n outputTokens?: number;\n}\n\nfunction isNonNegativeFinite(n: number | undefined): n is number {\n return typeof n === \"number\" && Number.isFinite(n) && n >= 0;\n}\n\n/**\n * Lower a usage record to the GenAI semantic-convention attribute bag, OMITTING\n * any unknown field. A synthesized zero token count or empty model would\n * corrupt every downstream token/cost aggregate, so absent stays absent — the\n * ingest then reads \"cost not computed\", never \"free\". This is the writer-side\n * mirror of {@link GEN_AI_MODEL_KEYS} / the `*_TOKEN_KEYS` reader candidates.\n */\nexport function genAiUsageAttributes(\n usage: GenAiUsage,\n): Record<string, string | number> {\n const attrs: Record<string, string | number> = {};\n if (typeof usage.model === \"string\" && usage.model.length > 0) {\n attrs[GEN_AI_REQUEST_MODEL] = usage.model;\n }\n if (isNonNegativeFinite(usage.inputTokens)) {\n attrs[GEN_AI_USAGE_INPUT_TOKENS] = usage.inputTokens;\n }\n if (isNonNegativeFinite(usage.outputTokens)) {\n attrs[GEN_AI_USAGE_OUTPUT_TOKENS] = usage.outputTokens;\n }\n return attrs;\n}\n","/**\n * Candidate field names for a producer-supplied `tokenUsage` bag on a\n * `message.updated` trace event. Agents and SDK layers disagree on the\n * spelling: `StreamTokenUsage` emits `inputTokens`/`outputTokens`, the eval and\n * workflow agent.run paths emit `input`/`output`, and persisted / foreign\n * shapes use snake_case or prompt/completion naming. A reader that wants the\n * token counts must try all of them, highest-priority first, or it silently\n * drops usage for the producers it does not name.\n *\n * Shared so every `tokenUsage` reader (the trace sink's root-span aggregation,\n * the signal extractor) keys off the identical set and cannot drift.\n *\n * Distinct layer from `genai-attributes.ts`: those keys (`GEN_AI_*_TOKEN_KEYS`)\n * name OTel SPAN ATTRIBUTES on an already-lowered span; these name the fields of\n * the raw producer `tokenUsage` OBJECT before lowering. A new producer that\n * spells token usage differently may need an entry in BOTH places.\n */\nexport const TOKEN_USAGE_INPUT_KEYS: readonly string[] = Object.freeze([\n \"inputTokens\",\n \"input\",\n \"input_tokens\",\n \"promptTokens\",\n \"prompt_tokens\",\n]);\n\nexport const TOKEN_USAGE_OUTPUT_KEYS: readonly string[] = Object.freeze([\n \"outputTokens\",\n \"output\",\n \"output_tokens\",\n \"completionTokens\",\n \"completion_tokens\",\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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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":["sleep"],"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\";\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}\n\nconst DEFAULT_RETRY_CONFIG: Required<\n Omit<RetryConfig, \"shouldRetry\" | \"onRetry\">\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 try {\n return await fn(attempt);\n } catch (error) {\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);\n }\n }\n\n throw lastError ?? new SDKError(\"Max retries exceeded\", { code: \"UNKNOWN\" });\n}\n\n/** Sleep utility */\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\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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"}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
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-
|
|
1
|
+
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-BOD4IhTr.js";
|
|
2
2
|
export { CircuitBreaker, CircuitBreakerConfig, CircuitBreakerStats, CircuitOpenError, CircuitState, ProtectionOptions, TimeoutError, createProtectedFn, createTimeoutController, sleep, withProtection, withTimeout };
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import { $ as extractContent, A as GEN_AI_MODEL_KEYS, B as CONTENT_KEYS, C as TANGLE_TRIGGER_SOURCE_KEY, D as WORKFLOW_MARKER_ATTRS, E as TRIGGER_SOURCE_ATTRS, F as GEN_AI_USAGE_INPUT_TOKENS, G as CONTENT_TOOL_RESULT_KEY, H as CONTENT_PROMPT_KEY, I as GEN_AI_USAGE_OUTPUT_TOKENS, J as NormalizedContent, K as ContentField, L as GenAiUsage, M as GEN_AI_OUTPUT_TOKEN_KEYS, N as GEN_AI_REQUEST_MODEL, O as GEN_AI_CONVERSATION_ID, P as GEN_AI_RESPONSE_MODEL, Q as declaredTaskText, R as genAiUsageAttributes, S as TANGLE_TRIGGER_KIND_KEY, T as TRIGGER_ID_ATTRS, U as CONTENT_TOOL_ARGS_KEY, V as CONTENT_KEY_FIELD, W as CONTENT_TOOL_NAME_KEY, X as asContentString, Y as asContentField, Z as classifyAgent, _ as TANGLE_RUN_ID_KEY, a as addTokenUsage, b as TANGLE_SUBJECT_KEY, c as readTokenCostUsd, d as tokenUsageSource, et as hasContent, f as PARENT_RUN_KEY_ATTRS, g as TANGLE_RUN_ID_CAMEL_KEY, h as SUBJECT_KEY_ATTRS, i as TokenUsageCounts, j as GEN_AI_OPERATION_NAME, k as GEN_AI_INPUT_TOKEN_KEYS, l as readTokenUsage, m as RUN_KIND_ATTRS, n as TOKEN_USAGE_INPUT_KEYS, nt as resolveDeclaredIntent, o as firstTokenCount, p as RUN_KEY_ATTRS, q as DeclaredIntentMatch, r as TOKEN_USAGE_OUTPUT_KEYS, s as firstUsageCostUsd, t as TOKEN_USAGE_COST_KEYS, tt as logRecordContentBag, u as tokenCount, v as TANGLE_RUN_KIND_KEY, w as TANGLE_WORKFLOW_ID_KEY, x as TANGLE_TRIGGER_ID_KEY, y as TANGLE_RUN_PARENT_ID_KEY, z as CONTENT_COMPLETION_KEY } from "../index-CBGkvDtv.js";
|
|
2
|
+
export { CONTENT_COMPLETION_KEY, CONTENT_KEYS, CONTENT_KEY_FIELD, CONTENT_PROMPT_KEY, CONTENT_TOOL_ARGS_KEY, CONTENT_TOOL_NAME_KEY, CONTENT_TOOL_RESULT_KEY, ContentField, DeclaredIntentMatch, 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, GenAiUsage, NormalizedContent, PARENT_RUN_KEY_ATTRS, RUN_KEY_ATTRS, RUN_KIND_ATTRS, SUBJECT_KEY_ATTRS, 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_COST_KEYS, TOKEN_USAGE_INPUT_KEYS, TOKEN_USAGE_OUTPUT_KEYS, TRIGGER_ID_ATTRS, TRIGGER_SOURCE_ATTRS, TokenUsageCounts, WORKFLOW_MARKER_ATTRS, addTokenUsage, asContentField, asContentString, classifyAgent, declaredTaskText, extractContent, firstTokenCount, firstUsageCostUsd, genAiUsageAttributes, hasContent, logRecordContentBag, readTokenCostUsd, readTokenUsage, resolveDeclaredIntent, tokenCount, tokenUsageSource };
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import { A as GEN_AI_OPERATION_NAME, B as CONTENT_PROMPT_KEY, C as TANGLE_WORKFLOW_ID_KEY, D as GEN_AI_CONVERSATION_ID, E as WORKFLOW_MARKER_ATTRS, F as GEN_AI_USAGE_OUTPUT_TOKENS, G as asContentString, H as CONTENT_TOOL_NAME_KEY, I as genAiUsageAttributes, J as extractContent, K as classifyAgent, L as CONTENT_COMPLETION_KEY, M as GEN_AI_REQUEST_MODEL, N as GEN_AI_RESPONSE_MODEL, O as GEN_AI_INPUT_TOKEN_KEYS, P as GEN_AI_USAGE_INPUT_TOKENS, R as CONTENT_KEYS, S as TANGLE_TRIGGER_SOURCE_KEY, T as TRIGGER_SOURCE_ATTRS, U as CONTENT_TOOL_RESULT_KEY, V as CONTENT_TOOL_ARGS_KEY, W as asContentField, X as logRecordContentBag, Y as hasContent, Z as resolveDeclaredIntent, _ as TANGLE_RUN_KIND_KEY, a as firstTokenCount, b as TANGLE_TRIGGER_ID_KEY, c as readTokenUsage, d as PARENT_RUN_KEY_ATTRS, f as RUN_KEY_ATTRS, g as TANGLE_RUN_ID_KEY, h as TANGLE_RUN_ID_CAMEL_KEY, i as addTokenUsage, j as GEN_AI_OUTPUT_TOKEN_KEYS, k as GEN_AI_MODEL_KEYS, l as tokenCount, m as SUBJECT_KEY_ATTRS, n as TOKEN_USAGE_INPUT_KEYS, o as firstUsageCostUsd, p as RUN_KIND_ATTRS, q as declaredTaskText, r as TOKEN_USAGE_OUTPUT_KEYS, s as readTokenCostUsd, t as TOKEN_USAGE_COST_KEYS, u as tokenUsageSource, v as TANGLE_RUN_PARENT_ID_KEY, w as TRIGGER_ID_ATTRS, x as TANGLE_TRIGGER_KIND_KEY, y as TANGLE_SUBJECT_KEY, z as CONTENT_KEY_FIELD } from "../telemetry-D2XGH5UL.js";
|
|
2
|
+
export { CONTENT_COMPLETION_KEY, CONTENT_KEYS, CONTENT_KEY_FIELD, CONTENT_PROMPT_KEY, CONTENT_TOOL_ARGS_KEY, CONTENT_TOOL_NAME_KEY, CONTENT_TOOL_RESULT_KEY, 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, PARENT_RUN_KEY_ATTRS, RUN_KEY_ATTRS, RUN_KIND_ATTRS, SUBJECT_KEY_ATTRS, 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_COST_KEYS, TOKEN_USAGE_INPUT_KEYS, TOKEN_USAGE_OUTPUT_KEYS, TRIGGER_ID_ATTRS, TRIGGER_SOURCE_ATTRS, WORKFLOW_MARKER_ATTRS, addTokenUsage, asContentField, asContentString, classifyAgent, declaredTaskText, extractContent, firstTokenCount, firstUsageCostUsd, genAiUsageAttributes, hasContent, logRecordContentBag, readTokenCostUsd, readTokenUsage, resolveDeclaredIntent, tokenCount, tokenUsageSource };
|