@agentionai/agents 0.4.2 → 0.6.0

package/README.md

@@ -86,14 +86,14 @@ import { GeminiAgent, Tool } from '@agentionai/agents/gemini';
 const weatherTool = new Tool({
   name: 'get_weather',
   description: 'Get the current weather for a location',
-  input_schema: {
+  inputSchema: {
     type: 'object',
     properties: {
       location: { type: 'string', description: 'City name' },
     },
     required: ['location'],
   },
-  handler: async ({ location }) => {
+  execute: async ({ location }) => {
     // In production, call a weather API
     return JSON.stringify({
       location,

package/dist/{vectorstore → embeddings}/OpenAIEmbeddings.d.ts

@@ -1,9 +1,13 @@
 /**
  * OpenAI embeddings implementation.
  *
- * @requires openai - Uses the OpenAI SDK (already a peer dependency)
+ * @requires openai - Uses the OpenAI SDK (peer dependency, dynamically imported)
  */
 import { Embeddings } from "./Embeddings";
+/**
+ * Available OpenAI embedding models with their dimensions.
+ */
+export type OpenAIEmbeddingModel = "text-embedding-3-small" | "text-embedding-3-large" | "text-embedding-ada-002";
 /**
  * Configuration for OpenAI embeddings.
  */
@@ -11,7 +15,7 @@ export interface OpenAIEmbeddingsConfig {
     /** OpenAI API key (defaults to OPENAI_API_KEY env var) */
     apiKey?: string;
     /** Model to use for embeddings */
-    model?: "text-embedding-3-small" | "text-embedding-3-large" | "text-embedding-ada-002" | string;
+    model?: OpenAIEmbeddingModel | string;
     /** Number of dimensions (only for text-embedding-3-* models) */
     dimensions?: number;
     /** Base URL for API (for proxies or compatible APIs) */
@@ -20,10 +24,14 @@ export interface OpenAIEmbeddingsConfig {
 /**
  * OpenAI embeddings provider.
  *
+ * Supports all OpenAI embedding models including text-embedding-3-small,
+ * text-embedding-3-large, and text-embedding-ada-002.
+ *
  * @example
  * ```typescript
  * const embeddings = new OpenAIEmbeddings({
  *   model: 'text-embedding-3-small',
+ *   dimensions: 512, // Optional: reduce dimensions for faster search
  * });
  *
  * const vectors = await embeddings.embed(['Hello world', 'Goodbye world']);

package/dist/{vectorstore → embeddings}/OpenAIEmbeddings.js

@@ -2,7 +2,7 @@
 /**
  * OpenAI embeddings implementation.
  *
- * @requires openai - Uses the OpenAI SDK (already a peer dependency)
+ * @requires openai - Uses the OpenAI SDK (peer dependency, dynamically imported)
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -49,10 +49,14 @@ const MODEL_DIMENSIONS = {
 /**
  * OpenAI embeddings provider.
  *
+ * Supports all OpenAI embedding models including text-embedding-3-small,
+ * text-embedding-3-large, and text-embedding-ada-002.
+ *
  * @example
  * ```typescript
  * const embeddings = new OpenAIEmbeddings({
  *   model: 'text-embedding-3-small',
+ *   dimensions: 512, // Optional: reduce dimensions for faster search
  * });
  *
  * const vectors = await embeddings.embed(['Hello world', 'Goodbye world']);

package/dist/embeddings/VoyageAIEmbeddings.d.ts

@@ -0,0 +1,80 @@
+/**
+ * VoyageAI embeddings implementation.
+ *
+ * @requires voyageai - Uses the VoyageAI SDK (peer dependency, dynamically imported)
+ */
+import { Embeddings } from "./Embeddings";
+/**
+ * Available VoyageAI embedding models with their dimensions and rate limits.
+ */
+export type VoyageAIEmbeddingModel = "voyage-4-large" | "voyage-3-large" | "voyage-context-3" | "voyage-code-3" | "voyage-4" | "voyage-3.5" | "voyage-4-lite" | "voyage-3.5-lite";
+/**
+ * Available VoyageAI multimodal models.
+ */
+export type VoyageAIMultimodalModel = "voyage-multimodal-3.5" | "voyage-multimodal-3";
+/**
+ * Configuration for VoyageAI embeddings.
+ */
+export interface VoyageAIEmbeddingsConfig {
+    /** VoyageAI API key (defaults to VOYAGE_API_KEY env var) */
+    apiKey?: string;
+    /** Model to use for embeddings */
+    model?: VoyageAIEmbeddingModel | VoyageAIMultimodalModel | string;
+    /** Input type for optimization (default: "document") */
+    inputType?: "query" | "document";
+    /** Optional truncation mode */
+    truncation?: boolean;
+    /** Base URL for API (for proxies or compatible APIs) */
+    baseURL?: string;
+    /** Maximum number of retries (default: 2) */
+    maxRetries?: number;
+    /** Timeout in seconds (default: 60) */
+    timeoutInSeconds?: number;
+}
+/**
+ * VoyageAI embeddings provider.
+ *
+ * Supports VoyageAI's embedding models including voyage-4, voyage-3.5, voyage-code-3,
+ * and multimodal models. Features automatic retries with exponential backoff.
+ *
+ * @example
+ * ```typescript
+ * const embeddings = new VoyageAIEmbeddings({
+ *   model: 'voyage-4',
+ *   inputType: 'document', // or 'query' for search queries
+ * });
+ *
+ * const vectors = await embeddings.embed(['Hello world', 'Goodbye world']);
+ * ```
+ *
+ * @example With custom configuration
+ * ```typescript
+ * const embeddings = new VoyageAIEmbeddings({
+ *   model: 'voyage-code-3',
+ *   maxRetries: 3,
+ *   timeoutInSeconds: 30,
+ * });
+ * ```
+ */
+export declare class VoyageAIEmbeddings extends Embeddings {
+    readonly name = "voyageai";
+    readonly model: string;
+    readonly dimensions: number;
+    private apiKey;
+    private inputType;
+    private truncation?;
+    private baseURL?;
+    private maxRetries;
+    private timeoutInSeconds;
+    constructor(config?: VoyageAIEmbeddingsConfig);
+    /**
+     * Generate embeddings for multiple texts using VoyageAI API.
+     */
+    embed(texts: string[]): Promise<number[][]>;
+    /**
+     * Generate embedding for a search query.
+     * Overrides the default to use inputType: "query" for better search results.
+     */
+    embedQuery(query: string): Promise<number[]>;
+}
+//# sourceMappingURL=VoyageAIEmbeddings.d.ts.map

package/dist/embeddings/VoyageAIEmbeddings.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * VoyageAI embeddings implementation.
+ *
+ * @requires voyageai - Uses the VoyageAI SDK (peer dependency, dynamically imported)
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoyageAIEmbeddings = void 0;
+const Embeddings_1 = require("./Embeddings");
+/** Default dimensions for each model */
+const MODEL_DIMENSIONS = {
+    "voyage-4-large": 1024,
+    "voyage-3-large": 1024,
+    "voyage-context-3": 1024,
+    "voyage-code-3": 1024,
+    "voyage-4": 1024,
+    "voyage-3.5": 1024,
+    "voyage-4-lite": 1024,
+    "voyage-3.5-lite": 1024,
+    "voyage-multimodal-3.5": 1024,
+    "voyage-multimodal-3": 1024,
+};
+/**
+ * VoyageAI embeddings provider.
+ *
+ * Supports VoyageAI's embedding models including voyage-4, voyage-3.5, voyage-code-3,
+ * and multimodal models. Features automatic retries with exponential backoff.
+ *
+ * @example
+ * ```typescript
+ * const embeddings = new VoyageAIEmbeddings({
+ *   model: 'voyage-4',
+ *   inputType: 'document', // or 'query' for search queries
+ * });
+ *
+ * const vectors = await embeddings.embed(['Hello world', 'Goodbye world']);
+ * ```
+ *
+ * @example With custom configuration
+ * ```typescript
+ * const embeddings = new VoyageAIEmbeddings({
+ *   model: 'voyage-code-3',
+ *   maxRetries: 3,
+ *   timeoutInSeconds: 30,
+ * });
+ * ```
+ */
+class VoyageAIEmbeddings extends Embeddings_1.Embeddings {
+    constructor(config = {}) {
+        super();
+        this.name = "voyageai";
+        this.model = config.model ?? "voyage-4";
+        this.apiKey = config.apiKey ?? process.env.VOYAGE_API_KEY ?? "";
+        this.inputType = config.inputType ?? "document";
+        this.truncation = config.truncation;
+        this.baseURL = config.baseURL;
+        this.maxRetries = config.maxRetries ?? 2;
+        this.timeoutInSeconds = config.timeoutInSeconds ?? 60;
+        // Determine dimensions
+        this.dimensions = MODEL_DIMENSIONS[this.model] ?? 1024;
+        if (!this.apiKey) {
+            throw new Error("VoyageAI API key is required. Set VOYAGE_API_KEY env var or pass apiKey in config.");
+        }
+    }
+    /**
+     * Generate embeddings for multiple texts using VoyageAI API.
+     */
+    async embed(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        // Dynamic import to keep voyageai optional at module load time
+        const { VoyageAIClient } = await Promise.resolve().then(() => __importStar(require("voyageai")));
+        const client = new VoyageAIClient({
+            apiKey: this.apiKey,
+        });
+        const params = {
+            input: texts,
+            model: this.model,
+            inputType: this.inputType,
+        };
+        if (this.truncation !== undefined) {
+            params.truncation = this.truncation;
+        }
+        const response = await client.embed(params, {
+            maxRetries: this.maxRetries,
+            timeoutInSeconds: this.timeoutInSeconds,
+        });
+        // VoyageAI returns embeddings in order
+        return response.data?.map((item) => item.embedding) ?? [];
+    }
+    /**
+     * Generate embedding for a search query.
+     * Overrides the default to use inputType: "query" for better search results.
+     */
+    async embedQuery(query) {
+        const originalInputType = this.inputType;
+        this.inputType = "query";
+        const result = await this.embedOne(query);
+        this.inputType = originalInputType;
+        return result;
+    }
+}
+exports.VoyageAIEmbeddings = VoyageAIEmbeddings;
+//# sourceMappingURL=VoyageAIEmbeddings.js.map

package/dist/embeddings/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Embeddings module for generating vector representations of text.
+ *
+ * @example
+ * ```typescript
+ * import { OpenAIEmbeddings, VoyageAIEmbeddings } from "@agentionai/agents/embeddings";
+ *
+ * // OpenAI embeddings
+ * const openaiEmbeddings = new OpenAIEmbeddings({
+ *   model: "text-embedding-3-small",
+ * });
+ *
+ * // VoyageAI embeddings
+ * const voyageEmbeddings = new VoyageAIEmbeddings({
+ *   model: "voyage-4",
+ *   inputType: "document",
+ * });
+ * ```
+ */
+export { Embeddings, EmbeddingOptions } from "./Embeddings";
+export { OpenAIEmbeddings, OpenAIEmbeddingsConfig, OpenAIEmbeddingModel, } from "./OpenAIEmbeddings";
+export { VoyageAIEmbeddings, VoyageAIEmbeddingsConfig, VoyageAIEmbeddingModel, VoyageAIMultimodalModel, } from "./VoyageAIEmbeddings";
+//# sourceMappingURL=index.d.ts.map

package/dist/embeddings/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Embeddings module for generating vector representations of text.
+ *
+ * @example
+ * ```typescript
+ * import { OpenAIEmbeddings, VoyageAIEmbeddings } from "@agentionai/agents/embeddings";
+ *
+ * // OpenAI embeddings
+ * const openaiEmbeddings = new OpenAIEmbeddings({
+ *   model: "text-embedding-3-small",
+ * });
+ *
+ * // VoyageAI embeddings
+ * const voyageEmbeddings = new VoyageAIEmbeddings({
+ *   model: "voyage-4",
+ *   inputType: "document",
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoyageAIEmbeddings = exports.OpenAIEmbeddings = exports.Embeddings = void 0;
+var Embeddings_1 = require("./Embeddings");
+Object.defineProperty(exports, "Embeddings", { enumerable: true, get: function () { return Embeddings_1.Embeddings; } });
+var OpenAIEmbeddings_1 = require("./OpenAIEmbeddings");
+Object.defineProperty(exports, "OpenAIEmbeddings", { enumerable: true, get: function () { return OpenAIEmbeddings_1.OpenAIEmbeddings; } });
+var VoyageAIEmbeddings_1 = require("./VoyageAIEmbeddings");
+Object.defineProperty(exports, "VoyageAIEmbeddings", { enumerable: true, get: function () { return VoyageAIEmbeddings_1.VoyageAIEmbeddings; } });
+//# sourceMappingURL=index.js.map

package/dist/graph/AgentGraph.d.ts

@@ -1,4 +1,5 @@
 import { BaseAgent } from "../agents/BaseAgent";
+import { Tool } from "../tools/Tool";
 import { GraphNode } from "./BaseExecutor";
 import { MapExecutor, MapExecutorOptions } from "./MapExecutor";
 import { ParallelExecutor, ParallelExecutorOptions } from "./ParallelExecutor";
@@ -6,6 +7,8 @@ import { Pipeline } from "./Pipeline";
 import { RouterExecutor, RouterExecutorOptions, Route } from "./RouterExecutor";
 import { SequentialExecutor, SequentialExecutorOptions } from "./SequentialExecutor";
 import { VotingSystem, VotingSystemOptions } from "./VotingSystem";
+import { ContextStore } from "./context";
+import { PlanStore, PlanExecutor, PlanExecutorOptions } from "./planning";
 export { GraphNode } from "./BaseExecutor";
 export { SequentialExecutor, SequentialExecutorOptions, } from "./SequentialExecutor";
 export { ParallelExecutor, ParallelExecutorOptions } from "./ParallelExecutor";
@@ -15,6 +18,8 @@ export { VotingSystem, VotingSystemOptions, VotingInput } from "./VotingSystem";
 export { RouterExecutor, RouterExecutorOptions, Route } from "./RouterExecutor";
 export { BaseExecutor, PipelineContext, ContextualInput, NodeInput, NodeOutput, MetricsCollector, NodeExecutionMetrics, MetricsTokenUsage, GraphNodeType, } from "./BaseExecutor";
 export { PipelineMetrics, PipelineStructure, getMetricsCollector, setMetricsCollector, createMetricsCollector, } from "./GraphMetrics";
+export { ContextStore, createContextGetTool, createContextSetTool, createContextListTool, createContextDeleteTool, } from "./context";
+export { Plan, PlanStep, PlanStepStatus, PlanStatus, PlanStore, createPlanTool, createViewPlanTool, createUpdateStepTool, createGetNextStepTool, createAddStepTool, PlanExecutor, PlanExecutorOptions, } from "./planning";
 /**
  * Factory class for building agent graphs and workflows.
  * Provides static methods to create various execution patterns.
@@ -95,5 +100,77 @@ export declare class AgentGraph {
      * ```
      */
     static router(router: BaseAgent, routes: Route[], options?: RouterExecutorOptions): RouterExecutor;
+    /**
+     * Creates a shared context store for passing data between agents.
+     *
+     * @param initial - Optional initial key-value pairs
+     * @returns ContextStore instance
+     *
+     * @example
+     * ```typescript
+     * const context = AgentGraph.createContextStore({ userId: '123' });
+     * const tools = AgentGraph.createContextTools(context);
+     * const agent = Agent.create({ ..., tools });
+     * ```
+     */
+    static createContextStore(initial?: Record<string, unknown>): ContextStore;
+    /**
+     * Creates context tools for an agent to read/write shared context.
+     * Includes: context_get, context_set, list_context_keys, context_delete
+     *
+     * @param store - The ContextStore to interact with
+     * @returns Array of context tools
+     */
+    static createContextTools(store: ContextStore): Tool<string>[];
+    /**
+     * Creates a plan store for managing execution plans.
+     *
+     * @returns PlanStore instance
+     *
+     * @example
+     * ```typescript
+     * const planStore = AgentGraph.createPlanStore();
+     * const tools = AgentGraph.createPlanningTools(planStore);
+     * const agent = Agent.create({ ..., tools });
+     * ```
+     */
+    static createPlanStore(): PlanStore;
+    /**
+     * Creates planning tools for an agent to create and manage plans.
+     * Includes: create_plan, view_plan, update_step, get_next_step, add_step
+     *
+     * @param store - The PlanStore to interact with
+     * @returns Array of planning tools
+     */
+    static createPlanningTools(store: PlanStore): Tool<string>[];
+    /**
+     * Creates a plan executor with separation of planning and execution.
+     *
+     * @param planStore - The PlanStore to track plan progress
+     * @param planningAgent - Agent responsible for creating the plan
+     * @param worker - Agent or GraphNode that executes individual steps
+     * @param options - Configuration options
+     * @returns PlanExecutor instance
+     *
+     * @example
+     * ```typescript
+     * const planStore = AgentGraph.createPlanStore();
+     * const contextStore = AgentGraph.createContextStore();
+     *
+     * const planner = new ClaudeAgent({
+     *   tools: AgentGraph.createPlanningTools(planStore),
+     *   description: 'Create a detailed plan.',
+     * });
+     *
+     * const worker = new ClaudeAgent({
+     *   tools: AgentGraph.createContextTools(contextStore),
+     *   description: 'Execute individual steps.',
+     * });
+     *
+     * const executor = AgentGraph.planExecutor(planStore, planner, worker);
+     * const result = await executor.execute('Research quantum computing');
+     * ```
+     */
+    static planExecutor(planStore: PlanStore, planningAgent: BaseAgent, worker: GraphNode<string, string> | BaseAgent, options?: PlanExecutorOptions): PlanExecutor;
 }
 //# sourceMappingURL=AgentGraph.d.ts.map

package/dist/graph/AgentGraph.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentGraph = exports.createMetricsCollector = exports.setMetricsCollector = exports.getMetricsCollector = exports.MetricsCollector = exports.BaseExecutor = exports.RouterExecutor = exports.VotingSystem = exports.MapExecutor = exports.Pipeline = exports.ParallelExecutor = exports.SequentialExecutor = void 0;
+exports.AgentGraph = exports.PlanExecutor = exports.createAddStepTool = exports.createGetNextStepTool = exports.createUpdateStepTool = exports.createViewPlanTool = exports.createPlanTool = exports.PlanStore = exports.createContextDeleteTool = exports.createContextListTool = exports.createContextSetTool = exports.createContextGetTool = exports.ContextStore = exports.createMetricsCollector = exports.setMetricsCollector = exports.getMetricsCollector = exports.MetricsCollector = exports.BaseExecutor = exports.RouterExecutor = exports.VotingSystem = exports.MapExecutor = exports.Pipeline = exports.ParallelExecutor = exports.SequentialExecutor = void 0;
 const MapExecutor_1 = require("./MapExecutor");
 const ParallelExecutor_1 = require("./ParallelExecutor");
 const Pipeline_1 = require("./Pipeline");
 const RouterExecutor_1 = require("./RouterExecutor");
 const SequentialExecutor_1 = require("./SequentialExecutor");
 const VotingSystem_1 = require("./VotingSystem");
+const context_1 = require("./context");
+const planning_1 = require("./planning");
 var SequentialExecutor_2 = require("./SequentialExecutor");
 Object.defineProperty(exports, "SequentialExecutor", { enumerable: true, get: function () { return SequentialExecutor_2.SequentialExecutor; } });
 var ParallelExecutor_2 = require("./ParallelExecutor");
@@ -26,6 +28,22 @@ var GraphMetrics_1 = require("./GraphMetrics");
 Object.defineProperty(exports, "getMetricsCollector", { enumerable: true, get: function () { return GraphMetrics_1.getMetricsCollector; } });
 Object.defineProperty(exports, "setMetricsCollector", { enumerable: true, get: function () { return GraphMetrics_1.setMetricsCollector; } });
 Object.defineProperty(exports, "createMetricsCollector", { enumerable: true, get: function () { return GraphMetrics_1.createMetricsCollector; } });
+// Context exports
+var context_2 = require("./context");
+Object.defineProperty(exports, "ContextStore", { enumerable: true, get: function () { return context_2.ContextStore; } });
+Object.defineProperty(exports, "createContextGetTool", { enumerable: true, get: function () { return context_2.createContextGetTool; } });
+Object.defineProperty(exports, "createContextSetTool", { enumerable: true, get: function () { return context_2.createContextSetTool; } });
+Object.defineProperty(exports, "createContextListTool", { enumerable: true, get: function () { return context_2.createContextListTool; } });
+Object.defineProperty(exports, "createContextDeleteTool", { enumerable: true, get: function () { return context_2.createContextDeleteTool; } });
+// Planning exports
+var planning_2 = require("./planning");
+Object.defineProperty(exports, "PlanStore", { enumerable: true, get: function () { return planning_2.PlanStore; } });
+Object.defineProperty(exports, "createPlanTool", { enumerable: true, get: function () { return planning_2.createPlanTool; } });
+Object.defineProperty(exports, "createViewPlanTool", { enumerable: true, get: function () { return planning_2.createViewPlanTool; } });
+Object.defineProperty(exports, "createUpdateStepTool", { enumerable: true, get: function () { return planning_2.createUpdateStepTool; } });
+Object.defineProperty(exports, "createGetNextStepTool", { enumerable: true, get: function () { return planning_2.createGetNextStepTool; } });
+Object.defineProperty(exports, "createAddStepTool", { enumerable: true, get: function () { return planning_2.createAddStepTool; } });
+Object.defineProperty(exports, "PlanExecutor", { enumerable: true, get: function () { return planning_2.PlanExecutor; } });
 /**
  * Factory class for building agent graphs and workflows.
  * Provides static methods to create various execution patterns.
@@ -110,6 +128,99 @@ class AgentGraph {
     static router(router, routes, options = {}) {
         return new RouterExecutor_1.RouterExecutor(router, routes, options);
     }
+    /**
+     * Creates a shared context store for passing data between agents.
+     *
+     * @param initial - Optional initial key-value pairs
+     * @returns ContextStore instance
+     *
+     * @example
+     * ```typescript
+     * const context = AgentGraph.createContextStore({ userId: '123' });
+     * const tools = AgentGraph.createContextTools(context);
+     * const agent = Agent.create({ ..., tools });
+     * ```
+     */
+    static createContextStore(initial) {
+        return new context_1.ContextStore(initial);
+    }
+    /**
+     * Creates context tools for an agent to read/write shared context.
+     * Includes: context_get, context_set, list_context_keys, context_delete
+     *
+     * @param store - The ContextStore to interact with
+     * @returns Array of context tools
+     */
+    static createContextTools(store) {
+        return [
+            (0, context_1.createContextGetTool)(store),
+            (0, context_1.createContextSetTool)(store),
+            (0, context_1.createContextListTool)(store),
+            (0, context_1.createContextDeleteTool)(store),
+        ];
+    }
+    /**
+     * Creates a plan store for managing execution plans.
+     *
+     * @returns PlanStore instance
+     *
+     * @example
+     * ```typescript
+     * const planStore = AgentGraph.createPlanStore();
+     * const tools = AgentGraph.createPlanningTools(planStore);
+     * const agent = Agent.create({ ..., tools });
+     * ```
+     */
+    static createPlanStore() {
+        return new planning_1.PlanStore();
+    }
+    /**
+     * Creates planning tools for an agent to create and manage plans.
+     * Includes: create_plan, view_plan, update_step, get_next_step, add_step
+     *
+     * @param store - The PlanStore to interact with
+     * @returns Array of planning tools
+     */
+    static createPlanningTools(store) {
+        return [
+            (0, planning_1.createPlanTool)(store),
+            (0, planning_1.createViewPlanTool)(store),
+            (0, planning_1.createUpdateStepTool)(store),
+            (0, planning_1.createGetNextStepTool)(store),
+            (0, planning_1.createAddStepTool)(store),
+        ];
+    }
+    /**
+     * Creates a plan executor with separation of planning and execution.
+     *
+     * @param planStore - The PlanStore to track plan progress
+     * @param planningAgent - Agent responsible for creating the plan
+     * @param worker - Agent or GraphNode that executes individual steps
+     * @param options - Configuration options
+     * @returns PlanExecutor instance
+     *
+     * @example
+     * ```typescript
+     * const planStore = AgentGraph.createPlanStore();
+     * const contextStore = AgentGraph.createContextStore();
+     *
+     * const planner = new ClaudeAgent({
+     *   tools: AgentGraph.createPlanningTools(planStore),
+     *   description: 'Create a detailed plan.',
+     * });
+     *
+     * const worker = new ClaudeAgent({
+     *   tools: AgentGraph.createContextTools(contextStore),
+     *   description: 'Execute individual steps.',
+     * });
+     *
+     * const executor = AgentGraph.planExecutor(planStore, planner, worker);
+     * const result = await executor.execute('Research quantum computing');
+     * ```
+     */
+    static planExecutor(planStore, planningAgent, worker, options = {}) {
+        return new planning_1.PlanExecutor(planStore, planningAgent, worker, options);
+    }
 }
 exports.AgentGraph = AgentGraph;
 //# sourceMappingURL=AgentGraph.js.map

package/dist/graph/context/ContextStore.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Simple key-value store for sharing data between agents in a graph.
+ * Accessed via tools with descriptive keys.
+ *
+ * @example
+ * ```typescript
+ * const store = new ContextStore({ userId: '123' });
+ * store.set('research_findings', { topic: 'AI', summary: '...' });
+ * const findings = store.get<{ topic: string; summary: string }>('research_findings');
+ * ```
+ */
+export declare class ContextStore {
+    private store;
+    /**
+     * Create a new ContextStore with optional initial values.
+     * @param initial - Initial key-value pairs to populate the store
+     */
+    constructor(initial?: Record<string, unknown>);
+    /**
+     * Set a value with a descriptive key.
+     * @param key - A descriptive key for this value (e.g., "research_findings", "user_preferences")
+     * @param value - The value to store
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * Get a value by key.
+     * @param key - The key to retrieve
+     * @returns The value if found, undefined otherwise
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Check if a key exists in the store.
+     * @param key - The key to check
+     * @returns True if the key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a key from the store.
+     * @param key - The key to delete
+     * @returns True if the key was deleted, false if it didn't exist
+     */
+    delete(key: string): boolean;
+    /**
+     * Get all keys in the store.
+     * @returns Array of all keys
+     */
+    keys(): string[];
+    /**
+     * Get the number of entries in the store.
+     * @returns The number of entries
+     */
+    get size(): number;
+    /**
+     * Get all entries as a plain object.
+     * @returns Object with all key-value pairs
+     */
+    toObject(): Record<string, unknown>;
+    /**
+     * Clear all entries from the store.
+     */
+    clear(): void;
+    /**
+     * Create a clone of this context store.
+     * Note: This performs a shallow clone of values.
+     * @returns A new ContextStore with the same entries
+     */
+    clone(): ContextStore;
+}
+//# sourceMappingURL=ContextStore.d.ts.map