@desplega.ai/agent-fs 0.1.2

package/dist/formatters.js

@@ -0,0 +1,257 @@
+/**
+ * Pretty-print formatters for CLI output.
+ * Each op has a formatter that takes the result object and returns a human-friendly string.
+ * MCP always returns JSON — these formatters are CLI-only.
+ */
+// --- Helpers ---
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+function formatDate(d) {
+    if (!d)
+        return "-";
+    const date = typeof d === "string" ? new Date(d) : d;
+    if (isNaN(date.getTime()))
+        return String(d);
+    return date.toISOString().replace("T", " ").replace(/\.\d{3}Z$/, "Z");
+}
+function padRight(s, len) {
+    return s.length >= len ? s : s + " ".repeat(len - s.length);
+}
+function padLeft(s, len) {
+    return s.length >= len ? s : " ".repeat(len - s.length) + s;
+}
+// --- Per-op formatters ---
+function formatLs(result) {
+    const entries = result.entries ?? [];
+    if (entries.length === 0)
+        return "(empty directory)";
+    // Compute column widths
+    const nameW = Math.max(4, ...entries.map((e) => String(e.name).length));
+    const typeW = Math.max(4, ...entries.map((e) => String(e.type).length));
+    const sizeW = Math.max(4, ...entries.map((e) => formatSize(e.size ?? 0).length));
+    const header = padRight("NAME", nameW) +
+        "  " +
+        padRight("TYPE", typeW) +
+        "  " +
+        padLeft("SIZE", sizeW) +
+        "  " +
+        "MODIFIED";
+    const lines = entries.map((e) => padRight(e.name, nameW) +
+        "  " +
+        padRight(e.type, typeW) +
+        "  " +
+        padLeft(formatSize(e.size ?? 0), sizeW) +
+        "  " +
+        formatDate(e.modifiedAt));
+    return [header, ...lines].join("\n");
+}
+function formatCat(result) {
+    const content = result.content ?? "";
+    const lines = content.split("\n");
+    // Remove trailing empty line from split if content ends with newline
+    if (lines.length > 0 && lines[lines.length - 1] === "") {
+        lines.pop();
+    }
+    const offset = result.offset ?? 1;
+    const width = String(offset + lines.length - 1).length;
+    return lines
+        .map((line, i) => `${padLeft(String(offset + i), width)}  ${line}`)
+        .join("\n");
+}
+function formatStat(result) {
+    const pairs = [
+        ["Path", result.path ?? "-"],
+        ["Size", formatSize(result.size ?? 0)],
+        ["Content-Type", result.contentType ?? "-"],
+        ["Author", result.author ?? "-"],
+        ["Version", result.currentVersion != null ? String(result.currentVersion) : "-"],
+        ["Created", formatDate(result.createdAt)],
+        ["Modified", formatDate(result.modifiedAt)],
+        ["Deleted", result.isDeleted ? "yes" : "no"],
+    ];
+    if (result.embeddingStatus) {
+        pairs.push(["Embedding", result.embeddingStatus]);
+    }
+    const labelW = Math.max(...pairs.map(([k]) => k.length));
+    return pairs.map(([k, v]) => `${padRight(k + ":", labelW + 1)}  ${v}`).join("\n");
+}
+function formatLog(result) {
+    const versions = result.versions ?? [];
+    if (versions.length === 0)
+        return "(no version history)";
+    return versions
+        .map((v) => {
+        const parts = [`v${v.version}  ${formatDate(v.createdAt)}  ${v.author ?? "-"}  [${v.operation}]`];
+        if (v.message)
+            parts.push(`  ${v.message}`);
+        if (v.diffSummary)
+            parts.push(`  ${v.diffSummary}`);
+        return parts.join("\n");
+    })
+        .join("\n\n");
+}
+function formatWrite(result) {
+    return `\u2713 wrote ${result.path} (v${result.version}, ${formatSize(result.size ?? 0)})`;
+}
+function formatEdit(result) {
+    return `\u2713 edited ${result.path} (v${result.version}, ${result.changes} change${result.changes !== 1 ? "s" : ""})`;
+}
+function formatAppend(result) {
+    return `\u2713 appended (v${result.version}, ${formatSize(result.size ?? 0)})`;
+}
+function formatRm(result) {
+    return result.deleted
+        ? `\u2713 deleted ${result.path}`
+        : `(not found: ${result.path})`;
+}
+function formatMv(result) {
+    return `\u2713 moved ${result.from} -> ${result.to} (v${result.version})`;
+}
+function formatCp(result) {
+    return `\u2713 copied ${result.from} -> ${result.to} (v${result.version})`;
+}
+function formatTree(result) {
+    const tree = result.tree ?? [];
+    if (tree.length === 0)
+        return "(empty)";
+    const lines = [];
+    function walk(entries, prefix) {
+        for (let i = 0; i < entries.length; i++) {
+            const entry = entries[i];
+            const isLast = i === entries.length - 1;
+            const connector = isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
+            const suffix = entry.type === "directory" ? "/" : "";
+            lines.push(`${prefix}${connector}${entry.name}${suffix}`);
+            if (entry.children && entry.children.length > 0) {
+                const childPrefix = prefix + (isLast ? "    " : "\u2502   ");
+                walk(entry.children, childPrefix);
+            }
+        }
+    }
+    walk(tree, "");
+    return lines.join("\n");
+}
+function formatGrep(result) {
+    const matches = result.matches ?? [];
+    if (matches.length === 0)
+        return "(no matches)";
+    return matches
+        .map((m) => `${m.path}:${m.lineNumber}: ${m.content}`)
+        .join("\n");
+}
+function formatFts(result) {
+    const matches = result.matches ?? [];
+    if (matches.length === 0) {
+        return result.hint ? `(no matches) ${result.hint}` : "(no matches)";
+    }
+    const lines = matches.map((m) => `${m.path} (rank: ${typeof m.rank === "number" ? m.rank.toFixed(2) : m.rank})\n  ${m.snippet}`);
+    if (result.hint)
+        lines.push(`\nhint: ${result.hint}`);
+    return lines.join("\n\n");
+}
+function formatSearch(result) {
+    const results = result.results ?? [];
+    if (results.length === 0)
+        return "(no results)";
+    return results
+        .map((r) => `${r.path} (score: ${typeof r.score === "number" ? r.score.toFixed(3) : r.score})` +
+        (r.author ? `  by ${r.author}` : "") +
+        `\n  ${r.snippet}`)
+        .join("\n\n");
+}
+function formatGlob(result) {
+    const matches = result.matches ?? [];
+    if (matches.length === 0)
+        return "(no matches)";
+    return matches
+        .map((m) => `${m.path}  ${formatSize(m.size ?? 0)}  ${formatDate(m.modifiedAt)}`)
+        .join("\n");
+}
+function formatDiff(result) {
+    const changes = result.changes ?? [];
+    if (changes.length === 0)
+        return "(no changes)";
+    return changes
+        .map((c) => {
+        const prefix = c.type === "add" ? "+" : c.type === "remove" ? "-" : " ";
+        const lineNum = c.lineNumber != null ? `${c.lineNumber}: ` : "";
+        return `${prefix} ${lineNum}${c.content}`;
+    })
+        .join("\n");
+}
+function formatTail(result) {
+    // tail returns CatResult, same format as cat
+    return formatCat(result);
+}
+function formatRevert(result) {
+    return `\u2713 reverted to v${result.revertedTo} (new version: v${result.version})`;
+}
+function formatRecent(result) {
+    const entries = result.entries ?? [];
+    if (entries.length === 0)
+        return "(no recent activity)";
+    return entries
+        .map((e) => `${e.path}  v${e.version}  ${formatDate(e.createdAt)}  ${e.author ?? "-"}  [${e.operation}]` +
+        (e.message ? `\n  ${e.message}` : ""))
+        .join("\n\n");
+}
+function formatReindex(result) {
+    const parts = [];
+    parts.push(`reindexed: ${result.reindexed ?? 0}`);
+    if (result.failed)
+        parts.push(`failed: ${result.failed}`);
+    if (result.skipped)
+        parts.push(`skipped: ${result.skipped}`);
+    return parts.join(", ");
+}
+// --- Formatter registry ---
+const formatters = {
+    ls: formatLs,
+    cat: formatCat,
+    stat: formatStat,
+    log: formatLog,
+    write: formatWrite,
+    edit: formatEdit,
+    append: formatAppend,
+    rm: formatRm,
+    mv: formatMv,
+    cp: formatCp,
+    tree: formatTree,
+    grep: formatGrep,
+    fts: formatFts,
+    search: formatSearch,
+    glob: formatGlob,
+    diff: formatDiff,
+    tail: formatTail,
+    revert: formatRevert,
+    recent: formatRecent,
+    reindex: formatReindex,
+};
+function formatResult(opName, result) {
+    const formatter = formatters[opName];
+    if (formatter) {
+        return formatter(result);
+    }
+    // Fallback: JSON for unknown ops
+    return JSON.stringify(result, null, 2);
+}
+/**
+ * Single entry point for all CLI output.
+ * If json is true, outputs raw JSON. Otherwise, uses the pretty-print formatter.
+ */
+export function outputResult(opName, result, json) {
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        console.log(formatResult(opName, result));
+    }
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env bun
+import { Command } from "commander";
+import { getConfig, listUserOrgs, getUserByApiKey, VERSION } from "@/core";
+import { ApiClient } from "./api-client.js";
+import { registerOpCommands } from "./commands/ops.js";
+import { authCommands } from "./commands/auth.js";
+import { daemonCommands } from "./commands/daemon.js";
+import { configCommands } from "./commands/config-cmd.js";
+import { driveCommands } from "./commands/drive.js";
+import { initCommand } from "./commands/init.js";
+import { onboardCommand } from "./commands/onboard.js";
+import { commentCommands } from "./commands/comment.js";
+import { docsCommand } from "./commands/docs.js";
+const program = new Command();
+program
+    .name("agent-fs")
+    .description("Agent-first filesystem backed by S3")
+    .version(VERSION)
+    .option("--org <orgId>", "Override org context")
+    .option("--drive <driveId>", "Override drive context")
+    .option("--json", "Output raw JSON");
+const client = new ApiClient();
+// Resolve the default org ID
+function getOrgId() {
+    const orgId = program.opts().org;
+    if (orgId)
+        return orgId;
+    // Try to resolve from config
+    const config = getConfig();
+    if (config.auth.apiKey) {
+        try {
+            const { createDatabase } = require("@/core");
+            const db = createDatabase();
+            const user = getUserByApiKey(db, config.auth.apiKey);
+            if (user) {
+                const orgs = listUserOrgs(db, user.id);
+                if (orgs.length > 0)
+                    return orgs[0].id;
+            }
+        }
+        catch {
+            // If DB isn't available, let the server handle it
+        }
+    }
+    console.error("Error: No org context. Use --org or run 'agent-fs auth register'");
+    process.exit(1);
+}
+// Register commands — docs first so it appears at top of --help
+program.addCommand(docsCommand());
+registerOpCommands(program, client, getOrgId);
+program.addCommand(authCommands(client));
+program.addCommand(daemonCommands());
+program.addCommand(configCommands());
+program.addCommand(driveCommands(client));
+program.addCommand(initCommand());
+program.addCommand(onboardCommand());
+program.addCommand(commentCommands(client, getOrgId));
+// MCP command
+program
+    .command("mcp")
+    .description("Start MCP server (stdio)")
+    .action(async () => {
+    await import("@/mcp/index.js");
+});
+// Server command (foreground dev mode)
+program
+    .command("server")
+    .description("Run server in foreground (dev mode)")
+    .action(async () => {
+    await import("@/server/index.js");
+});
+// Show global options in subcommand help
+const globalHelp = `
+Global Options:
+  --org <orgId>    Override org context
+  --drive <driveId>  Override drive context
+  --json           Output raw JSON
+`;
+for (const cmd of program.commands) {
+    cmd.addHelpText("after", globalHelp);
+}
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@desplega.ai/agent-fs",
+  "version": "0.1.2",
+  "type": "module",
+  "description": "Agent-first filesystem backed by S3",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/desplega-ai/agent-fs"
+  },
+  "keywords": ["agent", "filesystem", "s3", "mcp", "cli"],
+  "engines": {
+    "bun": ">=1.2.0"
+  },
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "bin": {
+    "agent-fs": "src/index.ts"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build:npm": "bun build src/index.ts --outfile dist/cli.js --target bun --packages external --minify",
+    "prepublishOnly": "bun run build:npm"
+  },
+  "dependencies": {
+    "@desplega.ai/agent-fs-core": "0.1.0",
+    "@desplega.ai/agent-fs-server": "0.1.0",
+    "@desplega.ai/agent-fs-mcp": "0.1.0",
+    "commander": "^14.0.3",
+    "@aws-sdk/client-s3": "^3.750.0",
+    "@google/genai": "^1.45.0",
+    "chonkie": "^0.3.0",
+    "diff": "^8.0.3",
+    "drizzle-orm": "^0.44.0",
+    "node-llama-cpp": "^3.17.1",
+    "openai": "^6.29.0",
+    "sqlite-vec": "^0.1.6",
+    "zod": "^3.24.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "hono": "^4.12.8"
+  }
+}

