mcoda 0.1.37 → 0.1.38

package/dist/bin/McodaEntrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"McodaEntrypoint.d.ts","sourceRoot":"","sources":["../../src/bin/McodaEntrypoint.ts"],"names":[],"mappings":";AA+BA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CAuMxE"}
+{"version":3,"file":"McodaEntrypoint.d.ts","sourceRoot":"","sources":["../../src/bin/McodaEntrypoint.ts"],"names":[],"mappings":";AAiCA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CAqNxE"}

package/dist/bin/McodaEntrypoint.js

@@ -3,6 +3,8 @@ import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import packageJson from "../../package.json" with { type: "json" };
 import { AgentsCommands } from "../commands/agents/AgentsCommands.js";
+import { CloudCommands } from "../commands/cloud/CloudCommands.js";
+import { ConfigCommands } from "../commands/config/ConfigCommands.js";
 import { GatewayAgentCommand } from "../commands/agents/GatewayAgentCommand.js";
 import { DocsCommands } from "../commands/docs/DocsCommands.js";
 import { JobsCommands } from "../commands/jobs/JobsCommands.js";
@@ -83,8 +85,10 @@ export class McodaEntrypoint {
             return;
         }
         if (!command) {
-            throw new Error("Usage: mcoda <agent|gateway-agent|test-agent|agent-run|routing|docs|openapi|job|jobs|tokens|telemetry|create-tasks|migrate-tasks|refine-tasks|task-sufficiency-audit|sds-preflight|order-tasks|tasks|add-tests|work-on-tasks|gateway-trio|code-review|qa-tasks|backlog|task|task-detail|estimate|update|set-workspace|project-guidance|pdr|sds> [...args]\n" +
+            throw new Error("Usage: mcoda <agent|cloud|cloud-agent|config|gateway-agent|test-agent|agent-run|routing|docs|openapi|job|jobs|tokens|telemetry|create-tasks|migrate-tasks|refine-tasks|task-sufficiency-audit|sds-preflight|order-tasks|tasks|add-tests|work-on-tasks|gateway-trio|code-review|qa-tasks|backlog|task|task-detail|estimate|update|set-workspace|project-guidance|pdr|sds> [...args]\n" +
+                "Config: use `mcoda config set mswarm-api-key <KEY>` to persist an encrypted mswarm API key in the resolved global mcoda config file.\n" +
                 "Routing: use `mcoda routing defaults` to view/update workspace/global defaults, `mcoda routing preview|explain` to inspect agent selection/provenance (override → workspace_default → global_default).\n" +
+                "Cloud agents: use `mcoda cloud agent list|details|sync` to discover and materialize mswarm-managed remote agents.\n" +
                 "Aliases: `tasks order-by-deps` forwards to `order-tasks` (dependency-aware ordering), `task`/`task-detail` show a single task.\n" +
                 "Job commands (mcoda job --help for details): list|status|watch|logs|inspect|resume|cancel|tokens\n" +
                 "Jobs API required for job commands (set MCODA_API_BASE_URL/MCODA_JOBS_API_URL or workspace api.baseUrl). status/watch/logs exit non-zero on failed/cancelled jobs per SDS.");
@@ -93,6 +97,18 @@ export class McodaEntrypoint {
             await AgentsCommands.run(rest);
             return;
         }
+        if (command === "cloud") {
+            await CloudCommands.run(rest);
+            return;
+        }
+        if (command === "config") {
+            await ConfigCommands.run(rest);
+            return;
+        }
+        if (command === "cloud-agent") {
+            await CloudCommands.run(["agent", ...rest]);
+            return;
+        }
         if (command === "gateway-agent") {
             await GatewayAgentCommand.run(rest);
             return;

package/dist/commands/cloud/CloudCommands.d.ts

@@ -0,0 +1,4 @@
+export declare class CloudCommands {
+    static run(argv: string[]): Promise<void>;
+}
+//# sourceMappingURL=CloudCommands.d.ts.map

package/dist/commands/cloud/CloudCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/cloud/CloudCommands.ts"],"names":[],"mappings":"AAyLA,qBAAa,aAAa;WACX,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA+EhD"}

package/dist/commands/cloud/CloudCommands.js

@@ -0,0 +1,249 @@
+import { MswarmApi } from "@mcoda/core";
+const USAGE = `
+Usage: mcoda cloud agent <list|details|sync> [options]
+
+Subcommands:
+  agent list                List mswarm cloud agents (supports --json)
+    --provider <NAME>       Filter by provider
+    --limit <N>             Limit returned agents
+  agent details <SLUG>      Show a single mswarm cloud agent (supports --json)
+  agent sync                Sync mswarm cloud agents into the local mcoda registry
+    --provider <NAME>       Filter by provider before syncing
+    --limit <N>             Limit synced agents
+    --agent-slug-prefix <P> Override the local managed-agent slug prefix
+
+Connection options:
+  --base-url <URL>          Override MCODA_MSWARM_BASE_URL (default: https://api.mswarm.org/)
+  --openai-base-url <URL>   Override MCODA_MSWARM_OPENAI_BASE_URL for synced managed-agent execution
+  --api-key <KEY>           Override MCODA_MSWARM_API_KEY
+  --timeout-ms <N>          Override MCODA_MSWARM_TIMEOUT_MS
+
+Environment:
+  MCODA_MSWARM_BASE_URL
+  MCODA_MSWARM_OPENAI_BASE_URL
+  MCODA_MSWARM_API_KEY
+  MCODA_MSWARM_TIMEOUT_MS
+  MCODA_MSWARM_AGENT_SLUG_PREFIX
+  Or persist the API key with: mcoda config set mswarm-api-key <KEY>
+
+Flags:
+  --json                    Emit JSON for supported commands
+  --help                    Show this help
+`.trim();
+const parseArgs = (argv) => {
+    const flags = {};
+    const positionals = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg.startsWith("--")) {
+            const key = arg.replace(/^--/, "");
+            const next = argv[index + 1];
+            if (next && !next.startsWith("--")) {
+                const current = flags[key];
+                if (current === undefined) {
+                    flags[key] = next;
+                }
+                else if (Array.isArray(current)) {
+                    flags[key] = [...current, next];
+                }
+                else if (typeof current === "string") {
+                    flags[key] = [current, next];
+                }
+                else {
+                    flags[key] = [next];
+                }
+                index += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+            continue;
+        }
+        positionals.push(arg);
+    }
+    return { flags, positionals };
+};
+const resolveString = (value) => {
+    if (value === undefined || typeof value === "boolean")
+        return undefined;
+    return Array.isArray(value) ? value[value.length - 1] : value;
+};
+const resolvePositiveInt = (value, label) => {
+    const raw = resolveString(value);
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`Invalid ${label}; expected a positive integer`);
+    }
+    return parsed;
+};
+const formatNumber = (value) => value === undefined || Number.isNaN(value) ? "-" : String(value);
+const formatCapabilities = (capabilities) => capabilities && capabilities.length > 0 ? capabilities.join(",") : "-";
+const formatBoolean = (value) => value === undefined ? "-" : value ? "yes" : "no";
+const pad = (value, width) => value.padEnd(width, " ");
+const renderTable = (headers, rows) => {
+    const widths = headers.map((header, columnIndex) => Math.max(header.length, ...rows.map((row) => row[columnIndex]?.length ?? 0)));
+    const lines = [
+        headers.map((header, index) => pad(header, widths[index] ?? header.length)).join("  "),
+        widths.map((width) => "-".repeat(width)).join("  "),
+        ...rows.map((row) => row.map((cell, index) => pad(cell, widths[index] ?? cell.length)).join("  ")),
+    ];
+    return lines.join("\n");
+};
+const printAgentList = (agents) => {
+    if (agents.length === 0) {
+        // eslint-disable-next-line no-console
+        console.log("No cloud agents found.");
+        return;
+    }
+    const headers = [
+        "REMOTE SLUG",
+        "PROVIDER",
+        "MODEL",
+        "RATING",
+        "REASON",
+        "MAX CPLX",
+        "TOOLS",
+        "HEALTH",
+        "PRICING",
+        "CAPABILITIES",
+    ];
+    const rows = agents.map((agent) => [
+        agent.slug,
+        agent.provider,
+        agent.default_model,
+        formatNumber(agent.rating),
+        formatNumber(agent.reasoning_rating),
+        formatNumber(agent.max_complexity),
+        formatBoolean(agent.supports_tools),
+        agent.health_status ?? "-",
+        agent.pricing_version ?? "-",
+        formatCapabilities(agent.capabilities),
+    ]);
+    // eslint-disable-next-line no-console
+    console.log(renderTable(headers, rows));
+};
+const printAgentDetails = (agent) => {
+    const entries = [
+        ["Slug", agent.slug],
+        ["Provider", agent.provider],
+        ["Model", agent.default_model],
+        ["Model ID", agent.model_id ?? "-"],
+        ["Display name", agent.display_name ?? "-"],
+        ["Description", agent.description ?? "-"],
+        ["Rating", formatNumber(agent.rating)],
+        ["Reasoning rating", formatNumber(agent.reasoning_rating)],
+        ["Max complexity", formatNumber(agent.max_complexity)],
+        ["Context window", formatNumber(agent.context_window)],
+        ["Supports tools", formatBoolean(agent.supports_tools)],
+        ["Supports reasoning", formatBoolean(agent.supports_reasoning)],
+        ["Health", agent.health_status ?? "-"],
+        ["Pricing version", agent.pricing_version ?? "-"],
+        ["Pricing snapshot", agent.pricing_snapshot_id ?? "-"],
+        ["Capabilities", formatCapabilities(agent.capabilities)],
+    ];
+    const labelWidth = Math.max(...entries.map(([label]) => label.length));
+    for (const [label, value] of entries) {
+        // eslint-disable-next-line no-console
+        console.log(`${label.padEnd(labelWidth, " ")} : ${value}`);
+    }
+};
+const printSyncSummary = (summary) => {
+    // eslint-disable-next-line no-console
+    console.log(`Synced ${summary.agents.length} cloud agents (created=${summary.created}, updated=${summary.updated}).`);
+    if (summary.agents.length === 0) {
+        return;
+    }
+    const rows = summary.agents.map((record) => [
+        record.remoteSlug,
+        record.localSlug,
+        record.action,
+        record.provider,
+        record.defaultModel,
+        record.pricingVersion ?? "-",
+    ]);
+    // eslint-disable-next-line no-console
+    console.log(renderTable(["REMOTE SLUG", "LOCAL SLUG", "ACTION", "PROVIDER", "MODEL", "PRICING"], rows));
+};
+export class CloudCommands {
+    static async run(argv) {
+        const [topic, rawSubcommand, ...rest] = argv;
+        if (!topic || argv.includes("--help") || argv.includes("-h")) {
+            // eslint-disable-next-line no-console
+            console.log(USAGE);
+            return;
+        }
+        if (topic !== "agent" && topic !== "agents") {
+            throw new Error(`Unknown cloud topic: ${topic}`);
+        }
+        const subcommand = rawSubcommand === "detail" || rawSubcommand === "show"
+            ? "details"
+            : rawSubcommand;
+        if (!subcommand) {
+            // eslint-disable-next-line no-console
+            console.log(USAGE);
+            return;
+        }
+        const parsed = parseArgs(rest);
+        const api = await MswarmApi.create({
+            baseUrl: resolveString(parsed.flags["base-url"]),
+            openAiBaseUrl: resolveString(parsed.flags["openai-base-url"]),
+            apiKey: resolveString(parsed.flags["api-key"]),
+            timeoutMs: resolvePositiveInt(parsed.flags["timeout-ms"], "--timeout-ms"),
+            agentSlugPrefix: resolveString(parsed.flags["agent-slug-prefix"]),
+        });
+        try {
+            switch (subcommand) {
+                case "list": {
+                    const agents = await api.listCloudAgents({
+                        provider: resolveString(parsed.flags.provider),
+                        limit: resolvePositiveInt(parsed.flags.limit, "--limit"),
+                    });
+                    if (parsed.flags.json) {
+                        // eslint-disable-next-line no-console
+                        console.log(JSON.stringify(agents, null, 2));
+                    }
+                    else {
+                        printAgentList(agents);
+                    }
+                    break;
+                }
+                case "details": {
+                    const slug = parsed.positionals[0];
+                    if (!slug) {
+                        throw new Error("Usage: mcoda cloud agent details <SLUG> [--json]");
+                    }
+                    const agent = await api.getCloudAgent(slug);
+                    if (parsed.flags.json) {
+                        // eslint-disable-next-line no-console
+                        console.log(JSON.stringify(agent, null, 2));
+                    }
+                    else {
+                        printAgentDetails(agent);
+                    }
+                    break;
+                }
+                case "sync": {
+                    const summary = await api.syncCloudAgents({
+                        provider: resolveString(parsed.flags.provider),
+                        limit: resolvePositiveInt(parsed.flags.limit, "--limit"),
+                    });
+                    if (parsed.flags.json) {
+                        // eslint-disable-next-line no-console
+                        console.log(JSON.stringify(summary, null, 2));
+                    }
+                    else {
+                        printSyncSummary(summary);
+                    }
+                    break;
+                }
+                default:
+                    throw new Error(`Unknown cloud subcommand: ${subcommand}`);
+            }
+        }
+        finally {
+            await api.close();
+        }
+    }
+}

