crewly 1.4.31 → 1.4.33

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

@@ -10,7 +10,41 @@
 import { ModelManager } from './model-manager.js';
 import { CrewlyApiClient } from './api-client.js';
 import { ApprovalQueueService } from './approval-queue.service.js';
-import { type CrewlyAgentConfig, type ConversationState, type AgentRunResult, type CompactionResult, type ContextBudgetStatus, type AuditEntry, type SecurityPolicy } from './types.js';
+import { type CrewlyAgentConfig, type ConversationState, type AgentRunResult, type CompactionResult, type ContextBudgetStatus, type AuditEntry, type SecurityPolicy, type StreamingEventCallbacks } from './types.js';
+/**
+ * Detects looping behavior in tool calls: consecutive identical calls or
+ * consecutive error responses from the same tool.
+ *
+ * Usage: create per-run, call `recordToolCall()` in onStepFinish, check `loopDetected`.
+ */
+export declare class ToolCallLoopDetector {
+    private readonly identicalThreshold;
+    private readonly errorThreshold;
+    /** Consecutive identical tool call fingerprints */
+    private consecutiveIdentical;
+    private lastFingerprint;
+    /** Consecutive error results from the same tool */
+    private consecutiveErrors;
+    private lastErrorTool;
+    /** Whether a loop was detected */
+    loopDetected: boolean;
+    /** Human-readable reason when loop is detected */
+    loopReason: string;
+    constructor(identicalThreshold?: number, errorThreshold?: number);
+    /**
+     * Record a tool call and check for loop patterns.
+     *
+     * @param toolName - Name of the tool called
+     * @param args - Arguments passed to the tool
+     * @param result - Result returned by the tool
+     * @returns True if a loop was just detected on this call
+     */
+    recordToolCall(toolName: string, args: Record<string, unknown>, result: unknown): boolean;
+    /**
+     * Check if a tool result looks like an error (404, HTTP error codes, error strings).
+     */
+    private isErrorResult;
+}
 /**
  * Core agent runner that manages the AI SDK generateText loop.
  *
@@ -55,6 +89,10 @@ export declare class AgentRunnerService {
     private tracing;
     /** Guards against concurrent compaction — only one compaction at a time */
     private compacting;
+    /** AbortController for the current run — allows external cancellation */
+    private currentRunAbort;
+    /** Streaming event callbacks — set per run by the runtime service */
+    private streamingCallbacks;
     /** @internal Override for testing — replaces the AI SDK generateText call */
     _generateTextFn: GenerateTextFn | null;
     /**
@@ -79,9 +117,28 @@ export declare class AgentRunnerService {
      * generateText calls which would corrupt conversation state.
      *
      * @param message - User/system message to process
+     * @param conversationId - Optional conversation ID for routing
+     * @param metadata - Optional metadata (Slack context, etc.)
+     * @param options - Optional abort signal and streaming callbacks
      * @returns Result of the agent run including text, tool calls, and usage
      */
-    run(message: string, conversationId?: string, metadata?: Record<string, string>): Promise<AgentRunResult>;
+    run(message: string, conversationId?: string, metadata?: Record<string, string>, options?: {
+        abortSignal?: AbortSignal;
+        streaming?: StreamingEventCallbacks;
+    }): Promise<AgentRunResult>;
+    /**
+     * Abort the current in-progress run.
+     * Signals the active streamText/generateText call to cancel.
+     *
+     * @returns True if an active run was aborted, false if no run was in progress
+     */
+    abortCurrentRun(): boolean;
+    /**
+     * Check if the agent is currently processing a message.
+     *
+     * @returns True if processing is in progress
+     */
+    isProcessing(): boolean;
     /**
      * Get current conversation state (for inspection/debugging).
      *
@@ -143,12 +200,81 @@ export declare class AgentRunnerService {
      */
     private processQueue;
     /**
-     * Execute a single generateText run with the current conversation context.
+     * Execute a single streamText run with the current conversation context.
+     *
+     * Uses streamText for real-time token emission and tool call feedback.
+     * Falls back to generateText when _generateTextFn is set (testing).
      *
      * @param message - New message to add to the conversation
+     * @param externalAbortSignal - Optional external abort signal for cancellation
      * @returns Agent run result
      */
     private executeRun;
+    /**
+     * Check if an error is recoverable and eligible for automatic retry.
+     *
+     * Recoverable errors include:
+     * - HTTP 429 (rate limit)
+     * - HTTP 5xx (server errors)
+     * - Network timeouts and connection errors
+     *
+     * @param error - The error to classify
+     * @returns True if the error is recoverable
+     */
+    private isRecoverableError;
+    /**
+     * Check if an error indicates the context length was exceeded.
+     *
+     * @param error - The error to classify
+     * @returns True if the error is a context length exceeded error
+     */
+    private isContextLengthError;
+    /**
+     * Sleep for a specified duration.
+     *
+     * @param ms - Milliseconds to sleep
+     * @returns Promise that resolves after the delay
+     */
+    private sleep;
+    /**
+     * Execute run using streamText for real-time streaming output.
+     * This is the production path — emits events as tokens arrive.
+     *
+     * Includes automatic retry with exponential backoff for recoverable errors
+     * (429, 5xx, network) and progressive context trimming for context length errors.
+     */
+    private executeRunWithStreamText;
+    /**
+     * Single attempt of streamText execution (no retry logic).
+     */
+    private executeStreamTextAttempt;
+    /**
+     * Execute run using generateText (batch mode).
+     * Used when _generateTextFn is set for testing, or as fallback.
+     *
+     * Includes automatic retry with exponential backoff for recoverable errors
+     * and progressive context trimming for context length errors.
+     */
+    private executeRunWithGenerateText;
+    /**
+     * Single attempt of generateText execution (no retry logic).
+     */
+    private executeGenerateTextAttempt;
+    /**
+     * Remove the oldest non-system messages to reduce context size.
+     * Preserves the most recent messages and any system-role messages.
+     */
+    private trimOldestNonSystemMessages;
+    /**
+     * Handle a detected tool call loop by injecting a corrective system message
+     * into conversation history and returning a structured result.
+     *
+     * @param detector - The loop detector with reason details
+     * @param toolCalls - Tool calls collected so far
+     * @param steps - Number of steps taken
+     * @returns AgentRunResult with the loop warning as text
+     */
+    private handleLoopDetected;
     /**
      * Public method for agent-initiated context compaction.
      * Called by the compact_memory tool to intelligently summarize conversation state.

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

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