@dirxai/cli 0.2.1 → 0.3.1

package/dist/index.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-import { readFileSync, existsSync, mkdirSync, writeFileSync, readdirSync, statSync, chmodSync } from 'fs';
-import { dirname, resolve, join, extname, relative } from 'path';
+import { readFileSync, existsSync, mkdirSync, writeFileSync, chmodSync } from 'fs';
+import { dirname, resolve, join } from 'path';
 import { homedir } from 'os';
+import { detectFramework, scanRoutes, getAuthHint } from '@dirxai/core';
 import { readFile } from 'fs/promises';
 import { fileURLToPath } from 'url';
 import { Command } from 'commander';
@@ -184,24 +185,6 @@ Next steps:`);
   console.log(`  2. Run 'dirx generate' to scan routes`);
   console.log(`  3. Run 'dirx register --domain <your-domain>' to publish`);
 }
-function detectFramework(target) {
-  if (existsSync(join(target, "Cargo.toml"))) {
-    return { lang: "rust", framework: "axum" };
-  }
-  if (existsSync(join(target, "go.mod"))) {
-    return { lang: "go", framework: "net/http" };
-  }
-  if (existsSync(join(target, "package.json"))) {
-    if (existsSync(join(target, "next.config.js")) || existsSync(join(target, "next.config.mjs"))) {
-      return { lang: "node", framework: "nextjs" };
-    }
-    return { lang: "node", framework: "express" };
-  }
-  if (existsSync(join(target, "requirements.txt")) || existsSync(join(target, "pyproject.toml"))) {
-    return { lang: "python", framework: "fastapi" };
-  }
-  return { lang: "unknown", framework: "generic" };
-}
 var init_init = __esm({
   "src/commands/init.ts"() {
   }
@@ -310,12 +293,8 @@ async function runGenerate(dir, opts) {
     process.exitCode = 1;
     return;
   }
-  const { framework } = detectFrameworkFromPackage(target);
-  const patterns = getRoutePatterns(framework);
-  const routes = [];
-  if (patterns.length > 0) {
-    scanDir(target, target, patterns, framework, routes, 0);
-  }
+  const { framework } = detectFramework(target);
+  const routes = scanRoutes(target, framework);
   console.log(`Scanned ${target} (${framework})`);
   if (routes.length > 0) {
     console.log(`
