@b3os/cli 0.0.0-stage → 0.0.1

package/dist/ctx.js

@@ -0,0 +1,271 @@
+// Shared CLI plumbing: flags, the SDK client, output in human or --json form, confirmations that never prompt
+// without a TTY, and the stable exit codes.
+import { createInterface } from "node:readline/promises";
+import { parseArgs } from "node:util";
+import { B3OS, B3OSError, DEFAULT_BASE_URL } from "@b3os/sdk";
+import { loadCredentials } from "./config.js";
+/** Exit codes. Stable: scripts may rely on them (documented in packages/cli/README.md). */
+export const EXIT = {
+    OK: 0,
+    ERROR: 1,
+    USAGE: 2,
+    AUTH: 3,
+    NOT_FOUND: 4,
+    INVALID: 5,
+    LIMITED: 6,
+    SERVER: 7,
+    TIMEOUT: 8,
+    CONNECTION: 9,
+    FAILED: 10,
+    INTERRUPTED: 130,
+};
+export class UsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UsageError";
+    }
+}
+/** Options every command takes. */
+export const GLOBAL_OPTIONS = {
+    json: { type: "boolean" },
+    yes: { type: "boolean", short: "y" },
+    quiet: { type: "boolean", short: "q" },
+    help: { type: "boolean", short: "h" },
+    "api-key": { type: "string" },
+    "base-url": { type: "string" },
+    timeout: { type: "string" },
+};
+export function parse(argv, options = {}) {
+    try {
+        const r = parseArgs({
+            args: argv,
+            options: { ...GLOBAL_OPTIONS, ...options },
+            allowPositionals: true,
+            strict: true,
+        });
+        return { values: r.values, positionals: r.positionals };
+    }
+    catch (e) {
+        throw new UsageError(e.message);
+    }
+}
+export class Ctx {
+    json = false;
+    yes = false;
+    quiet = false;
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    cached;
+    io;
+    /** Extra client options (tests). */
+    clientOptions = {};
+    constructor(io) {
+        this.io = io;
+    }
+    applyGlobals(v) {
+        if (v.json)
+            this.json = true;
+        if (v.yes)
+            this.yes = true;
+        if (v.quiet)
+            this.quiet = true;
+        if (typeof v["api-key"] === "string")
+            this.apiKey = v["api-key"];
+        if (typeof v["base-url"] === "string")
+            this.baseUrl = v["base-url"];
+        if (typeof v.timeout === "string") {
+            const ms = Number(v.timeout);
+            if (!Number.isFinite(ms) || ms <= 0)
+                throw new UsageError("--timeout takes milliseconds");
+            this.timeoutMs = ms;
+        }
+    }
+    get isTTY() {
+        return !!this.io.stdin.isTTY && !!this.io.stdout.isTTY;
+    }
+    /** The API key in effect: --api-key, B3OS_API_KEY, then the stored login. */
+    credential() {
+        const stored = loadCredentials();
+        const baseUrl = this.baseUrl ?? process.env.B3OS_BASE_URL ?? stored?.base_url ?? DEFAULT_BASE_URL;
+        if (this.apiKey)
+            return { key: this.apiKey, source: "--api-key", baseUrl };
+        if (process.env.B3OS_API_KEY)
+            return { key: process.env.B3OS_API_KEY, source: "B3OS_API_KEY", baseUrl };
+        if (stored)
+            return { key: stored.token, source: "b3os login", baseUrl };
+        return { key: null, source: "none", baseUrl };
+    }
+    /**
+     * The base URL the user chose (--base-url, B3OS_BASE_URL, or a stored login's non-default host), else undefined.
+     * Only a chosen one is passed to the SDK: a base URL turns off its default-socket detection on a node.
+     */
+    configuredBaseUrl() {
+        if (this.baseUrl)
+            return this.baseUrl;
+        if (process.env.B3OS_BASE_URL)
+            return process.env.B3OS_BASE_URL;
+        const stored = loadCredentials()?.base_url;
+        return stored && stored.replace(/\/+$/, "") !== DEFAULT_BASE_URL ? stored : undefined;
+    }
+    client() {
+        if (!this.cached) {
+            const c = this.credential();
+            const baseUrl = this.configuredBaseUrl();
+            this.cached = new B3OS({
+                apiKey: c.key,
+                ...(baseUrl ? { baseUrl } : {}),
+                timeoutMs: this.timeoutMs,
+                ...this.clientOptions,
+            });
+        }
+        return this.cached;
+    }
+    out(s) {
+        this.io.stdout.write(s.endsWith("\n") ? s : `${s}\n`);
+    }
+    /** Progress and notes go to stderr so stdout stays data. Silent with --quiet or --json. */
+    info(s) {
+        if (!this.quiet && !this.json)
+            this.io.stderr.write(s.endsWith("\n") ? s : `${s}\n`);
+    }
+    warn(s) {
+        if (!this.quiet)
+            this.io.stderr.write(s.endsWith("\n") ? s : `${s}\n`);
+    }
+    printJson(v) {
+        this.io.stdout.write(`${JSON.stringify(v, null, 2)}\n`);
+    }
+    /** One JSON document per line (streams with --json). */
+    printJsonLine(v) {
+        this.io.stdout.write(`${JSON.stringify(v)}\n`);
+    }
+    /** --json prints `data`; otherwise `human()` decides. */
+    result(data, human) {
+        if (this.json)
+            this.printJson(data);
+        else
+            human();
+    }
+    table(rows, columns) {
+        if (rows.length === 0) {
+            this.info("(none)");
+            return;
+        }
+        const cell = (v) => v === null || v === undefined ? "-" : typeof v === "object" ? JSON.stringify(v) : String(v);
+        const widths = columns.map((c) => Math.max(c.length, ...rows.map((r) => cell(r[c]).length)));
+        const line = (vals) => vals
+            .map((v, i) => (i === vals.length - 1 ? v : v.padEnd(widths[i] ?? 0)))
+            .join("  ")
+            .trimEnd();
+        this.out(line(columns.map((c) => c.toUpperCase())));
+        for (const r of rows)
+            this.out(line(columns.map((c) => cell(r[c]))));
+    }
+    /** Asks before a destructive action. Never prompts without a TTY: then --yes is required. */
+    async confirm(question) {
+        if (this.yes)
+            return true;
+        if (!this.isTTY)
+            throw new UsageError(`${question} Refusing without a terminal; pass --yes to confirm.`);
+        const rl = createInterface({ input: this.io.stdin, output: process.stderr });
+        try {
+            const a = (await rl.question(`${question} [y/N] `)).trim().toLowerCase();
+            return a === "y" || a === "yes";
+        }
+        finally {
+            rl.close();
+        }
+    }
+}
+export function exitCodeFor(e) {
+    if (e instanceof UsageError)
+        return EXIT.USAGE;
+    if (!(e instanceof B3OSError))
+        return EXIT.ERROR;
+    if (e.name === "B3OSJobError")
+        return EXIT.FAILED;
+    switch (e.code) {
+        case "timeout":
+            return EXIT.TIMEOUT;
+        case "connection_error":
+            return EXIT.CONNECTION;
+        case "aborted":
+            return EXIT.INTERRUPTED;
+        default:
+            break;
+    }
+    const s = e.status ?? 0;
+    if (s === 401 || s === 403)
+        return EXIT.AUTH;
+    if (s === 404)
+        return EXIT.NOT_FOUND;
+    if (s === 402 || s === 429)
+        return EXIT.LIMITED;
+    if (s === 504)
+        return EXIT.TIMEOUT;
+    if (s >= 500)
+        return EXIT.SERVER;
+    if (s >= 400)
+        return EXIT.INVALID;
+    return EXIT.ERROR;
+}
+/** The error as printed: one readable line (plus validation items), or a JSON object with --json. */
+export function renderError(e, json) {
+    if (e instanceof B3OSError) {
+        if (json) {
+            return JSON.stringify({
+                error: {
+                    code: e.code,
+                    status: e.status,
+                    title: e.title,
+                    detail: e.detail,
+                    type: e.type,
+                    request_id: e.requestId,
+                    errors: e.errors.length ? e.errors : undefined,
+                    job: e.job,
+                },
+            });
+        }
+        const lines = [`error: ${e.message}`];
+        for (const it of e.errors)
+            lines.push(`  ${it.pointer}: ${it.detail}`);
+        return lines.join("\n");
+    }
+    if (json)
+        return JSON.stringify({
+            error: { code: e instanceof UsageError ? "usage" : "error", detail: String(e?.message ?? e) },
+        });
+    return `error: ${e?.message ?? String(e)}`;
+}
+/** Reads `k=v` pairs (`--env A=1`). */
+export function pairs(list, flag) {
+    const out = {};
+    for (const item of Array.isArray(list) ? list : list === undefined ? [] : [list]) {
+        const s = String(item);
+        const eq = s.indexOf("=");
+        if (eq <= 0)
+            throw new UsageError(`${flag} takes KEY=VALUE, got "${s}"`);
+        out[s.slice(0, eq)] = s.slice(eq + 1);
+    }
+    return out;
+}
+export function intFlag(v, flag) {
+    if (v === undefined)
+        return undefined;
+    const n = Number(v);
+    if (!Number.isInteger(n))
+        throw new UsageError(`${flag} takes an integer, got "${String(v)}"`);
+    return n;
+}
+export function jsonFlag(v, flag) {
+    if (v === undefined)
+        return undefined;
+    try {
+        return JSON.parse(String(v));
+    }
+    catch (e) {
+        throw new UsageError(`${flag} is not valid JSON: ${e.message}`);
+    }
+}
+//# sourceMappingURL=ctx.js.map

