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

package/dist/types/task.d.ts

@@ -0,0 +1,127 @@
+import type { Memory } from "./memory";
+import type { UUID } from "./primitives";
+import type { JsonValue, Task as ProtoTask, TaskMetadata as ProtoTaskMetadata, TaskStatus as ProtoTaskStatus } from "./proto.js";
+import type { IAgentRuntime } from "./runtime";
+import type { State } from "./state";
+import type { TriggerConfig, TriggerRunRecord } from "./trigger";
+/**
+ * Defines the contract for a Task Worker, which is responsible for executing a specific type of task.
+ * Task workers are registered with the `AgentRuntime` and are invoked when a `Task` of their designated `name` needs processing.
+ * WHY two gates: shouldRun (scheduler) has no message/state; canExecute (actions) has full context for auth (e.g. approval roles).
+ */
+export interface TaskWorker {
+    /** The unique name of the task type this worker handles. This name links `Task` instances to this worker. */
+    name: string;
+    /**
+     * The core execution logic for the task. This function is called by the runtime when a task needs to be processed.
+     * It receives the `AgentRuntime`, task-specific `options`, and the `Task` object itself.
+     * May return `{ nextInterval?: number }` to dynamically adjust the task's updateInterval (recurring tasks only).
+     * WHY return nextInterval: workers can adapt rate (e.g. back off under load) without separate updateTask calls.
+     */
+    execute: (runtime: IAgentRuntime, options: Record<string, JsonValue | object>, task: Task) => Promise<undefined | {
+        nextInterval?: number;
+    }>;
+    /**
+     * Called by the scheduler before each run -- "should this task run now?"
+     * If absent, the task always passes scheduler validation.
+     * WHY separate from execute: scheduler has no message/state; avoids loading context just to skip.
+     */
+    shouldRun?: (runtime: IAgentRuntime, task: Task) => Promise<boolean>;
+    /**
+     * Called by actions (e.g. choice) to check authorization -- "can this user trigger this task?"
+     * If absent, execution is always allowed.
+     * WHY separate from shouldRun: choice action has message/state for role checks (e.g. approval allowedRoles).
+     */
+    canExecute?: (runtime: IAgentRuntime, message: Memory, state: State) => Promise<boolean>;
+    /**
+     * @deprecated Use `shouldRun` (scheduler) or `canExecute` (actions) instead.
+     * Optional validation function; kept for backward compatibility with compiled plugins.
+     */
+    validate?: (runtime: IAgentRuntime, message: Memory, state: State) => Promise<boolean>;
+}
+/**
+ * Defines metadata associated with a `Task`.
+ * This can include scheduling information like `updateInterval` or UI-related details
+ * for presenting task options to a user.
+ * The `[key: string]: unknown;` allows for additional, unspecified metadata fields.
+ */
+export interface TaskMetadata extends Omit<ProtoTaskMetadata, "$typeName" | "$unknown" | "values"> {
+    targetEntityId?: string;
+    reason?: string;
+    priority?: "low" | "medium" | "high";
+    message?: string;
+    status?: string;
+    scheduledAt?: string;
+    snoozedAt?: string;
+    originalScheduledAt?: JsonValue;
+    createdAt?: string;
+    completedAt?: string;
+    completionNotes?: string;
+    lastExecuted?: string;
+    updatedAt?: number;
+    /** Optional. If the task is recurring, this specifies the interval in milliseconds between updates or executions. */
+    updateInterval?: number;
+    /** Optional. Original interval to restore on success when worker does not return nextInterval. WHY: backoff multiplies interval; we need the original base so we don't compound (exponential-of-exponential). */
+    baseInterval?: number;
+    /** Optional. Window (ms) before ideal next run when task may run. Earliest run = idealNextRun - notBefore. WHY: allows jitter/earlier run within a window. */
+    notBefore?: number;
+    /** Optional. Window (ms) after ideal next run; run is considered overdue after idealNextRun + notAfter. WHY: detect and log overdue tasks. */
+    notAfter?: number;
+    /** Optional. If true, the scheduler skips this task. WHY: operators pause/resume via API without deleting the task. */
+    paused?: boolean;
+    /** Optional. Consecutive failure count; reset to 0 on success. WHY: drive backoff and auto-pause after maxFailures. */
+    failureCount?: number;
+    /** Optional. Auto-pause after this many consecutive failures. undefined = 5. Use -1 (not Infinity; JSON loses it) to never auto-pause. WHY: prevent infinite retry storms; operators can resume after fixing. */
+    maxFailures?: number;
+    /** Optional. Last error message for debugging. WHY: getTaskStatus and logs show why a task failed. */
+    lastError?: string;
+    /**
+     * Optional. If true (default), the task will block the next scheduled execution while it's running.
+     * Set to false to allow overlapping executions (use with caution - can cause resource contention).
+     * @default true
+     */
+    blocking?: boolean;
+    /** Optional. Describes options or parameters that can be configured for this task, often for UI presentation. */
+    options?: {
+        name: string;
+        description: string;
+    }[];
+    /** Allows for other dynamic metadata properties related to the task. */
+    values?: Record<string, JsonValue | object>;
+    /** Optional. Trigger configuration for trigger-based tasks. */
+    trigger?: TriggerConfig;
+    /** Optional. History of trigger run records. */
+    triggerRuns?: TriggerRunRecord[];
+    [key: string]: JsonValue | object | undefined;
+}
+/**
+ * Represents a task to be performed, often in the background or at a later time.
+ * Tasks are managed by the `AgentRuntime` and processed by registered `TaskWorker`s.
+ * They can be associated with a room, world, and tagged for categorization and retrieval.
+ * The `IDatabaseAdapter` handles persistence of task data.
+ */
+export interface Task extends Omit<ProtoTask, "$typeName" | "$unknown" | "id" | "roomId" | "worldId" | "entityId" | "metadata" | "createdAt" | "updatedAt" | "dueAt" | "status"> {
+    id?: UUID;
+    roomId?: UUID;
+    worldId?: UUID;
+    entityId?: UUID;
+    /** Agent that owns this task. WHY: multi-tenant safety; getTasks can filter by agentId so each runtime only sees its tasks. */
+    agentId?: UUID;
+    metadata?: TaskMetadata;
+    createdAt?: number | bigint;
+    updatedAt?: number | bigint;
+    dueAt?: number | bigint;
+    status?: ProtoTaskStatus;
+}
+/**
+ * Status returned by TaskService.getTaskStatus for a single task.
+ * WHY: operators and UIs need nextRunAt, paused, lastError without reading raw task metadata.
+ */
+export interface TaskRunStatus {
+    task: Task | null;
+    paused: boolean;
+    executing: boolean;
+    nextRunAt?: number;
+    lastError?: string;
+}
+//# sourceMappingURL=task.d.ts.map

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

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