package/dist/commands/config/ConfigCommands.d.ts

@@ -0,0 +1,4 @@
+export declare class ConfigCommands {
+    static run(argv: string[]): Promise<void>;
+}
+//# sourceMappingURL=ConfigCommands.d.ts.map

package/dist/commands/config/ConfigCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/config/ConfigCommands.ts"],"names":[],"mappings":"AAYA,qBAAa,cAAc;WACZ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBhD"}

package/dist/commands/config/ConfigCommands.js

@@ -0,0 +1,33 @@
+import { MswarmConfigStore } from "@mcoda/core";
+const USAGE = `
+Usage: mcoda config set mswarm-api-key <KEY>
+
+Subcommands:
+  set mswarm-api-key <KEY>   Persist an encrypted global mswarm API key in the resolved global mcoda config file
+
+Flags:
+  --help                     Show this help
+`.trim();
+export class ConfigCommands {
+    static async run(argv) {
+        const [subcommand, key, value] = argv;
+        if (!subcommand || argv.includes("--help") || argv.includes("-h")) {
+            // eslint-disable-next-line no-console
+            console.log(USAGE);
+            return;
+        }
+        if (subcommand !== "set") {
+            throw new Error(`Unknown config subcommand: ${subcommand}`);
+        }
+        if (key !== "mswarm-api-key") {
+            throw new Error(`Unknown config key: ${key ?? "<missing>"}`);
+        }
+        if (!value?.trim()) {
+            throw new Error("Usage: mcoda config set mswarm-api-key <KEY>");
+        }
+        const store = new MswarmConfigStore();
+        await store.saveApiKey(value);
+        // eslint-disable-next-line no-console
+        console.log(`Saved encrypted mswarm API key to ${store.configPath()}.`);
+    }
+}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./commands/agents/AgentsCommands.js";
 export * from "./bin/McodaEntrypoint.js";