package/src/index.ts

@@ -0,0 +1,90 @@
+#!/usr/bin/env bun
+import { Command } from "commander";
+import { getConfig, listUserOrgs, getUserByApiKey, VERSION } from "@/core";
+import { ApiClient } from "./api-client.js";
+import { registerOpCommands } from "./commands/ops.js";
+import { authCommands } from "./commands/auth.js";
+import { daemonCommands } from "./commands/daemon.js";
+import { configCommands } from "./commands/config-cmd.js";
+import { driveCommands } from "./commands/drive.js";
+import { initCommand } from "./commands/init.js";
+import { onboardCommand } from "./commands/onboard.js";
+import { commentCommands } from "./commands/comment.js";
+import { docsCommand } from "./commands/docs.js";
+
+const program = new Command();
+
+program
+  .name("agent-fs")
+  .description("Agent-first filesystem backed by S3")
+  .version(VERSION)
+  .option("--org <orgId>", "Override org context")
+  .option("--drive <driveId>", "Override drive context")
+  .option("--json", "Output raw JSON");
+
+const client = new ApiClient();
+
+// Resolve the default org ID
+function getOrgId(): string {
+  const orgId = program.opts().org;
+  if (orgId) return orgId;
+
+  // Try to resolve from config
+  const config = getConfig();
+  if (config.auth.apiKey) {
+    try {
+      const { createDatabase } = require("@/core");
+      const db = createDatabase();
+      const user = getUserByApiKey(db, config.auth.apiKey);
+      if (user) {
+        const orgs = listUserOrgs(db, user.id);
+        if (orgs.length > 0) return orgs[0].id;
+      }
+    } catch {
+      // If DB isn't available, let the server handle it
+    }
+  }
+
+  console.error("Error: No org context. Use --org or run 'agent-fs auth register'");
+  process.exit(1);
+}
+
+// Register commands — docs first so it appears at top of --help
+program.addCommand(docsCommand());
+registerOpCommands(program, client, getOrgId);
+program.addCommand(authCommands(client));
+program.addCommand(daemonCommands());
+program.addCommand(configCommands());
+program.addCommand(driveCommands(client));
+program.addCommand(initCommand());
+program.addCommand(onboardCommand());
+program.addCommand(commentCommands(client, getOrgId));
+
+// MCP command
+program
+  .command("mcp")
+  .description("Start MCP server (stdio)")
+  .action(async () => {
+    await import("@/mcp/index.js");
+  });
+
+// Server command (foreground dev mode)
+program
+  .command("server")
+  .description("Run server in foreground (dev mode)")
+  .action(async () => {
+    await import("@/server/index.js");
+  });
+
+// Show global options in subcommand help
+const globalHelp = `
+Global Options:
+  --org <orgId>    Override org context
+  --drive <driveId>  Override drive context
+  --json           Output raw JSON
+`;
+for (const cmd of program.commands) {
+  cmd.addHelpText("after", globalHelp);
+}
+
+program.parse();