@aigne/core 1.0.10 → 1.0.11

package/lib/esm/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/esm/index.js

@@ -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/esm/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/esm/llm-agent.js

@@ -12,10 +12,11 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { nanoid } from "nanoid";
 import { inject, injectable } from "tsyringe";
-import { Agent } from "./agent";
+import { Agent, } from "./agent";
 import { StreamTextOutputName, TYPES } from "./constants";
-import { schemaToDataType, } from "./definitions/data-type-schema";
-import { toRunnableMemories, } from "./definitions/memory";
+import { schemaToDataType } from "./definitions/data-schema";
+import { toRunnableMemories } from "./definitions/memory";
+import { preloadCreatorsToPreloads } from "./definitions/preload";
 import { prepareMessages } from "./utils/message-utils";
 import { renderMessage } from "./utils/mustache-utils";
 import { OrderedRecord } from "./utils/ordered-map";
@@ -101,10 +102,11 @@ export { LLMAgent };
  * @param options Options to create LLMAgent.
  * @returns LLMAgent definition.
  */
-function create({ context, ...options }) {
+function create(options) {
     const agentId = options.name || nanoid();
     const inputs = schemaToDataType(options.inputs);
     const outputs = schemaToDataType(options.outputs);
+    const preloads = preloadCreatorsToPreloads(inputs, options.preloads);
     const memories = toRunnableMemories(agentId, inputs, options.memories ?? {});
     const primaryMemoryNames = Object.entries(options.memories ?? {})
         .filter(([, i]) => i.primary)
@@ -123,9 +125,10 @@ function create({ context, ...options }) {
         type: "llm_agent",
         inputs,
         outputs,
+        preloads,
         primaryMemoryId: primaryMemoryNames?.at(0),
         memories,
         modelOptions: options.modelOptions,
         messages,
-    }, context);
+    }, options.context);
 }

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

@@ -1,44 +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 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 { 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 { BindAgentInput, BoundAgent, ExtractRunnableInputTypeIntersection, ExtractRunnableOutputType, OmitBoundAgentInput } from "./utils/runnable-type";
-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>>;
 }
-declare function create<Case extends BoundAgent, I extends ExtractRunnableInputTypeIntersection<Case["runnable"]>, O extends ExtractRunnableOutputType<Case["runnable"]>, 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 }: 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;
     };
-}): LLMDecisionAgent<OmitBoundAgentInput<Case, "ai">, 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>;
 }

package/lib/esm/llm-decision-agent.js

@@ -12,9 +12,9 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { nanoid } from "nanoid";
 import { inject, injectable } from "tsyringe";
-import { Agent } from "./agent";
+import { Agent, } from "./agent";
 import { TYPES } from "./constants";
-import { toRunnableMemories, } from "./definitions/memory";
+import { toRunnableMemories } from "./definitions/memory";
 import { OrderedRecord, extractOutputsFromRunnableOutput, renderMessage, } from "./utils";
 import { prepareMessages } from "./utils/message-utils";
 import { outputsToJsonSchema } from "./utils/structured-output-schema";
@@ -94,7 +94,7 @@ LLMDecisionAgent = __decorate([
     __metadata("design:paramtypes", [Object, Object, Function])
 ], LLMDecisionAgent);
 export { LLMDecisionAgent };
