manifest.json

{
  "$schema": "https://databricks.github.io/appkit/schemas/plugin-manifest.schema.json",
  "name": "analytics",
  "displayName": "Analytics Plugin",
  "description": "SQL query execution against Databricks SQL Warehouses",
  "agentHint": "Run 'databricks warehouses list' to find your SQL Warehouse ID.",
  "resources": {
    "required": [
      {
        "type": "sql_warehouse",
        "alias": "SQL Warehouse",
        "resourceKey": "sql-warehouse",
        "description": "SQL Warehouse for executing analytics queries",
        "permission": "CAN_USE",
        "fields": {
          "id": {
            "env": "DATABRICKS_WAREHOUSE_ID",
            "description": "SQL Warehouse ID",
            "resolution": "user-provided",
            "discovery": {
              "cliCommand": "databricks warehouses list --profile <PROFILE> -o json",
              "selectField": ".id",
              "displayField": ".name",
              "shortcut": "databricks experimental aitools tools get-default-warehouse --profile <PROFILE>"
            }
          }
        }
      }
    ],
    "optional": []
  },
  "config": {
    "schema": {
      "type": "object",
      "properties": {
        "timeout": {
          "type": "number",
          "default": 30000,
          "description": "Query execution timeout in milliseconds"
        }
      }
    }
  },
  "postScaffold": [
    { "step": 1, "instruction": "Create SQL query files in config/queries/" },
    { "step": 2, "instruction": "Run: npm run typegen", "blocking": true },
    {
      "step": 3,
      "instruction": "Read client/src/appKitTypes.d.ts for generated types"
    },
    { "step": 4, "instruction": "Write UI code using the generated types" },
    {
      "step": 5,
      "instruction": "Update tests/smoke.spec.ts selectors for your app"
    }
  ]
}