@elizaos/api-client 1.4.2 → 1.4.3-alpha.0

package/dist/core/src/settings.d.ts

@@ -0,0 +1,87 @@
+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;
+/**
+ * Retrieves the salt based on env variable SECRET_SALT
+ *
+ * @returns {string} The salt for the agent.
+ */
+export declare function getSalt(): string;
+/**
+ * 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 {string} value - The encrypted value in 'iv:encrypted' format
+ * @param {string} salt - The salt to use for decryption
+ * @returns {string} - The decrypted string value
+ */
+export declare function decryptStringValue(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, any>} obj - Object with values to encrypt
+ * @param {string} salt - The salt to use for encryption
+ * @returns {Record<string, any>} - Object with encrypted values
+ */
+export declare function encryptObjectValues(obj: Record<string, any>, salt: string): Record<string, any>;
+/**
+ * Helper function to decrypt all string values in an object
+ * @param {Record<string, any>} obj - Object with encrypted values
+ * @param {string} salt - The salt to use for decryption
+ * @returns {Record<string, any>} - Object with decrypted values
+ */
+export declare function decryptObjectValues(obj: Record<string, any>, salt: string): Record<string, any>;
+export { decryptStringValue as decryptSecret };
+//# sourceMappingURL=settings.d.ts.map

package/dist/core/src/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../../core/src/settings.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,KAAK,EACL,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,OAAO,CActF;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAWhC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA4CtE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAqDtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CASxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAS1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQ3F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQ7F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAc/B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgC/B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAgBlE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,SAAS,CAgB3F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAY/F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAY/F;AAED,OAAO,EAAE,kBAAkB,IAAI,aAAa,EAAE,CAAC"}

package/dist/core/src/types/agent.d.ts

@@ -0,0 +1,98 @@
+import type { DirectoryItem } from './knowledge';
+import type { Content, UUID } from './primitives';
+import type { State } from './state';
+/**
+ * Example message for demonstration
+ */
+export interface MessageExample {
+    /** Associated user */
+    name: string;
+    /** Message content */
+    content: Content;
+}
+export type TemplateType = string | ((options: {
+    state: State | {
+        [key: string]: string;
+    };
+}) => string);
+/**
+ * Configuration for an agent's character, defining its personality, knowledge, and capabilities.
+ * This is a central piece of an agent's definition, used by the `AgentRuntime` to initialize and operate the agent.
+ * It includes:
+ * - `id`: Optional unique identifier for the character.
+ * - `name`, `username`: Identifying names for the character.
+ * - `system`: A system prompt that guides the agent's overall behavior.
+ * - `templates`: A map of prompt templates for various situations (e.g., message generation, summarization).
+ * - `bio`: A textual biography or description of the character.
+ * - `messageExamples`, `postExamples`: Examples of how the character communicates.
+ * - `topics`, `adjectives`: Keywords describing the character's knowledge areas and traits.
+ * - `knowledge`: Paths to knowledge files or directories to be loaded into the agent's memory.
+ * - `plugins`: A list of plugin names to be loaded for this character.
+ * - `settings`, `secrets`: Configuration key-value pairs, with secrets being handled more securely.
+ * - `style`: Guidelines for the character's writing style in different contexts (chat, post).
+ */
+export interface Character {
+    /** Optional unique identifier */
+    id?: UUID;
+    /** Character name */
+    name: string;
+    /** Optional username */
+    username?: string;
+    /** Optional system prompt */
+    system?: string;
+    /** Optional prompt templates */
+    templates?: {
+        [key: string]: TemplateType;
+    };
+    /** Character biography */
+    bio: string | string[];
+    /** Example messages */
+    messageExamples?: MessageExample[][];
+    /** Example posts */
+    postExamples?: string[];
+    /** Known topics */
+    topics?: string[];
+    /** Character traits */
+    adjectives?: string[];
+    /** Optional knowledge base */
+    knowledge?: (string | {
+        path: string;
+        shared?: boolean;
+    } | DirectoryItem)[];
+    /** Available plugins */
+    plugins?: string[];
+    /** Optional configuration */
+    settings?: {
+        [key: string]: string | boolean | number | Record<string, any>;
+    };
+    /** Optional secrets */
+    secrets?: {
+        [key: string]: string | boolean | number;
+    };
+    /** Writing style guides */
+    style?: {
+        all?: string[];
+        chat?: string[];
+        post?: string[];
+    };
+}
+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 {
+    enabled?: boolean;
+    status?: AgentStatus;
+    createdAt: number;
+    updatedAt: number;
+}
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,CAAC,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;CAAE,KAAK,MAAM,CAAC,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,EAAE,CAAC,EAAE,IAAI,CAAC;IAEV,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,SAAS,CAAC,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;KAC7B,CAAC;IAEF,0BAA0B;IAC1B,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEvB,uBAAuB;IACvB,eAAe,CAAC,EAAE,cAAc,EAAE,EAAE,CAAC;IAErC,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa,CAAC,EAAE,CAAC;IAE5E,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACT,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChE,CAAC;IAEF,uBAAuB;IACvB,OAAO,CAAC,EAAE;QACR,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;KAC1C,CAAC;IAEF,2BAA2B;IAC3B,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAM,SAAQ,SAAS;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/core/src/types/browser.d.ts

