@aigne/core 1.15.0 → 1.17.0

package/lib/cjs/client/client.js

@@ -1,87 +0,0 @@
-"use strict";
-/**
- * Client module used to interact with the AIGNE framework.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIGNEClient = void 0;
-const event_stream_js_1 = require("../utils/event-stream.js");
-const type_utils_js_1 = require("../utils/type-utils.js");
-/**
- * Client for interacting with a remote AIGNE server.
- * AIGNEClient provides a client-side interface that matches the AIGNE API,
- * allowing applications to invoke agents and receive responses from a remote AIGNE instance.
- *
- * @example
- * Here's a simple example of how to use AIGNEClient:
- * {@includeCode ../../test/client/client.test.ts#example-aigne-client-simple}
- *
- * @example
- * Here's an example of how to use AIGNEClient with streaming response:
- * {@includeCode ../../test/client/client.test.ts#example-aigne-client-streaming}
- */
-class AIGNEClient {
-    options;
-    /**
-     * Creates a new AIGNEClient instance.
-     *
-     * @param options - Configuration options for connecting to the AIGNE server
-     */
-    constructor(options) {
-        this.options = options;
-    }
-    async invoke(agent, input, options) {
-        // Send the agent invocation request to the AIGNE server
-        const response = await this.fetch(this.options.url, {
-            ...options?.fetchOptions,
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                ...options?.fetchOptions?.headers,
-            },
-            body: JSON.stringify({ agent, input, options }),
-        });
-        // For non-streaming responses, simply parse the JSON response and return it
-        if (!options?.streaming) {
-            return await response.json();
-        }
-        // For streaming responses, set up the streaming pipeline
-        const stream = response.body;
-        if (!stream)
-            throw new Error("Response body is not a stream");
-        // Process the stream through a series of transforms:
-        // 1. Convert bytes to text
-        // 2. Parse SSE format into structured events
-        // 3. Convert events into a standardized agent response stream
-        return stream
-            .pipeThrough(new TextDecoderStream())
-            .pipeThrough(new event_stream_js_1.EventStreamParser())
-            .pipeThrough(new event_stream_js_1.AgentResponseStreamParser());
-    }
-    /**
-     * Enhanced fetch method that handles error responses from the AIGNE server.
-     * This method wraps the standard fetch API to provide better error handling and reporting.
-     *
-     * @param args - Standard fetch API arguments (url and options)
-     * @returns A Response object if the request was successful
-     * @throws Error with detailed information if the request failed
-     *
-     * @private
-     */
-    async fetch(...args) {
-        const result = await globalThis.fetch(...args);
-        if (!result.ok) {
-            let message;
-            try {
-                const text = await result.text();
-                const json = (0, type_utils_js_1.tryOrThrow)(() => JSON.parse(text));
-                message = json?.error?.message || text;
-            }
-            catch {
-                // ignore
-            }
-            throw new Error(`Failed to fetch url ${args[0]} with status ${result.status}: ${message}`);
-        }
-        return result;
-    }
-}
-exports.AIGNEClient = AIGNEClient;

package/lib/cjs/client/index.d.ts

@@ -1 +0,0 @@
-export * from "./client.js";

package/lib/cjs/client/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./client.js"), exports);

package/lib/cjs/memory/default-memory.d.ts

@@ -1,16 +0,0 @@
-import { type Memory, MemoryAgent, type MemoryAgentOptions } from "./memory.js";
-export declare const DEFAULT_MAX_MEMORY_COUNT = 10;
-export interface DefaultMemoryOptions extends Partial<MemoryAgentOptions> {
-}
-export declare class DefaultMemory extends MemoryAgent {
-    constructor(options?: DefaultMemoryOptions);
-    storage: Memory[];
-    search(options?: {
-        limit?: number;
-    }): Promise<{
-        result: Memory[];
-    }>;
-    create(memory: Pick<Memory, "content">): Promise<{
-        result: Memory;
-    }>;
-}

package/lib/cjs/models/bedrock-chat-model.d.ts