-function create({ context, ...options }) {
+function create(options) {
     const agentId = options.name || nanoid();
     const cases = OrderedRecord.fromArray(Object.entries(options.cases).map(([name, c]) => {
         const bindInputs = Object.entries(c.input ?? {});
@@ -137,5 +137,5 @@ function create({ context, ...options }) {
         memories,
         modelOptions: options.modelOptions,
         cases,
-    }, context);
+    }, options.context);
 }

package/lib/esm/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/esm/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"];

package/lib/esm/memorable.js

@@ -2,14 +2,14 @@ import { camelCase, startCase } from "lodash";
 import { Runnable } from "./runnable";
 import { OrderedRecord } from "./utils";
 export class Memorable extends Runnable {
-    constructor() {
+    constructor(context) {
         super({
             id: "memory",
             type: "memory",
             name: "Memory",
             inputs: OrderedRecord.fromArray([]),
             outputs: OrderedRecord.fromArray([]),
-        });
+        }, context);
     }
 }
 export class MemoryRunner extends Runnable {

package/lib/esm/open-api-agent.d.ts

@@ -1,55 +1,26 @@
-import { Agent } from "./agent";
+import { Agent, type AgentDefinition, type AgentMemories, type AgentPreloads, type AgentProcessInput, 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 { AuthConfig, FetchRequest, HTTPMethod, OpenAPIDataType, OpenAPIDataTypeSchema } from "./definitions/open-api";
-import type { MemorableSearchOutput, MemoryItemWithScore } from "./memorable";
-import type { RunnableDefinition } from "./runnable";
+import { type SchemaToType } from "./definitions/data-schema";
+import type { AuthConfig, FetchRequest, HTTPMethod, OpenAPIDataType } from "./definitions/open-api";
+import type { RunnableInput, RunnableOutput } from "./runnable";
 import type { OrderedRecord } from "./utils";
-export declare class OpenAPIAgent<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 OpenAPIAgent<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: OpenAPIAgentDefinition;
     static create: typeof create;
     constructor(definition: OpenAPIAgentDefinition, context?: Context<State>);
-    process(input: I): Promise<O>;
+    process(input: AgentProcessInput<I, Preloads, Memories>): Promise<O>;
     fetch<T>(request: FetchRequest): Promise<T>;
 }
-export interface OpenAPIAgentDefinition extends RunnableDefinition {
+export interface OpenAPIAgentDefinition extends AgentDefinition {
     type: "open_api_agent";
     inputs: OrderedRecord<OpenAPIDataType>;
     url: string;
     method?: HTTPMethod;
     auth?: AuthConfig;
 }
-export interface CreateOpenAPIAgentOptions<I extends {
-    [name: string]: OpenAPIDataTypeSchema;
-}, O extends {
-    [name: string]: DataTypeSchema;
-}, Memories extends {
-    [name: string]: CreateRunnableMemory<I>;
-}, State extends ContextState> {
-    context?: Context<State>;
-    id?: string;
-    name?: string;
-    inputs: I;
-    outputs: O;
-    memories?: Memories;
+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> & {
     url: string;
     method?: HTTPMethod;
     auth?: AuthConfig;
-}
-declare function create<I extends {
-    [name: string]: OpenAPIDataTypeSchema;
-}, O extends {
-    [name: string]: DataTypeSchema;
-}, Memories extends {
-    [name: string]: CreateRunnableMemory<I>;
-}, State extends ContextState>({ context, ...options }: CreateOpenAPIAgentOptions<I, O, Memories, State>): OpenAPIAgent<SchemaMapType<I>, SchemaMapType<O>, {
-    [name in keyof Memories]: MemorableSearchOutput<Memories[name]["memory"]>;
-}, State>;
+}): OpenAPIAgent<SchemaToType<I>, SchemaToType<O>, State, CreateAgentPreloadsType<I, Preloads>, CreateAgentMemoriesType<I, Memories>>;
 export {};

package/lib/esm/open-api-agent.js

@@ -12,9 +12,11 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { nanoid } from "nanoid";
 import { inject, injectable } from "tsyringe";
-import { Agent } from "./agent";
+import { Agent, } from "./agent";
 import { TYPES } from "./constants";
-import { schemaToDataType, } from "./definitions/data-type-schema";
+import { schemaToDataType } from "./definitions/data-schema";
+import { toRunnableMemories } from "./definitions/memory";
+import { preloadCreatorsToPreloads } from "./definitions/preload";
 import { fetchOpenApi } from "./utils/fetch-open-api";
 import { formatOpenAPIRequest } from "./utils/open-api-parameter";
 let OpenAPIAgent = class OpenAPIAgent extends Agent {
@@ -42,18 +44,22 @@ OpenAPIAgent = __decorate([
     __metadata("design:paramtypes", [Object, Object])
 ], OpenAPIAgent);
 export { OpenAPIAgent };
-function create({ context, ...options }) {
-    const agentId = options.id || options.name || nanoid();
+function create(options) {
+    const agentId = options.name || nanoid();
     const inputs = schemaToDataType(options.inputs);
     const outputs = schemaToDataType(options.outputs);
+    const preloads = preloadCreatorsToPreloads(inputs, options.preloads);
+    const memories = toRunnableMemories(agentId, inputs, options.memories || {});
     return new OpenAPIAgent({
         id: agentId,
         name: options.name,
         type: "open_api_agent",
         inputs,
+        preloads,
+        memories,
         outputs,
         url: options.url,
         method: options.method,
         auth: options.auth,
-    }, context);
+    }, options.context);
 }

package/lib/esm/pipeline-agent.d.ts

@@ -1,63 +1,40 @@
-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 { Runnable, RunnableDefinition, RunnableOutput, RunnableResponseDelta } from "./runnable";
+import { type SchemaToType } from "./definitions/data-schema";
+import type { Runnable, RunnableInput, RunnableOutput, RunnableOutputType, RunnableResponseDelta } from "./runnable";
 import type { MakeNullablePropertyOptional } from "./utils/nullable";
 import { OrderedRecord } from "./utils/ordered-map";
 import type { ExtractRunnableInputType } from "./utils/runnable-type";
-export declare class PipelineAgent<I extends {
-    [key: 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 PipelineAgent<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, AgentPreloads, Memories> {
     definition: PipelineAgentDefinition;
     static create: typeof create;
     constructor(definition: PipelineAgentDefinition, context?: Context<State>);
-    process(input: I, options: AgentProcessOptions<Memories>): Promise<import("stream/web").ReadableStream<RunnableResponseDelta<O>>>;
+    process(input: AgentProcessInput<I, Preloads, Memories>, options: AgentProcessOptions<Preloads, Memories>): Promise<import("stream/web").ReadableStream<RunnableResponseDelta<O>>>;
 }
 type VariableWithPropPath = {
     fromVariable: string;
     fromVariablePropPath?: (string | number)[];
 };
-export type PipelineAgentProcessParameter<R extends Runnable = any, RI extends {
-    [name: string]: DataTypeSchema;
-} = ExtractRunnableInputType<R>> = {
+export type PipelineAgentProcessParameter<R extends Runnable = Runnable, RI extends RunnableInput = ExtractRunnableInputType<R>> = {
     runnable: R;
     input: MakeNullablePropertyOptional<{
         [key in keyof RI]: VariableWithPropPath;
     }>;
 };
-declare function create<I extends {
-    [name: string]: DataTypeSchema;
-}, O extends {
-    [name: string]: DataTypeSchema & {
-        fromVariable: string;
-        fromVariablePropPath?: string[];
-    };
-}, Memories extends {
-    [name: string]: CreateRunnableMemory<I>;
-}, State extends ContextState, Processes extends {
+declare function create<I extends CreateAgentInputSchema, O extends CreateAgentOutputSchema<{
+    fromVariable: string;
+    fromVariablePropPath?: string[];
+}>, State extends ContextState, Preloads extends CreateAgentPreloadsSchema<I>, Memories extends CreateAgentMemoriesSchema<I>, Processes extends {
     [name: string]: PipelineAgentProcessParameter;
-}>({ context, ...options }: {
-    context: Context<State>;
-    name?: string;
-    inputs: I;
-    outputs: O;
-    memories?: Memories;
+}>(options: CreateAgentOptions<I, O, State, Preloads, Memories> & {
     processes: Processes;
-}): PipelineAgent<SchemaMapType<I>, SchemaMapType<O>, {
-    [name in keyof Memories]: MemorableSearchOutput<Memories[name]["memory"]>;
-}, State>;
-export interface PipelineAgentDefinition extends RunnableDefinition {
+}): PipelineAgent<SchemaToType<I>, SchemaToType<O>, State, CreateAgentPreloadsType<I, Preloads>, CreateAgentMemoriesType<I, Memories>>;
+export interface PipelineAgentDefinition extends AgentDefinition {
     type: "pipeline_agent";
     processes?: OrderedRecord<PipelineAgentProcess>;
     outputs: OrderedRecord<PipelineAgentOutput>;
 }
-export type PipelineAgentOutput = RunnableOutput & {
+export type PipelineAgentOutput = RunnableOutputType & {
     from: "variable";
     fromVariableId?: string;
     fromVariablePropPath?: (string | number)[];

package/lib/esm/pipeline-agent.js

@@ -13,12 +13,13 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { get, isNil } from "lodash";
 import { nanoid } from "nanoid";
 import { inject, injectable } from "tsyringe";
-import { Agent } from "./agent";
+import { Agent, } from "./agent";
 import { StreamTextOutputName, TYPES } from "./constants";
-import { schemaToDataType, } from "./definitions/data-type-schema";
-import { toRunnableMemories, } from "./definitions/memory";
-import logger from "./logger";
+import { schemaToDataType } from "./definitions/data-schema";
+import { toRunnableMemories } from "./definitions/memory";
+import { preloadCreatorsToPreloads } from "./definitions/preload";
 import { isNonNullable } from "./utils/is-non-nullable";
+import { logger } from "./utils/logger";
 import { OrderedRecord } from "./utils/ordered-map";
 let PipelineAgent = class PipelineAgent extends Agent {
     definition;
@@ -138,9 +139,10 @@ PipelineAgent = __decorate([
     __metadata("design:paramtypes", [Object, Object])
 ], PipelineAgent);
 export { PipelineAgent };
-function create({ context, ...options }) {
+function create(options) {
     const agentId = options.name || nanoid();
     const inputs = schemaToDataType(options.inputs);
+    const preloads = preloadCreatorsToPreloads(inputs, options.preloads);
     const memories = toRunnableMemories(agentId, inputs, options.memories || {});
     const processes = OrderedRecord.fromArray([]);
     for (const [name, p] of Object.entries(options.processes)) {
@@ -190,8 +192,9 @@ function create({ context, ...options }) {
         name: options.name,
         type: "pipeline_agent",
         inputs,
+        preloads,
         memories,
         outputs,
         processes,
-    }, context);
+    }, options.context);
 }