@@ -342,106 +321,8 @@ Registering with gateway...`);
     });
   }
 }
-function detectFrameworkFromPackage(target) {
-  const pkgPath = join(target, "package.json");
-  if (existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-      const deps = {
-        ...pkg.dependencies,
-        ...pkg.devDependencies
-      };
-      if (deps.next) return { framework: "nextjs" };
-      if (deps.hono) return { framework: "hono" };
-      if (deps.fastify) return { framework: "fastify" };
-      if (deps.express) return { framework: "express" };
-    } catch {
-    }
-  }
-  if (existsSync(join(target, "go.mod")))
-    return { framework: "go" };
-  if (existsSync(join(target, "Cargo.toml")))
-    return { framework: "axum" };
-  if (existsSync(join(target, "requirements.txt")) || existsSync(join(target, "pyproject.toml")))
-    return { framework: "fastapi" };
-  return { framework: "generic" };
-}
-function getRoutePatterns(framework) {
-  switch (framework) {
-    case "express":
-    case "hono":
-    case "fastify":
-      return [".get(", ".post(", ".put(", ".delete(", ".patch(", "router."];
-    case "nextjs":
-      return ["export default", "export async function"];
-    case "fastapi":
-      return ["@app.get", "@app.post", "@app.put", "@app.delete", "@router."];
-    case "go":
-      return ["HandleFunc(", "Get(", "Post(", "Put(", "Delete(", "r.Route("];
-    case "axum":
-      return [".route(", ".get(", ".post(", ".put(", ".delete("];
-    default:
-      return [];
-  }
-}
-function scanDir(root, dir, patterns, framework, routes, depth) {
-  if (depth > MAX_SCAN_DEPTH) return;
-  let entries;
-  try {
-    entries = readdirSync(dir);
-  } catch {
-    return;
-  }
-  for (const name of entries) {
-    if (SKIP_DIRS.has(name)) continue;
-    const fullPath = join(dir, name);
-    let stat;
-    try {
-      stat = statSync(fullPath);
-    } catch {
-      continue;
-    }
-    if (stat.isDirectory()) {
-      scanDir(root, fullPath, patterns, framework, routes, depth + 1);
-      continue;
-    }
-    if (!stat.isFile()) continue;
-    if (!SCAN_EXTENSIONS.has(extname(name))) continue;
-    try {
-      const content = readFileSync(fullPath, "utf-8");
-      if (patterns.some((p) => content.includes(p))) {
-        routes.push({
-          file: relative(root, fullPath),
-          framework
-        });
-      }
-    } catch {
-    }
-  }
-}
-var MAX_SCAN_DEPTH, SKIP_DIRS, SCAN_EXTENSIONS;
 var init_generate = __esm({
   "src/commands/generate.ts"() {
-    MAX_SCAN_DEPTH = 8;
-    SKIP_DIRS = /* @__PURE__ */ new Set([
-      "node_modules",
-      ".git",
-      "target",
-      "__pycache__",
-      "vendor",
-      "dist",
-      "build",
-      ".next"
-    ]);
-    SCAN_EXTENSIONS = /* @__PURE__ */ new Set([
-      ".ts",
-      ".tsx",
-      ".js",
-      ".jsx",
-      ".py",
-      ".go",
-      ".rs"
-    ]);
   }
 });
 
@@ -643,35 +524,130 @@ var init_client = __esm({
   }
 });
 
-// src/keys/provider-map.ts
-function getAuthHint(domain) {
-  return providers[domain] ?? null;
-}
-var providers;
-var init_provider_map = __esm({
-  "src/keys/provider-map.ts"() {
-    providers = {
-      "api.github.com": {
-        envVar: "GITHUB_TOKEN",
-        guideUrl: "https://github.com/settings/tokens"
-      },
-      "api.openai.com": {
-        envVar: "OPENAI_API_KEY",
-        guideUrl: "https://platform.openai.com/api-keys"
-      },
-      "api.anthropic.com": {
-        envVar: "ANTHROPIC_API_KEY",
-        guideUrl: "https://console.anthropic.com/settings/keys"
-      },
-      "generativelanguage.googleapis.com": {
-        envVar: "GOOGLE_API_KEY",
-        guideUrl: "https://aistudio.google.com/apikey"
-      },
-      "api.stripe.com": {
-        envVar: "STRIPE_SECRET_KEY",
-        guideUrl: "https://dashboard.stripe.com/apikeys"
+// src/format.ts
+function isSearchResults(data) {
+  if (!Array.isArray(data) || data.length === 0) return false;
+  const first = data[0];
+  return typeof first === "object" && first !== null && "domain" in first && ("title" in first || "name" in first);
+}
+function isEndpointResults(data) {
+  if (!Array.isArray(data) || data.length === 0) return false;
+  const first = data[0];
+  return typeof first === "object" && first !== null && "method" in first && "path" in first;
+}
+function extractPayload(result) {
+  if (typeof result !== "object" || result === null) return result;
+  const obj = result;
+  if ("ok" in obj && "data" in obj) {
+    const data = obj.data;
+    if (typeof data === "object" && data !== null && "results" in data) {
+      return data.results;
+    }
+    return data;
+  }
+  if ("results" in obj && "query" in obj) return obj.results;
+  return result;
+}
+function formatLs(result) {
+  const payload = extractPayload(result);
+  if (Array.isArray(payload)) {
+    if (payload.length === 0) return "(empty)";
+    return payload.map((item) => typeof item === "string" ? item : JSON.stringify(item)).join("\n");
+  }
+  if (typeof payload === "object" && payload !== null && "items" in payload) {
+    const items = payload.items;
+    if (!Array.isArray(items) || items.length === 0) return "(empty)";
+    const rich = items.some(
+      (item) => typeof item === "object" && item !== null && "path" in item
+    );
+    if (!rich) {
+      return items.map((item) => typeof item === "string" ? item : JSON.stringify(item)).join("\n");
+    }
+    const entries = items;
+    const maxPath = Math.min(
+      40,
+      Math.max(8, ...entries.map((e) => (e.path ?? "").length))
+    );
+    return entries.map((entry) => {
+      const path = entry.path ?? "<unknown>";
+      const title = entry.title ?? "";
+      if (title) {
+        return `${path.padEnd(maxPath)}  ${title}`;
       }
-    };
+      return path;
+    }).join("\n");
+  }
+  return JSON.stringify(payload);
+}
+function formatGrep(result) {
+  const payload = extractPayload(result);
+  if (isSearchResults(payload)) {
+    if (payload.length === 0) return "(no matches)";
+    let domainCount = 0;
+    let endpointCount = 0;
+    const blocks = payload.map((s) => {
+      domainCount++;
+      const name = s.title || s.name || "";
+      const header = name ? `${s.domain}  ${name}` : s.domain;
+      const lines = [header];
+      if (s.description) {
+        const desc = s.description.length > 80 ? s.description.slice(0, 77) + "..." : s.description;
+        lines.push(`  ${desc}`);
+      }
+      const endpoints = s.matched_endpoints;
+      if (endpoints && endpoints.length > 0) {
+        lines[0] += ` \xB7 ${endpoints.length} matched`;
+        for (const ep of endpoints) {
+          endpointCount++;
+          const method = (ep.method ?? "").padEnd(6);
+          const desc = ep.description ? `  -- ${ep.description}` : "";
+          lines.push(`    ${method} ${ep.path}${desc}`);
+        }
+      }
+      return lines.join("\n");
+    });
+    const output2 = blocks.join("\n\n");
+    if (domainCount > 0 || endpointCount > 0) {
+      const parts = [];
+      if (domainCount > 0) parts.push(`${domainCount} service${domainCount === 1 ? "" : "s"}`);
+      if (endpointCount > 0) parts.push(`${endpointCount} endpoint${endpointCount === 1 ? "" : "s"}`);
+      return `${output2}
+
+-- ${parts.join(", ")} matched`;
+    }
+    return output2;
+  }
+  if (isEndpointResults(payload)) {
+    if (payload.length === 0) return "(no matches)";
+    return payload.map((ep) => {
+      const method = (ep.method ?? "").padEnd(6);
+      const desc = ep.description ? `  -- ${ep.description}` : "";
+      return `${method} ${ep.path}${desc}`;
+    }).join("\n");
+  }
+  return JSON.stringify(payload);
+}
+function formatCat(result) {
+  const payload = extractPayload(result);
+  if (typeof payload === "string") return payload;
+  return JSON.stringify(payload);
+}
+function formatMutate(result, verb, path) {
+  const payload = extractPayload(result);
+  if (payload === null || payload === void 0) {
+    return `${verb}: ${path}`;
+  }
+  if (typeof payload === "object" && Object.keys(payload).length === 0) {
+    return `${verb}: ${path}`;
+  }
+  return `${verb}: ${path}
+${JSON.stringify(payload)}`;
+}
+function formatJson(result) {
+  return JSON.stringify(result);
+}
+var init_format = __esm({
+  "src/format.ts"() {
   }
 });
 
@@ -680,8 +656,8 @@ var fs_exports = {};
 __export(fs_exports, {
   registerFsCommands: () => registerFsCommands
 });
-function output(result) {
-  console.log(JSON.stringify(result, null, 2));
+function output(result, jsonMode) {
+  console.log(jsonMode ? formatJson(result) : formatCat(result));
 }
 function extractDomain(path) {
   const cleaned = path.replace(/^\/+/, "");
@@ -719,33 +695,40 @@ function handleError(err, cmdPath) {
       process.exit(1);
     }
   }
-  console.error(JSON.stringify({ error: message }));
+  console.error(message);
   process.exit(1);
 }
 function registerFsCommands(program2) {
-  program2.command("ls").description("List directory contents in the DirX path space").argument("<path>", "Directory path (e.g. /net/)").action(async (path) => {
+  program2.command("ls").description("List directory contents in the DirX path space").argument("[path]", "Directory path (e.g. /net/)", "/").action(async (path) => {
     try {
+      let normalizedPath = path.trim();
+      if (normalizedPath.length > 1 && normalizedPath.endsWith("/")) {
+        normalizedPath = normalizedPath.replace(/\/+$/, "");
+      }
+      const jsonMode = program2.opts().json === true;
       const client = await createClient();
-      const result = await client.execute(`ls ${path}`);
-      output(result);
+      const result = await client.execute(`ls ${normalizedPath}`);
+      console.log(jsonMode ? formatJson(result) : formatLs(result));
     } catch (err) {
       handleError(err, path);
     }
   });
   program2.command("cat").description("Read file contents from a DirX path").argument("<path>", "File path").action(async (path) => {
     try {
+      const jsonMode = program2.opts().json === true;
       const client = await createClient();
       const result = await client.execute(`cat ${path}`);
-      output(result);
+      output(result, jsonMode);
     } catch (err) {
       handleError(err, path);
     }
   });
   program2.command("read").description("Read file contents (alias for cat)").argument("<path>", "File path").action(async (path) => {
     try {
+      const jsonMode = program2.opts().json === true;
       const client = await createClient();
       const result = await client.execute(`cat ${path}`);
-      output(result);
+      output(result, jsonMode);
     } catch (err) {
       handleError(err, path);
     }
@@ -755,12 +738,13 @@ function registerFsCommands(program2) {
       try {
         let payload = opts.data ?? "";
         if (opts.file) {
-          const { readFileSync: readFileSync4 } = await import('fs');
-          payload = readFileSync4(opts.file, "utf-8");
+          const { readFileSync: readFileSync3 } = await import('fs');
+          payload = readFileSync3(opts.file, "utf-8");
         }
+        const jsonMode = program2.opts().json === true;
         const client = await createClient();
         const result = await client.execute(`write ${path} ${payload}`);
-        output(result);
+        console.log(jsonMode ? formatJson(result) : formatMutate(result, "Created", path));
       } catch (err) {
         handleError(err, path);
       }
@@ -771,12 +755,13 @@ function registerFsCommands(program2) {
       try {
         let payload = opts.data ?? "";
         if (opts.file) {
-          const { readFileSync: readFileSync4 } = await import('fs');
-          payload = readFileSync4(opts.file, "utf-8");
+          const { readFileSync: readFileSync3 } = await import('fs');
+          payload = readFileSync3(opts.file, "utf-8");
         }
+        const jsonMode = program2.opts().json === true;
         const client = await createClient();
         const result = await client.execute(`edit ${path} ${payload}`);
-        output(result);
+        console.log(jsonMode ? formatJson(result) : formatMutate(result, "Updated", path));
       } catch (err) {
         handleError(err, path);
       }
@@ -784,27 +769,30 @@ function registerFsCommands(program2) {
   );
   program2.command("rm").description("Remove a resource at a DirX path").argument("<path>", "Resource path").action(async (path) => {
     try {
+      const jsonMode = program2.opts().json === true;
       const client = await createClient();
       const result = await client.execute(`rm ${path}`);
-      output(result);
+      console.log(jsonMode ? formatJson(result) : formatMutate(result, "Removed", path));
     } catch (err) {
       handleError(err, path);
     }
   });
   program2.command("bash").description("Execute a multi-step pipeline on the gateway").argument("<pipeline>", "Pipeline expression").action(async (pipeline) => {
     try {
+      const jsonMode = program2.opts().json === true;
       const client = await createClient();
       const result = await client.execute(`bash ${pipeline}`);
-      output(result);
+      output(result, jsonMode);
     } catch (err) {
       handleError(err);
     }
   });
-  program2.command("grep").description("Search across services in the DirX path space").argument("<pattern>", "Search pattern").argument("<path>", "Search scope path").action(async (pattern, path) => {
+  program2.command("grep").description("Search across services in the DirX path space").argument("<pattern>", "Search pattern").argument("[path]", "Search scope path", "/").action(async (pattern, path) => {
     try {
+      const jsonMode = program2.opts().json === true;
       const client = await createClient();
       const result = await client.execute(`grep ${pattern} ${path}`);
-      output(result);
+      console.log(jsonMode ? formatJson(result) : formatGrep(result));
     } catch (err) {
       handleError(err, path);
     }
@@ -813,7 +801,7 @@ function registerFsCommands(program2) {
 var init_fs = __esm({
   "src/commands/fs.ts"() {
     init_client();
-    init_provider_map();
+    init_format();
   }
 });
 
@@ -823,13 +811,13 @@ __export(keys_exports, {
   registerKeysCommand: () => registerKeysCommand
 });
 async function loadKeyStore() {
-  const { readFileSync: readFileSync4 } = await import('fs');
+  const { readFileSync: readFileSync3 } = await import('fs');
   const { join: join5 } = await import('path');
   const { homedir: homedir2 } = await import('os');
   const dirxHome = process.env.DIRX_HOME ?? join5(homedir2(), ".dirx");
   const filePath = join5(dirxHome, "keys.json");
   try {
-    const text = readFileSync4(filePath, "utf-8");
+    const text = readFileSync3(filePath, "utf-8");
     return JSON.parse(text);
   } catch {
     return { keys: {} };
@@ -880,7 +868,7 @@ function registerKeysCommand(program2) {
       try {
         const client = await createClient();
         const result = await client.listByok();
-        console.log(JSON.stringify(result, null, 2));
+        console.log(JSON.stringify(result));
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         console.error(`Error: ${msg}`);
@@ -936,7 +924,7 @@ try {
 } catch {
 }
 var program = new Command();
-program.name("dirx").description("DirX \u2014 Unified Gateway & CLI for Agents").version(version);
+program.name("dirx").description("DirX \u2014 Unified Gateway & CLI for Agents").version(version).option("--json", "Output raw JSON instead of human-readable text");
 program.command("auth").description("Authenticate with the DirX gateway").option("--gateway-url <url>", "Gateway URL (default: https://api.dirx.ai)").action(async (opts) => {
   const { runAuth: runAuth2 } = await Promise.resolve().then(() => (init_auth(), auth_exports));
   await runAuth2({ gatewayUrl: opts.gatewayUrl });
@@ -982,4 +970,8 @@ var { registerFsCommands: registerFsCommands2 } = await Promise.resolve().then((
 registerFsCommands2(program);
 var { registerKeysCommand: registerKeysCommand2 } = await Promise.resolve().then(() => (init_keys(), keys_exports));
 registerKeysCommand2(program);
+if (process.argv.length <= 2) {
+  program.outputHelp();
+  process.exit(0);
+}
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dirxai/cli",
-    "version": "0.2.1",
+    "version": "0.3.1",
     "description": "DirX — Unified Gateway & CLI for Agents",
     "license": "MIT",
     "type": "module",
@@ -9,22 +9,16 @@
     },
     "scripts": {
         "build": "tsup",
-        "dev": "tsup --watch",
-        "lint": "tsc --noEmit",
-        "test": "vitest run"
+        "dev": "tsup --watch"
     },
     "dependencies": {
+        "@dirxai/core": "^0.3.1",
         "commander": "^13.0.0"
     },
-    "devDependencies": {
-        "@types/node": "^22.0.0",
-        "tsup": "^8.0.0",
-        "typescript": "^5.7.0",
-        "vitest": "^4.0.0"
-    },
     "repository": {
         "type": "git",
-        "url": "https://github.com/dirxai/dirx.git"
+        "url": "https://github.com/dirxai/dirx.git",
+        "directory": "packages/cli"
     },
     "homepage": "https://dirx.ai",
     "keywords": [

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 DirX AI
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,91 +0,0 @@
-# DirX — Unified Gateway & CLI for Agents
-
-[![npm version](https://img.shields.io/npm/v/@dirxai/cli.svg)](https://www.npmjs.com/package/@dirxai/cli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-DirX gives AI agents a unified, file-system-like interface to discover and interact with internet APIs — with built-in governance, access control, and auditing.
-
-## Install
-
-```bash
-npm install -g @dirxai/cli
-```
-
-## Quick Start
-
-```bash
-# Authenticate with the gateway
-dirx auth
-
-# Browse the API directory
-dirx ls /
-dirx ls /net/
-
-# Read service descriptions
-dirx cat /net/api.github.com/DIR.md
-
-# Search across services
-dirx grep "weather" /net/
-
-# Write data
-dirx write /net/api.example.com/data -d '{"key": "value"}'
-
-# Manage API keys (BYOK)
-dirx keys set api.github.com --token ghp_xxxx --sync
-```
-
-## Commands
-
-### Agent Commands
-
-| Command | Description |
-|---------|-------------|
-| `dirx ls <path>` | List directory contents |
-| `dirx cat <path>` | Read file contents |
-| `dirx write <path>` | Write data |
-| `dirx edit <path>` | Partial update |
-| `dirx rm <path>` | Remove a resource |
-| `dirx grep <pattern> <path>` | Search across services |
-| `dirx bash <pipeline>` | Execute multi-step pipeline |
-
-### Developer Tools
-
-| Command | Description |
-|---------|-------------|
-| `dirx init [dir]` | Initialize DirX in a project |
-| `dirx generate [dir]` | Scan and detect route definitions |
-| `dirx generate --register` | Scan and auto-register with the gateway |
-| `dirx claim <domain>` | Claim domain via DNS verification |
-| `dirx register` | Register DIR.md with the gateway |
-
-### Configuration
-
-| Command | Description |
-|---------|-------------|
-| `dirx auth` | Authenticate with the gateway |
-| `dirx keys set <domain>` | Set an API key |
-| `dirx keys list` | List stored keys |
-| `dirx keys remove <domain>` | Remove a key |
-| `dirx status` | Show CLI config and auth status |
-
-## Environment Variables
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `DIRX_GATEWAY_URL` | Gateway URL | `https://api.dirx.ai` |
-| `DIRX_TOKEN` | Agent token | — |
-| `DIRX_HOME` | Config directory | `~/.dirx` |
-
-## Development
-
-```bash
-git clone https://github.com/dirxai/dirx.git
-cd dirx
-npm install
-npm run build
-npm run lint
-```
-
-## License
-
-MIT