@elizaos/ui 2.0.0-alpha.25 → 2.0.0-alpha.334

package/packages/typescript/src/services.js

@@ -0,0 +1,99 @@
+import { Service } from "./types";
+/**
+ * Service builder class that provides type-safe service creation
+ * with automatic type inference
+ */
+export class ServiceBuilder {
+    serviceType;
+    startFn;
+    stopFn;
+    description;
+    constructor(serviceType) {
+        this.serviceType = serviceType;
+        this.description = "";
+    }
+    /**
+     * Set the service description
+     */
+    withDescription(description) {
+        this.description = description;
+        return this;
+    }
+    /**
+     * Set the start function for the service
+     */
+    withStart(startFn) {
+        this.startFn = startFn;
+        return this;
+    }
+    /**
+     * Set the stop function for the service
+     */
+    withStop(stopFn) {
+        this.stopFn = stopFn;
+        return this;
+    }
+    /**
+     * Build the service class with all configured properties.
+     * Returns a properly typed service class constructor.
+     */
+    build() {
+        const serviceType = this.serviceType;
+        const description = this.description;
+        const startFn = this.startFn;
+        const stopFn = this.stopFn;
+        // Build the service class using Object.assign to properly set static properties
+        // This avoids the need for 'as unknown as' by structuring the class correctly
+        const ServiceClassImpl = class extends Service {
+            capabilityDescription = description;
+            async stop() {
+                if (stopFn) {
+                    await stopFn();
+                }
+            }
+        };
+        // Define static properties on the class
+        Object.defineProperty(ServiceClassImpl, "serviceType", {
+            value: serviceType,
+            writable: false,
+            enumerable: true,
+            configurable: false,
+        });
+        // Define the static start method that returns the correct type
+        const startMethod = async (runtime) => {
+            if (!startFn) {
+                throw new Error(`Start function not defined for service ${serviceType}`);
+            }
+            return startFn(runtime);
+        };
+        Object.defineProperty(ServiceClassImpl, "start", {
+            value: startMethod,
+            writable: false,
+            enumerable: true,
+            configurable: false,
+        });
+        // The class now conforms to TypedServiceBuilder<TService> interface
+        // We use a type assertion here that is safe because we've explicitly
+        // set up the class to match the interface requirements
+        return ServiceClassImpl;
+    }
+}
+/**
+ * Create a type-safe service builder
+ * @param serviceType - The service type name
+ * @returns A new ServiceBuilder instance
+ */
+export function createService(serviceType) {
+    return new ServiceBuilder(serviceType);
+}
+/**
+ * Define a service with type safety.
+ * Returns a TypedServiceBuilder that can be instantiated and started.
+ */
+export function defineService(definition) {
+    return createService(definition.serviceType)
+        .withDescription(definition.description)
+        .withStart(definition.start)
+        .withStop(definition.stop || (() => Promise.resolve()))
+        .build();
+}

package/packages/typescript/src/sessions/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Session management utilities for elizaOS.
+ *
+ * Provides:
+ * - Session key building and parsing
+ * - Session types and data structures
+ * - Session storage with caching and locking
+ * - Session path resolution
+ * - Agent/peer/thread session management
+ * - Identity linking for cross-platform users
+ *
+ * @module sessions
+ */
+export { buildAcpSessionKey, buildAgentMainSessionKey, buildAgentPeerSessionKey, buildAgentSessionKey, buildGroupHistoryKey, buildSubagentSessionKey, DEFAULT_ACCOUNT_ID, DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, isAcpSessionKey, isSubagentSessionKey, normalizeAccountId, normalizeAgentId, normalizeMainKey, type ParsedAgentSessionKey, parseAgentSessionKey, resolveAgentIdFromSessionKey, resolveThreadParentSessionKey, resolveThreadSessionKeys, sanitizeAgentId, toAgentRequestSessionKey, toAgentStoreSessionKey, } from "./session-key.js";
+export { createSessionEntry, DEFAULT_IDLE_MINUTES, DEFAULT_RESET_TRIGGER, DEFAULT_RESET_TRIGGERS, type GroupKeyResolution, isValidSessionEntry, mergeSessionEntry, type SessionChatType, type SessionDeliveryContext, type SessionEntry, type SessionResolution, type SessionStore, } from "./types.js";
+export { createSendPolicyProvider, createSessionProvider, createSessionSkillsProvider, extractSessionContext, getSessionProviders, } from "./provider.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/typescript/src/sessions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EACN,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,EAC7B,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,sBAAsB,GACtB,MAAM,kBAAkB,CAAC;AAW1B,OAAO,EACN,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GACjB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACN,wBAAwB,EACxB,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,eAAe,CAAC"}