package/dist/ctx.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+import { type Streams } from "./ctx.ts";
+export declare const CLI_VERSION = "0.0.1";
+export declare function run(argv: string[], io?: Streams): Promise<number>;

package/dist/main.js

@@ -0,0 +1,86 @@
+// b3os: the B3OS command line. Every command takes --json (machine-readable stdout), --yes (no confirmations),
+// --quiet, --api-key, --base-url and --timeout MS. Without a TTY it never prompts. Exit codes: ctx.ts EXIT.
+import { SDK_VERSION } from "@b3os/sdk";
+import { api } from "./commands/api.js";
+import { login, logout, whoami } from "./commands/auth.js";
+import { bench } from "./commands/bench.js";
+import { keys } from "./commands/keys.js";
+import { mcp } from "./commands/mcp.js";
+import { action, routine } from "./commands/routine.js";
+import { sandbox } from "./commands/sandbox.js";
+import { scrape, screenshot, video } from "./commands/web.js";
+import { Ctx, EXIT, exitCodeFor, renderError, UsageError } from "./ctx.js";
+export const CLI_VERSION = "0.0.1";
+const COMMANDS = {
+    login: { run: login, summary: "Sign in with the device flow and store a CLI token" },
+    logout: { run: logout, summary: "Remove the stored CLI token" },
+    whoami: { run: whoami, summary: "Show the credential in use, its org, project and scopes" },
+    keys: { run: keys, summary: "List, create, update and revoke API keys" },
+    scrape: { run: scrape, summary: "Read a page as Markdown (or HTML, text, links, JSON)" },
+    screenshot: { run: screenshot, summary: "Take a styled screenshot and save the image" },
+    video: { run: video, summary: "Render a scripted product video and save it" },
+    sandbox: { run: sandbox, summary: "Create sandboxes, run commands, open a shell, list and delete" },
+    routine: { run: routine, summary: "Deploy routines, run them and read their logs" },
+    action: { run: action, summary: "Search, describe and run marketplace actions" },
+    mcp: { run: mcp, summary: "Install the B3OS MCP server into Claude, Cursor or Codex; or serve it" },
+    bench: { run: bench, summary: "Probe client-side latency of a few calls from here" },
+    api: { run: api, summary: "Call any API operation by method and path" },
+};
+function help(ctx) {
+    const w = Math.max(...Object.keys(COMMANDS).map((c) => c.length));
+    ctx.out([
+        `b3os ${CLI_VERSION}: browsers, sandboxes, render, routines and actions next to the model.`,
+        "",
+        "usage: b3os <command> [options]",
+        "",
+        ...Object.entries(COMMANDS).map(([name, c]) => `  ${name.padEnd(w)}  ${c.summary}`),
+        "",
+        "Options for every command: --json, --yes, --quiet, --api-key KEY, --base-url URL, --timeout MS, --help",
+        "Credentials: --api-key, else B3OS_API_KEY, else the token from b3os login. Inside a B3OS sandbox node",
+        "operations go to B3OS_API_URL. On a node they use b3osd's Unix socket when B3OS_SOCKET is set, or when",
+        "no key and no base URL are configured (the socket acts as your uid's principal, not a key's).",
+        "Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 not found, 5 invalid or conflict, 6 rate limited or",
+        "out of credits, 7 server or unavailable, 8 timeout, 9 connection, 10 job or remote command failed",
+        "(sandbox exec --exit-code passes the remote code through), 130 interrupted.",
+    ].join("\n"));
+}
+export async function run(argv, io) {
+    const ctx = new Ctx(io ?? {
+        stdout: process.stdout,
+        stderr: process.stderr,
+        stdin: process.stdin,
+    });
+    const json = argv.includes("--json");
+    ctx.json = json;
+    const [cmd, ...rest] = argv;
+    try {
+        if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+            help(ctx);
+            return cmd ? EXIT.OK : EXIT.USAGE;
+        }
+        if (cmd === "version" || cmd === "--version" || cmd === "-v") {
+            if (json)
+                ctx.printJson({ cli: CLI_VERSION, sdk: SDK_VERSION, node: process.versions.node });
+            else
+                ctx.out(`b3os ${CLI_VERSION} (sdk ${SDK_VERSION}, node ${process.versions.node})`);
+            return EXIT.OK;
+        }
+        const c = COMMANDS[cmd];
+        if (!c)
+            throw new UsageError(`unknown command "${cmd}"; run b3os --help`);
+        return await c.run(ctx, rest);
+    }
+    catch (e) {
+        ctx.io.stderr.write(`${renderError(e, json)}\n`);
+        return exitCodeFor(e);
+    }
+}
+// Run when executed directly (`node src/main.ts`), not when imported (tests, the bin launcher).
+const entry = process.argv[1] ?? "";
+if (/[\\/]src[\\/]main\.ts$/.test(entry)) {
+    process.on("SIGINT", () => process.exit(EXIT.INTERRUPTED));
+    run(process.argv.slice(2)).then((code) => {
+        process.exitCode = code;
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,4GAA4G;AAE5G,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAgB,UAAU,EAAE,MAAM,UAAU,CAAC;AAEzF,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAInC,MAAM,QAAQ,GAAsD;IAClE,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,oDAAoD,EAAE;IACpF,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,6BAA6B,EAAE;IAC/D,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,yDAAyD,EAAE;IAC3F,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,0CAA0C,EAAE;IACxE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,sDAAsD,EAAE;IACxF,UAAU,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,6CAA6C,EAAE;IACvF,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,6CAA6C,EAAE;IAC7E,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,+DAA+D,EAAE;IACnG,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,+CAA+C,EAAE;IACnF,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,8CAA8C,EAAE;IAChF,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,uEAAuE,EAAE;IACnG,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,oDAAoD,EAAE;IACpF,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,2CAA2C,EAAE;CACxE,CAAC;AAEF,SAAS,IAAI,CAAC,GAAQ;IACpB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,GAAG,CAAC,GAAG,CACL;QACE,QAAQ,WAAW,wEAAwE;QAC3F,EAAE;QACF,iCAAiC;QACjC,EAAE;QACF,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QACnF,EAAE;QACF,wGAAwG;QACxG,uGAAuG;QACvG,wGAAwG;QACxG,+FAA+F;QAC/F,mGAAmG;QACnG,mGAAmG;QACnG,6EAA6E;KAC9E,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,EAAY;IACpD,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,EAAE,IAAI;QACJ,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CACF,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC;QACH,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC/D,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpC,CAAC;QACD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC7D,IAAI,IAAI;gBAAE,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;;gBACxF,GAAG,CAAC,GAAG,CAAC,QAAQ,WAAW,SAAS,WAAW,UAAU,OAAO,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;YACxF,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,CAAC;QACD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,oBAAoB,GAAG,oBAAoB,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,IAAI,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3D,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACvC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@b3os/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "The B3OS command line: scrape, screenshots, videos, sandboxes, routines, actions, keys and MCP setup.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "b3os": "./bin/b3os.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "b3os-source": "./src/main.ts",
+      "types": "./dist/main.d.ts",
+      "default": "./dist/main.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "dev": "node --conditions=b3os-source src/main.ts"
+  },
+  "dependencies": {
+    "@b3os/mcp": "0.0.1",
+    "@b3os/sdk": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.19.2"
+  },
+  "homepage": "https://beta.b3os.org",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/b3-fun/b3os-beta.git",
+    "directory": "packages/cli"
+  }
+}