@elizaos/agent 0.25.9 → 2.0.0-alpha.151

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

@@ -0,0 +1,176 @@
+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;
+    /**
+     * Optional callback merge hint for streaming UIs.
+     * `replace` keeps the pre-callback prefix and swaps the callback suffix;
+     * `append` adds new callback text to the current visible reply.
+     */
+    merge?: "append" | "replace";
+    /** 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 basic-capabilities 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

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * Channel types for messaging
+ */
+export const ChannelType = {
+    SELF: "SELF",
+    DM: "DM",
+    GROUP: "GROUP",
+    VOICE_DM: "VOICE_DM",
+    VOICE_GROUP: "VOICE_GROUP",
+    FEED: "FEED",
+    THREAD: "THREAD",
+    WORLD: "WORLD",
+    FORUM: "FORUM",
+    API: "API",
+};
+/**
+ * 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 const DEFAULT_UUID = "00000000-0000-0000-0000-000000000000";
+/**
+ * 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 function asUUID(id) {
+    if (!id ||
+        !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)) {
+        throw new Error(`Invalid UUID format: ${id}`);
+    }
+    return id;
+}
+export const ContentType = {
+    IMAGE: "image",
+    VIDEO: "video",
+    AUDIO: "audio",
+    DOCUMENT: "document",
+    LINK: "link",
+};

package/packages/typescript/src/types/prompt-batcher.d.ts

@@ -0,0 +1,126 @@
+import type { Memory } from "./memory";
+import type { GenerateTextParams } from "./model";
+import type { Content } from "./primitives";
+import type { IAgentRuntime } from "./runtime";
+import type { SchemaRow } from "./state";
+export type SectionFrequency = "once" | "per-drain" | "recurring";
+export interface DrainMeta {
+    drainId: string;
+    timestamp: number;
+    messages: Memory[];
+    sectionId: string;
+    actualModel: "small" | "large";
+    durationMs: number;
+    cacheHit: boolean;
+    staleRevalidation: boolean;
+    packedWith: string[];
+    retryAttempt: number;
+    fallbackUsed: boolean;
+}
+/**
+ * Result of a batcher section delivery. All section promises (addSection, onDrain) resolve
+ * with this shape so callers get both extracted fields and drain metadata in one object.
+ * WHY: Single consistent type; meta (fallbackUsed, durationMs, etc.) is available when
+ * callers need it. askOnce/askNow unwrap to fields only for backward compatibility.
+ */
+export interface BatcherResult<T = Record<string, unknown>> {
+    fields: T;
+    meta: DrainMeta;
+}
+export interface DrainLog {
+    drainId: string;
+    agentId: string;
+    affinityKey: string;
+    timestamp: number;
+    durationMs: number;
+    sectionsIncluded: string[];
+    sectionsSkipped: string[];
+    cacheHits: string[];
+    callCount: number;
+    calls: Array<{
+        model: "small" | "large";
+        sectionIds: string[];
+        estimatedTokens: number;
+        durationMs: number;
+        success: boolean;
+        retried: boolean;
+        fallbackUsed: string[];
+    }>;
+}
+export interface BatcherStats {
+    totalDrains: number;
+    totalCalls: number;
+    totalCacheHits: number;
+    totalFallbacks: number;
+    avgSectionsPerCall: number;
+    avgDrainDurationMs: number;
+}
+export type ContextResolver = (runtime: IAgentRuntime, messages: Memory[]) => Promise<string> | string;
+export interface PromptSection {
+    id: string;
+    frequency: SectionFrequency;
+    providers?: string[];
+    contextBuilder?: (runtime: IAgentRuntime, messages: Memory[]) => Promise<string> | string;
+    contextResolvers?: string[];
+    dependsOnEvaluators?: boolean;
+    preamble?: string;
+    priority?: "background" | "normal" | "immediate";
+    model?: "small" | "large";
+    isolated?: boolean;
+    schema: SchemaRow[];
+    onResult?: (fields: Record<string, unknown>, meta: DrainMeta) => void | Promise<void>;
+    fallback?: () => Record<string, unknown>;
+    validate?: (fields: Record<string, unknown>) => Record<string, unknown> | null;
+    cacheTtlMs?: number;
+    staleWhileRevalidate?: boolean;
+    forceRegenerate?: boolean;
+    execOptions?: {
+        temperature?: number;
+        maxTokens?: number;
+        stopSequences?: string[];
+    };
+    shouldRun?: (runtime: IAgentRuntime) => Promise<boolean> | boolean;
+    maxRetries?: number;
+    minCycleMs?: number;
+    affinityKey?: string;
+}
+export interface ResolvedSection {
+    section: PromptSection;
+    resolvedContext: string;
+    contextCharCount: number;
+    schemaFieldCount: number;
+    estimatedTokens: number;
+    priority: "background" | "normal" | "immediate";
+    preferredModel: "small" | "large";
+    isolated: boolean;
+    affinityKey: string;
+    execOptions?: {
+        temperature?: number;
+        maxTokens?: number;
+        stopSequences?: string[];
+    };
+}
+export interface PreCallbackHandler {
+    id: string;
+    actionFilter: string[];
+    schema: SchemaRow[];
+    preamble: string;
+    providers?: string[];
+    model?: "small" | "large";
+    execOptions?: {
+        temperature?: number;
+        maxTokens?: number;
+        stopSequences?: string[];
+    };
+    validate?: (fields: Record<string, unknown>) => Record<string, unknown> | null;
+    apply: (fields: Record<string, unknown>, content: Content) => Content | null;
+    fallback?: () => Record<string, unknown>;
+}
+export declare class BatcherDisposedError extends Error {
+    constructor();
+}
+export type PromptBatcherExecOptions = NonNullable<PromptSection["execOptions"]>;
+export type PromptBatcherGenerateTextParams = Omit<GenerateTextParams, "prompt"> & {
+    prompt: string;
+};
+//# sourceMappingURL=prompt-batcher.d.ts.map