+export * from "./commands/cloud/CloudCommands.js";
+export * from "./commands/config/ConfigCommands.js";
 export * from "./commands/docs/DocsCommands.js";
 export * from "./commands/jobs/JobsCommands.js";
 export * from "./commands/openapi/OpenapiCommands.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oDAAoD,CAAC;AACnE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oDAAoD,CAAC;AACnE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
 export * from "./commands/agents/AgentsCommands.js";
 export * from "./bin/McodaEntrypoint.js";
+export * from "./commands/cloud/CloudCommands.js";
+export * from "./commands/config/ConfigCommands.js";
 export * from "./commands/docs/DocsCommands.js";
 export * from "./commands/jobs/JobsCommands.js";
 export * from "./commands/openapi/OpenapiCommands.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcoda",
-  "version": "0.1.37",
+  "version": "0.1.38",
   "description": "Local-first CLI for planning, documentation, and execution workflows with agent assistance.",
   "type": "module",
   "main": "dist/index.js",
@@ -45,12 +45,12 @@
   },
   "dependencies": {
     "yaml": "^2.4.2",
-    "@mcoda/shared": "0.1.37",
-    "@mcoda/core": "0.1.37"
+    "@mcoda/core": "0.1.38",
+    "@mcoda/shared": "0.1.38"
   },
   "devDependencies": {
-    "@mcoda/integrations": "0.1.37",
-    "@mcoda/db": "0.1.37"
+    "@mcoda/db": "0.1.38",
+    "@mcoda/integrations": "0.1.38"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",