@dharta/cli 0.6.77 → 0.6.78

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@dharta/cli",
-  "version": "0.6.77",
+  "version": "0.6.78",
   "description": "Command-line interface for the Dharta API.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dharta-ai/dharta.git",
+    "directory": "sdks/typescript-cli"
+  },
   "type": "module",
   "bin": {
     "dharta": "./dist/cli.js"
@@ -14,20 +19,25 @@
     "templates"
   ],
   "bundledDependencies": [
-    "@dharta/sdk"
+    "@dharta/sdk",
+    "@dharta/contracts"
   ],
   "scripts": {
     "build": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
-    "test": "vitest run",
+    "docs:cli": "npm run build && node scripts/write-cli-reference.mjs",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "npm run typecheck && vitest run",
     "test:watch": "vitest"
   },
   "engines": {
-    "node": ">=18.17.0"
+    "node": ">=22.12.0"
   },
   "dependencies": {
-    "@dharta/sdk": "^0.6.77",
+    "@dharta/contracts": "file:../contracts",
+    "@dharta/sdk": "^0.6.78",
     "@iarna/toml": "^2.2.5",
-    "commander": "^15.0.0"
+    "commander": "^15.0.0",
+    "jq-wasm": "3.0.0-jq-1.8.2"
   },
   "devDependencies": {
     "@types/node": "^26.0.1",

package/src/agent.ts

@@ -7,6 +7,7 @@ import * as path from "node:path";
 import { existsSync, statSync } from "node:fs";
 import { findGitRoot, scanAgentFolders, describeFolder, type AgentFolder } from "./setup-scan.js";
 import { normalizeNonBlank } from "./validators.js";
+import { CliUsageError } from "./exit-codes.js";
 
 const AGENT_SLUG_FORMAT = /^[a-z0-9][a-z0-9-]{0,62}$/;
 const MAX_AGENT_NAME_CHARACTERS = 100;
@@ -119,7 +120,7 @@ export function validateAgentSlug(value: string, label: string): string {
   const normalized = normalizeNonBlank(value, label);
   if (!AGENT_SLUG_FORMAT.test(normalized)) {
     const suggestion = slugSuggestion(normalized);
-    throw new Error(
+    throw new CliUsageError(
       `${label} must be a valid agent slug: lowercase letters, digits, hyphens; max 63.` +
         (suggestion ? ` Did you mean ${suggestion}?` : ""),
     );
@@ -133,7 +134,7 @@ export function validateAgentSlug(value: string, label: string): string {
 export function validateAgentName(value: string, label = "agent name"): string {
   const normalized = normalizeNonBlank(value, label);
   if ([...normalized].length > MAX_AGENT_NAME_CHARACTERS) {
-    throw new Error(`${label} must be 1-${MAX_AGENT_NAME_CHARACTERS} characters.`);
+    throw new CliUsageError(`${label} must be 1-${MAX_AGENT_NAME_CHARACTERS} characters.`);
   }
   return normalized;
 }

package/src/api-error.ts

@@ -4,6 +4,7 @@
 // hierarchy, which the CLI doesn't surface).
 
 import { SENSITIVE_API_KEY_SCOPES } from "./commands/scopes.js";
+import { CliApiError, CliNetworkError } from "./exit-codes.js";
 
 export function cliFormatError(status: number, parsed: unknown): Error {
   // Server messages already name fixes (e.g. the transcript-access 403 points
@@ -34,17 +35,17 @@ export function cliFormatError(status: number, parsed: unknown): Error {
       "Check the id or agent slug; for agent commands, run `dharta agent list`. " +
       "Run `dharta auth status` to confirm the active host; DHARTA_BASE_URL must point at the Dharta control API.";
   }
-  const err = new Error(message) as Error & { status?: number; body?: unknown };
-  err.status = status;
-  err.body = parsed;
-  return err;
+  // CliApiError, not a bare Error: `err.status` is what the exit-code
+  // taxonomy branches on, and a named class keeps that contract visible.
+  return new CliApiError(message, status, parsed);
 }
 
 export function cliFormatNetworkError(url: string, error: unknown): Error {
   const origin = new URL(url).origin;
-  return new Error(
+  return new CliNetworkError(
     `Could not reach Dharta at ${origin} (${formatCause(error)}). ` +
       "Check your network and DHARTA_BASE_URL, then try again.",
+    url,
   );
 }