@serverless-dna/sop-agents 0.1.0

package/dist/orchestrator.js

@@ -0,0 +1,281 @@
+import { Agent as StrandsAgent } from "@strands-agents/sdk";
+import { discoverAgents, findOrchestrator } from "./agent-discovery.js";
+import { AgentInvocationError } from "./errors.js";
+import { LoggerImpl } from "./logger.js";
+import { createModelFromSpec } from "./model-factory.js";
+import { clearCache as clearToolCache, createAllTools, getOrCreateAgent, setDefaultModelSpec, setDefaultProvider, setPrinterEnabled, } from "./tool-generator.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);
+    }
+    /**
+     * Process a request through the orchestrator agent
+     */
+    async invoke(request) {
+        const result = await this.invokeWithDetails(request);
+        return result.response;
+    }
+    /**
+     * Process a request and return detailed result including thinking
+     */
+    async invokeWithDetails(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);
+        // 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 && this._config.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 {
+                response: responseText,
+                thinking: thinking.length > 0 ? thinking : undefined,
+                toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+            };
+        }
+        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.js.map

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

package/dist/sop-loader.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import type { InputDef, SOPDefinition, SOPFrontmatter } from "./types.js";
+/**
+ * Validates frontmatter data against the SOPFrontmatter schema
+ * @throws FrontmatterValidationError if validation fails
+ */
+export declare function validateFrontmatter(data: unknown, filepath: string): SOPFrontmatter;
+/**
+ * Generates a Zod schema from input definitions
+ * Always includes a required 'task' field
+ */
+export declare function generateZodSchema(inputs?: Record<string, InputDef>): z.ZodObject<z.ZodRawShape>;
+/**
+ * Loads and parses an SOP file
+ * @throws FileNotFoundError if file doesn't exist
+ * @throws FrontmatterParseError if YAML is malformed
+ * @throws FrontmatterValidationError if frontmatter validation fails
+ */
+export declare function loadSOP(filepath: string): Promise<SOPDefinition>;
+//# sourceMappingURL=sop-loader.d.ts.map

package/dist/sop-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sop-loader.d.ts","sourceRoot":"","sources":["../src/sop-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACd,cAAc,CA4EhB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC/B,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAoD5B;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA6CtE"}

package/dist/sop-loader.js

@@ -0,0 +1,150 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import matter from "gray-matter";
+import { z } from "zod";
+import { FileNotFoundError, FrontmatterParseError, FrontmatterValidationError, } from "./errors.js";
+/**
+ * Validates frontmatter data against the SOPFrontmatter schema
+ * @throws FrontmatterValidationError if validation fails
+ */
+export function validateFrontmatter(data, filepath) {
+    if (typeof data !== "object" || data === null) {
+        throw new FrontmatterValidationError(filepath, "frontmatter", "must be an object");
+    }
+    const obj = data;
+    // Validate required 'name' field
+    if (!("name" in obj) || obj.name === undefined || obj.name === null) {
+        throw new FrontmatterValidationError(filepath, "name", "is required but missing");
+    }
+    if (typeof obj.name !== "string" || obj.name.trim() === "") {
+        throw new FrontmatterValidationError(filepath, "name", "must be a non-empty string");
+    }
+    // Validate required 'description' field
+    if (!("description" in obj) ||
+        obj.description === undefined ||
+        obj.description === null) {
+        throw new FrontmatterValidationError(filepath, "description", "is required but missing");
+    }
+    if (typeof obj.description !== "string" || obj.description.trim() === "") {
+        throw new FrontmatterValidationError(filepath, "description", "must be a non-empty string");
+    }
+    // Validate 'type' field if present
+    if ("type" in obj && obj.type !== undefined) {
+        if (obj.type !== "agent" && obj.type !== "orchestrator") {
+            throw new FrontmatterValidationError(filepath, "type", 'must be either "agent" or "orchestrator"');
+        }
+    }
+    // Validate optional fields
+    const version = typeof obj.version === "string" ? obj.version : undefined;
+    const tools = Array.isArray(obj.tools) ? obj.tools : undefined;
+    const inputs = typeof obj.inputs === "object" && obj.inputs !== null
+        ? obj.inputs
+        : undefined;
+    const model = typeof obj.model === "string" ? obj.model : undefined;
+    return {
+        name: obj.name,
+        description: obj.description,
+        version,
+        tools,
+        inputs,
+        type: obj.type ?? "agent", // Default to "agent"
+        model,
+    };
+}
+/**
+ * Generates a Zod schema from input definitions
+ * Always includes a required 'task' field
+ */
+export function generateZodSchema(inputs) {
+    const shape = {
+        task: z.string().describe("The specific task to perform"),
+    };
+    if (inputs) {
+        for (const [fieldName, inputDef] of Object.entries(inputs)) {
+            let fieldSchema;
+            // Map InputDef type to Zod type
+            switch (inputDef.type) {
+                case "string":
+                    fieldSchema = z.string();
+                    break;
+                case "number":
+                    fieldSchema = z.number();
+                    break;
+                case "boolean":
+                    fieldSchema = z.boolean();
+                    break;
+                case "enum":
+                    if (inputDef.values && inputDef.values.length > 0) {
+                        fieldSchema = z.enum(inputDef.values);
+                    }
+                    else {
+                        fieldSchema = z.string();
+                    }
+                    break;
+                case "list":
+                    fieldSchema = z.array(z.string());
+                    break;
+                default:
+                    fieldSchema = z.string();
+            }
+            // Apply description
+            fieldSchema = fieldSchema.describe(inputDef.description);
+            // Apply default value if specified
+            if (inputDef.default !== undefined) {
+                fieldSchema = fieldSchema.default(inputDef.default);
+            }
+            // Apply optional if required is false
+            if (inputDef.required === false) {
+                fieldSchema = fieldSchema.optional();
+            }
+            shape[fieldName] = fieldSchema;
+        }
+    }
+    return z.object(shape);
+}
+/**
+ * Loads and parses an SOP file
+ * @throws FileNotFoundError if file doesn't exist
+ * @throws FrontmatterParseError if YAML is malformed
+ * @throws FrontmatterValidationError if frontmatter validation fails
+ */
+export async function loadSOP(filepath) {
+    // Check if file exists
+    if (!fs.existsSync(filepath)) {
+        throw new FileNotFoundError(filepath);
+    }
+    // Read file content
+    const content = fs.readFileSync(filepath, "utf-8");
+    // Parse with gray-matter
+    let parsed;
+    try {
+        parsed = matter(content);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new FrontmatterParseError(filepath, errorMessage);
+    }
+    // Validate frontmatter
+    const frontmatter = validateFrontmatter(parsed.data, filepath);
+    // Check if name matches filename (log warning if not)
+    const filename = path.basename(filepath, ".md");
+    if (frontmatter.name !== filename) {
+        console.warn(`Warning: SOP name "${frontmatter.name}" does not match filename "${filename}" in ${filepath}`);
+    }
+    // Generate Zod schema from inputs
+    const zodSchema = generateZodSchema(frontmatter.inputs);
+    // Return complete SOPDefinition
+    return {
+        name: frontmatter.name,
+        description: frontmatter.description,
+        version: frontmatter.version ?? "1.0.0",
+        tools: frontmatter.tools ?? [],
+        inputs: frontmatter.inputs ?? {},
+        body: parsed.content.trim(),
+        filepath,
+        type: frontmatter.type ?? "agent",
+        zodSchema,
+        model: frontmatter.model,
+    };
+}
+//# sourceMappingURL=sop-loader.js.map

