@aigne/core 1.72.0 → 1.74.0-beta

package/dist/aigne/aigne.d.mts

@@ -0,0 +1,340 @@
+import { ChatModel } from "../agents/chat-model.mjs";
+import { ImageModel } from "../agents/image-model.mjs";
+import { MessagePayload, MessageQueue, MessageQueueListener, Unsubscribe } from "./message-queue.mjs";
+import { UserAgent } from "../agents/user-agent.mjs";
+import { AIGNECLIAgents, AIGNEMetadata } from "./type.mjs";
+import { ContextLimits } from "./usage.mjs";
+import { AIGNEContext, Context, InvokeOptions, UserContext } from "./context.mjs";
+import { Agent, AgentResponse, AgentResponseStream, Message } from "../agents/agent.mjs";
+import { LoadOptions } from "../loader/index.mjs";
+import { AIGNEObserver } from "@aigne/observability-api";
+
+//#region src/aigne/aigne.d.ts
+/**
+ * Options for the AIGNE class.
+ */
+interface AIGNEOptions {
+  /**
+       * Optional root directory for this AIGNE instance.
+       * This is used to resolve relative paths for agents and skills.
+       */
+  rootDir?: string;
+  /**
+       * The name of the AIGNE instance.
+       */
+  name?: string;
+  /**
+       * The description of the AIGNE instance.
+       */
+  description?: string;
+  /**
+       * Global model to use for all agents not specifying a model.
+       */
+  model?: ChatModel;
+  /**
+       * Optional image model to use for image processing tasks.
+       */
+  imageModel?: ImageModel;
+  /**
+       * Skills to use for the AIGNE instance.
+       */
+  skills?: Agent[];
+  /**
+       * Agents to use for the AIGNE instance.
+       */
+  agents?: Agent[];
+  mcpServer?: {
+    agents?: Agent[];
+  };
+  cli?: AIGNECLIAgents;
+  /**
+       * Limits for the AIGNE instance, such as timeout, max tokens, max invocations, etc.
+       */
+  limits?: ContextLimits;
+  /**
+       * Observer for the AIGNE instance.
+       */
+  observer?: AIGNEObserver;
+  metadata?: AIGNEMetadata;
+}
+/**
+ * AIGNE is a class that orchestrates multiple agents to build complex AI applications.
+ * It serves as the central coordination point for agent interactions, message passing, and execution flow.
+ *
+ * @example
+ * Here's a simple example of how to use AIGNE:
+ * {@includeCode ../../test/aigne/aigne.test.ts#example-simple}
+ *
+ * @example
+ * Here's an example of how to use AIGNE with streaming response:
+ * {@includeCode ../../test/aigne/aigne.test.ts#example-streaming}
+ */
+declare class AIGNE<U extends UserContext = UserContext> {
+  /**
+       * Loads an AIGNE instance from a directory containing an aigne.yaml file and agent definitions.
+       * This static method provides a convenient way to initialize an AIGNE system from configuration files.
+       *
+       * @param path - Path to the directory containing the aigne.yaml file.
+       * @param options - Options to override the loaded configuration.
+       * @returns A fully initialized AIGNE instance with configured agents and skills.
+       */
+  static load(path: string, options?: Omit<AIGNEOptions, keyof LoadOptions> & LoadOptions): Promise<AIGNE>;
+  /**
+       * Creates a new AIGNE instance with the specified options.
+       *
+       * @param options - Configuration options for the AIGNE instance including name, description, model, and agents.
+       */
+  constructor(options?: AIGNEOptions);
+  /**
+       * Optional root directory for this AIGNE instance.
+       */
+  rootDir?: string;
+  /**
+       * Optional name identifier for this AIGNE instance.
+       */
+  name?: string;
+  /**
+       * Optional description of this AIGNE instance's purpose or functionality.
+       */
+  description?: string;
+  /**
+       * Global model to use for all agents that don't specify their own model.
+       */
+  model?: ChatModel;
+  /**
+       * Optional image model to use for image processing tasks.
+       */
+  imageModel?: ImageModel;
+  /**
+       * Usage limits applied to this AIGNE instance's execution.
+       */
+  limits?: ContextLimits;
+  /**
+       * Message queue for handling inter-agent communication.
+       *
+       * @hidden
+       */
+  readonly messageQueue: MessageQueue;
+  /**
+       * Collection of all context IDs created by this AIGNE instance.
+       */
+  readonly contextIds: Set<string>;
+  /**
+       * Collection of skill agents available to this AIGNE instance.
+       * Provides indexed access by skill name.
+       */
+  readonly skills: Agent<any, any>[] & {
+    [key: string]: Agent<any, any>;
+  };
+  /**
+       * Collection of primary agents managed by this AIGNE instance.
+       * Provides indexed access by agent name.
+       */
+  readonly agents: Agent<any, any>[] & {
+    [key: string]: Agent<any, any>;
+  };
+  readonly mcpServer: {
+    agents: Agent<any, any>[] & {
+      [key: string]: Agent<any, any>;
+    };
+  };
+  readonly cli: AIGNECLIAgents;
+  /**
+       * Observer for the AIGNE instance.
+       */
+  readonly observer?: AIGNEObserver;
+  /**
+       * Metadata for the AIGNE instance.
+       */
+  readonly metadata: AIGNEMetadata;
+  /**
+       * Adds one or more agents to this AIGNE instance.
+       * Each agent is attached to this AIGNE instance, allowing it to access the AIGNE's resources.
+       *
+       * @param agents - One or more Agent instances to add to this AIGNE.
+       */
+  addAgent(...agents: Agent[]): void;
+  /**
+       * Creates a new execution context for this AIGNE instance.
+       * Contexts isolate state for different flows or conversations.
+       *
+       * @returns A new AIGNEContext instance bound to this AIGNE.
+       */
+  newContext(options?: Partial<Pick<Context, "userContext" | "memories">>): AIGNEContext;
+  /**
+       * Creates a user agent for consistent interactions with a specified agent.
+       * This method allows you to create a wrapper around an agent for repeated invocations.
+       *
+       * @param agent - Target agent to be wrapped for consistent invocation
+       * @returns A user agent instance that provides a convenient interface for interacting with the target agent
+       *
+       * @example
+       * Here's an example of how to create a user agent and invoke it consistently:
+       * {@includeCode ../../test/aigne/aigne.test.ts#example-user-agent}
+       */
+  invoke<I extends Message, O extends Message>(agent: Agent<I, O>): UserAgent<I, O>;
+  /**
+       * Invokes an agent with a message and returns both the output and the active agent.
+       * This overload is useful when you need to track which agent was ultimately responsible for generating the response.
+       *
+       * @param agent - Target agent to invoke
+       * @param message - Input message to send to the agent
+       * @param options.returnActiveAgent - Must be true to return the final active agent
+       * @param options.streaming - Must be false to return a response stream
+       * @returns A promise resolving to a tuple containing the agent's response and the final active agent
+       */
+  invoke<I extends Message, O extends Message>(agent: Agent<I, O>, message: I & Message, options: InvokeOptions<U> & {
+    returnActiveAgent: true;
+    streaming?: false;
+  }): Promise<[O, Agent]>;
+  /**
+       * Invokes an agent with a message and returns both a stream of the response and the active agent.
+       * This overload is useful when you need streaming responses while also tracking which agent provided them.
+       *
+       * @param agent - Target agent to invoke
+       * @param message - Input message to send to the agent
+       * @param options.returnActiveAgent - Must be true to return the final active agent
+       * @param options.streaming - Must be true to return a response stream
+       * @returns A promise resolving to a tuple containing the agent's response stream and a promise for the final agent
+       */
+  invoke<I extends Message, O extends Message>(agent: Agent<I, O>, message: I & Message, options: InvokeOptions<U> & {
+    returnActiveAgent: true;
+    streaming: true;
+  }): Promise<[AgentResponseStream<O>, Promise<Agent>]>;
+  /**
+       * Invokes an agent with a message and returns just the output.
+       * This is the standard way to invoke an agent when you only need the response.
+       *
+       * @param agent - Target agent to invoke
+       * @param message - Input message to send to the agent
+       * @param options - Optional configuration parameters for the invocation
+       * @returns A promise resolving to the agent's complete response
+       *
+       * @example
+       * Here's a simple example of how to invoke an agent:
+       * {@includeCode ../../test/aigne/aigne.test.ts#example-simple}
+       */
+  invoke<I extends Message, O extends Message>(agent: Agent<I, O>, message: I & Message, options?: InvokeOptions<U> & {
+    returnActiveAgent?: false;
+    streaming?: false;
+  }): Promise<O>;
+  /**
+       * Invokes an agent with a message and returns a stream of the response.
+       * This allows processing the response incrementally as it's being generated.
+       *
+       * @param agent - Target agent to invoke
+       * @param message - Input message to send to the agent
+       * @param options - Configuration with streaming enabled to receive incremental response chunks
+       * @returns A promise resolving to a stream of the agent's response that can be consumed incrementally
+       *
+       * @example
+       * Here's an example of how to invoke an agent with streaming response:
+       * {@includeCode ../../test/aigne/aigne.test.ts#example-streaming}
+       */
+  invoke<I extends Message, O extends Message>(agent: Agent<I, O>, message: I & Message, options: InvokeOptions<U> & {
+    returnActiveAgent?: false;
+    streaming: true;
+  }): Promise<AgentResponseStream<O>>;
+  /**
+       * General implementation signature that handles all overload cases.
+       * This unified signature supports all the different invocation patterns defined by the overloads.
+       *
+       * @param agent - Target agent to invoke or wrap
+       * @param message - Optional input message to send to the agent
+       * @param options - Optional configuration parameters for the invocation
+       * @returns Either a UserAgent (when no message provided) or a promise resolving to the agent's response
+       * with optional active agent information based on the provided options
+       */
+  invoke<I extends Message, O extends Message>(agent: Agent<I, O>, message?: I & Message, options?: InvokeOptions<U>): UserAgent<I, O> | Promise<AgentResponse<O> | [AgentResponse<O>, Agent]>;
+  /**
+       * Publishes a message to the message queue for inter-agent communication.
+       * This method broadcasts a message to all subscribers of the specified topic(s).
+       * It creates a new context internally and delegates to the context's publish method.
+       *
+       * @param topic - The topic or array of topics to publish the message to
+       * @param payload - The message payload to be delivered to subscribers
+       * @param options - Optional configuration parameters for the publish operation
+       *
+       * @example
+       * Here's an example of how to publish a message:
+       * {@includeCode ../../test/aigne/aigne.test.ts#example-publish-message}
+       */
+  publish(topic: string | string[], payload: Omit<MessagePayload, "context"> | Message, options?: InvokeOptions<U>): void;
+  /**
+       * Subscribes to receive the next message on a specific topic.
+       * This overload returns a Promise that resolves with the next message published to the topic.
+       * It's useful for one-time message handling or when using async/await patterns.
+       *
+       * @param topic - The topic to subscribe to
+       * @returns A Promise that resolves with the next message payload published to the specified topic
+       *
+       * @example
+       * Here's an example of how to subscribe to a topic and receive the next message:
+       * {@includeCode ../../test/aigne/aigne.test.ts#example-publish-message}
+       */
+  subscribe(topic: string | string[], listener?: undefined): Promise<MessagePayload>;
+  /**
+       * Subscribes to messages on a specific topic with a listener callback.
+       * This overload registers a listener function that will be called for each message published to the topic.
+       * It's useful for continuous message handling or event-driven architectures.
+       *
+       * @param topic - The topic to subscribe to
+       * @param listener - Callback function that will be invoked when messages arrive on the specified topic
+       * @returns An Unsubscribe function that can be called to cancel the subscription
+       *
+       * @example
+       * Here's an example of how to subscribe to a topic with a listener:
+       * {@includeCode ../../test/aigne/aigne.test.ts#example-subscribe-topic}
+       */
+  subscribe(topic: string | string[], listener: MessageQueueListener): Unsubscribe;
+  /**
+       * Generic subscribe signature that handles both Promise and listener patterns.
+       * This is the implementation signature that supports both overloaded behaviors.
+       *
+       * @param topic - The topic to subscribe to
+       * @param listener - Optional callback function
+       * @returns Either a Promise for the next message or an Unsubscribe function
+       */
+  subscribe(topic: string | string[], listener?: MessageQueueListener): Unsubscribe | Promise<MessagePayload>;
+  /**
+       * Unsubscribes a listener from a specific topic in the message queue.
+       * This method stops a previously registered listener from receiving further messages.
+       * It should be called when message processing is complete or when the component is no longer interested
+       * in messages published to the specified topic.
+       *
+       * @param topic - The topic to unsubscribe from
+       * @param listener - The listener function that was previously subscribed to the topic
+       *
+       * @example
+       * {@includeCode ../../test/aigne/aigne.test.ts#example-subscribe-topic}
+       */
+  unsubscribe(topic: string | string[], listener: MessageQueueListener): void;
+  /**
+       * Gracefully shuts down the AIGNE instance and all its agents and skills.
+       * This ensures proper cleanup of resources before termination.
+       *
+       * @returns A promise that resolves when shutdown is complete.
+       *
+       * @example
+       * Here's an example of shutdown an AIGNE instance:
+       * {@includeCode ../../test/aigne/aigne.test.ts#example-shutdown}
+       */
+  shutdown(): Promise<void>;
+  /**
+       * Asynchronous dispose method for the AIGNE instance.
+       *
+       * @example
+       * Here's an example of using async dispose:
+       * {@includeCode ../../test/aigne/aigne.test.ts#example-shutdown-using}
+       */
+  [Symbol.asyncDispose](): Promise<void>;
+  /**
+       * Initializes handlers for process exit events to ensure clean shutdown.
+       * This registers handlers for SIGINT/SIGTERM to properly terminate all agents.
+       * Note: 'exit' event cannot run async code, so we handle cleanup in signal handlers.
+       */
+  private initProcessExitHandler;
+}
+//#endregion
+export { AIGNE, AIGNEOptions };
+//# sourceMappingURL=aigne.d.mts.map

