@aigne/agent-library 1.24.0 → 1.74.0-beta

package/lib/dts/orchestrator/type.d.ts

@@ -1,388 +0,0 @@
-import type { Message } from "@aigne/core";
-import z from "zod";
-/**
- * Task execution status
- */
-export type TaskStatus = "pending" | "completed" | "failed";
-/**
- * Individual task execution record
- */
-export interface TaskRecord {
-    /** Task description */
-    task: string;
-    /** Task execution status */
-    status: TaskStatus;
-    /** Task execution result (can be any type) */
-    result?: unknown;
-    /** Error information if task failed */
-    error?: {
-        message: string;
-    };
-    /** Timestamp when task was created */
-    createdAt?: number;
-    /** Timestamp when task was completed or failed */
-    completedAt?: number;
-}
-/**
- * Execution state tracking all tasks
- */
-export interface ExecutionState {
-    tasks: TaskRecord[];
-}
-export declare const taskRecordSchema: z.ZodObject<{
-    task: z.ZodString;
-    status: z.ZodEnum<["pending", "completed", "failed"]>;
-    result: z.ZodOptional<z.ZodUnknown>;
-    error: z.ZodOptional<z.ZodObject<{
-        message: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        message: string;
-    }, {
-        message: string;
-    }>>;
-    createdAt: z.ZodOptional<z.ZodNumber>;
-    completedAt: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    status: "pending" | "completed" | "failed";
-    task: string;
-    error?: {
-        message: string;
-    } | undefined;
-    result?: unknown;
-    createdAt?: number | undefined;
-    completedAt?: number | undefined;
-}, {
-    status: "pending" | "completed" | "failed";
-    task: string;
-    error?: {
-        message: string;
-    } | undefined;
-    result?: unknown;
-    createdAt?: number | undefined;
-    completedAt?: number | undefined;
-}>;
-export declare const executionStateSchema: z.ZodObject<{
-    tasks: z.ZodArray<z.ZodObject<{
-        task: z.ZodString;
-        status: z.ZodEnum<["pending", "completed", "failed"]>;
-        result: z.ZodOptional<z.ZodUnknown>;
-        error: z.ZodOptional<z.ZodObject<{
-            message: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            message: string;
-        }, {
-            message: string;
-        }>>;
-        createdAt: z.ZodOptional<z.ZodNumber>;
-        completedAt: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        status: "pending" | "completed" | "failed";
-        task: string;
-        error?: {
-            message: string;
-        } | undefined;
-        result?: unknown;
-        createdAt?: number | undefined;
-        completedAt?: number | undefined;
-    }, {
-        status: "pending" | "completed" | "failed";
-        task: string;
-        error?: {
-            message: string;
-        } | undefined;
-        result?: unknown;
-        createdAt?: number | undefined;
-        completedAt?: number | undefined;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    tasks: {
-        status: "pending" | "completed" | "failed";
-        task: string;
-        error?: {
-            message: string;
-        } | undefined;
-        result?: unknown;
-        createdAt?: number | undefined;
-        completedAt?: number | undefined;
-    }[];
-}, {
-    tasks: {
-        status: "pending" | "completed" | "failed";
-        task: string;
-        error?: {
-            message: string;
-        } | undefined;
-        result?: unknown;
-        createdAt?: number | undefined;
-        completedAt?: number | undefined;
-    }[];
-}>;
-export interface PlannerInput extends Message {
-    objective?: string;
-    executionState?: ExecutionState;
-}
-export declare const plannerInputSchema: z.ZodObject<{
-    objective: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
-    executionState: z.ZodType<{
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined, z.ZodTypeDef, {
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined>;
-}, "strip", z.ZodTypeAny, {
-    objective?: string | undefined;
-    executionState?: {
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined;
-}, {
-    objective?: string | undefined;
-    executionState?: {
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined;
-}>;
-export interface PlannerOutput extends Message {
-    nextTasks?: string[];
-    parallelTasks?: boolean;
-    finished?: boolean;
-}
-export declare const plannerOutputSchema: z.ZodObject<{
-    nextTasks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    parallelTasks: z.ZodOptional<z.ZodBoolean>;
-    finished: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    nextTasks?: string[] | undefined;
-    parallelTasks?: boolean | undefined;
-    finished?: boolean | undefined;
-}, {
-    nextTasks?: string[] | undefined;
-    parallelTasks?: boolean | undefined;
-    finished?: boolean | undefined;
-}>;
-export interface WorkerInput extends Message {
-    objective?: string;
-    executionState?: ExecutionState;
-    task?: string;
-}
-export declare const workerInputSchema: z.ZodObject<{
-    objective: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
-    task: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
-    executionState: z.ZodType<{
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined, z.ZodTypeDef, {
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined>;
-}, "strip", z.ZodTypeAny, {
-    task?: string | undefined;
-    objective?: string | undefined;
-    executionState?: {
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined;
-}, {
-    task?: string | undefined;
-    objective?: string | undefined;
-    executionState?: {
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined;
-}>;
-/**
- * Worker output structure
- */
-export interface WorkerOutput extends Message {
-    /** Task execution result */
-    result?: string;
-    /** Whether the task was completed successfully */
-    success: boolean;
-    /** Error information if task failed */
-    error?: {
-        message: string;
-    };
-}
-export declare const workerOutputSchema: z.ZodObject<{
-    result: z.ZodOptional<z.ZodString>;
-    success: z.ZodBoolean;
-    error: z.ZodOptional<z.ZodObject<{
-        message: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        message: string;
-    }, {
-        message: string;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    success: boolean;
-    error?: {
-        message: string;
-    } | undefined;
-    result?: string | undefined;
-}, {
-    success: boolean;
-    error?: {
-        message: string;
-    } | undefined;
-    result?: string | undefined;
-}>;
-export interface CompleterInput extends Message {
-    objective?: string;
-    executionState?: ExecutionState;
-}
-export declare const completerInputSchema: z.ZodObject<{
-    objective: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
-    executionState: z.ZodType<{
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined, z.ZodTypeDef, {
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined>;
-}, "strip", z.ZodTypeAny, {
-    objective?: string | undefined;
-    executionState?: {
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined;
-}, {
-    objective?: string | undefined;
-    executionState?: {
-        tasks: {
-            status: "pending" | "completed" | "failed";
-            task: string;
-            error?: {
-                message: string;
-            } | undefined;
-            result?: unknown;
-            createdAt?: number | undefined;
-            completedAt?: number | undefined;
-        }[];
-    } | undefined;
-}>;
-/**
- * Default maximum number of task execution iterations
- */
-export declare const DEFAULT_MAX_ITERATIONS = 20;
-/**
- * Options for managing execution state to prevent context overflow
- */
-export interface StateManagementOptions {
-    /**
-     * Maximum tokens allowed for execution state
-     * When exceeded, triggers compression
-     */
-    maxTokens?: number;
-    /**
-     * Number of recent tasks to keep when compression is triggered
-     */
-    keepRecent?: number;
-    /**
-     * Maximum number of task execution iterations
-     * When reached, orchestrator will stop and synthesize final result
-     * @default 20
-     */
-    maxIterations?: number;
-}
-export declare const stateManagementOptionsSchema: z.ZodObject<{
-    maxTokens: z.ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
-    keepRecent: z.ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
-    maxIterations: z.ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
-}, "strip", z.ZodTypeAny, {
-    maxTokens?: number | undefined;
-    keepRecent?: number | undefined;
-    maxIterations?: number | undefined;
-}, {
-    maxTokens?: number | undefined;
-    keepRecent?: number | undefined;
-    maxIterations?: number | undefined;
-}>;

package/lib/dts/utils/fs.d.ts

@@ -1,2 +0,0 @@
-export declare function exists(path: string): Promise<boolean>;
-export declare function expandHome(filepath: string): string;

package/lib/dts/utils/mutex.d.ts

@@ -1,6 +0,0 @@
-export declare class Mutex {
-    constructor();
-    private _lock;
-    lock(): Promise<() => void>;
-    runExclusive<T>(callback: () => Promise<T> | T): Promise<T>;
-}

package/lib/esm/agent-skill-manager/index.d.ts

@@ -1,10 +0,0 @@
-import { type Agent, AIAgent, type AIAgentOptions, type Message } from "@aigne/core";
-export interface AgentSkillManagerOptions<I extends Message = Message, O extends Message = Message> extends AIAgentOptions<I, O> {
-}
-export default class AgentSkillManagerAgent<I extends Message = Message, O extends Message = Message> extends AIAgent<I, O> {
-    static load<I extends Message = any, O extends Message = any>(options: {
-        filepath: string;
-        parsed: object;
-    }): Promise<Agent<I, O>>;
-    constructor(options: AgentSkillManagerOptions<I, O>);
-}

package/lib/esm/agent-skill-manager/index.js

@@ -1,23 +0,0 @@
-import { AIAgent, } from "@aigne/core";
-import { AgentSkillManagerSystemPrompt } from "./prompt.js";
-export default class AgentSkillManagerAgent extends AIAgent {
-    static async load(options) {
-        const schema = AIAgent.schema(options);
-        const valid = await schema.parseAsync(options.parsed);
-        return AIAgent.load({
-            ...options,
-            parsed: {
-                ...options.parsed,
-                instructions: valid.instructions || [
-                    { role: "system", content: AgentSkillManagerSystemPrompt, path: options.filepath },
-                ],
-            },
-        });
-    }
-    constructor(options) {
-        super({
-            ...options,
-            instructions: options.instructions || AgentSkillManagerSystemPrompt,
-        });
-    }
-}

package/lib/esm/agent-skill-manager/prompt.d.ts

@@ -1 +0,0 @@
-export declare const AgentSkillManagerSystemPrompt = "You are an interactive CLI tool that helps users according to your \"Output Style\" below, which describes how you should respond to user queries. Use the instructions below and the tools available to you to assist the user.\n\nIMPORTANT: You must NEVER generate or guess URLs for the user unless you are confident that the URLs are for helping the user with programming. You may use URLs provided by the user in their messages or local files.\n\n# Tone and style\n- Only use emojis if the user explicitly requests it. Avoid using emojis in all communication unless asked.\n- Your output will be displayed on a command line interface. Your responses should be short and concise. You can use Github-flavored markdown for formatting, and will be rendered in a monospace font using the CommonMark specification.\n- Output text to communicate with the user; all text you output outside of tool use is displayed to the user. Only use tools to complete tasks. Never use tools like Bash or code comments as means to communicate with the user during the session.\n- NEVER create files unless they're absolutely necessary for achieving your goal. ALWAYS prefer editing an existing file to creating a new one. This includes markdown files.\n- Do not use a colon before tool calls. Your tool calls may not be shown directly in the output, so text like \"Let me read the file:\" followed by a read tool call should just be \"Let me read the file.\" with a period.\n\n{% if $afs.enabled %}\n# AFS Context\n\n{{ $afs.description }}\n\n```yaml alt=\"AFS Modules\"\n{{ $afs.modules | yaml.stringify }}\n```\n{% endif %}\n\n# Asking questions as you work\n\nYou have access to the askUserQuestion tool to ask the user questions when you need clarification, want to validate assumptions, or need to make a decision you're unsure about. When presenting options or plans, never include time estimates - focus on what each option involves, not how long it takes.\n\n# Skill usage\n\nWhen the user requests you to perform tasks, check if any of the available skills can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.\n\n## Loading skill resources on demand\n\nSkills may include reference documents (guides, schemas, examples) in a `references/` directory. To optimize performance and context usage:\n\n1. **Start with the main skill file** (e.g., `SKILL.md`) - it contains the workflow overview and references to detailed guides\n2. **Load reference documents only when needed** - read specific guides only when you reach the step that requires them\n3. **Don't preload all resources** - avoid reading all reference files at the start of a task\n\n# Doing tasks\nThe user will primarily request you perform software engineering tasks. This includes solving bugs, adding new functionality, refactoring code, explaining code, and more. For these tasks the following steps are recommended:\n- NEVER propose changes to code you haven't read. If a user asks about or wants you to modify a file, read it first. Understand existing code before suggesting modifications.\n- Use the askUserQuestion tool to ask questions, clarify and gather information as needed.\n- Be careful not to introduce security vulnerabilities such as command injection, XSS, SQL injection, and other OWASP top 10 vulnerabilities. If you notice that you wrote insecure code, immediately fix it.\n- Avoid over-engineering. Only make changes that are directly requested or clearly necessary. Keep solutions simple and focused.\n  - Don't add features, refactor code, or make \"improvements\" beyond what was asked. A bug fix doesn't need surrounding code cleaned up. A simple feature doesn't need extra configurability. Don't add docstrings, comments, or type annotations to code you didn't change. Only add comments where the logic isn't self-evident.\n  - Don't add error handling, fallbacks, or validation for scenarios that can't happen. Trust internal code and framework guarantees. Only validate at system boundaries (user input, external APIs). Don't use feature flags or backwards-compatibility shims when you can just change the code.\n  - Don't create helpers, utilities, or abstractions for one-time operations. Don't design for hypothetical future requirements. The right amount of complexity is the minimum needed for the current task\u2014three similar lines of code is better than a premature abstraction.\n- Avoid backwards-compatibility hacks like renaming unused `_vars`, re-exporting types, adding `// removed` comments for removed code, etc. If something is unused, delete it completely.\n\nIMPORTANT: Complete tasks fully. Do not stop mid-task or leave work incomplete. Do not claim a task is too large, that you lack time, or that context limits prevent completion. You have unlimited context through summarization. Continue working until the task is done or the user stops you.\n";

package/lib/esm/ask-user-question/index.d.ts

@@ -1,28 +0,0 @@
-import { Agent, type AgentInvokeOptions, type AgentOptions, type AgentProcessResult, type Message } from "@aigne/core";
-import { z } from "zod";
-export interface AskUserQuestionAgentOption {
-    label: string;
-    description?: string;
-}
-export interface AskUserQuestionAgentInput extends Message {
-    questions: {
-        header: string;
-        question: string;
-        options?: AskUserQuestionAgentOption[];
-        multipleSelect?: boolean;
-    }[];
-    allowCustomAnswer?: boolean;
-}
-export interface AskUserQuestionAgentOutput extends Message {
-    answers: Record<string, string>;
-}
-export default class AskUserQuestionAgent extends Agent<AskUserQuestionAgentInput, AskUserQuestionAgentOutput> {
-    tag: string;
-    static schema(): z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-    static load<I extends Message = any, O extends Message = any>(options: {
-        filepath: string;
-        parsed: object;
-    }): Promise<Agent<I, O>>;
-    constructor(options?: AgentOptions<AskUserQuestionAgentInput, AskUserQuestionAgentOutput>);
-    process(input: AskUserQuestionAgentInput, options: AgentInvokeOptions): Promise<AgentProcessResult<AskUserQuestionAgentOutput>>;
-}

package/lib/esm/ask-user-question/index.js

@@ -1,105 +0,0 @@
-import { Agent, } from "@aigne/core";
-import { optionalize } from "@aigne/core/loader/schema.js";
-import { z } from "zod";
-const askUserQuestionAgentOptionSchema = z.object({
-    label: z.string().describe("The display text for this option (1-5 words)"),
-    description: optionalize(z.string()).describe("Explanation of what this option means"),
-});
-const askUserQuestionAgentInputSchema = z.object({
-    questions: z
-        .array(z.object({
-        header: z
-            .string()
-            .describe("Very short label (max 12 chars) used as key in answers. Examples: 'Auth method', 'Library', 'Approach'"),
-        question: z.string().describe("The question to ask the user"),
-        options: optionalize(z.array(askUserQuestionAgentOptionSchema)).describe("List of options to present to the user"),
-        multipleSelect: optionalize(z.boolean()).describe("Whether to allow multiple selections"),
-    }))
-        .describe("List of questions to ask the user"),
-    allowCustomAnswer: optionalize(z.boolean()).describe("Whether to allow the user to provide custom answers"),
-});
-export default class AskUserQuestionAgent extends Agent {
-    tag = "AskUserQuestion";
-    static schema() {
-        return z.object({});
-    }
-    static async load(options) {
-        return new AskUserQuestionAgent({
-            name: defaultName,
-            description: defaultDescription,
-            ...options.parsed,
-            inputSchema: askUserQuestionAgentInputSchema,
-        });
-    }
-    constructor(options) {
-        super({
-            ...options,
-            name: options?.name || defaultName,
-            description: options?.description || defaultDescription,
-            inputSchema: options?.inputSchema || askUserQuestionAgentInputSchema,
-        });
-    }
-    async process(input, options) {
-        const { prompts } = options;
-        if (!prompts)
-            throw new Error("Prompts is not available in AskUserQuestionAgent");
-        const { questions, allowCustomAnswer } = input;
-        const answers = {};
-        for (const q of questions) {
-            let answer;
-            if (q.options?.length) {
-                const choices = q.options.map((opt) => ({
-                    value: opt.label,
-                    name: opt.label,
-                    description: opt.description ?? opt.label,
-                }));
-                if (allowCustomAnswer) {
-                    choices.push({
-                        name: "None of the above / Enter my own response",
-                        value: "OTHER_OPTION",
-                    });
-                }
-                if (!q.multipleSelect) {
-                    answer = await prompts.select({
-                        message: q.question,
-                        choices,
-                    });
-                }
-                else {
-                    answer = await prompts.checkbox({
-                        message: q.question,
-                        choices,
-                    });
-                }
-                if (answer === "OTHER_OPTION" ||
-                    (Array.isArray(answer) && answer.includes("OTHER_OPTION"))) {
-                    answer = await prompts.input({
-                        message: `Please provide your response for: ${q.question}`,
-                    });
-                }
-            }
-            else {
-                answer = await prompts.input({
-                    message: q.question,
-                });
-            }
-            answers[q.header] = Array.isArray(answer) ? answer.join(", ") : answer;
-        }
-        return {
-            answers,
-        };
-    }
-}
-const defaultName = "askUserQuestion";
-const defaultDescription = `\
-Use this tool when you need to ask the user questions during execution. This allows you to:
-1. Gather user preferences or requirements
-2. Clarify ambiguous instructions
-3. Get decisions on implementation choices as you work
-4. Offer choices to the user about what direction to take.
-
-Usage notes:
-- Users will always be able to select "Other" to provide custom text input
-- Use multiSelect: true to allow multiple answers to be selected for a question
-- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
-`;