@statelyai/agent 1.1.6 → 2.0.0-alpha.10

package/CHANGELOG.md

@@ -1,222 +0,0 @@
-# @statelyai/agent
-
-## 1.1.6
-
-### Patch Changes
-
-- [#54](https://github.com/statelyai/agent/pull/54) [`140fdce`](https://github.com/statelyai/agent/commit/140fdceb879dea5a32f243e89a8d87a9c524e454) Thanks [@XavierDK](https://github.com/XavierDK)! - - Addressing an issue where the fullStream property was not properly copied when using the spread operator (...). The problem occurred because fullStream is an iterator, and as such, it was not included in the shallow copy of the result object.
-  - Update all packages
-
-## 1.1.5
-
-### Patch Changes
-
-- [#49](https://github.com/statelyai/agent/pull/49) [`ae505d5`](https://github.com/statelyai/agent/commit/ae505d56b432a92875699507fb694628ef4d773d) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Update `ai` package
-
-## 1.1.4
-
-### Patch Changes
-
-- [#47](https://github.com/statelyai/agent/pull/47) [`185c149`](https://github.com/statelyai/agent/commit/185c1498f63aef15a3194032df3dcdcb2b33d752) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Update `ai` and `xstate` packages
-
-## 1.1.3
-
-### Patch Changes
-
-- [#45](https://github.com/statelyai/agent/pull/45) [`3c271f3`](https://github.com/statelyai/agent/commit/3c271f306c4ed9553c155e66cec8aa4284e9c813) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Fix reading the actor logic
-
-## 1.1.2
-
-### Patch Changes
-
-- [#43](https://github.com/statelyai/agent/pull/43) [`8e7629c`](https://github.com/statelyai/agent/commit/8e7629c347b29b704ae9576aa1af97e6cd693bc7) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Update dependencies
-
-## 1.1.1
-
-### Patch Changes
-
-- [#41](https://github.com/statelyai/agent/pull/41) [`b2f2b73`](https://github.com/statelyai/agent/commit/b2f2b7307e96d7722968769aae9db2572ede8ce7) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Update dependencies
-
-## 1.1.0
-
-### Minor Changes
-
-- [#39](https://github.com/statelyai/agent/pull/39) [`3cce30f`](https://github.com/statelyai/agent/commit/3cce30fc77d36dbed0abad805248de9f64bf8086) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Added four new methods for easily retrieving agent messages, observations, feedback, and plans:
-
-  - `agent.getMessages()`
-  - `agent.getObservations()`
-  - `agent.getFeedback()`
-  - `agent.getPlans()`
-
-  The `agent.select(…)` method is deprecated in favor of these methods.
-
-- [#40](https://github.com/statelyai/agent/pull/40) [`8b7c374`](https://github.com/statelyai/agent/commit/8b7c37482d5c35b2b3addc2f88e198526f203da7) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Correlation IDs are now provided as part of the result from `agent.generateText(…)` and `agent.streamText(…)`:
-
-  ```ts
-  const result = await agent.generateText({
-    prompt: "Write me a song",
-    correlationId: "my-correlation-id",
-    // ...
-  });
-
-  result.correlationId; // 'my-correlation-id'
-  ```
-
-  These correlation IDs can be passed to feedback:
-
-  ```ts
-  // ...
-
-  agent.addFeedback({
-    reward: -1,
-    correlationId: result.correlationId,
-  });
-  ```
-
-- [#40](https://github.com/statelyai/agent/pull/40) [`8b7c374`](https://github.com/statelyai/agent/commit/8b7c37482d5c35b2b3addc2f88e198526f203da7) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Changes to agent feedback (the `AgentFeedback` interface):
-
-  - `goal` is now optional
-  - `observationId` is now optional
-  - `correlationId` has been added (optional)
-  - `reward` has been added (optional)
-  - `attributes` are now optional
-
-- [#38](https://github.com/statelyai/agent/pull/38) [`21fb17c`](https://github.com/statelyai/agent/commit/21fb17c65fac1cbb4a8b08a04a58480a6930a0a9) Thanks [@davidkpiano](https://github.com/davidkpiano)! - You can now add `context` Zod schema to your agent. For now, this is meant to be passed directly to the state machine, but in the future, the schema can be shared with the LLM agent to better understand the state machine and its context for decision making.
-
-  Breaking: The `context` and `events` types are now in `agent.types` instead of ~~`agent.eventTypes`.
-
-  ```ts
-  const agent = createAgent({
-    // ...
-    context: {
-      score: z.number().describe("The score of the game"),
-      // ...
-    },
-  });
-
-  const machine = setup({
-    types: agent.types,
-  }).createMachine({
-    context: {
-      score: 0,
-    },
-    // ...
-  });
-  ```
-
-### Patch Changes
-
-- [`5f863bb`](https://github.com/statelyai/agent/commit/5f863bb0d89d90f30d0a9aa1f0dd2a35f0eeb45b) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Use nanoid
-
-- [#37](https://github.com/statelyai/agent/pull/37) [`dafa815`](https://github.com/statelyai/agent/commit/dafa8157cc1b5adbfb222c146dbc84ab2eed8894) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Messages are now properly included in `agent.decide(…)`, when specified.
-
-## 0.1.0
-
-### Minor Changes
-
-- [#32](https://github.com/statelyai/agent/pull/32) [`537f501`](https://github.com/statelyai/agent/commit/537f50111b5f8edc1a309d1abb8fffcdddddbc03) Thanks [@davidkpiano](https://github.com/davidkpiano)! - First minor release of `@statelyai/agent`! The API has been simplified from experimental earlier versions. Here are the main methods:
-
-  - `createAgent({ … })` creates an agent
-  - `agent.decide({ … })` decides on a plan to achieve the goal
-  - `agent.generateText({ … })` generates text based on a prompt
-  - `agent.streamText({ … })` streams text based on a prompt
-  - `agent.addObservation(observation)` adds an observation and returns a full observation object
-  - `agent.addFeedback(feedback)` adds a feedback and returns a full feedback object
-  - `agent.addMessage(message)` adds a message and returns a full message object
-  - `agent.addPlan(plan)` adds a plan and returns a full plan object
-  - `agent.onMessage(cb)` listens to messages
-  - `agent.select(selector)` selects data from the agent context
-  - `agent.interact(actorRef, getInput)` interacts with an actor and makes decisions to accomplish a goal
-
-## 0.0.8
-
-### Patch Changes
-
-- [#22](https://github.com/statelyai/agent/pull/22) [`8a2c34b`](https://github.com/statelyai/agent/commit/8a2c34b8a99161bf47c72df8eed3f5d3b6a19f5f) Thanks [@davidkpiano](https://github.com/davidkpiano)! - The `createSchemas(…)` function has been removed. The `defineEvents(…)` function should be used instead, as it is a simpler way of defining events and event schemas using Zod:
-
-  ```ts
-  import { defineEvents } from "@statelyai/agent";
-  import { z } from "zod";
-  import { setup } from "xstate";
-
-  const events = defineEvents({
-    inc: z.object({
-      by: z.number().describe("Increment amount"),
-    }),
-  });
-
-  const machine = setup({
-    types: {
-      events: events.types,
-    },
-    schema: {
-      events: events.schemas,
-    },
-  }).createMachine({
-    // ...
-  });
-  ```
-
-## 0.0.7
-
-### Patch Changes
-
-- [#18](https://github.com/statelyai/agent/pull/18) [`dcaabab`](https://github.com/statelyai/agent/commit/dcaababe69255b7eaff3347d0cf09469d3e6cc78) Thanks [@davidkpiano](https://github.com/davidkpiano)! - `context` is now optional for `createSchemas(…)`
-
-## 0.0.6
-
-### Patch Changes
-
-- [#16](https://github.com/statelyai/agent/pull/16) [`3ba5fb2`](https://github.com/statelyai/agent/commit/3ba5fb2392b51dee71f2585ed662b4ee9ecd6c41) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Update to XState 5.8.0
-
-## 0.0.5
-
-### Patch Changes
-
-- [#9](https://github.com/statelyai/agent/pull/9) [`d8e7b67`](https://github.com/statelyai/agent/commit/d8e7b673f6d265f37b2096b25d75310845860271) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Add `adapter.fromTool(…)`, which creates an actor that chooses agent logic based on a input.
-
-  ```ts
-  const actor = adapter.fromTool(() => "Draw me a picture of a donut", {
-    // tools
-    makeIllustration: {
-      description: "Makes an illustration",
-      run: async (input) => {
-        /* ... */
-      },
-      inputSchema: {
-        /* ... */
-      },
-    },
-    getWeather: {
-      description: "Gets the weather",
-      run: async (input) => {
-        /* ... */
-      },
-      inputSchema: {
-        /* ... */
-      },
-    },
-  });
-
-  //...
-  ```
-
-## 0.0.4
-
-### Patch Changes
-
-- [#5](https://github.com/statelyai/agent/pull/5) [`ae473d7`](https://github.com/statelyai/agent/commit/ae473d73399a15ac3199d77d00eb44a0ea5626db) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Simplify API (WIP)
-
-- [#5](https://github.com/statelyai/agent/pull/5) [`687bed8`](https://github.com/statelyai/agent/commit/687bed87f29bd1d13447cc53b5154da0fe6fdcab) Thanks [@davidkpiano](https://github.com/davidkpiano)! - Add `createSchemas`, `createOpenAIAdapter`, and change `createAgent`
-
-## 0.0.3
-
-### Patch Changes
-
-- [#1](https://github.com/statelyai/agent/pull/1) [`3dc2880`](https://github.com/statelyai/agent/commit/3dc28809a7ffd915a69d9f3374531c31fc1ee357) Thanks [@mellson](https://github.com/mellson)! - Adds a convenient way to run the examples with `pnpm example ${exampleName}`. If no example name is provided, the script will print the available examples. Also, adds a fun little loading animation to the joke example.
-
-## 0.0.2
-
-### Patch Changes
-
-- e125728: Added `createAgent(...)`

package/dist/index.d.ts

@@ -1,428 +0,0 @@
-import { EventObject, AnyStateMachine, AnyEventObject, AnyActorRef, SnapshotFrom, EventFrom, PromiseActorLogic, ActorLogic, TransitionSnapshot, Values, ActorRefFrom, Subscription, StateValue, ObservableActorLogic } from 'xstate';
-import { SomeZodObject, ZodType, TypeOf } from 'zod';
-import { generateText, streamText, LanguageModel, CoreMessage, GenerateTextResult, StreamTextResult, CoreTool } from 'ai';
-
-type ZodEventMapping = {
-    [eventType: string]: SomeZodObject;
-};
-type ZodContextMapping = {
-    [contextKey: string]: ZodType;
-};
-
-type GenerateTextOptions = Parameters<typeof generateText>[0];
-type StreamTextOptions = Parameters<typeof streamText>[0];
-type AgentPlanInput<TEvent extends EventObject> = Omit<GenerateTextOptions, 'prompt' | 'messages' | 'tools'> & {
-    /**
-     * The currently observed state.
-     */
-    state: ObservedState;
-    /**
-     * The goal for the agent to accomplish.
-     * The agent will create a plan based on this goal.
-     */
-    goal: string;
-    /**
-     * The events that the agent can trigger. This is a mapping of
-     * event types to Zod event schemas.
-     */
-    events: ZodEventMapping;
-    /**
-     * The state machine that represents the environment the agent
-     * is interacting with.
-     */
-    machine?: AnyStateMachine;
-    /**
-     * The previous plan.
-     */
-    previousPlan?: AgentPlan<TEvent>;
-};
-type AgentPlan<TEvent extends EventObject> = {
-    goal: string;
-    state: ObservedState;
-    content?: string;
-    /**
-     * Executes the plan based on the given `state` and resolves with
-     * a potential next `event` to trigger to achieve the `goal`.
-     */
-    execute: (state: ObservedState) => Promise<TEvent | undefined>;
-    nextEvent: TEvent | undefined;
-    sessionId: string;
-    timestamp: number;
-};
-interface TransitionData {
-    eventType: string;
-    description?: string;
-    guard?: {
-        type: string;
-    };
-    target?: any;
-}
-type PromptTemplate<TEvents extends EventObject> = (data: {
-    goal: string;
-    /**
-     * The observed state
-     */
-    state?: ObservedState;
-    /**
-     * The context to provide.
-     * This overrides the observed state.context, if provided.
-     */
-    context?: any;
-    /**
-     * The state machine model of the observed environment
-     */
-    machine?: unknown;
-    /**
-     * The potential next transitions that can be taken
-     * in the state machine
-     */
-    transitions?: TransitionData[];
-    /**
-     * Past observations
-     */
-    observations?: AgentObservation<any>[];
-    feedback?: AgentFeedback[];
-    messages?: AgentMessage[];
-    plans?: AgentPlan<TEvents>[];
-}) => string;
-type AgentPlanner<T extends AnyAgent> = (agent: T, input: AgentPlanInput<T['types']['events']>) => Promise<AgentPlan<T['types']['events']> | undefined>;
-type AgentDecideOptions = {
-    goal: string;
-    model?: LanguageModel;
-    context?: any;
-    state: ObservedState;
-    machine: AnyStateMachine;
-    execute?: (event: AnyEventObject) => Promise<void>;
-    planner?: AgentPlanner<any>;
-    events?: ZodEventMapping;
-} & Omit<Parameters<typeof generateText>[0], 'model' | 'tools' | 'prompt' | 'messages'>;
-interface AgentFeedback {
-    goal?: string;
-    observationId?: string;
-    /**
-     * The message correlation that the feedback is relevant for
-     */
-    correlationId?: string;
-    attributes: Record<string, any>;
-    reward: number;
-    timestamp: number;
-    sessionId: string;
-}
-interface AgentFeedbackInput {
-    goal?: string;
-    observationId?: string;
-    correlationId?: string;
-    attributes?: Record<string, any>;
-    timestamp?: number;
-    reward?: number;
-}
-type AgentMessage = CoreMessage & {
-    timestamp: number;
-    id: string;
-    /**
-     * The response ID of the message, which references
-     * which message this message is responding to, if any.
-     */
-    responseId?: string;
-    result?: GenerateTextResult<any>;
-    sessionId: string;
-    correlationId: string;
-    parentCorrelationId?: string;
-};
-type AgentMessageInput = CoreMessage & {
-    timestamp?: number;
-    id?: string;
-    /**
-     * The response ID of the message, which references
-     * which message this message is responding to, if any.
-     */
-    responseId?: string;
-    correlationId?: string;
-    parentCorrelationId?: string;
-    result?: GenerateTextResult<any>;
-};
-interface AgentObservation<TActor extends AnyActorRef> {
-    id: string;
-    prevState: SnapshotFrom<TActor> | undefined;
-    event: EventFrom<TActor>;
-    state: SnapshotFrom<TActor>;
-    machineHash: string | undefined;
-    sessionId: string;
-    timestamp: number;
-}
-interface AgentObservationInput {
-    id?: string;
-    prevState: ObservedState | undefined;
-    event: AnyEventObject;
-    state: ObservedState;
-    machine?: AnyStateMachine;
-    timestamp?: number;
-}
-type AgentDecisionInput = {
-    goal: string;
-    model?: LanguageModel;
-    context?: any;
-} & Omit<Parameters<typeof generateText>[0], 'model' | 'tools' | 'prompt'>;
-type AgentDecisionLogic<TEvents extends EventObject> = PromiseActorLogic<AgentPlan<TEvents> | undefined, AgentDecisionInput | string>;
-type AgentEmitted<TEvents extends EventObject> = {
-    type: 'feedback';
-    feedback: AgentFeedback;
-} | {
-    type: 'observation';
-    observation: AgentObservation<any>;
-} | {
-    type: 'message';
-    message: AgentMessage;
-} | {
-    type: 'plan';
-    plan: AgentPlan<TEvents>;
-};
-type AgentLogic<TEvents extends EventObject> = ActorLogic<TransitionSnapshot<AgentMemoryContext>, {
-    type: 'agent.feedback';
-    feedback: AgentFeedback;
-} | {
-    type: 'agent.observe';
-    observation: AgentObservation<any>;
-} | {
-    type: 'agent.message';
-    message: AgentMessage;
-} | {
-    type: 'agent.plan';
-    plan: AgentPlan<TEvents>;
-}, any, // TODO: input
-any, AgentEmitted<TEvents>>;
-type EventsFromZodEventMapping<TEventSchemas extends ZodEventMapping> = Values<{
-    [K in keyof TEventSchemas & string]: {
-        type: K;
-    } & TypeOf<TEventSchemas[K]>;
-}>;
-type ContextFromZodContextMapping<TContextSchema extends ZodContextMapping> = {
-    [K in keyof TContextSchema & string]: TypeOf<TContextSchema[K]>;
-};
-type Agent<TContext, TEvents extends EventObject> = ActorRefFrom<AgentLogic<TEvents>> & {
-    /**
-     * The name of the agent. All agents with the same name are related and
-     * able to share experiences (observations, feedback) with each other.
-     */
-    name?: string;
-    /**
-     * The unique identifier for the agent.
-     */
-    id?: string;
-    description?: string;
-    events: ZodEventMapping;
-    types: {
-        events: TEvents;
-        context: Compute<TContext>;
-    };
-    model: LanguageModel;
-    defaultOptions: GenerateTextOptions;
-    memory: AgentLongTermMemory | undefined;
-    /**
-     * The adapter used to perform LLM actions such as
-     * `.generateText(…)` and `.streamText(…)`.
-     *
-     * Defaults to the Vercel AI SDK.
-     */
-    adapter: AIAdapter;
-    /**
-     * Resolves with an `AgentPlan` based on the information provided in the `options`, including:
-     *
-     * - The `goal` for the agent to achieve
-     * - The observed current `state`
-     * - The `machine` (e.g. a state machine) that specifies what can happen next
-     * - Additional `context`
-     */
-    decide: (options: AgentDecideOptions) => Promise<AgentPlan<TEvents> | undefined>;
-    generateText: (options: AgentGenerateTextOptions) => Promise<AgentGenerateTextResult>;
-    streamText: (options: AgentStreamTextOptions) => Promise<AgentStreamTextResult>;
-    addObservation: (observationInput: AgentObservationInput) => AgentObservation<any>;
-    addMessage: (messageInput: AgentMessageInput) => AgentMessage;
-    addFeedback: (feedbackInput: AgentFeedbackInput) => AgentFeedback;
-    addPlan: (plan: AgentPlan<TEvents>) => void;
-    /**
-     * Called whenever the agent (LLM assistant) receives or sends a message.
-     */
-    onMessage: (callback: (message: AgentMessage) => void) => void;
-    /**
-     * Selects agent data from its context.
-     *
-     * @deprecated Select from `agent.getSnapshot().context` directly or:
-     * - `agent.getMessages()`
-     * - `agent.getObservations()`
-     * - `agent.getFeedback()`
-     * - `agent.getPlans()`
-     */
-    select: <T>(selector: (context: AgentMemoryContext) => T) => T;
-    /**
-     * Retrieves messages from the agent's short-term (local) memory.
-     */
-    getMessages: () => AgentMessage[];
-    /**
-     * Retrieves observations from the agent's short-term (local) memory.
-     */
-    getObservations: () => AgentObservation<Agent<TContext, TEvents>>[];
-    /**
-     * Retrieves feedback from the agent's short-term (local) memory.
-     */
-    getFeedback: () => AgentFeedback[];
-    /**
-     * Retrieves strategies from the agent's short-term (local) memory.
-     */
-    getPlans: () => AgentPlan<TEvents>[];
-    /**
-     * Interacts with this state machine actor by inspecting state transitions and storing them as observations.
-     *
-     * Observations contain the `prevState`, `event`, and current `state` of this
-     * actor, as well as other properties that are useful when recalled.
-     * These observations are stored in the `agent`'s short-term (local) memory
-     * and can be retrieved via `agent.getObservations()`.
-     *
-     * @example
-     * ```ts
-     * // Only observes the actor's state transitions
-     * agent.interact(actor);
-     *
-     * actor.start();
-     * ```
-     */
-    interact<TActor extends AnyActorRef>(actorRef: TActor): Subscription;
-    /**
-     * Interacts with this state machine actor by:
-     * 1. Inspecting state transitions and storing them as observations
-     * 2. Deciding what to do next (which event to send the actor) based on
-     * the agent input returned from `getInput(observation)`, if `getInput(…)` is provided as the 2nd argument.
-     *
-     * Observations contain the `prevState`, `event`, and current `state` of this
-     * actor, as well as other properties that are useful when recalled.
-     * These observations are stored in the `agent`'s short-term (local) memory
-     * and can be retrieved via `agent.getObservations()`.
-     *
-     * @example
-     * ```ts
-     * // Observes the actor's state transitions and
-     * // makes a decision if on the "summarize" state
-     * agent.interact(actor, observed => {
-     *   if (observed.state.matches('summarize')) {
-     *     return {
-     *       context: observed.state.context,
-     *       goal: 'Summarize the message'
-     *     }
-     *   }
-     * });
-     *
-     * actor.start();
-     * ```
-     */
-    interact<TActor extends AnyActorRef>(actorRef: TActor, getInput: (observation: AgentObservation<TActor>) => AgentDecisionInput | undefined): Subscription;
-};
-type AnyAgent = Agent<any, any>;
-type FromAgent<T> = T | ((agent: AnyAgent) => T | Promise<T>);
-type CommonTextOptions = {
-    prompt: FromAgent<string>;
-    model?: LanguageModel;
-    context?: Record<string, any>;
-    messages?: FromAgent<CoreMessage[]>;
-    template?: PromptTemplate<any>;
-    correlationId?: string;
-    parentCorrelationId?: string;
-};
-type TextResultMeta = {
-    correlationId: string;
-    parentCorrelationId?: string;
-};
-type AgentGenerateTextOptions = Omit<GenerateTextOptions, 'model' | 'prompt' | 'messages'> & CommonTextOptions;
-type AgentGenerateTextResult = GenerateTextResult<any> & TextResultMeta;
-type AgentStreamTextOptions = Omit<StreamTextOptions, 'model' | 'prompt' | 'messages'> & CommonTextOptions;
-type AgentStreamTextResult = StreamTextResult<any> & TextResultMeta;
-interface ObservedState {
-    /**
-     * The current state value of the state machine, e.g.
-     * `"loading"` or `"processing"` or `"ready"`
-     */
-    value: StateValue;
-    /**
-     * Additional contextual data related to the current state
-     */
-    context: Record<string, unknown>;
-}
-type ObservedStateFrom<TActor extends AnyActorRef> = Pick<SnapshotFrom<TActor>, 'value' | 'context'>;
-type AgentMemoryContext = {
-    observations: AgentObservation<any>[];
-    messages: AgentMessage[];
-    plans: AgentPlan<any>[];
-    feedback: AgentFeedback[];
-};
-type AgentMemory = AppendOnlyStorage<AgentMemoryContext>;
-interface AppendOnlyStorage<T extends Record<string, any[]>> {
-    append<K extends keyof T>(sessionId: string, key: K, item: T[K][0]): Promise<void>;
-    getAll<K extends keyof T>(sessionId: string, key: K): Promise<T[K] | undefined>;
-}
-interface AgentLongTermMemory {
-    get<K extends keyof AgentMemoryContext>(key: K): Promise<AgentMemoryContext[K]>;
-    append<K extends keyof AgentMemoryContext>(key: K, item: AgentMemoryContext[K][0]): Promise<void>;
-    set<K extends keyof AgentMemoryContext>(key: K, items: AgentMemoryContext[K]): Promise<void>;
-}
-interface AIAdapter {
-    generateText: typeof generateText;
-    streamText: typeof streamText;
-}
-type Compute<A extends any> = {
-    [K in keyof A]: A[K];
-} & unknown;
-
-declare function createAgent<const TContextSchema extends ZodContextMapping, const TEventSchemas extends ZodEventMapping, TEvents extends EventObject = EventsFromZodEventMapping<TEventSchemas>, TContext = ContextFromZodContextMapping<TContextSchema>>({ name, description, model, events, context, planner, stringify, getMemory, logic, adapter, ...generateTextOptions }: {
-    /**
-     * The unique identifier for the agent.
-     *
-     * This should be the same across all sessions of a specific agent, as it can be
-     * used to retrieve memory for this agent.
-     *
-     * @example
-     * ```ts
-     * const agent = createAgent({
-     *  id: 'recipe-assistant',
-     *  // ...
-     * });
-     * ```
-     */
-    id?: string;
-    /**
-     * The name of the agent
-     */
-    name?: string;
-    /**
-     * A description of the role of the agent
-     */
-    description?: string;
-    /**
-     * Events that the agent can cause (send) in an environment
-     * that the agent knows about.
-     */
-    events: TEventSchemas;
-    context?: TContextSchema;
-    planner?: AgentPlanner<Agent<TContext, TEvents>>;
-    stringify?: typeof JSON.stringify;
-    /**
-     * A function that retrieves the agent's long term memory
-     */
-    getMemory?: (agent: Agent<TContext, TEvents>) => AgentLongTermMemory;
-    /**
-     * Agent logic
-     */
-    logic?: AgentLogic<TEvents>;
-    adapter?: AIAdapter;
-} & GenerateTextOptions): Agent<TContext, TEvents>;
-
-declare function fromTextStream<T extends AnyAgent>(agent: T, defaultOptions?: AgentStreamTextOptions): ObservableActorLogic<{
-    textDelta: string;
-}, Omit<AgentStreamTextOptions, 'context'> & {
-    context?: AgentStreamTextOptions['context'];
-}>;
-declare function fromText<T extends AnyAgent>(agent: T, defaultOptions?: AgentGenerateTextOptions): PromiseActorLogic<GenerateTextResult<Record<string, CoreTool<any, any>>>, Omit<AgentGenerateTextOptions, 'context'> & {
-    context?: AgentGenerateTextOptions['context'];
-}>;
-
-declare function fromDecision(agent: AnyAgent, defaultInput?: AgentDecisionInput): AgentDecisionLogic<any>;
-
-export { type AIAdapter, type Agent, type AgentDecideOptions, type AgentDecisionInput, type AgentDecisionLogic, type AgentEmitted, type AgentFeedback, type AgentFeedbackInput, type AgentGenerateTextOptions, type AgentGenerateTextResult, type AgentLogic, type AgentLongTermMemory, type AgentMemory, type AgentMemoryContext, type AgentMessage, type AgentMessageInput, type AgentObservation, type AgentObservationInput, type AgentPlan, type AgentPlanInput, type AgentPlanner, type AgentStreamTextOptions, type AgentStreamTextResult, type AnyAgent, type AppendOnlyStorage, type CommonTextOptions, type Compute, type ContextFromZodContextMapping, type EventsFromZodEventMapping, type FromAgent, type GenerateTextOptions, type ObservedState, type ObservedStateFrom, type PromptTemplate, type StreamTextOptions, type TextResultMeta, type TransitionData, createAgent, fromDecision, fromText, fromTextStream };