crewly 1.8.9 → 1.8.12

package/dist/backend/backend/src/services/agent/crewly-agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAiB,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAA0B,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAWL,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/backend/backend/src/services/agent/crewly-agent/mcp-tool-bridge.d.ts

@@ -0,0 +1,135 @@
+/**
+ * MCP Tool Bridge
+ *
+ * Converts external MCP server tools into Crewly Agent ToolDefinitions
+ * so they can be used alongside built-in tools during agent execution.
+ * All MCP-sourced tools default to 'sensitive' classification for audit
+ * purposes unless explicitly overridden.
+ *
+ * @module services/agent/crewly-agent/mcp-tool-bridge
+ */
+import { z } from 'zod';
+import type { McpClientService, McpToolInfo, McpServerConfig } from '../../mcp-client.js';
+import type { ToolDefinition, ToolSensitivity } from './types.js';
+/**
+ * Prefix applied to MCP tool names to avoid collisions with built-in tools.
+ */
+export declare const MCP_TOOL_PREFIX: "mcp_";
+/**
+ * Default sensitivity for MCP-sourced tools.
+ * External tools are classified as 'sensitive' because they interact
+ * with systems outside the agent's direct control.
+ */
+export declare const MCP_DEFAULT_SENSITIVITY: ToolSensitivity;
+/**
+ * Configuration for MCP tool sensitivity overrides.
+ * Maps `serverName:toolName` or just `toolName` to a sensitivity level.
+ *
+ * @example
+ * ```typescript
+ * const overrides: McpSensitivityOverrides = {
+ *   'filesystem:read_file': 'safe',
+ *   'github:create_issue': 'sensitive',
+ *   'admin:drop_database': 'destructive',
+ * };
+ * ```
+ */
+export type McpSensitivityOverrides = Record<string, ToolSensitivity>;
+/**
+ * Convert a JSON Schema object from an MCP tool into a Zod schema.
+ *
+ * MCP tools declare their input using JSON Schema. The AI SDK expects
+ * Zod schemas. This function creates a z.object({}) passthrough schema
+ * that accepts any object — actual validation is done server-side by
+ * the MCP server itself.
+ *
+ * @param inputSchema - JSON Schema from the MCP tool definition
+ * @returns A Zod schema that passes through any object
+ */
+export declare function jsonSchemaToZodPassthrough(inputSchema: Record<string, unknown>): z.ZodType;
+/**
+ * Build the namespaced tool name for an MCP tool.
+ *
+ * Format: `mcp_{serverName}_{toolName}` to prevent collisions
+ * with built-in Crewly tools and tools from other MCP servers.
+ *
+ * @param serverName - Name of the MCP server
+ * @param toolName - Original tool name from the MCP server
+ * @returns Namespaced tool name
+ */
+export declare function buildMcpToolName(serverName: string, toolName: string): string;
+/**
+ * Resolve the sensitivity level for an MCP tool.
+ *
+ * Checks overrides in order of specificity:
+ * 1. `serverName:toolName` (most specific)
+ * 2. `toolName` (tool-level default)
+ * 3. Falls back to MCP_DEFAULT_SENSITIVITY ('sensitive')
+ *
+ * @param serverName - Name of the MCP server
+ * @param toolName - Original tool name
+ * @param overrides - Optional sensitivity overrides map
+ * @returns Resolved sensitivity level
+ */
+export declare function resolveSensitivity(serverName: string, toolName: string, overrides?: McpSensitivityOverrides): ToolSensitivity;
+/**
+ * Convert a single MCP tool into a Crewly ToolDefinition.
+ *
+ * The resulting tool definition:
+ * - Has a namespaced name (`mcp_{server}_{tool}`)
+ * - Uses a passthrough Zod schema for input validation
+ * - Delegates execution to McpClientService.callTool()
+ * - Defaults to 'sensitive' classification for auditing
+ *
+ * @param mcpClient - The MCP client service for executing tool calls
+ * @param toolInfo - Tool metadata from the MCP server
+ * @param overrides - Optional sensitivity overrides
+ * @returns A ToolDefinition compatible with the Crewly Agent runtime
+ */
+export declare function convertMcpTool(mcpClient: McpClientService, toolInfo: McpToolInfo, overrides?: McpSensitivityOverrides): ToolDefinition;
+/**
+ * Load all tools from connected MCP servers and convert them to ToolDefinitions.
+ *
+ * This is the primary entry point for integrating MCP tools into the agent
+ * runtime. It queries all connected MCP servers, converts their tools to
+ * the Crewly ToolDefinition format, and returns a map ready to merge with
+ * the built-in tool registry.
+ *
+ * @param mcpClient - The MCP client service with active server connections
+ * @param overrides - Optional sensitivity overrides
+ * @returns Map of namespaced tool name -> ToolDefinition
+ *
+ * @example
+ * ```typescript
+ * const mcpClient = new McpClientService();
+ * await mcpClient.connectServer('filesystem', config);
+ * const mcpTools = loadMcpTools(mcpClient);
+ * // mcpTools = { mcp_filesystem_read_file: {...}, mcp_filesystem_write_file: {...} }
+ * ```
+ */
+export declare function loadMcpTools(mcpClient: McpClientService, overrides?: McpSensitivityOverrides): Record<string, ToolDefinition>;
+/**
+ * Connect to MCP servers and load their tools in one step.
+ *
+ * Convenience function that handles the full lifecycle:
+ * 1. Connects to all configured MCP servers (tolerates failures)
+ * 2. Loads and converts all available tools
+ * 3. Returns tools ready to merge into the agent's tool registry
+ *
+ * @param mcpClient - The MCP client service instance
+ * @param serverConfigs - Map of server name -> server configuration
+ * @param overrides - Optional sensitivity overrides
+ * @returns Object with loaded tools and any connection errors
+ *
+ * @example
+ * ```typescript
+ * const { tools, errors } = await connectAndLoadMcpTools(mcpClient, {
+ *   filesystem: { command: 'npx', args: ['-y', '@anthropic/mcp-filesystem'] },
+ * });
+ * ```
+ */
+export declare function connectAndLoadMcpTools(mcpClient: McpClientService, serverConfigs: Record<string, McpServerConfig>, overrides?: McpSensitivityOverrides): Promise<{
+    tools: Record<string, ToolDefinition>;
+    errors: Map<string, Error>;
+}>;
+//# sourceMappingURL=mcp-tool-bridge.d.ts.map