package/dist/aigne/aigne.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aigne.d.mts","names":[],"sources":["../../src/aigne/aigne.ts"],"mappings":"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"}

package/dist/aigne/aigne.mjs

@@ -0,0 +1,235 @@
+import { checkArguments, createAccessorArray } from "../utils/type-utils.mjs";
+import { MessageQueue } from "./message-queue.mjs";
+import { load } from "../loader/index.mjs";
+import { AIGNEContext } from "./context.mjs";
+import { z as z$1 } from "zod";
+import { AIGNEObserver } from "@aigne/observability-api";
+
+//#region src/aigne/aigne.ts
+/**
+* AIGNE is a class that orchestrates multiple agents to build complex AI applications.
+* It serves as the central coordination point for agent interactions, message passing, and execution flow.
+*
+* @example
+* Here's a simple example of how to use AIGNE:
+* {@includeCode ../../test/aigne/aigne.test.ts#example-simple}
+*
+* @example
+* Here's an example of how to use AIGNE with streaming response:
+* {@includeCode ../../test/aigne/aigne.test.ts#example-streaming}
+*/
+var AIGNE = class AIGNE {
+	/**
+	* Loads an AIGNE instance from a directory containing an aigne.yaml file and agent definitions.
+	* This static method provides a convenient way to initialize an AIGNE system from configuration files.
+	*
+	* @param path - Path to the directory containing the aigne.yaml file.
+	* @param options - Options to override the loaded configuration.
+	* @returns A fully initialized AIGNE instance with configured agents and skills.
+	*/
+	static async load(path, options = {}) {
+		const { agents = [], skills = [], model, imageModel, ...aigne } = await load(path, options);
+		return new AIGNE({
+			...aigne,
+			...options,
+			model,
+			imageModel,
+			agents: agents.concat(options?.agents ?? []),
+			skills: skills.concat(options?.skills ?? []),
+			metadata: options?.metadata
+		});
+	}
+	/**
+	* Creates a new AIGNE instance with the specified options.
+	*
+	* @param options - Configuration options for the AIGNE instance including name, description, model, and agents.
+	*/
+	constructor(options) {
+		if (options) checkArguments("AIGNE", aigneOptionsSchema, options);
+		this.rootDir = options?.rootDir;
+		this.name = options?.name;
+		this.description = options?.description;
+		this.model = options?.model;
+		this.imageModel = options?.imageModel;
+		this.limits = options?.limits;
+		this.observer = process.env.AIGNE_OBSERVABILITY_DISABLED === "true" ? void 0 : options?.observer ?? new AIGNEObserver();
+		if (options?.skills?.length) this.skills.push(...options.skills);
+		if (options?.agents?.length) this.addAgent(...options.agents);
+		if (options?.mcpServer?.agents?.length) this.mcpServer.agents.push(...options.mcpServer.agents);
+		this.cli = options?.cli ?? {};
+		this.observer?.serve();
+		this.initProcessExitHandler();
+		this.metadata = options?.metadata ?? {};
+	}
+	/**
+	* Optional root directory for this AIGNE instance.
+	*/
+	rootDir;
+	/**
+	* Optional name identifier for this AIGNE instance.
+	*/
+	name;
+	/**
+	* Optional description of this AIGNE instance's purpose or functionality.
+	*/
+	description;
+	/**
+	* Global model to use for all agents that don't specify their own model.
+	*/
+	model;
+	/**
+	* Optional image model to use for image processing tasks.
+	*/
+	imageModel;
+	/**
+	* Usage limits applied to this AIGNE instance's execution.
+	*/
+	limits;
+	/**
+	* Message queue for handling inter-agent communication.
+	*
+	* @hidden
+	*/
+	messageQueue = new MessageQueue();
+	/**
+	* Collection of all context IDs created by this AIGNE instance.
+	*/
+	contextIds = /* @__PURE__ */ new Set();
+	/**
+	* Collection of skill agents available to this AIGNE instance.
+	* Provides indexed access by skill name.
+	*/
+	skills = createAccessorArray([], (arr, name) => arr.find((i) => i.name === name));
+	/**
+	* Collection of primary agents managed by this AIGNE instance.
+	* Provides indexed access by agent name.
+	*/
+	agents = createAccessorArray([], (arr, name) => arr.find((i) => i.name === name));
+	mcpServer = { agents: createAccessorArray([], (arr, name) => arr.find((i) => i.name === name)) };
+	cli = {};
+	/**
+	* Observer for the AIGNE instance.
+	*/
+	observer;
+	/**
+	* Metadata for the AIGNE instance.
+	*/
+	metadata = {};
+	/**
+	* Adds one or more agents to this AIGNE instance.
+	* Each agent is attached to this AIGNE instance, allowing it to access the AIGNE's resources.
+	*
+	* @param agents - One or more Agent instances to add to this AIGNE.
+	*/
+	addAgent(...agents) {
+		checkArguments("AIGNE.addAgent", aigneAddAgentArgsSchema, agents);
+		for (const agent of agents) {
+			this.agents.push(agent);
+			agent.attach(this);
+		}
+	}
+	/**
+	* Creates a new execution context for this AIGNE instance.
+	* Contexts isolate state for different flows or conversations.
+	*
+	* @returns A new AIGNEContext instance bound to this AIGNE.
+	*/
+	newContext(options) {
+		const context = new AIGNEContext(this);
+		if (options?.userContext) context.userContext = options.userContext;
+		if (options?.memories) context.memories = options.memories;
+		return context;
+	}
+	invoke(agent, message, options) {
+		this.observer?.serve();
+		return new AIGNEContext(this).invoke(agent, message, {
+			...options,
+			newContext: false
+		});
+	}
+	/**
+	* Publishes a message to the message queue for inter-agent communication.
+	* This method broadcasts a message to all subscribers of the specified topic(s).
+	* It creates a new context internally and delegates to the context's publish method.
+	*
+	* @param topic - The topic or array of topics to publish the message to
+	* @param payload - The message payload to be delivered to subscribers
+	* @param options - Optional configuration parameters for the publish operation
+	*
+	* @example
+	* Here's an example of how to publish a message:
+	* {@includeCode ../../test/aigne/aigne.test.ts#example-publish-message}
+	*/
+	publish(topic, payload, options) {
+		this.observer?.serve();
+		return new AIGNEContext(this).publish(topic, payload, options);
+	}
+	subscribe(topic, listener) {
+		return this.messageQueue.subscribe(topic, listener);
+	}
+	/**
+	* Unsubscribes a listener from a specific topic in the message queue.
+	* This method stops a previously registered listener from receiving further messages.
+	* It should be called when message processing is complete or when the component is no longer interested
+	* in messages published to the specified topic.
+	*
+	* @param topic - The topic to unsubscribe from
+	* @param listener - The listener function that was previously subscribed to the topic
+	*
+	* @example
+	* {@includeCode ../../test/aigne/aigne.test.ts#example-subscribe-topic}
+	*/
+	unsubscribe(topic, listener) {
+		this.messageQueue.unsubscribe(topic, listener);
+	}
+	/**
+	* Gracefully shuts down the AIGNE instance and all its agents and skills.
+	* This ensures proper cleanup of resources before termination.
+	*
+	* @returns A promise that resolves when shutdown is complete.
+	*
+	* @example
+	* Here's an example of shutdown an AIGNE instance:
+	* {@includeCode ../../test/aigne/aigne.test.ts#example-shutdown}
+	*/
+	async shutdown() {
+		await this.observer?.close(Array.from(this.contextIds));
+		for (const tool of this.skills) await tool.shutdown();
+		for (const agent of this.agents) await agent.shutdown();
+	}
+	/**
+	* Asynchronous dispose method for the AIGNE instance.
+	*
+	* @example
+	* Here's an example of using async dispose:
+	* {@includeCode ../../test/aigne/aigne.test.ts#example-shutdown-using}
+	*/
+	async [Symbol.asyncDispose]() {
+		await this.shutdown();
+	}
+	/**
+	* Initializes handlers for process exit events to ensure clean shutdown.
+	* This registers handlers for SIGINT/SIGTERM to properly terminate all agents.
+	* Note: 'exit' event cannot run async code, so we handle cleanup in signal handlers.
+	*/
+	initProcessExitHandler() {
+		const originalExit = process.exit;
+		process.exit = (...args) => {
+			this.shutdown().finally(() => originalExit(...args));
+		};
+		const shutdownAndExit = () => this.shutdown().finally(() => originalExit(0));
+		process.on("SIGINT", shutdownAndExit);
+	}
+};
+const aigneOptionsSchema = z$1.object({
+	model: z$1.custom().optional(),
+	imageModel: z$1.custom().optional(),
+	skills: z$1.array(z$1.custom()).optional(),
+	agents: z$1.array(z$1.custom()).optional(),
+	observer: z$1.custom().optional()
+});
+const aigneAddAgentArgsSchema = z$1.array(z$1.custom());
+
+//#endregion
+export { AIGNE };
+//# sourceMappingURL=aigne.mjs.map