package/dist/types/tee.d.ts

@@ -0,0 +1,3 @@
+import type { DeriveKeyAttestationData, RemoteAttestationMessage, RemoteAttestationQuote, TEEMode, TeeAgent, TeePluginConfig, TeeType } from "./proto.js";
+export type { DeriveKeyAttestationData, RemoteAttestationMessage, RemoteAttestationQuote, TEEMode, TeeAgent, TeePluginConfig, TeeType, };
+//# sourceMappingURL=tee.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tee.d.ts","sourceRoot":"","sources":["../../src/types/tee.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,OAAO,EACP,QAAQ,EACR,eAAe,EACf,OAAO,EACP,MAAM,YAAY,CAAC;AAEpB,YAAY,EACX,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,OAAO,EACP,QAAQ,EACR,eAAe,EACf,OAAO,GACP,CAAC"}

package/dist/types/testing.d.ts

@@ -0,0 +1,15 @@
+import type { TestCase as ProtoTestCase, TestSuite as ProtoTestSuite } from "./proto.js";
+import type { IAgentRuntime } from "./runtime";
+/**
+ * Represents a test case for evaluating agent or plugin functionality.
+ */
+export interface TestCase extends Omit<ProtoTestCase, "$typeName" | "$unknown" | "handlerId"> {
+    fn: (runtime: IAgentRuntime) => Promise<void> | void;
+}
+/**
+ * Represents a suite of related test cases for an agent or plugin.
+ */
+export interface TestSuite extends Omit<ProtoTestSuite, "$typeName" | "$unknown" | "tests"> {
+    tests: TestCase[];
+}
+//# sourceMappingURL=testing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/types/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,QAAQ,IAAI,aAAa,EACzB,SAAS,IAAI,cAAc,EAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,QAChB,SAAQ,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;IACnE,EAAE,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,SAChB,SAAQ,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IAChE,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB"}