package/dist/backend/backend/src/services/agent/crewly-agent/mcp-tool-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-bridge.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/mcp-tool-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAG,MAAe,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAA6B,CAAC;AAEpE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,CAAC,CAAC,OAAO,CAeX;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,uBAAuB,GAClC,eAAe,CAYjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,SAAS,CAAC,EAAE,uBAAuB,GAClC,cAAc,CAwChB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,gBAAgB,EAC3B,SAAS,CAAC,EAAE,uBAAuB,GAClC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAUhC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,gBAAgB,EAC3B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC9C,SAAS,CAAC,EAAE,uBAAuB,GAClC,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;CAAE,CAAC,CAIhF"}

package/dist/backend/backend/src/services/agent/crewly-agent/mcp-tool-bridge.js

@@ -0,0 +1,185 @@
+/**
+ * MCP Tool Bridge
+ *
+ * Converts external MCP server tools into Crewly Agent ToolDefinitions
+ * so they can be used alongside built-in tools during agent execution.
+ * All MCP-sourced tools default to 'sensitive' classification for audit
+ * purposes unless explicitly overridden.
+ *
+ * @module services/agent/crewly-agent/mcp-tool-bridge
+ */
+import { z } from 'zod';
+/**
+ * Prefix applied to MCP tool names to avoid collisions with built-in tools.
+ */
+export const MCP_TOOL_PREFIX = 'mcp_';
+/**
+ * Default sensitivity for MCP-sourced tools.
+ * External tools are classified as 'sensitive' because they interact
+ * with systems outside the agent's direct control.
+ */
+export const MCP_DEFAULT_SENSITIVITY = 'sensitive';
+/**
+ * Convert a JSON Schema object from an MCP tool into a Zod schema.
+ *
+ * MCP tools declare their input using JSON Schema. The AI SDK expects
+ * Zod schemas. This function creates a z.object({}) passthrough schema
+ * that accepts any object — actual validation is done server-side by
+ * the MCP server itself.
+ *
+ * @param inputSchema - JSON Schema from the MCP tool definition
+ * @returns A Zod schema that passes through any object
+ */
+export function jsonSchemaToZodPassthrough(inputSchema) {
+    // Extract property names from JSON Schema for documentation,
+    // but use a passthrough object since the MCP server validates inputs.
+    const properties = inputSchema.properties;
+    if (properties && typeof properties === 'object') {
+        const shape = {};
+        for (const key of Object.keys(properties)) {
+            shape[key] = z.unknown().optional().describe(String(properties[key]?.description || key));
+        }
+        return z.object(shape).passthrough();
+    }
+    // Fallback: accept any object
+    return z.record(z.unknown());
+}
+/**
+ * Build the namespaced tool name for an MCP tool.
+ *
+ * Format: `mcp_{serverName}_{toolName}` to prevent collisions
+ * with built-in Crewly tools and tools from other MCP servers.
+ *
+ * @param serverName - Name of the MCP server
+ * @param toolName - Original tool name from the MCP server
+ * @returns Namespaced tool name
+ */
+export function buildMcpToolName(serverName, toolName) {
+    return `${MCP_TOOL_PREFIX}${serverName}_${toolName}`;
+}
+/**
+ * Resolve the sensitivity level for an MCP tool.
+ *
+ * Checks overrides in order of specificity:
+ * 1. `serverName:toolName` (most specific)
+ * 2. `toolName` (tool-level default)
+ * 3. Falls back to MCP_DEFAULT_SENSITIVITY ('sensitive')
+ *
+ * @param serverName - Name of the MCP server
+ * @param toolName - Original tool name
+ * @param overrides - Optional sensitivity overrides map
+ * @returns Resolved sensitivity level
+ */
+export function resolveSensitivity(serverName, toolName, overrides) {
+    if (!overrides)
+        return MCP_DEFAULT_SENSITIVITY;
+    // Check server-specific override first
+    const serverSpecific = overrides[`${serverName}:${toolName}`];
+    if (serverSpecific)
+        return serverSpecific;
+    // Check tool-level override
+    const toolLevel = overrides[toolName];
+    if (toolLevel)
+        return toolLevel;
+    return MCP_DEFAULT_SENSITIVITY;
+}
+/**
+ * Convert a single MCP tool into a Crewly ToolDefinition.
+ *
+ * The resulting tool definition:
+ * - Has a namespaced name (`mcp_{server}_{tool}`)
+ * - Uses a passthrough Zod schema for input validation
+ * - Delegates execution to McpClientService.callTool()
+ * - Defaults to 'sensitive' classification for auditing
+ *
+ * @param mcpClient - The MCP client service for executing tool calls
+ * @param toolInfo - Tool metadata from the MCP server
+ * @param overrides - Optional sensitivity overrides
+ * @returns A ToolDefinition compatible with the Crewly Agent runtime
+ */
+export function convertMcpTool(mcpClient, toolInfo, overrides) {
+    const sensitivity = resolveSensitivity(toolInfo.serverName, toolInfo.name, overrides);
+    return {
+        description: toolInfo.description
+            ? `[MCP:${toolInfo.serverName}] ${toolInfo.description}`
+            : `[MCP:${toolInfo.serverName}] ${toolInfo.name}`,
+        inputSchema: jsonSchemaToZodPassthrough(toolInfo.inputSchema),
+        sensitivity,
+        execute: async (args) => {
+            try {
+                const result = await mcpClient.callTool(toolInfo.serverName, toolInfo.name, args);
+                // Flatten text content for simpler tool results
+                if (!result.isError && result.content.length === 1
+                    && result.content[0].type === 'text' && 'text' in result.content[0]) {
+                    return { success: true, text: result.content[0].text };
+                }
+                return {
+                    success: !result.isError,
+                    content: result.content,
+                    ...(result.isError && { error: 'MCP tool returned an error' }),
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `MCP tool call failed: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    };
+}
+/**
+ * Load all tools from connected MCP servers and convert them to ToolDefinitions.
+ *
+ * This is the primary entry point for integrating MCP tools into the agent
+ * runtime. It queries all connected MCP servers, converts their tools to
+ * the Crewly ToolDefinition format, and returns a map ready to merge with
+ * the built-in tool registry.
+ *
+ * @param mcpClient - The MCP client service with active server connections
+ * @param overrides - Optional sensitivity overrides
+ * @returns Map of namespaced tool name -> ToolDefinition
+ *
+ * @example
+ * ```typescript
+ * const mcpClient = new McpClientService();
+ * await mcpClient.connectServer('filesystem', config);
+ * const mcpTools = loadMcpTools(mcpClient);
+ * // mcpTools = { mcp_filesystem_read_file: {...}, mcp_filesystem_write_file: {...} }
+ * ```
+ */
+export function loadMcpTools(mcpClient, overrides) {
+    const tools = {};
+    const mcpToolInfos = mcpClient.listTools();
+    for (const toolInfo of mcpToolInfos) {
+        const toolName = buildMcpToolName(toolInfo.serverName, toolInfo.name);
+        tools[toolName] = convertMcpTool(mcpClient, toolInfo, overrides);
+    }
+    return tools;
+}
+/**
+ * Connect to MCP servers and load their tools in one step.
+ *
+ * Convenience function that handles the full lifecycle:
+ * 1. Connects to all configured MCP servers (tolerates failures)
+ * 2. Loads and converts all available tools
+ * 3. Returns tools ready to merge into the agent's tool registry
+ *
+ * @param mcpClient - The MCP client service instance
+ * @param serverConfigs - Map of server name -> server configuration
+ * @param overrides - Optional sensitivity overrides
+ * @returns Object with loaded tools and any connection errors
+ *
+ * @example
+ * ```typescript
+ * const { tools, errors } = await connectAndLoadMcpTools(mcpClient, {
+ *   filesystem: { command: 'npx', args: ['-y', '@anthropic/mcp-filesystem'] },
+ * });
+ * ```
+ */
+export async function connectAndLoadMcpTools(mcpClient, serverConfigs, overrides) {
+    const errors = await mcpClient.connectAll(serverConfigs);
+    const tools = loadMcpTools(mcpClient, overrides);
+    return { tools, errors };
+}
+//# sourceMappingURL=mcp-tool-bridge.js.map

package/dist/backend/backend/src/services/agent/crewly-agent/mcp-tool-bridge.js.map

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

package/dist/backend/backend/src/services/agent/crewly-agent/model-manager.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Crewly Agent Model Manager
+ *
+ * Multi-provider model factory that creates AI SDK model instances
+ * from configuration. Supports Anthropic, OpenAI, Google, DeepSeek, and
+ * Ollama providers.
+ *
+ * API keys for cloud providers are resolved through the settings service
+ * (skill → runtime → global → env var) and injected into process.env so the
+ * provider SDKs can pick them up:
+ * - ANTHROPIC_API_KEY
+ * - OPENAI_API_KEY
+ * - GOOGLE_GENERATIVE_AI_API_KEY
+ * - DEEPSEEK_API_KEY (DeepSeek; served via OpenAI-compatible API)
+ *
+ * Ollama runs locally and does not require an API key.
+ * Configure the Ollama base URL via OLLAMA_BASE_URL (default: http://localhost:11434).
+ *
+ * @module services/agent/crewly-agent/model-manager
+ */
+import type { LanguageModel } from 'ai';
+import { type ModelConfig, type ModelProvider } from './types.js';
+/**
+ * Factory for creating AI SDK language model instances from configuration.
+ *
+ * Uses dynamic imports to avoid loading provider SDKs that aren't needed,
+ * keeping the startup cost minimal when only one provider is used.
+ *
+ * @example
+ * ```typescript
+ * const manager = new ModelManager();
+ * const model = await manager.getModel({ provider: 'anthropic', modelId: 'claude-sonnet-4-20250514' });
+ * ```
+ */
+export declare class ModelManager {
+    /** Cached provider module references to avoid re-importing */
+    private providerCache;
+    /**
+     * Per-instance buffer of parsed DeepSeek-R1 reasoning_content from in-flight
+     * and recently-completed HTTP calls. Each `streamText` call to a DeepSeek
+     * model triggers one or more fetch calls (one per agentic step); each fetch
+     * appends its parsed reasoning to this buffer. Consumer (agent-runner) reads
+     * via `consumeDeepseekReasoning()` after `await streamResult` and the buffer
+     * resets to `''` on read.
+     *
+     * **Concurrency:** AgentRunner uses one ModelManager per session and calls
+     * streamText serially per session (the rate limiter enforces this).
+     * Cross-session concurrency is not a concern because each AgentRunner gets
+     * its own ModelManager via `new ModelManager()` in the constructor.
+     */
+    private deepseekReasoningBuffer;
+    /** Tracks in-flight parsed-SSE handles so we can wait for drain on consume. */
+    private deepseekParsedHandles;
+    /**
+     * Get an AI SDK language model instance for the given configuration.
+     *
+     * Resolves API keys from settings (with override chain) and injects them
+     * into the environment before creating the model, so provider SDKs can find them.
+     *
+     * @param config - Model configuration specifying provider and model ID
+     * @returns AI SDK LanguageModel instance ready for use with generateText
+     * @throws Error if the provider is unknown or the SDK is not installed
+     */
+    getModel(config?: ModelConfig): Promise<LanguageModel>;
+    /**
+     * Get provider function, using cache for repeated calls.
+     *
+     * @param provider - Provider name
+     * @returns Function that creates a model from a model ID string
+     */
+    private getProviderFunction;
+    /**
+     * Check which providers have API keys configured (settings + env vars).
+     *
+     * @returns Object indicating which providers are available
+     */
+    getAvailableProviders(): Promise<Record<ModelProvider, boolean>>;
+    /**
+     * Map model provider name to API key provider name.
+     * Only applicable for cloud providers wired through the settings service
+     * (anthropic, openai, google, deepseek). Ollama runs locally and is
+     * excluded.
+     *
+     * @param provider - Cloud model provider
+     * @returns Corresponding ApiKeyProvider name
+     */
+    private static providerToApiKeyProvider;
+    /**
+     * Ensure the API key for a provider is available in process.env
+     * by resolving it from settings if not already present.
+     *
+     * No-op for 'ollama' (runs locally, no key required). All other providers —
+     * including 'deepseek' — flow through the settings service so users can
+     * configure them from the UI without touching env vars.
+     *
+     * @param provider - The model provider
+     */
+    private ensureApiKeyInEnv;
+    /**
+     * Clear the provider cache (useful for testing or reconfiguration).
+     * Also clears any buffered DeepSeek reasoning so a fresh test/run starts clean.
+     */
+    clearCache(): void;
+    /**
+     * Build the custom fetch wrapper for the DeepSeek provider.
+     *
+     * Returns a function with the same signature as `globalThis.fetch` that:
+     * 1. Calls native fetch with the supplied input/init.
+     * 2. If the response is a streaming SSE body, tees it and parses one branch
+     *    for `delta.reasoning_content`, accumulating into `this.deepseekReasoningBuffer`.
+     * 3. Returns a new Response wrapping the un-tampered passthrough branch as
+     *    its body, so AI SDK consumes exactly the bytes DeepSeek sent.
+     *
+     * If the response is not an SSE stream (e.g. error JSON, no body), it is
+     * returned unchanged.
+     *
+     * **Why a method, not a free function:** the wrapper closes over `this` to
+     * append to the per-instance reasoning buffer. Each ModelManager instance
+     * has its own buffer (one per AgentRunner per session).
+     */
+    private makeDeepseekFetch;
+    /**
+     * Drain any in-flight DeepSeek SSE parser branches and return the accumulated
+     * `reasoning_content` string. Resets the buffer to `''` on each call (consume
+     * semantics).
+     *
+     * **Caller contract:** call AFTER `await streamResult` resolves in agent-runner.
+     * The AI SDK consumer branch must have been fully drained for the parser branch
+     * (which lags slightly due to tee buffering) to have caught up.
+     *
+     * **Multi-step accumulation:** if a single `streamText` call made multiple HTTP
+     * calls (one per agentic step), reasoning from all steps is concatenated in
+     * call order — not separated by step boundary. This matches the user-facing
+     * mental model of "what was the model's full chain of thought for this turn."
+     *
+     * **Returns `null` if no reasoning was captured.** Empty string means a fetch
+     * happened but produced no reasoning content (e.g. non-R1 DeepSeek model).
+     */
+    consumeDeepseekReasoning(): Promise<string | null>;
+}
+//# sourceMappingURL=model-manager.d.ts.map

package/dist/backend/backend/src/services/agent/crewly-agent/model-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/model-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAyB,MAAM,YAAY,CAAC;AAazF;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACvB,8DAA8D;IAC9D,OAAO,CAAC,aAAa,CAAgE;IAErF;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,uBAAuB,CAAM;IAErC,+EAA+E;IAC/E,OAAO,CAAC,qBAAqB,CAA2B;IAExD;;;;;;;;;OASG;IACG,QAAQ,CAAC,MAAM,GAAE,WAAiD,GAAG,OAAO,CAAC,aAAa,CAAC;IAQjG;;;;;OAKG;YACW,mBAAmB;IAwEjC;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAoBtE;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAIvC;;;;;;;;;OASG;YACW,iBAAiB;IA0B/B;;;OAGG;IACH,UAAU,IAAI,IAAI;IAMlB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;;;;;;;;;;;;;;;OAgBG;IACG,wBAAwB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAqBzD"}