concevent-ai-agent-sdk 2.1.1 → 2.2.0-rc1

package/README.md

@@ -17,6 +17,7 @@ A framework-agnostic AI Agent SDK for building intelligent conversational agents
 - 🔌 **Middleware System** - Extensible plugin architecture for logging, sanitization, and more
 - 📋 **Structured Output** - JSON schema validation with Zod for type-safe responses
 - 🎭 **Multi-Agent Orchestration** - Route tasks to specialized sub-agents based on their capabilities
+- 📊 **Flow Visualization** - Automatic Mermaid sequence diagrams showing orchestration flow
 
 ## Installation
 
@@ -99,6 +100,7 @@ console.log(result.message);
   - [Abort Requests](#abort-requests)
   - [Middleware](#middleware)
   - [Multi-Agent Orchestration](#multi-agent-orchestration)
+  - [Orchestration Flow Diagrams](#orchestration-flow-diagrams)
 
 ---
 
@@ -1615,7 +1617,13 @@ interface AgentDefinition {
 #### OrchestratorAgent Interface
 
 ```typescript
-interface OrchestratorAgent extends Agent {
+interface OrchestratorAgent extends Omit<Agent, 'chat'> {
+  chat(
+    message: string,
+    context: ToolExecutorContext,
+    callbacks?: AgentCallbacks
+  ): Promise<OrchestratorResult>;  // Returns OrchestratorResult with diagram
+  
   getSubAgents(): AgentDefinition[];  // Returns registered sub-agents
 }
 ```
@@ -1630,6 +1638,90 @@ interface OrchestratorAgent extends Agent {
 
 4. **Automatic Routing**: The orchestrator's LLM decides which sub-agent(s) to use based on their descriptions and the user's request.
 
+### Orchestration Flow Diagrams
+
+The orchestrator automatically generates Mermaid sequence diagrams that visualize the complete orchestration flow. This helps developers understand how tasks are routed between sub-agents and debug or fine-tune their multi-agent systems.
+
+#### Accessing the Diagram
+
+The orchestrator returns an `OrchestratorResult` which extends `AgentResult` with a `diagram` property:
+
+```typescript
+const result = await orchestrator.chat(
+  "Research sorting algorithms and implement quicksort",
+  { userId: "user-123", timezone: "UTC" }
+);
+
+console.log(result.message);  // The orchestrator's response
+console.log(result.diagram);  // Mermaid sequence diagram
+```
+
+#### OrchestratorResult
+
+```typescript
+interface OrchestratorResult<T = unknown> extends AgentResult<T> {
+  /** Mermaid sequence diagram showing the orchestration flow */
+  diagram: string;
+}
+```
+
+#### Example Diagram Output
+
+When the orchestrator delegates to sub-agents, the diagram shows the complete flow:
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant Orchestrator
+    participant researcher
+    participant code_expert
+
+    User->>Orchestrator: Research sorting algorithms and implement quicksort
+    Orchestrator->>+researcher: Research the best sorting algorithms
+    researcher-->>-Orchestrator: QuickSort is efficient for large datasets
+    Orchestrator->>+code_expert: Implement QuickSort in TypeScript
+    Note right of code_expert: Tool: write_file
+    Note right of code_expert: Tool: read_file
+    code_expert-->>-Orchestrator: Implementation complete
+    Orchestrator-->>User: Based on research, QuickSort is best...
+```
+
+#### Diagram Features
+
+The generated diagrams include:
+
+| Element | Description |
+|---------|-------------|
+| **Participants** | User, Orchestrator, and all called sub-agents |
+| **Delegations** | Messages sent from orchestrator to sub-agents |
+| **Tool Calls** | Notes showing tools called within sub-agents |
+| **Responses** | Return messages from sub-agents to orchestrator |
+| **Final Response** | The orchestrator's synthesized response to the user |
+
+#### Using the Diagram
+
+The diagram string is valid Mermaid syntax that can be:
+
+1. **Rendered in Markdown**: GitHub, GitLab, and many documentation tools render Mermaid natively
+2. **Displayed in Web Apps**: Use [Mermaid.js](https://mermaid.js.org/) to render in browsers
+3. **Logged for Debugging**: Visualize agent routing decisions in development
+4. **Stored for Analytics**: Track orchestration patterns over time
+
+```typescript
+// Example: Save diagram to file for debugging
+import { writeFile } from "fs/promises";
+
+const result = await orchestrator.chat("Complex multi-agent task", context);
+await writeFile("orchestration-flow.md", `\`\`\`mermaid\n${result.diagram}\n\`\`\``);
+```
+
+#### Diagram Characteristics
+
+- **Automatic Generation**: Diagrams are generated by the SDK, not the LLM (deterministic and reliable)
+- **Message Truncation**: Long messages are truncated to 50 characters for readability
+- **Special Character Escaping**: Characters that could break Mermaid syntax are safely escaped
+- **Activation Boxes**: Sub-agent calls show activation (`+`/`-`) to indicate processing time
+
 ---
 
 ## Exports Summary
@@ -1684,6 +1776,7 @@ export type {
   AgentDefinition,
   OrchestratorConfig,
   OrchestratorAgent,
+  OrchestratorResult,
   SubAgentStartData,
   SubAgentCompleteData,
   OrchestratorCallbacks,

package/dist/core/diagram-builder.d.ts

@@ -0,0 +1,110 @@
+/**
+ * DiagramBuilder - Generates Mermaid sequence diagrams for orchestrator flows.
+ *
+ * This utility tracks sub-agent delegations, tool calls, and responses during
+ * orchestrator execution, then generates a Mermaid sequence diagram that
+ * visualizes the complete flow.
+ */
+/**
+ * Configuration options for DiagramBuilder.
+ */
+export interface DiagramBuilderConfig {
+    /**
+     * Maximum length for message text before truncation.
+     * @default 50
+     */
+    messageTruncateLength?: number;
+    /**
+     * Whether to include tool call arguments in the diagram.
+     * @default false
+     */
+    includeToolArgs?: boolean;
+    /**
+     * Whether to include tool result events.
+     * @default false
+     */
+    includeToolResults?: boolean;
+}
+/**
+ * Builds Mermaid sequence diagrams from orchestrator execution events.
+ *
+ * @example
+ * ```typescript
+ * const builder = new DiagramBuilder();
+ * builder.recordUserMessage('Write a sorting function');
+ * builder.recordDelegation('code_expert', 'Implement quicksort');
+ * builder.recordToolCall('code_expert', 'write_file');
+ * builder.recordSubAgentResponse('code_expert', 'Created implementation');
+ * builder.recordOrchestratorResponse('Here is your sorting function...');
+ *
+ * const diagram = builder.build();
+ * // Returns Mermaid sequence diagram string
+ * ```
+ */
+export declare class DiagramBuilder {
+    private events;
+    private participants;
+    private currentSubAgent;
+    private config;
+    constructor(config?: DiagramBuilderConfig);
+    /**
+     * Records the initial user message to the orchestrator.
+     */
+    recordUserMessage(message: string): void;
+    /**
+     * Records the orchestrator delegating to a sub-agent.
+     */
+    recordDelegation(agentName: string, message: string): void;
+    /**
+     * Records a tool call made by a sub-agent.
+     */
+    recordToolCall(agentName: string, toolName: string, args?: Record<string, unknown>): void;
+    /**
+     * Records a tool result returned to a sub-agent.
+     */
+    recordToolResult(agentName: string, toolName: string, success?: boolean): void;
+    /**
+     * Records a sub-agent's response back to the orchestrator.
+     */
+    recordSubAgentResponse(agentName: string, message: string): void;
+    /**
+     * Records the orchestrator's final response to the user.
+     */
+    recordOrchestratorResponse(message: string): void;
+    /**
+     * Returns the name of the currently active sub-agent (if any).
+     * Useful for associating tool calls with the correct agent.
+     */
+    getCurrentSubAgent(): string | null;
+    /**
+     * Truncates a message to the configured length, adding ellipsis if needed.
+     */
+    private truncate;
+    /**
+     * Escapes special characters for Mermaid syntax.
+     */
+    private escape;
+    /**
+     * Sanitizes a participant name for Mermaid (no spaces, alphanumeric + underscore).
+     */
+    private sanitizeParticipant;
+    /**
+     * Formats tool call arguments for display.
+     */
+    private formatToolArgs;
+    /**
+     * Builds the Mermaid sequence diagram from recorded events.
+     *
+     * @returns The complete Mermaid diagram as a string.
+     */
+    build(): string;
+    /**
+     * Clears all recorded events and participants.
+     */
+    clear(): void;
+    /**
+     * Returns the number of recorded events.
+     */
+    getEventCount(): number;
+}
+//# sourceMappingURL=diagram-builder.d.ts.map

package/dist/core/diagram-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-builder.d.ts","sourceRoot":"","sources":["../../src/core/diagram-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyFH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,GAAE,oBAAyB;IAQ7C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAW1D;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUzF;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,OAAc,GAAG,IAAI;IAYpF;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAUhE;;OAEG;IACH,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjD;;;OAGG;IACH,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,MAAM;IAYd;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;;;OAIG;IACH,KAAK,IAAI,MAAM;IAmEf;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB"}

package/dist/core/diagram-builder.js

@@ -0,0 +1,240 @@
+/**
+ * DiagramBuilder - Generates Mermaid sequence diagrams for orchestrator flows.
+ *
+ * This utility tracks sub-agent delegations, tool calls, and responses during
+ * orchestrator execution, then generates a Mermaid sequence diagram that
+ * visualizes the complete flow.
+ */
+/** Maximum length for message text in diagram labels */
+const DEFAULT_MESSAGE_TRUNCATE_LENGTH = 50;
+/**
+ * Builds Mermaid sequence diagrams from orchestrator execution events.
+ *
+ * @example
+ * ```typescript
+ * const builder = new DiagramBuilder();
+ * builder.recordUserMessage('Write a sorting function');
+ * builder.recordDelegation('code_expert', 'Implement quicksort');
+ * builder.recordToolCall('code_expert', 'write_file');
+ * builder.recordSubAgentResponse('code_expert', 'Created implementation');
+ * builder.recordOrchestratorResponse('Here is your sorting function...');
+ *
+ * const diagram = builder.build();
+ * // Returns Mermaid sequence diagram string
+ * ```
+ */
+export class DiagramBuilder {
+    events = [];
+    participants = new Set();
+    currentSubAgent = null;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            messageTruncateLength: config.messageTruncateLength ?? DEFAULT_MESSAGE_TRUNCATE_LENGTH,
+            includeToolArgs: config.includeToolArgs ?? false,
+            includeToolResults: config.includeToolResults ?? false,
+        };
+    }
+    /**
+     * Records the initial user message to the orchestrator.
+     */
+    recordUserMessage(message) {
+        this.events.push({
+            type: 'user_message',
+            message,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Records the orchestrator delegating to a sub-agent.
+     */
+    recordDelegation(agentName, message) {
+        this.participants.add(agentName);
+        this.currentSubAgent = agentName;
+        this.events.push({
+            type: 'delegation',
+            agentName,
+            message,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Records a tool call made by a sub-agent.
+     */
+    recordToolCall(agentName, toolName, args) {
+        this.events.push({
+            type: 'tool_call',
+            agentName,
+            toolName,
+            args,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Records a tool result returned to a sub-agent.
+     */
+    recordToolResult(agentName, toolName, success = true) {
+        if (this.config.includeToolResults) {
+            this.events.push({
+                type: 'tool_result',
+                agentName,
+                toolName,
+                success,
+                timestamp: new Date(),
+            });
+        }
+    }
+    /**
+     * Records a sub-agent's response back to the orchestrator.
+     */
+    recordSubAgentResponse(agentName, message) {
+        this.currentSubAgent = null;
+        this.events.push({
+            type: 'sub_agent_response',
+            agentName,
+            message,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Records the orchestrator's final response to the user.
+     */
+    recordOrchestratorResponse(message) {
+        this.events.push({
+            type: 'orchestrator_response',
+            message,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Returns the name of the currently active sub-agent (if any).
+     * Useful for associating tool calls with the correct agent.
+     */
+    getCurrentSubAgent() {
+        return this.currentSubAgent;
+    }
+    /**
+     * Truncates a message to the configured length, adding ellipsis if needed.
+     */
+    truncate(text) {
+        const maxLen = this.config.messageTruncateLength;
+        if (text.length <= maxLen) {
+            return text;
+        }
+        return text.slice(0, maxLen - 3) + '...';
+    }
+    /**
+     * Escapes special characters for Mermaid syntax.
+     */
+    escape(text) {
+        // Replace characters that could break Mermaid syntax
+        return text
+            .replace(/"/g, "'")
+            .replace(/\n/g, ' ')
+            .replace(/\r/g, '')
+            .replace(/>/g, 'ᐳ')
+            .replace(/</g, 'ᐸ')
+            .replace(/#/g, '＃')
+            .replace(/;/g, '；');
+    }
+    /**
+     * Sanitizes a participant name for Mermaid (no spaces, alphanumeric + underscore).
+     */
+    sanitizeParticipant(name) {
+        return name.replace(/[^a-zA-Z0-9_]/g, '_');
+    }
+    /**
+     * Formats tool call arguments for display.
+     */
+    formatToolArgs(args) {
+        if (!args || !this.config.includeToolArgs) {
+            return '';
+        }
+        const entries = Object.entries(args);
+        if (entries.length === 0) {
+            return '';
+        }
+        // Show first key-value pair only for brevity
+        const [key, value] = entries[0];
+        const valueStr = typeof value === 'string' ? value : JSON.stringify(value);
+        const truncatedValue = this.truncate(valueStr);
+        return `(${key}: ${truncatedValue})`;
+    }
+    /**
+     * Builds the Mermaid sequence diagram from recorded events.
+     *
+     * @returns The complete Mermaid diagram as a string.
+     */
+    build() {
+        const lines = ['sequenceDiagram'];
+        // Add participants in order: User, Orchestrator, then sub-agents
+        lines.push('    participant User');
+        lines.push('    participant Orchestrator');
+        for (const participant of this.participants) {
+            const sanitized = this.sanitizeParticipant(participant);
+            if (sanitized !== participant) {
+                lines.push(`    participant ${sanitized} as ${participant}`);
+            }
+            else {
+                lines.push(`    participant ${participant}`);
+            }
+        }
+        lines.push('');
+        // Add events
+        for (const event of this.events) {
+            switch (event.type) {
+                case 'user_message': {
+                    const msg = this.escape(this.truncate(event.message));
+                    lines.push(`    User->>Orchestrator: ${msg}`);
+                    break;
+                }
+                case 'delegation': {
+                    const agent = this.sanitizeParticipant(event.agentName);
+                    const msg = this.escape(this.truncate(event.message));
+                    lines.push(`    Orchestrator->>+${agent}: ${msg}`);
+                    break;
+                }
+                case 'tool_call': {
+                    const agent = this.sanitizeParticipant(event.agentName);
+                    const argsStr = this.formatToolArgs(event.args);
+                    const toolInfo = argsStr ? `${event.toolName}${argsStr}` : event.toolName;
+                    lines.push(`    Note right of ${agent}: Tool: ${this.escape(toolInfo)}`);
+                    break;
+                }
+                case 'tool_result': {
+                    const agent = this.sanitizeParticipant(event.agentName);
+                    const status = event.success ? '✓' : '✗';
+                    lines.push(`    Note right of ${agent}: ${status} ${event.toolName}`);
+                    break;
+                }
+                case 'sub_agent_response': {
+                    const agent = this.sanitizeParticipant(event.agentName);
+                    const msg = this.escape(this.truncate(event.message));
+                    lines.push(`    ${agent}-->>-Orchestrator: ${msg}`);
+                    break;
+                }
+                case 'orchestrator_response': {
+                    const msg = this.escape(this.truncate(event.message));
+                    lines.push(`    Orchestrator-->>User: ${msg}`);
+                    break;
+                }
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Clears all recorded events and participants.
+     */
+    clear() {
+        this.events = [];
+        this.participants.clear();
+        this.currentSubAgent = null;
+    }
+    /**
+     * Returns the number of recorded events.
+     */
+    getEventCount() {
+        return this.events.length;
+    }
+}
+//# sourceMappingURL=diagram-builder.js.map

package/dist/core/diagram-builder.js.map

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

package/dist/core/index.d.ts

@@ -12,4 +12,6 @@ export { buildResponseFormat, validateResponse, formatValidationError, requiresJ
 export type { ValidationResult } from './response-format.js';
 export { convertChatMessagesToOpenAI, convertFunctionDeclarationsToTools, convertOpenAIToolCallsToFunctionCalls, mapOpenAIUsageToMetadata, normalizeReasoning, createSystemMessage, createUserMessage, createAssistantMessage, } from './openrouter-utils.js';
 export type { NormalizedReasoning } from './openrouter-utils.js';
+export { DiagramBuilder } from './diagram-builder.js';
+export type { DiagramBuilderConfig } from './diagram-builder.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,EAClC,qCAAqC,EACrC,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,EAClC,qCAAqC,EACrC,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/index.js

@@ -6,4 +6,5 @@ export { summarizeConversation, createSummaryMessage, shouldSummarize, DEFAULT_C
 export { AgentError, formatErrorTrace, isAbortError, createErrorMessageResolver, } from './errors.js';
 export { buildResponseFormat, validateResponse, formatValidationError, requiresJsonParsing, hasSchema, } from './response-format.js';
 export { convertChatMessagesToOpenAI, convertFunctionDeclarationsToTools, convertOpenAIToolCallsToFunctionCalls, mapOpenAIUsageToMetadata, normalizeReasoning, createSystemMessage, createUserMessage, createAssistantMessage, } from './openrouter-utils.js';
+export { DiagramBuilder } from './diagram-builder.js';
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,EAClC,qCAAqC,EACrC,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,EAClC,qCAAqC,EACrC,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AA2HlC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CA0GrF"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAmJlC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CA+HrF"}

package/dist/core/orchestrator.js

@@ -1,6 +1,7 @@
 import { createAgent } from './agent.js';
 import { AgentError } from './errors.js';
 import { logger } from './logger.js';
+import { DiagramBuilder } from './diagram-builder.js';
 /**
  * Symbol used to mark an agent as an orchestrator.
  * Used to prevent nested orchestrators.
@@ -16,7 +17,7 @@ function isOrchestratorAgent(agent) {
  * Creates a tool definition that delegates to a sub-agent.
  * The tool allows the orchestrator to invoke the sub-agent with a message.
  */
-function createSubAgentTool(definition, callbacks) {
+function createSubAgentTool(definition, callbacks, diagramBuilder) {
     return {
         declaration: {
             name: definition.name,
@@ -36,6 +37,8 @@ function createSubAgentTool(definition, callbacks) {
         executor: async (args, context) => {
             const message = args.message;
             logger.subAgentStart(definition.name, message);
+            // Record delegation in diagram
+            diagramBuilder?.recordDelegation(definition.name, message);
             // Fire onSubAgentStart callback
             callbacks?.onSubAgentStart?.({
                 agentName: definition.name,
@@ -44,14 +47,30 @@ function createSubAgentTool(definition, callbacks) {
             try {
                 // Clear sub-agent history to ensure stateless execution
                 definition.agent.clearHistory();
-                // Delegate to the sub-agent
-                const result = await definition.agent.chat(message, context, {
+                // Create wrapped callbacks that record tool calls in the diagram
+                const wrappedCallbacks = {
                     // Forward abort handling
                     onAborted: callbacks?.onAborted,
                     // Forward error handling
                     onError: callbacks?.onError,
-                });
+                    // Wrap tool call start to record in diagram
+                    onToolCallStart: (calls) => {
+                        for (const call of calls) {
+                            diagramBuilder?.recordToolCall(definition.name, call.name, call.args);
+                        }
+                        callbacks?.onToolCallStart?.(calls);
+                    },
+                    // Wrap tool result to record in diagram
+                    onToolResult: (result) => {
+                        diagramBuilder?.recordToolResult(definition.name, result.functionName, !result.error);
+                        callbacks?.onToolResult?.(result);
+                    },
+                };
+                // Delegate to the sub-agent
+                const result = await definition.agent.chat(message, context, wrappedCallbacks);
                 logger.subAgentComplete(definition.name, result.iterations);
+                // Record sub-agent response in diagram
+                diagramBuilder?.recordSubAgentResponse(definition.name, result.message);
                 // Fire onSubAgentComplete callback
                 callbacks?.onSubAgentComplete?.({
                     agentName: definition.name,
@@ -137,19 +156,20 @@ export function createOrchestratorAgent(config) {
         }
         names.add(definition.name);
     }
-    // We need to create tools that capture callbacks, but callbacks are passed per-chat call.
-    // So we create a mutable reference that gets updated on each chat call.
+    // We need to create tools that capture callbacks and diagramBuilder, but these are passed per-chat call.
+    // So we create mutable references that get updated on each chat call.
     let currentCallbacks;
+    let currentDiagramBuilder;
     // Generate delegation tools for each sub-agent
     const subAgentTools = subAgents.map((definition) => {
-        // Create a wrapper that uses the current callbacks
-        const baseToolDef = createSubAgentTool(definition, undefined);
+        // Create a wrapper that uses the current callbacks and diagram builder
+        const baseToolDef = createSubAgentTool(definition, undefined, undefined);
         return {
             ...baseToolDef,
             executor: async (args, context) => {
-                // Create tool with current callbacks
-                const toolWithCallbacks = createSubAgentTool(definition, currentCallbacks);
-                return toolWithCallbacks.executor(args, context);
+                // Create tool with current callbacks and diagram builder
+                const toolWithContext = createSubAgentTool(definition, currentCallbacks, currentDiagramBuilder);
+                return toolWithContext.executor(args, context);
             },
         };
     });
@@ -166,13 +186,27 @@ export function createOrchestratorAgent(config) {
     // Create the orchestrator agent wrapper
     const orchestratorAgent = {
         async chat(message, context, callbacks) {
-            // Update current callbacks for sub-agent tools to use
+            // Create a fresh diagram builder for this chat
+            const diagramBuilder = new DiagramBuilder();
+            // Record the initial user message
+            diagramBuilder.recordUserMessage(message);
+            // Update current callbacks and diagram builder for sub-agent tools to use
             currentCallbacks = callbacks;
+            currentDiagramBuilder = diagramBuilder;
             try {
-                return await underlyingAgent.chat(message, context, callbacks);
+                const result = await underlyingAgent.chat(message, context, callbacks);
+                // Record the orchestrator's final response
+                diagramBuilder.recordOrchestratorResponse(result.message);
+                // Build the diagram and return OrchestratorResult
+                const diagram = diagramBuilder.build();
+                return {
+                    ...result,
+                    diagram,
+                };
             }
             finally {
                 currentCallbacks = undefined;
+                currentDiagramBuilder = undefined;
             }
         },
         abort() {

package/dist/core/orchestrator.js.map

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

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { createEvent } from './types/events.js';
 export { ENCRYPTED_REASONING_MARKER } from './core/openrouter-utils.js';
 export { AgentError, formatErrorTrace, isAbortError } from './core/errors.js';
 export type { AgentErrorCode } from './core/errors.js';
-export type { ReasoningDetail, ChatMessage, FunctionDeclaration, ToolExecutorContext, ToolDefinition, AgentConfig, ParallelExecutionConfig, RetryConfig, TimeoutConfig, UsageMetadata, AgentResult, ToolCallStartData, ToolResultData, AgentCallbacks, AgentEventType, ThinkingEventData, UsageUpdateEventData, RetryEventData, ErrorEventData, CompleteEventData, MessageDeltaEventData, ReasoningDeltaEventData, AgentEvent, ResponseFormatConfig, Middleware, MiddlewareContext, BeforeChatContext, AfterChatContext, BeforeToolCallContext, AfterToolCallContext, ErrorContext, AgentDefinition, OrchestratorConfig, OrchestratorAgent, SubAgentStartData, SubAgentCompleteData, OrchestratorCallbacks, } from './types/index.js';
+export type { ReasoningDetail, ChatMessage, FunctionDeclaration, ToolExecutorContext, ToolDefinition, AgentConfig, ParallelExecutionConfig, RetryConfig, TimeoutConfig, UsageMetadata, AgentResult, ToolCallStartData, ToolResultData, AgentCallbacks, AgentEventType, ThinkingEventData, UsageUpdateEventData, RetryEventData, ErrorEventData, CompleteEventData, MessageDeltaEventData, ReasoningDeltaEventData, AgentEvent, ResponseFormatConfig, Middleware, MiddlewareContext, BeforeChatContext, AfterChatContext, BeforeToolCallContext, AfterToolCallContext, ErrorContext, AgentDefinition, OrchestratorConfig, OrchestratorAgent, OrchestratorResult, SubAgentStartData, SubAgentCompleteData, OrchestratorCallbacks, } from './types/index.js';
 export { DEFAULT_TOOL_EXECUTION_TIMEOUT_MS, DEFAULT_API_REQUEST_TIMEOUT_MS, } from './types/index.js';
 export { ToolExecutionTimeoutError } from './core/tool-executor.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,YAAY,EACV,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,EACV,oBAAoB,EAEpB,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EAEZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,YAAY,EACV,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,EACV,oBAAoB,EAEpB,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EAEZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6C9E,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA8C9E,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types/index.d.ts

@@ -4,5 +4,5 @@ export { DEFAULT_MAX_CONCURRENCY, DEFAULT_RETRY_MAX_ATTEMPTS, DEFAULT_RETRY_BASE
 export type { AgentCallbacks, AgentEventType, ThinkingEventData, MessageEventData, MessageDeltaEventData, ReasoningDeltaEventData, ToolCallStartEventData, ToolResultEventData, UsageUpdateEventData, SummarizationStartEventData, SummarizationEndEventData, IterationStartEventData, RetryEventData, ErrorEventData, CompleteEventData, AbortedEventData, SubAgentStartEventData, SubAgentCompleteEventData, EventDataMap, AgentEvent, } from './events.js';
 export { createEvent } from './events.js';
 export type { Middleware, MiddlewareContext, BeforeChatContext, AfterChatContext, BeforeToolCallContext, AfterToolCallContext, ErrorContext, } from './middleware.js';
-export type { AgentDefinition, OrchestratorConfig, OrchestratorAgent, SubAgentStartData, SubAgentCompleteData, OrchestratorCallbacks, } from './orchestrator.js';
+export type { AgentDefinition, OrchestratorConfig, OrchestratorAgent, OrchestratorResult, SubAgentStartData, SubAgentCompleteData, OrchestratorCallbacks, } from './orchestrator.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,eAAe,EACf,QAAQ,EACR,WAAW,EACX,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,EAChC,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,YAAY,EACZ,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,eAAe,EACf,QAAQ,EACR,WAAW,EACX,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,EAChC,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,YAAY,EACZ,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}

package/dist/types/orchestrator.d.ts

@@ -1,5 +1,6 @@
 import type { Agent } from '../core/agent.js';
-import type { AgentConfig, AgentResult } from './config.js';
+import type { AgentConfig, AgentResult, ToolExecutorContext } from './config.js';
+import type { AgentCallbacks } from './events.js';
 /**
  * Definition of a sub-agent that can be delegated to by an orchestrator.
  */
@@ -24,13 +25,6 @@ export interface OrchestratorConfig extends Omit<AgentConfig, 'tools'> {
     /** Array of sub-agents that the orchestrator can delegate to */
     subAgents: AgentDefinition[];
 }
-/**
- * Extended Agent interface for orchestrators with sub-agent management.
- */
-export interface OrchestratorAgent extends Agent {
-    /** Returns the list of registered sub-agents */
-    getSubAgents(): AgentDefinition[];
-}
 /**
  * Callback fired when orchestrator starts delegating to a sub-agent.
  */
@@ -58,4 +52,46 @@ export interface OrchestratorCallbacks {
     /** Called when a sub-agent completes its work */
     onSubAgentComplete?: (data: SubAgentCompleteData) => void;
 }
+/**
+ * Result returned from orchestrator.chat().
+ * Extends AgentResult with a Mermaid sequence diagram showing the orchestration flow.
+ *
+ * @typeParam T - The type of the parsed response when using responseFormat with json_schema.
+ */
+export interface OrchestratorResult<T = unknown> extends AgentResult<T> {
+    /**
+     * Mermaid sequence diagram showing the orchestration flow.
+     * Includes sub-agent delegations, tool calls, and responses.
+     *
+     * @example
+     * ```mermaid
+     * sequenceDiagram
+     *     participant User
+     *     participant Orchestrator
+     *     participant code_expert
+     *
+     *     User->>Orchestrator: Write a sorting function
+     *     Orchestrator->>code_expert: Implement quicksort
+     *     Note right of code_expert: Tool: read_file
+     *     code_expert-->>Orchestrator: Implementation complete
+     *     Orchestrator-->>User: Here is your function...
+     * ```
+     */
+    diagram: string;
+}
+/**
+ * Extended Agent interface for orchestrators with sub-agent management.
+ */
+export interface OrchestratorAgent extends Omit<Agent, 'chat'> {
+    /**
+     * Sends a message to the orchestrator and returns a result with a diagram.
+     * @param message - The user's message
+     * @param context - Execution context (userId, timezone, abortSignal)
+     * @param callbacks - Optional callbacks for streaming events
+     * @returns OrchestratorResult including the Mermaid diagram
+     */
+    chat(message: string, context: ToolExecutorContext, callbacks?: AgentCallbacks): Promise<OrchestratorResult>;
+    /** Returns the list of registered sub-agents */
+    getSubAgents(): AgentDefinition[];
+}
 //# sourceMappingURL=orchestrator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/types/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,EAAE,KAAK,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IACpE,gEAAgE;IAChE,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,KAAK;IAC9C,gDAAgD;IAChD,YAAY,IAAI,eAAe,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpD,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC3D"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/types/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,EAAE,KAAK,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IACpE,gEAAgE;IAChE,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpD,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IACrE;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC;IAC5D;;;;;;OAMG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,EAC5B,SAAS,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B,gDAAgD;IAChD,YAAY,IAAI,eAAe,EAAE,CAAC;CACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "concevent-ai-agent-sdk",
-  "version": "2.1.1",
+  "version": "2.2.0-rc1",
   "description": "Framework-agnostic AI Agent SDK with tool calling, conversation management, and automatic summarization",
   "type": "module",
   "main": "./dist/index.js",