package/dist/types/tools.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Tool Policy Types
+ *
+ * Types and definitions for tool/action filtering and permissions in elizaOS.
+ *
+ * @module tools
+ */
+export type { ToolPolicyConfig, ToolProfileId } from "./channel-config";
+import type { ToolPolicyConfig, ToolProfileId } from "./channel-config";
+/**
+ * Canonical tool name aliases for backward compatibility.
+ * Maps legacy names to canonical names.
+ */
+export declare const TOOL_NAME_ALIASES: Record<string, string>;
+/**
+ * Predefined tool groups for easier policy configuration.
+ * Use "group:<name>" syntax in policy configs (e.g., "group:fs").
+ */
+export declare const TOOL_GROUPS: Record<string, string[]>;
+/**
+ * Predefined tool profiles with default allow/deny policies.
+ */
+export declare const TOOL_PROFILES: Record<ToolProfileId, ToolPolicyConfig>;
+/**
+ * Plugin tool groups for dynamic tool resolution.
+ */
+export interface PluginToolGroups {
+    /** All tool names from plugins */
+    all: string[];
+    /** Tool names organized by plugin ID */
+    byPlugin: Map<string, string[]>;
+}
+/**
+ * Result of allowlist resolution with diagnostics.
+ */
+export interface AllowlistResolution {
+    /** The resolved policy after processing */
+    policy: ToolPolicyConfig | undefined;
+    /** Entries in the allowlist that weren't recognized */
+    unknownAllowlist: string[];
+    /** Whether the allowlist was stripped (contained only plugin tools) */
+    strippedAllowlist: boolean;
+}
+/**
+ * Tool policy evaluation options.
+ */
+export interface ToolPolicyEvaluationOptions {
+    /** The character's tool profile */
+    profile?: ToolProfileId;
+    /** Character-level tool policy overrides */
+    characterPolicy?: ToolPolicyConfig;
+    /** Channel-specific tool policy overrides */
+    channelPolicy?: ToolPolicyConfig;
+    /** Provider-specific tool policy overrides */
+    providerPolicy?: ToolPolicyConfig;
+    /** Plugin tool groups for resolution */
+    pluginGroups?: PluginToolGroups;
+    /** Set of core tool names for validation */
+    coreTools?: Set<string>;
+}
+/**
+ * Tool policy evaluation result.
+ */
+export interface ToolPolicyResult {
+    /** Whether the tool is allowed */
+    allowed: boolean;
+    /** Reason for the decision */
+    reason: string;
+    /** The effective policy after merging */
+    effectivePolicy: ToolPolicyConfig;
+}
+/**
+ * Normalize a tool name to its canonical form.
+ * Handles aliases and case normalization.
+ *
+ * @param name - The tool name to normalize
+ * @returns The canonical tool name
+ */
+export declare function normalizeToolName(name: string): string;
+/**
+ * Normalize a list of tool names.
+ *
+ * @param list - The list of tool names to normalize
+ * @returns Normalized list with empty entries filtered out
+ */
+export declare function normalizeToolList(list?: string[]): string[];
+/**
+ * Expand tool groups in a list to their constituent tools.
+ * Handles both group references (e.g., "group:fs") and individual tools.
+ *
+ * @param list - The list containing tool names and/or group references
+ * @returns Expanded list with all groups resolved to individual tools
+ */
+export declare function expandToolGroups(list?: string[]): string[];
+/**
+ * Resolve a tool profile to its policy configuration.
+ *
+ * @param profile - The profile ID to resolve
+ * @returns The policy configuration, or undefined if profile is invalid
+ */
+export declare function resolveToolProfilePolicy(profile?: string): ToolPolicyConfig | undefined;
+/**
+ * Collect all explicit allow entries from multiple policies.
+ *
+ * @param policies - Array of policies to collect from
+ * @returns Combined allowlist entries
+ */
+export declare function collectExplicitAllowlist(policies: Array<ToolPolicyConfig | undefined>): string[];
+/**
+ * Build plugin tool groups from a list of tools with metadata.
+ *
+ * @param params - Tools and metadata accessor
+ * @returns Plugin tool groups organized by plugin ID
+ */
+export declare function buildPluginToolGroups<T extends {
+    name: string;
+}>(params: {
+    tools: T[];
+    toolMeta: (tool: T) => {
+        pluginId: string;
+    } | undefined;
+}): PluginToolGroups;
+/**
+ * Expand plugin group references in a list.
+ *
+ * @param list - The list containing potential plugin group references
+ * @param groups - Plugin tool groups for resolution
+ * @returns Expanded list with plugin groups resolved
+ */
+export declare function expandPluginGroups(list: string[] | undefined, groups: PluginToolGroups): string[] | undefined;
+/**
+ * Expand a policy with plugin group resolution.
+ *
+ * @param policy - The policy to expand
+ * @param groups - Plugin tool groups for resolution
+ * @returns Policy with plugin groups expanded
+ */
+export declare function expandPolicyWithPluginGroups(policy: ToolPolicyConfig | undefined, groups: PluginToolGroups): ToolPolicyConfig | undefined;
+/**
+ * Strip plugin-only allowlist to prevent accidentally disabling core tools.
+ * When an allowlist contains only plugin tools, we remove it to avoid
+ * inadvertently blocking core functionality.
+ *
+ * @param policy - The policy to check
+ * @param groups - Plugin tool groups
+ * @param coreTools - Set of core tool names
+ * @returns Resolution result with diagnostic information
+ */
+export declare function stripPluginOnlyAllowlist(policy: ToolPolicyConfig | undefined, groups: PluginToolGroups, coreTools: Set<string>): AllowlistResolution;
+/**
+ * Merge multiple tool policies into a single effective policy.
+ * Later policies take precedence for conflicts.
+ *
+ * @param policies - Policies to merge in order of precedence
+ * @returns Merged policy
+ */
+export declare function mergeToolPolicies(...policies: Array<ToolPolicyConfig | undefined>): ToolPolicyConfig;
+/**
+ * Check if a tool is allowed by a policy.
+ *
+ * @param toolName - The tool name to check
+ * @param policy - The policy to evaluate against
+ * @returns Whether the tool is allowed
+ */
+export declare function isToolAllowedByPolicy(toolName: string, policy: ToolPolicyConfig | undefined): boolean;
+//# sourceMappingURL=tools.d.ts.map

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

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