package/dist/sop-loader.js.map

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

package/dist/tool-generator.d.ts

@@ -0,0 +1,66 @@
+import type { InvokableTool } from "@strands-agents/sdk";
+import { Agent } from "@strands-agents/sdk";
+import { type ModelProvider } from "./model-factory.js";
+import type { SOPDefinition } from "./types.js";
+/**
+ * Builds a structured prompt for the agent from task and input parameters
+ * @param task - The specific task to perform
+ * @param inputs - Input parameters for the task
+ * @returns Formatted prompt string
+ */
+export declare function buildAgentPrompt(task: string, inputs: Record<string, unknown>): string;
+/**
+ * Gets or creates a cached agent instance for the given SOP
+ * @param sop - The SOP definition to create an agent for
+ * @param logger - Optional logger for logging agent creation
+ * @returns The agent instance (cached or newly created)
+ */
+export declare function getOrCreateAgent(sop: SOPDefinition, logger?: {
+    info: (msg: string) => void;
+}): Agent;
+/**
+ * Sets the default model spec for creating new agents
+ * @param modelSpec - The model spec to use as default (e.g., "bedrock/us.anthropic.claude-sonnet-4-20250514-v1:0")
+ */
+export declare function setDefaultModelSpec(modelSpec: string | undefined): void;
+/**
+ * Gets the current default model spec (undefined means Strands default)
+ */
+export declare function getDefaultModelSpec(): string | undefined;
+/**
+ * Sets the default provider when model spec has no provider prefix
+ * @param provider - The default provider ("bedrock" or "openai")
+ */
+export declare function setDefaultProvider(provider: ModelProvider): void;
+/**
+ * Gets the current default provider
+ */
+export declare function getDefaultProvider(): ModelProvider;
+/**
+ * Sets whether agent output should be printed to console
+ * @param enabled - true to print output (debug), false to suppress (production)
+ */
+export declare function setPrinterEnabled(enabled: boolean): void;
+/**
+ * Gets whether printer is enabled
+ */
+export declare function isPrinterEnabled(): boolean;
+/**
+ * Clears the agent cache
+ */
+export declare function clearCache(): void;
+/**
+ * Creates a Strands tool from an SOP definition
+ * Tool name follows pattern: agent_{sop.name}
+ * Uses async generator to stream sub-agent output
+ * @param sop - The SOP definition to create a tool from
+ * @returns An InvokableTool that delegates to the agent
+ */
+export declare function createTool(sop: SOPDefinition): InvokableTool<Record<string, unknown>, string>;
+/**
+ * Creates tools for all agents in a registry
+ * @param registry - Map of agent names to SOP definitions
+ * @returns Array of InvokableTool instances
+ */
+export declare function createAllTools(registry: Map<string, SOPDefinition>): InvokableTool<Record<string, unknown>, string>[];
+//# sourceMappingURL=tool-generator.d.ts.map

package/dist/tool-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-generator.d.ts","sourceRoot":"","sources":["../src/tool-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAQ,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAEN,KAAK,aAAa,EAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsBhD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,aAAa,EAClB,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACtC,KAAK,CA+BP;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAEhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAElD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACzB,GAAG,EAAE,aAAa,GAChB,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CA6ChD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAClC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,CAQlD"}