@elizaos/core 2.0.0-alpha.43 → 2.0.0-alpha.44

package/dist/types/plugin-manifest.d.ts

@@ -1,353 +0,0 @@
-/**
- * Plugin Manifest Types
- *
- * Defines the structure for plugin manifests (elizaos.plugin.json).
- * These manifests describe plugin metadata, configuration schemas,
- * and capabilities for discovery and loading.
- *
- * @module types/plugin-manifest
- */
-import type { JsonValue } from "./primitives.ts";
-/**
- * Plugin kind identifier for specialized plugins.
- */
-export type PluginKind = "memory" | "channel" | "provider" | "skill" | "database";
-/**
- * Plugin origin indicates where the plugin was discovered.
- */
-export type PluginOrigin = "bundled" | "global" | "workspace" | "config" | "npm";
-/**
- * UI hints for plugin configuration fields.
- */
-export interface PluginConfigUiHint {
-    /** Display label for the field */
-    label?: string;
-    /** Help text or description */
-    help?: string;
-    /** Mark as advanced configuration */
-    advanced?: boolean;
-    /** Mark as sensitive (e.g., API keys) */
-    sensitive?: boolean;
-    /** Placeholder text for input */
-    placeholder?: string;
-    /** Field type hint for UI rendering */
-    type?: "text" | "password" | "number" | "boolean" | "select" | "textarea";
-    /** Options for select fields */
-    options?: Array<{
-        value: string;
-        label: string;
-    }>;
-}
-/**
- * Plugin skill definition within a manifest.
- */
-export interface PluginSkillDefinition {
-    /** Skill identifier */
-    id: string;
-    /** Human-readable name */
-    name?: string;
-    /** Description of the skill */
-    description?: string;
-    /** Path to the skill file relative to plugin root */
-    path?: string;
-    /** Required binary dependencies */
-    requiresBins?: string[];
-    /** Required environment variables */
-    requiresEnv?: string[];
-    /** Required config keys */
-    requiresConfig?: string[];
-}
-/**
- * Plugin gateway method definition.
- */
-export interface PluginGatewayMethod {
-    /** Method name */
-    method: string;
-    /** Method description */
-    description?: string;
-    /** Input schema (JSON Schema) */
-    inputSchema?: Record<string, JsonValue>;
-    /** Output schema (JSON Schema) */
-    outputSchema?: Record<string, JsonValue>;
-}
-/**
- * Plugin manifest structure (elizaos.plugin.json).
- */
-export interface PluginManifest {
-    /** Unique plugin identifier */
-    id: string;
-    /** Human-readable plugin name */
-    name?: string;
-    /** Plugin description */
-    description?: string;
-    /** Plugin version (semver) */
-    version?: string;
-    /** Plugin kind for specialized handling */
-    kind?: PluginKind;
-    /** Configuration schema (JSON Schema) */
-    configSchema: Record<string, JsonValue>;
-    /** UI hints for configuration fields */
-    uiHints?: Record<string, PluginConfigUiHint>;
-    /** Channel identifiers this plugin provides */
-    channels?: string[];
-    /** Provider identifiers this plugin provides */
-    providers?: string[];
-    /** Skills this plugin provides */
-    skills?: string[] | PluginSkillDefinition[];
-    /** Gateway methods this plugin exposes */
-    gatewayMethods?: string[] | PluginGatewayMethod[];
-    /** CLI commands this plugin registers */
-    cliCommands?: string[];
-    /** Required secrets/API keys */
-    requiredSecrets?: string[];
-    /** Optional secrets/API keys */
-    optionalSecrets?: string[];
-    /** Plugin dependencies (other plugin IDs) */
-    dependencies?: string[];
-    /** Minimum ElizaOS version required */
-    minElizaVersion?: string;
-    /** Plugin author */
-    author?: string;
-    /** Plugin homepage URL */
-    homepage?: string;
-    /** Plugin repository URL */
-    repository?: string;
-    /** Plugin license */
-    license?: string;
-    /** Plugin keywords for search */
-    keywords?: string[];
-}
-/**
- * Result of loading a plugin manifest.
- */
-export type PluginManifestLoadResult = {
-    ok: true;
-    manifest: PluginManifest;
-    manifestPath: string;
-} | {
-    ok: false;
-    error: string;
-    manifestPath: string;
-};
-/**
- * Plugin diagnostic message.
- */
-export interface PluginDiagnostic {
-    /** Diagnostic severity */
-    level: "warn" | "error" | "info";
-    /** Diagnostic message */
-    message: string;
-    /** Associated plugin ID */
-    pluginId?: string;
-    /** Source file path */
-    source?: string;
-}
-/**
- * Plugin candidate discovered during scanning.
- */
-export interface PluginCandidate {
-    /** Derived plugin ID hint */
-    idHint: string;
-    /** Path to the plugin entry point */
-    source: string;
-    /** Plugin root directory */
-    rootDir: string;
-    /** Where the plugin was discovered */
-    origin: PluginOrigin;
-    /** Workspace directory if workspace-scoped */
-    workspaceDir?: string;
-    /** Package name from package.json */
-    packageName?: string;
-    /** Package version from package.json */
-    packageVersion?: string;
-    /** Package description from package.json */
-    packageDescription?: string;
-    /** Package directory */
-    packageDir?: string;
-    /** Extracted package manifest metadata */
-    packageManifest?: ElizaOSPackageManifest;
-}
-/**
- * Result of plugin discovery.
- */
-export interface PluginDiscoveryResult {
-    /** Discovered plugin candidates */
-    candidates: PluginCandidate[];
-    /** Discovery diagnostics */
-    diagnostics: PluginDiagnostic[];
-}
-/**
- * Plugin manifest record with additional metadata.
- */
-export interface PluginManifestRecord {
-    /** Plugin ID */
-    id: string;
-    /** Plugin name */
-    name?: string;
-    /** Plugin description */
-    description?: string;
-    /** Plugin version */
-    version?: string;
-    /** Plugin kind */
-    kind?: PluginKind;
-    /** Channels provided */
-    channels: string[];
-    /** Providers provided */
-    providers: string[];
-    /** Skills provided */
-    skills: string[];
-    /** Plugin origin */
-    origin: PluginOrigin;
-    /** Workspace directory */
-    workspaceDir?: string;
-    /** Plugin root directory */
-    rootDir: string;
-    /** Plugin entry point source */
-    source: string;
-    /** Path to the manifest file */
-    manifestPath: string;
-    /** Cache key for schema validation */
-    schemaCacheKey?: string;
-    /** Configuration schema */
-    configSchema?: Record<string, JsonValue>;
-    /** Configuration UI hints */
-    configUiHints?: Record<string, PluginConfigUiHint>;
-}
-/**
- * Plugin manifest registry containing all discovered manifests.
- */
-export interface PluginManifestRegistry {
-    /** Plugin manifest records */
-    plugins: PluginManifestRecord[];
-    /** Registry diagnostics */
-    diagnostics: PluginDiagnostic[];
-}
-/**
- * Channel metadata from package.json.
- */
-export interface PluginPackageChannel {
-    /** Channel identifier */
-    id?: string;
-    /** Display label */
-    label?: string;
-    /** Selection label for onboarding */
-    selectionLabel?: string;
-    /** Detail label */
-    detailLabel?: string;
-    /** Documentation path */
-    docsPath?: string;
-    /** Documentation label */
-    docsLabel?: string;
-    /** Short description */
-    blurb?: string;
-    /** Display order */
-    order?: number;
-    /** Alternative names */
-    aliases?: string[];
-    /** Channels this one is preferred over */
-    preferOver?: string[];
-    /** System image name (for icons) */
-    systemImage?: string;
-    /** Show configured status */
-    showConfigured?: boolean;
-    /** Allow from quickstart */
-    quickstartAllowFrom?: boolean;
-}
-/**
- * Installation metadata from package.json.
- */
-export interface PluginPackageInstall {
-    /** NPM package specifier */
-    npmSpec?: string;
-    /** Local path for development */
-    localPath?: string;
-    /** Default installation choice */
-    defaultChoice?: "npm" | "local";
-}
-/**
- * ElizaOS-specific metadata in package.json.
- */
-export interface ElizaOSPackageManifest {
-    /** Entry point extensions */
-    extensions?: string[];
-    /** Channel metadata */
-    channel?: PluginPackageChannel;
-    /** Installation metadata */
-    install?: PluginPackageInstall;
-}
-/**
- * Standard package.json structure with ElizaOS metadata.
- */
-export interface PackageManifest {
-    /** Package name */
-    name?: string;
-    /** Package version */
-    version?: string;
-    /** Package description */
-    description?: string;
-    /** ElizaOS-specific metadata */
-    elizaos?: ElizaOSPackageManifest;
-}
-/**
- * Plugin record in the runtime registry.
- */
-export interface PluginRecord {
-    /** Plugin ID */
-    id: string;
-    /** Plugin name */
-    name: string;
-    /** Plugin description */
-    description?: string;
-    /** Plugin version */
-    version?: string;
-    /** Plugin kind */
-    kind?: PluginKind;
-    /** Plugin entry point source */
-    source: string;
-    /** Plugin origin */
-    origin: PluginOrigin;
-    /** Workspace directory */
-    workspaceDir?: string;
-    /** Whether the plugin is enabled */
-    enabled: boolean;
-    /** Plugin status */
-    status: "loaded" | "disabled" | "error" | "pending";
-    /** Error message if status is error */
-    error?: string;
-    /** Registered tool names */
-    toolNames: string[];
-    /** Registered hook names */
-    hookNames: string[];
-    /** Channel IDs */
-    channelIds: string[];
-    /** Provider IDs */
-    providerIds: string[];
-    /** Gateway methods */
-    gatewayMethods: string[];
-    /** CLI commands */
-    cliCommands: string[];
-    /** Services */
-    services: string[];
-    /** Commands */
-    commands: string[];
-    /** HTTP handler count */
-    httpHandlers: number;
-    /** Hook count */
-    hookCount: number;
-    /** Has config schema */
-    configSchema: boolean;
-    /** Config UI hints */
-    configUiHints?: Record<string, PluginConfigUiHint>;
-    /** Config JSON schema */
-    configJsonSchema?: Record<string, JsonValue>;
-}
-/**
- * Plugin registry containing all loaded plugins.
- */
-export interface PluginRegistry {
-    /** Plugin records */
-    plugins: PluginRecord[];
-    /** Registry diagnostics */
-    diagnostics: PluginDiagnostic[];
-}
-//# sourceMappingURL=plugin-manifest.d.ts.map

