@serverless-dna/sop-agents 0.1.0

package/dist/model-factory.d.ts

@@ -0,0 +1,36 @@
+import type { Model } from "@strands-agents/sdk";
+/**
+ * Supported model providers
+ */
+export type ModelProvider = "bedrock" | "openai";
+/**
+ * Parsed model specification
+ */
+export interface ParsedModelSpec {
+    provider: ModelProvider;
+    modelId: string;
+}
+/**
+ * Parse a model specification string into provider and model ID.
+ * Format: "<provider>/<modelId>" or just "<modelId>" (defaults to bedrock)
+ *
+ * @example
+ * parseModelSpec("bedrock/us.anthropic.claude-sonnet-4-20250514-v1:0")
+ * // => { provider: "bedrock", modelId: "us.anthropic.claude-sonnet-4-20250514-v1:0" }
+ *
+ * parseModelSpec("openai/gpt-4o")
+ * // => { provider: "openai", modelId: "gpt-4o" }
+ *
+ * parseModelSpec("us.anthropic.claude-sonnet-4-20250514-v1:0")
+ * // => { provider: "bedrock", modelId: "us.anthropic.claude-sonnet-4-20250514-v1:0" }
+ */
+export declare function parseModelSpec(modelSpec: string, defaultProvider?: ModelProvider): ParsedModelSpec;
+/**
+ * Create a Model instance from a parsed model specification
+ */
+export declare function createModel(spec: ParsedModelSpec): Model;
+/**
+ * Create a Model instance from a model specification string
+ */
+export declare function createModelFromSpec(modelSpec: string, defaultProvider?: ModelProvider): Model;
+//# sourceMappingURL=model-factory.d.ts.map

package/dist/model-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-factory.d.ts","sourceRoot":"","sources":["../src/model-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC7B,SAAS,EAAE,MAAM,EACjB,eAAe,GAAE,aAAyB,GACxC,eAAe,CAkBjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,KAAK,CAaxD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,MAAM,EACjB,eAAe,GAAE,aAAyB,GACxC,KAAK,CAGP"}

package/dist/model-factory.js

@@ -0,0 +1,55 @@
+import { BedrockModel } from "@strands-agents/sdk/bedrock";
+/**
+ * Parse a model specification string into provider and model ID.
+ * Format: "<provider>/<modelId>" or just "<modelId>" (defaults to bedrock)
+ *
+ * @example
+ * parseModelSpec("bedrock/us.anthropic.claude-sonnet-4-20250514-v1:0")
+ * // => { provider: "bedrock", modelId: "us.anthropic.claude-sonnet-4-20250514-v1:0" }
+ *
+ * parseModelSpec("openai/gpt-4o")
+ * // => { provider: "openai", modelId: "gpt-4o" }
+ *
+ * parseModelSpec("us.anthropic.claude-sonnet-4-20250514-v1:0")
+ * // => { provider: "bedrock", modelId: "us.anthropic.claude-sonnet-4-20250514-v1:0" }
+ */
+export function parseModelSpec(modelSpec, defaultProvider = "bedrock") {
+    const slashIndex = modelSpec.indexOf("/");
+    if (slashIndex === -1) {
+        // No provider prefix, use default
+        return { provider: defaultProvider, modelId: modelSpec };
+    }
+    const providerPart = modelSpec.substring(0, slashIndex).toLowerCase();
+    const modelId = modelSpec.substring(slashIndex + 1);
+    // Validate provider
+    if (providerPart === "bedrock" || providerPart === "openai") {
+        return { provider: providerPart, modelId };
+    }
+    // Unknown provider prefix - treat the whole thing as a model ID
+    return { provider: defaultProvider, modelId: modelSpec };
+}
+/**
+ * Create a Model instance from a parsed model specification
+ */
+export function createModel(spec) {
+    switch (spec.provider) {
+        case "bedrock":
+            return new BedrockModel({ modelId: spec.modelId });
+        case "openai": {
+            // Dynamic import to avoid requiring openai package when not used
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { OpenAIModel } = require("@strands-agents/sdk/openai");
+            return new OpenAIModel({ modelId: spec.modelId });
+        }
+        default:
+            throw new Error(`Unsupported model provider: ${spec.provider}`);
+    }
+}
+/**
+ * Create a Model instance from a model specification string
+ */
+export function createModelFromSpec(modelSpec, defaultProvider = "bedrock") {
+    const parsed = parseModelSpec(modelSpec, defaultProvider);
+    return createModel(parsed);
+}
+//# sourceMappingURL=model-factory.js.map

