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

package/dist/sessions/types.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Session types for elizaOS.
+ *
+ * Defines the core data structures for session management including
+ * session entries, scopes, origins, and related metadata.
+ *
+ * Note: Some session-related types (SessionOrigin, SessionModelOverride, etc.)
+ * are defined in types/memory.ts to avoid circular dependencies. This module
+ * imports them for use in SessionEntry but does not re-export them to avoid
+ * duplicate exports when both sessions and types are exported from index.
+ *
+ * @module sessions/types
+ */
+import type { SessionOrigin, SessionSkillsSnapshot } from "../types/memory.js";
+/**
+ * Normalized chat type for session classification.
+ */
+export type SessionChatType = "dm" | "group" | "channel" | "thread";
+/**
+ * Delivery context for routing responses.
+ */
+export type SessionDeliveryContext = {
+    /** Channel to deliver to */
+    channel?: string;
+    /** Target recipient/destination */
+    to?: string;
+    /** Account to use for delivery */
+    accountId?: string;
+    /** Thread to deliver to */
+    threadId?: string | number;
+};
+/**
+ * Core session entry representing a conversation session.
+ *
+ * This is the primary data structure for session state in elizaOS.
+ */
+export type SessionEntry = {
+    /** Unique session identifier (UUID) */
+    sessionId: string;
+    /** Last update timestamp (milliseconds since epoch) */
+    updatedAt: number;
+    /** Path to the session transcript file */
+    sessionFile?: string;
+    /** Parent session key that spawned this session (for subagent scoping) */
+    spawnedBy?: string;
+    /** Human-readable label for the session */
+    label?: string;
+    /** Display name for UI purposes */
+    displayName?: string;
+    /** Whether system introduction has been sent */
+    systemSent?: boolean;
+    /** Whether the last run was aborted */
+    abortedLastRun?: boolean;
+    /** Type of chat (dm, group, channel, thread) */
+    chatType?: SessionChatType;
+    /** Primary channel for this session */
+    channel?: string;
+    /** Group identifier (for group chats) */
+    groupId?: string;
+    /** Group subject/name */
+    subject?: string;
+    /** Group channel name (e.g., "#general") */
+    groupChannel?: string;
+    /** Space/server name (e.g., Discord guild) */
+    space?: string;
+    /** Origin information */
+    origin?: SessionOrigin;
+    /** Current delivery context */
+    deliveryContext?: SessionDeliveryContext;
+    /** Last channel used for delivery */
+    lastChannel?: string;
+    /** Last recipient */
+    lastTo?: string;
+    /** Last account used */
+    lastAccountId?: string;
+    /** Last thread ID */
+    lastThreadId?: string | number;
+    /** Thinking/reasoning level */
+    thinkingLevel?: string;
+    /** Verbose output level */
+    verboseLevel?: string;
+    /** Reasoning level */
+    reasoningLevel?: string;
+    /** Elevated permissions level */
+    elevatedLevel?: string;
+    /** Provider override */
+    providerOverride?: string;
+    /** Model override */
+    modelOverride?: string;
+    /** Auth profile override */
+    authProfileOverride?: string;
+    /** Source of auth profile override */
+    authProfileOverrideSource?: "auto" | "user";
+    /** Compaction count when auth profile was set */
+    authProfileOverrideCompactionCount?: number;
+    /** Input tokens consumed */
+    inputTokens?: number;
+    /** Output tokens generated */
+    outputTokens?: number;
+    /** Total tokens */
+    totalTokens?: number;
+    /** Context window tokens */
+    contextTokens?: number;
+    /** Number of compaction operations */
+    compactionCount?: number;
+    /** Model provider used */
+    modelProvider?: string;
+    /** Model identifier used */
+    model?: string;
+    /** Group activation mode (mention or always) */
+    groupActivation?: "mention" | "always";
+    /** Whether group needs system introduction */
+    groupActivationNeedsSystemIntro?: boolean;
+    /** Send policy (allow or deny responses) */
+    sendPolicy?: "allow" | "deny";
+    /** Response usage display mode */
+    responseUsage?: "on" | "off" | "tokens" | "full";
+    /** Text-to-speech auto mode */
+    ttsAuto?: "on" | "off" | "voice-only";
+    /** Execution host */
+    execHost?: string;
+    /** Execution security mode */
+    execSecurity?: string;
+    /** Execution ask mode */
+    execAsk?: string;
+    /** Execution node */
+    execNode?: string;
+    /** Timestamp when memory was last flushed */
+    memoryFlushAt?: number;
+    /** Compaction count when memory was flushed */
+    memoryFlushCompactionCount?: number;
+    /** Snapshot of active skills */
+    skillsSnapshot?: SessionSkillsSnapshot;
+    /** Last delivered heartbeat payload */
+    lastHeartbeatText?: string;
+    /** Timestamp when last heartbeat was sent */
+    lastHeartbeatSentAt?: number;
+    /** Map of CLI session identifiers */
+    cliSessionIds?: Record<string, string>;
+};
+/**
+ * Session store mapping session keys to entries.
+ */
+export type SessionStore = Record<string, SessionEntry>;
+/**
+ * Merge a session entry with a partial update.
+ *
+ * @param existing - Existing session entry (or undefined for new)
+ * @param patch - Partial updates to apply
+ * @returns Merged session entry
+ */
+export declare function mergeSessionEntry(existing: SessionEntry | undefined, patch: Partial<SessionEntry>): SessionEntry;
+/**
+ * Create a new session entry with minimal required fields.
+ *
+ * @param overrides - Optional field overrides
+ * @returns New session entry
+ */
+export declare function createSessionEntry(overrides?: Partial<SessionEntry>): SessionEntry;
+/**
+ * Check if a session entry is valid.
+ *
+ * @param entry - Entry to validate
+ * @returns True if entry has required fields
+ */
+export declare function isValidSessionEntry(entry: unknown): entry is SessionEntry;
+/**
+ * Result of resolving a session key.
+ */
+export type SessionResolution = {
+    /** The resolved session key */
+    sessionKey: string;
+    /** Whether this is a new session */
+    isNew: boolean;
+    /** The session entry */
+    entry: SessionEntry;
+};
+/**
+ * Result of resolving a group session key.
+ */
+export type GroupKeyResolution = {
+    /** The resolved group key */
+    key: string;
+    /** Channel identifier */
+    channel?: string;
+    /** Group/room identifier */
+    id?: string;
+    /** Chat type */
+    chatType?: SessionChatType;
+};
+/** Default trigger for resetting a session */
+export declare const DEFAULT_RESET_TRIGGER = "/new";
+/** All default reset triggers */
+export declare const DEFAULT_RESET_TRIGGERS: string[];
+/** Default idle timeout in minutes */
+export declare const DEFAULT_IDLE_MINUTES = 60;
+//# sourceMappingURL=types.d.ts.map

