@elizaos/agent 0.25.8 → 2.0.0-alpha.144

package/packages/typescript/src/types/agentEvent.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Agent Event Types
+ *
+ * Defines types for agent event streaming - lifecycle events, tool usage,
+ * assistant responses, errors, messages, actions, evaluators, memory, and
+ * custom application events.
+ *
+ * These events enable real-time monitoring of agent activity and
+ * can be used for debugging, analytics, and UI updates.
+ */
+import type { UUID } from "./primitives.ts";
+/**
+ * Standard event streams for agent activity
+ */
+export type AgentEventStream = "lifecycle" | "tool" | "assistant" | "error" | "heartbeat" | "message" | "action" | "evaluator" | "provider" | "memory" | (string & {});
+/**
+ * Verbose levels for event filtering
+ */
+export type AgentVerboseLevel = "quiet" | "normal" | "verbose" | "debug";
+/**
+ * Payload for a single agent event
+ */
+export interface AgentEventPayload {
+    /** Unique identifier for the agent run */
+    runId: string;
+    /** Monotonically increasing sequence number per run */
+    seq: number;
+    /** The event stream category */
+    stream: AgentEventStream;
+    /** Unix timestamp in milliseconds */
+    ts: number;
+    /** Event-specific data */
+    data: Record<string, unknown>;
+    /** Optional session key for routing */
+    sessionKey?: string;
+    /** Optional agent ID */
+    agentId?: string;
+    /** Optional room ID */
+    roomId?: UUID;
+}
+/**
+ * Context for an agent run - used to enrich events with session info
+ */
+export interface AgentRunContext {
+    /** Session key for routing events to specific clients */
+    sessionKey?: string;
+    /** Verbose level for event filtering */
+    verboseLevel?: AgentVerboseLevel;
+    /** Whether this run is a heartbeat check */
+    isHeartbeat?: boolean;
+    /** Optional agent ID */
+    agentId?: string;
+    /** Optional room ID */
+    roomId?: string;
+}
+/**
+ * Heartbeat status types
+ */
+export type HeartbeatStatus = "sent" | "ok-empty" | "ok-token" | "skipped" | "failed";
+/**
+ * Heartbeat indicator types for UI status display
+ */
+export type HeartbeatIndicatorType = "ok" | "alert" | "error";
+/**
+ * Payload for heartbeat events
+ */
+export interface HeartbeatEventPayload {
+    /** Unix timestamp in milliseconds */
+    ts: number;
+    /** Heartbeat status */
+    status: HeartbeatStatus;
+    /** Target of the heartbeat (e.g., channel/user) */
+    to?: string;
+    /** Message preview */
+    preview?: string;
+    /** Duration in milliseconds */
+    durationMs?: number;
+    /** Whether the heartbeat included media */
+    hasMedia?: boolean;
+    /** Reason for status (e.g., failure reason) */
+    reason?: string;
+    /** The channel this heartbeat was sent to */
+    channel?: string;
+    /** Whether the message was silently suppressed */
+    silent?: boolean;
+    /** Indicator type for UI status display */
+    indicatorType?: HeartbeatIndicatorType;
+}
+/**
+ * Listener function for agent events
+ */
+export type AgentEventListener = (event: AgentEventPayload) => void;
+/**
+ * Listener function for heartbeat events
+ */
+export type HeartbeatEventListener = (event: HeartbeatEventPayload) => void;
+/**
+ * Event input without auto-generated fields (seq, ts)
+ */
+export type AgentEventInput = Omit<AgentEventPayload, "seq" | "ts">;
+/**
+ * Heartbeat input without auto-generated timestamp
+ */
+export type HeartbeatEventInput = Omit<HeartbeatEventPayload, "ts">;
+/**
+ * Lifecycle event data types
+ */
+export interface LifecycleEventData {
+    type: "run_start" | "run_end" | "step_start" | "step_end" | "context_loaded" | "action_start" | "action_end";
+    stepName?: string;
+    actionName?: string;
+    duration?: number;
+    success?: boolean;
+    error?: string;
+}
+/**
+ * Tool event data types
+ */
+export interface ToolEventData {
+    type: "tool_call" | "tool_result" | "tool_error";
+    toolName: string;
+    input?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+    duration?: number;
+    error?: string;
+}
+/**
+ * Assistant event data types
+ */
+export interface AssistantEventData {
+    type: "message" | "thought" | "plan" | "reflection";
+    content: string;
+    role?: "assistant" | "user" | "system";
+    tokens?: number;
+}
+/**
+ * Error event data types
+ */
+export interface ErrorEventData {
+    type: "error" | "warning";
+    code?: string;
+    message: string;
+    stack?: string;
+    recoverable?: boolean;
+}
+/**
+ * Message event data types - for inbound/outbound messages
+ */
+export interface MessageEventData {
+    type: "received" | "sent" | "queued" | "failed";
+    /** Message ID */
+    messageId?: UUID;
+    /** Channel the message came from or was sent to */
+    channel?: string;
+    /** The user or target ID */
+    userId?: UUID;
+    /** Room ID where the message occurred */
+    roomId?: UUID;
+    /** Message content (may be truncated) */
+    content?: string;
+    /** Whether the message has attachments */
+    hasAttachments?: boolean;
+    /** Delivery timestamp */
+    deliveredAt?: number;
+    /** Failure reason if type is 'failed' */
+    error?: string;
+    /** Index signature for Record<string, unknown> compatibility */
+    [key: string]: unknown;
+}
+/**
+ * Action event data types - for action execution
+ */
+export interface ActionEventData {
+    type: "start" | "complete" | "error" | "skipped";
+    /** Action name */
+    actionName: string;
+    /** Action handler name (if different from actionName) */
+    handler?: string;
+    /** Input parameters to the action */
+    input?: Record<string, unknown>;
+    /** Output result from the action */
+    output?: Record<string, unknown>;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Whether the action succeeded */
+    success?: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Memory ID associated with this action */
+    memoryId?: UUID;
+    /** Index signature for Record<string, unknown> compatibility */
+    [key: string]: unknown;
+}
+/**
+ * Evaluator event data types - for evaluator execution
+ */
+export interface EvaluatorEventData {
+    type: "start" | "complete" | "error" | "skipped";
+    /** Evaluator name */
+    evaluatorName: string;
+    /** Whether the evaluator validation passed */
+    validated?: boolean;
+    /** Evaluation result/score */
+    result?: unknown;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Error message if failed */
+    error?: string;
+    /** Message ID being evaluated */
+    messageId?: UUID;
+    /** Index signature for Record<string, unknown> compatibility */
+    [key: string]: unknown;
+}
+/**
+ * Provider event data types - for provider data fetching
+ */
+export interface ProviderEventData {
+    type: "start" | "complete" | "error" | "cached";
+    /** Provider name */
+    providerName: string;
+    /** Data returned by the provider (may be truncated) */
+    data?: unknown;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Whether the result was served from cache */
+    fromCache?: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Token count if provider returns text */
+    tokens?: number;
+    /** Index signature for Record<string, unknown> compatibility */
+    [key: string]: unknown;
+}
+/**
+ * Memory event data types - for memory operations
+ */
+export interface MemoryEventData {
+    type: "create" | "update" | "delete" | "search" | "retrieved";
+    /** Memory ID */
+    memoryId?: UUID;
+    /** Memory table/collection name */
+    tableName?: string;
+    /** Room ID associated with the memory */
+    roomId?: UUID;
+    /** Number of memories affected or retrieved */
+    count?: number;
+    /** Whether the operation succeeded */
+    success?: boolean;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Error message if failed */
+    error?: string;
+    /** Content preview (truncated) */
+    preview?: string;
+    /** Index signature for Record<string, unknown> compatibility */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=agentEvent.d.ts.map

package/packages/typescript/src/types/agentEvent.d.ts.map

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

package/packages/typescript/src/types/agentEvent.js

@@ -0,0 +1,11 @@
+/**
+ * Agent Event Types
+ *
+ * Defines types for agent event streaming - lifecycle events, tool usage,
+ * assistant responses, errors, messages, actions, evaluators, memory, and
+ * custom application events.
+ *
+ * These events enable real-time monitoring of agent activity and
+ * can be used for debugging, analytics, and UI updates.
+ */
+export {};

package/packages/typescript/src/types/channel-config.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Shared channel configuration types for Eliza plugins.
+ *
+ * These types define the common configuration patterns used across
+ * all communication channel plugins (Discord, Telegram, WhatsApp, etc.).
+ */
+import type { NormalizedChatType } from "../utils/channel-utils.js";
+/** Reply mode for message responses. */
+export type ReplyMode = "text" | "command";
+/** Typing indicator behavior. */
+export type TypingMode = "never" | "instant" | "thinking" | "message";
+/** Session scoping strategy. */
+export type SessionScope = "per-sender" | "global";
+/** DM session scoping strategy. */
+export type DmScope = "main" | "per-peer" | "per-channel-peer" | "per-account-channel-peer";
+/** Reply threading mode. */
+export type ReplyToMode = "off" | "first" | "all";
+/**
+ * Group message handling policy.
+ * - "open": groups bypass allowlists; mention-gating applies
+ * - "disabled": block all group messages
+ * - "allowlist": only allow configured groups/channels
+ */
+export type GroupPolicy = "open" | "disabled" | "allowlist";
+/**
+ * Direct message access policy.
+ * - "pairing": unknown senders get a pairing code; owner must approve
+ * - "allowlist": only allow senders in allowFrom list
+ * - "open": allow all inbound DMs (requires allowFrom to include "*")
+ * - "disabled": ignore all inbound DMs
+ */
+export type DmPolicy = "pairing" | "allowlist" | "open" | "disabled";
+/** Retry policy for outbound API calls. */
+export type OutboundRetryConfig = {
+    /** Max retry attempts (default: 3). */
+    attempts?: number;
+    /** Minimum retry delay in ms (default: 300-500ms depending on provider). */
+    minDelayMs?: number;
+    /** Maximum retry delay cap in ms (default: 30000). */
+    maxDelayMs?: number;
+    /** Jitter factor (0-1) applied to delays (default: 0.1). */
+    jitter?: number;
+};
+/** Block streaming coalescing configuration. */
+export type BlockStreamingCoalesceConfig = {
+    minChars?: number;
+    maxChars?: number;
+    idleMs?: number;
+};
+/** Block streaming chunking configuration. */
+export type BlockStreamingChunkConfig = {
+    minChars?: number;
+    maxChars?: number;
+    breakPreference?: "paragraph" | "newline" | "sentence";
+};
+/** Markdown table rendering mode - re-exported from markdown module for convenience */
+export type { MarkdownTableMode } from "../markdown/ir.js";
+/** Markdown formatting configuration. */
+export type MarkdownConfig = {
+    /** Table rendering mode (off|bullets|code). */
+    tables?: import("../markdown/ir.js").MarkdownTableMode;
+};
+/** Human-like delay configuration for responses. */
+export type HumanDelayConfig = {
+    /** Delay style for block replies (off|natural|custom). */
+    mode?: "off" | "natural" | "custom";
+    /** Minimum delay in milliseconds (default: 800). */
+    minMs?: number;
+    /** Maximum delay in milliseconds (default: 2500). */
+    maxMs?: number;
+};
+export type SessionSendPolicyAction = "allow" | "deny";
+export type SessionSendPolicyMatch = {
+    channel?: string;
+    chatType?: NormalizedChatType;
+    keyPrefix?: string;
+};
+export type SessionSendPolicyRule = {
+    action: SessionSendPolicyAction;
+    match?: SessionSendPolicyMatch;
+};
+export type SessionSendPolicyConfig = {
+    default?: SessionSendPolicyAction;
+    rules?: SessionSendPolicyRule[];
+};
+export type SessionResetMode = "daily" | "idle";
+export type SessionResetConfig = {
+    mode?: SessionResetMode;
+    /** Local hour (0-23) for the daily reset boundary. */
+    atHour?: number;
+    /** Sliding idle window (minutes). When set with daily mode, whichever expires first wins. */
+    idleMinutes?: number;
+};
+export type SessionResetByTypeConfig = {
+    dm?: SessionResetConfig;
+    group?: SessionResetConfig;
+    thread?: SessionResetConfig;
+};
+export type SessionConfig = {
+    scope?: SessionScope;
+    /** DM session scoping (default: "main"). */
+    dmScope?: DmScope;
+    /** Map platform-prefixed identities to canonical DM peers. */
+    identityLinks?: Record<string, string[]>;
+    resetTriggers?: string[];
+    idleMinutes?: number;
+    reset?: SessionResetConfig;
+    resetByType?: SessionResetByTypeConfig;
+    /** Channel-specific reset overrides. */
+    resetByChannel?: Record<string, SessionResetConfig>;
+    store?: string;
+    typingIntervalSeconds?: number;
+    typingMode?: TypingMode;
+    mainKey?: string;
+    sendPolicy?: SessionSendPolicyConfig;
+    agentToAgent?: {
+        /** Max ping-pong turns between requester/target (0–5). Default: 5. */
+        maxPingPongTurns?: number;
+    };
+};
+export type ChannelHeartbeatVisibilityConfig = {
+    /** Show HEARTBEAT_OK acknowledgments in chat (default: false). */
+    showOk?: boolean;
+    /** Show heartbeat alerts with actual content (default: true). */
+    showAlerts?: boolean;
+    /** Emit indicator events for UI status display (default: true). */
+    useIndicator?: boolean;
+};
+export type IdentityConfig = {
+    name?: string;
+    theme?: string;
+    emoji?: string;
+    /** Avatar image: workspace-relative path, http(s) URL, or data URI. */
+    avatar?: string;
+};
+export type ToolProfileId = "minimal" | "coding" | "messaging" | "full";
+export type ToolPolicyConfig = {
+    allow?: string[];
+    /** Additional allowlist entries merged into the effective allowlist. */
+    alsoAllow?: string[];
+    deny?: string[];
+    profile?: ToolProfileId;
+};
+export type GroupToolPolicyConfig = {
+    allow?: string[];
+    /** Additional allowlist entries merged into allow. */
+    alsoAllow?: string[];
+    deny?: string[];
+};
+export type GroupToolPolicyBySenderConfig = Record<string, GroupToolPolicyConfig>;
+export type GroupChatConfig = {
+    mentionPatterns?: string[];
+    historyLimit?: number;
+};
+export type DmConfig = {
+    historyLimit?: number;
+};
+export type NativeCommandsSetting = boolean | "auto";
+export type ProviderCommandsConfig = {
+    /** Override native command registration for this provider (bool or "auto"). */
+    native?: NativeCommandsSetting;
+    /** Override native skill command registration for this provider (bool or "auto"). */
+    nativeSkills?: NativeCommandsSetting;
+};
+/** Allowlists keyed by provider id (and internal "webchat"). */
+export type AgentElevatedAllowFromConfig = Partial<Record<string, Array<string | number>>>;
+//# sourceMappingURL=channel-config.d.ts.map

package/packages/typescript/src/types/channel-config.d.ts.map

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

package/packages/typescript/src/types/channel-config.js

@@ -0,0 +1,7 @@
+/**
+ * Shared channel configuration types for Eliza plugins.
+ *
+ * These types define the common configuration patterns used across
+ * all communication channel plugins (Discord, Telegram, WhatsApp, etc.).
+ */
+export {};