@@ -1,79 +0,0 @@
-import { BedrockRuntimeClient } from "@aws-sdk/client-bedrock-runtime";
-import { z } from "zod";
-import type { AgentResponse } from "../agents/agent.js";
-import { ChatModel, type ChatModelInput, type ChatModelOptions, type ChatModelOutput } from "./chat-model.js";
-/**
- * @hidden
- */
-export declare function extractLastJsonObject(text: string): string | null;
-export interface BedrockChatModelOptions {
-    accessKeyId?: string;
-    secretAccessKey?: string;
-    region?: string;
-    model?: string;
-    modelOptions?: ChatModelOptions;
-}
-/**
- * @hidden
- */
-export declare const bedrockChatModelOptionsSchema: z.ZodObject<{
-    region: z.ZodOptional<z.ZodString>;
-    model: z.ZodOptional<z.ZodString>;
-    modelOptions: z.ZodOptional<z.ZodObject<{
-        model: z.ZodOptional<z.ZodString>;
-        temperature: z.ZodOptional<z.ZodNumber>;
-        topP: z.ZodOptional<z.ZodNumber>;
-        frequencyPenalty: z.ZodOptional<z.ZodNumber>;
-        presencePenalty: z.ZodOptional<z.ZodNumber>;
-        parallelToolCalls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    }, "strip", z.ZodTypeAny, {
-        parallelToolCalls: boolean;
-        model?: string | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        presencePenalty?: number | undefined;
-    }, {
-        model?: string | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        presencePenalty?: number | undefined;
-        parallelToolCalls?: boolean | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    modelOptions?: {
-        parallelToolCalls: boolean;
-        model?: string | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        presencePenalty?: number | undefined;
-    } | undefined;
-    model?: string | undefined;
-    region?: string | undefined;
-}, {
-    modelOptions?: {
-        model?: string | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        presencePenalty?: number | undefined;
-        parallelToolCalls?: boolean | undefined;
-    } | undefined;
-    model?: string | undefined;
-    region?: string | undefined;
-}>;
-export declare class BedrockChatModel extends ChatModel {
-    options?: BedrockChatModelOptions | undefined;
-    constructor(options?: BedrockChatModelOptions | undefined);
-    /**
-     * @hidden
-     */
-    protected _client?: BedrockRuntimeClient;
-    get client(): BedrockRuntimeClient;
-    get modelOptions(): ChatModelOptions | undefined;
-    process(input: ChatModelInput): Promise<AgentResponse<ChatModelOutput>>;
-    private extractResultFromStream;
-    private requestStructuredOutput;
-}

package/lib/cjs/models/bedrock-chat-model.js

@@ -1,303 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BedrockChatModel = exports.bedrockChatModelOptionsSchema = void 0;
-exports.extractLastJsonObject = extractLastJsonObject;
-const client_bedrock_runtime_1 = require("@aws-sdk/client-bedrock-runtime");
-const nanoid_1 = require("nanoid");
-const zod_1 = require("zod");
-const json_schema_js_1 = require("../utils/json-schema.js");
-const model_utils_js_1 = require("../utils/model-utils.js");
-const prompts_js_1 = require("../utils/prompts.js");
-const stream_utils_js_1 = require("../utils/stream-utils.js");
-const type_utils_js_1 = require("../utils/type-utils.js");
-const chat_model_js_1 = require("./chat-model.js");
-/**
- * @hidden
- */
-function extractLastJsonObject(text) {
-    return text.replace(/<thinking>[\s\S]*?<\/thinking>/g, "").trim();
-}
-const BEDROCK_DEFAULT_CHAT_MODEL = "us.amazon.nova-lite-v1:0";
-/**
- * @hidden
- */
-exports.bedrockChatModelOptionsSchema = zod_1.z.object({
-    region: zod_1.z.string().optional(),
-    model: zod_1.z.string().optional(),
-    modelOptions: zod_1.z
-        .object({
-        model: zod_1.z.string().optional(),
-        temperature: zod_1.z.number().optional(),
-        topP: zod_1.z.number().optional(),
-        frequencyPenalty: zod_1.z.number().optional(),
-        presencePenalty: zod_1.z.number().optional(),
-        parallelToolCalls: zod_1.z.boolean().optional().default(true),
-    })
-        .optional(),
-});
-class BedrockChatModel extends chat_model_js_1.ChatModel {
-    options;
-    constructor(options) {
-        if (options)
-            (0, type_utils_js_1.checkArguments)("BedrockChatModel", exports.bedrockChatModelOptionsSchema, options);
-        super();
-        this.options = options;
-    }
-    /**
-     * @hidden
-     */
-    _client;
-    get client() {
-        const credentials = this.options?.accessKeyId && this.options?.secretAccessKey
-            ? {
-                accessKeyId: this.options.accessKeyId,
-                secretAccessKey: this.options.secretAccessKey,
-            }
-            : undefined;
-        this._client ??= new client_bedrock_runtime_1.BedrockRuntimeClient({
-            region: this.options?.region,
-            credentials,
-        });
-        return this._client;
-    }
-    get modelOptions() {
-        return this.options?.modelOptions;
-    }
-    async process(input) {
-        const modelId = input.modelOptions?.model ?? this.modelOptions?.model ?? BEDROCK_DEFAULT_CHAT_MODEL;
-        const { messages, system } = getRunMessages(input);
-        const toolConfig = convertTools(input);
-        const body = {
-            modelId,
-            messages,
-            system,
-            toolConfig,
-            inferenceConfig: {
-                temperature: input.modelOptions?.temperature ?? this.modelOptions?.temperature,
-                topP: input.modelOptions?.topP ?? this.modelOptions?.topP,
-            },
-        };
-        const command = new client_bedrock_runtime_1.ConverseStreamCommand(body);
-        const response = await this.client.send(command);
-        const jsonMode = input.responseFormat?.type === "json_schema";
-        if (!jsonMode) {
-            return this.extractResultFromStream(response.stream, modelId, true);
-        }
-        const result = await this.extractResultFromStream(response.stream, modelId, false);
-        if (!result.toolCalls?.length && jsonMode && result.text) {
-            const output = await this.requestStructuredOutput(body, input.responseFormat);
-            return { ...output, usage: (0, model_utils_js_1.mergeUsage)(result.usage, output.usage) };
-        }
-        return result;
-    }
-    async extractResultFromStream(stream, modelId, streaming) {
-        if (!stream)
-            throw new Error("Unable to get AI model response.");
-        const result = new ReadableStream({
-            start: async (controller) => {
-                try {
-                    controller.enqueue({ delta: { json: { model: modelId } } });
-                    const toolCalls = [];
-                    let usage;
-                    for await (const chunk of stream) {
-                        if (chunk.contentBlockStart?.start?.toolUse) {
-                            const toolUse = chunk.contentBlockStart.start.toolUse;
-                            if (!toolUse.name)
-                                throw new Error("Tool use is invalid");
-                            if (chunk.contentBlockStart.contentBlockIndex === undefined)
-                                throw new Error("Tool use content block index is required");
-                            toolCalls[chunk.contentBlockStart.contentBlockIndex] = {
-                                type: "function",
-                                id: toolUse.toolUseId || (0, nanoid_1.nanoid)(),
-                                function: {
-                                    name: toolUse.name,
-                                    arguments: {},
-                                },
-                                args: "",
-                            };
-                        }
-                        if (chunk.contentBlockDelta) {
-                            const block = chunk.contentBlockDelta;
-                            const delta = block.delta;
-                            if (delta?.text) {
-                                controller.enqueue({ delta: { text: { text: delta.text } } });
-                            }
-                            if (delta?.toolUse) {
-                                if (block.contentBlockIndex === undefined)
-                                    throw new Error("Content block index is required");
-                                const call = toolCalls[block.contentBlockIndex];
-                                if (!call)
-                                    throw new Error("Tool call not found");
-                                call.args += delta.toolUse.input;
-                            }
-                        }
-                        if (chunk.metadata) {
-                            usage = chunk.metadata.usage;
-                        }
-                    }
-                    if (toolCalls.length) {
-                        controller.enqueue({
-                            delta: {
-                                json: {
-                                    toolCalls: toolCalls
-                                        .map(({ args, ...c }) => ({
-                                        ...c,
-                                        function: { ...c.function, arguments: (0, json_schema_js_1.parseJSON)(args) },
-                                    }))
-                                        .filter(type_utils_js_1.isNonNullable),
-                                },
-                            },
-                        });
-                    }
-                    controller.enqueue({ delta: { json: { usage } } });
-                    controller.close();
-                }
-                catch (error) {
-                    controller.error(error);
-                }
-            },
-        });
-        return streaming ? result : await (0, stream_utils_js_1.agentResponseStreamToObject)(result);
-    }
-    async requestStructuredOutput(body, responseFormat) {
-        if (responseFormat?.type !== "json_schema") {
-            throw new Error("Expected json_schema response format");
-        }
-        const system = [
-            ...(body.system ?? []),
-            {
-                text: `Use the generate_json tool to generate a json result. ${(0, prompts_js_1.getJsonToolInputPrompt)(responseFormat.jsonSchema.schema)}`,
-            },
-        ];
-        const toolConfig = {
-            tools: [
-                {
-                    toolSpec: {
-                        name: "generate_json",
-                        description: "Generate a json result by given context",
-                        inputSchema: { json: responseFormat.jsonSchema.schema },
-                    },
-                },
-            ],
-            toolChoice: { tool: { name: "generate_json" } },
-        };
-        const command = new client_bedrock_runtime_1.ConverseCommand({ ...body, system, toolConfig });
-        const response = await this.client.send(command);
-        const jsonTool = response.output?.message?.content?.find((i) => i.toolUse?.name === "generate_json");
-        if (!jsonTool)
-            throw new Error("Json tool not found");
-        return {
-            json: jsonTool.toolUse?.input,
-            model: body.modelId,
-            usage: response.usage,
-        };
-    }
-}
-exports.BedrockChatModel = BedrockChatModel;
-const getRunMessages = ({ messages: msgs, }) => {
-    const system = [];
-    const messages = [];
-    for (const msg of msgs) {
-        if (msg.role === "system") {
-            if (typeof msg.content !== "string")
-                throw new Error("System message must have content");
-            system.push({ text: msg.content });
-        }
-        else if (msg.role === "tool") {
-            if (!msg.toolCallId)
-                throw new Error("Tool message must have toolCallId");
-            if (typeof msg.content !== "string")
-                throw new Error("Tool message must have string content");
-            if (messages.at(-1)?.role === "user") {
-                messages.at(-1)?.content?.push({
-                    toolResult: { toolUseId: msg.toolCallId, content: [{ json: (0, json_schema_js_1.parseJSON)(msg.content) }] },
-                });
-            }
-            else {
-                messages.push({
-                    role: "user",
-                    content: [
-                        {
-                            toolResult: {
-                                toolUseId: msg.toolCallId,
-                                content: [{ json: (0, json_schema_js_1.parseJSON)(msg.content) }],
-                            },
-                        },
-                    ],
-                });
-            }
-        }
-        else if (msg.role === "user") {
-            if (!msg.content)
-                throw new Error("User message must have content");
-            messages.push({ role: "user", content: convertContent(msg.content) });
-        }
-        else if (msg.role === "agent") {
-            if (msg.toolCalls?.length) {
-                messages.push({
-                    role: "assistant",
-                    content: msg.toolCalls.map((i) => ({
-                        toolUse: {
-                            toolUseId: i.id,
-                            name: i.function.name,
-                            input: i.function.arguments,
-                        },
-                    })),
-                });
-            }
-            else if (msg.content) {
-                messages.push({ role: "assistant", content: convertContent(msg.content) });
-            }
-            else {
-                throw new Error("Agent message must have content or toolCalls");
-            }
-        }
-    }
-    if (messages.at(0)?.role !== "user") {
-        messages.unshift({ role: "user", content: [{ text: "." }] });
-    }
-    return { messages, system };
-};
-function convertContent(content) {
-    if (typeof content === "string")
-        return [{ text: content }];
-    if (Array.isArray(content)) {
-        const blocks = [];
-        for (const item of content) {
-            if (item.type === "text")
-                blocks.push({ text: item.text });
-        }
-        return blocks;
-    }
-    throw new Error("Invalid chat message content");
-}
-function convertTools({ tools, toolChoice }) {
-    if (!tools?.length || toolChoice === "none")
-        return undefined;
-    let choice;
-    if (typeof toolChoice === "object" && "type" in toolChoice && toolChoice.type === "function") {
-        choice = { tool: { name: toolChoice.function.name } };
-    }
-    else if (toolChoice === "required") {
-        choice = { any: {} };
-    }
-    else if (toolChoice === "auto") {
-        choice = { auto: {} };
-    }
-    return {
-        tools: tools.map((i) => {
-            const parameters = i.function.parameters;
-            if (Object.keys(parameters).length === 0) {
-                parameters.type = "object";
-            }
-            return {
-                toolSpec: {
-                    name: i.function.name,
-                    description: i.function.description,
-                    inputSchema: { json: parameters },
-                },
-            };
-        }),
-        toolChoice: choice,
-    };
-}

package/lib/cjs/models/claude-chat-model.d.ts

@@ -1,114 +0,0 @@
-import Anthropic from "@anthropic-ai/sdk";
-import { z } from "zod";
-import type { AgentProcessResult } from "../agents/agent.js";
-import { type PromiseOrValue } from "../utils/type-utils.js";
-import { ChatModel, type ChatModelInput, type ChatModelOptions, type ChatModelOutput } from "./chat-model.js";
-/**
- * Configuration options for Claude Chat Model
- */
-export interface ClaudeChatModelOptions {
-    /**
-     * API key for Anthropic's Claude API
-     *
-     * If not provided, will look for ANTHROPIC_API_KEY or CLAUDE_API_KEY in environment variables
-     */
-    apiKey?: string;
-    /**
-     * Claude model to use
-     *
-     * Defaults to 'claude-3-7-sonnet-latest'
-     */
-    model?: string;
-    /**
-     * Additional model options to control behavior
-     */
-    modelOptions?: ChatModelOptions;
-}
-/**
- * @hidden
- */
-export declare const claudeChatModelOptionsSchema: z.ZodObject<{
-    apiKey: z.ZodOptional<z.ZodString>;
-    model: z.ZodOptional<z.ZodString>;
-    modelOptions: z.ZodOptional<z.ZodObject<{
-        model: z.ZodOptional<z.ZodString>;
-        temperature: z.ZodOptional<z.ZodNumber>;
-        topP: z.ZodOptional<z.ZodNumber>;
-        frequencyPenalty: z.ZodOptional<z.ZodNumber>;
-        presencePenalty: z.ZodOptional<z.ZodNumber>;
-        parallelToolCalls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    }, "strip", z.ZodTypeAny, {
-        parallelToolCalls: boolean;
-        model?: string | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        presencePenalty?: number | undefined;
-    }, {
-        model?: string | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        presencePenalty?: number | undefined;
-        parallelToolCalls?: boolean | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    modelOptions?: {
-        parallelToolCalls: boolean;
-        model?: string | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        presencePenalty?: number | undefined;
-    } | undefined;
-    model?: string | undefined;
-    apiKey?: string | undefined;
-}, {
-    modelOptions?: {
-        model?: string | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        presencePenalty?: number | undefined;
-        parallelToolCalls?: boolean | undefined;
-    } | undefined;
-    model?: string | undefined;
-    apiKey?: string | undefined;
-}>;
-/**
- * Implementation of the ChatModel interface for Anthropic's Claude API
- *
- * This model provides access to Claude's capabilities including:
- * - Text generation
- * - Tool use
- * - JSON structured output
- *
- * Default model: 'claude-3-7-sonnet-latest'
- *
- * @example
- * Here's how to create and use a Claude chat model:
- * {@includeCode ../../test/models/claude-chat-model.test.ts#example-claude-chat-model}
- *
- * @example
- * Here's an example with streaming response:
- * {@includeCode ../../test/models/claude-chat-model.test.ts#example-claude-chat-model-streaming-async-generator}
- */
-export declare class ClaudeChatModel extends ChatModel {
-    options?: ClaudeChatModelOptions | undefined;
-    constructor(options?: ClaudeChatModelOptions | undefined);
-    /**
-     * @hidden
-     */
-    protected _client?: Anthropic;
-    get client(): Anthropic;
-    get modelOptions(): ChatModelOptions | undefined;
-    /**
-     * Process the input using Claude's chat model
-     * @param input - The input to process
-     * @returns The processed output from the model
-     */
-    process(input: ChatModelInput): PromiseOrValue<AgentProcessResult<ChatModelOutput>>;
-    private _process;
-    private extractResultFromClaudeStream;
-    private requestStructuredOutput;
-}