@@ -0,0 +1,127 @@
+import { Service } from './service';
+export interface BrowserNavigationOptions {
+    timeout?: number;
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2';
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    userAgent?: string;
+    headers?: Record<string, string>;
+}
+export interface ScreenshotOptions {
+    fullPage?: boolean;
+    clip?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    format?: 'png' | 'jpeg' | 'webp';
+    quality?: number;
+    omitBackground?: boolean;
+}
+export interface ElementSelector {
+    selector: string;
+    text?: string;
+    timeout?: number;
+}
+export interface ExtractedContent {
+    text: string;
+    html: string;
+    links: Array<{
+        url: string;
+        text: string;
+    }>;
+    images: Array<{
+        src: string;
+        alt?: string;
+    }>;
+    title?: string;
+    metadata?: Record<string, string>;
+}
+export interface ClickOptions {
+    timeout?: number;
+    force?: boolean;
+    waitForNavigation?: boolean;
+}
+export interface TypeOptions {
+    delay?: number;
+    timeout?: number;
+    clear?: boolean;
+}
+/**
+ * Interface for browser automation services
+ */
+export declare abstract class IBrowserService extends Service {
+    static readonly serviceType: "browser";
+    readonly capabilityDescription = "Web browser automation and scraping capabilities";
+    /**
+     * Navigate to a URL
+     * @param url - URL to navigate to
+     * @param options - Navigation options
+     * @returns Promise resolving when navigation completes
+     */
+    abstract navigate(url: string, options?: BrowserNavigationOptions): Promise<void>;
+    /**
+     * Take a screenshot of the current page
+     * @param options - Screenshot options
+     * @returns Promise resolving to screenshot buffer
+     */
+    abstract screenshot(options?: ScreenshotOptions): Promise<Buffer>;
+    /**
+     * Extract text and content from the current page
+     * @param selector - Optional CSS selector to extract from specific element
+     * @returns Promise resolving to extracted content
+     */
+    abstract extractContent(selector?: string): Promise<ExtractedContent>;
+    /**
+     * Click on an element
+     * @param selector - CSS selector or element selector
+     * @param options - Click options
+     * @returns Promise resolving when click completes
+     */
+    abstract click(selector: string | ElementSelector, options?: ClickOptions): Promise<void>;
+    /**
+     * Type text into an input field
+     * @param selector - CSS selector for input field
+     * @param text - Text to type
+     * @param options - Typing options
+     * @returns Promise resolving when typing completes
+     */
+    abstract type(selector: string, text: string, options?: TypeOptions): Promise<void>;
+    /**
+     * Wait for an element to appear
+     * @param selector - CSS selector or element selector
+     * @returns Promise resolving when element is found
+     */
+    abstract waitForElement(selector: string | ElementSelector): Promise<void>;
+    /**
+     * Evaluate JavaScript in the browser context
+     * @param script - JavaScript code to evaluate
+     * @param args - Arguments to pass to the script
+     * @returns Promise resolving to evaluation result
+     */
+    abstract evaluate<T = any>(script: string, ...args: any[]): Promise<T>;
+    /**
+     * Get the current page URL
+     * @returns Promise resolving to current URL
+     */
+    abstract getCurrentUrl(): Promise<string>;
+    /**
+     * Go back in browser history
+     * @returns Promise resolving when navigation completes
+     */
+    abstract goBack(): Promise<void>;
+    /**
+     * Go forward in browser history
+     * @returns Promise resolving when navigation completes
+     */
+    abstract goForward(): Promise<void>;
+    /**
+     * Refresh the current page
+     * @returns Promise resolving when refresh completes
+     */
+    abstract refresh(): Promise<void>;
+}
+//# sourceMappingURL=browser.d.ts.map

