@aigne/agent-library 1.24.0 → 1.74.0-beta

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

@@ -1,89 +0,0 @@
-import { optionalize } from "@aigne/core/loader/schema.js";
-import z from "zod";
-export const taskRecordSchema = z.object({
-    task: z.string().describe("The description of the executed task."),
-    status: z
-        .enum(["pending", "completed", "failed"])
-        .describe("The execution status of the task: pending, completed, or failed."),
-    result: z.unknown().optional().describe("The result produced by executing the task."),
-    error: z
-        .object({
-        message: z.string().describe("Error message if the task failed."),
-    })
-        .optional()
-        .describe("Error information if the task failed."),
-    createdAt: z.number().optional().describe("Timestamp when the task was created."),
-    completedAt: z.number().optional().describe("Timestamp when the task completed or failed."),
-});
-export const executionStateSchema = z.object({
-    tasks: z
-        .array(taskRecordSchema)
-        .describe("The list of tasks that have been executed along with their results."),
-});
-export const plannerInputSchema = z.object({
-    objective: optionalize(z.string().describe("The user's overall objective.")),
-    executionState: optionalize(executionStateSchema),
-});
-export const plannerOutputSchema = z.object({
-    nextTasks: z
-        .array(z.string())
-        .optional()
-        .describe(`\
-The next tasks to be executed by the worker.
-Provide clear, actionable task descriptions that specify what needs to be done.
-Include relevant context from previous task results if needed for execution.
-Omit this field when all necessary work has been completed.
-`),
-    parallelTasks: z
-        .boolean()
-        .optional()
-        .describe(`\
-Indicates whether the next tasks can be executed in parallel.
-Set to true if tasks are independent and can run simultaneously.
-Set to false if tasks must be executed sequentially.
-default is false.
-`),
-    finished: z
-        .boolean()
-        .optional()
-        .describe(`\
-Indicates whether the objective has been fully achieved.
-Set to true when: all required tasks are completed and the objective is satisfied.
-When finished is true, nextTask should be omitted.
-`),
-});
-export const workerInputSchema = z.object({
-    objective: optionalize(z.string().describe("The user's overall objective.")),
-    task: optionalize(z.string().describe("The specific task assigned to the worker for execution.")),
-    executionState: optionalize(executionStateSchema),
-});
-export const workerOutputSchema = z.object({
-    result: z
-        .string()
-        .optional()
-        .describe("The text result or output produced by executing the task. Include key findings, data retrieved, or actions taken. Can be omitted if the task failed with no partial results."),
-    success: z
-        .boolean()
-        .describe("Whether the task completed successfully. Set to true if the task achieved its goal, false if it encountered errors or could not be completed."),
-    error: z
-        .object({
-        message: z
-            .string()
-            .describe("A clear description of what went wrong, including error type and relevant context to help with debugging or retry strategies."),
-    })
-        .optional()
-        .describe("Error details if the task failed. Only include when success is false."),
-});
-export const completerInputSchema = z.object({
-    objective: optionalize(z.string().describe("The user's overall objective.")),
-    executionState: optionalize(executionStateSchema),
-});
-/**
- * Default maximum number of task execution iterations
- */
-export const DEFAULT_MAX_ITERATIONS = 20;
-export const stateManagementOptionsSchema = z.object({
-    maxTokens: optionalize(z.number().int().positive()),
-    keepRecent: optionalize(z.number().int().positive()),
-    maxIterations: optionalize(z.number().int().positive()),
-});

package/lib/esm/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "module"
-}

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

@@ -1,21 +0,0 @@
-import { stat } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
-export async function exists(path) {
-    try {
-        await stat(path);
-        return true;
-    }
-    catch (e) {
-        if (e.code === "ENOENT") {
-            return false;
-        }
-        throw e;
-    }
-}
-export function expandHome(filepath) {
-    if (filepath.startsWith("~/") || filepath === "~") {
-        return join(homedir(), filepath.slice(1));
-    }
-    return filepath;
-}

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

@@ -1,24 +0,0 @@
-export class Mutex {
-    constructor() {
-        this._lock = Promise.resolve();
-    }
-    _lock;
-    lock() {
-        let unlockNext;
-        const willLock = new Promise((resolve) => {
-            unlockNext = resolve;
-        });
-        const willUnlock = this._lock.then(() => unlockNext);
-        this._lock = willLock;
-        return willUnlock;
-    }
-    async runExclusive(callback) {
-        const unlock = await this.lock();
-        try {
-            return await callback();
-        }
-        finally {
-            unlock();
-        }
-    }
-}