@elizaos/core 2.0.0-alpha.52 → 2.0.0-alpha.53

package/dist/request-context.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Request context management for per-entity settings in multi-tenant deployments.
+ *
+ * Follows the OpenTelemetry ContextManager pattern (same as streaming-context.ts):
+ * - Interface for context management
+ * - Platform-specific implementations (Node.js AsyncLocalStorage, Browser Stack)
+ * - Global singleton configured at startup
+ *
+ * This enables sharing a single agent runtime across multiple users while ensuring
+ * each user's API keys, OAuth tokens, and configuration are used for their specific requests.
+ *
+ * @example
+ * ```typescript
+ * // Before processing a user's message
+ * const entitySettings = await prefetchEntitySettings(userId, agentId);
+ *
+ * await runWithRequestContext({
+ *   entityId: userId,
+ *   agentId: agentId,
+ *   entitySettings: new Map([
+ *     ['OPENAI_API_KEY', 'sk-user-specific-key'],
+ *     ['TWITTER_ACCESS_TOKEN', 'oauth-token-for-user'],
+ *   ]),
+ *   requestStartTime: Date.now(),
+ * }, async () => {
+ *   // All getSetting() calls here check entitySettings first
+ *   await runtime.handleMessage(message);
+ * });
+ * ```
+ */
+import type { UUID } from "./types";
+/**
+ * The value types that can be stored in entity settings.
+ * Matches the return type of getSetting().
+ */
+export type EntitySettingValue = string | boolean | number | null;
+/**
+ * Request-scoped context containing per-entity settings.
+ * Used to isolate user settings across concurrent requests sharing the same runtime.
+ */
+export interface RequestContext {
+    /**
+     * The entity (user) ID for this request.
+     * Used to identify which user's settings should be used.
+     */
+    entityId: UUID;
+    /**
+     * The agent ID for this request.
+     * Used for agent-specific entity settings lookup.
+     */
+    agentId: UUID;
+    /**
+     * Pre-fetched entity-specific settings.
+     * These take highest priority in getSetting() resolution chain.
+     *
+     * The Map contains setting keys and their values:
+     * - string/boolean/number: The actual setting value to use
+     * - null: Explicitly unset (use agent default)
+     * - undefined (key not present): Fall through to agent settings
+     */
+    entitySettings: Map<string, EntitySettingValue>;
+    /**
+     * Request start timestamp for observability and debugging.
+     * Useful for tracking request duration and timeout handling.
+     */
+    requestStartTime: number;
+    /**
+     * Optional trace ID for distributed tracing.
+     * Can be passed from incoming request headers (e.g., X-Trace-Id).
+     */
+    traceId?: string;
+    /**
+     * Optional organization ID for multi-tenant deployments.
+     * Used for logging and auditing purposes.
+     */
+    organizationId?: string;
+}
+/**
+ * Interface for request context managers.
+ * Different implementations exist for Node.js (AsyncLocalStorage) and Browser (fallback).
+ */
+export interface IRequestContextManager {
+    /**
+     * Run a function with a request context.
+     * The context will be available to all nested async calls via `active()`.
+     *
+     * @param context - The request context to make available, or undefined to clear context
+     * @param fn - The function to run within the context
+     * @returns The result of the function
+     */
+    run<T>(context: RequestContext | undefined, fn: () => T): T;
+    /**
+     * Get the currently active request context.
+     * Returns undefined if no context is active (e.g., during plugin init).
+     *
+     * @returns The current request context or undefined
+     */
+    active(): RequestContext | undefined;
+}
+/**
+ * Set the global request context manager.
+ * Called during initialization by platform-specific entry points.
+ *
+ * @param manager - The context manager to use globally
+ */
+export declare function setRequestContextManager(manager: IRequestContextManager): void;
+/**
+ * Get the global request context manager.
+ * Useful for testing or advanced use cases.
+ *
+ * @returns The current global request context manager
+ */
+export declare function getRequestContextManager(): IRequestContextManager;
+/**
+ * Run a function with a request context.
+ * All getSetting() calls within this function will check entitySettings first.
+ *
+ * @example
+ * ```typescript
+ * const result = await runWithRequestContext({
+ *   entityId: userId as UUID,
+ *   agentId: agentId as UUID,
+ *   entitySettings: new Map([['API_KEY', 'user-specific-key']]),
+ *   requestStartTime: Date.now(),
+ * }, async () => {
+ *   // Inside here, runtime.getSetting('API_KEY') returns 'user-specific-key'
+ *   return await runtime.processMessage(message);
+ * });
+ * ```
+ *
+ * @param context - The request context with entitySettings
+ * @param fn - The function to run with request context
+ * @returns The result of the function
+ */
+export declare function runWithRequestContext<T>(context: RequestContext | undefined, fn: () => T): T;
+/**
+ * Get the currently active request context.
+ * Called by getSetting() to check for entity-specific settings.
+ *
+ * @returns The current request context or undefined if not in a request
+ */
+export declare function getRequestContext(): RequestContext | undefined;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../src/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,EAAE,IAAI,CAAC;IAEf;;;OAGG;IACH,OAAO,EAAE,IAAI,CAAC;IAEd;;;;;;;;OAQG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAEhD;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,MAAM,IAAI,cAAc,GAAG,SAAS,CAAC;CACtC;AAqBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,sBAAsB,CAEjE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAEH;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D"}

package/dist/roles.d.ts

@@ -0,0 +1,9 @@
+import type { IAgentRuntime, Role, World } from "./types";
+export interface ServerOwnershipState {
+    servers: {
+        [serverId: string]: World;
+    };
+}
+export declare function getUserServerRole(runtime: IAgentRuntime, entityId: string, serverId: string): Promise<Role>;
+export declare function findWorldsForOwner(runtime: IAgentRuntime, entityId: string): Promise<World[] | null>;
+//# sourceMappingURL=roles.d.ts.map

package/dist/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../src/roles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAQ,KAAK,EAAE,MAAM,SAAS,CAAC;AAIhE,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE;QACR,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;KAC1B,CAAC;CACF;AAED,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CA6BzB"}