@aigne/core 1.72.0 → 1.74.0-beta

package/lib/dts/loader/agent-js.d.ts

@@ -1,2 +0,0 @@
-import type { LoadOptions } from "./index.js";
-export declare function loadAgentFromJsFile(path: string, options: LoadOptions): Promise<import("../index.js").Agent<any, any> | import("./agent-yaml.js").AgentSchema>;

package/lib/dts/loader/agent-yaml.d.ts

@@ -1,78 +0,0 @@
-import type { AFSOptions } from "@aigne/afs";
-import { type ZodType, z } from "zod";
-import type { AgentHooks, TaskRenderMode } from "../agents/agent.js";
-import type { LoadOptions } from "./index.js";
-import { chatModelSchema, imageModelSchema } from "./schema.js";
-export interface HooksSchema {
-    priority?: AgentHooks["priority"];
-    onStart?: NestAgentSchema;
-    onSuccess?: NestAgentSchema;
-    onError?: NestAgentSchema;
-    onEnd?: NestAgentSchema;
-    onSkillStart?: NestAgentSchema;
-    onSkillEnd?: NestAgentSchema;
-    onHandoff?: NestAgentSchema;
-}
-export type NestAgentSchema = string | {
-    url: string;
-    defaultInput?: Record<string, any>;
-    hooks?: HooksSchema | HooksSchema[];
-} | AgentSchema;
-export type AFSModuleSchema = string | {
-    module: string;
-    options?: Record<string, any>;
-};
-export interface AFSContextPresetSchema {
-    view?: string;
-    select?: {
-        agent: NestAgentSchema;
-    };
-    per?: {
-        agent: NestAgentSchema;
-    };
-    dedupe?: {
-        agent: NestAgentSchema;
-    };
-}
-export interface AFSContextSchema {
-    search?: {
-        presets?: Record<string, AFSContextPresetSchema>;
-    };
-    list?: {
-        presets?: Record<string, AFSContextPresetSchema>;
-    };
-}
-export interface AgentSchema {
-    type: string;
-    name?: string;
-    description?: string;
-    model?: z.infer<typeof chatModelSchema>;
-    imageModel?: z.infer<typeof imageModelSchema>;
-    taskTitle?: string;
-    taskRenderMode?: TaskRenderMode;
-    inputSchema?: ZodType<Record<string, any>>;
-    defaultInput?: Record<string, any>;
-    outputSchema?: ZodType<Record<string, any>>;
-    includeInputInOutput?: boolean;
-    skills?: NestAgentSchema[];
-    hooks?: HooksSchema | HooksSchema[];
-    memory?: boolean | {
-        provider: string;
-        subscribeTopic?: string[];
-    };
-    afs?: boolean | (Omit<AFSOptions, "modules" | "context"> & {
-        modules?: AFSModuleSchema[];
-        context?: AFSContextSchema;
-    });
-    shareAFS?: boolean;
-    [key: string]: unknown;
-}
-export declare function parseAgentFile(path: string, data: any, options: LoadOptions): Promise<AgentSchema>;
-export declare function loadAgentFromYamlFile(path: string, options: LoadOptions): Promise<AgentSchema>;
-export declare const getAgentSchema: ({ filepath }: {
-    filepath: string;
-    options?: LoadOptions;
-}) => ZodType<AgentSchema, z.ZodTypeDef, AgentSchema>;
-export declare const getNestAgentSchema: ({ filepath, }: {
-    filepath: string;
-}) => ZodType<NestAgentSchema>;

package/lib/dts/loader/agents.d.ts

@@ -1,4 +0,0 @@
-import type { AgentClass } from "../agents/types.ts";
-export declare const builtinAgents: {
-    [type: string]: AgentClass;
-};

package/lib/dts/loader/error.d.ts

@@ -1,2 +0,0 @@
-export declare class LoadJsAgentError extends Error {
-}

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

@@ -1,2 +0,0 @@
-import type { FunctionAgentFn } from "../agents/agent.js";
-export declare function codeToFunctionAgentFn(code: string): FunctionAgentFn;

package/lib/dts/loader/index.d.ts

