mcoda 0.1.70 → 0.1.72

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"McodaEntrypoint.d.ts","sourceRoot":"","sources":["../../src/bin/McodaEntrypoint.ts"],"names":[],"mappings":";AAsCA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CA4PxE"}

package/dist/bin/McodaEntrypoint.js

@@ -5,6 +5,7 @@ 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 { WorkersCommands } from '../commands/workers/WorkersCommands.js';
 import { ConfigCommands } from '../commands/config/ConfigCommands.js';
 import { ConsentCommands } from '../commands/consent/ConsentCommands.js';
 import { GatewayAgentCommand } from '../commands/agents/GatewayAgentCommand.js';
@@ -89,13 +90,14 @@ export class McodaEntrypoint {
             return;
         }
         if (!command) {
-            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' +
+            throw new Error('Usage: mcoda <agent|cloud|cloud-agent|self-hosted|self-hosted-agent|workers|worker|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' +
+                'Workers: use `mcoda workers list|details|sync|run` to discover, materialize, and invoke mswarm Workers.\n' +
                 'Expose this machine: install `@mcoda/mswarm`, then run `mswarm install <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' +
@@ -121,6 +123,10 @@ export class McodaEntrypoint {
             await SelfHostedCommands.run(rest);
             return;
         }
+        if (command === 'workers' || command === 'worker') {
+            await WorkersCommands.run(rest);
+            return;
+        }
         if (command === 'config') {
             await ConfigCommands.run(rest);
             return;

package/dist/commands/workers/WorkersCommands.d.ts

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

package/dist/commands/workers/WorkersCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkersCommands.d.ts","sourceRoot":"","sources":["../../../src/commands/workers/WorkersCommands.ts"],"names":[],"mappings":"AA0PA,qBAAa,eAAe;WACb,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAwFhD"}

package/dist/commands/workers/WorkersCommands.js

@@ -0,0 +1,301 @@
+import { MswarmApi, } from "@mcoda/core";
+import { readFile } from "node:fs/promises";
+const USAGE = `
+Usage: mcoda workers <list|details|sync|run> [options]
+
+Subcommands:
+  list                     List mswarm Workers as mcoda agents (supports --json)
+    --limit <N>            Limit returned workers
+    --include-disabled     Include disabled Workers in the catalog result (default)
+    --enabled-only         Hide disabled Workers
+  details <SLUG>           Show a single mswarm Worker (supports --json)
+  sync                     Sync mswarm Workers into the local mcoda registry
+    --limit <N>            Limit synced workers
+    --include-disabled     Sync disabled Workers too (default)
+    --enabled-only         Sync active Workers only
+    --prune                Remove previously synced Workers missing from the current catalog result
+    --agent-slug-prefix <P>
+                             Override the local managed-worker slug prefix
+  run <SLUG> [TEXT...]     Run a Worker through mswarm
+    --input <TEXT>         Worker input text
+    --payload-file <FILE>  Read JSON payload from a file
+    --payload-stdin        Read JSON or text payload from stdin
+    --idempotency-key <K>  Forward an idempotency key
+
+Connection options:
+  --base-url <URL>         Override MCODA_MSWARM_BASE_URL (default: https://api.mswarm.org/)
+  --api-key <KEY>          Override MCODA_MSWARM_API_KEY
+  --timeout-ms <N>         Override MCODA_MSWARM_TIMEOUT_MS
+
+Environment:
+  MCODA_MSWARM_BASE_URL
+  MCODA_MSWARM_API_KEY
+  MCODA_MSWARM_TIMEOUT_MS
+  MCODA_MSWARM_WORKER_AGENT_SLUG_PREFIX
+
+Flags:
+  --json                   Emit JSON for supported commands
+  --help                   Show this help
+`.trim();
+const MAX_WORKER_PAYLOAD_BYTES = 5 * 1024 * 1024;
+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 formatBoolean = (value) => value === undefined ? "-" : value ? "yes" : "no";
+const formatCapabilities = (capabilities) => capabilities && capabilities.length > 0 ? capabilities.join(",") : "-";
+const asRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value)
+    ? value
+    : undefined;
+const formatString = (value) => typeof value === "string" && value.trim() ? value.trim() : "-";
+const formatWorkerAgent = (worker) => {
+    const selected = asRecord(worker.worker?.selected_agent);
+    return formatString(selected?.slug ?? selected?.model ?? worker.default_model);
+};
+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)));
+    return [
+        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("  ")),
+    ].join("\n");
+};
+const printWorkerList = (workers) => {
+    if (workers.length === 0) {
+        // eslint-disable-next-line no-console
+        console.log("No mswarm Workers found.");
+        return;
+    }
+    const rows = workers.map((worker) => [
+        worker.slug,
+        worker.worker?.name ?? worker.display_name ?? "-",
+        formatBoolean(worker.worker?.enabled),
+        worker.worker?.status ?? worker.health_status ?? "-",
+        formatWorkerAgent(worker),
+        formatBoolean(worker.worker?.docdex_enabled),
+        formatString(asRecord(worker.worker?.config_health)?.status),
+    ]);
+    // eslint-disable-next-line no-console
+    console.log(renderTable(["WORKER SLUG", "NAME", "ENABLED", "STATUS", "AGENT", "DOCDEX", "CONFIG"], rows));
+};
+const printWorkerDetails = (worker) => {
+    const entries = [
+        ["Slug", worker.slug],
+        ["Remote slug", worker.remote_slug ?? "-"],
+        ["Name", worker.worker?.name ?? worker.display_name ?? "-"],
+        ["Provider", worker.provider],
+        ["Adapter", worker.adapter ?? "-"],
+        ["Model", worker.default_model],
+        ["Rating", formatNumber(worker.rating)],
+        ["Reasoning rating", formatNumber(worker.reasoning_rating)],
+        ["Max complexity", formatNumber(worker.max_complexity)],
+        ["Supports tools", formatBoolean(worker.supports_tools)],
+        ["Health", worker.health_status ?? "-"],
+        ["Capabilities", formatCapabilities(worker.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} Workers (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.defaultModel,
+    ]);
+    // eslint-disable-next-line no-console
+    console.log(renderTable(["REMOTE SLUG", "LOCAL SLUG", "ACTION", "MODEL"], rows));
+};
+const ensurePayloadSize = (raw, label) => {
+    const bytes = Buffer.byteLength(raw, "utf8");
+    if (bytes > MAX_WORKER_PAYLOAD_BYTES) {
+        throw new Error(`${label} exceeds ${MAX_WORKER_PAYLOAD_BYTES} bytes`);
+    }
+};
+const readStdin = async () => new Promise((resolve, reject) => {
+    let data = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+        data += chunk;
+        if (Buffer.byteLength(data, "utf8") > MAX_WORKER_PAYLOAD_BYTES) {
+            reject(new Error(`stdin payload exceeds ${MAX_WORKER_PAYLOAD_BYTES} bytes`));
+        }
+    });
+    process.stdin.on("error", reject);
+    process.stdin.on("end", () => resolve(data));
+});
+const parsePayloadText = (raw, label) => {
+    ensurePayloadSize(raw, label);
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return {};
+    }
+    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch (error) {
+            throw new Error(`${label} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return { text: raw };
+};
+const resolveRunPayload = async (parsed) => {
+    const sources = [
+        resolveString(parsed.flags["payload-file"]) !== undefined,
+        parsed.flags["payload-stdin"] === true,
+        resolveString(parsed.flags.input) !== undefined || parsed.positionals.length > 1,
+    ].filter(Boolean).length;
+    if (sources > 1) {
+        throw new Error("Use only one of --payload-file, --payload-stdin, --input, or positional TEXT");
+    }
+    const payloadFile = resolveString(parsed.flags["payload-file"]);
+    if (payloadFile) {
+        return parsePayloadText(await readFile(payloadFile, "utf8"), "--payload-file");
+    }
+    if (parsed.flags["payload-stdin"] === true) {
+        return parsePayloadText(await readStdin(), "--payload-stdin");
+    }
+    const input = resolveString(parsed.flags.input) ?? parsed.positionals.slice(1).join(" ");
+    return { text: input };
+};
+const resolveIncludeDisabled = (parsed) => parsed.flags["enabled-only"] === true ? false : true;
+export class WorkersCommands {
+    static async run(argv) {
+        const [rawSubcommand, ...rest] = argv;
+        if (!rawSubcommand || argv.includes("--help") || argv.includes("-h")) {
+            // eslint-disable-next-line no-console
+            console.log(USAGE);
+            return;
+        }
+        const subcommand = rawSubcommand === "detail" || rawSubcommand === "show" ? "details" : rawSubcommand;
+        const parsed = parseArgs(rest);
+        const api = await MswarmApi.create({
+            baseUrl: resolveString(parsed.flags["base-url"]),
+            apiKey: resolveString(parsed.flags["api-key"]),
+            timeoutMs: resolvePositiveInt(parsed.flags["timeout-ms"], "--timeout-ms"),
+            workerAgentSlugPrefix: resolveString(parsed.flags["agent-slug-prefix"]),
+        });
+        try {
+            switch (subcommand) {
+                case "list": {
+                    const workers = await api.listAllWorkers({
+                        limit: resolvePositiveInt(parsed.flags.limit, "--limit"),
+                        includeDisabled: resolveIncludeDisabled(parsed),
+                    });
+                    if (parsed.flags.json) {
+                        // eslint-disable-next-line no-console
+                        console.log(JSON.stringify(workers, null, 2));
+                    }
+                    else {
+                        printWorkerList(workers);
+                    }
+                    break;
+                }
+                case "details": {
+                    const slug = parsed.positionals[0];
+                    if (!slug)
+                        throw new Error("Usage: mcoda workers details <SLUG> [--json]");
+                    const worker = await api.getWorker(slug);
+                    if (parsed.flags.json) {
+                        // eslint-disable-next-line no-console
+                        console.log(JSON.stringify(worker, null, 2));
+                    }
+                    else {
+                        printWorkerDetails(worker);
+                    }
+                    break;
+                }
+                case "sync": {
+                    const summary = await api.syncWorkers({
+                        limit: resolvePositiveInt(parsed.flags.limit, "--limit"),
+                        includeDisabled: resolveIncludeDisabled(parsed),
+                        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;
+                }
+                case "run": {
+                    const slug = parsed.positionals[0];
+                    if (!slug)
+                        throw new Error("Usage: mcoda workers run <SLUG> [TEXT...]");
+                    const result = await api.runWorker(slug, await resolveRunPayload(parsed), { idempotencyKey: resolveString(parsed.flags["idempotency-key"]) });
+                    if (parsed.flags.json) {
+                        // eslint-disable-next-line no-console
+                        console.log(JSON.stringify(result, null, 2));
+                    }
+                    else {
+                        const output = typeof result.output === "string"
+                            ? result.output
+                            : typeof result.result?.output === "string"
+                                ? String(result.result.output)
+                                : JSON.stringify(result, null, 2);
+                        // eslint-disable-next-line no-console
+                        console.log(output);
+                    }
+                    break;
+                }
+                default:
+                    throw new Error(`Unknown workers subcommand: ${subcommand}`);
+            }
+        }
+        finally {
+            await api.close();
+        }
+    }
+}

package/dist/index.d.ts

@@ -2,6 +2,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/workers/WorkersCommands.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,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"}
+{"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,uCAAuC,CAAC;AACtD,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

@@ -2,6 +2,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/workers/WorkersCommands.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.70",
+  "version": "0.1.72",
   "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.70",
-    "@mcoda/shared": "0.1.70"
+    "@mcoda/core": "0.1.72",
+    "@mcoda/shared": "0.1.72"
   },
   "devDependencies": {
-    "@mcoda/db": "0.1.70",
-    "@mcoda/integrations": "0.1.70"
+    "@mcoda/db": "0.1.72",
+    "@mcoda/integrations": "0.1.72"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",