package/packages/typescript/src/types/prompt-batcher.d.ts.map

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

package/packages/typescript/src/types/prompt-batcher.js

@@ -0,0 +1,6 @@
+export class BatcherDisposedError extends Error {
+    constructor() {
+        super("PromptBatcher has been disposed");
+        this.name = "BatcherDisposedError";
+    }
+}

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

@@ -0,0 +1,39 @@
+/**
+ * Shared types for prompt building and template composition.
+ *
+ * These types are used across plugins to ensure consistent prompt handling
+ * and to enable shared prompt building utilities.
+ */
+import type { TemplateType } from "./agent.js";
+import type { BuildPromptOptions as ProtoBuildPromptOptions, BuiltPrompt as ProtoBuiltPrompt, PromptFieldInfo as ProtoPromptFieldInfo, PromptTemplateConfig as ProtoPromptTemplateConfig } from "./proto.js";
+/**
+ * Information about a field for prompt building.
+ * Used when building prompts that extract or format field values.
+ */
+export type PromptFieldInfo = ProtoPromptFieldInfo;
+/**
+ * Options for building a prompt from a template.
+ */
+export interface BuildPromptOptions extends Omit<ProtoBuildPromptOptions, "template" | "state" | "defaults"> {
+    template: TemplateType;
+    state: Record<string, string | number | boolean | undefined>;
+    defaults?: Record<string, string>;
+}
+/**
+ * Result of building a prompt from a template.
+ */
+export type BuiltPrompt = ProtoBuiltPrompt;
+/**
+ * Function signature for building prompts dynamically.
+ */
+export type PromptBuilder = (options: BuildPromptOptions) => string | BuiltPrompt;
+/**
+ * Configuration for a prompt template.
+ * Extends the basic template with metadata and building options.
+ */
+export interface PromptTemplateConfig extends Omit<ProtoPromptTemplateConfig, "template" | "defaults"> {
+    template: TemplateType;
+    defaults?: Record<string, string>;
+    builder?: PromptBuilder;
+}
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/types/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EACX,kBAAkB,IAAI,uBAAuB,EAC7C,WAAW,IAAI,gBAAgB,EAC/B,eAAe,IAAI,oBAAoB,EACvC,oBAAoB,IAAI,yBAAyB,EACjD,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,kBAChB,SAAQ,IAAI,CAAC,uBAAuB,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;IACxE,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAC3B,OAAO,EAAE,kBAAkB,KACvB,MAAM,GAAG,WAAW,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,oBAChB,SAAQ,IAAI,CAAC,yBAAyB,EAAE,UAAU,GAAG,UAAU,CAAC;IAChE,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB"}

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

@@ -0,0 +1,7 @@
+/**
+ * Shared types for prompt building and template composition.
+ *
+ * These types are used across plugins to ensure consistent prompt handling
+ * and to enable shared prompt building utilities.
+ */
+export {};

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

