@ellyco/agentic 0.1.1 → 0.2.0

package/README.md

@@ -17,7 +17,7 @@ A powerful TypeScript framework for building stateful, agentic workflows with bu
 ## Installation
 
 ```bash
-npm install ellyco-agentic
+npm install @ellyco/agentic
 ```
 
 ### Dependencies
@@ -31,7 +31,7 @@ npm install ellyco-agentic
 ### 1. Define Your Messages
 
 ```typescript
-import { SystemMessage, UserMessage, AgentMessage } from 'ellyco-agentic';
+import { SystemMessage, UserMessage, AgentMessage } from '@ellyco/agentic';
 
 const systemMsg = new SystemMessage(
   "You are a helpful assistant that processes data."
@@ -46,7 +46,7 @@ userMsg.interpolate({ data: "important info" });
 ### 2. Define Your Tools
 
 ```typescript
-import { defineTool, tool } from 'ellyco-agentic';
+import { defineTool, tool } from '@ellyco/agentic';
 import { z } from 'zod';
 
 const searchTool = defineTool(
@@ -70,7 +70,7 @@ const searchImplementation = tool(
 ### 3. Configure Your Model
 
 ```typescript
-import { BedrockModel } from 'ellyco-agentic';
+import { BedrockModel } from '@ellyco/agentic';
 
 const model = new BedrockModel({
   modelId: "anthropic.claude-3-sonnet-20240229-v1:0",
@@ -86,7 +86,7 @@ const response = await model.invoke([userMsg]);
 ### 4. Build a Graph
 
 ```typescript
-import { StateMachine, makeNode } from 'ellyco-agentic';
+import { StateMachine, makeNode } from '@ellyco/agentic';
 import { z } from 'zod';
 
 const schema = z.object({
@@ -138,7 +138,7 @@ sm.addNode("path2", path2Node);
 // Conditional edge - route based on state
 sm.addConditionalEdge(
   "decision",
-  ["path1", "path2", "end"],
+  ["path1", "path2"],
   (state) => state.priority > 5 ? "path1" : "path2"
 );
 ```
@@ -162,7 +162,7 @@ const schema = z.object({
   items: z.array(z.object({ value: z.number() }))
 });
 
-const iterator = new Iterator(schema, "item", "items");
+const iterator = new Iterator(schema, "items", "item");
 iterator.setLoopedNode(loopedNode);
 
 const result = await iterator.invoke({ 
@@ -178,7 +178,7 @@ Nodes are the building blocks of graphs - they execute logic and return partial
 Simple synchronous or asynchronous functions.
 
 ```typescript
-import { makeNode } from 'ellyco-agentic';
+import { makeNode } from '@ellyco/agentic';
 
 const node = makeNode((state, context) => ({
   processed: true,
@@ -212,7 +212,7 @@ const confirmNode = new InterruptNode(
 Messages represent communication in the system with different roles:
 
 ```typescript
-import { SystemMessage, UserMessage, AgentMessage } from 'ellyco-agentic';
+import { SystemMessage, UserMessage, AgentMessage } from '@ellyco/agentic';
 
 // System messages set context
 const system = new SystemMessage("You are a data analyst");
@@ -227,43 +227,74 @@ const agent = new AgentMessage("The analysis shows...");
 
 ### Tool Usage
 
-Tools enable models to request external operations:
+Tools enable models to request external operations. Define tools and attach them to models:
 
 ```typescript
-import { ToolRequest, ToolResponse, ToolError } from 'ellyco-agentic';
-
-// Model requests a tool
-const request = new ToolRequest(
-  "call_123",
-  "search",
-  { query: "latest news" }
-);
+import { defineTool } from '@ellyco/agentic';
+import { z } from 'zod';
 
-// Tool execution succeeds
-const response = new ToolResponse(
-  "call_123",
-  "search",
-  { results: [...] }
+// Define a tool with input schema
+const weatherTool = defineTool(
+  "get_weather",
+  "Get current weather for a location",
+  z.object({
+    location: z.string(),
+    unit: z.enum(["celsius", "fahrenheit"]).optional()
+  })
 );
 
-// Or fails
-const error = new ToolError(
-  "call_123",
-  "search",
-  "API rate limit exceeded"
-);
+// Attach tool to model
+const model = new BedrockModel({ modelId: "..." })
+  .withTools([weatherTool]);
+
+// When you invoke the model, it can request tool usage
+// The model's response will include ToolRequest messages that you can handle
+const response = await model.invoke([
+  new UserMessage("What's the weather in San Francisco?")
+]);
+
+// Check for tool requests in the response
+for (const message of response.messages) {
+  if (message instanceof ToolRequest) {
+    // Execute the tool based on message.name and message.input
+    // Then add ToolResponse or ToolError back to the conversation
+  }
+}
 ```
 
 ### State Management
 
-State flows through graphs, with each node returning partial updates that are merged using the schema:
+State flows through graphs, with each node returning partial updates that are automatically merged:
 
 ```typescript
-const base = { count: 5, items: [1, 2, 3] };
-const changes = { count: 10, items: [4, 5] };
+const schema = z.object({
+  count: z.number(),
+  items: z.array(z.string()),
+  status: z.string().optional()
+});
+
+const graph = new StateMachine(schema);
+
+// Node 1: Sets initial values
+graph.addNode("init", makeNode((state) => ({
+  count: 0,
+  items: ["a", "b"]
+})));
+
+// Node 2: Updates count and adds items
+graph.addNode("update", makeNode((state) => ({
+  count: state.count + 1,
+  items: [...state.items, "c"]
+})));
+
+// Node 3: Sets status
+graph.addNode("finalize", makeNode((state) => ({
+  status: `Processed ${state.count} items`
+})));
 
-// Merged state
-const merged = { count: 10, items: [4, 5] };
+// State evolves: {count: 0, items: ["a","b"]} 
+//            → {count: 1, items: ["a","b","c"]} 
+//            → {count: 1, items: ["a","b","c"], status: "Processed 1 items"}
 ```
 
 ## Advanced Features
@@ -296,7 +327,7 @@ if (result.exitReason === "interrupt") {
 Use SQLite to persist and resume runs across sessions:
 
 ```typescript
-import { SQLiteStore } from 'ellyco-agentic';
+import { SQLiteStore } from '@ellyco/agentic';
 import Database from 'better-sqlite3';
 
 // Setup database
@@ -309,7 +340,7 @@ let result = await graph.invoke(initialState, { store });
 if (result.exitReason === "interrupt") {
   // Later, in a different process:
   const db2 = new Database("runs.db");
-  const store2 = new SQLiteStore(db2);
+  const store2 = new SQLiteStore(db2, "graph_runs");
   
   // Resume from stored checkpoint
   const result2 = await graph.invoke(result.state, {
@@ -345,10 +376,15 @@ console.log(result.explanation);   // string
 
 ### Custom Models
 
-Implement your own model provider:
+Implement your own model provider by extending `BaseModel`:
 
 ```typescript
-import { BaseModel, InvokeResponse, ModelMessages } from 'ellyco-agentic';
+import { 
+  BaseModel, 
+  InvokeResponse, 
+  InvokeResponseStopReason,
+  ModelMessages 
+} from '@ellyco/agentic';
 
 class MyCustomModel extends BaseModel {
   protected async runModel(
@@ -360,15 +396,22 @@ class MyCustomModel extends BaseModel {
       body: JSON.stringify({ messages })
     });
     
+    const data = await response.json();
+    
     return {
-      messages: [...],
-      usage: { inputTokens: 100, outputTokens: 50 },
+      messages: data.messages, // Array of AgentMessage or ToolRequest
+      usage: { 
+        inputTokens: data.usage.inputTokens, 
+        outputTokens: data.usage.outputTokens 
+      },
       stopReason: InvokeResponseStopReason.END_TURN
     };
   }
 }
 
-const model = new MyCustomModel({ temperature: 0.7 });
+const model = new MyCustomModel({ temperature: 0.7 })
+  .withSystemMessage("You are helpful")
+  .withTools([myTool]);
 ```
 
 ### Testing with TestModel
@@ -376,7 +419,7 @@ const model = new MyCustomModel({ temperature: 0.7 });
 Use the mock model for testing without hitting real APIs:
 
 ```typescript
-import { TestModel, TestResponseConfig } from 'ellyco-agentic';
+import { TestModel, TestResponseConfig } from '@ellyco/agentic';
 
 const testModel = new TestModel({ temperature: 0.7 });
 
@@ -487,27 +530,6 @@ const exporter = new OTLPTraceExporter({
 provider.addSpanProcessor(new BatchSpanProcessor(exporter));
 ```
 
-#### Tracing Nested Graphs
-
-When graphs call other graphs, context layers create a hierarchical span structure:
-
-```typescript
-// Parent graph
-const parentGraph = new StateMachine(parentSchema);
-parentGraph.addNode("delegate", new FunctionNode(async (state) => {
-  // Calling a subgraph
-  return await subGraph.run(state, context);
-}));
-
-// Traces show hierarchy:
-// ├─ run-id: run-abc123
-// │  ├─ process (layerId: ROOT)
-// │  ├─ delegate (layerId: ROOT.delegate)
-// │  │  ├─ subprocess (layerId: ROOT.delegate.subprocess)
-// │  │  └─ validate (layerId: ROOT.delegate.validate)
-// │  └─ finalize (layerId: ROOT)
-```
-
 #### Debugging with Traces
 
 Traces are invaluable for:
@@ -516,102 +538,43 @@ Traces are invaluable for:
 - **Error investigation** - Track state at each step before failure
 - **Production monitoring** - Monitor graph executions in real-time
 
-```typescript
-// Example: Find slow nodes
-const traces = await exporter.getTraces();
-traces.forEach(span => {
-  const duration = span.endTime - span.startTime;
-  if (duration > 5000) {
-    console.warn(`Slow node: ${span.attributes.nodeName} took ${duration}ms`);
-  }
-});
-```
-
-## Architecture
-
-### Execution Flow
-
-```
-Graph.invoke()
-  ↓
-Create RuntimeContext
-  ↓
-Loop:
-  - Get current node
-  - Execute node.run(state, context)
-  - Merge returned state
-  - Check for interrupts
-  - Transition to next node
-  ↓
-Return result (end or interrupt)
-```
-
-### State Transformation
-
-```
-Graph State
-    ↓
-stateToNodeState() ← Node gets specific state type
-    ↓
-Node.run() ← Node executes
-    ↓
-nodeStateToState() ← Convert back to graph state
-    ↓
-mergeState() ← Merge with existing state
-    ↓
-Updated Graph State
-```
-
-### Context Layers
-
-Nested graphs create a stack of context layers for tracking execution position:
-
-```typescript
-RuntimeContext
-  └─ ContextLayer 0 (root)
-     ├─ currentNode: "node1"
-     ├─ custom: { ... }
-     └─ ContextLayer 1 (nested graph)
-        ├─ currentNode: "subnode"
-        └─ custom: { ... }
-```
+When graphs call other graphs (nested execution), traces automatically show the hierarchical structure with layer IDs, making it easy to understand the execution flow.
 
 ## API Reference
 
+This is a high-level overview. For detailed API documentation, see the JSDoc comments in the source code.
+
 ### Graph Classes
 
-- **`Graph<Z, S, NS>`** - Abstract base class for all graphs
 - **`StateMachine<T, S>`** - Flexible graph with manual node/edge definition
 - **`NodeSequence<T, S>`** - Linear graph executing nodes in sequence
 - **`Iterator<Item, T, Prefix, S, NS>`** - Loop over array items
 
 ### Node Classes
 
-- **`FunctionNode<T>`** - Execute a function
-- **`ModelNode<T>`** - Invoke an AI model
-- **`InterruptNode<T>`** - Pause execution
+- **`FunctionNode<T>`** - Execute a function (or use `makeNode()` helper)
+- **`ModelNode<T>`** - Invoke an AI model and store response in state
+- **`InterruptNode<T>`** - Pause execution for external input
 
 ### Message Classes
 
-- **`BaseMessage`** - Abstract message base
 - **`SystemMessage`** - System context message
-- **`UserMessage`** - User request message
+- **`UserMessage`** - User request message (supports template interpolation)
 - **`AgentMessage`** - Agent response message
-- **`ToolRequest<T>`** - Tool invocation request
+- **`ToolRequest<T>`** - Tool invocation request from models
 - **`ToolResponse<T>`** - Tool execution result
 - **`ToolError`** - Tool execution error
 
 ### Model Classes
 
-- **`BaseModel`** - Abstract model base class
+- **`BaseModel`** - Abstract base class for custom model implementations
 - **`BedrockModel`** - AWS Bedrock integration
 - **`TestModel`** - Mock model for testing
 
 ### Storage Classes
 
-- **`BaseStore`** - Abstract store interface
-- **`SQLiteStore`** - SQLite-based persistence
-- **`StoredRun`** - Single run checkpoint wrapper
+- **`SQLiteStore`** - SQLite-based persistence for checkpoints
+- **`StoredRun`** - Wrapper for interacting with a specific run's stored state
 
 ## Complete Example
 
@@ -626,9 +589,8 @@ import {
   UserMessage,
   SystemMessage,
   SQLiteStore,
-  defineTool,
-  tool
-} from 'ellyco-agentic';
+  defineTool
+} from '@ellyco/agentic';
 import { z } from 'zod';
 import Database from 'better-sqlite3';
 

package/dist/graphs/graph.d.ts.map

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

package/dist/graphs/graph.js

@@ -3,9 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Graph = exports.DerivedSchemaConstructor = exports.END = exports.START = void 0;
 const runtime_context_1 = require("./runtime-context");
 const cuid2_1 = require("@paralleldrive/cuid2");
-const merge_state_1 = require("./merge-state");
+const zod_1 = require("zod");
+const merge_state_1 = require("../util/merge-state");
 const api_1 = require("@opentelemetry/api");
-const tracer = api_1.trace.getTracer("@ellyco/agentic", "0.1.1");
+const util_1 = require("../util");
+const tracer = api_1.trace.getTracer("@ellyco/agentic", "0.2.0");
 /**
  * Special node name indicating the start of graph execution
  */
@@ -153,22 +155,29 @@ class Graph {
                 layerId: context.id,
             }
         }, async (span) => {
-            const inputNodeState = this.stateToNodeState(structuredClone(state), context);
-            const result = await node.run(structuredClone(inputNodeState), context);
-            if (Object.keys(result).length === 0) {
+            try {
+                const inputNodeState = this.stateToNodeState(state, context);
+                const result = await node.run((0, util_1.cloneAware)(inputNodeState), context);
+                if (Object.keys(result).length === 0) {
+                    span.setAttributes({
+                        changes: JSON.stringify({}),
+                        newState: JSON.stringify(state),
+                    });
+                    return state;
+                }
+                const changes = this.nodeStateToState(result, context);
+                const mergedState = this.mergeState(state, changes);
                 span.setAttributes({
-                    changes: JSON.stringify({}),
-                    newState: JSON.stringify(state),
+                    changes: JSON.stringify(changes),
+                    newState: JSON.stringify(mergedState),
                 });
-                return state;
+                return mergedState;
+            }
+            catch (error) {
+                console.error(`Exception encountered at node ${context.id}.${currentNode}`);
+                span.recordException(error);
+                throw error;
             }
-            const changes = this.nodeStateToState(result, context);
-            const mergedState = this.mergeState(state, changes);
-            span.setAttributes({
-                changes: JSON.stringify(changes),
-                newState: JSON.stringify(mergedState),
-            });
-            return mergedState;
         });
     }
     /**
@@ -206,7 +215,7 @@ class Graph {
      * @returns {Promise<Partial<S>>} Final state changes
      */
     async runInternal(input, context) {
-        let state = structuredClone(input);
+        let state = (0, util_1.cloneAware)(input);
         let shouldContinue = true;
         while (shouldContinue) {
             const currentNode = context.currentNode;
@@ -220,7 +229,7 @@ class Graph {
                 this.transition(input, context);
                 continue;
             }
-            state = { ...state, ...(await this.step(structuredClone(state), context)) };
+            state = { ...state, ...(await this.step(state, context)) };
             if (context.runtime.interrupted) {
                 shouldContinue = false;
                 break;
@@ -299,30 +308,38 @@ class Graph {
                 mergedState = this.mergeState(mergedState, load.state);
                 runtime.unwrapCursor(load.cursor);
             }
-            const state = this.schema.parse(mergedState);
-            const result = await this.run(state, runtime);
-            const finalState = { ...state, ...result };
-            if (runtime.interrupted) {
-                await storedRun.save(runtime.wrapCursor(), finalState);
+            try {
+                const state = this.schema.parse(mergedState);
+                const result = await this.run(state, runtime);
+                const finalState = { ...state, ...result };
+                if (runtime.interrupted) {
+                    await storedRun.save(runtime.wrapCursor(), finalState);
+                    return {
+                        runId,
+                        state: finalState,
+                        exitReason: "interrupt",
+                        exitMessage: runtime.exitMessage,
+                        cursor: runtime.wrapCursor(),
+                    };
+                }
+                if (config?.deleteAfterEnd) {
+                    await storedRun.delete();
+                }
+                else {
+                    await storedRun.save(exports.END, finalState);
+                }
                 return {
                     runId,
                     state: finalState,
-                    exitReason: "interrupt",
-                    exitMessage: runtime.exitMessage,
-                    cursor: runtime.wrapCursor(),
+                    exitReason: "end",
                 };
             }
-            if (config?.deleteAfterEnd) {
-                await storedRun.delete();
-            }
-            else {
-                await storedRun.save(exports.END, finalState);
+            catch (error) {
+                if (error instanceof zod_1.z.ZodError) {
+                    throw new Error(`Input does not match schema: ${error.message}`);
+                }
+                throw error;
             }
-            return {
-                runId,
-                state: finalState,
-                exitReason: "end",
-            };
         }
         else {
             const fullInput = input;
@@ -330,23 +347,31 @@ class Graph {
             if (config?.resumeFrom) {
                 runtime.unwrapCursor(config.resumeFrom);
             }
-            const state = this.schema.parse(fullInput);
-            const result = await this.run(state, runtime);
-            const finalState = { ...state, ...result };
-            if (runtime.interrupted) {
+            try {
+                const state = this.schema.parse(fullInput);
+                const result = await this.run(state, runtime);
+                const finalState = { ...state, ...result };
+                if (runtime.interrupted) {
+                    return {
+                        runId,
+                        state: finalState,
+                        exitReason: "interrupt",
+                        exitMessage: runtime.exitMessage,
+                        cursor: runtime.wrapCursor(),
+                    };
+                }
                 return {
                     runId,
                     state: finalState,
-                    exitReason: "interrupt",
-                    exitMessage: runtime.exitMessage,
-                    cursor: runtime.wrapCursor(),
+                    exitReason: "end",
                 };
             }
-            return {
-                runId,
-                state: finalState,
-                exitReason: "end",
-            };
+            catch (error) {
+                if (error instanceof zod_1.z.ZodError) {
+                    throw new Error(`Input does not match schema: ${error.message}`);
+                }
+                throw error;
+            }
         }
     }
 }

package/dist/graphs/graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/graphs/graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/graphs/graph.ts"],"names":[],"mappings":"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"}

package/dist/graphs/index.d.ts

@@ -1,7 +1,9 @@
-export { StateMachine } from "./state-machine";
-export { type GraphResult } from "./types";
-export { NodeSequence } from "./node-sequence";
-export { Iterator } from "./iterator";
-export { RuntimeContext, ContextLayer } from "./runtime-context";
-export { STATE_MERGE } from "./registry";
+export * from "./store";
+export * from "./graph";
+export * from "./iterator";
+export * from "./node-sequence";
+export * from "./registry";
+export * from "./runtime-context";
+export * from "./state-machine";
+export * from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/graphs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphs/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}