@@ -1,247 +0,0 @@
-import { AFS, type AFSModule } from "@aigne/afs";
-import { type ZodType, z } from "zod";
-import { Agent, type AgentOptions } from "../agents/agent.js";
-import type { ChatModel } from "../agents/chat-model.js";
-import type { ImageModel } from "../agents/image-model.js";
-import type { AIGNEOptions } from "../aigne/aigne.js";
-import type { MemoryAgent, MemoryAgentOptions } from "../memory/memory.js";
-import { type PromiseOrValue } from "../utils/type-utils.js";
-import { loadAgentFromYamlFile, type NestAgentSchema } from "./agent-yaml.js";
-export interface LoadOptions {
-    memories?: {
-        new (parameters?: MemoryAgentOptions): MemoryAgent;
-    }[];
-    model?: ChatModel | ((model?: z.infer<typeof aigneFileSchema>["model"]) => PromiseOrValue<ChatModel | undefined>);
-    imageModel?: ImageModel | ((model?: z.infer<typeof aigneFileSchema>["imageModel"]) => PromiseOrValue<ImageModel | undefined>);
-    afs?: {
-        sharedAFS?: AFS;
-        availableModules?: {
-            module: string;
-            alias?: string[];
-            load: (options: {
-                filepath: string;
-                parsed?: object;
-            }) => PromiseOrValue<AFSModule>;
-        }[];
-    };
-    aigne?: z.infer<typeof aigneFileSchema>;
-    require?: (modulePath: string, options: {
-        parent?: string;
-    }) => Promise<any>;
-}
-export interface AgentLoadOptions extends LoadOptions {
-    loadNestAgent: (path: string, agent: NestAgentSchema, options: LoadOptions, agentOptions?: AgentOptions<any, any> & Record<string, unknown>) => Promise<Agent>;
-}
-export declare function load(path: string, options?: LoadOptions): Promise<AIGNEOptions>;
-export declare function loadAgent(path: string, options: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
-export declare function loadNestAgent(path: string, agent: NestAgentSchema, options: LoadOptions, agentOptions?: AgentOptions<any, any> & Record<string, unknown>): Promise<Agent>;
-export declare function parseAgent(path: string, agent: Awaited<ReturnType<typeof loadAgentFromYamlFile>>, options: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
-type CliAgent = string | {
-    url?: string;
-    name?: string;
-    alias?: string[];
-    description?: string;
-    agents?: CliAgent[];
-};
-declare const aigneFileSchema: z.ZodObject<{
-    name: ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
-    description: ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
-    model: ZodType<z.objectInputType<{
-        model: ZodType<string | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, string | {
-            $get: string;
-        } | undefined>;
-        temperature: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        topP: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        frequencyPenalty: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        presencePenalty: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
-            $get: string;
-        } | undefined>;
-    }, z.ZodTypeAny, "passthrough"> | undefined, z.ZodTypeDef, z.objectInputType<{
-        model: ZodType<string | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, string | {
-            $get: string;
-        } | undefined>;
-        temperature: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        topP: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        frequencyPenalty: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        presencePenalty: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
-            $get: string;
-        } | undefined>;
-    }, z.ZodTypeAny, "passthrough"> | undefined>;
-    imageModel: ZodType<z.objectInputType<{
-        model: ZodType<string | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, string | {
-            $get: string;
-        } | undefined>;
-    }, z.ZodTypeAny, "passthrough"> | undefined, z.ZodTypeDef, z.objectInputType<{
-        model: ZodType<string | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, string | {
-            $get: string;
-        } | undefined>;
-    }, z.ZodTypeAny, "passthrough"> | undefined>;
-    agents: ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
-    skills: ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
-    mcpServer: ZodType<{
-        agents?: string[] | undefined;
-    } | undefined, z.ZodTypeDef, {
-        agents?: string[] | undefined;
-    } | undefined>;
-    cli: ZodType<{
-        agents?: CliAgent[] | undefined;
-        chat?: string | undefined;
-    } | undefined, z.ZodTypeDef, {
-        agents?: CliAgent[] | undefined;
-        chat?: string | undefined;
-    } | undefined>;
-}, "strip", z.ZodTypeAny, {
-    model?: z.objectInputType<{
-        model: ZodType<string | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, string | {
-            $get: string;
-        } | undefined>;
-        temperature: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        topP: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        frequencyPenalty: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        presencePenalty: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
-            $get: string;
-        } | undefined>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-    name?: string | undefined;
-    description?: string | undefined;
-    imageModel?: z.objectInputType<{
-        model: ZodType<string | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, string | {
-            $get: string;
-        } | undefined>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-    skills?: string[] | undefined;
-    agents?: string[] | undefined;
-    mcpServer?: {
-        agents?: string[] | undefined;
-    } | undefined;
-    cli?: {
-        agents?: CliAgent[] | undefined;
-        chat?: string | undefined;
-    } | undefined;
-}, {
-    model?: z.objectInputType<{
-        model: ZodType<string | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, string | {
-            $get: string;
-        } | undefined>;
-        temperature: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        topP: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        frequencyPenalty: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        presencePenalty: ZodType<number | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | {
-            $get: string;
-        } | undefined>;
-        thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
-            $get: string;
-        } | undefined>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-    name?: string | undefined;
-    description?: string | undefined;
-    imageModel?: z.objectInputType<{
-        model: ZodType<string | {
-            $get: string;
-        } | undefined, z.ZodTypeDef, string | {
-            $get: string;
-        } | undefined>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-    skills?: string[] | undefined;
-    agents?: string[] | undefined;
-    mcpServer?: {
-        agents?: string[] | undefined;
-    } | undefined;
-    cli?: {
-        agents?: CliAgent[] | undefined;
-        chat?: string | undefined;
-    } | undefined;
-}>;
-export declare function loadAIGNEFile(path: string): Promise<{
-    aigne: z.infer<typeof aigneFileSchema>;
-    rootDir: string;
-}>;
-export declare function findAIGNEFile(path: string): Promise<string>;
-export {};

package/lib/dts/loader/schema.d.ts

@@ -1,167 +0,0 @@
-import { type ZodType, z } from "zod";
-import { type Role } from "../agents/chat-model.js";
-import { PromptBuilder } from "../prompt/prompt-builder.js";
-export declare const inputOutputSchema: ({ path }: {
-    path: string;
-}) => z.ZodUnion<[ZodType<any, z.ZodTypeDef, any>, z.ZodEffects<z.ZodObject<{
-    type: z.ZodLiteral<"object">;
-    properties: z.ZodRecord<z.ZodString, z.ZodAny>;
-    required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    additionalProperties: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    type: "object";
-    properties: Record<string, any>;
-    required?: string[] | undefined;
-    additionalProperties?: boolean | undefined;
-}, {
-    type: "object";
-    properties: Record<string, any>;
-    required?: string[] | undefined;
-    additionalProperties?: boolean | undefined;
-}>, any, {
-    type: "object";
-    properties: Record<string, any>;
-    required?: string[] | undefined;
-    additionalProperties?: boolean | undefined;
-}>]>;
-export declare const defaultInputSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodUnknown, z.ZodObject<{
-    $get: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    $get: string;
-}, {
-    $get: string;
-}>]>>;
-declare const chatModelObjectSchema: z.ZodObject<{
-    model: ZodType<string | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, string | {
-        $get: string;
-    } | undefined>;
-    temperature: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    topP: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    frequencyPenalty: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    presencePenalty: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
-        $get: string;
-    } | undefined>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    model: ZodType<string | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, string | {
-        $get: string;
-    } | undefined>;
-    temperature: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    topP: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    frequencyPenalty: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    presencePenalty: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
-        $get: string;
-    } | undefined>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    model: ZodType<string | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, string | {
-        $get: string;
-    } | undefined>;
-    temperature: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    topP: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    frequencyPenalty: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    presencePenalty: ZodType<number | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | {
-        $get: string;
-    } | undefined>;
-    thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
-        $get: string;
-    } | undefined>;
-}, z.ZodTypeAny, "passthrough">>;
-export declare const chatModelSchema: typeof chatModelObjectSchema;
-declare const imageModelObjectSchema: z.ZodObject<{
-    model: ZodType<string | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, string | {
-        $get: string;
-    } | undefined>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    model: ZodType<string | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, string | {
-        $get: string;
-    } | undefined>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    model: ZodType<string | {
-        $get: string;
-    } | undefined, z.ZodTypeDef, string | {
-        $get: string;
-    } | undefined>;
-}, z.ZodTypeAny, "passthrough">>;
-export declare const imageModelSchema: typeof imageModelObjectSchema;
-export declare function optionalize<T>(schema: ZodType<T>): ZodType<T | undefined>;
-export declare function camelizeSchema<T extends ZodType>(schema: T, { shallow }?: {
-    shallow?: boolean;
-}): T;
-export declare function preprocessSchema<T extends ZodType>(fn: (data: unknown) => unknown, schema: T): T;
-export type Instructions = {
-    role: Exclude<Role, "tool">;
-    content: string;
-    path: string;
-    cacheControl?: {
-        type: "ephemeral";
-        ttl?: "5m" | "1h";
-    };
-}[];
-export declare const getInstructionsSchema: ({ filepath }: {
-    filepath: string;
-}) => ZodType<Instructions>;
-export declare function instructionsToPromptBuilder(instructions: Instructions | string): PromptBuilder;
-export {};

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