package/dist/types/plugin-manifest.d.ts.map

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

package/dist/types/plugin.d.ts

@@ -1,146 +0,0 @@
-import type { Character } from "./agent";
-import type { Action, Evaluator, Provider } from "./components";
-import type { IDatabaseAdapter } from "./database";
-import type { EventHandler, EventPayload, EventPayloadMap } from "./events";
-import type { ModelParamsMap, PluginModelResult } from "./model";
-import type { JsonValue, ComponentTypeDefinition as ProtoComponentTypeDefinition, JSONSchemaDefinition as ProtoJSONSchemaDefinition, RouteManifest as ProtoRouteManifest } from "./proto.js";
-import type { IAgentRuntime } from "./runtime";
-import type { Service } from "./service";
-import type { TestSuite } from "./testing";
-/**
- * Type for a service class constructor.
- * This is more flexible than `typeof Service` to allow for:
- * - Service classes with more specific `serviceType` values (e.g., "task" instead of string)
- * - Service classes that properly extend the base Service class
- */
-export interface ServiceClass {
-    /** The service type identifier */
-    serviceType: string;
-    /** Factory method to create and start the service */
-    start(runtime: IAgentRuntime): Promise<Service>;
-    /** Stop service for a runtime - optional as not all services implement this */
-    stopRuntime?(runtime: IAgentRuntime): Promise<void>;
-    /** Optional static method to register send handlers */
-    registerSendHandlers?(runtime: IAgentRuntime, service: Service): void;
-    /** Constructor (optional runtime parameter) */
-    new (runtime?: IAgentRuntime): Service;
-}
-/**
- * Supported types for route request body fields
- */
-export type RouteBodyValue = JsonValue;
-/**
- * Minimal request interface
- * Plugins can use this type for route handlers
- */
-export interface RouteRequest {
-    body?: Record<string, RouteBodyValue>;
-    params?: Record<string, string>;
-    query?: Record<string, string | string[]>;
-    headers?: Record<string, string | string[] | undefined>;
-    method?: string;
-    path?: string;
-    url?: string;
-}
-/**
- * Minimal response interface
- * Plugins can use this type for route handlers
- */
-export interface RouteResponse {
-    status: (code: number) => RouteResponse;
-    json: (data: unknown) => RouteResponse;
-    send: (data: unknown) => RouteResponse;
-    end: () => RouteResponse;
-    setHeader?: (name: string, value: string | string[]) => RouteResponse;
-    sendFile?: (path: string) => RouteResponse;
-    headersSent?: boolean;
-}
-interface BaseRoute {
-    type: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "STATIC";
-    path: string;
-    filePath?: string;
-    handler?: (req: RouteRequest, res: RouteResponse, runtime: IAgentRuntime) => Promise<void>;
-    isMultipart?: boolean;
-    /** x402 payment configuration for this route. If present, the route requires payment. */
-    x402?: {
-        /** Price in USDC base units (6 decimals, e.g. "1000000" = $1.00) */
-        price: string;
-        /** Override network (defaults to agent's configured network) */
-        network?: string;
-        /** Override payTo address (defaults to agent's configured address) */
-        payTo?: string;
-        /** Description of what is being paid for */
-        description?: string;
-    };
-}
-interface PublicRoute extends BaseRoute {
-    public: true;
-    name: string;
-}
-interface PrivateRoute extends BaseRoute {
-    public?: false;
-    name?: string;
-}
-export type Route = PublicRoute | PrivateRoute;
-/**
- * JSON Schema type definition for component validation
- */
-export type JSONSchemaDefinition = ProtoJSONSchemaDefinition;
-/**
- * Component type definition for entity components
- */
-export interface ComponentTypeDefinition extends Omit<ProtoComponentTypeDefinition, "schema"> {
-    schema: JSONSchemaDefinition;
-    validator?: (data: Record<string, RouteBodyValue>) => boolean;
-}
-/**
- * Plugin for extending agent functionality
- */
-export type PluginEvents = {
-    [K in keyof EventPayloadMap]?: EventHandler<K>[];
-};
-/** Internal type for runtime event storage - allows dynamic access for event registration */
-export type RuntimeEventStorage = PluginEvents & {
-    [key: string]: ((params: EventPayloadMap[keyof EventPayloadMap] | EventPayload) => Promise<void>)[] | undefined;
-};
-export interface Plugin {
-    name: string;
-    description: string;
-    init?: (config: Record<string, string>, runtime: IAgentRuntime) => Promise<void>;
-    /** Plugin configuration - string keys to primitive values */
-    config?: Record<string, string | number | boolean | null>;
-    /**
-     * Service classes to be registered with the runtime.
-     * Uses ServiceClass interface which is more flexible than `typeof Service`
-     * to allow service classes with specific serviceType values.
-     */
-    services?: ServiceClass[];
-    /** Entity component definitions with JSON schema */
-    componentTypes?: ComponentTypeDefinition[];
-    actions?: Action[];
-    providers?: Provider[];
-    evaluators?: Evaluator[];
-    adapter?: IDatabaseAdapter;
-    models?: {
-        [K in keyof ModelParamsMap]?: (runtime: IAgentRuntime, params: ModelParamsMap[K]) => Promise<PluginModelResult<K>>;
-    };
-    events?: PluginEvents;
-    routes?: Route[];
-    tests?: TestSuite[];
-    dependencies?: string[];
-    testDependencies?: string[];
-    priority?: number;
-    schema?: Record<string, JsonValue | object>;
-}
-export interface ProjectAgent {
-    character: Character;
-    init?: (runtime: IAgentRuntime) => Promise<void>;
-    plugins?: Plugin[];
-    tests?: TestSuite | TestSuite[];
-}
-export interface Project {
-    agents: ProjectAgent[];
-}
-export type RouteManifest = ProtoRouteManifest;
-export {};
-//# sourceMappingURL=plugin.d.ts.map

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

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