package/dist/types/trigger.d.ts

@@ -0,0 +1,38 @@
+import type { UUID } from "./primitives";
+export declare const TRIGGER_SCHEMA_VERSION: 1;
+export type TriggerType = "interval" | "once" | "cron";
+export type TriggerWakeMode = "inject_now" | "next_autonomy_cycle";
+export type TriggerLastStatus = "success" | "error" | "skipped";
+export interface TriggerConfig {
+    version: typeof TRIGGER_SCHEMA_VERSION;
+    triggerId: UUID;
+    displayName: string;
+    instructions: string;
+    triggerType: TriggerType;
+    enabled: boolean;
+    wakeMode: TriggerWakeMode;
+    createdBy: string;
+    timezone?: string;
+    intervalMs?: number;
+    scheduledAtIso?: string;
+    cronExpression?: string;
+    maxRuns?: number;
+    runCount: number;
+    nextRunAtMs?: number;
+    lastRunAtIso?: string;
+    lastStatus?: TriggerLastStatus;
+    lastError?: string;
+    dedupeKey?: string;
+}
+export interface TriggerRunRecord {
+    triggerRunId: UUID;
+    triggerId: UUID;
+    taskId: UUID;
+    startedAt: number;
+    finishedAt: number;
+    status: TriggerLastStatus;
+    error?: string;
+    latencyMs: number;
+    source: "scheduler" | "manual";
+}
+//# sourceMappingURL=trigger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../src/types/trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,sBAAsB,EAAG,CAAU,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,qBAAqB,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,IAAI,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC/B"}