package/dist/model-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-factory.js","sourceRoot":"","sources":["../src/model-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAe3D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC7B,SAAiB,EACjB,kBAAiC,SAAS;IAE1C,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1C,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,kCAAkC;QAClC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC1D,CAAC;IAED,MAAM,YAAY,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IACtE,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAEpD,oBAAoB;IACpB,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC7D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,gEAAgE;IAChE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAqB;IAChD,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,KAAK,SAAS;YACb,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,iEAAiE;YACjE,iEAAiE;YACjE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;YAC9D,OAAO,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;QACD;YACC,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,SAAiB,EACjB,kBAAiC,SAAS;IAE1C,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC1D,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/orchestrator/default-orchestrator.d.ts

@@ -0,0 +1,7 @@
+import type { SOPDefinition } from "../types/types.js";
+/**
+ * Default orchestrator SOP that ships with the package.
+ * Used when no orchestrator.md is found in the user's SOP directory.
+ */
+export declare const DEFAULT_ORCHESTRATOR: SOPDefinition;
+//# sourceMappingURL=default-orchestrator.d.ts.map

package/dist/orchestrator/default-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/default-orchestrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,aA2ClC,CAAC"}

package/dist/orchestrator/default-orchestrator.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+/**
+ * Default orchestrator SOP that ships with the package.
+ * Used when no orchestrator.md is found in the user's SOP directory.
+ */
+export const DEFAULT_ORCHESTRATOR = {
+    name: "orchestrator",
+    description: "Master orchestrator that delegates tasks to specialized agents",
+    version: "1.0.0",
+    type: "orchestrator",
+    tools: [],
+    inputs: {},
+    filepath: "<built-in>",
+    zodSchema: z.object({ task: z.string().describe("The task to perform") }),
+    body: `# Task Orchestrator
+
+## Overview
+
+You are a master orchestrator responsible for coordinating multiple specialized agents to complete complex tasks.
+
+## Steps
+
+### 1. Analyze Request
+
+Parse the incoming request to understand what needs to be accomplished.
+
+**Constraints:**
+- You MUST identify all subtasks required to fulfill the request
+- You SHOULD break complex requests into smaller, manageable tasks
+
+### 2. Delegate to Agents
+
+Invoke the appropriate specialized agents for each subtask.
+
+**Constraints:**
+- You MUST choose the most appropriate agent for each subtask
+- You MUST pass relevant context between agent calls
+- You SHOULD handle agent errors gracefully
+- You MUST ask the user for more detail if you do not have sufficient inputs for agent execution
+
+### 3. Synthesize Results
+
+Combine outputs from all agents into a coherent response.
+
+**Constraints:**
+- You MUST include the actual content produced by agents (poems, jokes, stories, etc.) in your response because the user wants to see the content, not just a description of it
+- You MUST provide a unified response that addresses the original request
+- You MAY add brief context before or after the agent's output`,
+};
+//# sourceMappingURL=default-orchestrator.js.map

package/dist/orchestrator/default-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-orchestrator.js","sourceRoot":"","sources":["../../src/orchestrator/default-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IAClD,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,gEAAgE;IAC7E,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,YAAY;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;IACzE,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAiCwD;CAC9D,CAAC"}

package/dist/orchestrator/orchestrator.d.ts

@@ -0,0 +1,47 @@
+import type { InvokeOptions, InvokeResult, Orchestrator, OrchestratorConfig, OrchestratorStreamEvent, SOPDefinition } from "../types/types.js";
+/**
+ * OrchestratorImpl class implementing the Orchestrator interface
+ */
+export declare class OrchestratorImpl implements Orchestrator {
+    private readonly _config;
+    private registry;
+    private orchestratorAgent;
+    private orchestratorSOP;
+    private logger;
+    private currentCorrelationId?;
+    constructor(config?: OrchestratorConfig);
+    /**
+     * Current configuration (readonly for inspection)
+     */
+    get config(): OrchestratorConfig;
+    /**
+     * Initialize the orchestrator by discovering agents and creating tools
+     */
+    initialize(): Promise<void>;
+    /**
+     * Process a request through the orchestrator agent
+     */
+    invoke(request: string): Promise<string>;
+    invoke(request: string, options: InvokeOptions): Promise<InvokeResult>;
+    /**
+     * Stream events from the orchestrator in real-time
+     */
+    stream(request: string): AsyncGenerator<OrchestratorStreamEvent>;
+    /**
+     * Clear agent cache
+     */
+    clearCache(): void;
+    /**
+     * Get the agent registry (for inspection/debugging)
+     */
+    getRegistry(): Map<string, SOPDefinition>;
+    /**
+     * Wrap tools with error handling and logging
+     */
+    private wrapToolsWithErrorHandling;
+}
+/**
+ * Factory function to create and initialize an orchestrator
+ */
+export declare function createOrchestrator(config?: OrchestratorConfig): Promise<Orchestrator>;
+//# sourceMappingURL=orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/orchestrator.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEX,aAAa,EACb,YAAY,EAGZ,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,MAAM,mBAAmB,CAAC;AAqB3B;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,oBAAoB,CAAC,CAAS;gBAE1B,MAAM,GAAE,kBAAuB;IAmB3C;;OAEG;IACH,IAAI,MAAM,IAAI,kBAAkB,CAE/B;IAED;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCjC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACxC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA0GtE;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,uBAAuB,CAAC;IAiCvE;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAIzC;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAwGlC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,GAAE,kBAAuB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAIvB"}

