@agnt5/sdk 0.2.1

package/dist/agent.js

@@ -0,0 +1,493 @@
+/**
+ * Agent component for LLM-driven autonomous execution.
+ *
+ * Production ready with support for the new LM class and durable execution
+ */
+import { Tool } from './tool.js';
+import { ContextImpl } from './context.js';
+import { randomUUID } from 'crypto';
+import { agentStarted, agentCompleted, agentFailed, iterationStarted, iterationCompleted, toolCallStarted, toolCallCompleted, toolCallFailed, } from './events.js';
+/**
+ * Message role in conversation (for backwards compatibility)
+ * @deprecated Use MessageRole from lm.js instead
+ */
+export var MessageRole;
+(function (MessageRole) {
+    MessageRole["System"] = "system";
+    MessageRole["User"] = "user";
+    MessageRole["Assistant"] = "assistant";
+})(MessageRole || (MessageRole = {}));
+/**
+ * Message factory functions
+ */
+export const Message = {
+    system: (content) => ({ role: 'system', content }),
+    user: (content) => ({ role: 'user', content }),
+    assistant: (content) => ({ role: 'assistant', content })
+};
+/**
+ * Handoff configuration for agent-to-agent delegation
+ */
+export class Handoff {
+    constructor(agent, description, toolName, passFullHistory = true) {
+        this.agent = agent;
+        this.description = description || agent.instructions || `Transfer to ${agent.name}`;
+        this.toolName = toolName || `transfer_to_${agent.name}`;
+        this.passFullHistory = passFullHistory;
+    }
+}
+/**
+ * Create a handoff configuration for agent delegation
+ */
+export function handoff(agent, description, toolName, passFullHistory = true) {
+    return new Handoff(agent, description, toolName, passFullHistory);
+}
+/**
+ * Global registry for looking up agents by name.
+ *
+ * Provides discovery for multi-agent systems where agents need to find each
+ * other, and for the worker to enumerate registered agents.
+ *
+ * @example
+ * ```typescript
+ * const researcher = new Agent({ name: 'researcher', ... });
+ * // Agent is auto-registered in constructor
+ *
+ * // Look up later
+ * const found = AgentRegistry.get('researcher');
+ * ```
+ */
+export class AgentRegistry {
+    static register(agent) {
+        if (this.agents.has(agent.name)) {
+            console.warn(`Overwriting existing agent '${agent.name}'`);
+        }
+        this.agents.set(agent.name, agent);
+    }
+    static get(name) {
+        return this.agents.get(name);
+    }
+    static all() {
+        return new Map(this.agents);
+    }
+    static listNames() {
+        return Array.from(this.agents.keys());
+    }
+    static clear() {
+        this.agents.clear();
+    }
+}
+AgentRegistry.agents = new Map();
+/**
+ * Autonomous LLM-driven agent with tool orchestration
+ *
+ * @example
+ * ```typescript
+ * import { Agent, tool } from '@agnt5/sdk';
+ *
+ * const searchTool = tool('search_web', {
+ *   description: 'Search the web for information',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       query: { type: 'string', description: 'Search query' }
+ *     },
+ *     required: ['query']
+ *   }
+ * }, async (ctx, args) => {
+ *   const { query } = args;
+ *   // Search implementation
+ *   return [{ title: 'Result', url: '...' }];
+ * });
+ *
+ * const agent = new Agent({
+ *   name: 'researcher',
+ *   model: myLanguageModel,
+ *   instructions: 'You are a research assistant.',
+ *   tools: [searchTool]
+ * });
+ *
+ * const result = await agent.run('What are the latest AI trends?');
+ * console.log(result.output);
+ * ```
+ */
+export class Agent {
+    constructor(options) {
+        this.tools = new Map();
+        this.handoffs = [];
+        this.name = options.name;
+        this.model = options.model;
+        this.instructions = options.instructions;
+        this.modelName = options.modelName || 'openai/gpt-4o-mini';
+        this.temperature = options.temperature ?? 0.7;
+        this.maxIterations = options.maxIterations || 10;
+        // Detect if it's the new LM class (has static factory methods)
+        this.isNewLM = 'generate' in options.model && !('stream' in options.model.constructor);
+        // Build tool registry
+        if (options.tools) {
+            for (const t of options.tools) {
+                this.addTool(t);
+            }
+        }
+        // Register handoff targets
+        if (options.handoffs) {
+            for (const item of options.handoffs) {
+                const h = item instanceof Handoff ? item : new Handoff(item);
+                this.handoffs.push(h);
+                // Create and register the transfer tool
+                const transferTool = this.createHandoffTool(h);
+                this.tools.set(transferTool.name, transferTool);
+            }
+        }
+        // Auto-register in global registry
+        AgentRegistry.register(this);
+    }
+    /**
+     * Add a tool to this agent's tool set
+     */
+    addTool(t) {
+        if (t instanceof Tool) {
+            this.tools.set(t.name, t);
+        }
+        else if (t instanceof Agent) {
+            // Agent-as-tool: wrap the agent in a Tool that invokes its run() method
+            // so a coordinator can delegate to specialist agents by name. Mirrors
+            // sdk-python's pattern of passing Agent instances directly in tools.
+            const subAgent = t;
+            const wrapped = new Tool(subAgent.name, `Delegate a task to the ${subAgent.name} agent. Pass the task as the 'message' argument.`, async (ctx, args) => {
+                const message = args.message || args.prompt || JSON.stringify(args);
+                const result = await subAgent.run(message, ctx);
+                return result.output;
+            }, {
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        message: {
+                            type: 'string',
+                            description: 'The task or question to delegate to this agent',
+                        },
+                    },
+                    required: ['message'],
+                },
+            });
+            this.tools.set(subAgent.name, wrapped);
+        }
+        else if ('name' in t && 'getSchema' in t) {
+            this.tools.set(t.name, t);
+        }
+        else if ('_tool' in t) {
+            const toolInstance = t._tool;
+            this.tools.set(toolInstance.name, toolInstance);
+        }
+    }
+    /**
+     * Create an auto-generated transfer tool for a handoff target
+     */
+    createHandoffTool(h) {
+        const targetAgent = h.agent;
+        const passHistory = h.passFullHistory;
+        return new Tool(h.toolName, h.description, async (ctx, args) => {
+            const message = args.message || args.prompt || '';
+            // Run target agent to completion
+            const result = await targetAgent.run(message, ctx, passHistory ? ctx._agentConversation : undefined);
+            // Return with handoff marker
+            return {
+                _handoff: true,
+                to_agent: targetAgent.name,
+                output: result.output,
+                tool_calls: result.toolCalls,
+            };
+        }, {
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    message: { type: 'string', description: 'Message to send to the target agent' },
+                },
+                required: ['message'],
+            },
+        });
+    }
+    /**
+     * Convert ToolSchema to LM ToolDefinition
+     */
+    convertToolSchema(schema) {
+        return {
+            name: schema.name,
+            description: schema.description,
+            parameters: JSON.stringify(schema.input_schema),
+            strict: false,
+        };
+    }
+    /**
+     * Generate using the model (handles both old and new LM types)
+     */
+    async generateWithModel(messages, toolDefs) {
+        if (this.isNewLM) {
+            // New LM class - use new types
+            const lm = this.model;
+            const request = {
+                model: this.modelName,
+                systemPrompt: this.instructions,
+                messages: messages,
+                tools: toolDefs.length > 0 ? toolDefs.map(t => this.convertToolSchema(t)) : undefined,
+                config: {
+                    temperature: this.temperature,
+                },
+            };
+            const response = await lm.generate(request);
+            // Convert response to old format
+            return {
+                text: response.text,
+                usage: response.usage ? {
+                    promptTokens: response.usage.promptTokens || 0,
+                    completionTokens: response.usage.completionTokens || 0,
+                    totalTokens: response.usage.totalTokens || 0,
+                } : undefined,
+                finishReason: response.finishReason,
+                toolCalls: response.toolCalls,
+            };
+        }
+        else {
+            // Legacy LanguageModel - use old types
+            const legacyModel = this.model;
+            const request = {
+                model: this.modelName,
+                systemPrompt: this.instructions,
+                messages,
+                tools: toolDefs.length > 0 ? toolDefs : undefined,
+                config: {
+                    temperature: this.temperature,
+                },
+            };
+            return await legacyModel.generate(request);
+        }
+    }
+    /**
+     * Stream agent execution, yielding events at each stage.
+     *
+     * @example
+     * ```typescript
+     * for await (const event of agent.stream('Analyze tech news')) {
+     *   if (event.eventType === 'agent.completed') {
+     *     console.log('Done:', event.outputLength);
+     *   }
+     * }
+     * ```
+     */
+    async *stream(userMessage, context, history) {
+        const agentCorrelationId = randomUUID();
+        // Create context if not provided
+        const ctx = context || new ContextImpl(`agent-${this.name}-${Date.now()}`, `run-${Date.now()}`, 0, this.name);
+        // Stash conversation on context for handoff history passing
+        const messages = history ? [...history] : [];
+        messages.push(Message.user(userMessage));
+        ctx._agentConversation = messages;
+        const toolNames = Array.from(this.tools.keys());
+        const allToolCalls = [];
+        // ── AgentStarted ──
+        yield agentStarted(this.name, agentCorrelationId, {
+            agentModel: this.modelName,
+            toolNames,
+            maxIterations: this.maxIterations,
+        });
+        let completedIterations = 0;
+        try {
+            for (let iteration = 0; iteration < this.maxIterations; iteration++) {
+                const iterCorrelationId = randomUUID();
+                // ── IterationStarted ──
+                yield iterationStarted(iterCorrelationId, agentCorrelationId, {
+                    iteration: iteration + 1,
+                    maxIterations: this.maxIterations,
+                });
+                // Build tool definitions and call LLM
+                const toolDefs = Array.from(this.tools.values()).map(t => t.getSchema());
+                const response = await this.generateWithModel(messages, toolDefs);
+                messages.push(Message.assistant(response.text));
+                if (response.toolCalls && response.toolCalls.length > 0) {
+                    // Execute tool calls
+                    const toolResults = [];
+                    for (const tc of response.toolCalls) {
+                        const tcId = randomUUID();
+                        const toolName = tc.name;
+                        const toolArgsStr = tc.arguments;
+                        allToolCalls.push({ name: toolName, arguments: toolArgsStr, iteration: iteration + 1 });
+                        // ── ToolCallStarted ──
+                        yield toolCallStarted(tcId, iterCorrelationId, { toolName, toolCallId: tcId });
+                        try {
+                            const toolArgs = JSON.parse(toolArgsStr);
+                            const tool = this.tools.get(toolName);
+                            if (!tool) {
+                                yield toolCallFailed(tcId, iterCorrelationId, {
+                                    toolName,
+                                    toolCallId: tcId,
+                                    error: `Tool '${toolName}' not found`,
+                                });
+                                toolResults.push({ tool: toolName, result: null, error: `Tool '${toolName}' not found` });
+                                continue;
+                            }
+                            const result = await tool.invoke(ctx, toolArgs);
+                            // ── Handoff detection ──
+                            if (result && typeof result === 'object' && result._handoff) {
+                                yield toolCallCompleted(tcId, iterCorrelationId, { toolName, toolCallId: tcId });
+                                completedIterations = iteration + 1;
+                                const handoffResult = {
+                                    output: result.output,
+                                    toolCalls: [...allToolCalls, ...(result.tool_calls || [])],
+                                    context: ctx,
+                                    handoffTo: result.to_agent,
+                                    handoffMetadata: result,
+                                };
+                                // ── AgentCompleted (with handoff) ──
+                                yield agentCompleted(this.name, agentCorrelationId, {
+                                    iterations: completedIterations,
+                                    toolCallsCount: allToolCalls.length,
+                                    handoffTo: result.to_agent,
+                                    outputLength: handoffResult.output.length,
+                                });
+                                yield handoffResult;
+                                return;
+                            }
+                            const resultText = JSON.stringify(result);
+                            yield toolCallCompleted(tcId, iterCorrelationId, { toolName, toolCallId: tcId });
+                            toolResults.push({ tool: toolName, result: resultText, error: null });
+                        }
+                        catch (error) {
+                            // HITL: WaitingForUserInputError must propagate to pause the
+                            // workflow — do NOT treat it as a tool failure or the LLM will
+                            // retry the tool in the next iteration.
+                            if (error?.name === 'WaitingForUserInputError') {
+                                throw error;
+                            }
+                            yield toolCallFailed(tcId, iterCorrelationId, {
+                                toolName,
+                                toolCallId: tcId,
+                                error: String(error),
+                            });
+                            toolResults.push({ tool: toolName, result: null, error: String(error) });
+                        }
+                    }
+                    // Add tool results to conversation
+                    const resultsText = toolResults
+                        .map(tr => tr.error ? `Tool: ${tr.tool}\nError: ${tr.error}` : `Tool: ${tr.tool}\nResult: ${tr.result}`)
+                        .join('\n\n');
+                    messages.push(Message.user(`Tool results:\n${resultsText}`));
+                    // ── IterationCompleted (with tools) ──
+                    yield iterationCompleted(iterCorrelationId, agentCorrelationId, {
+                        iteration: iteration + 1,
+                        hasToolCalls: true,
+                        toolCallsCount: response.toolCalls.length,
+                    });
+                    completedIterations = iteration + 1;
+                }
+                else {
+                    // No tool calls — agent is done
+                    completedIterations = iteration + 1;
+                    // ── IterationCompleted (final) ──
+                    yield iterationCompleted(iterCorrelationId, agentCorrelationId, {
+                        iteration: iteration + 1,
+                        hasToolCalls: false,
+                        toolCallsCount: 0,
+                    });
+                    // ── AgentCompleted ──
+                    yield agentCompleted(this.name, agentCorrelationId, {
+                        iterations: completedIterations,
+                        toolCallsCount: allToolCalls.length,
+                        handoffTo: null,
+                        outputLength: response.text.length,
+                    });
+                    yield {
+                        output: response.text,
+                        toolCalls: allToolCalls,
+                        context: ctx,
+                        handoffTo: null,
+                        handoffMetadata: {},
+                    };
+                    return;
+                }
+            }
+            // Max iterations reached
+            completedIterations = this.maxIterations;
+            const finalOutput = messages[messages.length - 1]?.content || 'No output generated';
+            yield agentCompleted(this.name, agentCorrelationId, {
+                iterations: completedIterations,
+                toolCallsCount: allToolCalls.length,
+                handoffTo: null,
+                outputLength: finalOutput.length,
+            });
+            yield {
+                output: finalOutput,
+                toolCalls: allToolCalls,
+                context: ctx,
+                handoffTo: null,
+                handoffMetadata: {},
+            };
+        }
+        catch (error) {
+            yield agentFailed(this.name, agentCorrelationId, {
+                iterations: completedIterations,
+                error: String(error),
+            });
+            throw error;
+        }
+    }
+    /**
+     * Run agent to completion (non-streaming).
+     * Consumes stream() internally and returns the final AgentResult.
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.run('Analyze recent tech news');
+     * console.log(result.output);
+     * ```
+     */
+    async run(userMessage, context, history) {
+        let result;
+        for await (const event of this.stream(userMessage, context, history)) {
+            // The last yielded value that has 'output' is the AgentResult
+            if ('output' in event && 'toolCalls' in event && 'context' in event) {
+                result = event;
+                continue;
+            }
+            // Forward lifecycle events (agent.started/completed/failed, iteration.*,
+            // tool_call.started/completed/failed, output.*) to the platform via the
+            // provided context emitter. Without this, agent.run() called from inside
+            // a function or workflow handler silently swallows every tool-level
+            // event and downstream projections/tests can't see them.
+            if (context) {
+                try {
+                    await context.emit(event);
+                }
+                catch {
+                    // Best effort — emission failures should not break the agent
+                }
+            }
+        }
+        if (!result) {
+            throw new Error(`Agent '${this.name}' completed without producing a result`);
+        }
+        return result;
+    }
+    /**
+     * Continue multi-turn conversation
+     *
+     * @example
+     * ```typescript
+     * let messages: Message[] = [];
+     * let response: string;
+     *
+     * [response, messages] = await agent.chat('Hello', messages);
+     * [response, messages] = await agent.chat('Tell me more', messages);
+     * ```
+     */
+    async chat(userMessage, messages, context) {
+        const ctx = context || new ContextImpl(`agent-chat-${this.name}-${Date.now()}`, `run-${Date.now()}`, 0, this.name);
+        // Add user message
+        const conversation = [...messages, Message.user(userMessage)];
+        // Call LLM (no tools for simple chat, using helper)
+        const response = await this.generateWithModel(conversation, []);
+        // Add assistant response
+        conversation.push(Message.assistant(response.text));
+        return [response.text, conversation];
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/async-context.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Context propagation via Node.js AsyncLocalStorage.
+ *
+ * Provides implicit context propagation through async call chains
+ * without threading context through every function parameter.
+ *
+ * Usage:
+ *   // In worker dispatch or middleware:
+ *   runWithContext({ runId, sessionId, userId, correlationId }, async () => {
+ *     // Deep inside a function/agent/workflow:
+ *     const ctx = getCurrentContext();
+ *     console.log(ctx?.runId);
+ *   });
+ */
+/**
+ * Propagated context data available throughout an async execution chain.
+ */
+export interface PropagatedContext {
+    /** Current run ID */
+    runId: string;
+    /** Session ID for multi-turn conversations */
+    sessionId?: string;
+    /** User ID for user-scoped operations */
+    userId?: string;
+    /** Correlation ID for distributed tracing */
+    correlationId?: string;
+    /** Tenant ID for multi-tenant deployments */
+    tenantId?: string;
+    /** Arbitrary metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Run a function with propagated context.
+ * All async operations within the callback can access this context
+ * via getCurrentContext().
+ *
+ * @example
+ * ```typescript
+ * await runWithContext(
+ *   { runId: 'run-1', sessionId: 'sess-1', userId: 'user-42' },
+ *   async () => {
+ *     const ctx = getCurrentContext();
+ *     console.log(ctx?.runId); // 'run-1'
+ *   },
+ * );
+ * ```
+ */
+export declare function runWithContext<T>(context: PropagatedContext, fn: () => T | Promise<T>): T | Promise<T>;
+/**
+ * Get the current propagated context, or undefined if not within a context scope.
+ */
+export declare function getCurrentContext(): PropagatedContext | undefined;
+/**
+ * Get the current propagated context, throwing if not within a context scope.
+ */
+export declare function requireContext(): PropagatedContext;
+//# sourceMappingURL=async-context.d.ts.map

package/dist/async-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.d.ts","sourceRoot":"","sources":["../src/async-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,iBAAiB,EAC1B,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,GAAG,SAAS,CAEjE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAQlD"}

package/dist/async-context.js

@@ -0,0 +1,52 @@
+/**
+ * Context propagation via Node.js AsyncLocalStorage.
+ *
+ * Provides implicit context propagation through async call chains
+ * without threading context through every function parameter.
+ *
+ * Usage:
+ *   // In worker dispatch or middleware:
+ *   runWithContext({ runId, sessionId, userId, correlationId }, async () => {
+ *     // Deep inside a function/agent/workflow:
+ *     const ctx = getCurrentContext();
+ *     console.log(ctx?.runId);
+ *   });
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+const asyncLocalStorage = new AsyncLocalStorage();
+/**
+ * Run a function with propagated context.
+ * All async operations within the callback can access this context
+ * via getCurrentContext().
+ *
+ * @example
+ * ```typescript
+ * await runWithContext(
+ *   { runId: 'run-1', sessionId: 'sess-1', userId: 'user-42' },
+ *   async () => {
+ *     const ctx = getCurrentContext();
+ *     console.log(ctx?.runId); // 'run-1'
+ *   },
+ * );
+ * ```
+ */
+export function runWithContext(context, fn) {
+    return asyncLocalStorage.run(context, fn);
+}
+/**
+ * Get the current propagated context, or undefined if not within a context scope.
+ */
+export function getCurrentContext() {
+    return asyncLocalStorage.getStore();
+}
+/**
+ * Get the current propagated context, throwing if not within a context scope.
+ */
+export function requireContext() {
+    const ctx = asyncLocalStorage.getStore();
+    if (!ctx) {
+        throw new Error('No propagated context available. Ensure this code runs inside runWithContext().');
+    }
+    return ctx;
+}
+//# sourceMappingURL=async-context.js.map

package/dist/async-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.js","sourceRoot":"","sources":["../src/async-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBhD,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAqB,CAAC;AAErE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA0B,EAC1B,EAAwB;IAExB,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,CAAC,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}