@@ -0,0 +1,60 @@
+/**
+ * Proto-generated Types
+ *
+ * This module provides the proto-generated types for elizaOS.
+ * Types are generated from /packages/@schemas/eliza/v1/*.proto using @bufbuild/protoc-gen-es
+ *
+ * ## Type Structure
+ *
+ * 1. **Enums**: Use `ENUM_NAME_VALUE` format
+ *    - Example: `MEMORY_TYPE_MESSAGE`
+ *
+ * 2. **Optional fields**: Explicitly typed as `T | undefined`
+ *
+ * 3. **Dynamic properties**: Use `google.protobuf.Struct` (JsonObject)
+ *    - Access via `.data` field on Content, State, etc.
+ *
+ * @module @elizaos/core/types/proto
+ */
+import type { JsonObject as BufJsonObject, JsonValue as BufJsonValue } from "@bufbuild/protobuf";
+export * from "./generated/eliza/v1/agent_pb.js";
+export * from "./generated/eliza/v1/components_pb.js";
+export * from "./generated/eliza/v1/database_pb.js";
+export * from "./generated/eliza/v1/environment_pb.js";
+export * from "./generated/eliza/v1/events_pb.js";
+export * from "./generated/eliza/v1/ipc_pb.js";
+export * from "./generated/eliza/v1/knowledge_pb.js";
+export * from "./generated/eliza/v1/memory_pb.js";
+export * from "./generated/eliza/v1/message_service_pb.js";
+export * from "./generated/eliza/v1/messaging_pb.js";
+export * from "./generated/eliza/v1/model_pb.js";
+export * from "./generated/eliza/v1/plugin_pb.js";
+export * from "./generated/eliza/v1/primitives_pb.js";
+export * from "./generated/eliza/v1/prompts_pb.js";
+export * from "./generated/eliza/v1/service_interfaces_pb.js";
+export * from "./generated/eliza/v1/service_pb.js";
+export * from "./generated/eliza/v1/settings_pb.js";
+export * from "./generated/eliza/v1/state_pb.js";
+export * from "./generated/eliza/v1/task_pb.js";
+export * from "./generated/eliza/v1/tee_pb.js";
+export * from "./generated/eliza/v1/testing_pb.js";
+/**
+ * Type alias for JSON-serializable object (used for dynamic properties)
+ */
+export type JsonObject = BufJsonObject;
+/**
+ * Type alias for JSON-serializable values
+ */
+export type JsonValue = BufJsonValue;
+/**
+ * Helper to convert a proto message to a plain JSON object.
+ * Uses a properly constrained type to avoid unsafe casts.
+ */
+export declare function toJson<T extends JsonObject>(message: T): JsonObject;
+/**
+ * Helper to create a proto message from a plain object
+ */
+export declare function fromJson<T extends object>(schema: {
+    new (): T;
+}, json: JsonObject): T;
+//# sourceMappingURL=proto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proto.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/types/proto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACX,UAAU,IAAI,aAAa,EAC3B,SAAS,IAAI,YAAY,EACzB,MAAM,oBAAoB,CAAC;AAE5B,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC;AAErC;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,OAAO,EAAE,CAAC,GAAG,UAAU,CAGnE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACxC,MAAM,EAAE;IAAE,QAAQ,CAAC,CAAA;CAAE,EACrB,IAAI,EAAE,UAAU,GACd,CAAC,CAEH"}

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

@@ -0,0 +1,53 @@
+/**
+ * Proto-generated Types
+ *
+ * This module provides the proto-generated types for elizaOS.
+ * Types are generated from /packages/@schemas/eliza/v1/*.proto using @bufbuild/protoc-gen-es
+ *
+ * ## Type Structure
+ *
+ * 1. **Enums**: Use `ENUM_NAME_VALUE` format
+ *    - Example: `MEMORY_TYPE_MESSAGE`
+ *
+ * 2. **Optional fields**: Explicitly typed as `T | undefined`
+ *
+ * 3. **Dynamic properties**: Use `google.protobuf.Struct` (JsonObject)
+ *    - Access via `.data` field on Content, State, etc.
+ *
+ * @module @elizaos/core/types/proto
+ */
+export * from "./generated/eliza/v1/agent_pb.js";
+export * from "./generated/eliza/v1/components_pb.js";
+export * from "./generated/eliza/v1/database_pb.js";
+export * from "./generated/eliza/v1/environment_pb.js";
+export * from "./generated/eliza/v1/events_pb.js";
+export * from "./generated/eliza/v1/ipc_pb.js";
+export * from "./generated/eliza/v1/knowledge_pb.js";
+export * from "./generated/eliza/v1/memory_pb.js";
+export * from "./generated/eliza/v1/message_service_pb.js";
+export * from "./generated/eliza/v1/messaging_pb.js";
+export * from "./generated/eliza/v1/model_pb.js";
+export * from "./generated/eliza/v1/plugin_pb.js";
+export * from "./generated/eliza/v1/primitives_pb.js";
+export * from "./generated/eliza/v1/prompts_pb.js";
+export * from "./generated/eliza/v1/service_interfaces_pb.js";
+export * from "./generated/eliza/v1/service_pb.js";
+export * from "./generated/eliza/v1/settings_pb.js";
+export * from "./generated/eliza/v1/state_pb.js";
+export * from "./generated/eliza/v1/task_pb.js";
+export * from "./generated/eliza/v1/tee_pb.js";
+export * from "./generated/eliza/v1/testing_pb.js";
+/**
+ * Helper to convert a proto message to a plain JSON object.
+ * Uses a properly constrained type to avoid unsafe casts.
+ */
+export function toJson(message) {
+    // The @bufbuild/protobuf types are already plain objects
+    return message;
+}
+/**
+ * Helper to create a proto message from a plain object
+ */
+export function fromJson(schema, json) {
+    return Object.assign(new schema(), json);
+}