mcoda 0.1.41 → 0.1.43

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

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

package/dist/bin/McodaEntrypoint.js

@@ -4,6 +4,7 @@ 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 { SelfHostedCommands } from '../commands/self-hosted/SelfHostedCommands.js';
 import { ConfigCommands } from '../commands/config/ConfigCommands.js';
 import { ConsentCommands } from '../commands/consent/ConsentCommands.js';
 import { GatewayAgentCommand } from '../commands/agents/GatewayAgentCommand.js';
@@ -88,12 +89,14 @@ export class McodaEntrypoint {
             return;
         }
         if (!command) {
-            throw new Error('Usage: mcoda <agent|cloud|cloud-agent|config|consent|setup|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|self-hosted|self-hosted-agent|config|consent|setup|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' +
                 'Setup: use `mcoda setup` after installation (or accept the postinstall prompt) to complete the mandatory mswarm telemetry consent flow.\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' +
                 'Consent: use `mcoda consent accept` before other commands if you need to complete consent outside the guided setup flow.\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' +
+                'Self-hosted agents: use `mcoda self-hosted agent list|details|sync` to discover and materialize owner-hosted mswarm agents.\n' +
+                'Expose this machine: install `@mcoda/mswarm`, then run `mswarm setup --api-key <KEY>`.\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.');
@@ -114,6 +117,10 @@ export class McodaEntrypoint {
             await CloudCommands.run(rest);
             return;
         }
+        if (command === 'self-hosted' || command === 'selfhosted') {
+            await SelfHostedCommands.run(rest);
+            return;
+        }
         if (command === 'config') {
             await ConfigCommands.run(rest);
             return;
@@ -130,6 +137,10 @@ export class McodaEntrypoint {
             await CloudCommands.run(['agent', ...rest]);
             return;
         }
+        if (command === 'self-hosted-agent' || command === 'selfhosted-agent') {
+            await SelfHostedCommands.run(['agent', ...rest]);
+            return;
+        }
         if (command === 'gateway-agent') {
             await GatewayAgentCommand.run(rest);
             return;

package/dist/commands/config/ConfigCommands.js

@@ -29,6 +29,6 @@ export class ConfigCommands {
         await store.saveApiKey(value);
         const refresh = await MswarmApi.refreshManagedAgentAuth(value);
         // eslint-disable-next-line no-console
-        console.log(`Saved encrypted mswarm API key to ${store.configPath()}. Refreshed managed cloud-agent auth for ${refresh.updated} agents.`);
+        console.log(`Saved encrypted mswarm API key to ${store.configPath()}. Refreshed managed mswarm-agent auth for ${refresh.updated} agents.`);
     }
 }

package/dist/commands/self-hosted/SelfHostedCommands.d.ts

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

package/dist/commands/self-hosted/SelfHostedCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelfHostedCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/self-hosted/SelfHostedCommands.ts"],"names":[],"mappings":"AA6NA,qBAAa,kBAAkB;WAChB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA8FhD"}

package/dist/commands/self-hosted/SelfHostedCommands.js

@@ -0,0 +1,283 @@
+import { MswarmApi, } from "@mcoda/core";
+const USAGE = `
+Usage: mcoda self-hosted agent <list|details|sync> [options]
+
+Subcommands:
+  agent list                List mswarm self-hosted agents (supports --json)
+    --provider <NAME>       Filter by provider (mcoda|ollama)
+    --limit <N>             Limit returned agents
+    --include-unreachable   Include unreachable agents in the catalog result
+    --max-cost-per-1m-token <N>
+                             Exclude agents above the given cost_per_million
+    --sorted-by-catalog-rating
+                             Sort results by the catalog rating field (descending)
+    --min-context <N>       Require at least this context window
+    --min-reasoning <N>     Require at least this reasoning rating
+  agent details <SLUG>      Show a single mswarm self-hosted agent (supports --json)
+  agent sync                Sync self-hosted agents into the local mcoda registry
+    --provider <NAME>       Filter by provider before syncing
+    --include-unreachable   Sync unreachable agents too
+    --limit <N>             Limit synced agents
+    --prune                 Remove previously synced self-hosted agents missing from the current catalog result
+    --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 execution 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_SELF_HOSTED_AGENT_SLUG_PREFIX
+  Or persist the API key with: mcoda config set mswarm-api-key <KEY>
+
+To expose this machine's local agents:
+  npm install -g @mcoda/mswarm
+  mswarm setup --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 resolveNonNegativeNumber = (value, label) => {
+    const raw = resolveString(value);
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        throw new Error(`Invalid ${label}; expected a non-negative number`);
+    }
+    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 self-hosted agents found.");
+        return;
+    }
+    const headers = [
+        "REMOTE SLUG",
+        "PROVIDER",
+        "ADAPTER",
+        "MODEL",
+        "RATING",
+        "REASON",
+        "MAX CPLX",
+        "CTX",
+        "COST/$1M",
+        "TOOLS",
+        "HEALTH",
+        "CAPABILITIES",
+    ];
+    const rows = agents.map((agent) => [
+        agent.remote_slug ?? agent.slug,
+        agent.provider,
+        agent.adapter ?? "-",
+        agent.default_model,
+        formatNumber(agent.rating),
+        formatNumber(agent.reasoning_rating),
+        formatNumber(agent.max_complexity),
+        formatNumber(agent.context_window),
+        formatNumber(agent.cost_per_million),
+        formatBoolean(agent.supports_tools),
+        agent.health_status ?? "-",
+        formatCapabilities(agent.capabilities),
+    ]);
+    // eslint-disable-next-line no-console
+    console.log(renderTable(headers, rows));
+};
+const printAgentDetails = (agent) => {
+    const entries = [
+        ["Slug", agent.slug],
+        ["Remote slug", agent.remote_slug ?? "-"],
+        ["Provider", agent.provider],
+        ["Adapter", agent.adapter ?? "-"],
+        ["Source agent", agent.source_agent_slug ?? "-"],
+        ["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)],
+        ["Cost / 1M tokens", formatNumber(agent.cost_per_million)],
+        ["Context window", formatNumber(agent.context_window)],
+        ["Supports tools", formatBoolean(agent.supports_tools)],
+        ["Supports reasoning", formatBoolean(agent.supports_reasoning)],
+        ["Health", agent.health_status ?? "-"],
+        ["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} self-hosted agents (created=${summary.created}, updated=${summary.updated}, deleted=${summary.deleted}).`);
+    if (summary.agents.length === 0)
+        return;
+    const rows = summary.agents.map((record) => [
+        record.remoteSlug,
+        record.localSlug,
+        record.action,
+        record.provider,
+        record.defaultModel,
+    ]);
+    // eslint-disable-next-line no-console
+    console.log(renderTable(["REMOTE SLUG", "LOCAL SLUG", "ACTION", "PROVIDER", "MODEL"], rows));
+};
+export class SelfHostedCommands {
+    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 self-hosted 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"),
+            selfHostedAgentSlugPrefix: resolveString(parsed.flags["agent-slug-prefix"]),
+        });
+        try {
+            switch (subcommand) {
+                case "list": {
+                    const agents = await api.listSelfHostedAgents({
+                        provider: resolveString(parsed.flags.provider),
+                        limit: resolvePositiveInt(parsed.flags.limit, "--limit"),
+                        includeUnreachable: Boolean(parsed.flags["include-unreachable"]),
+                        maxCostPerMillion: resolveNonNegativeNumber(parsed.flags["max-cost-per-1m-token"], "--max-cost-per-1m-token"),
+                        minContextWindow: resolvePositiveInt(parsed.flags["min-context"], "--min-context"),
+                        minReasoningRating: resolveNonNegativeNumber(parsed.flags["min-reasoning"], "--min-reasoning"),
+                        sortByCatalogRating: Boolean(parsed.flags["sorted-by-catalog-rating"] || parsed.flags["sort-by-catalog-rating"]),
+                    });
+                    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 self-hosted agent details <SLUG> [--json]");
+                    }
+                    const agent = await api.getSelfHostedAgent(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.syncSelfHostedAgents({
+                        provider: resolveString(parsed.flags.provider),
+                        limit: resolvePositiveInt(parsed.flags.limit, "--limit"),
+                        includeUnreachable: Boolean(parsed.flags["include-unreachable"]),
+                        pruneMissing: Boolean(parsed.flags.prune),
+                    });
+                    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 self-hosted subcommand: ${subcommand}`);
+            }
+        }
+        finally {
+            await api.close();
+        }
+    }
+}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './commands/agents/AgentsCommands.js';
 export * from './bin/McodaEntrypoint.js';
 export * from './commands/cloud/CloudCommands.js';
+export * from './commands/self-hosted/SelfHostedCommands.js';
 export * from './commands/config/ConfigCommands.js';
 export * from './commands/consent/ConsentCommands.js';
 export * from './commands/docs/DocsCommands.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,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,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,kCAAkC,CAAC;AACjD,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,8CAA8C,CAAC;AAC7D,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,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,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from './commands/agents/AgentsCommands.js';
 export * from './bin/McodaEntrypoint.js';
 export * from './commands/cloud/CloudCommands.js';
+export * from './commands/self-hosted/SelfHostedCommands.js';
 export * from './commands/config/ConfigCommands.js';
 export * from './commands/consent/ConsentCommands.js';
 export * from './commands/docs/DocsCommands.js';

package/package.json

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