@aigne/core 1.0.9 → 1.0.11

package/lib/dts/definitions/data-schema.d.ts

@@ -0,0 +1,61 @@
+import type { MakeNullablePropertyOptional } from "../utils/nullable";
+import { OrderedRecord } from "../utils/ordered-map";
+import type { ArrayElement } from "../utils/type-utils";
+import type { DataType } from "./data-type";
+export declare function schemaToDataType(dataType: {
+    [name: string]: DataSchema;
+}): OrderedRecord<DataType>;
+export type DataSchema = DataSchemaString | DataSchemaNumber | DataSchemaBoolean | DataSchemaObject | DataSchemaArray;
+export interface DataSchemaBase {
+    description?: string;
+    required?: boolean;
+}
+export interface DataSchemaString extends DataSchemaBase {
+    type: "string";
+}
+export interface DataSchemaNumber extends DataSchemaBase {
+    type: "number";
+}
+export interface DataSchemaBoolean extends DataSchemaBase {
+    type: "boolean";
+}
+export interface DataSchemaObject extends DataSchemaBase {
+    type: "object";
+    properties?: {
+        [key: string]: DataSchema;
+    };
+}
+export interface DataSchemaArray extends DataSchemaBase {
+    type: "array";
+    items?: DataSchema;
+}
+type SchemaTypeInner<T extends DataSchema> = T extends DataSchemaString ? string : T extends DataSchemaNumber ? number : T extends DataSchemaBoolean ? boolean : T extends DataSchemaObject ? MakeNullablePropertyOptional<{
+    [K in keyof T["properties"]]: SchemaType<NonNullable<T["properties"]>[K]>;
+}> : T extends DataSchemaArray ? Extract<T["items"], null | undefined> extends null | undefined ? SchemaType<{
+    type: "object";
+}>[] : SchemaType<NonNullable<T["items"]>>[] : never;
+type SchemaType<T extends DataSchema> = T["required"] extends true ? SchemaTypeInner<T> : SchemaTypeInner<T> | undefined | null;
+export type SchemaToType<T extends Record<string, DataSchema>> = SchemaType<{
+    type: "object";
+    required: true;
+    properties: T;
+}>;
+type TypeToSchemaInner<T> = Extract<T, string | undefined> extends string | undefined ? DataSchemaString & {
+    required: Extract<T, undefined> extends undefined ? false : true;
+} : Extract<T, number | undefined> extends number | undefined ? DataSchemaNumber & {
+    required: Extract<T, undefined> extends undefined ? false : true;
+} : Extract<T, boolean | undefined> extends boolean | undefined ? DataSchemaBoolean & {
+    required: Extract<T, undefined> extends undefined ? false : true;
+} : Extract<T, object | undefined> extends object | undefined ? DataSchemaObject & {
+    properties: {
+        [K in keyof T]: TypeToSchemaInner<NonNullable<T[K]>>;
+    };
+    required: Extract<T, undefined> extends undefined ? false : true;
+} : Extract<T, [] | undefined> extends [] | undefined ? DataSchemaArray & {
+    items: Extract<T, undefined> extends undefined ? undefined : TypeToSchemaInner<NonNullable<ArrayElement<T>>>;
+    required: Extract<T, undefined> extends undefined ? false : true;
+} : never;
+export type TypeToSchema<T extends Record<string, unknown>> = {
+    [K in keyof T]: TypeToSchemaInner<T[K]>;
+};
+export {};

package/lib/dts/definitions/memory.d.ts

@@ -1,9 +1,22 @@
 import type { Memorable } from "../memorable";
-import type { RunnableInput, RunnableMemory } from "../runnable";
+import type { RunnableInputType } from "../runnable";
 import { OrderedRecord } from "../utils";