package/packages/typescript/src/sessions/index.js

@@ -0,0 +1,29 @@
+/**
+ * Session management utilities for elizaOS.
+ *
+ * Provides:
+ * - Session key building and parsing
+ * - Session types and data structures
+ * - Session storage with caching and locking
+ * - Session path resolution
+ * - Agent/peer/thread session management
+ * - Identity linking for cross-platform users
+ *
+ * @module sessions
+ */
+// ============================================================================
+// Session Key Utilities
+// ============================================================================
+export { buildAcpSessionKey, buildAgentMainSessionKey, buildAgentPeerSessionKey, buildAgentSessionKey, buildGroupHistoryKey, buildSubagentSessionKey, DEFAULT_ACCOUNT_ID, DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, isAcpSessionKey, isSubagentSessionKey, normalizeAccountId, normalizeAgentId, normalizeMainKey, parseAgentSessionKey, resolveAgentIdFromSessionKey, resolveThreadParentSessionKey, resolveThreadSessionKeys, sanitizeAgentId, toAgentRequestSessionKey, toAgentStoreSessionKey, } from "./session-key.js";
+// ============================================================================
+// Session Types
+// ============================================================================
+// Note: SessionOrigin, SessionModelOverride, SessionUsage, SessionSkillEntry,
+// SessionSkillsSnapshot, and SessionScope are defined in types/memory.ts and
+// types/channel-config.ts to avoid circular dependencies. They are exported
+// from the main types module, not from sessions.
+export { createSessionEntry, DEFAULT_IDLE_MINUTES, DEFAULT_RESET_TRIGGER, DEFAULT_RESET_TRIGGERS, isValidSessionEntry, mergeSessionEntry, } from "./types.js";
+// ============================================================================
+// Session Providers
+// ============================================================================
+export { createSendPolicyProvider, createSessionProvider, createSessionSkillsProvider, extractSessionContext, getSessionProviders, } from "./provider.js";

package/packages/typescript/src/sessions/provider.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Session provider for elizaOS runtime.
+ *
+ * Exposes session context to agents during message processing.
+ *
+ * @module sessions/provider
+ */
+import type { Provider } from "../types/components.js";
+import type { Memory } from "../types/memory.js";
+import type { SessionEntry } from "./types.js";
+/**
+ * Extract session context from a memory object.
+ *
+ * Looks for session information in:
+ * 1. memory.sessionId / memory.sessionKey
+ * 2. memory.metadata.session
+ * 3. memory.metadata.sessionId / memory.metadata.sessionKey
+ *
+ * @param memory - Memory to extract session from
+ * @returns Session context or null
+ */
+export declare function extractSessionContext(memory: Memory): {
+    sessionId?: string;
+    sessionKey?: string;
+    entry?: SessionEntry;
+} | null;
+/**
+ * Create a session provider that exposes session context.
+ *
+ * @param options - Provider options
+ * @returns Provider instance
+ */
+export declare function createSessionProvider(options?: {
+    /** Path to session store (defaults to runtime's configured store) */
+    storePath?: string;
+    /** Custom name for the provider */
+    name?: string;
+}): Provider;
+/**
+ * Create a provider that exposes session skills.
+ *
+ * @param options - Provider options
+ * @returns Provider instance
+ */
+export declare function createSessionSkillsProvider(options?: {
+    storePath?: string;
+    name?: string;
+}): Provider;
+/**
+ * Create a provider that enforces session send policy.
+ *
+ * When sendPolicy is "deny", adds strong guidance to prevent
+ * the agent from sending external messages.
+ *
+ * @param options - Provider options
+ * @returns Provider instance
+ */
+export declare function createSendPolicyProvider(options?: {
+    storePath?: string;
+    name?: string;
+}): Provider;
+/**
+ * Get all default session providers.
+ *
+ * @param options - Provider options
+ * @returns Array of session providers
+ */
+export declare function getSessionProviders(options?: {
+    storePath?: string;
+}): Provider[];
+//# sourceMappingURL=provider.d.ts.map