package/dist/sessions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"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"}

package/dist/settings.d.ts

@@ -0,0 +1,99 @@
+import type { Character, IAgentRuntime, OnboardingConfig, Setting, World, WorldSettings } from "./types";
+/**
+ * Creates a Setting object from a configSetting object by omitting the 'value' property.
+ *
+ * @param {Omit<Setting, 'value'>} configSetting - The configSetting object to create the Setting from.
+ * @returns {Setting} A new Setting object created from the provided configSetting object.
+ */
+export declare function createSettingFromConfig(configSetting: Omit<Setting, "value">): Setting;
+/**
+ * Gets the salt for the agent.
+ *
+ * @returns {string} The salt for the agent.
+ */
+export declare function getSalt(): string;
+/**
+ * Clears the salt cache - useful for tests or when environment changes
+ */
+export declare function clearSaltCache(): void;
+/**
+ * Common encryption function for string values
+ * @param {string} value - The string value to encrypt
+ * @param {string} salt - The salt to use for encryption
+ * @returns {string} - The encrypted value in 'iv:encrypted' format
+ */
+export declare function encryptStringValue(value: string, salt: string): string;
+/**
+ * Common decryption function for string values
+ * @param value - The encrypted value in 'iv:encrypted' format
+ * @param salt - The salt to use for decryption
+ * @returns The decrypted string value, or original value if not encrypted
+ */
+export declare function decryptStringValue(value: string, salt: string): string;
+/**
+ * Migrates an encrypted string from legacy v1 (AES-CBC) to v2 (AES-GCM).
+ *
+ * - v2 values are returned unchanged
+ * - v1 values are decrypted then re-encrypted as v2
+ * - non-encrypted values are returned unchanged
+ */
+export declare function migrateEncryptedStringValue(value: string, salt: string): string;
+/**
+ * Applies salt to the value of a setting
+ * Only applies to secret settings with string values
+ */
+export declare function saltSettingValue(setting: Setting, salt: string): Setting;
+/**
+ * Removes salt from the value of a setting
+ * Only applies to secret settings with string values
+ */
+export declare function unsaltSettingValue(setting: Setting, salt: string): Setting;
+/**
+ * Applies salt to all settings in a WorldSettings object
+ */
+export declare function saltWorldSettings(worldSettings: WorldSettings, salt: string): WorldSettings;
+/**
+ * Removes salt from all settings in a WorldSettings object
+ */
+export declare function unsaltWorldSettings(worldSettings: WorldSettings, salt: string): WorldSettings;
+/**
+ * Updates settings state in world metadata
+ */
+export declare function updateWorldSettings(runtime: IAgentRuntime, serverId: string, worldSettings: WorldSettings): Promise<boolean>;
+/**
+ * Gets settings state from world metadata
+ */
+export declare function getWorldSettings(runtime: IAgentRuntime, serverId: string): Promise<WorldSettings | null>;
+/**
+ * Initializes settings configuration for a server
+ */
+export declare function initializeOnboarding(runtime: IAgentRuntime, world: World, config: OnboardingConfig): Promise<WorldSettings | null>;
+/**
+ * Encrypts sensitive data in a Character object
+ * @param {Character} character - The character object to encrypt secrets for
+ * @returns {Character} - A copy of the character with encrypted secrets
+ */
+export declare function encryptedCharacter(character: Character): Character;
+/**
+ * Decrypts sensitive data in a Character object
+ * @param {Character} character - The character object with encrypted secrets
+ * @param {IAgentRuntime} runtime - The runtime information needed for salt generation
+ * @returns {Character} - A copy of the character with decrypted secrets
+ */
+export declare function decryptedCharacter(character: Character, _runtime: IAgentRuntime): Character;
+/**
+ * Helper function to encrypt all string values in an object
+ * @param {Record<string, string | number | boolean>} obj - Object with values to encrypt
+ * @param {string} salt - The salt to use for encryption
+ * @returns {Record<string, unknown>} - Object with encrypted values
+ */
+export declare function encryptObjectValues(obj: Record<string, string | number | boolean>, salt: string): Record<string, string | number | boolean>;
+/**
+ * Helper function to decrypt all string values in an object
+ * @param {Record<string, string | number | boolean>} obj - Object with encrypted values
+ * @param {string} salt - The salt to use for decryption
+ * @returns {Record<string, unknown>} - Object with decrypted values
+ */
+export declare function decryptObjectValues(obj: Record<string, string | number | boolean>, salt: string): Record<string, string | number | boolean>;
+export { decryptStringValue as decryptSecret };
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,KAAK,EACL,aAAa,EACb,MAAM,SAAS,CAAC;AAKjB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GACnC,OAAO,CAcT;AAoCD;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAiDhC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAsCtE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAiDtE;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACV,MAAM,CAeR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAaxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAa1E;AA0BD;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,MAAM,GACV,aAAa,CASf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,MAAM,GACV,aAAa,CASf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,aAAa,GAC1B,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAe/B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuC/B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAalE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,aAAa,GACrB,SAAS,CAaX;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAC9C,IAAI,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAY3C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAC9C,IAAI,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAY3C;AAED,OAAO,EAAE,kBAAkB,IAAI,aAAa,EAAE,CAAC"}