package/dist/aigne/aigne.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aigne.mjs","names":["z"],"sources":["../../src/aigne/aigne.ts"],"sourcesContent":["import { AIGNEObserver } from \"@aigne/observability-api\";\nimport { z } from \"zod\";\nimport type { Agent, AgentResponse, AgentResponseStream, Message } from \"../agents/agent.js\";\nimport type { ChatModel } from \"../agents/chat-model.js\";\nimport type { ImageModel } from \"../agents/image-model.js\";\nimport type { UserAgent } from \"../agents/user-agent.js\";\nimport { type LoadOptions, load } from \"../loader/index.js\";\nimport { checkArguments, createAccessorArray } from \"../utils/type-utils.js\";\nimport { AIGNEContext, type Context, type InvokeOptions, type UserContext } from \"./context.js\";\nimport {\n  type MessagePayload,\n  MessageQueue,\n  type MessageQueueListener,\n  type Unsubscribe,\n} from \"./message-queue.js\";\nimport type { AIGNECLIAgents, AIGNEMetadata } from \"./type.js\";\nimport type { ContextLimits } from \"./usage.js\";\n\n/**\n * Options for the AIGNE class.\n */\nexport interface AIGNEOptions {\n  /**\n   * Optional root directory for this AIGNE instance.\n   * This is used to resolve relative paths for agents and skills.\n   */\n  rootDir?: string;\n\n  /**\n   * The name of the AIGNE instance.\n   */\n  name?: string;\n\n  /**\n   * The description of the AIGNE instance.\n   */\n  description?: string;\n\n  /**\n   * Global model to use for all agents not specifying a model.\n   */\n  model?: ChatModel;\n\n  /**\n   * Optional image model to use for image processing tasks.\n   */\n  imageModel?: ImageModel;\n\n  /**\n   * Skills to use for the AIGNE instance.\n   */\n  skills?: Agent[];\n\n  /**\n   * Agents to use for the AIGNE instance.\n   */\n  agents?: Agent[];\n\n  mcpServer?: {\n    agents?: Agent[];\n  };\n\n  cli?: AIGNECLIAgents;\n\n  /**\n   * Limits for the AIGNE instance, such as timeout, max tokens, max invocations, etc.\n   */\n  limits?: ContextLimits;\n\n  /**\n   * Observer for the AIGNE instance.\n   */\n  observer?: AIGNEObserver;\n\n  metadata?: AIGNEMetadata;\n}\n\n/**\n * AIGNE is a class that orchestrates multiple agents to build complex AI applications.\n * It serves as the central coordination point for agent interactions, message passing, and execution flow.\n *\n * @example\n * Here's a simple example of how to use AIGNE:\n * {@includeCode ../../test/aigne/aigne.test.ts#example-simple}\n *\n * @example\n * Here's an example of how to use AIGNE with streaming response:\n * {@includeCode ../../test/aigne/aigne.test.ts#example-streaming}\n */\nexport class AIGNE<U extends UserContext = UserContext> {\n  /**\n   * Loads an AIGNE instance from a directory containing an aigne.yaml file and agent definitions.\n   * This static method provides a convenient way to initialize an AIGNE system from configuration files.\n   *\n   * @param path - Path to the directory containing the aigne.yaml file.\n   * @param options - Options to override the loaded configuration.\n   * @returns A fully initialized AIGNE instance with configured agents and skills.\n   */\n  static async load(\n    path: string,\n    options: Omit<AIGNEOptions, keyof LoadOptions> & LoadOptions = {},\n  ): Promise<AIGNE> {\n    const { agents = [], skills = [], model, imageModel, ...aigne } = await load(path, options);\n    return new AIGNE({\n      ...aigne,\n      ...options,\n      model,\n      imageModel,\n      agents: agents.concat(options?.agents ?? []),\n      skills: skills.concat(options?.skills ?? []),\n      metadata: options?.metadata,\n    });\n  }\n\n  /**\n   * Creates a new AIGNE instance with the specified options.\n   *\n   * @param options - Configuration options for the AIGNE instance including name, description, model, and agents.\n   */\n  constructor(options?: AIGNEOptions) {\n    if (options) checkArguments(\"AIGNE\", aigneOptionsSchema, options);\n\n    this.rootDir = options?.rootDir;\n    this.name = options?.name;\n    this.description = options?.description;\n    this.model = options?.model;\n    this.imageModel = options?.imageModel;\n    this.limits = options?.limits;\n    this.observer =\n      process.env.AIGNE_OBSERVABILITY_DISABLED === \"true\"\n        ? undefined\n        : (options?.observer ?? new AIGNEObserver());\n    if (options?.skills?.length) this.skills.push(...options.skills);\n    if (options?.agents?.length) this.addAgent(...options.agents);\n    if (options?.mcpServer?.agents?.length) this.mcpServer.agents.push(...options.mcpServer.agents);\n    this.cli = options?.cli ?? {};\n\n    this.observer?.serve();\n    this.initProcessExitHandler();\n    this.metadata = options?.metadata ?? {};\n  }\n\n  /**\n   * Optional root directory for this AIGNE instance.\n   */\n  rootDir?: string;\n\n  /**\n   * Optional name identifier for this AIGNE instance.\n   */\n  name?: string;\n\n  /**\n   * Optional description of this AIGNE instance's purpose or functionality.\n   */\n  description?: string;\n\n  /**\n   * Global model to use for all agents that don't specify their own model.\n   */\n  model?: ChatModel;\n\n  /**\n   * Optional image model to use for image processing tasks.\n   */\n  imageModel?: ImageModel;\n\n  /**\n   * Usage limits applied to this AIGNE instance's execution.\n   */\n  limits?: ContextLimits;\n\n  /**\n   * Message queue for handling inter-agent communication.\n   *\n   * @hidden\n   */\n  readonly messageQueue = new MessageQueue();\n\n  /**\n   * Collection of all context IDs created by this AIGNE instance.\n   */\n  readonly contextIds = new Set<string>();\n\n  /**\n   * Collection of skill agents available to this AIGNE instance.\n   * Provides indexed access by skill name.\n   */\n  readonly skills = createAccessorArray<Agent>([], (arr, name) => arr.find((i) => i.name === name));\n\n  /**\n   * Collection of primary agents managed by this AIGNE instance.\n   * Provides indexed access by agent name.\n   */\n  readonly agents = createAccessorArray<Agent>([], (arr, name) => arr.find((i) => i.name === name));\n\n  readonly mcpServer = {\n    agents: createAccessorArray<Agent>([], (arr, name) => arr.find((i) => i.name === name)),\n  };\n\n  readonly cli: AIGNECLIAgents = {};\n\n  /**\n   * Observer for the AIGNE instance.\n   */\n  readonly observer?: AIGNEObserver;\n\n  /**\n   * Metadata for the AIGNE instance.\n   */\n  readonly metadata: AIGNEMetadata = {};\n\n  /**\n   * Adds one or more agents to this AIGNE instance.\n   * Each agent is attached to this AIGNE instance, allowing it to access the AIGNE's resources.\n   *\n   * @param agents - One or more Agent instances to add to this AIGNE.\n   */\n  addAgent(...agents: Agent[]) {\n    checkArguments(\"AIGNE.addAgent\", aigneAddAgentArgsSchema, agents);\n\n    for (const agent of agents) {\n      this.agents.push(agent);\n\n      agent.attach(this);\n    }\n  }\n\n  /**\n   * Creates a new execution context for this AIGNE instance.\n   * Contexts isolate state for different flows or conversations.\n   *\n   * @returns A new AIGNEContext instance bound to this AIGNE.\n   */\n  newContext(options?: Partial<Pick<Context, \"userContext\" | \"memories\">>) {\n    const context = new AIGNEContext(this);\n\n    if (options?.userContext) context.userContext = options.userContext;\n    if (options?.memories) context.memories = options.memories;\n\n    return context;\n  }\n\n  /**\n   * Creates a user agent for consistent interactions with a specified agent.\n   * This method allows you to create a wrapper around an agent for repeated invocations.\n   *\n   * @param agent - Target agent to be wrapped for consistent invocation\n   * @returns A user agent instance that provides a convenient interface for interacting with the target agent\n   *\n   * @example\n   * Here's an example of how to create a user agent and invoke it consistently:\n   * {@includeCode ../../test/aigne/aigne.test.ts#example-user-agent}\n   */\n  invoke<I extends Message, O extends Message>(agent: Agent<I, O>): UserAgent<I, O>;\n\n  /**\n   * Invokes an agent with a message and returns both the output and the active agent.\n   * This overload is useful when you need to track which agent was ultimately responsible for generating the response.\n   *\n   * @param agent - Target agent to invoke\n   * @param message - Input message to send to the agent\n   * @param options.returnActiveAgent - Must be true to return the final active agent\n   * @param options.streaming - Must be false to return a response stream\n   * @returns A promise resolving to a tuple containing the agent's response and the final active agent\n   */\n  invoke<I extends Message, O extends Message>(\n    agent: Agent<I, O>,\n    message: I & Message,\n    options: InvokeOptions<U> & { returnActiveAgent: true; streaming?: false },\n  ): Promise<[O, Agent]>;\n\n  /**\n   * Invokes an agent with a message and returns both a stream of the response and the active agent.\n   * This overload is useful when you need streaming responses while also tracking which agent provided them.\n   *\n   * @param agent - Target agent to invoke\n   * @param message - Input message to send to the agent\n   * @param options.returnActiveAgent - Must be true to return the final active agent\n   * @param options.streaming - Must be true to return a response stream\n   * @returns A promise resolving to a tuple containing the agent's response stream and a promise for the final agent\n   */\n  invoke<I extends Message, O extends Message>(\n    agent: Agent<I, O>,\n    message: I & Message,\n    options: InvokeOptions<U> & { returnActiveAgent: true; streaming: true },\n  ): Promise<[AgentResponseStream<O>, Promise<Agent>]>;\n\n  /**\n   * Invokes an agent with a message and returns just the output.\n   * This is the standard way to invoke an agent when you only need the response.\n   *\n   * @param agent - Target agent to invoke\n   * @param message - Input message to send to the agent\n   * @param options - Optional configuration parameters for the invocation\n   * @returns A promise resolving to the agent's complete response\n   *\n   * @example\n   * Here's a simple example of how to invoke an agent:\n   * {@includeCode ../../test/aigne/aigne.test.ts#example-simple}\n   */\n  invoke<I extends Message, O extends Message>(\n    agent: Agent<I, O>,\n    message: I & Message,\n    options?: InvokeOptions<U> & { returnActiveAgent?: false; streaming?: false },\n  ): Promise<O>;\n\n  /**\n   * Invokes an agent with a message and returns a stream of the response.\n   * This allows processing the response incrementally as it's being generated.\n   *\n   * @param agent - Target agent to invoke\n   * @param message - Input message to send to the agent\n   * @param options - Configuration with streaming enabled to receive incremental response chunks\n   * @returns A promise resolving to a stream of the agent's response that can be consumed incrementally\n   *\n   * @example\n   * Here's an example of how to invoke an agent with streaming response:\n   * {@includeCode ../../test/aigne/aigne.test.ts#example-streaming}\n   */\n  invoke<I extends Message, O extends Message>(\n    agent: Agent<I, O>,\n    message: I & Message,\n    options: InvokeOptions<U> & { returnActiveAgent?: false; streaming: true },\n  ): Promise<AgentResponseStream<O>>;\n\n  /**\n   * General implementation signature that handles all overload cases.\n   * This unified signature supports all the different invocation patterns defined by the overloads.\n   *\n   * @param agent - Target agent to invoke or wrap\n   * @param message - Optional input message to send to the agent\n   * @param options - Optional configuration parameters for the invocation\n   * @returns Either a UserAgent (when no message provided) or a promise resolving to the agent's response\n   * with optional active agent information based on the provided options\n   */\n  invoke<I extends Message, O extends Message>(\n    agent: Agent<I, O>,\n    message?: I & Message,\n    options?: InvokeOptions<U>,\n  ): UserAgent<I, O> | Promise<AgentResponse<O> | [AgentResponse<O>, Agent]>;\n\n  invoke<I extends Message, O extends Message>(\n    agent: Agent<I, O>,\n    message?: I & Message,\n    options?: InvokeOptions<U>,\n  ): UserAgent<I, O> | Promise<AgentResponse<O> | [AgentResponse<O>, Agent]> {\n    this.observer?.serve();\n    const context = new AIGNEContext(this);\n    return context.invoke(agent, message, { ...options, newContext: false });\n  }\n\n  /**\n   * Publishes a message to the message queue for inter-agent communication.\n   * This method broadcasts a message to all subscribers of the specified topic(s).\n   * It creates a new context internally and delegates to the context's publish method.\n   *\n   * @param topic - The topic or array of topics to publish the message to\n   * @param payload - The message payload to be delivered to subscribers\n   * @param options - Optional configuration parameters for the publish operation\n   *\n   * @example\n   * Here's an example of how to publish a message:\n   * {@includeCode ../../test/aigne/aigne.test.ts#example-publish-message}\n   */\n  publish(\n    topic: string | string[],\n    payload: Omit<MessagePayload, \"context\"> | Message,\n    options?: InvokeOptions<U>,\n  ) {\n    this.observer?.serve();\n    return new AIGNEContext(this).publish(topic, payload, options);\n  }\n\n  /**\n   * Subscribes to receive the next message on a specific topic.\n   * This overload returns a Promise that resolves with the next message published to the topic.\n   * It's useful for one-time message handling or when using async/await patterns.\n   *\n   * @param topic - The topic to subscribe to\n   * @returns A Promise that resolves with the next message payload published to the specified topic\n   *\n   * @example\n   * Here's an example of how to subscribe to a topic and receive the next message:\n   * {@includeCode ../../test/aigne/aigne.test.ts#example-publish-message}\n   */\n  subscribe(topic: string | string[], listener?: undefined): Promise<MessagePayload>;\n\n  /**\n   * Subscribes to messages on a specific topic with a listener callback.\n   * This overload registers a listener function that will be called for each message published to the topic.\n   * It's useful for continuous message handling or event-driven architectures.\n   *\n   * @param topic - The topic to subscribe to\n   * @param listener - Callback function that will be invoked when messages arrive on the specified topic\n   * @returns An Unsubscribe function that can be called to cancel the subscription\n   *\n   * @example\n   * Here's an example of how to subscribe to a topic with a listener:\n   * {@includeCode ../../test/aigne/aigne.test.ts#example-subscribe-topic}\n   */\n  subscribe(topic: string | string[], listener: MessageQueueListener): Unsubscribe;\n\n  /**\n   * Generic subscribe signature that handles both Promise and listener patterns.\n   * This is the implementation signature that supports both overloaded behaviors.\n   *\n   * @param topic - The topic to subscribe to\n   * @param listener - Optional callback function\n   * @returns Either a Promise for the next message or an Unsubscribe function\n   */\n  subscribe(\n    topic: string | string[],\n    listener?: MessageQueueListener,\n  ): Unsubscribe | Promise<MessagePayload>;\n  subscribe(\n    topic: string | string[],\n    listener?: MessageQueueListener,\n  ): Unsubscribe | Promise<MessagePayload> {\n    return this.messageQueue.subscribe(topic, listener);\n  }\n\n  /**\n   * Unsubscribes a listener from a specific topic in the message queue.\n   * This method stops a previously registered listener from receiving further messages.\n   * It should be called when message processing is complete or when the component is no longer interested\n   * in messages published to the specified topic.\n   *\n   * @param topic - The topic to unsubscribe from\n   * @param listener - The listener function that was previously subscribed to the topic\n   *\n   * @example\n   * {@includeCode ../../test/aigne/aigne.test.ts#example-subscribe-topic}\n   */\n  unsubscribe(topic: string | string[], listener: MessageQueueListener) {\n    this.messageQueue.unsubscribe(topic, listener);\n  }\n\n  /**\n   * Gracefully shuts down the AIGNE instance and all its agents and skills.\n   * This ensures proper cleanup of resources before termination.\n   *\n   * @returns A promise that resolves when shutdown is complete.\n   *\n   * @example\n   * Here's an example of shutdown an AIGNE instance:\n   * {@includeCode ../../test/aigne/aigne.test.ts#example-shutdown}\n   */\n  async shutdown() {\n    // Close observer first to flush any pending traces\n    await this.observer?.close(Array.from(this.contextIds));\n\n    for (const tool of this.skills) {\n      await tool.shutdown();\n    }\n    for (const agent of this.agents) {\n      await agent.shutdown();\n    }\n  }\n\n  /**\n   * Asynchronous dispose method for the AIGNE instance.\n   *\n   * @example\n   * Here's an example of using async dispose:\n   * {@includeCode ../../test/aigne/aigne.test.ts#example-shutdown-using}\n   */\n  async [Symbol.asyncDispose]() {\n    await this.shutdown();\n  }\n\n  /**\n   * Initializes handlers for process exit events to ensure clean shutdown.\n   * This registers handlers for SIGINT/SIGTERM to properly terminate all agents.\n   * Note: 'exit' event cannot run async code, so we handle cleanup in signal handlers.\n   */\n  private initProcessExitHandler() {\n    const originalExit = process.exit;\n\n    // @ts-ignore\n    process.exit = (...args) => {\n      this.shutdown().finally(() => originalExit(...args));\n    };\n\n    const shutdownAndExit = () => this.shutdown().finally(() => originalExit(0));\n    process.on(\"SIGINT\", shutdownAndExit);\n  }\n}\n\nconst aigneOptionsSchema = z.object({\n  model: z.custom<ChatModel>().optional(),\n  imageModel: z.custom<ImageModel>().optional(),\n  skills: z.array(z.custom<Agent>()).optional(),\n  agents: z.array(z.custom<Agent>()).optional(),\n  observer: z.custom<AIGNEObserver>().optional(),\n});\n\nconst aigneAddAgentArgsSchema = z.array(z.custom<Agent>());\n"],"mappings":"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"}