package/dist/utils/boolean.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Boolean parsing utilities.
+ *
+ * Provides flexible boolean parsing from string values
+ * with configurable truthy/falsy representations.
+ *
+ * @module utils/boolean
+ */
+/**
+ * Options for boolean parsing.
+ */
+export type BooleanParseOptions = {
+    /** Values that should parse as true */
+    truthy?: string[];
+    /** Values that should parse as false */
+    falsy?: string[];
+};
+/**
+ * Parse a value as a boolean.
+ *
+ * Handles:
+ * - Boolean values (passed through)
+ * - String values ("true", "1", "yes", "on" => true; "false", "0", "no", "off" => false)
+ * - Custom truthy/falsy values via options
+ *
+ * @param value - Value to parse
+ * @param options - Parsing options
+ * @returns Boolean value or undefined if not parseable
+ *
+ * @example
+ * ```ts
+ * parseBooleanValue(true) // => true
+ * parseBooleanValue("yes") // => true
+ * parseBooleanValue("1") // => true
+ * parseBooleanValue("false") // => false
+ * parseBooleanValue("no") // => false
+ * parseBooleanValue("maybe") // => undefined
+ * parseBooleanValue("enabled", { truthy: ["enabled"] }) // => true
+ * ```
+ */
+export declare function parseBooleanValue(value: unknown, options?: BooleanParseOptions): boolean | undefined;
+/**
+ * Parse user/config text as a boolean, defaulting invalid values to false.
+ *
+ * WHY: A few older call sites intentionally treat unknown text as "off" rather
+ * than propagating `undefined`. This preserves that behavior while still routing
+ * through the shared boolean parser.
+ */
+export declare function parseBooleanText(value: string | boolean | undefined | null): boolean;
+//# sourceMappingURL=boolean.d.ts.map

package/dist/utils/boolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.d.ts","sourceRoot":"","sources":["../../src/utils/boolean.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AASF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,mBAAwB,GAC/B,OAAO,GAAG,SAAS,CAuBrB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,GACxC,OAAO,CAOT"}

