@xynehq/jaf 0.1.2

package/dist/core/tool-results.js

@@ -0,0 +1,133 @@
+// Common error codes
+export const ToolErrorCodes = {
+    // Validation errors
+    INVALID_INPUT: 'INVALID_INPUT',
+    MISSING_REQUIRED_FIELD: 'MISSING_REQUIRED_FIELD',
+    INVALID_FORMAT: 'INVALID_FORMAT',
+    // Permission errors  
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    INSUFFICIENT_PERMISSIONS: 'INSUFFICIENT_PERMISSIONS',
+    // Resource errors
+    NOT_FOUND: 'NOT_FOUND',
+    RESOURCE_UNAVAILABLE: 'RESOURCE_UNAVAILABLE',
+    // Execution errors
+    EXECUTION_FAILED: 'EXECUTION_FAILED',
+    TIMEOUT: 'TIMEOUT',
+    EXTERNAL_SERVICE_ERROR: 'EXTERNAL_SERVICE_ERROR',
+    // Generic
+    UNKNOWN_ERROR: 'UNKNOWN_ERROR'
+};
+/**
+ * Helper functions for creating standardized tool results
+ */
+export class ToolResponse {
+    static success(data, metadata) {
+        return {
+            status: 'success',
+            data,
+            metadata
+        };
+    }
+    static error(code, message, details, metadata) {
+        return {
+            status: 'error',
+            error: {
+                code,
+                message,
+                details
+            },
+            metadata
+        };
+    }
+    static validationError(message, details, metadata) {
+        return {
+            status: 'validation_error',
+            error: {
+                code: ToolErrorCodes.INVALID_INPUT,
+                message,
+                details
+            },
+            metadata
+        };
+    }
+    static permissionDenied(message, requiredPermissions, metadata) {
+        return {
+            status: 'permission_denied',
+            error: {
+                code: ToolErrorCodes.PERMISSION_DENIED,
+                message,
+                details: { requiredPermissions }
+            },
+            metadata
+        };
+    }
+    static notFound(resource, identifier, metadata) {
+        return {
+            status: 'not_found',
+            error: {
+                code: ToolErrorCodes.NOT_FOUND,
+                message: `${resource} not found${identifier ? `: ${identifier}` : ''}`,
+                details: { resource, identifier }
+            },
+            metadata
+        };
+    }
+}
+/**
+ * Tool execution wrapper that provides standardized error handling
+ */
+export function withErrorHandling(toolName, executor) {
+    return async (args, context) => {
+        const startTime = Date.now();
+        try {
+            console.log(`[TOOL:${toolName}] Starting execution with args:`, args);
+            const result = await executor(args, context);
+            const executionTime = Date.now() - startTime;
+            console.log(`[TOOL:${toolName}] Completed successfully in ${executionTime}ms`);
+            return ToolResponse.success(result, {
+                executionTimeMs: executionTime,
+                toolName
+            });
+        }
+        catch (error) {
+            const executionTime = Date.now() - startTime;
+            console.error(`[TOOL:${toolName}] Failed after ${executionTime}ms:`, error);
+            if (error instanceof Error) {
+                return ToolResponse.error(ToolErrorCodes.EXECUTION_FAILED, error.message, { stack: error.stack }, { executionTimeMs: executionTime, toolName });
+            }
+            return ToolResponse.error(ToolErrorCodes.UNKNOWN_ERROR, 'Unknown error occurred', error, { executionTimeMs: executionTime, toolName });
+        }
+    };
+}
+/**
+ * Permission checking helper
+ */
+export function requirePermissions(requiredPermissions) {
+    return (context) => {
+        const userPermissions = context.permissions || [];
+        const missingPermissions = requiredPermissions.filter(perm => !userPermissions.includes(perm));
+        if (missingPermissions.length > 0) {
+            return ToolResponse.permissionDenied(`Missing required permissions: ${missingPermissions.join(', ')}`, requiredPermissions);
+        }
+        return null; // No error
+    };
+}
+/**
+ * Convert ToolResult to string for backward compatibility with existing tools
+ */
+export function toolResultToString(result) {
+    if (result.status === 'success') {
+        return typeof result.data === 'string' ? result.data : JSON.stringify(result.data);
+    }
+    // For errors, return a structured error message
+    const error = result.error;
+    const errorObj = {
+        error: result.status,
+        code: error.code,
+        message: error.message,
+        ...(error.details && { details: error.details }),
+        ...(result.metadata && { metadata: result.metadata })
+    };
+    return JSON.stringify(errorObj, null, 2);
+}
+//# sourceMappingURL=tool-results.js.map