package/dist/orchestrator/orchestrator.js

@@ -0,0 +1,276 @@
+import { Agent as StrandsAgent } from "@strands-agents/sdk";
+import { discoverAgents, findOrchestrator } from "../agents/discovery.js";
+import { clearCache as clearToolCache, createAllTools, getOrCreateAgent, setDefaultModelSpec, setDefaultProvider, setPrinterEnabled, } from "../agents/tool-generator.js";
+import { LoggerImpl } from "../logger.js";
+import { createModelFromSpec } from "../model-factory.js";
+import { AgentInvocationError } from "../types/errors.js";
+/**
+ * Generate a unique correlation ID for request tracing
+ */
+function generateCorrelationId() {
+    return `req-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * OrchestratorImpl class implementing the Orchestrator interface
+ */
+export class OrchestratorImpl {
+    _config;
+    registry = new Map();
+    orchestratorAgent = null;
+    orchestratorSOP = null;
+    logger;
+    currentCorrelationId;
+    constructor(config = {}) {
+        this._config = {
+            directory: config.directory ?? "./sops",
+            errorMode: config.errorMode ?? "fail-fast",
+            logLevel: config.logLevel ?? "info",
+            defaultModel: config.defaultModel,
+            defaultProvider: config.defaultProvider ?? "bedrock",
+            showThinking: config.showThinking ?? false,
+        };
+        this.logger = new LoggerImpl(this._config.logLevel);
+        // Set the default model and provider for tool-generator
+        setDefaultModelSpec(this._config.defaultModel);
+        setDefaultProvider(this._config.defaultProvider);
+        // Only print agent output to console in debug mode
+        setPrinterEnabled(this._config.logLevel === "debug");
+    }
+    /**
+     * Current configuration (readonly for inspection)
+     */
+    get config() {
+        return { ...this._config };
+    }
+    /**
+     * Initialize the orchestrator by discovering agents and creating tools
+     */
+    async initialize() {
+        const directory = this._config.directory ?? "./sops";
+        // Discover agents
+        this.registry = await discoverAgents(directory);
+        // Find orchestrator SOP
+        this.orchestratorSOP = await findOrchestrator(directory);
+        // Create tools for all agents
+        const tools = createAllTools(this.registry);
+        // Wrap tools with error handling and logging
+        const wrappedTools = this.wrapToolsWithErrorHandling(tools);
+        // Determine model for orchestrator (SOP-specific, config default, or Strands default)
+        const orchestratorModelSpec = this.orchestratorSOP.model ?? this._config.defaultModel;
+        // Create orchestrator agent with SOP body as system prompt
+        const agentConfig = {
+            systemPrompt: this.orchestratorSOP.body,
+            tools: wrappedTools,
+            printer: this._config.logLevel === "debug",
+        };
+        if (orchestratorModelSpec) {
+            agentConfig.model = createModelFromSpec(orchestratorModelSpec, this._config.defaultProvider);
+        }
+        this.orchestratorAgent = new StrandsAgent(agentConfig);
+    }
+    async invoke(request, options) {
+        if (!this.orchestratorAgent) {
+            throw new Error("Orchestrator not initialized. Call initialize() first.");
+        }
+        const showThinking = options?.showThinking ?? this._config.showThinking;
+        // Generate correlation ID for request and store it for tool access
+        const correlationId = generateCorrelationId();
+        this.currentCorrelationId = correlationId;
+        const requestLogger = this.logger.withCorrelationId(correlationId);
+        // Log request start
+        requestLogger.info(`Processing request: ${request.substring(0, 100)}...`, {
+            requestLength: request.length,
+        });
+        const startTime = Date.now();
+        const thinking = [];
+        const toolCalls = [];
+        let responseText = "";
+        try {
+            // Use streaming to capture thinking and tool calls
+            for await (const event of this.orchestratorAgent.stream(request)) {
+                // Capture thinking/reasoning content
+                if (event.type === "modelContentBlockDeltaEvent" &&
+                    // biome-ignore lint/suspicious/noExplicitAny: SDK event types vary
+                    event.delta?.type === "thinkingDelta") {
+                    // biome-ignore lint/suspicious/noExplicitAny: SDK event types vary
+                    const thinkingText = event.delta?.thinking;
+                    if (thinkingText && showThinking) {
+                        thinking.push(thinkingText);
+                        requestLogger.debug(`Thinking: ${thinkingText.substring(0, 100)}...`);
+                    }
+                }
+                // Capture text content
+                if (event.type === "modelContentBlockDeltaEvent" &&
+                    // biome-ignore lint/suspicious/noExplicitAny: SDK event types vary
+                    event.delta?.type === "textDelta") {
+                    // biome-ignore lint/suspicious/noExplicitAny: SDK event types vary
+                    responseText += event.delta?.text ?? "";
+                }
+                // Capture tool use starts
+                if (event.type === "modelContentBlockStartEvent" &&
+                    // biome-ignore lint/suspicious/noExplicitAny: SDK event types vary
+                    event.start?.type === "toolUseStart") {
+                    // biome-ignore lint/suspicious/noExplicitAny: SDK event types vary
+                    const toolName = event.start?.name;
+                    if (toolName) {
+                        requestLogger.debug(`Tool selected: ${toolName}`);
+                    }
+                }
+                // Capture tool calls from beforeToolsEvent
+                if (event.type === "beforeToolsEvent") {
+                    // biome-ignore lint/suspicious/noExplicitAny: SDK event types vary
+                    const toolUses = event.toolUses;
+                    if (Array.isArray(toolUses)) {
+                        for (const toolUse of toolUses) {
+                            toolCalls.push({
+                                name: toolUse.name,
+                                input: toolUse.input,
+                            });
+                        }
+                    }
+                }
+            }
+            const duration = Date.now() - startTime;
+            requestLogger.info(`Request completed in ${duration}ms`);
+            // Return string if no options, InvokeResult if options provided
+            if (options) {
+                return {
+                    response: responseText,
+                    thinking: thinking.length > 0 ? thinking : undefined,
+                    toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+                };
+            }
+            return responseText;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            requestLogger.error(`Request failed after ${duration}ms`, error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+    /**
+     * Stream events from the orchestrator in real-time
+     */
+    async *stream(request) {
+        if (!this.orchestratorAgent) {
+            throw new Error("Orchestrator not initialized. Call initialize() first.");
+        }
+        // Generate correlation ID for request and store it for tool access
+        const correlationId = generateCorrelationId();
+        this.currentCorrelationId = correlationId;
+        const requestLogger = this.logger.withCorrelationId(correlationId);
+        requestLogger.info(`Streaming request: ${request.substring(0, 100)}...`, {
+            requestLength: request.length,
+        });
+        const startTime = Date.now();
+        try {
+            for await (const event of this.orchestratorAgent.stream(request)) {
+                yield event;
+            }
+            const duration = Date.now() - startTime;
+            requestLogger.info(`Stream completed in ${duration}ms`);
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            requestLogger.error(`Stream failed after ${duration}ms`, error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+    /**
+     * Clear agent cache
+     */
+    clearCache() {
+        clearToolCache();
+    }
+    /**
+     * Get the agent registry (for inspection/debugging)
+     */
+    getRegistry() {
+        return new Map(this.registry);
+    }
+    /**
+     * Wrap tools with error handling and logging
+     */
+    wrapToolsWithErrorHandling(tools) {
+        return tools.map((originalTool) => {
+            const agentName = originalTool.name.replace(/^agent_/, "");
+            const sop = this.registry.get(agentName);
+            const wrappedInvoke = async (input) => {
+                // Get logger with current correlation ID and agent name
+                const agentLogger = this.currentCorrelationId
+                    ? this.logger
+                        .withCorrelationId(this.currentCorrelationId)
+                        .withAgent(agentName)
+                    : this.logger.withAgent(agentName);
+                const task = input.task;
+                const startTime = Date.now();
+                agentLogger.debug("Tool invoke called", { input });
+                // Ensure agent is created with logger for model info
+                if (sop) {
+                    getOrCreateAgent(sop, agentLogger);
+                }
+                agentLogger.info(`Invoking agent with task: "${task?.substring(0, 80) ?? "NO TASK"}..."`);
+                try {
+                    const result = await originalTool.invoke(input);
+                    const duration = Date.now() - startTime;
+                    // Log completion with output preview
+                    const outputPreview = result.substring(0, 200);
+                    agentLogger.info(`Completed in ${duration}ms (${result.length} chars)`);
+                    agentLogger.debug(`Output preview: ${outputPreview}...`);
+                    return result;
+                }
+                catch (error) {
+                    const duration = Date.now() - startTime;
+                    const originalError = error instanceof Error ? error : new Error(String(error));
+                    agentLogger.error(`Failed after ${duration}ms: ${originalError.message}`, originalError);
+                    if (this._config.errorMode === "fail-fast") {
+                        throw new AgentInvocationError(agentName, task, originalError);
+                    }
+                    return JSON.stringify({
+                        success: false,
+                        agentName,
+                        error: {
+                            message: originalError.message,
+                            code: "AGENT_INVOCATION_ERROR",
+                        },
+                    });
+                }
+            };
+            // Wrapped stream generator with logging
+            const wrappedStream = (toolContext) => {
+                const streamLogger = this.currentCorrelationId
+                    ? this.logger
+                        .withCorrelationId(this.currentCorrelationId)
+                        .withAgent(agentName)
+                    : this.logger.withAgent(agentName);
+                const input = toolContext.toolUse.input;
+                const task = input?.task;
+                // Ensure agent is created with logger for model info
+                if (sop) {
+                    getOrCreateAgent(sop, streamLogger);
+                }
+                streamLogger.info(`Invoking agent with task: "${task?.substring(0, 80) ?? "NO TASK"}..."`);
+                // Return the original stream - logging happens at invoke level
+                return originalTool.stream(toolContext);
+            };
+            // Create a new tool object with the wrapped invoke and stream
+            const wrappedTool = {
+                name: originalTool.name,
+                description: originalTool.description,
+                toolSpec: originalTool.toolSpec,
+                invoke: wrappedInvoke,
+                stream: wrappedStream,
+            };
+            return wrappedTool;
+        });
+    }
+}
+/**
+ * Factory function to create and initialize an orchestrator
+ */
+export async function createOrchestrator(config = {}) {
+    const orchestrator = new OrchestratorImpl(config);
+    await orchestrator.initialize();
+    return orchestrator;
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator/orchestrator.js.map

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

package/dist/orchestrator.d.ts

@@ -0,0 +1,50 @@
+import type { InvokeResult, Orchestrator, OrchestratorConfig, OrchestratorStreamEvent, SOPDefinition } from "./types.js";
+/**
+ * OrchestratorImpl class implementing the Orchestrator interface
+ */
+export declare class OrchestratorImpl implements Orchestrator {
+    private readonly _config;
+    private registry;
+    private orchestratorAgent;
+    private orchestratorSOP;
+    private logger;
+    private currentCorrelationId?;
+    constructor(config?: OrchestratorConfig);
+    /**
+     * Current configuration (readonly for inspection)
+     */
+    get config(): OrchestratorConfig;
+    /**
+     * Initialize the orchestrator by discovering agents and creating tools
+     */
+    initialize(): Promise<void>;
+    /**
+     * Process a request through the orchestrator agent
+     */
+    invoke(request: string): Promise<string>;
+    /**
+     * Process a request and return detailed result including thinking
+     */
+    invokeWithDetails(request: string): Promise<InvokeResult>;
+    /**
+     * Stream events from the orchestrator in real-time
+     */
+    stream(request: string): AsyncGenerator<OrchestratorStreamEvent>;
+    /**
+     * Clear agent cache
+     */
+    clearCache(): void;
+    /**
+     * Get the agent registry (for inspection/debugging)
+     */
+    getRegistry(): Map<string, SOPDefinition>;
+    /**
+     * Wrap tools with error handling and logging
+     */
+    private wrapToolsWithErrorHandling;
+}
+/**
+ * Factory function to create and initialize an orchestrator
+ */
+export declare function createOrchestrator(config?: OrchestratorConfig): Promise<Orchestrator>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEX,YAAY,EAGZ,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,MAAM,YAAY,CAAC;AAqBpB;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,oBAAoB,CAAC,CAAS;gBAE1B,MAAM,GAAE,kBAAuB;IAmB3C;;OAEG;IACH,IAAI,MAAM,IAAI,kBAAkB,CAE/B;IAED;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCjC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9C;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgG/D;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,uBAAuB,CAAC;IAiCvE;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAIzC;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAwGlC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,GAAE,kBAAuB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAIvB"}