improvement(clickhouse): expand block templates and skills, normalize tool versions

- Expand ClickHouseBlockMeta templates from 3 to 9 (schema docs, table maintenance, partition retention, long-running-query alerts, table provisioning, storage growth report)
- Add document-schema and maintain-tables skills (now 5, all grounded in tools.access)
- Normalize tool version '1.0' to '1.0.0' across all 26 tools for repo consistency

Author: waleedlatif1

apps/sim/blocks/blocks/clickhouse.ts

@@ -1,5 +1,14 @@
 import { getErrorMessage } from '@sim/utils/errors'
-import { ClipboardList, File } from '@/components/emcn/icons'
+import {
+  Bell,
+  ClipboardList,
+  Database,
+  File,
+  Search,
+  Server,
+  Trash,
+  Wrench,
+} from '@/components/emcn/icons'
 import { ClickHouseIcon } from '@/components/icons'
 import type { BlockConfig, BlockMeta } from '@/blocks/types'
 import { IntegrationType } from '@/blocks/types'
@@ -497,6 +506,62 @@ export const ClickHouseBlockMeta = {
       category: 'engineering',
       tags: ['data-analytics', 'data-warehouse'],
     },
+    {
+      icon: Search,
+      title: 'Document a ClickHouse schema',
+      prompt:
+        'Build a workflow that introspects my ClickHouse database schema, then has an agent write clear documentation describing each table, its columns, types, and engine.',
+      modules: ['agent', 'workflows'],
+      category: 'engineering',
+      tags: ['data-warehouse', 'documentation'],
+    },
+    {
+      icon: Wrench,
+      title: 'Scheduled table maintenance',
+      prompt:
+        'Create a scheduled workflow that runs OPTIMIZE TABLE on my high-write ClickHouse tables each night to merge parts, then reports the resulting part counts and storage size.',
+      modules: ['scheduled', 'workflows'],
+      category: 'engineering',
+      tags: ['data-warehouse', 'maintenance'],
+    },
+    {
+      icon: Trash,
+      title: 'Partition retention cleanup',
+      prompt:
+        'Build a scheduled workflow that lists the partitions of my ClickHouse events table and drops partitions older than the retention window to keep storage under control.',
+      modules: ['scheduled', 'agent', 'workflows'],
+      category: 'engineering',
+      tags: ['data-warehouse', 'maintenance'],
+    },
+    {
+      icon: Bell,
+      title: 'Alert on long-running queries',
+      prompt:
+        'Create a scheduled workflow that checks ClickHouse for running queries, and if any has been running too long, posts an alert to Slack and optionally kills the query.',
+      modules: ['scheduled', 'agent', 'workflows'],
+      category: 'engineering',
+      tags: ['monitoring', 'data-warehouse'],
+      alsoIntegrations: ['slack'],
+    },
+    {
+      icon: Database,
+      title: 'Provision a ClickHouse table from a spec',
+      prompt:
+        'Build a workflow where I describe the table I need in plain English, an agent designs the columns, engine, and ORDER BY key, and the workflow creates the ClickHouse table.',
+      modules: ['agent', 'workflows'],
+      category: 'engineering',
+      tags: ['data-warehouse', 'schema'],
+    },
+    {
+      icon: Server,
+      title: 'Weekly storage growth report',
+      prompt:
+        'Create a scheduled workflow that collects ClickHouse table stats (rows and size on disk) each week, has an agent summarize the largest tables and fastest growth, and posts the report to Slack.',
+      modules: ['scheduled', 'agent', 'workflows'],
+      category: 'engineering',
+      tags: ['monitoring', 'reporting'],
+      alsoIntegrations: ['slack'],
+    },
   ],
   skills: [
     {
@@ -520,5 +585,19 @@ export const ClickHouseBlockMeta = {
       content:
         '# Bulk Insert Events\n\nLoad a batch of records into a ClickHouse table.\n\n## Steps\n1. Use Describe Table to confirm the target column names and types.\n2. Map each incoming payload to those columns, coercing types (e.g. timestamps to DateTime format, numbers to the right width).\n3. Build a JSON array of row objects with consistent keys, then use Insert Rows (Bulk) against the table.\n4. Verify with Count Rows or a small SELECT.\n\n## Output\nReturn the number of rows inserted and any rows that were skipped or failed validation, with the reason. Confirm the new total row count so the caller knows ingestion succeeded.',
     },
+    {
+      name: 'document-schema',
+      description:
+        'Introspect a ClickHouse database and produce readable documentation of its tables, columns, and engines. Use when onboarding to an unfamiliar ClickHouse instance or refreshing schema docs.',
+      content:
+        '# Document Schema\n\nInspect a ClickHouse database and describe its structure.\n\n## Steps\n1. Use Introspect Schema to pull every table with its columns, types, and engine in one call. For a single table, use Describe Table or Show Create Table instead.\n2. Group columns by table and note primary/sorting key membership and defaults.\n3. Summarize each table: what it appears to store, its engine, key columns, and approximate row count.\n\n## Output\nReturn a per-table summary (name, engine, key columns, row count) followed by a column reference. Keep it concise and skimmable; call out anything unusual such as missing ORDER BY keys or very wide tables.',
+    },
+    {
+      name: 'maintain-tables',
+      description:
+        'Keep ClickHouse tables healthy by inspecting parts, optimizing tables, and dropping stale partitions. Use for scheduled maintenance or when storage or part counts grow.',
+      content:
+        '# Maintain Tables\n\nRun routine ClickHouse table maintenance.\n\n## Steps\n1. Use Table Stats and List Partitions to see size on disk, part counts, and per-partition rows.\n2. For tables with many small parts, run Optimize Table (optionally with Force Final Merge) to consolidate them.\n3. For time-partitioned tables past their retention window, use Drop Partition on the oldest partitions.\n4. Re-check Table Stats to confirm the part count and size dropped.\n\n## Output\nReport what was optimized or dropped, the before/after part count and size on disk, and any partitions intentionally retained. Never drop a partition unless it is clearly outside the retention window.',
+    },
   ],
 } as const satisfies BlockMeta

