crewly 1.2.4 → 1.2.7

package/dist/backend/backend/src/services/agent/crewly-agent/crewly-agent-runtime.service.js

@@ -0,0 +1,242 @@
+/**
+ * Crewly Agent Runtime Service
+ *
+ * Concrete RuntimeAgentService subclass for the in-process Crewly Agent.
+ * Unlike PTY-based runtimes (Claude Code, Gemini CLI), this runtime runs
+ * entirely inside the Node.js process using the Vercel AI SDK.
+ *
+ * No tmux session, no shell commands — messages are routed directly to
+ * the AgentRunnerService.handleMessage() method.
+ *
+ * @module services/agent/crewly-agent/crewly-agent-runtime.service
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { RuntimeAgentService } from '../runtime-agent.service.abstract.js';
+import { AgentRunnerService } from './agent-runner.service.js';
+import { RUNTIME_TYPES } from '../../../constants.js';
+import { CREWLY_AGENT_DEFAULTS } from './types.js';
+import { InProcessLogBuffer } from './in-process-log-buffer.js';
+/**
+ * In-process Crewly Agent runtime powered by AI SDK generateText.
+ *
+ * Key differences from PTY-based runtimes:
+ * - No tmux session needed — runs in-process
+ * - Messages routed via handleMessage() instead of PTY write
+ * - System prompt loaded from config/roles/orchestrator/prompt.md
+ * - Ready immediately after initialization (no CLI startup wait)
+ *
+ * @example
+ * ```typescript
+ * const runtime = new CrewlyAgentRuntimeService(sessionHelper, projectRoot);
+ * await runtime.initializeInProcess('crewly-orc');
+ * const result = await runtime.handleMessage('Check all team statuses');
+ * ```
+ */
+export class CrewlyAgentRuntimeService extends RuntimeAgentService {
+    agentRunner = null;
+    initialized = false;
+    currentSessionName = null;
+    logBuffer;
+    constructor(sessionHelper, projectRoot) {
+        super(sessionHelper, projectRoot);
+        this.logBuffer = InProcessLogBuffer.getInstance();
+    }
+    // ===== Abstract method implementations =====
+    /**
+     * Get the runtime type identifier.
+     *
+     * @returns 'crewly-agent' runtime type constant
+     */
+    getRuntimeType() {
+        return RUNTIME_TYPES.CREWLY_AGENT;
+    }
+    /**
+     * Detect if the Crewly Agent runtime is running.
+     * For in-process runtime, this checks if the AgentRunner is initialized.
+     *
+     * @param _sessionName - Session name (unused for in-process runtime)
+     * @returns True if the agent runner is initialized
+     */
+    async detectRuntimeSpecific(_sessionName) {
+        return this.initialized && this.agentRunner !== null && this.agentRunner.isInitialized();
+    }
+    /**
+     * Get patterns that indicate the runtime is ready.
+     * For in-process runtime, there are no terminal patterns — readiness is checked programmatically.
+     *
+     * @returns Empty array (no terminal output to match)
+     */
+    getRuntimeReadyPatterns() {
+        return ['Crewly Agent Ready'];
+    }
+    /**
+     * Get patterns that indicate runtime errors.
+     *
+     * @returns Empty array (errors are thrown as exceptions, not terminal patterns)
+     */
+    getRuntimeErrorPatterns() {
+        return [];
+    }
+    /**
+     * Get patterns that indicate the runtime has exited.
+     *
+     * @returns Empty array (in-process runtime doesn't exit via terminal)
+     */
+    getRuntimeExitPatterns() {
+        return [];
+    }
+    // ===== In-process lifecycle methods =====
+    /**
+     * Initialize the in-process agent runtime.
+     *
+     * Loads the system prompt from config/roles/orchestrator/prompt.md,
+     * creates the AgentRunnerService, and initializes the model.
+     *
+     * @param sessionName - Session name for this agent instance
+     * @param config - Optional partial config overrides
+     * @param roleName - Role name for system prompt lookup (default: 'orchestrator')
+     */
+    async initializeInProcess(sessionName, config, roleName) {
+        this.currentSessionName = sessionName;
+        // Load system prompt from file (role-specific)
+        const systemPrompt = await this.loadSystemPrompt(roleName || 'orchestrator');
+        // Build full config with defaults
+        const fullConfig = {
+            model: config?.model || CREWLY_AGENT_DEFAULTS.DEFAULT_MODEL,
+            maxSteps: config?.maxSteps || CREWLY_AGENT_DEFAULTS.MAX_STEPS,
+            sessionName,
+            apiBaseUrl: config?.apiBaseUrl || CREWLY_AGENT_DEFAULTS.API_BASE_URL,
+            systemPrompt: config?.systemPrompt || systemPrompt,
+            maxHistoryMessages: config?.maxHistoryMessages || CREWLY_AGENT_DEFAULTS.MAX_HISTORY_MESSAGES,
+            compactionThreshold: config?.compactionThreshold || CREWLY_AGENT_DEFAULTS.COMPACTION_THRESHOLD,
+        };
+        this.agentRunner = new AgentRunnerService(fullConfig);
+        await this.agentRunner.initialize();
+        this.initialized = true;
+        // Register in-process session for frontend terminal visibility
+        this.logBuffer.registerSession(sessionName);
+        this.logBuffer.append(sessionName, 'info', `Crewly Agent initialized (${fullConfig.model.provider}/${fullConfig.model.modelId})`);
+        this.logger.info('Crewly Agent runtime initialized', {
+            sessionName,
+            model: `${fullConfig.model.provider}/${fullConfig.model.modelId}`,
+            maxSteps: fullConfig.maxSteps,
+        });
+    }
+    /**
+     * Handle an incoming message by routing it to the AgentRunner.
+     *
+     * This is the primary entry point for message delivery, replacing
+     * the PTY write path used by other runtimes.
+     *
+     * @param message - The message to process
+     * @returns Agent run result with text response and tool call records
+     * @throws Error if the runtime is not initialized
+     */
+    async handleMessage(message) {
+        if (!this.agentRunner || !this.initialized) {
+            throw new Error('Crewly Agent runtime not initialized. Call initializeInProcess() first.');
+        }
+        const session = this.currentSessionName;
+        this.logBuffer.append(session, 'info', `← Message received (${message.length} chars)`);
+        this.logger.debug('Handling message', {
+            sessionName: session,
+            messageLength: message.length,
+            historyLength: this.agentRunner.getHistoryLength(),
+        });
+        try {
+            const result = await this.agentRunner.run(message);
+            // Log tool calls to buffer for frontend visibility
+            for (const tc of result.toolCalls) {
+                const argsPreview = JSON.stringify(tc.args).substring(0, 120);
+                this.logBuffer.append(session, 'info', `🔧 ${tc.toolName}(${argsPreview})`);
+                const resultPreview = tc.result ? JSON.stringify(tc.result).substring(0, 200) : 'void';
+                this.logBuffer.append(session, 'debug', `  → ${resultPreview}`);
+            }
+            // Log response summary
+            const textPreview = result.text ? result.text.substring(0, 150) : '(no text)';
+            this.logBuffer.append(session, 'info', `→ Response (${result.steps} steps, ${result.toolCalls.length} tools): ${textPreview}`);
+            this.logBuffer.append(session, 'debug', `  Tokens: ${result.usage.input}in/${result.usage.output}out`);
+            this.logger.info('Message processed', {
+                sessionName: session,
+                steps: result.steps,
+                toolCalls: result.toolCalls.length,
+                usage: result.usage,
+                finishReason: result.finishReason,
+            });
+            return result;
+        }
+        catch (error) {
+            const errMsg = error instanceof Error ? error.message : String(error);
+            this.logBuffer.append(session, 'error', `Agent error: ${errMsg}`);
+            throw error;
+        }
+    }
+    /**
+     * Check if the runtime is initialized and ready to handle messages.
+     *
+     * @returns True if initializeInProcess() has been called successfully
+     */
+    isReady() {
+        return this.initialized && this.agentRunner !== null && this.agentRunner.isInitialized();
+    }
+    /**
+     * Get the current agent runner instance (for inspection/testing).
+     *
+     * @returns The AgentRunnerService instance, or null if not initialized
+     */
+    getAgentRunner() {
+        return this.agentRunner;
+    }
+    /**
+     * Get the session name this runtime was initialized with.
+     *
+     * @returns Session name string, or null if not initialized
+     */
+    getSessionName() {
+        return this.currentSessionName;
+    }
+    /**
+     * Shut down the in-process runtime.
+     * Clears the agent runner and resets state.
+     */
+    shutdown() {
+        this.logger.info('Shutting down Crewly Agent runtime', {
+            sessionName: this.currentSessionName,
+        });
+        if (this.currentSessionName) {
+            this.logBuffer.append(this.currentSessionName, 'info', 'Crewly Agent shutting down');
+            this.logBuffer.removeSession(this.currentSessionName);
+        }
+        this.agentRunner = null;
+        this.initialized = false;
+        this.currentSessionName = null;
+    }
+    // ===== Private helpers =====
+    /**
+     * Load the system prompt for a given role from file.
+     *
+     * @param roleName - Role name (maps to config/roles/{roleName}/prompt.md)
+     * @returns System prompt content
+     * @throws Error if the prompt file cannot be read
+     */
+    async loadSystemPrompt(roleName = 'orchestrator') {
+        const promptPath = path.join(this.projectRoot, 'config', 'roles', roleName, 'prompt.md');
+        try {
+            const content = await fs.readFile(promptPath, 'utf8');
+            this.logger.debug('System prompt loaded', {
+                promptPath,
+                length: content.length,
+            });
+            return content;
+        }
+        catch (error) {
+            this.logger.warn('Failed to load system prompt, using fallback', {
+                promptPath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return 'You are the Crewly orchestrator agent. Manage teams and delegate tasks.';
+        }
+    }
+}
+//# sourceMappingURL=crewly-agent-runtime.service.js.map

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

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

package/dist/backend/backend/src/services/agent/crewly-agent/in-process-log-buffer.d.ts

@@ -0,0 +1,95 @@
+/**
+ * In-Process Log Buffer
+ *
+ * Ring buffer that captures structured output from in-process Crewly Agent
+ * runtimes. Provides the same interface as PTY terminal capture so the
+ * frontend Side Terminal panel can display crewly-agent activity.
+ *
+ * @module services/agent/crewly-agent/in-process-log-buffer
+ */
+/**
+ * Single log entry from an in-process agent session.
+ */
+export interface LogEntry {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Log level */
+    level: 'info' | 'debug' | 'warn' | 'error';
+    /** Log message */
+    message: string;
+}
+/**
+ * Singleton buffer that captures in-process agent output.
+ *
+ * Used by CrewlyAgentRuntimeService to log tool calls, responses,
+ * and errors. The terminal controller reads from this buffer when
+ * the requested session is an in-process agent (no PTY).
+ *
+ * @example
+ * ```typescript
+ * const buffer = InProcessLogBuffer.getInstance();
+ * buffer.append('crewly-assistant', 'info', 'Calling get_team_status tool...');
+ * const output = buffer.capture('crewly-assistant', 50);
+ * ```
+ */
+export declare class InProcessLogBuffer {
+    private static instance;
+    private sessions;
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The shared InProcessLogBuffer instance
+     */
+    static getInstance(): InProcessLogBuffer;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Append a log entry for a session.
+     *
+     * @param sessionName - In-process agent session name
+     * @param level - Log level
+     * @param message - Log message text
+     */
+    append(sessionName: string, level: LogEntry['level'], message: string): void;
+    /**
+     * Check if a session has any log entries.
+     *
+     * @param sessionName - Session to check
+     * @returns True if the session has been registered with at least one entry
+     */
+    hasSession(sessionName: string): boolean;
+    /**
+     * Capture recent output from an in-process session, formatted like
+     * terminal output for frontend compatibility.
+     *
+     * @param sessionName - Session to capture from
+     * @param lines - Maximum number of lines to return
+     * @returns Formatted output string (one log entry per line)
+     */
+    capture(sessionName: string, lines?: number): string;
+    /**
+     * Register a session (creates empty entry list).
+     *
+     * @param sessionName - Session to register
+     */
+    registerSession(sessionName: string): void;
+    /**
+     * Remove a session's log buffer.
+     *
+     * @param sessionName - Session to remove
+     */
+    removeSession(sessionName: string): void;
+    /**
+     * Get all registered in-process session names.
+     *
+     * @returns Array of session names
+     */
+    getSessionNames(): string[];
+    /**
+     * Clear all sessions (for testing).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=in-process-log-buffer.d.ts.map

package/dist/backend/backend/src/services/agent/crewly-agent/in-process-log-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-log-buffer.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/in-process-log-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAiC;IAEjD;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAOxC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAgB5E;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,MAAM;IAajD;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAM1C;;;;OAIG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIxC;;;;OAIG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/backend/backend/src/services/agent/crewly-agent/in-process-log-buffer.js

@@ -0,0 +1,130 @@
+/**
+ * In-Process Log Buffer
+ *
+ * Ring buffer that captures structured output from in-process Crewly Agent
+ * runtimes. Provides the same interface as PTY terminal capture so the
+ * frontend Side Terminal panel can display crewly-agent activity.
+ *
+ * @module services/agent/crewly-agent/in-process-log-buffer
+ */
+/** Maximum number of entries to keep per session */
+const MAX_ENTRIES_PER_SESSION = 500;
+/**
+ * Singleton buffer that captures in-process agent output.
+ *
+ * Used by CrewlyAgentRuntimeService to log tool calls, responses,
+ * and errors. The terminal controller reads from this buffer when
+ * the requested session is an in-process agent (no PTY).
+ *
+ * @example
+ * ```typescript
+ * const buffer = InProcessLogBuffer.getInstance();
+ * buffer.append('crewly-assistant', 'info', 'Calling get_team_status tool...');
+ * const output = buffer.capture('crewly-assistant', 50);
+ * ```
+ */
+export class InProcessLogBuffer {
+    static instance = null;
+    sessions = new Map();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The shared InProcessLogBuffer instance
+     */
+    static getInstance() {
+        if (!InProcessLogBuffer.instance) {
+            InProcessLogBuffer.instance = new InProcessLogBuffer();
+        }
+        return InProcessLogBuffer.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        InProcessLogBuffer.instance = null;
+    }
+    /**
+     * Append a log entry for a session.
+     *
+     * @param sessionName - In-process agent session name
+     * @param level - Log level
+     * @param message - Log message text
+     */
+    append(sessionName, level, message) {
+        if (!this.sessions.has(sessionName)) {
+            this.sessions.set(sessionName, []);
+        }
+        const entries = this.sessions.get(sessionName);
+        entries.push({
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+        });
+        // Ring buffer — drop oldest entries
+        if (entries.length > MAX_ENTRIES_PER_SESSION) {
+            entries.splice(0, entries.length - MAX_ENTRIES_PER_SESSION);
+        }
+    }
+    /**
+     * Check if a session has any log entries.
+     *
+     * @param sessionName - Session to check
+     * @returns True if the session has been registered with at least one entry
+     */
+    hasSession(sessionName) {
+        return this.sessions.has(sessionName);
+    }
+    /**
+     * Capture recent output from an in-process session, formatted like
+     * terminal output for frontend compatibility.
+     *
+     * @param sessionName - Session to capture from
+     * @param lines - Maximum number of lines to return
+     * @returns Formatted output string (one log entry per line)
+     */
+    capture(sessionName, lines = 100) {
+        const entries = this.sessions.get(sessionName);
+        if (!entries || entries.length === 0) {
+            return '[crewly-agent] No output yet';
+        }
+        const slice = entries.slice(-lines);
+        return slice.map(e => {
+            const ts = e.timestamp.substring(11, 23); // HH:MM:SS.mmm
+            const prefix = e.level === 'error' ? 'ERROR' : e.level === 'warn' ? 'WARN' : e.level === 'debug' ? 'DEBUG' : '';
+            return prefix ? `[${ts}] ${prefix}: ${e.message}` : `[${ts}] ${e.message}`;
+        }).join('\n');
+    }
+    /**
+     * Register a session (creates empty entry list).
+     *
+     * @param sessionName - Session to register
+     */
+    registerSession(sessionName) {
+        if (!this.sessions.has(sessionName)) {
+            this.sessions.set(sessionName, []);
+        }
+    }
+    /**
+     * Remove a session's log buffer.
+     *
+     * @param sessionName - Session to remove
+     */
+    removeSession(sessionName) {
+        this.sessions.delete(sessionName);
+    }
+    /**
+     * Get all registered in-process session names.
+     *
+     * @returns Array of session names
+     */
+    getSessionNames() {
+        return Array.from(this.sessions.keys());
+    }
+    /**
+     * Clear all sessions (for testing).
+     */
+    clear() {
+        this.sessions.clear();
+    }
+}
+//# sourceMappingURL=in-process-log-buffer.js.map

package/dist/backend/backend/src/services/agent/crewly-agent/in-process-log-buffer.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * Crewly Agent Runtime — Barrel Export
+ *
+ * @module services/agent/crewly-agent
+ */
+export { AgentRunnerService } from './agent-runner.service.js';
+export { CrewlyAgentRuntimeService } from './crewly-agent-runtime.service.js';
+export { CrewlyApiClient } from './api-client.js';
+export { ModelManager } from './model-manager.js';
+export { InProcessLogBuffer, type LogEntry } from './in-process-log-buffer.js';
+export { createTools, getToolNames } from './tool-registry.js';
+export { createAuditorTools, getAuditorToolNames } from './auditor-tools.js';
+export { type ModelProvider, type ModelConfig, type ConversationState, type CrewlyAgentConfig, type AgentRunResult, type ToolCallRecord, type ApiCallResult, MODEL_PROVIDERS, CREWLY_AGENT_DEFAULTS, isModelProvider, isModelConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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,EAAE,KAAK,QAAQ,EAAE,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,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Crewly Agent Runtime — Barrel Export
+ *
+ * @module services/agent/crewly-agent
+ */
+export { AgentRunnerService } from './agent-runner.service.js';
+export { CrewlyAgentRuntimeService } from './crewly-agent-runtime.service.js';
+export { CrewlyApiClient } from './api-client.js';
+export { ModelManager } from './model-manager.js';
+export { InProcessLogBuffer } from './in-process-log-buffer.js';
+export { createTools, getToolNames } from './tool-registry.js';
+export { createAuditorTools, getAuditorToolNames } from './auditor-tools.js';
+export { MODEL_PROVIDERS, CREWLY_AGENT_DEFAULTS, isModelProvider, isModelConfig, } from './types.js';
+//# sourceMappingURL=index.js.map

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,EAQL,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,57 @@
+/**
+ * Crewly Agent Model Manager
+ *
+ * Multi-provider model factory that creates AI SDK model instances
+ * from configuration. Supports Anthropic, OpenAI, and Google providers.
+ *
+ * API keys are read from environment variables by the provider SDKs:
+ * - ANTHROPIC_API_KEY
+ * - OPENAI_API_KEY
+ * - GOOGLE_GENERATIVE_AI_API_KEY
+ *
+ * @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;
+    /**
+     * Get an AI SDK language model instance for the given configuration.
+     *
+     * @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 in the environment.
+     *
+     * @returns Object indicating which providers are available
+     */
+    getAvailableProviders(): Record<ModelProvider, boolean>;
+    /**
+     * Clear the provider cache (useful for testing or reconfiguration).
+     */
+    clearCache(): void;
+}
+//# 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;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAyB,MAAM,YAAY,CAAC;AAEzF;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACvB,8DAA8D;IAC9D,OAAO,CAAC,aAAa,CAAgE;IAErF;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,GAAE,WAAiD,GAAG,OAAO,CAAC,aAAa,CAAC;IAKjG;;;;;OAKG;YACW,mBAAmB;IA8BjC;;;;OAIG;IACH,qBAAqB,IAAI,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC;IAQvD;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}