@@ -1,3 +0,0 @@
-export * from "./memory.js";
-export * from "./recorder.js";
-export * from "./retriever.js";

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

@@ -1,93 +0,0 @@
-import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "../agents/agent.js";
-import type { Context } from "../aigne/context.js";
-import type { MessagePayload } from "../aigne/message-queue.js";
-import { MemoryRecorder, type MemoryRecorderInput, type MemoryRecorderOptions, type MemoryRecorderOutput } from "./recorder.js";
-import { MemoryRetriever, type MemoryRetrieverInput, type MemoryRetrieverOptions, type MemoryRetrieverOutput } from "./retriever.js";
-export interface Memory {
-    id: string;
-    sessionId?: string | null;
-    content: unknown;
-    createdAt: string;
-}
-export declare const newMemoryId: () => string;
-export interface MemoryAgentOptions extends Partial<Pick<MemoryAgent, "autoUpdate">>, Pick<AgentOptions, "subscribeTopic" | "skills"> {
-    recorder?: MemoryRecorder | MemoryRecorderOptions["process"] | MemoryRecorderOptions;
-    retriever?: MemoryRetriever | MemoryRetrieverOptions["process"] | MemoryRetrieverOptions;
-}
-/**
- * A specialized agent responsible for managing, storing, and retrieving memories within the agent system.
- *
- * MemoryAgent serves as a bridge between application logic and memory storage/retrieval mechanisms.
- * It delegates the actual memory operations to specialized recorder and retriever agents that
- * are attached as skills. This agent doesn't directly process messages like other agents but
- * instead provides memory management capabilities to the system.
- */
-export declare class MemoryAgent extends Agent {
-    tag: string;
-    /**
-     * Creates a new MemoryAgent instance.
-     */
-    constructor(options: MemoryAgentOptions);
-    private _retriever?;
-    /**
-     * Agent used for retrieving memories from storage.
-     *
-     * This retriever is automatically added to the agent's skills when set.
-     * Setting a new retriever will remove any previously set retriever from skills.
-     */
-    get retriever(): MemoryRetriever | undefined;
-    set retriever(value: MemoryRetriever | undefined);
-    private _recorder?;
-    /**
-     * Agent used for recording and storing new memories.
-     *
-     * This recorder is automatically added to the agent's skills when set.
-     * Setting a new recorder will remove any previously set recorder from skills.
-     */
-    get recorder(): MemoryRecorder | undefined;
-    set recorder(value: MemoryRecorder | undefined);
-    /**
-     * Controls whether to automatically update the memory when agent call completes.
-     *
-     * When true, the agent will automatically record any relevant information
-     * after completing operations, creating a history of interactions.
-     */
-    autoUpdate?: boolean;
-    /**
-     * Indicates whether this agent can be directly called.
-     *
-     * MemoryAgent is designed to be used as a supporting component rather than
-     * being directly invoked for processing, so this returns false.
-     */
-    get isCallable(): boolean;
-    /**
-     * The standard message processing method required by the Agent interface.
-     *
-     * MemoryAgent doesn't directly process messages like other agents, so this method
-     * throws an error when called. Use the specialized retrieve() and record() methods instead.
-     */
-    process(_input: Message, _options: AgentInvokeOptions): Promise<Message>;
-    /**
-     * Retrieves memories based on the provided input criteria.
-     *
-     * Delegates the actual retrieval operation to the configured retriever agent.
-     *
-     * @param input - The retrieval parameters (can include search terms, limits, etc.)
-     * @param context - The execution context
-     * @returns A promise resolving to the retrieved memories
-     * @throws Error - If no retriever has been initialized
-     */
-    retrieve(input: MemoryRetrieverInput, context: Context): Promise<MemoryRetrieverOutput>;
-    /**
-     * Records new memories based on the provided input content.
-     *
-     * Delegates the actual recording operation to the configured recorder agent.
-     *
-     * @param input - The content to be recorded as memories
-     * @param context - The execution context
-     * @returns A promise resolving to the recorded memories
-     * @throws Error - If no recorder has been initialized
-     */
-    record(input: MemoryRecorderInput, context: Context): Promise<MemoryRecorderOutput>;
-    onMessage({ role, source, message, context }: MessagePayload): Promise<void>;
-}