@superblocksteam/shared 0.9558.8 → 0.9559.1

package/src/plugins/templates/mariadb.ts

@@ -19,7 +19,8 @@ export const MariaDBPluginVersions = {
   V8: '0.0.8',
   V9: '0.0.9',
   V10: '0.0.10',
-  V11: '0.0.11'
+  V11: '0.0.11',
+  V12: '0.0.12'
 };
 
 const BASE_HOST = {
@@ -336,6 +337,7 @@ export const MariaDBPlugin: Plugin = {
             label: 'Operation',
             name: 'operation',
             startVersion: MariaDBPluginVersions.V10,
+            endVersion: MariaDBPluginVersions.V11,
             componentType: FormComponentType.DROPDOWN,
             options: [
               {
@@ -351,6 +353,49 @@ export const MariaDBPlugin: Plugin = {
             ],
             initialValue: SqlOperations.RUN_SQL
           },
+          {
+            // Only show operation dropdown if UPDATE_ROWS was previously selected
+            // This effectively deprecates UPDATE_ROWS for new actions
+            label: 'Operation',
+            name: 'operation',
+            startVersion: MariaDBPluginVersions.V12,
+            componentType: FormComponentType.DROPDOWN,
+            options: [
+              {
+                displayName: 'Run SQL',
+                key: SqlOperations.RUN_SQL,
+                value: SqlOperations.RUN_SQL
+              },
+              {
+                displayName: 'Insert, update, or delete rows with form',
+                key: SqlOperations.UPDATE_ROWS,
+                value: SqlOperations.UPDATE_ROWS
+              }
+            ],
+            initialValue: SqlOperations.RUN_SQL,
+            display: {
+              show: {
+                operation: [SqlOperations.UPDATE_ROWS]
+              }
+            }
+          },
+          {
+            label: 'Parameters (?, ?, ...)',
+            name: 'parameters',
+            startVersion: MariaDBPluginVersions.V12,
+            ldFlag: 'clark.parameterized-apis.v2.enabled',
+            componentType: FormComponentType.DYNAMIC_INPUT_TEXT,
+            placeholder: '[param1, param2, ...]',
+            tooltip: {
+              markdownText:
+                'JavaScript expression that evaluates to an array of parameter values. Use `?` placeholders in your SQL query to reference these parameters.'
+            },
+            display: {
+              show: {
+                operation: ['undefined', SqlOperations.RUN_SQL]
+              }
+            }
+          },
           {
             label: '', // Query
             name: 'body',
@@ -617,6 +662,7 @@ export const MariaDBPlugin: Plugin = {
             label: 'Use parameterized SQL',
             name: 'usePreparedSql',
             startVersion: MariaDBPluginVersions.V6,
+            endVersion: MariaDBPluginVersions.V11,
             componentType: FormComponentType.SWITCH,
             initialValue: true,
             tooltip: {
@@ -627,6 +673,22 @@ export const MariaDBPlugin: Plugin = {
                 operation: ['undefined', SqlOperations.RUN_SQL]
               }
             }
+          },
+          {
+            label: 'Use parameterized SQL',
+            name: 'usePreparedSql',
+            startVersion: MariaDBPluginVersions.V12,
+            componentType: FormComponentType.SWITCH,
+            initialValue: true,
+            tooltip: {
+              markdownText: PARAMETERIZED_SQL_DESCRIPTION
+            },
+            display: {
+              show: {
+                operation: [SqlOperations.RUN_SQL],
+                parameters: ['undefined']
+              }
+            }
           }
         ]
       }

package/src/plugins/templates/mssql.ts

@@ -19,7 +19,8 @@ export const MicrosoftSQLPluginVersions = {
   V7: '0.0.7',
   V8: '0.0.8',
   V9: '0.0.9',
-  V10: '0.0.10'
+  V10: '0.0.10',
+  V11: '0.0.11'
 };
 
 const BASE_HOST = {
@@ -216,6 +217,7 @@ export const MicrosoftSQLPlugin: Plugin = {
             label: 'Operation',
             name: 'operation',
             startVersion: MicrosoftSQLPluginVersions.V9,
+            endVersion: MicrosoftSQLPluginVersions.V10,
             componentType: FormComponentType.DROPDOWN,
             options: [
               {
@@ -231,6 +233,49 @@ export const MicrosoftSQLPlugin: Plugin = {
             ],
             initialValue: SqlOperations.RUN_SQL
           },
+          {
+            // Only show operation dropdown if UPDATE_ROWS was previously selected
+            // This effectively deprecates UPDATE_ROWS for new actions
+            label: 'Operation',
+            name: 'operation',
+            startVersion: MicrosoftSQLPluginVersions.V11,
+            componentType: FormComponentType.DROPDOWN,
+            options: [
+              {
+                displayName: 'Run SQL',
+                key: SqlOperations.RUN_SQL,
+                value: SqlOperations.RUN_SQL
+              },
+              {
+                displayName: 'Insert, update, or delete rows with form',
+                key: SqlOperations.UPDATE_ROWS,
+                value: SqlOperations.UPDATE_ROWS
+              }
+            ],
+            initialValue: SqlOperations.RUN_SQL,
+            display: {
+              show: {
+                operation: [SqlOperations.UPDATE_ROWS]
+              }
+            }
+          },
+          {
+            label: 'Parameters (@PARAM_1, @PARAM_2, ...)',
+            name: 'parameters',
+            startVersion: MicrosoftSQLPluginVersions.V11,
+            ldFlag: 'clark.parameterized-apis.v2.enabled',
+            componentType: FormComponentType.DYNAMIC_INPUT_TEXT,
+            placeholder: '[param1, param2, ...]',
+            tooltip: {
+              markdownText:
+                'JavaScript expression that evaluates to an array of parameter values. Use `@PARAM_1`, `@PARAM_2`, etc. in your SQL query to reference these parameters.'
+            },
+            display: {
+              show: {
+                operation: ['undefined', SqlOperations.RUN_SQL]
+              }
+            }
+          },
           {
             label: '', // Query
             name: 'body',
@@ -497,6 +542,7 @@ export const MicrosoftSQLPlugin: Plugin = {
             label: 'Use parameterized SQL',
             name: 'usePreparedSql',
             startVersion: MicrosoftSQLPluginVersions.V6,
+            endVersion: MicrosoftSQLPluginVersions.V10,
             componentType: FormComponentType.SWITCH,
             initialValue: true,
             tooltip: {
@@ -507,6 +553,22 @@ export const MicrosoftSQLPlugin: Plugin = {
                 operation: ['undefined', SqlOperations.RUN_SQL]
               }
             }
+          },
+          {
+            label: 'Use parameterized SQL',
+            name: 'usePreparedSql',
+            startVersion: MicrosoftSQLPluginVersions.V11,
+            componentType: FormComponentType.SWITCH,
+            initialValue: true,
+            tooltip: {
+              markdownText: PARAMETERIZED_SQL_DESCRIPTION
+            },
+            display: {
+              show: {
+                operation: [SqlOperations.RUN_SQL],
+                parameters: ['undefined']
+              }
+            }
           }
         ]
       }

package/src/plugins/templates/mysql.ts

@@ -19,7 +19,8 @@ export const MySQLPluginVersions = {
   V8: '0.0.8',
   V9: '0.0.9',
   V10: '0.0.10',
-  V11: '0.0.11'
+  V11: '0.0.11',
+  V12: '0.0.12'
 };
 
 const BASE_HOST = {
@@ -356,6 +357,7 @@ export const MySQLPlugin: Plugin = {
             label: 'Operation',
             name: 'operation',
             startVersion: MySQLPluginVersions.V10,
+            endVersion: MySQLPluginVersions.V11,
             componentType: FormComponentType.DROPDOWN,
             options: [
               {
@@ -371,6 +373,49 @@ export const MySQLPlugin: Plugin = {
             ],
             initialValue: SqlOperations.RUN_SQL
           },
+          {
+            // Only show operation dropdown if UPDATE_ROWS was previously selected
+            // This effectively deprecates UPDATE_ROWS for new actions
+            label: 'Operation',
+            name: 'operation',
+            startVersion: MySQLPluginVersions.V12,
+            componentType: FormComponentType.DROPDOWN,
+            options: [
+              {
+                displayName: 'Run SQL',
+                key: SqlOperations.RUN_SQL,
+                value: SqlOperations.RUN_SQL
+              },
+              {
+                displayName: 'Insert, update, or delete rows with form',
+                key: SqlOperations.UPDATE_ROWS,
+                value: SqlOperations.UPDATE_ROWS
+              }
+            ],
+            initialValue: SqlOperations.RUN_SQL,
+            display: {
+              show: {
+                operation: [SqlOperations.UPDATE_ROWS]
+              }
+            }
+          },
+          {
+            label: 'Parameters (?, ?, ...)',
+            name: 'parameters',
+            startVersion: MySQLPluginVersions.V12,
+            ldFlag: 'clark.parameterized-apis.v2.enabled',
+            componentType: FormComponentType.DYNAMIC_INPUT_TEXT,
+            placeholder: '[param1, param2, ...]',
+            tooltip: {
+              markdownText:
+                'JavaScript expression that evaluates to an array of parameter values. Use `?` placeholders in your SQL query to reference these parameters.'
+            },
+            display: {
+              show: {
+                operation: ['undefined', SqlOperations.RUN_SQL]
+              }
+            }
+          },
           {
             label: '', // Query
             name: 'body',
@@ -637,6 +682,7 @@ export const MySQLPlugin: Plugin = {
             label: 'Use parameterized SQL',
             name: 'usePreparedSql',
             startVersion: MySQLPluginVersions.V6,
+            endVersion: MySQLPluginVersions.V11,
             componentType: FormComponentType.SWITCH,
             initialValue: true,
             tooltip: {
@@ -647,6 +693,22 @@ export const MySQLPlugin: Plugin = {
                 operation: ['undefined', SqlOperations.RUN_SQL]
               }
             }
+          },
+          {
+            label: 'Use parameterized SQL',
+            name: 'usePreparedSql',
+            startVersion: MySQLPluginVersions.V12,
+            componentType: FormComponentType.SWITCH,
+            initialValue: true,
+            tooltip: {
+              markdownText: PARAMETERIZED_SQL_DESCRIPTION
+            },
+            display: {
+              show: {
+                operation: [SqlOperations.RUN_SQL],
+                parameters: ['undefined']
+              }
+            }
           }
         ]
       }

package/src/plugins/templates/oracledb.ts

@@ -13,7 +13,8 @@ import { CONNECTION_METHODS_AND_DISPLAY_NAMES, makeDropdownItem } from './shared
 
 export const OracleDbPluginVersions = {
   V1: '0.0.1',
-  V2: '0.0.2'
+  V2: '0.0.2',
+  V3: '0.0.3'
 };
 
 const BASE_HOST = {
@@ -186,10 +187,31 @@ export const OracleDbPlugin: Plugin = {
       {
         name: 'main',
         items: [
+          {
+            label: 'Parameters (:1, :2, ...)',
+            name: 'runSql.parameters',
+            startVersion: OracleDbPluginVersions.V3,
+            ldFlag: 'clark.parameterized-apis.v2.enabled',
+            componentType: FormComponentType.DYNAMIC_INPUT_TEXT,
+            placeholder: '[param1, param2, ...]',
+            tooltip: {
+              markdownText:
+                'JavaScript expression that evaluates to an array of parameter values. Use `:1`, `:2`, etc. in your SQL query to reference these parameters.'
+            }
+          },
           {
             label: '', // Query
             name: 'runSql.sqlBody',
             startVersion: OracleDbPluginVersions.V1,
+            endVersion: OracleDbPluginVersions.V2,
+            componentType: FormComponentType.CODE_EDITOR,
+            language: EditorLanguage.SQL,
+            initialValue: DB_SQL_INITIAL_TEXT
+          },
+          {
+            label: '', // Query
+            name: 'runSql.sqlBody',
+            startVersion: OracleDbPluginVersions.V3,
             componentType: FormComponentType.CODE_EDITOR,
             language: EditorLanguage.SQL,
             initialValue: DB_SQL_INITIAL_TEXT
@@ -203,10 +225,43 @@ export const OracleDbPlugin: Plugin = {
             label: 'Use parameterized SQL',
             name: 'runSql.useParameterized',
             startVersion: OracleDbPluginVersions.V1,
+            endVersion: OracleDbPluginVersions.V2,
+            componentType: FormComponentType.SWITCH,
+            initialValue: true,
+            tooltip: {
+              markdownText: PARAMETERIZED_SQL_DESCRIPTION
+            }
+          },
+          {
+            label: 'Use parameterized SQL',
+            name: 'runSql.useParameterized',
+            startVersion: OracleDbPluginVersions.V3,
+            ldFlag: '!clark.parameterized-apis.v2.enabled',
             componentType: FormComponentType.SWITCH,
             initialValue: true,
             tooltip: {
               markdownText: PARAMETERIZED_SQL_DESCRIPTION
+            },
+            display: {
+              show: {
+                'runSql.parameters': ['undefined']
+              }
+            }
+          },
+          {
+            label: 'Use parameterized SQL',
+            name: 'runSql.useParameterized',
+            startVersion: OracleDbPluginVersions.V3,
+            ldFlag: 'clark.parameterized-apis.v2.enabled',
+            componentType: FormComponentType.SWITCH,
+            initialValue: undefined,
+            tooltip: {
+              markdownText: PARAMETERIZED_SQL_DESCRIPTION
+            },
+            display: {
+              show: {
+                'runSql.parameters': ['undefined']
+              }
             }
           }
         ]

package/src/plugins/templates/postgres.ts

@@ -19,7 +19,8 @@ export const PostgresPluginVersions = {
   V8: '0.0.8',
   V9: '0.0.9',
   V10: '0.0.10',
-  V11: '0.0.11'
+  V11: '0.0.11',
+  V12: '0.0.12'
 };
 
 const BASE_HOST = {
@@ -344,6 +345,7 @@ export const PostgresPlugin: Plugin = {
             label: 'Operation',
             name: 'operation',
             startVersion: PostgresPluginVersions.V10,
+            endVersion: PostgresPluginVersions.V11,
             componentType: FormComponentType.DROPDOWN,
             options: [
               {
@@ -359,6 +361,49 @@ export const PostgresPlugin: Plugin = {
             ],
             initialValue: SqlOperations.RUN_SQL
           },
+          {
+            // Only show operation dropdown if UPDATE_ROWS was previously selected
+            // This effectively deprecates UPDATE_ROWS for new actions
+            label: 'Operation',
+            name: 'operation',
+            startVersion: PostgresPluginVersions.V12,
+            componentType: FormComponentType.DROPDOWN,
+            options: [
+              {
+                displayName: 'Run SQL',
+                key: SqlOperations.RUN_SQL,
+                value: SqlOperations.RUN_SQL
+              },
+              {
+                displayName: 'Insert, update, or delete rows with form',
+                key: SqlOperations.UPDATE_ROWS,
+                value: SqlOperations.UPDATE_ROWS
+              }
+            ],
+            initialValue: SqlOperations.RUN_SQL,
+            display: {
+              show: {
+                operation: [SqlOperations.UPDATE_ROWS]
+              }
+            }
+          },
+          {
+            label: 'Parameters ($1, $2, ...)',
+            name: 'parameters',
+            startVersion: PostgresPluginVersions.V12,
+            ldFlag: 'clark.parameterized-apis.v2.enabled',
+            componentType: FormComponentType.DYNAMIC_INPUT_TEXT,
+            placeholder: '[param1, param2, ...]',
+            tooltip: {
+              markdownText:
+                'JavaScript expression that evaluates to an array of parameter values. Use `$1`, `$2`, etc. in your SQL query to reference these parameters.'
+            },
+            display: {
+              show: {
+                operation: ['undefined', SqlOperations.RUN_SQL]
+              }
+            }
+          },
           {
             label: '', // Query
             name: 'body',
@@ -632,7 +677,8 @@ export const PostgresPlugin: Plugin = {
             },
             display: {
               show: {
-                operation: ['undefined', SqlOperations.RUN_SQL]
+                operation: ['undefined', SqlOperations.RUN_SQL],
+                parameters: ['undefined']
               }
             }
           }

package/src/plugins/templates/redshift.ts

@@ -6,7 +6,8 @@ export const RedshiftPluginVersions = {
   V1: '0.0.1',
   V2: '0.0.2',
   V6: '0.0.6',
-  V7: '0.0.7'
+  V7: '0.0.7',
+  V8: '0.0.8'
 };
 
 const BASE_HOST = {
@@ -221,10 +222,31 @@ export const RedshiftPlugin: Plugin = {
       {
         name: 'main',
         items: [
+          {
+            label: 'Parameters ($1, $2, ...)',
+            name: 'parameters',
+            startVersion: RedshiftPluginVersions.V8,
+            ldFlag: 'clark.parameterized-apis.v2.enabled',
+            componentType: FormComponentType.DYNAMIC_INPUT_TEXT,
+            placeholder: '[param1, param2, ...]',
+            tooltip: {
+              markdownText:
+                'JavaScript expression that evaluates to an array of parameter values. Use `$1`, `$2`, etc. in your SQL query to reference these parameters.'
+            }
+          },
           {
             label: '', // Query
             name: 'body',
             startVersion: RedshiftPluginVersions.V1,
+            endVersion: RedshiftPluginVersions.V7,
+            componentType: FormComponentType.CODE_EDITOR,
+            language: EditorLanguage.SQL,
+            initialValue: SQL_INITIAL_TEXT
+          },
+          {
+            label: '', // Query
+            name: 'body',
+            startVersion: RedshiftPluginVersions.V8,
             componentType: FormComponentType.CODE_EDITOR,
             language: EditorLanguage.SQL,
             initialValue: SQL_INITIAL_TEXT
@@ -238,11 +260,27 @@ export const RedshiftPlugin: Plugin = {
             label: 'Use parameterized SQL',
             name: 'usePreparedSql',
             startVersion: RedshiftPluginVersions.V6,
+            endVersion: RedshiftPluginVersions.V7,
             componentType: FormComponentType.SWITCH,
             initialValue: true,
             tooltip: {
               markdownText: PARAMETERIZED_SQL_DESCRIPTION
             }
+          },
+          {
+            label: 'Use parameterized SQL',
+            name: 'usePreparedSql',
+            startVersion: RedshiftPluginVersions.V8,
+            componentType: FormComponentType.SWITCH,
+            initialValue: true,
+            tooltip: {
+              markdownText: PARAMETERIZED_SQL_DESCRIPTION
+            },
+            display: {
+              show: {
+                parameters: ['undefined']
+              }
+            }
           }
         ]
       }

package/src/plugins/templates/snowflake.ts

@@ -27,7 +27,8 @@ export const SnowflakePluginVersions = {
   V7: '0.0.7',
   V8: '0.0.8',
   V9: '0.0.9',
-  V10: '0.0.10'
+  V10: '0.0.10',
+  V11: '0.0.11'
 };
 
 const CONNECTION_TYPE_FIELD = 'connectionType';
@@ -461,10 +462,31 @@ export const SnowflakePlugin: Plugin = {
       {
         name: 'main',
         items: [
+          {
+            label: 'Parameters (?, ?, ...)',
+            name: 'parameters',
+            startVersion: SnowflakePluginVersions.V11,
+            ldFlag: 'clark.parameterized-apis.v2.enabled',
+            componentType: FormComponentType.DYNAMIC_INPUT_TEXT,
+            placeholder: '[param1, param2, ...]',
+            tooltip: {
+              markdownText:
+                'JavaScript expression that evaluates to an array of parameter values. Use `?` placeholders in your SQL query to reference these parameters.'
+            }
+          },
           {
             label: '', // Query
             name: 'body',
             startVersion: SnowflakePluginVersions.V1,
+            endVersion: SnowflakePluginVersions.V10,
+            componentType: FormComponentType.CODE_EDITOR,
+            language: EditorLanguage.SQL,
+            initialValue: SQL_INITIAL_TEXT
+          },
+          {
+            label: '', // Query
+            name: 'body',
+            startVersion: SnowflakePluginVersions.V11,
             componentType: FormComponentType.CODE_EDITOR,
             language: EditorLanguage.SQL,
             initialValue: SQL_INITIAL_TEXT
@@ -478,10 +500,26 @@ export const SnowflakePlugin: Plugin = {
             label: 'Use parameterized SQL',
             name: 'usePreparedSql',
             startVersion: SnowflakePluginVersions.V6,
+            endVersion: SnowflakePluginVersions.V10,
+            componentType: FormComponentType.SWITCH,
+            initialValue: true,
+            tooltip: {
+              markdownText: PARAMETERIZED_SQL_DESCRIPTION
+            }
+          },
+          {
+            label: 'Use parameterized SQL',
+            name: 'usePreparedSql',
+            startVersion: SnowflakePluginVersions.V11,
             componentType: FormComponentType.SWITCH,
             initialValue: true,
             tooltip: {
               markdownText: PARAMETERIZED_SQL_DESCRIPTION
+            },
+            display: {
+              show: {
+                parameters: ['undefined']
+              }
             }
           }
         ]

package/src/socket/protocol.ts

@@ -2,7 +2,7 @@
 
 import { DirectoryEntry, PutManyRequestPayload, PutManyResponsePayload } from '../dbfs/types.js';
 import { ApiToSign, ApiToVerify, AppToSign, AppToVerify, ApplicationSignatureTreeSigned, Signature } from '../signing/constants.js';
-import { AiChatMessageDto, AiChatMessagePayload } from '../types/index.js';
+import { AiChatMessageDto, AiChatMessagePayload, AiWorkflowEvent } from '../types/index.js';
 import {
   ApplicationConfiguration,
   ApplicationPageClonePayload,
@@ -120,12 +120,20 @@ export interface ServerMethods {
       chat: {
         pushMessage: ServerMethodSchema<
           { applicationId: string; payload: AiChatMessagePayload; version?: number; branchName?: string | null },
-          void
+          { chatmessageId: string }
+        >;
+        getMessages: ServerMethodSchema<
+          { applicationId: string; branchName?: string | null; limit?: number },
+          { messages: AiChatMessageDto[] }
         >;
-        getMessages: ServerMethodSchema<{ applicationId: string; branchName?: string | null }, { messages: AiChatMessageDto[] }>;
         new: ServerMethodSchema<{ applicationId: string; branchName?: string | null }, void>;
         truncateAfterTimestamp: ServerMethodSchema<{ applicationId: string; sinceTimestamp: number }, void>;
       };
+      billing: {
+        workflowSummary: {
+          submit: ServerMethodSchema<AiWorkflowEvent, void>;
+        };
+      };
     };
   };
   v2: {

package/src/types/ai/index.ts

@@ -7,3 +7,39 @@ export type AiChatMessageDto = {
   authorEmail?: string | null;
   authorName?: string | null;
 };
+
+/**
+ * System event trigger types for AI operations without prompt_id
+ */
+export enum AiSystemTriggerType {
+  COMMIT_MESSAGE = 'commit_message'
+}
+
+/**
+ * Attributes for AI workflow summary events (used in CloudEvents)
+ * These are the core metrics tracked for AI workflows
+ */
+export interface AiWorkflowAttributes {
+  /** Total number of tool invocations across all LLM calls */
+  tool_call_count?: number;
+  /** Total number of reasoning steps across all LLM calls */
+  step_count?: number;
+  /** Total lines of code added during workflow */
+  lines_added?: number;
+  /** Total lines of code edited during workflow */
+  lines_edited?: number;
+  /** Total lines of code removed during workflow */
+  lines_removed?: number;
+  /** When the workflow started (first LLM call) */
+  workflow_started_at?: string;
+  /** When the workflow completed (last LLM call) */
+  workflow_completed_at?: string;
+}
+
+/**
+ * AI workflow summary with promptId for socket protocol
+ */
+export interface AiWorkflowEvent {
+  promptId: string;
+  attributes: AiWorkflowAttributes;
+}

package/src/types/api/action.ts

@@ -96,6 +96,7 @@ export type GoogleSheetsActionConfiguration = {
 export type DBActionConfiguration = {
   body?: string;
   usePreparedSql?: boolean;
+  parameters?: string;
   // When operation is undefined we assume it's RUN_SQL, otherwise it's part of the SqlOperations enum
   operation?: string;
   // When using operation UPDATE_ROWS the default behavior is to match by primary key- but

package/src/types/plugin/form.ts

@@ -150,6 +150,11 @@ export interface BaseFormItem {
   agentType?: AgentType;
   actionOptions?: { label?: string; value: string; children: { label: string; value: string; description?: string }[] }[];
   transformation?: FormItemTransformation;
+  /**
+   * LaunchDarkly feature flag that controls whether this form item is shown.
+   * If the flag evaluates to false, the item is removed from the form.
+   * Supports negation with "!" prefix (e.g., "!feature.disabled" shows when flag is false).
+   */
   ldFlag?: string;
 }