package/dist/streaming-context.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Streaming context management for automatic streaming in useModel calls.
+ *
+ * Follows the OpenTelemetry ContextManager pattern:
+ * - Interface for context management
+ * - Platform-specific implementations (Node.js AsyncLocalStorage, Browser Stack)
+ * - Auto-detected at runtime - no separate entry points needed
+ *
+ * @see https://opentelemetry.io/docs/languages/js/context/
+ */
+/**
+ * Streaming context containing callbacks for streaming lifecycle.
+ */
+export interface StreamingContext {
+    /** Called for each chunk of streamed content */
+    onStreamChunk: (chunk: string, messageId?: string) => Promise<void>;
+    /** Called when a useModel streaming call completes (allows reset between calls) */
+    onStreamEnd?: () => void;
+    messageId?: string;
+    /** Optional abort signal to cancel streaming */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Interface for streaming context managers.
+ * Different implementations exist for Node.js (AsyncLocalStorage) and Browser (Stack).
+ */
+export interface IStreamingContextManager {
+    /**
+     * Run a function with a streaming context.
+     * The context will be available to all nested async calls via `active()`.
+     */
+    run<T>(context: StreamingContext | undefined, fn: () => T): T;
+    /**
+     * Get the currently active streaming context.
+     * Returns undefined if no context is active.
+     */
+    active(): StreamingContext | undefined;
+}
+/**
+ * Set the global streaming context manager.
+ * Can be used to override the auto-detected manager.
+ *
+ * @param manager - The context manager to use globally
+ */
+export declare function setStreamingContextManager(manager: IStreamingContextManager): void;
+/**
+ * Get the global streaming context manager.
+ * Auto-detects and creates the appropriate manager on first access.
+ */
+export declare function getStreamingContextManager(): IStreamingContextManager;
+/**
+ * Run a function with a streaming context.
+ * All useModel calls within this function will automatically use streaming.
+ *
+ * @example
+ * ```typescript
+ * await runWithStreamingContext(
+ *   { onStreamChunk: async (chunk) => sendSSE(chunk), messageId },
+ *   async () => {
+ *     // All useModel calls here will stream automatically
+ *     await runtime.processMessage(message);
+ *   }
+ * );
+ * ```
+ *
+ * @param context - The streaming context with onStreamChunk callback
+ * @param fn - The function to run with streaming context
+ * @returns The result of the function
+ */
+export declare function runWithStreamingContext<T>(context: StreamingContext | undefined, fn: () => T): T;
+/**
+ * Get the currently active streaming context.
+ * Called by useModel to check if automatic streaming should be enabled.
+ *
+ * @returns The current streaming context or undefined
+ */
+export declare function getStreamingContext(): StreamingContext | undefined;
+//# sourceMappingURL=streaming-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-context.d.ts","sourceRoot":"","sources":["../src/streaming-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,gDAAgD;IAChD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACxC;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE9D;;;OAGG;IACH,MAAM,IAAI,gBAAgB,GAAG,SAAS,CAAC;CACvC;AA2GD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,wBAAwB,GAC/B,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,wBAAwB,CAErE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACxC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,EAAE,EAAE,MAAM,CAAC,GACT,CAAC,CAEH;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAElE"}

package/dist/trajectory-context.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Trajectory context management for benchmark/training traces.
+ *
+ * Mirrors the streaming context design:
+ * - Node.js: AsyncLocalStorage for async-safe propagation
+ * - Browser: stack-based fallback
+ */
+export interface TrajectoryContext {
+    trajectoryStepId?: string;
+}
+export interface ITrajectoryContextManager {
+    run<T>(context: TrajectoryContext | undefined, fn: () => T | Promise<T>): T | Promise<T>;
+    active(): TrajectoryContext | undefined;
+}
+export declare function setTrajectoryContextManager(manager: ITrajectoryContextManager): void;
+export declare function getTrajectoryContextManager(): ITrajectoryContextManager;
+export declare function runWithTrajectoryContext<T>(context: TrajectoryContext | undefined, fn: () => T | Promise<T>): T | Promise<T>;
+export declare function getTrajectoryContext(): TrajectoryContext | undefined;
+//# sourceMappingURL=trajectory-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory-context.d.ts","sourceRoot":"","sources":["../src/trajectory-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACzC,GAAG,CAAC,CAAC,EACJ,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACtB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClB,MAAM,IAAI,iBAAiB,GAAG,SAAS,CAAC;CACxC;AA6FD,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,yBAAyB,GAChC,IAAI,CAGN;AAED,wBAAgB,2BAA2B,IAAI,yBAAyB,CAEvE;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EACzC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACtB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhB;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,SAAS,CAEpE"}

package/dist/types/agent.d.ts

@@ -0,0 +1,54 @@
+import type { KnowledgeSourceItem } from "./knowledge";
+import type { Content } from "./primitives";
+import type { JsonValue, Agent as ProtoAgent, AgentStatus as ProtoAgentStatus, Character as ProtoCharacter, CharacterSettings as ProtoCharacterSettingsType, MessageExample as ProtoMessageExample, MessageExampleGroup as ProtoMessageExampleGroup } from "./proto.js";
+import type { State } from "./state";
+export type TemplateType = string | ((params: {
+    state: State | Record<string, string | number | boolean | null | undefined> | object;
+}) => string);
+/**
+ * Example message for demonstration
+ */
+export interface MessageExample extends Omit<ProtoMessageExample, "$typeName" | "$unknown" | "content"> {
+    content: Content;
+}
+export interface MessageExampleGroup extends Omit<ProtoMessageExampleGroup, "$typeName" | "$unknown" | "examples"> {
+    examples: MessageExample[];
+}
+export type CharacterSettings = Omit<ProtoCharacterSettingsType, "$typeName" | "$unknown" | "secrets"> & {
+    ENABLE_AUTONOMY?: boolean | string;
+    DISABLE_BASIC_CAPABILITIES?: boolean | string;
+    ENABLE_EXTENDED_CAPABILITIES?: boolean | string;
+    ADVANCED_CAPABILITIES?: boolean | string;
+    secrets?: Record<string, string | boolean | number>;
+    [key: string]: JsonValue | undefined;
+};
+export type ProtoCharacterSettings = ProtoCharacterSettingsType;
+export type Character = Partial<Omit<ProtoCharacter, "$typeName" | "$unknown" | "settings" | "messageExamples" | "knowledge" | "secrets">> & {
+    settings?: CharacterSettings;
+    secrets?: Record<string, string | number | boolean>;
+    messageExamples?: MessageExampleGroup[];
+    knowledge?: KnowledgeSourceItem[];
+    /** Enable advanced planning capabilities for this character */
+    advancedPlanning?: boolean;
+    /** Enable advanced memory capabilities for this character */
+    advancedMemory?: boolean;
+};
+export declare enum AgentStatus {
+    ACTIVE = "active",
+    INACTIVE = "inactive"
+}
+/**
+ * Represents an operational agent, extending the `Character` definition with runtime status and timestamps.
+ * While `Character` defines the blueprint, `Agent` represents an instantiated and potentially running version.
+ * It includes:
+ * - `enabled`: A boolean indicating if the agent is currently active or disabled.
+ * - `status`: The current operational status, typically `AgentStatus.ACTIVE` or `AgentStatus.INACTIVE`.
+ * - `createdAt`, `updatedAt`: Timestamps for when the agent record was created and last updated in the database.
+ * This interface is primarily used by the `IDatabaseAdapter` for agent management.
+ */
+export interface Agent extends Character, Omit<ProtoAgent, "$typeName" | "$unknown" | "character" | "status" | "createdAt" | "updatedAt" | "secrets"> {
+    status?: AgentStatus | ProtoAgentStatus;
+    createdAt: number | bigint;
+    updatedAt: number | bigint;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/types/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EACX,SAAS,EACT,KAAK,IAAI,UAAU,EACnB,WAAW,IAAI,gBAAgB,EAC/B,SAAS,IAAI,cAAc,EAC3B,iBAAiB,IAAI,0BAA0B,EAC/C,cAAc,IAAI,mBAAmB,EACrC,mBAAmB,IAAI,wBAAwB,EAC/C,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,YAAY,GACrB,MAAM,GACN,CAAC,CAAC,MAAM,EAAE;IACV,KAAK,EACF,KAAK,GACL,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAC5D,MAAM,CAAC;CACT,KAAK,MAAM,CAAC,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,cAChB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IACvE,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAChB,SAAQ,IAAI,CACX,wBAAwB,EACxB,WAAW,GAAG,UAAU,GAAG,UAAU,CACrC;IACD,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CACnC,0BAA0B,EAC1B,WAAW,GAAG,UAAU,GAAG,SAAS,CACpC,GAAG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACnC,0BAA0B,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9C,4BAA4B,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAChD,qBAAqB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACrC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,CAAC;AAChE,MAAM,MAAM,SAAS,GAAG,OAAO,CAC9B,IAAI,CACH,cAAc,EACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,iBAAiB,GACjB,WAAW,GACX,SAAS,CACX,CACD,GAAG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACxC,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,oBAAY,WAAW;IACtB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,KAChB,SAAQ,SAAS,EAChB,IAAI,CACH,UAAU,EACR,WAAW,GACX,UAAU,GACV,WAAW,GACX,QAAQ,GACR,WAAW,GACX,WAAW,GACX,SAAS,CACX;IACF,MAAM,CAAC,EAAE,WAAW,GAAG,gBAAgB,CAAC;IACxC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B"}