package/dist/core/src/types/browser.d.ts.map

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

package/dist/core/src/types/components.d.ts

@@ -0,0 +1,135 @@
+import type { Memory } from './memory';
+import type { Content } from './primitives';
+import type { IAgentRuntime } from './runtime';
+import type { State } from './state';
+/**
+ * Example content with associated user for demonstration purposes
+ */
+export interface ActionExample {
+    /** User associated with the example */
+    name: string;
+    /** Content of the example */
+    content: Content;
+}
+/**
+ * Callback function type for handlers
+ */
+export type HandlerCallback = (response: Content, files?: any) => Promise<Memory[]>;
+/**
+ * Handler function type for processing messages
+ */
+export type Handler = (runtime: IAgentRuntime, message: Memory, state?: State, options?: {
+    [key: string]: unknown;
+}, callback?: HandlerCallback, responses?: Memory[]) => Promise<ActionResult | void | undefined>;
+/**
+ * Validator function type for actions/evaluators
+ */
+export type Validator = (runtime: IAgentRuntime, message: Memory, state?: State) => Promise<boolean>;
+/**
+ * Represents an action the agent can perform
+ */
+export interface Action {
+    /** Similar action descriptions */
+    similes?: string[];
+    /** Detailed description */
+    description: string;
+    /** Example usages */
+    examples?: ActionExample[][];
+    /** Handler function */
+    handler: Handler;
+    /** Action name */
+    name: string;
+    /** Validation function */
+    validate: Validator;
+}
+/**
+ * Example for evaluating agent behavior
+ */
+export interface EvaluationExample {
+    /** Evaluation context */
+    prompt: string;
+    /** Example messages */
+    messages: Array<ActionExample>;
+    /** Expected outcome */
+    outcome: string;
+}
+/**
+ * Evaluator for assessing agent responses
+ */
+export interface Evaluator {
+    /** Whether to always run */
+    alwaysRun?: boolean;
+    /** Detailed description */
+    description: string;
+    /** Similar evaluator descriptions */
+    similes?: string[];
+    /** Example evaluations */
+    examples: EvaluationExample[];
+    /** Handler function */
+    handler: Handler;
+    /** Evaluator name */
+    name: string;
+    /** Validation function */
+    validate: Validator;
+}
+export interface ProviderResult {
+    values?: {
+        [key: string]: any;
+    };
+    data?: {
+        [key: string]: any;
+    };
+    text?: string;
+}
+/**
+ * Provider for external data/services
+ */
+export interface Provider {
+    /** Provider name */
+    name: string;
+    /** Description of the provider */
+    description?: string;
+    /** Whether the provider is dynamic */
+    dynamic?: boolean;
+    /** Position of the provider in the provider list, positive or negative */
+    position?: number;
+    /**
+     * Whether the provider is private
+     *
+     * Private providers are not displayed in the regular provider list, they have to be called explicitly
+     */
+    private?: boolean;
+    /** Data retrieval function */
+    get: (runtime: IAgentRuntime, message: Memory, state: State) => Promise<ProviderResult>;
+}
+/**
+ * Result returned by an action after execution
+ * Used for action chaining and state management
+ */
+export interface ActionResult {
+    /** Optional text description of the result */
+    text?: string;
+    /** Values to merge into the state */
+    values?: Record<string, any>;
+    /** Data payload containing action-specific results */
+    data?: Record<string, any>;
+    /** Whether the action succeeded - defaults to true */
+    success: boolean;
+    /** Error information if the action failed */
+    error?: string | Error;
+}
+/**
+ * Context provided to actions during execution
+ * Allows actions to access previous results and update state
+ */
+export interface ActionContext {
+    /** Results from previously executed actions in this run */
+    previousResults: ActionResult[];
+    /** Get a specific previous result by action name */
+    getPreviousResult?: (actionName: string) => ActionResult | undefined;
+}
+/**
+ * Helper function to create ActionResult with proper defaults
+ */
+export declare function createActionResult(partial?: Partial<ActionResult>): ActionResult;
+//# sourceMappingURL=components.d.ts.map

package/dist/core/src/types/components.d.ts.map

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