@trilogy-data/trilogy-studio-components 0.1.10 → 0.1.12

package/dist/llm/toolLoopCore.d.ts

@@ -4,7 +4,6 @@ import { ToolCallResult } from './editorRefinementToolExecutor';
 /** Interface for LLM operations needed by the tool loop */
 export interface LLMAdapter {
     generateCompletion(connectionName: string, options: LLMRequestOptions, messages: LLMMessage[]): Promise<LLMResponse>;
-    shouldAutoContinue(connectionName: string, responseText: string): Promise<boolean>;
 }
 /** Interface for persisting messages during tool loop execution */
 export interface MessagePersistence {
@@ -33,14 +32,20 @@ export interface ToolLoopConfig {
     tools: any[];
     /** Maximum iterations before stopping (safety limit) */
     maxIterations?: number;
-    /** Maximum auto-continue attempts when LLM doesn't call tools */
-    maxAutoContinue?: number;
     /** Build system prompt - called each iteration to allow dynamic prompts */
     buildSystemPrompt: () => string;
     /** Optional callback invoked after each tool execution */
     onToolResult?: (toolName: string, result: ToolCallResult) => void;
     /** Optional callback when a tool returns awaitsUserInput */
     onAwaitsUserInput?: (result: ToolCallResult, executedToolCalls: ChatToolCall[]) => void;
+    /** Message sent to agent when it responds with text but no tool call. Defaults to a generic reminder. */
+    noToolCallReminder?: string;
+    /**
+     * If true, terminate the loop when the LLM responds with text but no tool calls,
+     * instead of re-prompting. Use this for standalone/embedded chat modes where the
+     * LLM's plain text response is the final answer.
+     */
+    terminateOnNoToolCall?: boolean;
 }
 /** Result from running the tool loop */
 export interface ToolLoopResult {
@@ -48,20 +53,44 @@ export interface ToolLoopResult {
     finalMessage?: string;
     stopped?: boolean;
 }
+/**
+ * Maximum number of data rows to include in a tool result sent to the LLM.
+ * When results exceed this limit, the first and last (MAX_TOOL_RESULT_ROWS / 2) rows
+ * are shown with a truncation notice in between.
+ */
+export declare const MAX_TOOL_RESULT_ROWS = 100;
+/**
+ * Truncate a deserialized query result object if it has more rows than MAX_TOOL_RESULT_ROWS.
+ * Returns the (possibly truncated) data array and the number of rows cut.
+ *
+ * The caller is responsible for rendering the cut notice between the two halves.
+ */
+export declare function truncateResultRows(jsonData: any): {
+    head: any[];
+    tail: any[];
+    totalRows: number;
+    cutCount: number;
+};
 /**
  * Format a tool result for sending to the LLM.
  * Handles artifacts, messages, and errors consistently.
+ * Includes artifact IDs so the LLM can reference them in follow-up tool calls.
+ * Large result sets are truncated to MAX_TOOL_RESULT_ROWS rows (head + tail)
+ * with a cut notice; the agent can use get_artifact_rows to fetch any range.
  */
 export declare function formatToolResultText(result: ToolCallResult): string;
 /**
  * Core tool loop execution.
  * Runs the LLM conversation with tool calls until:
- * - LLM responds without tool calls
- * - A tool returns terminatesLoop: true
- * - A tool returns awaitsUserInput: true
- * - Max iterations reached
+ * - A tool returns terminatesLoop: true (agent explicitly signals done)
+ * - A tool returns awaitsUserInput: true (agent pauses for user input)
+ * - Max iterations reached (safety limit)
  * - Abort signal triggered
  * - An error occurs
+ *
+ * If the LLM responds with text and no tool calls, it is re-prompted with a
+ * reminder to call a tool. The agent must explicitly call a termination tool
+ * (e.g. return_to_user, request_close) to return control to the user.
  */
 export declare function runToolLoop(userMessage: string, llmConnectionName: string, llmAdapter: LLMAdapter, messagePersistence: MessagePersistence, toolExecutorFactory: ToolExecutorFactory, stateUpdater: ExecutionStateUpdater, config: ToolLoopConfig): Promise<ToolLoopResult>;
 //# sourceMappingURL=toolLoopCore.d.ts.map

package/dist/llm/toolLoopCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolLoopCore.d.ts","sourceRoot":"","sources":["../../llm/toolLoopCore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAA8B,MAAM,QAAQ,CAAA;AACpG,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAEpE,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,kBAAkB,CAChB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,WAAW,CAAC,CAAA;IACvB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACnF;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IACtC,yCAAyC;IACzC,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IACzC,oDAAoD;IACpD,WAAW,IAAI,WAAW,EAAE,CAAA;CAC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,gGAAgG;IAChG,eAAe,IAAI;QACjB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;KAC3F,CAAA;CACF;AAED,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,YAAY,IAAI,OAAO,CAAA;CACxB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,KAAK,EAAE,GAAG,EAAE,CAAA;IACZ,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,MAAM,CAAA;IAC/B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;IACjE,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,IAAI,CAAA;CACxF;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAwBnE;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,UAAU,EACtB,kBAAkB,EAAE,kBAAkB,EACtC,mBAAmB,EAAE,mBAAmB,EACxC,YAAY,EAAE,qBAAqB,EACnC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CA4QzB"}
+{"version":3,"file":"toolLoopCore.d.ts","sourceRoot":"","sources":["../../llm/toolLoopCore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAA8B,MAAM,QAAQ,CAAA;AACpG,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAKpE,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,kBAAkB,CAChB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,WAAW,CAAC,CAAA;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IACtC,yCAAyC;IACzC,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IACzC,oDAAoD;IACpD,WAAW,IAAI,WAAW,EAAE,CAAA;CAC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,gGAAgG;IAChG,eAAe,IAAI;QACjB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;KAC3F,CAAA;CACF;AAED,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,YAAY,IAAI,OAAO,CAAA;CACxB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,KAAK,EAAE,GAAG,EAAE,CAAA;IACZ,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,MAAM,CAAA;IAC/B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;IACjE,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,IAAI,CAAA;IACvF,yGAAyG;IACzG,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,GAAG,GAAG;IACjD,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAYA;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAoCnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,UAAU,EACtB,kBAAkB,EAAE,kBAAkB,EACtC,mBAAmB,EAAE,mBAAmB,EACxC,YAAY,EAAE,qBAAqB,EACnC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAsQzB"}

package/dist/llm/utils.d.ts

@@ -18,12 +18,15 @@ export interface RetryOptions {
     onRetry?: (attempt: number, delayMs: number, error: Error) => void;
     /** Optional AbortSignal for cancellation */
     signal?: AbortSignal;
+    /** Optional function to extract a richer error message from a non-ok response body */
+    errorBodyExtractor?: (response: Response) => Promise<string>;
 }
 /**
  * Default retry configuration
  */
-export declare const DEFAULT_RETRY_OPTIONS: Omit<Required<RetryOptions>, 'signal'> & {
+export declare const DEFAULT_RETRY_OPTIONS: Omit<Required<RetryOptions>, 'signal' | 'errorBodyExtractor'> & {
     signal?: AbortSignal;
+    errorBodyExtractor?: RetryOptions['errorBodyExtractor'];
 };
 /**
  * Type definition for errors that might contain response information

package/dist/llm/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../llm/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAClE,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,GAAG;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAA;CASrB,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAuEZ;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAChC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAkBnB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,iBAAiB,EAAE,CAQnF"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../llm/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAClE,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7D;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,IAAI,CACtC,QAAQ,CAAC,YAAY,CAAC,EACtB,QAAQ,GAAG,oBAAoB,CAChC,GAAG;IACF,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,kBAAkB,CAAC,EAAE,YAAY,CAAC,oBAAoB,CAAC,CAAA;CAUxD,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAuEZ;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAChC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAyBnB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,iBAAiB,EAAE,CAQnF"}