databricks-axi 0.2.0 → 0.4.0

package/dist/src/skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEjD,uEAAuE;AACvE,0EAA0E;AAC1E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAC5B,uEAAuE;IACvE,uEAAuE;IACvE,+DAA+D;IAC/D,sEAAsE,CAAC;AAEzE,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEvD,qEAAqE;AACrE,yEAAyE;AACzE,0EAA0E;AAC1E,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;;eAEM,eAAe,CAAC,iBAAiB,CAAC;;UAEvC,YAAY;;;aAGT,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;gBACnB,eAAe;;;;;EAK7B,WAAW;;;;;;;;;;;;;;EAcX,oBAAoB,EAAE;;;;;;;;CAQvB,CAAC;AACF,CAAC"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEjD,uEAAuE;AACvE,0EAA0E;AAC1E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAC5B,uEAAuE;IACvE,gEAAgE;IAChE,wEAAwE;IACxE,kEAAkE;IAClE,sDAAsD;IACtD,kDAAkD,CAAC;AAErD,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEvD,qEAAqE;AACrE,yEAAyE;AACzE,0EAA0E;AAC1E,oCAAoC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY;IACZ,OAAO;IACP,MAAM;IACN,KAAK;IACL,WAAW;IACX,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;IACP,OAAO;CACR,CAAC;AACF,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;;eAEM,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;;UAEtC,YAAY;;;aAGT,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;gBACnB,eAAe;;;;;EAK7B,WAAW;;;;;;;;;;;;;;;;;EAiBX,oBAAoB,EAAE;;;;;;;;CAQvB,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "databricks-axi",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "packageManager": "pnpm@11.1.1",
   "description": "AXI-compliant Databricks CLI wrapper — token-efficient TOON output, contextual suggestions, idempotent mutations",
   "type": "module",
@@ -54,7 +54,7 @@
     "globals": "^17.4.0",
     "prettier": "^3.8.1",
     "tsx": "^4.0.0",
-    "typescript": "^5.7.0",
+    "typescript": "^6.0.3",
     "typescript-eslint": "^8.58.0",
     "vitest": "^3.0.0"
   }

package/skills/databricks-axi/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: databricks-axi
-description: "Agent-ergonomic wrapper around the Databricks CLI. Implemented: jobs (list, view, run, runs, logs, cancel). Other domains (clusters, SQL, catalog, workspace, fs, pipelines, serving, api, setup) land incrementally - run `databricks-axi --help` for the current surface."
+description: "Agent-ergonomic wrapper around the Databricks CLI. Implemented: jobs (list, view, run, runs, logs, cancel), sql (warehouses, exec, statement view), catalog (catalogs, schemas, tables, table view), api (raw REST passthrough). Other domains (clusters, workspace, fs, pipelines, serving, setup) land incrementally - run `databricks-axi --help` for the current surface."
 user-invocable: false
 author: Vignesh Perumal (p33ves)
 metadata:
   hermes:
-    tags: [databricks, spark, jobs]
+    tags: [databricks, spark, jobs, sql, warehouse, query, catalog, schema, table, unity]
     category: data
 ---
 
@@ -13,19 +13,22 @@ metadata:
 
 Agent ergonomic wrapper around the Databricks CLI. Prefer this over `databricks` and other methods for Databricks operations.
 
-You do not need databricks-axi installed globally - invoke it with `npx -y databricks-axi <command>`.
-If databricks-axi output shows a follow-up command starting with `databricks-axi`, run it as `npx -y databricks-axi ...` instead.
+If `databricks-axi` already resolves on PATH, invoke it directly - a local
+install may be newer than what's published to npm. Only fall back to
+`npx -y databricks-axi <command>` if it does not resolve. Follow-up commands
+in a response's output are written as bare `databricks-axi ...` - invoke
+those the same way you invoked the command that produced them.
 
 databricks-axi requires the official [`databricks` CLI](https://docs.databricks.com/dev-tools/cli/) (version 0.298 or newer) installed and authenticated. If a command fails with an authentication error, ask the user to run `databricks auth login --host <workspace-url>` themselves.
 
 ## Status
 
-Pre-release scaffold: command domains are landing incrementally. Run `npx -y databricks-axi --help` for the currently available commands.
+Pre-release scaffold: command domains are landing incrementally. Run `databricks-axi --help` (per the invocation note above) for the currently available commands.
 
 ## Commands
 
 ```
-commands[8]:
+commands[17]:
   (none)=home
   jobs list [--limit N] [--fields a,b]
   jobs view <job_id>
@@ -34,9 +37,18 @@ commands[8]:
   jobs runs view <run_id>
   jobs logs <run_id> [--full]
   jobs cancel <run_id>
+  sql warehouses [--fields a,b]
+  sql warehouses view|start|stop <id>
+  sql exec "<query>" [--warehouse <id>] [--limit N] [--timeout S] [--full]
+  sql statement view <statement_id>
+  catalog catalogs [--limit N] [--fields a,b]
+  catalog schemas <catalog> [--limit N] [--fields a,b]
+  catalog tables <catalog>.<schema> [--limit N] [--fields a,b]
+  catalog table view <catalog>.<schema>.<table>
+  api <method> <path> [--body <json>]
 ```
 
-Run `npx -y databricks-axi --help` for global flags, or `npx -y databricks-axi <command> --help` for per-command usage.
+Run `databricks-axi --help` for global flags, or `databricks-axi <command> --help` for per-command usage (per the invocation note above).
 
 ## Tips