package/dist/core/tool-results.js.map

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

package/dist/core/tracing.d.ts

@@ -0,0 +1,32 @@
+import { TraceEvent, TraceId } from './types.js';
+export interface TraceCollector {
+    collect(event: TraceEvent): void;
+    getTrace(traceId: TraceId): TraceEvent[];
+    getAllTraces(): Map<TraceId, TraceEvent[]>;
+    clear(traceId?: TraceId): void;
+}
+export declare class InMemoryTraceCollector implements TraceCollector {
+    private traces;
+    collect(event: TraceEvent): void;
+    getTrace(traceId: TraceId): TraceEvent[];
+    getAllTraces(): Map<TraceId, TraceEvent[]>;
+    clear(traceId?: TraceId): void;
+}
+export declare class ConsoleTraceCollector implements TraceCollector {
+    private inMemory;
+    collect(event: TraceEvent): void;
+    getTrace(traceId: TraceId): TraceEvent[];
+    getAllTraces(): Map<TraceId, TraceEvent[]>;
+    clear(traceId?: TraceId): void;
+}
+export declare class FileTraceCollector implements TraceCollector {
+    private filePath;
+    private inMemory;
+    constructor(filePath: string);
+    collect(event: TraceEvent): void;
+    getTrace(traceId: TraceId): TraceEvent[];
+    getAllTraces(): Map<TraceId, TraceEvent[]>;
+    clear(traceId?: TraceId): void;
+}
+export declare function createCompositeTraceCollector(...collectors: TraceCollector[]): TraceCollector;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/core/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/core/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAS,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE,CAAC;IACzC,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AAED,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,MAAM,CAAoC;IAElD,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAmBhC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE;IAIxC,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAI1C,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;CAO/B;AAED,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAgC;IAEhD,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAyChC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE;IAIxC,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAI1C,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;CAG/B;AAED,qBAAa,kBAAmB,YAAW,cAAc;IAG3C,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,QAAQ,CAAgC;gBAE5B,QAAQ,EAAE,MAAM;IAEpC,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAiBhC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE;IAIxC,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAI1C,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;CAG/B;AAED,wBAAgB,6BAA6B,CAAC,GAAG,UAAU,EAAE,cAAc,EAAE,GAAG,cAAc,CAkB7F"}

package/dist/core/tracing.js

