decocms 0.16.0 → 2.138.0

package/README.md

@@ -1,95 +1,70 @@
-# Deco CLI Reference
+# Deco Studio
 
-The Deco CLI is your interface for managing AI-native projects built with
-[deco.chat](https://deco.chat).
+Open-source control plane for your AI agents. Install in 30 seconds.
 
-Official docs: https://docs.deco.page/
+```bash
+bunx decocms
+```
 
----
+> Requires [Bun](https://bun.sh). Install with: `curl -fsSL https://bun.sh/install | bash`
 
-## Authentication
+## What is Deco Studio?
 
-| Command       | Description                                                  |
-| ------------- | ------------------------------------------------------------ |
-| `deco login`  | Authenticate and store an API token for subsequent commands. |
-| `deco logout` | Remove local credentials and end the session.                |
-| `deco whoami` | Show the currently authenticated user and workspace.         |
+Deco Studio is where you hire AI agents, connect tools, and manage projects —
+all from a single dashboard. Browse specialized agents, wire up 50+ integrations
+via MCP, and track every token, cost, and action in real time.
 
----
+- **Hire agents** — browse specialized AI agents or create your own from custom prompts. Agents can compose and call each other.
+- **Connect tools** — 50+ integrations (GitHub, Slack, Postgres, OpenAI, and more) with one-click OAuth and granular RBAC.
+- **Track everything** — real-time cost attribution, latency monitoring, and error tracking per agent and connection.
+- **Run locally** — private, SQLite-based setup on your machine. No cloud required.
+- **Scale to teams** — optional cloud sync via [studio.decocms.com](https://studio.decocms.com), or self-host for your org.
 
-## Project Management
+```
+Your AI Agents & MCP Clients
+              │
+              ▼
+        Deco Studio
+  Agents · Tools · Observability
+              │
+              ▼
+ Integrations (Slack, GitHub, APIs, DBs...)
+```
 
-| Command          | Description                                                                 |
-| ---------------- | --------------------------------------------------------------------------- |
-| `deco create`    | Scaffold a new deco project from an official template.                      |
-| `deco configure` | Re-run setup for the current directory to change workspace or app settings. |
+## Quick start
 
----
+```bash
+# Start Deco Studio locally
+bunx decocms
 
-## Development
+# Opens at http://localhost:3000
+```
 
-| Command                     | Description                                                                                          |
-| --------------------------- | ---------------------------------------------------------------------------------------------------- |
-| `npm run dev`               | Preferred way to run local Worker and React frontend in watch mode.                                  |
-| `deco dev`                  | (Experimental) Future unified development command.                                                   |
-| `deco link [build-command]` | Link your local dev server to a public domain. Supports `-p <port>`. Example: deco link npm run dev. |
+Connect any MCP client to `http://localhost:3000/mcp`:
 
----
+```json
+{
+  "mcpServers": {
+    "deco": {
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+```
 
-## Type Generation
+## Deploy
 
-| Command         | Description                                                                |
-| --------------- | -------------------------------------------------------------------------- |
-| `deco gen`      | Generate types for external integrations (`deco.gen.ts`).                  |
-| `deco gen:self` | Generate types for your own tools and workflows via local `/mcp` endpoint. |
+Run locally with SQLite, or deploy for your team with Docker, Bun/Node,
+Kubernetes, and PostgreSQL. See the [docs](https://docs.deco.page/).
 
----
+## Links
 
-## Hosting & Deployment
+- [Website](https://decocms.com/studio)
+- [Documentation](https://docs.deco.page/)
+- [GitHub](https://github.com/decocms/mesh)
+- [Discord](https://decocms.com/discord)
 
-| Command                       | Description                                                                |
-| ----------------------------- | -------------------------------------------------------------------------- |
-| `npm run deploy`              | Builds frontend and invokes `deco deploy`. Recommended for most use cases. |
-| `deco deploy`                 | Bundle and deploy to Cloudflare Workers. Supports `-w`, `-a`, and `-l`.    |
-| `deco hosting list -w <name>` | List deployed apps in a specific workspace.                                |
+## License
 
----
-
-## Integrations
-
-| Command    | Description                               |
-| ---------- | ----------------------------------------- |
-| `deco add` | Add and configure workspace integrations. |
-
----
-
-## Maintenance
-
-| Command       | Description                                      |
-| ------------- | ------------------------------------------------ |
-| `deco update` | Upgrade the CLI to the latest published version. |
-
----
-
-## Getting Help
-
-| Command       | Description                                      |
-| ------------- | ------------------------------------------------ |
-| `deco --help` | Display the full list of CLI commands and usage. |
-
----
-
-## Configuration File
-
-The CLI uses a local config file to store your workspace and app context. Set or
-update this configuration anytime using: `deco configure`
-
----
-
-## Environment Variables
-
-| Variable              | Purpose                                                               |
-| --------------------- | --------------------------------------------------------------------- |
-| `DECO_CHAT_API_TOKEN` | API token for authentication (set by `deco login`).                   |
-| `DECO_CHAT_API_LOCAL` | Overrides API base URL for local development.                         |
-| `DECO_SELF_URL`       | Local MCP endpoint for `deco gen:self` to introspect workflows/tools. |
+Sustainable Use License — free to self-host for internal use and client
+projects. See [LICENSE.md](https://github.com/decocms/mesh/blob/main/LICENSE.md).

package/bin/deco.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+// Re-export the @decocms/mesh CLI entry point.
+// This wrapper package exists so that `npx decocms` / `deco` works
+// while the canonical package remains @decocms/mesh.
+
+const { execFileSync } = require("child_process");
+const { createRequire } = require("module");
+const { dirname, join } = require("path");
+
+const require_ = createRequire(__filename);
+const meshPkgJson = require_.resolve("@decocms/mesh/package.json");
+const meshDir = dirname(meshPkgJson);
+const meshBin = join(meshDir, "dist", "server", "cli.js");
+
+// The built CLI uses Bun APIs (Bun.file, Bun.serve), so bun is required.
+try {
+  execFileSync("bun", ["--version"], { stdio: "ignore" });
+} catch {
+  console.error("Deco Studio requires Bun to run.");
+  console.error("Install it with: curl -fsSL https://bun.sh/install | bash");
+  console.error("");
+  console.error("Then run: bunx decocms");
+  process.exit(1);
+}
+
+try {
+  execFileSync("bun", [meshBin, ...process.argv.slice(2)], {
+    stdio: "inherit",
+  });
+} catch (e) {
+  process.exit(e.status || 1);
+}

package/package.json

@@ -1,79 +1,48 @@
 {
   "name": "decocms",
-  "version": "0.16.0",
-  "description": "CLI for managing deco.chat apps & projects",
-  "license": "MIT",
+  "version": "2.138.0",
+  "description": "Open-source control plane for your AI agents. Hire agents, connect tools, track costs.",
   "author": "Deco team",
-  "homepage": "https://github.com/deco-cx/deco",
+  "license": "MIT",
+  "homepage": "https://github.com/decocms/mesh",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/deco-cx/deco.git",
-    "directory": "packages/cli"
+    "url": "git+https://github.com/decocms/mesh.git",
+    "directory": "packages/studio"
   },
   "bugs": {
-    "url": "https://github.com/deco-cx/deco/issues"
+    "url": "https://github.com/decocms/mesh/issues"
   },
-  "type": "module",
-  "main": "./dist/cli.js",
   "bin": {
-    "deco": "./dist/cli.js"
+    "deco": "./bin/deco.js"
   },
   "files": [
-    "dist/**/*",
-    "template/**/*"
+    "bin/**/*"
   ],
-  "scripts": {
-    "build": "tsc && cp -r src/rules dist/",
-    "dev": "tsx src/cli.ts",
-    "start": "node dist/cli.js",
-    "type-check": "tsc --noEmit",
-    "prepublishOnly": "npm run build",
-    "postpublish": "echo 'Published deco-cli to npm registry!'"
-  },
   "dependencies": {
-    "@deco-cx/warp-node": "0.3.16",
-    "@modelcontextprotocol/sdk": "1.17.1",
-    "@supabase/ssr": "^0.6.1",
-    "@supabase/supabase-js": "^2.50.0",
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "glob": "^10.3.10",
-    "inquirer": "^9.2.15",
-    "inquirer-search-checkbox": "^1.0.0",
-    "inquirer-search-list": "^1.2.6",
-    "jose": "^6.0.11",
-    "json-schema-to-typescript": "^15.0.4",
-    "object-hash": "^3.0.0",
-    "prettier": "^3.6.2",
-    "semver": "^7.6.0",
-    "smol-toml": "^1.3.4",
-    "ws": "^8.16.0",
-    "zod": "^3.25.64"
-  },
-  "devDependencies": {
-    "@types/inquirer": "^9.0.7",
-    "@types/node": "^20.11.17",
-    "@types/object-hash": "^3.0.6",
-    "@types/semver": "^7.5.6",
-    "@types/ws": "^8.5.10",
-    "tsx": "^4.7.1",
-    "typescript": "^5.3.3"
+    "@decocms/mesh": "2.138.0"
   },
-  "engines": {
-    "node": ">=18.0.0"
+  "publishConfig": {
+    "access": "public"
   },
   "keywords": [
-    "cli",
-    "deco",
-    "chat",
-    "deployment",
-    "development",
+    "ai-agents",
     "mcp",
     "model-context-protocol",
-    "hosting",
-    "tunnel"
-  ],
-  "publishConfig": {
-    "access": "public"
-  }
+    "ai",
+    "gateway",
+    "self-hosted",
+    "mesh",
+    "studio",
+    "deco",
+    "decocms",
+    "cli",
+    "cursor",
+    "claude",
+    "observability",
+    "cost-tracking",
+    "integrations",
+    "oauth",
+    "rbac"
+  ]
 }

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -1,373 +0,0 @@
-#!/usr/bin/env node
-// Check Node.js version requirement
-import process from "node:process";
-const MIN_NODE_VERSION = "18.0.0";
-const currentNodeVersion = process.version.slice(1); // Remove 'v' prefix
-function compareVersions(version1, version2) {
-    const v1parts = version1.split(".").map(Number);
-    const v2parts = version2.split(".").map(Number);
-    for (let i = 0; i < Math.max(v1parts.length, v2parts.length); i++) {
-        const v1part = v1parts[i] || 0;
-        const v2part = v2parts[i] || 0;
-        if (v1part < v2part)
-            return -1;
-        if (v1part > v2part)
-            return 1;
-    }
-    return 0;
-}
-if (compareVersions(currentNodeVersion, MIN_NODE_VERSION) < 0) {
-    console.error(`❌ Error: Node.js ${MIN_NODE_VERSION} or higher is required.`);
-    console.error(`   Current version: ${process.version}`);
-    console.error(`   Please upgrade Node.js: https://nodejs.org/`);
-    process.exit(1);
-}
-// Suppress punycode deprecation warning from dependencies
-process.removeAllListeners("warning");
-process.on("warning", (warning) => {
-    if (warning.name === "DeprecationWarning" &&
-        warning.message.includes("punycode")) {
-        return; // Ignore punycode deprecation warnings
-    }
-    console.warn(warning.message);
-});
-import { Command } from "commander";
-import { readFile, writeFile } from "fs/promises";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-import { spawn } from "child_process";
-import { deleteSession, readSession, setToken } from "./lib/session.js";
-import { DECO_CHAT_API_LOCAL } from "./lib/constants.js";
-import { getAppDomain, getConfig, readWranglerConfig, getLocal, setLocal, } from "./lib/config.js";
-import { loginCommand } from "./commands/auth/login.js";
-import { whoamiCommand } from "./commands/auth/whoami.js";
-import { configureCommand } from "./commands/config/configure.js";
-import { deploy } from "./commands/hosting/deploy.js";
-import { listApps } from "./commands/hosting/list.js";
-import { promoteApp } from "./commands/hosting/promote.js";
-import { createCommand } from "./commands/create/create.js";
-import { devCommand } from "./commands/dev/dev.js";
-import { link } from "./commands/dev/link.js";
-import { genEnv } from "./commands/gen/gen.js";
-import { upgradeCommand } from "./commands/update/upgrade.js";
-import { updateCommand } from "./commands/update/update.js";
-import { addCommand } from "./commands/add/add.js";
-import { detectRuntime } from "./lib/runtime.js";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-// Read package.json for version
-const packageJsonPath = join(__dirname, "../package.json");
-const packageJson = JSON.parse(await readFile(packageJsonPath, "utf-8"));
-// Login command implementation
-const login = new Command("login")
-    .description("Log in to deco.chat and retrieve tokens for CLI usage.")
-    .action(async () => {
-    try {
-        await loginCommand();
-        console.log("✅ Successfully logged in to deco.chat");
-    }
-    catch (error) {
-        console.error("❌ Login failed:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-// Placeholder for logout command implementation
-const logout = new Command("logout")
-    .description("Log out of deco.chat and remove local session data.")
-    .action(async () => {
-    try {
-        await deleteSession();
-        console.log("Logged out successfully. Session data removed.");
-    }
-    catch (e) {
-        if (e instanceof Error) {
-            console.error("Failed to log out:", e.message);
-        }
-        else {
-            console.error("Failed to log out:", String(e));
-        }
-    }
-});
-// Whoami command implementation
-const whoami = new Command("whoami")
-    .description("Print info about the current session.")
-    .action(whoamiCommand);
-// Configure command implementation
-const configure = new Command("configure")
-    .alias("config")
-    .description("Save configuration options for the current directory.")
-    .action(async () => {
-    try {
-        await configureCommand(getLocal());
-    }
-    catch (error) {
-        console.error("❌ Configuration failed:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-const hostingList = new Command("list")
-    .description("List all apps in the current workspace.")
-    .option("-w, --workspace <workspace>", "Workspace name")
-    .action(async (options) => {
-    try {
-        const session = await readSession();
-        const workspace = options.workspace || session?.workspace;
-        if (!workspace) {
-            console.error("❌ No workspace specified. Use -w flag or run 'deco configure' first.");
-            process.exit(1);
-        }
-        await listApps({ workspace });
-    }
-    catch (error) {
-        console.error("❌ Failed to list apps:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-// Hosting deploy command implementation
-const hostingDeploy = new Command("deploy")
-    .description("Deploy the current directory into the current workspace.")
-    .option("-w, --workspace <workspace>", "Workspace name")
-    .option("-a, --app <app>", "App name")
-    .option("-y, --yes", "Skip confirmation")
-    .option("-p, --public", "Make the app public in the registry")
-    .option("-f, --force", "Force the deployment even if there are breaking changes")
-    .option("--dry-run", "Write deploy manifest to local filesystem instead of deploying")
-    .argument("[cwd]", "Working directory")
-    .action(async (cwd, options) => {
-    try {
-        const config = await getConfig({
-            inlineOptions: options,
-        });
-        const wranglerConfig = await readWranglerConfig();
-        const assetsDirectory = wranglerConfig.assets?.directory;
-        const app = options.app ??
-            (typeof wranglerConfig.name === "string"
-                ? wranglerConfig.name
-                : "my-app");
-        await deploy({
-            ...config,
-            app,
-            skipConfirmation: options.yes,
-            cwd: cwd ?? process.cwd(),
-            unlisted: !options.public,
-            assetsDirectory,
-            force: options.force,
-            dryRun: options.dryRun,
-        });
-    }
-    catch (error) {
-        console.error("❌ Deployment failed:", error instanceof Error ? error.message : JSON.stringify(error));
-        process.exit(1);
-    }
-});
-// Hosting promote command implementation
-const hostingPromote = new Command("promote")
-    .description("Promote a deployment to an existing route pattern.")
-    .option("-w, --workspace <workspace>", "Workspace name")
-    .option("-a, --app <app>", "App name")
-    .option("-d, --deployment <deployment>", "Deployment ID")
-    .option("-r, --route <route>", "Route pattern (defaults to appName.deco.page)")
-    .option("-y, --yes", "Skip confirmation")
-    .action(async (options) => {
-    try {
-        const config = await getConfig({
-            inlineOptions: options,
-        });
-        let app = options.app;
-        if (!app) {
-            try {
-                const wranglerConfig = await readWranglerConfig();
-                app =
-                    typeof wranglerConfig.name === "string"
-                        ? wranglerConfig.name
-                        : undefined;
-            }
-            catch {
-                // No wrangler config found, app will remain undefined
-            }
-        }
-        await promoteApp({
-            workspace: config.workspace,
-            local: config.local,
-            appSlug: app,
-            deploymentId: options.deployment,
-            routePattern: options.route,
-            skipConfirmation: options.yes,
-        });
-    }
-    catch (error) {
-        console.error("❌ Promotion failed:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-// Link command implementation
-const linkCmd = new Command("link")
-    .description("Link the project to be accessed through a remote domain.")
-    .option("-p, --port <port>", "Port to link", parseInt)
-    .allowUnknownOption()
-    .action(async (options, cmd) => {
-    try {
-        const runCommand = cmd.args;
-        await link({
-            port: options.port,
-            onBeforeRegister: () => {
-                if (runCommand.length === 0) {
-                    console.log("⚠️  No command provided. Tunnel will connect to existing service on port.");
-                    return;
-                }
-                const [command, ...args] = runCommand;
-                console.log(`🔗 Starting command: ${command} ${args.join(" ")}`);
-                const childProcess = spawn(command, args, {
-                    stdio: "inherit",
-                    shell: true,
-                });
-                childProcess.on("error", (error) => {
-                    console.error("❌ Failed to start command:", error.message);
-                    process.exit(1);
-                });
-                return childProcess;
-            },
-        });
-    }
-    catch (error) {
-        console.error("❌ Link failed:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-const upgrade = new Command("upgrade")
-    .description("Upgrade the deco CLI to the latest version.")
-    .action(upgradeCommand);
-const update = new Command("update")
-    .description("Update Deco dependencies to their latest versions.")
-    .option("-y, --yes", "Skip confirmation prompts")
-    .action(async (options) => {
-    try {
-        await updateCommand({ yes: options.yes });
-    }
-    catch (error) {
-        console.error("❌ Update failed:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-// Dev command implementation
-const dev = new Command("dev")
-    .description("Start a development server.")
-    .option("--clean-build-dir <directory>", "Clean the build directory before starting the development server", (directory) => {
-    return {
-        enabled: true,
-        directory,
-    };
-})
-    .action((options) => {
-    devCommand({
-        cleanBuildDirectory: options.cleanBuildDir,
-    });
-});
-// Create command implementation
-const create = new Command("create")
-    .description("Create a new project from a template.")
-    .argument("[project-name]", "Name of the project")
-    .action(async (projectName) => {
-    try {
-        const config = await getConfig().catch(() => ({}));
-        await createCommand(projectName, config);
-    }
-    catch (error) {
-        console.error("❌ Project creation failed:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-// Add command implementation
-const add = new Command("add")
-    .description("Add integrations to the current project.")
-    .option("-w, --workspace <workspace>", "Workspace name")
-    .action(async (options) => {
-    try {
-        await addCommand({
-            workspace: options.workspace,
-            local: getLocal(),
-        });
-    }
-    catch (error) {
-        console.error("❌ Failed to add integrations:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-// Hosting parent command
-const hosting = new Command("hosting")
-    .description("Manage hosting apps in a workspace.")
-    .addCommand(hostingList)
-    .addCommand(hostingDeploy)
-    .addCommand(hostingPromote);
-const gen = new Command("gen")
-    .description("Generate the environment that will be used to run the app.")
-    .option("-s, --self <url>", "Useful to generate a SELF binding for own types based on local mcp server.")
-    .option("-o, --output <path>", "Output path for the generated environment file.")
-    .action(async (options) => {
-    try {
-        const wranglerConfig = await readWranglerConfig();
-        const config = await getConfig({});
-        const env = await genEnv({
-            workspace: config.workspace,
-            local: config.local,
-            bindings: config.bindings,
-            selfUrl: options.self ??
-                `https://${getAppDomain(config.workspace, wranglerConfig.name ?? "my-app")}/mcp`,
-        });
-        if (options.output) {
-            await writeFile(options.output, env);
-        }
-        else {
-            console.log(env);
-        }
-    }
-    catch (error) {
-        console.error("❌ Failed to generate environment:", error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-// Main CLI program
-const program = new Command()
-    .name(packageJson.name)
-    .version(packageJson.version)
-    .description(packageJson.description)
-    .configureOutput({
-    writeOut: (str) => {
-        // Customize version output to include runtime info
-        if (str.includes(packageJson.version) &&
-            str.trim() === packageJson.version) {
-            const runtime = detectRuntime();
-            process.stdout.write(`${packageJson.version} (${runtime})\n`);
-        }
-        else {
-            process.stdout.write(str);
-        }
-    },
-    writeErr: (str) => process.stderr.write(str),
-})
-    .option("-t, --token <token>", "Authentication token to use for API requests", (token) => {
-    setToken(token);
-})
-    .option("-l, --local", `Deploy the app locally (Needs deco.chat running at ${DECO_CHAT_API_LOCAL})`, () => {
-    setLocal(true);
-})
-    .addHelpText("after", () => {
-    const runtime = detectRuntime();
-    return `\nRuntime: ${runtime}`;
-})
-    .addCommand(login)
-    .addCommand(logout)
-    .addCommand(whoami)
-    .addCommand(hosting)
-    .addCommand(hostingDeploy)
-    .addCommand(hostingPromote)
-    .addCommand(dev)
-    .addCommand(configure)
-    .addCommand(add)
-    .addCommand(upgrade)
-    .addCommand(update)
-    .addCommand(linkCmd)
-    .addCommand(gen)
-    .addCommand(create);
-program.parse();
-//# sourceMappingURL=cli.js.map