package/packages/typescript/src/sessions/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/sessions/provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,oBAAoB,CAAC;AAGjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB,GAAG,IAAI,CA0BP;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IAC/C,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,QAAQ,CAuEX;AAMD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,QAAQ,CAkDX;AAMD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,QAAQ,CA2DX;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,QAAQ,EAAE,CAMb"}

package/packages/typescript/src/sessions/provider.js

@@ -0,0 +1,243 @@
+/**
+ * Session provider for elizaOS runtime.
+ *
+ * Exposes session context to agents during message processing.
+ *
+ * @module sessions/provider
+ */
+// ============================================================================
+// Session Context Extraction
+// ============================================================================
+/**
+ * Extract session context from a memory object.
+ *
+ * Looks for session information in:
+ * 1. memory.sessionId / memory.sessionKey
+ * 2. memory.metadata.session
+ * 3. memory.metadata.sessionId / memory.metadata.sessionKey
+ *
+ * @param memory - Memory to extract session from
+ * @returns Session context or null
+ */
+export function extractSessionContext(memory) {
+    // Direct properties on memory (for backwards compat — runtime may attach extra fields)
+    const memoryRecord = memory;
+    const directSessionId = memoryRecord.sessionId;
+    const directSessionKey = memoryRecord.sessionKey;
+    // Metadata-based session info
+    const metadata = memory.metadata;
+    const metaSessionId = metadata?.sessionId;
+    const metaSessionKey = metadata?.sessionKey;
+    const metaSession = metadata?.session;
+    const sessionId = directSessionId ?? metaSessionId ?? metaSession?.sessionId;
+    const sessionKey = directSessionKey ?? metaSessionKey;
+    if (!sessionId && !sessionKey) {
+        return null;
+    }
+    return {
+        sessionId,
+        sessionKey,
+        entry: metaSession,
+    };
+}
+// ============================================================================
+// Session Provider
+// ============================================================================
+/**
+ * Create a session provider that exposes session context.
+ *
+ * @param options - Provider options
+ * @returns Provider instance
+ */
+export function createSessionProvider(options) {
+    return {
+        name: options?.name ?? "session",
+        description: "Current session context and state",
+        dynamic: true,
+        async get(_runtime, message, _state) {
+            const context = extractSessionContext(message);
+            if (!context) {
+                return {
+                    text: "No session context available.",
+                    data: { hasSession: false },
+                };
+            }
+            // Use session entry directly from context
+            const entry = context.entry;
+            // Build text representation
+            const lines = [];
+            lines.push(`Session ID: ${context.sessionId ?? "unknown"}`);
+            if (context.sessionKey) {
+                lines.push(`Session Key: ${context.sessionKey}`);
+            }
+            if (entry) {
+                if (entry.label) {
+                    lines.push(`Label: ${entry.label}`);
+                }
+                if (entry.chatType) {
+                    lines.push(`Chat Type: ${entry.chatType}`);
+                }
+                if (entry.channel) {
+                    lines.push(`Channel: ${entry.channel}`);
+                }
+                if (entry.modelOverride) {
+                    lines.push(`Model Override: ${entry.modelOverride}`);
+                }
+                if (entry.thinkingLevel) {
+                    lines.push(`Thinking Level: ${entry.thinkingLevel}`);
+                }
+                if (entry.sendPolicy === "deny") {
+                    lines.push("");
+                    lines.push("⚠️ SEND POLICY: DENY - Do not send messages externally.");
+                }
+                if (entry.totalTokens) {
+                    lines.push(`Total Tokens Used: ${entry.totalTokens}`);
+                }
+            }
+            return {
+                text: lines.join("\n"),
+                values: {
+                    sessionId: context.sessionId,
+                    sessionKey: context.sessionKey,
+                    hasSession: true,
+                },
+                data: {
+                    hasSession: true,
+                    sessionId: context.sessionId,
+                    sessionKey: context.sessionKey,
+                    entry: entry,
+                },
+            };
+        },
+    };
+}
+// ============================================================================
+// Session Skills Provider
+// ============================================================================
+/**
+ * Create a provider that exposes session skills.
+ *
+ * @param options - Provider options
+ * @returns Provider instance
+ */
+export function createSessionSkillsProvider(options) {
+    return {
+        name: options?.name ?? "sessionSkills",
+        description: "Skills active in the current session",
+        dynamic: true,
+        async get(_runtime, message, _state) {
+            const context = extractSessionContext(message);
+            if (!context) {
+                return {
+                    text: "No session skills available.",
+                    data: { hasSkills: false },
+                };
+            }
+            const entry = context.entry;
+            const snapshot = entry?.skillsSnapshot;
+            if (!snapshot?.skills.length) {
+                return {
+                    text: "No skills configured for this session.",
+                    data: { hasSkills: false, skills: [] },
+                };
+            }
+            const skillNames = snapshot.skills.map((s) => s.name);
+            const lines = [
+                `Active Skills: ${skillNames.join(", ")}`,
+                "",
+                snapshot.prompt,
+            ];
+            return {
+                text: lines.join("\n"),
+                values: {
+                    skillCount: skillNames.length,
+                    skillNames,
+                },
+                data: {
+                    hasSkills: true,
+                    skills: snapshot.skills,
+                    prompt: snapshot.prompt,
+                },
+            };
+        },
+    };
+}
+// ============================================================================
+// Send Policy Provider
+// ============================================================================
+/**
+ * Create a provider that enforces session send policy.
+ *
+ * When sendPolicy is "deny", adds strong guidance to prevent
+ * the agent from sending external messages.
+ *
+ * @param options - Provider options
+ * @returns Provider instance
+ */
+export function createSendPolicyProvider(options) {
+    return {
+        name: options?.name ?? "sendPolicy",
+        description: "Session send policy enforcement",
+        dynamic: true,
+        // High position to appear prominently in context
+        position: 100,
+        async get(_runtime, message, _state) {
+            const context = extractSessionContext(message);
+            if (!context) {
+                return {
+                    text: "",
+                    data: { sendPolicy: "allow" },
+                };
+            }
+            const entry = context.entry;
+            const sendPolicy = entry?.sendPolicy ?? "allow";
+            if (sendPolicy === "deny") {
+                return {
+                    text: [
+                        "🚫 SEND POLICY: DENY",
+                        "",
+                        "This session has sending DISABLED.",
+                        "Do NOT send messages to external channels.",
+                        "Do NOT use send/reply actions.",
+                        "You may still process and respond internally.",
+                    ].join("\n"),
+                    values: {
+                        sendPolicy: "deny",
+                        canSend: false,
+                    },
+                    data: {
+                        sendPolicy: "deny",
+                        canSend: false,
+                    },
+                };
+            }
+            return {
+                text: "",
+                values: {
+                    sendPolicy: "allow",
+                    canSend: true,
+                },
+                data: {
+                    sendPolicy: "allow",
+                    canSend: true,
+                },
+            };
+        },
+    };
+}
+// ============================================================================
+// Default Session Providers
+// ============================================================================
+/**
+ * Get all default session providers.
+ *
+ * @param options - Provider options
+ * @returns Array of session providers
+ */
+export function getSessionProviders(options) {
+    return [
+        createSessionProvider(options),
+        createSessionSkillsProvider(options),
+        createSendPolicyProvider(options),
+    ];
+}