@@ -0,0 +1,132 @@
+export class InMemoryTraceCollector {
+    traces = new Map();
+    collect(event) {
+        let traceId = null;
+        if ('traceId' in event.data) {
+            traceId = event.data.traceId;
+        }
+        else if ('runId' in event.data) {
+            traceId = event.data.runId;
+        }
+        if (!traceId)
+            return;
+        if (!this.traces.has(traceId)) {
+            this.traces.set(traceId, []);
+        }
+        const events = this.traces.get(traceId);
+        events.push(event);
+    }
+    getTrace(traceId) {
+        return this.traces.get(traceId) || [];
+    }
+    getAllTraces() {
+        return new Map(this.traces);
+    }
+    clear(traceId) {
+        if (traceId) {
+            this.traces.delete(traceId);
+        }
+        else {
+            this.traces.clear();
+        }
+    }
+}
+export class ConsoleTraceCollector {
+    inMemory = new InMemoryTraceCollector();
+    collect(event) {
+        this.inMemory.collect(event);
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] JAF:${event.type}`;
+        switch (event.type) {
+            case 'run_start':
+                console.log(`${prefix} Starting run ${event.data.runId} (trace: ${event.data.traceId})`);
+                break;
+            case 'llm_call_start':
+                console.log(`${prefix} Calling ${event.data.model} for agent ${event.data.agentName}`);
+                break;
+            case 'llm_call_end': {
+                const choice = event.data.choice;
+                const hasTools = choice.message?.tool_calls?.length > 0;
+                const hasContent = !!choice.message?.content;
+                console.log(`${prefix} LLM responded with ${hasTools ? 'tool calls' : hasContent ? 'content' : 'empty response'}`);
+                break;
+            }
+            case 'tool_call_start':
+                console.log(`${prefix} Executing tool ${event.data.toolName} with args:`, event.data.args);
+                break;
+            case 'tool_call_end':
+                console.log(`${prefix} Tool ${event.data.toolName} completed`);
+                break;
+            case 'handoff':
+                console.log(`${prefix} Agent handoff: ${event.data.from} → ${event.data.to}`);
+                break;
+            case 'run_end': {
+                const outcome = event.data.outcome;
+                if (outcome.status === 'completed') {
+                    console.log(`${prefix} Run completed successfully`);
+                }
+                else {
+                    console.error(`${prefix} Run failed:`, outcome.error._tag, outcome.error);
+                }
+                break;
+            }
+        }
+    }
+    getTrace(traceId) {
+        return this.inMemory.getTrace(traceId);
+    }
+    getAllTraces() {
+        return this.inMemory.getAllTraces();
+    }
+    clear(traceId) {
+        this.inMemory.clear(traceId);
+    }
+}
+export class FileTraceCollector {
+    filePath;
+    inMemory = new InMemoryTraceCollector();
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    collect(event) {
+        this.inMemory.collect(event);
+        const logEntry = {
+            timestamp: new Date().toISOString(),
+            ...event
+        };
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const fs = require('fs');
+            fs.appendFileSync(this.filePath, JSON.stringify(logEntry) + '\n');
+        }
+        catch (error) {
+            console.error('Failed to write trace to file:', error);
+        }
+    }
+    getTrace(traceId) {
+        return this.inMemory.getTrace(traceId);
+    }
+    getAllTraces() {
+        return this.inMemory.getAllTraces();
+    }
+    clear(traceId) {
+        this.inMemory.clear(traceId);
+    }
+}
+export function createCompositeTraceCollector(...collectors) {
+    return {
+        collect(event) {
+            collectors.forEach(c => c.collect(event));
+        },
+        getTrace(traceId) {
+            return collectors[0]?.getTrace(traceId) || [];
+        },
+        getAllTraces() {
+            return collectors[0]?.getAllTraces() || new Map();
+        },
+        clear(traceId) {
+            collectors.forEach(c => c.clear(traceId));
+        }
+    };
+}
+//# sourceMappingURL=tracing.js.map

package/dist/core/tracing.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,165 @@
+import { z } from 'zod';
+import { MemoryConfig } from '../memory/types';
+export type TraceId = string & {
+    readonly _brand: 'TraceId';
+};
+export type RunId = string & {
+    readonly _brand: 'RunId';
+};
+export declare const createTraceId: (id: string) => TraceId;
+export declare const createRunId: (id: string) => RunId;
+export type ValidationResult = {
+    readonly isValid: true;
+} | {
+    readonly isValid: false;
+    readonly errorMessage: string;
+};
+export type Message = {
+    readonly role: 'user' | 'assistant' | 'tool';
+    readonly content: string;
+    readonly tool_call_id?: string;
+    readonly tool_calls?: readonly {
+        readonly id: string;
+        readonly type: 'function';
+        readonly function: {
+            readonly name: string;
+            readonly arguments: string;
+        };
+    }[];
+};
+export type ModelConfig = {
+    readonly name?: string;
+    readonly temperature?: number;
+    readonly maxTokens?: number;
+};
+export type Tool<A, Ctx> = {
+    readonly schema: {
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: z.ZodType<A>;
+    };
+    readonly execute: (args: A, context: Readonly<Ctx>) => Promise<string | import('./tool-results').ToolResult>;
+};
+export type Agent<Ctx, Out> = {
+    readonly name: string;
+    readonly instructions: (state: Readonly<RunState<Ctx>>) => string;
+    readonly tools?: readonly Tool<any, Ctx>[];
+    readonly outputCodec?: z.ZodType<Out>;
+    readonly handoffs?: readonly string[];
+    readonly modelConfig?: ModelConfig;
+};
+export type Guardrail<I> = (input: I) => Promise<ValidationResult> | ValidationResult;
+export type RunState<Ctx> = {
+    readonly runId: RunId;
+    readonly traceId: TraceId;
+    readonly messages: readonly Message[];
+    readonly currentAgentName: string;
+    readonly context: Readonly<Ctx>;
+    readonly turnCount: number;
+};
+export type JAFError = {
+    readonly _tag: "MaxTurnsExceeded";
+    readonly turns: number;
+} | {
+    readonly _tag: "ModelBehaviorError";
+    readonly detail: string;
+} | {
+    readonly _tag: "DecodeError";
+    readonly errors: z.ZodIssue[];
+} | {
+    readonly _tag: "InputGuardrailTripwire";
+    readonly reason: string;
+} | {
+    readonly _tag: "OutputGuardrailTripwire";
+    readonly reason: string;
+} | {
+    readonly _tag: "ToolCallError";
+    readonly tool: string;
+    readonly detail: string;
+} | {
+    readonly _tag: "HandoffError";
+    readonly detail: string;
+} | {
+    readonly _tag: "AgentNotFound";
+    readonly agentName: string;
+};
+export type RunResult<Out> = {
+    readonly finalState: RunState<any>;
+    readonly outcome: {
+        readonly status: 'completed';
+        readonly output: Out;
+    } | {
+        readonly status: 'error';
+        readonly error: JAFError;
+    };
+};
+export type TraceEvent = {
+    type: 'run_start';
+    data: {
+        runId: RunId;
+        traceId: TraceId;
+    };
+} | {
+    type: 'llm_call_start';
+    data: {
+        agentName: string;
+        model: string;
+    };
+} | {
+    type: 'llm_call_end';
+    data: {
+        choice: any;
+    };
+} | {
+    type: 'tool_call_start';
+    data: {
+        toolName: string;
+        args: any;
+    };
+} | {
+    type: 'tool_call_end';
+    data: {
+        toolName: string;
+        result: string;
+        toolResult?: any;
+        status?: string;
+    };
+} | {
+    type: 'handoff';
+    data: {
+        from: string;
+        to: string;
+    };
+} | {
+    type: 'run_end';
+    data: {
+        outcome: RunResult<any>['outcome'];
+    };
+};
+export interface ModelProvider<Ctx> {
+    getCompletion: (state: Readonly<RunState<Ctx>>, agent: Readonly<Agent<Ctx, any>>, config: Readonly<RunConfig<Ctx>>) => Promise<{
+        message?: {
+            content?: string | null;
+            tool_calls?: Array<{
+                id: string;
+                type: 'function';
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+            }>;
+        };
+    }>;
+}
+export type RunConfig<Ctx> = {
+    readonly agentRegistry: ReadonlyMap<string, Agent<Ctx, any>>;
+    readonly modelProvider: ModelProvider<Ctx>;
+    readonly maxTurns?: number;
+    readonly modelOverride?: string;
+    readonly initialInputGuardrails?: readonly Guardrail<string>[];
+    readonly finalOutputGuardrails?: readonly Guardrail<any>[];
+    readonly onEvent?: (event: TraceEvent) => void;
+    readonly memory?: MemoryConfig;
+    readonly conversationId?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,3 @@
+export const createTraceId = (id) => id;
+export const createRunId = (id) => id;
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,EAAa,CAAC;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAS,EAAE,CAAC,EAAW,CAAC"}

package/dist/demo/agents.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { Agent } from '../core/types.js';
+type DemoContext = {
+    userId: string;
+    permissions: string[];
+    workspace: string;
+};
+declare const handoffResponseSchema: z.ZodObject<{
+    agentName: z.ZodEnum<["MathTutor", "FileManager", "WebResearcher"]>;
+    reasoning: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentName: "MathTutor" | "FileManager" | "WebResearcher";
+    reasoning: string;
+}, {
+    agentName: "MathTutor" | "FileManager" | "WebResearcher";
+    reasoning: string;
+}>;
+export declare const triageAgent: Agent<DemoContext, z.infer<typeof handoffResponseSchema>>;
+export declare const mathTutor: Agent<DemoContext, string>;
+export declare const fileManager: Agent<DemoContext, string>;
+export declare const webResearcher: Agent<DemoContext, string>;
+export {};
+//# sourceMappingURL=agents.d.ts.map

package/dist/demo/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/demo/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAIzC,KAAK,WAAW,GAAG;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,QAAA,MAAM,qBAAqB;;;;;;;;;EAGzB,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAmBjF,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,CAWhD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,CAclD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,CAUpD,CAAC"}

package/dist/demo/agents.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webResearcher = exports.fileManager = exports.mathTutor = exports.triageAgent = void 0;
+const zod_1 = require("zod");
+const handoff_js_1 = require("../policies/handoff.js");
+const tools_js_1 = require("./tools.js");
+const handoffResponseSchema = zod_1.z.object({
+    agentName: zod_1.z.enum(['MathTutor', 'FileManager', 'WebResearcher']).describe("The agent to handoff to"),
+    reasoning: zod_1.z.string().describe("Why this agent is best suited for the task")
+});
+exports.triageAgent = {
+    name: 'TriageAgent',
+    instructions: (state) => `You are a triage agent that routes user requests to specialized agents.
+
+Available agents:
+- MathTutor: Handles mathematical calculations, equations, and number problems
+- FileManager: Handles file operations like reading, writing, and organizing files
+- WebResearcher: Handles web searches and research tasks
+
+Current user: ${state.context.userId}
+User permissions: ${state.context.permissions.join(', ')}
+
+Analyze the user's request and determine which specialized agent should handle it.
+Respond with a JSON object containing the agent name and your reasoning.
+
+If the request involves multiple capabilities, choose the most relevant one or start with the primary task.`,
+    outputCodec: handoffResponseSchema,
+    tools: [handoff_js_1.handoffTool],
+    handoffs: ['MathTutor', 'FileManager', 'WebResearcher'],
+};
+exports.mathTutor = {
+    name: 'MathTutor',
+    instructions: () => `You are a helpful math tutor. You can:
+- Solve mathematical problems and equations
+- Explain mathematical concepts
+- Perform calculations using the calculate tool
+
+When users ask math questions, use the calculate tool to show your work and provide accurate results.
+Always explain your reasoning and show step-by-step solutions when appropriate.`,
+    tools: [tools_js_1.mathTool, handoff_js_1.handoffTool],
+    handoffs: ['FileManager', 'WebResearcher'],
+};
+exports.fileManager = {
+    name: 'FileManager',
+    instructions: (state) => `You are a file management assistant. You can help users:
+- Read file contents
+- Write files (requires admin permission)
+- Organize and manage files within the workspace
+
+Current workspace: ${state.context.workspace}
+User permissions: ${state.context.permissions.join(', ')}
+
+Note: File operations are restricted to the workspace directory for security.
+Write operations require admin permissions.`,
+    tools: [tools_js_1.fileReadTool, tools_js_1.fileWriteTool, handoff_js_1.handoffTool],
+    handoffs: ['MathTutor', 'WebResearcher'],
+};
+exports.webResearcher = {
+    name: 'WebResearcher',
+    instructions: () => `You are a web research assistant. You can:
+- Search the web for information
+- Provide summaries of search results
+- Help with research tasks
+
+Use the search_web tool to find relevant information and provide comprehensive answers based on the results.`,
+    tools: [tools_js_1.webSearchTool, handoff_js_1.handoffTool],
+    handoffs: ['MathTutor', 'FileManager'],
+};
+//# sourceMappingURL=agents.js.map

package/dist/demo/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/demo/agents.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,uDAAqD;AACrD,yCAAkF;AAQlF,MAAM,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACpG,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC7E,CAAC,CAAC;AAEU,QAAA,WAAW,GAA8D;IACpF,IAAI,EAAE,aAAa;IACnB,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;;;;;;;gBAOX,KAAK,CAAC,OAAO,CAAC,MAAM;oBAChB,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;4GAKoD;IAC1G,WAAW,EAAE,qBAAqB;IAClC,KAAK,EAAE,CAAC,wBAAW,CAAC;IACpB,QAAQ,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,eAAe,CAAC;CACxD,CAAC;AAEW,QAAA,SAAS,GAA+B;IACnD,IAAI,EAAE,WAAW;IACjB,YAAY,EAAE,GAAG,EAAE,CAAC;;;;;;gFAM0D;IAC9E,KAAK,EAAE,CAAC,mBAAQ,EAAE,wBAAW,CAAC;IAC9B,QAAQ,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;CAC3C,CAAC;AAEW,QAAA,WAAW,GAA+B;IACrD,IAAI,EAAE,aAAa;IACnB,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;;;;;qBAKN,KAAK,CAAC,OAAO,CAAC,SAAS;oBACxB,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;;;4CAGZ;IAC1C,KAAK,EAAE,CAAC,uBAAY,EAAE,wBAAa,EAAE,wBAAW,CAAC;IACjD,QAAQ,EAAE,CAAC,WAAW,EAAE,eAAe,CAAC;CACzC,CAAC;AAEW,QAAA,aAAa,GAA+B;IACvD,IAAI,EAAE,eAAe;IACrB,YAAY,EAAE,GAAG,EAAE,CAAC;;;;;6GAKuF;IAC3G,KAAK,EAAE,CAAC,wBAAa,EAAE,wBAAW,CAAC;IACnC,QAAQ,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;CACvC,CAAC"}

package/dist/demo/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/demo/index.ts"],"names":[],"mappings":""}