swallowkit 1.0.0-beta.19 → 1.0.0-beta.20

package/dist/machine/errors.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MachineCommandError = void 0;
+exports.toMachineError = toMachineError;
+class MachineCommandError extends Error {
+    constructor(code, message, details) {
+        super(message);
+        this.name = "MachineCommandError";
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.MachineCommandError = MachineCommandError;
+function toMachineError(error) {
+    if (error instanceof MachineCommandError) {
+        return {
+            code: error.code,
+            message: error.message,
+            ...(error.details === undefined ? {} : { details: error.details }),
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            code: "internal-error",
+            message: error.message,
+        };
+    }
+    return {
+        code: "internal-error",
+        message: "Unknown error",
+        details: error,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/machine/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/machine/errors.ts"],"names":[],"mappings":";;;AAYA,wCAqBC;AAjCD,MAAa,mBAAoB,SAAQ,KAAK;IAI5C,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAVD,kDAUC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC"}

package/dist/machine/index.d.ts

@@ -0,0 +1,3 @@
+export declare function isMachineCommand(argv: string[]): boolean;
+export declare function runMachineCli(argv?: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/machine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/machine/index.ts"],"names":[],"mappings":"AAwJA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAExD;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhF"}

package/dist/machine/index.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMachineCommand = isMachineCommand;
+exports.runMachineCli = runMachineCli;
+const commander_1 = require("commander");
+const create_model_1 = require("../core/operations/create-model");
+const scaffold_machine_1 = require("../core/operations/scaffold-machine");
+const manifest_1 = require("../core/project/manifest");
+const validation_1 = require("../core/project/validation");
+const errors_1 = require("./errors");
+function writeMachineResponse(response) {
+    process.stdout.write(`${JSON.stringify(response, null, 2)}\n`);
+}
+function writeMachineSuccess(command, data) {
+    const response = {
+        ok: true,
+        command,
+        data,
+    };
+    writeMachineResponse(response);
+}
+function writeMachineError(command, error) {
+    const response = {
+        ok: false,
+        command,
+        error: (0, errors_1.toMachineError)(error),
+    };
+    writeMachineResponse(response);
+}
+async function handleMachineAction(command, action) {
+    try {
+        writeMachineSuccess(command, await action());
+    }
+    catch (error) {
+        writeMachineError(command, error);
+        process.exitCode = 1;
+    }
+}
+function createMachineProgram() {
+    const program = new commander_1.Command();
+    program
+        .name("swallowkit machine")
+        .description("SwallowKit machine-readable CLI for AI and MCP integrations")
+        .showHelpAfterError(false)
+        .configureOutput({
+        writeErr: () => undefined,
+        writeOut: () => undefined,
+    });
+    const inspect = new commander_1.Command("inspect");
+    inspect
+        .command("project")
+        .description("Inspect SwallowKit project metadata")
+        .action(async () => {
+        await handleMachineAction("inspect-project", async () => {
+            const loaded = await (0, manifest_1.loadProjectManifest)();
+            return {
+                manifestSource: loaded.source,
+                diagnostics: loaded.diagnostics,
+                manifest: loaded.manifest,
+            };
+        });
+    });
+    inspect
+        .command("entities")
+        .description("Inspect SwallowKit entities")
+        .action(async () => {
+        await handleMachineAction("inspect-entities", async () => {
+            const loaded = await (0, manifest_1.loadProjectManifest)();
+            return {
+                manifestSource: loaded.source,
+                diagnostics: loaded.diagnostics,
+                entities: loaded.manifest.entities,
+            };
+        });
+    });
+    inspect
+        .command("routes")
+        .description("Inspect SwallowKit routes")
+        .action(async () => {
+        await handleMachineAction("inspect-routes", async () => {
+            const loaded = await (0, manifest_1.loadProjectManifest)();
+            return {
+                manifestSource: loaded.source,
+                diagnostics: loaded.diagnostics,
+                routes: loaded.manifest.routes,
+            };
+        });
+    });
+    const validate = new commander_1.Command("validate");
+    validate
+        .command("project")
+        .description("Validate SwallowKit project metadata and conventions")
+        .action(async () => {
+        await handleMachineAction("validate-project", async () => (0, validation_1.validateProject)());
+    });
+    const generate = new commander_1.Command("generate");
+    generate
+        .command("model")
+        .description("Generate model templates with deterministic JSON output")
+        .argument("<names...>", "Model names to generate")
+        .option("--models-dir <dir>", "Models directory", "shared/models")
+        .option("--connector <name>", "Associate the models with a configured connector")
+        .option("--overwrite <mode>", "Overwrite policy: always | never", "never")
+        .action(async (names, options) => {
+        await handleMachineAction("generate-model", async () => {
+            if (options.overwrite !== "always" && options.overwrite !== "never") {
+                throw new errors_1.MachineCommandError("invalid-overwrite-mode", `Unsupported overwrite mode: ${options.overwrite}. Use "always" or "never".`);
+            }
+            return (0, create_model_1.createModelOperation)({
+                names,
+                modelsDir: options.modelsDir,
+                connector: options.connector,
+                overwriteMode: options.overwrite,
+            });
+        });
+    });
+    generate
+        .command("scaffold")
+        .description("Generate scaffold artifacts with deterministic JSON output")
+        .argument("<model>", "Model file or model name")
+        .option("--functions-dir <dir>", "Functions directory", "functions")
+        .option("--api-dir <dir>", "API routes directory", "app/api")
+        .option("--api-only", "Generate only API artifacts", false)
+        .action(async (model, options) => {
+        await handleMachineAction("generate-scaffold", async () => (0, scaffold_machine_1.runMachineScaffoldOperation)({
+            model,
+            functionsDir: options.functionsDir,
+            apiDir: options.apiDir,
+            apiOnly: options.apiOnly,
+        }));
+    });
+    program.addCommand(inspect);
+    program.addCommand(validate);
+    program.addCommand(generate);
+    return program;
+}
+function isMachineCommand(argv) {
+    return argv[2] === "machine";
+}
+async function runMachineCli(argv = process.argv) {
+    const program = createMachineProgram();
+    program.exitOverride();
+    try {
+        await program.parseAsync(argv.slice(3), { from: "user" });
+    }
+    catch (error) {
+        if (error instanceof commander_1.CommanderError) {
+            writeMachineError("machine-parse", new errors_1.MachineCommandError("invalid-command", error.message));
+            process.exitCode = Number.isFinite(error.exitCode) ? error.exitCode : 1;
+            return;
+        }
+        writeMachineError("machine-parse", error);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/machine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/machine/index.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
+import * as z from "zod/v4";
+type MachineCliRunner = (args: string[]) => Promise<{
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}>;
+type ToolContentResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+type ToolDefinition = {
+    name: string;
+    description: string;
+    inputSchema: z.ZodTypeAny;
+    handler: (input: any) => Promise<ToolContentResult>;
+};
+export declare function buildSwallowKitToolDefinitions(runMachineCli?: MachineCliRunner): ToolDefinition[];
+export declare function createSwallowKitMcpServer(runMachineCli?: MachineCliRunner): McpServer;
+export declare function runMcpServer(): Promise<void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEjE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAS5B,KAAK,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC1G,KAAK,iBAAiB,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAC5E,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC;IAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACrD,CAAC;AAkDF,wBAAgB,8BAA8B,CAC5C,aAAa,GAAE,gBAA0C,GACxD,cAAc,EAAE,CA8ElB;AAED,wBAAgB,yBAAyB,CAAC,aAAa,GAAE,gBAA0C,GAAG,SAAS,CAkB9G;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAIlD"}

package/dist/mcp/index.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSwallowKitToolDefinitions = buildSwallowKitToolDefinitions;
+exports.createSwallowKitMcpServer = createSwallowKitMcpServer;
+exports.runMcpServer = runMcpServer;
+const path = __importStar(require("path"));
+const mcp_1 = require("@modelcontextprotocol/sdk/server/mcp");
+const stdio_1 = require("@modelcontextprotocol/sdk/server/stdio");
+const z = __importStar(require("zod/v4"));
+function resolveMachineCliEntrypoint() {
+    return path.resolve(__dirname, "..", "cli", "index.js");
+}
+async function defaultMachineCliRunner(args) {
+    const { execa } = await Promise.resolve().then(() => __importStar(require("execa")));
+    const result = await execa(process.execPath, [resolveMachineCliEntrypoint(), "machine", ...args], {
+        reject: false,
+    });
+    return {
+        stdout: result.stdout,
+        stderr: result.stderr,
+        exitCode: result.exitCode ?? 0,
+    };
+}
+async function executeMachineCommand(args, runMachineCli) {
+    const result = await runMachineCli(args);
+    let parsed;
+    try {
+        parsed = JSON.parse(result.stdout);
+    }
+    catch {
+        throw new Error(result.stderr || result.stdout || "Machine CLI returned invalid JSON.");
+    }
+    if (!parsed.ok) {
+        throw new Error(parsed.error.message);
+    }
+    return parsed;
+}
+function jsonTextContent(value) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+function buildSwallowKitToolDefinitions(runMachineCli = defaultMachineCliRunner) {
+    return [
+        {
+            name: "swallowkit_inspect_project",
+            description: "Return framework-owned SwallowKit project metadata.",
+            inputSchema: z.object({}),
+            handler: async () => {
+                const response = await executeMachineCommand(["inspect", "project"], runMachineCli);
+                return jsonTextContent(response.data);
+            },
+        },
+        {
+            name: "swallowkit_inspect_entities",
+            description: "Return SwallowKit entities, schema metadata, and connector/auth annotations.",
+            inputSchema: z.object({}),
+            handler: async () => {
+                const response = await executeMachineCommand(["inspect", "entities"], runMachineCli);
+                return jsonTextContent(response.data);
+            },
+        },
+        {
+            name: "swallowkit_inspect_routes",
+            description: "Return BFF and Functions route metadata understood by SwallowKit.",
+            inputSchema: z.object({}),
+            handler: async () => {
+                const response = await executeMachineCommand(["inspect", "routes"], runMachineCli);
+                return jsonTextContent(response.data);
+            },
+        },
+        {
+            name: "swallowkit_validate_project",
+            description: "Validate project metadata, generated artifacts, and framework conventions.",
+            inputSchema: z.object({}),
+            handler: async () => {
+                const response = await executeMachineCommand(["validate", "project"], runMachineCli);
+                return jsonTextContent(response.data);
+            },
+        },
+        {
+            name: "swallowkit_generate_model",
+            description: "Generate SwallowKit model templates through the official generator.",
+            inputSchema: z.object({
+                names: z.array(z.string()).min(1),
+                modelsDir: z.string().optional(),
+                connector: z.string().optional(),
+                overwrite: z.enum(["always", "never"]).optional(),
+            }),
+            handler: async ({ names, modelsDir, connector, overwrite }) => {
+                const response = await executeMachineCommand(["generate", "model", ...names, ...(modelsDir ? ["--models-dir", modelsDir] : []), ...(connector ? ["--connector", connector] : []), "--overwrite", overwrite || "never"], runMachineCli);
+                return jsonTextContent(response.data);
+            },
+        },
+        {
+            name: "swallowkit_scaffold_model",
+            description: "Generate SwallowKit scaffold artifacts through the official generator.",
+            inputSchema: z.object({
+                model: z.string(),
+                functionsDir: z.string().optional(),
+                apiDir: z.string().optional(),
+                apiOnly: z.boolean().optional(),
+            }),
+            handler: async ({ model, functionsDir, apiDir, apiOnly }) => {
+                const args = ["generate", "scaffold", model];
+                if (functionsDir) {
+                    args.push("--functions-dir", functionsDir);
+                }
+                if (apiDir) {
+                    args.push("--api-dir", apiDir);
+                }
+                if (apiOnly) {
+                    args.push("--api-only");
+                }
+                const response = await executeMachineCommand(args, runMachineCli);
+                return jsonTextContent(response.data);
+            },
+        },
+    ];
+}
+function createSwallowKitMcpServer(runMachineCli = defaultMachineCliRunner) {
+    const server = new mcp_1.McpServer({
+        name: "swallowkit-mcp",
+        version: process.env.npm_package_version || "0.0.0",
+    });
+    for (const tool of buildSwallowKitToolDefinitions(runMachineCli)) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }, tool.handler);
+    }
+    return server;
+}
+async function runMcpServer() {
+    const server = createSwallowKitMcpServer();
+    const transport = new stdio_1.StdioServerTransport();
+    await server.connect(transport);
+}
+if (require.main === module) {
+    void runMcpServer().catch((error) => {
+        console.error(error);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "swallowkit",
-  "version": "1.0.0-beta.19",
+  "version": "1.0.0-beta.20",
   "description": "Type-safe schema-driven development toolkit for Next.js applications on Azure",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "swallowkit": "dist/cli/index.js"
+    "swallowkit": "dist/cli/index.js",
+    "swallowkit-mcp": "dist/mcp/index.js"
   },
   "files": [
     "dist",
@@ -35,14 +36,15 @@
   "license": "MIT",
   "dependencies": {
     "@azure/cosmos": "^4.9.2",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^11.0.0",
     "cors": "^2.8.5",
     "execa": "^8.0.1",
     "express": "^4.18.0",
+    "jsonwebtoken": "^9.0.0",
     "prompts": "^2.4.2",
     "tsx": "^4.7.0",
-    "zod": "^3.25.76",
-    "jsonwebtoken": "^9.0.0"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/cors": "^2.8.0",