package/packages/typescript/src/sessions/session-key.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Session key utilities for elizaOS.
+ *
+ * Provides functions for building, parsing, and normalizing session keys
+ * used to identify agent sessions, threads, and peer connections.
+ *
+ * Session keys follow the format: agent:{agentId}:{rest}
+ *
+ * @module sessions/session-key
+ */
+export declare const DEFAULT_AGENT_ID = "main";
+export declare const DEFAULT_MAIN_KEY = "main";
+export declare const DEFAULT_ACCOUNT_ID = "default";
+/**
+ * Parsed agent session key components.
+ */
+export type ParsedAgentSessionKey = {
+    /** The full original session key */
+    raw: string;
+    /** Agent ID extracted from the key */
+    agentId: string;
+    /** The remainder of the key after agent:{agentId}: */
+    rest: string;
+    /** Whether this is an ACP (Agent Communication Protocol) session */
+    isAcp: boolean;
+    /** Whether this is a subagent session */
+    isSubagent: boolean;
+    /** Thread ID if present */
+    threadId?: string;
+    /** Parent session key if this is a thread */
+    parentKey?: string;
+};
+/**
+ * Parse an agent session key into its components.
+ *
+ * Session keys follow the format:
+ * - agent:{agentId}:{rest}
+ * - agent:{agentId}:acp:{...}
+ * - agent:{agentId}:subagent:{subagentId}:{...}
+ * - agent:{agentId}:{...}:thread:{threadId}
+ *
+ * @param sessionKey - The session key to parse
+ * @returns Parsed components or null if invalid
+ */
+export declare function parseAgentSessionKey(sessionKey: string | undefined | null): ParsedAgentSessionKey | null;
+/**
+ * Check if a session key is an ACP session.
+ *
+ * @param sessionKey - The session key to check
+ * @returns True if this is an ACP session
+ */
+export declare function isAcpSessionKey(sessionKey: string | undefined | null): boolean;
+/**
+ * Check if a session key is a subagent session.
+ *
+ * @param sessionKey - The session key to check
+ * @returns True if this is a subagent session
+ */
+export declare function isSubagentSessionKey(sessionKey: string | undefined | null): boolean;
+/**
+ * Resolve the parent session key for a thread session.
+ *
+ * @param sessionKey - The session key to resolve
+ * @returns Parent session key or the original key if not a thread
+ */
+export declare function resolveThreadParentSessionKey(sessionKey: string | undefined | null): string | null;
+/**
+ * Normalize a main key value.
+ *
+ * @param value - Value to normalize
+ * @returns Normalized main key
+ */
+export declare function normalizeMainKey(value: string | undefined | null): string;
+/**
+ * Normalize an agent ID.
+ *
+ * Ensures the ID is path-safe and shell-friendly.
+ *
+ * @param value - Value to normalize
+ * @returns Normalized agent ID
+ */
+export declare function normalizeAgentId(value: string | undefined | null): string;
+/**
+ * Sanitize an agent ID (alias for normalizeAgentId).
+ *
+ * @param value - Value to sanitize
+ * @returns Sanitized agent ID
+ */
+export declare function sanitizeAgentId(value: string | undefined | null): string;
+/**
+ * Normalize an account ID.
+ *
+ * @param value - Value to normalize
+ * @returns Normalized account ID
+ */
+export declare function normalizeAccountId(value: string | undefined | null): string;
+/**
+ * Build an agent session key from components.
+ *
+ * @param agentId - The agent ID
+ * @param rest - The rest of the key
+ * @returns Formatted session key
+ */
+export declare function buildAgentSessionKey(agentId: string, rest: string): string;
+/**
+ * Build the main session key for an agent.
+ *
+ * @param params - Session key parameters
+ * @returns Main session key
+ */
+export declare function buildAgentMainSessionKey(params: {
+    agentId: string;
+    mainKey?: string | undefined;
+}): string;
+/**
+ * Build an ACP session key.
+ *
+ * @param agentId - The agent ID
+ * @param acpKey - The ACP-specific key portion
+ * @returns Formatted ACP session key
+ */
+export declare function buildAcpSessionKey(agentId: string, acpKey: string): string;
+/**
+ * Build a subagent session key.
+ *
+ * @param agentId - The parent agent ID
+ * @param subagentId - The subagent ID
+ * @param rest - Additional key portion
+ * @returns Formatted subagent session key
+ */
+export declare function buildSubagentSessionKey(agentId: string, subagentId: string, rest?: string): string;
+/**
+ * Build a peer session key for an agent.
+ *
+ * @param params - Peer session parameters
+ * @returns Peer session key
+ */
+export declare function buildAgentPeerSessionKey(params: {
+    agentId: string;
+    mainKey?: string | undefined;
+    channel: string;
+    accountId?: string | null;
+    peerKind?: "dm" | "group" | "channel" | null;
+    peerId?: string | null;
+    identityLinks?: Record<string, string[]>;
+    /** DM session scope. */
+    dmScope?: "main" | "per-peer" | "per-channel-peer" | "per-account-channel-peer";
+}): string;
+/**
+ * Convert a store session key to a request session key.
+ *
+ * @param storeKey - Store session key
+ * @returns Request session key or undefined
+ */
+export declare function toAgentRequestSessionKey(storeKey: string | undefined | null): string | undefined;
+/**
+ * Convert a request session key to a store session key.
+ *
+ * @param params - Conversion parameters
+ * @returns Store session key
+ */
+export declare function toAgentStoreSessionKey(params: {
+    agentId: string;
+    requestKey: string | undefined | null;
+    mainKey?: string | undefined;
+}): string;
+/**
+ * Resolve the agent ID from a session key.
+ *
+ * @param sessionKey - Session key to parse
+ * @returns Resolved agent ID
+ */
+export declare function resolveAgentIdFromSessionKey(sessionKey: string | undefined | null): string;
+/**
+ * Build a group history key.
+ *
+ * @param params - History key parameters
+ * @returns Group history key
+ */
+export declare function buildGroupHistoryKey(params: {
+    channel: string;
+    accountId?: string | null;
+    peerKind: "group" | "channel";
+    peerId: string;
+}): string;
+/**
+ * Resolve thread session keys.
+ *
+ * @param params - Thread resolution parameters
+ * @returns Session key and optional parent session key
+ */
+export declare function resolveThreadSessionKeys(params: {
+    baseSessionKey: string;
+    threadId?: string | null;
+    parentSessionKey?: string;
+    useSuffix?: boolean;
+}): {
+    sessionKey: string;
+    parentSessionKey?: string;
+};
+//# sourceMappingURL=session-key.d.ts.map

package/packages/typescript/src/sessions/session-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-key.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/sessions/session-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAY5C;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IACnC,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACnC,qBAAqB,GAAG,IAAI,CA4C9B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACnC,OAAO,CAGT;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACnC,OAAO,CAGT;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC5C,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACnC,MAAM,GAAG,IAAI,CAWf;AAUD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAGzE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAkBzE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAgB3E;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,GAAG,MAAM,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,wBAAwB;IACxB,OAAO,CAAC,EACL,MAAM,GACN,UAAU,GACV,kBAAkB,GAClB,0BAA0B,CAAC;CAC9B,GAAG,MAAM,CAqCT;AAoDD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACjC,MAAM,GAAG,SAAS,CAMpB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,GAAG,MAAM,CAgBT;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC3C,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACnC,MAAM,CAGR;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,CAWpD"}