apps/sim/tools/clickhouse/count-rows.ts

@@ -5,7 +5,7 @@ export const countRowsTool: ToolConfig<ClickHouseCountRowsParams, ClickHouseCoun
   id: 'clickhouse_count_rows',
   name: 'ClickHouse Count Rows',
   description: 'Count rows in a ClickHouse table, optionally filtered',
-  version: '1.0',
+  version: '1.0.0',
 
   params: {
     host: {

apps/sim/tools/clickhouse/create-database.ts

@@ -11,7 +11,7 @@ export const createDatabaseTool: ToolConfig<
   id: 'clickhouse_create_database',
   name: 'ClickHouse Create Database',
   description: 'Create a new database on a ClickHouse server',
-  version: '1.0',
+  version: '1.0.0',
 
   params: {
     host: {

apps/sim/tools/clickhouse/create-table.ts

@@ -8,7 +8,7 @@ export const createTableTool: ToolConfig<ClickHouseCreateTableParams, ClickHouse
   id: 'clickhouse_create_table',
   name: 'ClickHouse Create Table',
   description: 'Create a new MergeTree-family table in ClickHouse',
-  version: '1.0',
+  version: '1.0.0',
 
   params: {
     host: {

apps/sim/tools/clickhouse/delete.ts

@@ -5,7 +5,7 @@ export const deleteTool: ToolConfig<ClickHouseDeleteParams, ClickHouseDeleteResp
   id: 'clickhouse_delete',
   name: 'ClickHouse Delete',
   description: 'Delete rows from a ClickHouse table via an ALTER TABLE ... DELETE mutation',
-  version: '1.0',
+  version: '1.0.0',
 
   params: {
     host: {

apps/sim/tools/clickhouse/describe-table.ts

@@ -9,7 +9,7 @@ export const describeTableTool: ToolConfig<ClickHouseDescribeTableParams, ClickH
     id: 'clickhouse_describe_table',
     name: 'ClickHouse Describe Table',
     description: 'Describe the columns of a ClickHouse table',
-    version: '1.0',
+    version: '1.0.0',
 
     params: {
       host: {

apps/sim/tools/clickhouse/drop-database.ts

@@ -9,7 +9,7 @@ export const dropDatabaseTool: ToolConfig<ClickHouseDropDatabaseParams, ClickHou
     id: 'clickhouse_drop_database',
     name: 'ClickHouse Drop Database',
     description: 'Drop a database from a ClickHouse server',
-    version: '1.0',
+    version: '1.0.0',
 
     params: {
       host: {

apps/sim/tools/clickhouse/drop-partition.ts

@@ -11,7 +11,7 @@ export const dropPartitionTool: ToolConfig<
   id: 'clickhouse_drop_partition',
   name: 'ClickHouse Drop Partition',
   description: 'Drop a partition from a ClickHouse table',
-  version: '1.0',
+  version: '1.0.0',
 
   params: {
     host: {

apps/sim/tools/clickhouse/drop-table.ts

@@ -5,7 +5,7 @@ export const dropTableTool: ToolConfig<ClickHouseDropTableParams, ClickHouseMess
   id: 'clickhouse_drop_table',
   name: 'ClickHouse Drop Table',
   description: 'Drop a table from a ClickHouse database',
-  version: '1.0',
+  version: '1.0.0',
 
   params: {
     host: {

apps/sim/tools/clickhouse/execute.ts

@@ -5,7 +5,7 @@ export const executeTool: ToolConfig<ClickHouseExecuteParams, ClickHouseExecuteR
   id: 'clickhouse_execute',
   name: 'ClickHouse Execute',
   description: 'Execute raw SQL (DDL, mutations, or queries) on a ClickHouse database',
-  version: '1.0',
+  version: '1.0.0',
 
   params: {
     host: {