-import type { DataTypeSchema } from "./data-type-schema";
+import type { DataSchema } from "./data-schema";
+export interface AgentMemory {
+    id: string;
+    name?: string;
+    memory?: Memorable<unknown>;
+    query?: {
+        from: "variable";
+        fromVariableId?: string;
+        fromVariablePropPath?: string[];
+    };
+    options?: {
+        k?: number;
+    };
+}
 export interface CreateRunnableMemory<I extends {
-    [key: string]: DataTypeSchema;
+    [key: string]: DataSchema;
 } = {}> {
     /**
      * Memory instance to query/store memory.
@@ -35,6 +48,6 @@ export interface CreateRunnableMemory<I extends {
         k?: number;
     };
 }
-export declare function toRunnableMemories<I extends {}>(agentName: string, inputs: OrderedRecord<RunnableInput>, memories: {
+export declare function toRunnableMemories<I extends {}>(agentName: string, inputs: OrderedRecord<RunnableInputType>, memories: {
     [name: string]: CreateRunnableMemory<I>;
-}): OrderedRecord<RunnableMemory>;
+}): OrderedRecord<AgentMemory>;

package/lib/dts/definitions/open-api.d.ts

@@ -1,5 +1,5 @@
+import type { DataSchema } from "./data-schema";
 import type { DataType } from "./data-type";
-import type { DataTypeSchema } from "./data-type-schema";
 export interface BaseAuthConfig {
     type: "bearer" | "basic";
     token: string;
@@ -22,7 +22,7 @@ export type ParameterLocation = "path" | "query" | "body" | "header" | "cookie";
 export type OpenAPIDataType = DataType & {
     in?: ParameterLocation;
 };
-export type OpenAPIDataTypeSchema = DataTypeSchema & {
+export type OpenAPIDataTypeSchema = DataSchema & {
     in?: ParameterLocation;
 };
 export type FetchRequest = {
@@ -31,6 +31,6 @@ export type FetchRequest = {
     query?: Record<string, string | number | boolean>;
     headers?: Record<string, string>;
     cookies?: Record<string, string>;
-    body?: Record<string, any>;
+    body?: Record<string, unknown>;
 };
 export {};

package/lib/dts/definitions/preload.d.ts

@@ -0,0 +1,43 @@
+import type { CreateAgentInputSchema, CreateAgentPreloadsSchema } from "../agent";
+import type { Runnable, RunnableInputType } from "../runnable";
+import { OrderedRecord } from "../utils/ordered-map";
+import type { ExtractRunnableInputType } from "../utils/runnable-type";
+import type { UnionToIntersection } from "../utils/union";
+import type { SchemaToType } from "./data-schema";
+export declare function preloadCreatorsToPreloads<I extends CreateAgentInputSchema, C extends CreateAgentPreloadsSchema<I>>(inputs: OrderedRecord<RunnableInputType>, creators?: C): OrderedRecord<AgentPreload>;
+export type PreloadCreator<I extends CreateAgentInputSchema> = (preload: <R extends Runnable, Input extends BindAgentInputs<SchemaToType<I>, R>>(runnable: R, input: Input, options?: {
+    description?: string;
+}) => Readonly<BoundAgent<I, R, Input>>) => ReturnType<typeof preload>;
+export type BindAgentInputs<Vars extends Record<string, unknown>, R extends Runnable> = {
+    [key in keyof ExtractRunnableInputType<R>]: BindAgentInput<Vars, ExtractRunnableInputType<R>[key]>;
+};
+export interface AgentPreload {
+    id: string;
+    name?: string;
+    runnable?: {
+        id: string;
+    };
+    input?: {
+        [inputId: string]: BindAgentInput;
+    };
+}
+export type BindAgentInput<Vars extends Record<string, unknown> = Record<string, unknown>, Input = unknown> = {
+    from: "ai";
+} | {
+    from: "input";
+    fromInput: keyof {
+        [name in keyof Vars as Vars[name] extends Input ? name : never]: name;
+    };
+};
+export interface BoundAgent<Vars extends Record<string, unknown> = Record<string, unknown>, R extends Runnable = Runnable, I extends BindAgentInputs<Vars, R> = BindAgentInputs<Vars, R>> {
+    description?: string;
+    runnable: R;
+    input?: I;
+}
+type PickInputFrom<I, From extends BindAgentInput["from"]> = {
+    [key in keyof I as I[key] extends {
+        from: From;
+    } ? key : never]: I[key];
+};
+export type OmitBoundAgentInput<Case extends BoundAgent, From extends BindAgentInput["from"]> = Omit<UnionToIntersection<ExtractRunnableInputType<Case["runnable"]>, Record<string, never>>, keyof PickInputFrom<Required<UnionToIntersection<NonNullable<Case["input"]>, Record<string, never>>>, From>>;
+export {};

package/lib/dts/function-agent.d.ts

@@ -1,64 +1,23 @@
-import { Agent, type AgentProcessOptions } from "./agent";
+import { Agent, type AgentDefinition, type AgentMemories, type AgentPreloads, type AgentProcessInput, type AgentProcessOptions, type CreateAgentInputSchema, type CreateAgentMemoriesSchema, type CreateAgentMemoriesType, type CreateAgentOptions, type CreateAgentOutputSchema, type CreateAgentPreloadsSchema, type CreateAgentPreloadsType } from "./agent";
 import type { Context, ContextState } from "./context";
-import { type DataTypeSchema, type SchemaMapType } from "./definitions/data-type-schema";
-import { type CreateRunnableMemory } from "./definitions/memory";
-import type { MemorableSearchOutput, MemoryItemWithScore } from "./memorable";
-import type { RunnableDefinition, RunnableResponse, RunnableResponseChunk } from "./runnable";
-export declare class FunctionAgent<I extends {
-    [name: string]: any;
-} = {}, O extends {
-    [name: string]: any;
-} = {}, Memories extends {
-    [name: string]: MemoryItemWithScore[];
-} = {}, State extends ContextState = ContextState> extends Agent<I, O, Memories, State> {
-    definition: FunctionAgentDefinition<I, O, Memories, State>;
+import { type SchemaToType } from "./definitions/data-schema";
+import type { RunnableInput, RunnableOutput, RunnableResponse, RunnableResponseChunk } from "./runnable";
+export declare class FunctionAgent<I extends RunnableInput = RunnableInput, O extends RunnableOutput = RunnableOutput, State extends ContextState = ContextState, Preloads extends AgentPreloads = AgentPreloads, Memories extends AgentMemories = AgentMemories> extends Agent<I, O, State, Preloads, Memories> {
+    definition: FunctionAgentDefinition<I, O, State, Preloads, Memories>;
     static create: typeof create;
-    constructor(definition: FunctionAgentDefinition<I, O, Memories, State>, context?: Context<State>);
-    process(input: I, options: AgentProcessOptions<Memories>): Promise<AsyncGenerator<RunnableResponseChunk<O>, void, any> | RunnableResponse<O>>;
+    constructor(definition: FunctionAgentDefinition<I, O, State, Preloads, Memories>, context?: Context<State>);
+    process(input: AgentProcessInput<I, Preloads, Memories>, options: AgentProcessOptions<Preloads, Memories>): Promise<AsyncGenerator<RunnableResponseChunk<O>, void, any> | RunnableResponse<O>>;
 }
-export interface FunctionAgentDefinition<I extends {
-    [name: string]: any;
-}, O extends {
-    [name: string]: any;
-}, Memories extends {
-    [name: string]: MemoryItemWithScore[];
-}, State extends ContextState> extends RunnableDefinition {
+export interface FunctionAgentDefinition<I extends RunnableInput, O extends RunnableOutput, State extends ContextState, Preloads extends AgentPreloads, Memories extends AgentMemories> extends AgentDefinition {
     type: "function_agent";
-    function?: FunctionFuncType<I, O, Memories, State>;
+    function?: FunctionFuncType<I, O, State, Preloads, Memories>;
 }
-export type FunctionFuncType<I extends {
-    [name: string]: any;
-}, O extends {
-    [name: string]: any;
-}, Memories extends {
-    [name: string]: MemoryItemWithScore[];
-}, State extends ContextState> = (input: I, options: {
-    memories: Memories;
+export type FunctionFuncType<I extends RunnableInput, O extends RunnableOutput, State extends ContextState, Preloads extends AgentPreloads, Memories extends AgentMemories> = (input: AgentProcessInput<I, Preloads, Memories>, options: {
     context: Context<State>;
+    preloads: Preloads;
+    memories: Memories;
 }) => Promise<RunnableResponse<O> | AsyncGenerator<RunnableResponseChunk<O>, void>> | AsyncGenerator<RunnableResponseChunk<O>, void>;
-export interface CreateFunctionAgentOptions<I extends {
-    [name: string]: DataTypeSchema;
-}, O extends {
-    [name: string]: DataTypeSchema;
-}, Memories extends {
-    [name: string]: CreateRunnableMemory<I>;
-}, State extends ContextState> {
-    context?: Context<State>;
-    name?: string;
-    inputs: I;
-    outputs: O;
-    memories?: Memories;
-    function?: FunctionFuncType<SchemaMapType<I>, SchemaMapType<O>, {
-        [key in keyof Memories]: MemorableSearchOutput<Memories[key]["memory"]>;
-    }, State>;
-}
-declare function create<I extends {
-    [name: string]: DataTypeSchema;
-}, O extends {
-    [name: string]: DataTypeSchema;
-}, Memories extends {
-    [name: string]: CreateRunnableMemory<I>;
-}, State extends ContextState>({ context, ...options }: CreateFunctionAgentOptions<I, O, Memories, State>): FunctionAgent<SchemaMapType<I>, SchemaMapType<O>, {
-    [name in keyof Memories]: MemorableSearchOutput<Memories[name]["memory"]>;
-}, State>;
+declare function create<I extends CreateAgentInputSchema, O extends CreateAgentOutputSchema, State extends ContextState, Preloads extends CreateAgentPreloadsSchema<I>, Memories extends CreateAgentMemoriesSchema<I>>(options: CreateAgentOptions<I, O, State, Preloads, Memories> & {
+    function?: FunctionFuncType<SchemaToType<I>, SchemaToType<O>, State, CreateAgentPreloadsType<I, Preloads>, CreateAgentMemoriesType<I, Memories>>;
+}): FunctionAgent<SchemaToType<I>, SchemaToType<O>, State, CreateAgentPreloadsType<I, Preloads>, CreateAgentMemoriesType<I, Memories>>;
 export {};

package/lib/dts/index.d.ts

@@ -2,7 +2,7 @@ export * from "./agent";
 export * from "./constants";
 export * from "./context";
 export * from "./definitions/data-type";
-export * from "./definitions/data-type-schema";
+export * from "./definitions/data-schema";
 export * from "./definitions/memory";
 export * from "./definitions/open-api";
 export * from "./function-agent";

package/lib/dts/llm-agent.d.ts

@@ -1,23 +1,15 @@
-import { Agent, type AgentProcessOptions } from "./agent";
+import { Agent, type AgentDefinition, type AgentMemories, type AgentPreloads, type AgentProcessInput, type AgentProcessOptions, type CreateAgentInputSchema, type CreateAgentMemoriesSchema, type CreateAgentMemoriesType, type CreateAgentOptions, type CreateAgentOutputSchema, type CreateAgentPreloadsSchema, type CreateAgentPreloadsType } from "./agent";
 import type { Context, ContextState } from "./context";
-import { type DataTypeSchema, type SchemaMapType } from "./definitions/data-type-schema";
-import { type CreateRunnableMemory } from "./definitions/memory";
+import { type SchemaToType } from "./definitions/data-schema";
 import type { LLMModel, LLMModelInputMessage, LLMModelInputs } from "./llm-model";
-import type { MemorableSearchOutput, MemoryItemWithScore } from "./memorable";
-import type { RunnableDefinition } from "./runnable";
+import type { RunnableInput, RunnableOutput } from "./runnable";
 import { OrderedRecord } from "./utils/ordered-map";
-export declare class LLMAgent<I extends {
-    [name: string]: any;
-} = {}, O extends {
-    [name: string]: any;
-} = {}, Memories extends {
-    [name: string]: MemoryItemWithScore[];
-} = {}, State extends ContextState = ContextState> extends Agent<I, O, Memories, State> {
+export declare class LLMAgent<I extends RunnableInput = RunnableInput, O extends RunnableOutput = RunnableOutput, State extends ContextState = ContextState, Preloads extends AgentPreloads = AgentPreloads, Memories extends AgentMemories = AgentMemories> extends Agent<I, O, State, Preloads, Memories> {
     definition: LLMAgentDefinition;
     model?: LLMModel | undefined;
     static create: typeof create;
     constructor(definition: LLMAgentDefinition, context?: Context<State>, model?: LLMModel | undefined);
-    process(input: I, options: AgentProcessOptions<Memories>): AsyncGenerator<{
+    process(input: AgentProcessInput<I, Preloads, Memories>, options: AgentProcessOptions): AsyncGenerator<{
         $text: string | undefined;
         delta?: undefined;
     } | {
@@ -27,7 +19,7 @@ export declare class LLMAgent<I extends {
     private runWithStructuredOutput;
     private runWithTextOutput;
 }
-export interface LLMAgentDefinition extends RunnableDefinition {
+export interface LLMAgentDefinition extends AgentDefinition {
     type: "llm_agent";
     primaryMemoryId?: string;
     messages?: OrderedRecord<LLMModelInputMessage & {
@@ -36,32 +28,19 @@ export interface LLMAgentDefinition extends RunnableDefinition {
     modelOptions?: LLMModelInputs["modelOptions"];
 }
 /**
- * Options to create LLMAgent.
+ * Create LLMAgent definition.
+ * @param options Options to create LLMAgent.
+ * @returns LLMAgent definition.
  */
-export interface CreateLLMAgentOptions<I extends {
-    [name: string]: DataTypeSchema;
-}, O extends {
-    [name: string]: DataTypeSchema;
-}, Memories extends {
-    [name: string]: CreateRunnableMemory<I>;
-}, State extends ContextState> {
-    context?: Context<State>;
-    /**
-     * Agent name, used to identify the agent.
-     */
-    name?: string;
-    /**
-     * Input variables for this agent.
-     */
-    inputs: I;
+declare function create<I extends CreateAgentInputSchema, O extends CreateAgentOutputSchema, State extends ContextState, Preloads extends CreateAgentPreloadsSchema<I>, Memories extends CreateAgentMemoriesSchema<I, {
     /**
-     * Output variables for this agent.
+     * Whether this memory is primary? Primary memory will be passed as messages to LLM chat model,
+     * otherwise, it will be placed in a system message.
+     *
+     * Only one primary memory is allowed.
      */
-    outputs: O;
-    /**
-     * Memories to be used in this agent.
-     */
-    memories?: Memories;
+    primary?: boolean;
+}>>(options: CreateAgentOptions<I, O, State, Preloads, Memories> & {
     /**
      * Options for LLM chat model.
      */
@@ -70,27 +49,5 @@ export interface CreateLLMAgentOptions<I extends {
      * Messages to be passed to LLM chat model.
      */
     messages?: LLMModelInputMessage[];
-}
-/**
- * Create LLMAgent definition.
- * @param options Options to create LLMAgent.
- * @returns LLMAgent definition.
- */
-declare function create<I extends {
-    [name: string]: DataTypeSchema;
-}, O extends {
-    [name: string]: DataTypeSchema;
-}, Memories extends {
-    [name: string]: CreateRunnableMemory<I> & {
-        /**
-         * Whether this memory is primary? Primary memory will be passed as messages to LLM chat model,
-         * otherwise, it will be placed in a system message.
-         *
-         * Only one primary memory is allowed.
-         */
-        primary?: boolean;
-    };
-}, State extends ContextState>({ context, ...options }: CreateLLMAgentOptions<I, O, Memories, State>): LLMAgent<SchemaMapType<I>, SchemaMapType<O>, {
-    [name in keyof Memories]: MemorableSearchOutput<Memories[name]["memory"]>;
-}, State>;
+}): LLMAgent<SchemaToType<I>, SchemaToType<O>, State, CreateAgentPreloadsType<I, Preloads>, CreateAgentMemoriesType<I, Memories>>;
 export {};

package/lib/dts/llm-decision-agent.d.ts

@@ -1,64 +1,41 @@
-import { Agent, type AgentProcessOptions } from "./agent";
+import { Agent, type AgentDefinition, type AgentMemories, type AgentPreloads, type AgentProcessInput, type AgentProcessOptions, type CreateAgentMemoriesSchema, type CreateAgentMemoriesType, type CreateAgentOptions, type CreateAgentPreloadsSchema, type CreateAgentPreloadsType } from "./agent";
 import type { Context, ContextState } from "./context";
-import type { DataTypeSchema } from "./definitions/data-type-schema";
-import { type CreateRunnableMemory } from "./definitions/memory";
-import type { CreateLLMAgentOptions, LLMAgentDefinition } from "./llm-agent";
-import type { LLMModel } from "./llm-model";
-import type { MemorableSearchOutput, MemoryItemWithScore } from "./memorable";
-import type { Runnable, RunnableDefinition } from "./runnable";
+import type { TypeToSchema } from "./definitions/data-schema";
+import type { BindAgentInput, BoundAgent, OmitBoundAgentInput } from "./definitions/preload";
+import type { LLMAgentDefinition } from "./llm-agent";
+import type { LLMModel, LLMModelInputMessage, LLMModelInputs } from "./llm-model";
+import type { RunnableInput, RunnableOutput } from "./runnable";
 import { OrderedRecord } from "./utils";
-import type { ExtractRunnableInputType, ExtractRunnableOutputType } from "./utils/runnable-type";
-import type { UnionToIntersection } from "./utils/union";
-export declare class LLMDecisionAgent<I extends {
-    [name: string]: any;
-} = {}, O extends {
-    [name: string]: any;
-} = {}, Memories extends {
-    [name: string]: MemoryItemWithScore[];
-} = {}, State extends ContextState = ContextState> extends Agent<I, O, Memories, State> {
+import type { ExtractRunnableInputTypeIntersection, ExtractRunnableOutputType } from "./utils/runnable-type";
+export declare class LLMDecisionAgent<I extends RunnableInput = RunnableInput, O extends RunnableOutput = RunnableOutput, State extends ContextState = ContextState, Preloads extends AgentPreloads = AgentPreloads, Memories extends AgentMemories = AgentMemories> extends Agent<I, O, State, Preloads, Memories> {
     definition: LLMDecisionAgentDefinition;
     model?: LLMModel | undefined;
     static create: typeof create;
     constructor(definition: LLMDecisionAgentDefinition, context?: Context<State>, model?: LLMModel | undefined);
-    process(input: I, options: AgentProcessOptions<Memories>): Promise<import("./runnable").RunnableResponse<O>>;
+    process(input: AgentProcessInput<I, Preloads, Memories>, options: AgentProcessOptions<Preloads, Memories>): Promise<import("./runnable").RunnableResponse<O>>;
 }
-export interface DecisionAgentCaseParameter<R extends Runnable = Runnable> {
-    description?: string;
-    runnable: R;
-}
-/**
- * Options to create LLMDecisionAgent.
- */
-export interface CreateLLMDecisionAgentOptions<Case extends DecisionAgentCaseParameter, I extends UnionToIntersection<ExtractRunnableInputType<Case["runnable"]>, {
-    [name: string]: DataTypeSchema;
-}>, O extends UnionToIntersection<ExtractRunnableOutputType<Case["runnable"]>, {
-    [name: string]: DataTypeSchema;
-}>, Memories extends {
-    [name: string]: CreateRunnableMemory<I>;
-}, State extends ContextState> extends Pick<CreateLLMAgentOptions<I, O, Memories, State>, "name" | "memories" | "messages" | "modelOptions"> {
-    context: Context<State>;
+declare function create<Case extends BoundAgent, InputType extends ExtractRunnableInputTypeIntersection<Case["runnable"]>, OutputType extends ExtractRunnableOutputType<Case["runnable"]>, State extends ContextState, Preloads extends CreateAgentPreloadsSchema<TypeToSchema<InputType>>, Memories extends CreateAgentMemoriesSchema<TypeToSchema<InputType>, {
+    /**
+     * Whether this memory is primary? Primary memory will be passed as messages to LLM chat model,
+     * otherwise, it will be placed in a system message.
+     *
+     * Only one primary memory is allowed.
+     */
+    primary?: boolean;
+}>>(options: Omit<CreateAgentOptions<never, never, State, Preloads, Memories>, "inputs" | "outputs"> & {
     cases: {
         [name: string]: Case;
     };
-}
-declare function create<Case extends DecisionAgentCaseParameter, I extends UnionToIntersection<ExtractRunnableInputType<Case["runnable"]>, {
-    [name: string]: DataTypeSchema;
-}>, O extends UnionToIntersection<ExtractRunnableOutputType<Case["runnable"]>, {
-    [name: string]: DataTypeSchema;
-}>, Memories extends {
-    [name: string]: CreateRunnableMemory<I> & {
-        /**
-         * Whether this memory is primary? Primary memory will be passed as messages to LLM chat model,
-         * otherwise, it will be placed in a system message.
-         *
-         * Only one primary memory is allowed.
-         */
-        primary?: boolean;
-    };
-}, State extends ContextState>({ context, ...options }: CreateLLMDecisionAgentOptions<Case, I, O, Memories, State>): LLMDecisionAgent<UnionToIntersection<ExtractRunnableInputType<Case["runnable"]>, {}>, ExtractRunnableOutputType<Case["runnable"]>, {
-    [name in keyof Memories]: MemorableSearchOutput<Memories[name]["memory"]>;
-}, State>;
-export interface LLMDecisionAgentDefinition extends RunnableDefinition, Pick<LLMAgentDefinition, "modelOptions" | "messages" | "primaryMemoryId"> {
+    /**
+     * Options for LLM chat model.
+     */
+    modelOptions?: LLMModelInputs["modelOptions"];
+    /**
+     * Messages to be passed to LLM chat model.
+     */
+    messages?: LLMModelInputMessage[];
+}): LLMDecisionAgent<OmitBoundAgentInput<Case, "ai">, OutputType, State, CreateAgentPreloadsType<TypeToSchema<InputType>, Preloads>, CreateAgentMemoriesType<TypeToSchema<InputType>, Memories>>;
+export interface LLMDecisionAgentDefinition extends AgentDefinition, Pick<LLMAgentDefinition, "modelOptions" | "messages" | "primaryMemoryId"> {
     type: "llm_decision_agent";
     cases?: OrderedRecord<LLMDecisionCase>;
 }
@@ -69,5 +46,8 @@ export interface LLMDecisionCase {
     runnable?: {
         id?: string;
     };
+    input?: {
+        [inputId: string]: BindAgentInput;
+    };
 }
 export {};

package/lib/dts/llm-model.d.ts

@@ -1,7 +1,7 @@
 import { Agent } from "./agent";
 import type { Context } from "./context";
 export type Role = "system" | "user" | "assistant" | "tool";
-export interface LLMModelInputs {
+export type LLMModelInputs = {
     messages: LLMModelInputMessage[];
     responseFormat?: {
         type: "text";
@@ -23,7 +23,7 @@ export interface LLMModelInputs {
         };
     };
     modelOptions?: LLMModelOptions;
-}
+};
 export interface LLMModelInputMessage {
     role: Role;
     content: string | ({
@@ -60,7 +60,7 @@ export interface LLMModelOptions {
     frequencyPenalty?: number;
     presencePenalty?: number;
 }
-export interface LLMModelOutputs {
+export type LLMModelOutputs = {
     $text?: string | null;
     toolCalls?: {
         id?: string;
@@ -70,7 +70,7 @@ export interface LLMModelOutputs {
             arguments?: string;
         };
     }[];
-}
+};
 export declare abstract class LLMModel extends Agent<LLMModelInputs, LLMModelOutputs> {
     constructor(context?: Context);
 }

package/lib/dts/llm-models/openai-llm-model.d.ts

@@ -8,7 +8,9 @@ export declare class OpenaiLLMModel extends LLMModel {
     private client;
     setApiKey(apiKey: string): void;
     process(input: LLMModelInputs): AsyncGenerator<{
-        $text: string | undefined;
+        $text: string;
+        delta?: undefined;
+    } | {
         delta: {
             toolCalls: {
                 id?: string;
@@ -19,5 +21,6 @@ export declare class OpenaiLLMModel extends LLMModel {
                 };
             }[];
         };
+        $text?: undefined;
     }, void, unknown>;
 }

package/lib/dts/memorable.d.ts

@@ -1,8 +1,7 @@
+import type { Context } from "./context";
 import type { LLMModelInputMessage } from "./llm-model";
 import { Runnable } from "./runnable";
-export interface MemoryMetadata {
-    [key: string]: any;
-}
+export type MemoryMetadata = Record<string, unknown>;
 export type MemoryActionItem<T> = {
     event: "add";
     id: string;
@@ -31,7 +30,7 @@ export interface MemoryItem<T> {
     memory: T;
     metadata: MemoryMetadata;
 }
-export interface MemoryItemWithScore<T = any> extends MemoryItem<T> {
+export interface MemoryItemWithScore<T = unknown> extends MemoryItem<T> {
     score: number;
 }
 export type MemoryMessage = LLMModelInputMessage;
@@ -110,13 +109,19 @@ export type MemoryActions<T> = {
 } | {
     action: "delete";
     inputs: {
-        filter: string | string[] | Record<string, any>;
+        filter: string | string[] | Record<string, unknown>;
+    };
+    outputs: {
+        [name: string]: never;
     };
-    outputs: {};
 } | {
     action: "reset";
-    inputs: {};
-    outputs: {};
+    inputs: {
+        [name: string]: never;
+    };
+    outputs: {
+        [name: string]: never;
+    };
 };
 export interface SortItem {
     field: string;
@@ -124,7 +129,7 @@ export interface SortItem {
 }
 export type MemorySortOptions = SortItem | SortItem[];
 export declare abstract class Memorable<T, C = undefined> extends Runnable<MemoryActions<T>, MemoryActions<T>["outputs"]> {
-    constructor();
+    constructor(context?: Context);
     abstract runner?: MemoryRunner<T, C>;
     abstract add(messages: Extract<MemoryActions<T>, {
         action: "add";
@@ -169,15 +174,18 @@ export declare abstract class Memorable<T, C = undefined> extends Runnable<Memor
     }>["outputs"]>;
     abstract reset(): Promise<void>;
 }
-export interface MemoryRunnerInput<C = undefined> {
+export type MemoryRunnerInput<C = undefined> = {
     messages: MemoryMessage[];
     userId?: string;
     sessionId?: string;
     metadata?: MemoryMetadata;
     filter?: MemoryMetadata;
     customData: C;
-}
-export declare abstract class MemoryRunner<T, C = undefined> extends Runnable<MemoryRunnerInput<C>, MemoryActionItem<T>[]> {
+};
+export type MemoryRunnerOutput<T> = {
+    actions: MemoryActionItem<T>[];
+};
+export declare abstract class MemoryRunner<T, C = undefined> extends Runnable<MemoryRunnerInput<C>, MemoryRunnerOutput<T>> {
     constructor(name: string);
 }
-export type MemorableSearchOutput<T extends Memorable<any>> = Awaited<ReturnType<T["search"]>>["results"];
+export type MemorableSearchOutput<T extends Memorable<unknown>> = Awaited<ReturnType<T["search"]>>["results"];