package/dist/types/primitives.d.ts

@@ -1,170 +0,0 @@
-import type { UnknownField } from "@bufbuild/protobuf";
-import type { JsonObject, Content as ProtoContent, JsonValue as ProtoJsonValue, Media as ProtoMedia, MentionContext as ProtoMentionContext } from "./proto.js";
-export type JsonValue = ProtoJsonValue;
-/**
- * Defines a UUID as a string for protobuf interoperability.
- */
-export type UUID = string;
-/**
- * Channel types for messaging
- */
-export declare const ChannelType: {
-    readonly SELF: "SELF";
-    readonly DM: "DM";
-    readonly GROUP: "GROUP";
-    readonly VOICE_DM: "VOICE_DM";
-    readonly VOICE_GROUP: "VOICE_GROUP";
-    readonly FEED: "FEED";
-    readonly THREAD: "THREAD";
-    readonly WORLD: "WORLD";
-    readonly FORUM: "FORUM";
-    readonly API: "API";
-};
-export type ChannelType = (typeof ChannelType)[keyof typeof ChannelType];
-/**
- * The default UUID used when no room or world is specified.
- * This is the nil/zero UUID (00000000-0000-0000-0000-000000000000).
- * Using this allows users to spin up an AgentRuntime without worrying about room/world setup.
- */
-export declare const DEFAULT_UUID: UUID;
-/**
- * Helper function to safely cast a string to strongly typed UUID
- * @param id The string UUID to validate and cast
- * @returns The same UUID with branded type information
- * @throws Error if the id is not a valid UUID format
- */
-export declare function asUUID(id: string): UUID;
-/**
- * Allowed value types for content dynamic properties
- */
-export type ContentValue = ProtoJsonValue | undefined | ContentValue[] | {
-    [key: string]: ContentValue;
-};
-/**
- * Represents the content of a memory, message, or other information.
- * This is the primary data structure for messages exchanged between
- * users, agents, and the system.
- */
-export interface Content extends Omit<ProtoContent, "$typeName" | "$unknown" | "actions" | "providers" | "attachments" | "channelType" | "inReplyTo" | "mentionContext" | "responseMessageId" | "responseId"> {
-    /** The agent's internal thought process */
-    thought?: string;
-    /** The main text content visible to users */
-    text?: string;
-    /** Actions to be performed */
-    actions?: string[];
-    /** Providers to use for context generation */
-    providers?: string[];
-    /** Source/origin of the content (e.g., 'discord', 'telegram') */
-    source?: string;
-    /** Target/destination for responses */
-    target?: string;
-    /** URL of the original message/post (e.g. post URL, Discord message link) */
-    url?: string;
-    /** UUID of parent message if this is a reply/thread */
-    inReplyTo?: UUID;
-    /** Array of media attachments */
-    attachments?: Media[];
-    /** Channel type where this content was sent */
-    channelType?: ChannelType;
-    /** Platform-provided metadata about mentions */
-    mentionContext?: MentionContext;
-    /**
-     * Internal message ID used for streaming coordination.
-     * Set during response generation to ensure streaming chunks and
-     * final broadcast use the same message ID.
-     */
-    responseMessageId?: UUID;
-    /**
-     * Response ID for message tracking.
-     * Used to coordinate between streaming and final response.
-     */
-    responseId?: UUID;
-    /**
-     * Whether this is a simple response (no actions required).
-     * Used for optimization in the message handler.
-     */
-    simple?: boolean;
-    /**
-     * Results from action callbacks
-     */
-    actionCallbacks?: Content;
-    /**
-     * Results from evaluator callbacks
-     */
-    evalCallbacks?: Content;
-    /**
-     * Type marker for internal use
-     */
-    type?: string;
-    /**
-     * Additional dynamic properties for plugin extensions
-     */
-    [key: string]: ContentValue | ChannelType | MentionContext | Media[] | Content | UnknownField[] | undefined;
-}
-/**
- * Platform-provided metadata about mentions.
- * Contains ONLY technical facts from the platform API.
- * This allows bootstrap to make intelligent decisions about responding
- * while keeping platform-specific logic isolated.
- */
-export interface MentionContext extends Omit<ProtoMentionContext, "$typeName" | "$unknown"> {
-    /** Platform native mention (@Discord, @Telegram, etc.) */
-    isMention: boolean;
-    /** Reply to agent's message */
-    isReply: boolean;
-    /** In a thread with agent */
-    isThread: boolean;
-    /** Platform-specific mention type for debugging/logging */
-    mentionType?: "platform_mention" | "reply" | "thread" | "none";
-}
-/**
- * Represents a media attachment
- */
-export type Media = Omit<ProtoMedia, "$typeName" | "$unknown" | "contentType"> & {
-    /** Unique identifier */
-    id: string;
-    /** Media URL */
-    url: string;
-    /** Media title */
-    title?: string;
-    /** Media source */
-    source?: string;
-    /** Media description */
-    description?: string;
-    /** Text content */
-    text?: string;
-    /** Content type */
-    contentType?: ContentType;
-};
-export declare const ContentType: {
-    readonly IMAGE: "image";
-    readonly VIDEO: "video";
-    readonly AUDIO: "audio";
-    readonly DOCUMENT: "document";
-    readonly LINK: "link";
-};
-export type ContentType = (typeof ContentType)[keyof typeof ContentType];
-/**
- * Allowed value types for metadata (JSON-serializable).
- *
- * This type is intentionally broad to accept:
- * - Primitive JSON values (string, number, boolean, null)
- * - Arrays of metadata values
- * - Complex domain objects with UUID fields (template literal strings)
- *
- * The Record<string, unknown> union member ensures that domain types like
- * ContactInfo, RelationshipData, etc. are accepted without requiring
- * unsafe 'as unknown as' casts.
- */
-export type MetadataValue = ProtoJsonValue | undefined | MetadataValue[] | {
-    readonly [key: string]: MetadataValue | undefined;
-} | JsonObject;
-/**
- * A type for metadata objects with JSON-serializable values.
- * Accepts any object shape that can be serialized to JSON.
- * The index signature allows dynamic property access.
- */
-export type Metadata = {
-    [key: string]: MetadataValue;
-};
-//# sourceMappingURL=primitives.d.ts.map