package/dist/utils/buffer.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Browser and Node.js compatible buffer abstraction
+ * This module provides a cross-platform interface for buffer operations
+ * that works in both browser and Node.js environments.
+ *
+ * In browsers, we use Uint8Array as a Buffer replacement.
+ * In Node.js, we use the native Buffer.
+ */
+/**
+ * Type representing a buffer-like object that works in both environments
+ */
+export type BufferLike = Buffer | Uint8Array;
+/**
+ * Convert a hex string to a buffer-like object
+ * @param hex - The hexadecimal string to convert
+ * @returns A BufferLike object
+ */
+export declare function fromHex(hex: string): BufferLike;
+/**
+ * Convert a string to a buffer-like object
+ * @param str - The string to convert
+ * @param encoding - The encoding to use (default: 'utf8')
+ * @returns A BufferLike object
+ */
+export declare function fromString(str: string, encoding?: "utf8" | "utf-8" | "base64"): BufferLike;
+/**
+ * Convert a buffer-like object to a hexadecimal string
+ * @param buffer - The buffer to convert
+ * @returns A hexadecimal string
+ */
+export declare function toHex(buffer: BufferLike): string;
+/**
+ * Convert a buffer-like object to a string
+ * @param buffer - The buffer to convert
+ * @param encoding - The encoding to use (default: 'utf8')
+ * @returns A string
+ */
+export declare function bufferToString(buffer: BufferLike, encoding?: "utf8" | "utf-8" | "base64" | "hex"): string;
+/**
+ * Check if an object is a Buffer or Uint8Array
+ * @param obj - The object to check
+ * @returns True if the object is buffer-like
+ */
+export declare function isBuffer(obj: unknown): obj is BufferLike;
+/**
+ * Create a buffer of a specific size filled with zeros
+ * @param size - The size of the buffer
+ * @returns A BufferLike object
+ */
+export declare function alloc(size: number): BufferLike;
+/**
+ * Create a buffer from an array of bytes
+ * @param bytes - Array of byte values
+ * @returns A BufferLike object
+ */
+export declare function fromBytes(bytes: number[] | Uint8Array): BufferLike;
+/**
+ * Concatenate multiple buffers
+ * @param buffers - Array of buffers to concatenate
+ * @returns A new BufferLike object
+ */
+export declare function concat(buffers: BufferLike[]): BufferLike;
+/**
+ * Slice a buffer to create a new buffer
+ * @param buffer - The buffer to slice
+ * @param start - Start index
+ * @param end - End index (optional)
+ * @returns A new BufferLike object
+ */
+export declare function slice(buffer: BufferLike, start: number, end?: number): BufferLike;
+/**
+ * Compare two buffers for equality
+ * @param a - First buffer
+ * @param b - Second buffer
+ * @returns True if buffers are equal
+ */
+export declare function equals(a: BufferLike, b: BufferLike): boolean;
+/**
+ * Get the byte length of a buffer
+ * @param buffer - The buffer
+ * @returns The byte length
+ */
+export declare function byteLength(buffer: BufferLike): number;
+/**
+ * Create a random buffer of specified size using cryptographically secure random bytes.
+ * @param size - The size of the buffer
+ * @returns A BufferLike object filled with random bytes
+ * @throws Error if no cryptographic random source is available
+ */
+export declare function randomBytes(size: number): BufferLike;
+export declare const BufferUtils: {
+    fromHex: typeof fromHex;
+    fromString: typeof fromString;
+    fromBytes: typeof fromBytes;
+    toHex: typeof toHex;
+    bufferToString: typeof bufferToString;
+    toString: typeof bufferToString;
+    isBuffer: typeof isBuffer;
+    alloc: typeof alloc;
+    concat: typeof concat;
+    slice: typeof slice;
+    equals: typeof equals;
+    byteLength: typeof byteLength;
+    randomBytes: typeof randomBytes;
+};
+export type { BufferLike as Buffer };
+//# sourceMappingURL=buffer.d.ts.map

package/dist/utils/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/utils/buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAS7C;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAc/C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACzB,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAM,GAAG,OAAO,GAAG,QAAiB,GAC5C,UAAU,CAkBZ;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAYhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,UAAU,EAClB,QAAQ,GAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAc,GACpD,MAAM,CAoBR;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAYxD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAK9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,UAAU,CAKlE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,CAoBxD;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACpB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,GACV,UAAU,CAKZ;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAY5D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAgBpD;AAGD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;CAcvB,CAAC;AAGF,YAAY,EAAE,UAAU,IAAI,MAAM,EAAE,CAAC"}