@trilogy-data/trilogy-studio-components 0.1.4 → 0.1.5

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../llm/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAe,MAAM,QAAQ,CAAA;AACrF,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3D;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAoBxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BhE;AAED,qBAAa,cAAe,SAAQ,WAAW;IAC7C,OAAO,CAAC,iBAAiB,CAAuD;IAChF,OAAO,CAAC,YAAY,CAA6C;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,EAAE,MAAM,CAAW;IAC9B,OAAO,CAAC,YAAY,CAAc;gBAGhC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,OAAe,EAC/B,YAAY,CAAC,EAAE,YAAY;IAgBvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BtB,kBAAkB,CACtB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,UAAU,EAAE,GAAG,IAAW,GAClC,OAAO,CAAC,WAAW,CAAC;IAoIvB;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAS/C;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM;CAUjD"}

package/dist/llm/sharedToolSchemas.d.ts

@@ -0,0 +1,93 @@
+import { ChartConfig } from '../editors/results';
+export declare const CHART_TYPES: readonly ["line", "bar", "barh", "point", "geo-map", "tree", "area", "headline", "donut", "heatmap", "boxplot", "treemap", "beeswarm"];
+export declare const CHART_CONFIG_EXAMPLE: ChartConfig;
+export declare const chartConfigSchema: {
+    readonly type: "object";
+    readonly description: "Chart configuration object";
+    readonly properties: {
+        readonly chartType: {
+            readonly type: "string";
+            readonly enum: readonly ["line", "bar", "barh", "point", "geo-map", "tree", "area", "headline", "donut", "heatmap", "boxplot", "treemap", "beeswarm"];
+            readonly description: "Type of chart to render";
+        };
+        readonly xField: {
+            readonly type: "string";
+            readonly description: "Field name for x-axis. Longitude for geo-map charts if geofield not provided.";
+        };
+        readonly yField: {
+            readonly type: "string";
+            readonly description: "Field name for y-axis. Latitude for geo-map charts if geofield not provided.";
+        };
+        readonly yField2: {
+            readonly type: "string";
+            readonly description: "Secondary y-axis field (optional)";
+        };
+        readonly colorField: {
+            readonly type: "string";
+            readonly description: "Field for color encoding (optional)";
+        };
+        readonly sizeField: {
+            readonly type: "string";
+            readonly description: "Field for size encoding (optional)";
+        };
+        readonly groupField: {
+            readonly type: "string";
+            readonly description: "Field for grouping data (optional)";
+        };
+        readonly trellisField: {
+            readonly type: "string";
+            readonly description: "Field for small multiples/faceting columns (optional)";
+        };
+        readonly trellisRowField: {
+            readonly type: "string";
+            readonly description: "Field for small multiples/faceting rows (optional)";
+        };
+        readonly geoField: {
+            readonly type: "string";
+            readonly description: "Field for geographic data (optional)";
+        };
+        readonly annotationField: {
+            readonly type: "string";
+            readonly description: "Field for data point annotations/labels (optional)";
+        };
+        readonly hideLegend: {
+            readonly type: "boolean";
+            readonly description: "Whether to hide the legend (optional)";
+        };
+        readonly showTitle: {
+            readonly type: "boolean";
+            readonly description: "Whether to show the chart title (optional)";
+        };
+        readonly scaleX: {
+            readonly type: "string";
+            readonly enum: readonly ["linear", "log", "sqrt"];
+            readonly description: "Scale type for x-axis (optional)";
+        };
+        readonly scaleY: {
+            readonly type: "string";
+            readonly enum: readonly ["linear", "log", "sqrt"];
+            readonly description: "Scale type for y-axis (optional)";
+        };
+        readonly linkY2: {
+            readonly type: "boolean";
+            readonly description: "Whether to link the secondary y-axis scale to the primary y-axis (optional)";
+        };
+    };
+};
+export declare const CHART_TYPES_LIST: string;
+export declare const chartConfigGuidance: string;
+export declare const connectDataConnectionTool: {
+    readonly name: "connect_data_connection";
+    readonly description: "Connect or reconnect a data connection that is not currently active. Use this when a query fails because the connection is not active, or when you need to establish a connection before running queries.";
+    readonly input_schema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly connection: {
+                readonly type: "string";
+                readonly description: "The name of the data connection to connect";
+            };
+        };
+        readonly required: readonly ["connection"];
+    };
+};
+//# sourceMappingURL=sharedToolSchemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sharedToolSchemas.d.ts","sourceRoot":"","sources":["../../llm/sharedToolSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,oBAAoB,CAAA;AAGjE,eAAO,MAAM,WAAW,wIAcd,CAAA;AAGV,eAAO,MAAM,oBAAoB,EAAE,WAiBlC,CAAA;AAGD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEpB,CAAA;AAGV,eAAO,MAAM,gBAAgB,QAA8C,CAAA;AAG3E,eAAO,MAAM,mBAAmB,QAWU,CAAA;AAG1C,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;CAc5B,CAAA"}

package/dist/llm/toolLoopCore.d.ts

@@ -0,0 +1,67 @@
+import { LLMMessage, LLMRequestOptions, LLMResponse } from './base';
+import { ChatMessage, ChatArtifact, ChatToolCall } from '../chats/chat';
+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 {
+    /** Add a message to the conversation history */
+    addMessage(message: ChatMessage): void;
+    /** Add an artifact produced by a tool */
+    addArtifact(artifact: ChatArtifact): void;
+    /** Get current messages for building LLM history */
+    getMessages(): ChatMessage[];
+}
+/** Interface for tool execution */
+export interface ToolExecutorFactory {
+    /** Create/get a tool executor. Called at the start of each iteration to allow fresh context. */
+    getToolExecutor(): {
+        executeToolCall(toolName: string, toolInput: Record<string, any>): Promise<ToolCallResult>;
+    };
+}
+/** Interface for updating execution state (loading, active tool, etc.) */
+export interface ExecutionStateUpdater {
+    setActiveToolName(name: string): void;
+    checkAborted(): boolean;
+}
+/** Options for running the tool loop */
+export interface ToolLoopConfig {
+    /** Tool definitions in JSON Schema format */
+    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;
+}
+/** Result from running the tool loop */
+export interface ToolLoopResult {
+    terminated: boolean;
+    finalMessage?: string;
+    stopped?: boolean;
+}
+/**
+ * Format a tool result for sending to the LLM.
+ * Handles artifacts, messages, and errors consistently.
+ */
+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
+ * - Abort signal triggered
+ * - An error occurs
+ */
+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

@@ -0,0 +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,CA2BnE;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,CAkQzB"}

package/dist/llm/utils.d.ts

@@ -16,11 +16,15 @@ export interface RetryOptions {
     retryStatusCodes?: number[];
     /** Optional callback function to execute before each retry */
     onRetry?: (attempt: number, delayMs: number, error: Error) => void;
+    /** Optional AbortSignal for cancellation */
+    signal?: AbortSignal;
 }
 /**
  * Default retry configuration
  */
-export declare const DEFAULT_RETRY_OPTIONS: Required<RetryOptions>;
+export declare const DEFAULT_RETRY_OPTIONS: Omit<Required<RetryOptions>, 'signal'> & {
+    signal?: AbortSignal;
+};
 /**
  * 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;CACnE;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAOxD,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,CAiDZ;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;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"}