mcoda 0.1.78 → 0.1.79

package/README.md

@@ -35,6 +35,7 @@ mcoda docs pdr generate --workspace-root . --project WEB --rfp-path docs/rfp/web
 - Backlog: `mcoda backlog`, `mcoda task`
 - Jobs/telemetry: `mcoda jobs`, `mcoda tokens`, `mcoda telemetry`
 - Owner-local GPU jobs: `mcoda gpu list`, `mcoda gpu ops`, `mcoda job artifact upload|run|status|logs|events|artifacts|cancel|retry`
+- Self-hosted agents: `mcoda self-hosted agent list`, `mcoda self-hosted agent details`, `mcoda self-hosted agent sync`
 - Agents: `mcoda test-agent`, `mcoda agent-run`
 - Updates: `mcoda update --check`
 
@@ -50,6 +51,18 @@ Environment variables are optional overrides for workspace settings:
 - `MCODA_TELEMETRY` set to `off` to disable telemetry.
 - `MCODA_STREAM_IO=1` to emit agent I/O lines to stderr.
 
+## Self-hosted mswarm agents
+
+`mcoda self-hosted agent list` reads direct self-hosted agents and opt-in
+load-balanced aliases from mswarm when the configured API key allows it. Direct
+entries stay pinned to one server. Load-balanced aliases are saved as auto
+routes and let mswarm choose an eligible upgraded node for the requested model
+or capability.
+
+Use direct slugs for rollback or pinned-server workloads. Use auto aliases only
+when the product should allow mswarm to route around busy, drained, stale, or
+incompatible nodes.
+
 ## Programmatic usage
 ```ts
 import { McodaEntrypoint } from "mcoda";

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

@@ -1 +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"}
+{"version":3,"file":"SelfHostedCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/self-hosted/SelfHostedCommands.ts"],"names":[],"mappings":"AAyOA,qBAAa,kBAAkB;WAChB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkGhD"}

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

@@ -7,6 +7,7 @@ Subcommands:
     --provider <NAME>       Filter by provider (mcoda|ollama)
     --limit <N>             Limit returned agents
     --include-unreachable   Include unreachable agents in the catalog result
+    --include-load-balanced Include auto-routed load-balanced self-hosted aliases
     --max-cost-per-1m-token <N>
                              Exclude agents above the given cost_per_million
     --sorted-by-catalog-rating
@@ -14,9 +15,11 @@ Subcommands:
     --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)
+    --include-load-balanced Allow details for auto-routed aliases
   agent sync                Sync self-hosted agents into the local mcoda registry
     --provider <NAME>       Filter by provider before syncing
     --include-unreachable   Sync unreachable agents too
+    --include-load-balanced Sync auto-routed load-balanced aliases 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
@@ -104,6 +107,7 @@ const resolveNonNegativeNumber = (value, label) => {
 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 agentRoutingMode = (agent) => agent.load_balanced ? "auto" : "direct";
 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)));
@@ -122,6 +126,7 @@ const printAgentList = (agents) => {
     }
     const headers = [
         "REMOTE SLUG",
+        "ROUTE",
         "PROVIDER",
         "ADAPTER",
         "MODEL",
@@ -136,6 +141,7 @@ const printAgentList = (agents) => {
     ];
     const rows = agents.map((agent) => [
         agent.remote_slug ?? agent.slug,
+        agentRoutingMode(agent),
         agent.provider,
         agent.adapter ?? "-",
         agent.default_model,
@@ -155,6 +161,8 @@ const printAgentDetails = (agent) => {
     const entries = [
         ["Slug", agent.slug],
         ["Remote slug", agent.remote_slug ?? "-"],
+        ["Route", agentRoutingMode(agent)],
+        ["Load-balanced group", agent.load_balanced_group_id ?? "-"],
         ["Provider", agent.provider],
         ["Adapter", agent.adapter ?? "-"],
         ["Source agent", agent.source_agent_slug ?? "-"],
@@ -170,6 +178,7 @@ const printAgentDetails = (agent) => {
         ["Supports tools", formatBoolean(agent.supports_tools)],
         ["Supports reasoning", formatBoolean(agent.supports_reasoning)],
         ["Health", agent.health_status ?? "-"],
+        ["Members", formatNumber(agent.member_count)],
         ["Capabilities", formatCapabilities(agent.capabilities)],
     ];
     const labelWidth = Math.max(...entries.map(([label]) => label.length));
@@ -187,11 +196,12 @@ const printSyncSummary = (summary) => {
         record.remoteSlug,
         record.localSlug,
         record.action,
+        record.routingMode ?? "-",
         record.provider,
         record.defaultModel,
     ]);
     // eslint-disable-next-line no-console
-    console.log(renderTable(["REMOTE SLUG", "LOCAL SLUG", "ACTION", "PROVIDER", "MODEL"], rows));
+    console.log(renderTable(["REMOTE SLUG", "LOCAL SLUG", "ACTION", "ROUTE", "PROVIDER", "MODEL"], rows));
 };
 export class SelfHostedCommands {
     static async run(argv) {
@@ -227,6 +237,7 @@ export class SelfHostedCommands {
                         provider: resolveString(parsed.flags.provider),
                         limit: resolvePositiveInt(parsed.flags.limit, "--limit"),
                         includeUnreachable: Boolean(parsed.flags["include-unreachable"]),
+                        includeLoadBalanced: Boolean(parsed.flags["include-load-balanced"]),
                         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"),
@@ -246,7 +257,9 @@ export class SelfHostedCommands {
                     if (!slug) {
                         throw new Error("Usage: mcoda self-hosted agent details <SLUG> [--json]");
                     }
-                    const agent = await api.getSelfHostedAgent(slug);
+                    const agent = await api.getSelfHostedAgent(slug, {
+                        includeLoadBalanced: Boolean(parsed.flags["include-load-balanced"]),
+                    });
                     if (parsed.flags.json) {
                         // eslint-disable-next-line no-console
                         console.log(JSON.stringify(agent, null, 2));
@@ -261,6 +274,7 @@ export class SelfHostedCommands {
                         provider: resolveString(parsed.flags.provider),
                         limit: resolvePositiveInt(parsed.flags.limit, "--limit"),
                         includeUnreachable: Boolean(parsed.flags["include-unreachable"]),
+                        includeLoadBalanced: Boolean(parsed.flags["include-load-balanced"]),
                         pruneMissing: Boolean(parsed.flags.prune),
                     });
                     if (parsed.flags.json) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcoda",
-  "version": "0.1.78",
+  "version": "0.1.79",
   "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.78",
-    "@mcoda/shared": "0.1.78"
+    "@mcoda/core": "0.1.79",
+    "@mcoda/shared": "0.1.79"
   },
   "devDependencies": {
-    "@mcoda/integrations": "0.1.78",
-    "@mcoda/db": "0.1.78"
+    "@mcoda/db": "0.1.79",
+    "@mcoda/integrations": "0.1.79"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",