usepaso 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path_1 = require("path");
+const fs_1 = require("fs");
+const parser_1 = require("./parser");
+const validator_1 = require("./validator");
+const mcp_1 = require("./generators/mcp");
+const program = new commander_1.Command();
+program
+    .name('usepaso')
+    .description('Make your API agent-ready in minutes')
+    .version('0.1.0');
+program
+    .command('init')
+    .description('Create a paso.yaml template in the current directory')
+    .option('-n, --name <name>', 'Service name')
+    .action((opts) => {
+    const outPath = (0, path_1.resolve)('paso.yaml');
+    if ((0, fs_1.existsSync)(outPath)) {
+        console.error('paso.yaml already exists in this directory.');
+        process.exit(1);
+    }
+    const name = opts.name || 'MyService';
+    const template = `version: "1.0"
+
+service:
+  name: ${name}
+  description: TODO — describe what your service does
+  base_url: https://api.example.com
+  auth:
+    type: bearer
+
+capabilities:
+  - name: example_action
+    description: TODO — describe what this action does
+    method: GET
+    path: /example
+    permission: read
+    inputs:
+      id:
+        type: string
+        required: true
+        description: TODO — describe this parameter
+        in: query
+    output:
+      result:
+        type: string
+        description: TODO — describe the output
+
+permissions:
+  read:
+    - example_action
+`;
+    (0, fs_1.writeFileSync)(outPath, template, 'utf-8');
+    console.log(`Created paso.yaml for "${name}"`);
+    console.log('Edit the file to declare your API capabilities, then run: usepaso serve');
+});
+program
+    .command('validate')
+    .description('Validate a paso.yaml file')
+    .option('-f, --file <path>', 'Path to paso.yaml', 'paso.yaml')
+    .action((opts) => {
+    const filePath = (0, path_1.resolve)(opts.file);
+    if (!(0, fs_1.existsSync)(filePath)) {
+        console.error(`File not found: ${filePath}`);
+        process.exit(1);
+    }
+    try {
+        const decl = (0, parser_1.parseFile)(filePath);
+        const errors = (0, validator_1.validate)(decl);
+        if (errors.length === 0) {
+            console.log(`${filePath} is valid.`);
+            console.log(`Service: ${decl.service.name}`);
+            console.log(`Capabilities: ${decl.capabilities.length}`);
+        }
+        else {
+            console.error(`Found ${errors.length} error(s):`);
+            for (const err of errors) {
+                console.error(`  ${err.path}: ${err.message}`);
+            }
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(`Failed to parse: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+});
+program
+    .command('serve')
+    .description('Start an MCP server from a paso.yaml declaration')
+    .option('-f, --file <path>', 'Path to paso.yaml', 'paso.yaml')
+    .action(async (opts) => {
+    const filePath = (0, path_1.resolve)(opts.file);
+    if (!(0, fs_1.existsSync)(filePath)) {
+        console.error(`File not found: ${filePath}`);
+        process.exit(1);
+    }
+    try {
+        const decl = (0, parser_1.parseFile)(filePath);
+        const errors = (0, validator_1.validate)(decl);
+        if (errors.length > 0) {
+            console.error(`Validation failed with ${errors.length} error(s):`);
+            for (const err of errors) {
+                console.error(`  ${err.path}: ${err.message}`);
+            }
+            process.exit(1);
+        }
+        console.error(`Paso MCP server starting for "${decl.service.name}"...`);
+        console.error(`Capabilities: ${decl.capabilities.length}`);
+        console.error('Transport: stdio');
+        console.error('Waiting for MCP client connection...');
+        await (0, mcp_1.serveMcp)(decl);
+    }
+    catch (err) {
+        console.error(`Failed to start: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,+BAAqC;AACrC,2BAA+C;AAC/C,qCAAqC;AACrC,2CAAuC;AACvC,0CAA4C;AAE5C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,sCAAsC,CAAC;KACnD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,sDAAsD,CAAC;KACnE,MAAM,CAAC,mBAAmB,EAAE,cAAc,CAAC;KAC3C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;IACf,MAAM,OAAO,GAAG,IAAA,cAAO,EAAC,WAAW,CAAC,CAAC;IACrC,IAAI,IAAA,eAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;IACtC,MAAM,QAAQ,GAAG;;;UAGX,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bb,CAAC;IAEE,IAAA,kBAAa,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC;AACzF,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,2BAA2B,CAAC;KACxC,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,CAAC;KAC7D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;IACf,MAAM,QAAQ,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAA,kBAAS,EAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAC;QAE9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,YAAY,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;YAClD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,CAAC;KAC7D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,QAAQ,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAA,kBAAS,EAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAC;QAE9B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,0BAA0B,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;YACnE,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,iCAAiC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,CAAC;QACxE,OAAO,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAEtD,MAAM,IAAA,cAAQ,EAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/generators/mcp.d.ts

@@ -0,0 +1,12 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { PasoDeclaration } from '../types';
+/**
+ * Generate and return an McpServer from a Paso declaration.
+ * Each capability becomes an MCP tool.
+ */
+export declare function generateMcpServer(decl: PasoDeclaration): McpServer;
+/**
+ * Start the MCP server on stdio transport.
+ */
+export declare function serveMcp(decl: PasoDeclaration): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/generators/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,eAAe,EAA6B,MAAM,UAAU,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,CA0BlE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAInE"}

package/dist/generators/mcp.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMcpServer = generateMcpServer;
+exports.serveMcp = serveMcp;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+/**
+ * Generate and return an McpServer from a Paso declaration.
+ * Each capability becomes an MCP tool.
+ */
+function generateMcpServer(decl) {
+    const server = new mcp_js_1.McpServer({
+        name: decl.service.name,
+        version: decl.service.version || '1.0.0',
+    });
+    const forbidden = new Set(decl.permissions?.forbidden || []);
+    for (const cap of decl.capabilities) {
+        if (forbidden.has(cap.name))
+            continue;
+        const inputSchema = buildZodSchema(cap);
+        const description = buildToolDescription(cap, decl);
+        if (inputSchema) {
+            server.tool(cap.name, description, inputSchema, async (args) => {
+                return await executeCapability(cap, args, decl);
+            });
+        }
+        else {
+            server.tool(cap.name, description, async () => {
+                return await executeCapability(cap, {}, decl);
+            });
+        }
+    }
+    return server;
+}
+/**
+ * Start the MCP server on stdio transport.
+ */
+async function serveMcp(decl) {
+    const server = generateMcpServer(decl);
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+/**
+ * Build a Zod schema from a capability's inputs.
+ * Returns undefined if the capability has no inputs.
+ */
+function buildZodSchema(cap) {
+    if (!cap.inputs || Object.keys(cap.inputs).length === 0)
+        return undefined;
+    const shape = {};
+    for (const [name, input] of Object.entries(cap.inputs)) {
+        let field = inputToZod(input);
+        if (!input.required) {
+            field = field.optional();
+        }
+        if (input.description) {
+            field = field.describe(input.description);
+        }
+        shape[name] = field;
+    }
+    return shape;
+}
+/**
+ * Convert a PasoInput to a Zod type.
+ */
+function inputToZod(input) {
+    switch (input.type) {
+        case 'string':
+            return zod_1.z.string();
+        case 'integer':
+            return zod_1.z.number().int();
+        case 'number':
+            return zod_1.z.number();
+        case 'boolean':
+            return zod_1.z.boolean();
+        case 'enum':
+            if (input.values && input.values.length > 0) {
+                const vals = input.values.map(v => String(v));
+                return zod_1.z.enum(vals);
+            }
+            return zod_1.z.string();
+        case 'array':
+            return zod_1.z.array(zod_1.z.unknown());
+        case 'object':
+            return zod_1.z.record(zod_1.z.string(), zod_1.z.unknown());
+        default:
+            return zod_1.z.unknown();
+    }
+}
+/**
+ * Build a rich tool description from the capability and service info.
+ */
+function buildToolDescription(cap, decl) {
+    let desc = cap.description;
+    if (cap.consent_required) {
+        desc += '\n\n⚠️ REQUIRES USER CONSENT: You must confirm this action with the user before executing.';
+    }
+    if (cap.constraints && cap.constraints.length > 0) {
+        desc += '\n\nConstraints:';
+        for (const c of cap.constraints) {
+            if (c.description)
+                desc += `\n- ${c.description}`;
+            if (c.max_per_hour)
+                desc += `\n- Rate limit: ${c.max_per_hour}/hour`;
+            if (c.max_value)
+                desc += `\n- Max value: ${c.max_value}`;
+            if (c.max_per_request)
+                desc += `\n- Max per request: ${c.max_per_request}`;
+        }
+    }
+    return desc;
+}
+/**
+ * Execute a capability by making the actual HTTP request to the service.
+ */
+async function executeCapability(cap, args, decl) {
+    // Build the URL
+    let path = cap.path;
+    const queryParams = {};
+    const bodyParams = {};
+    if (cap.inputs) {
+        for (const [name, input] of Object.entries(cap.inputs)) {
+            const value = args[name];
+            if (value === undefined)
+                continue;
+            const location = input.in || (['POST', 'PUT', 'PATCH'].includes(cap.method) ? 'body' : 'query');
+            switch (location) {
+                case 'path':
+                    path = path.replace(`{${name}}`, encodeURIComponent(String(value)));
+                    break;
+                case 'query':
+                    queryParams[name] = String(value);
+                    break;
+                case 'header':
+                    // Headers handled separately
+                    break;
+                case 'body':
+                default:
+                    bodyParams[name] = value;
+                    break;
+            }
+        }
+    }
+    const url = new URL(path, decl.service.base_url);
+    for (const [k, v] of Object.entries(queryParams)) {
+        url.searchParams.set(k, v);
+    }
+    // Build headers
+    const headers = {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json',
+    };
+    if (decl.service.auth) {
+        // Auth token comes from environment variable: PASO_AUTH_TOKEN
+        const token = process.env.PASO_AUTH_TOKEN;
+        if (token) {
+            const authHeader = decl.service.auth.header || 'Authorization';
+            const prefix = decl.service.auth.prefix ?? (decl.service.auth.type === 'bearer' ? 'Bearer' : '');
+            headers[authHeader] = prefix ? `${prefix} ${token}` : token;
+        }
+    }
+    // Add any header-type inputs
+    if (cap.inputs) {
+        for (const [name, input] of Object.entries(cap.inputs)) {
+            if (input.in === 'header' && args[name] !== undefined) {
+                headers[name] = String(args[name]);
+            }
+        }
+    }
+    try {
+        const fetchOptions = {
+            method: cap.method,
+            headers,
+        };
+        if (['POST', 'PUT', 'PATCH'].includes(cap.method) && Object.keys(bodyParams).length > 0) {
+            fetchOptions.body = JSON.stringify(bodyParams);
+        }
+        const response = await fetch(url.toString(), fetchOptions);
+        const text = await response.text();
+        let result;
+        try {
+            const json = JSON.parse(text);
+            result = JSON.stringify(json, null, 2);
+        }
+        catch {
+            result = text;
+        }
+        if (!response.ok) {
+            return {
+                content: [{ type: 'text', text: `Error ${response.status}: ${result}` }],
+            };
+        }
+        return {
+            content: [{ type: 'text', text: result }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Request failed: ${error instanceof Error ? error.message : String(error)}` }],
+        };
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/generators/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/generators/mcp.ts"],"names":[],"mappings":";;AASA,8CA0BC;AAKD,4BAIC;AA5CD,oEAAoE;AACpE,wEAAiF;AACjF,6BAAwB;AAGxB;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,IAAqB;IACrD,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO;KACzC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IAE7D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAEtC,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEpD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC7D,OAAO,MAAM,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE;gBAC5C,OAAO,MAAM,iBAAiB,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,QAAQ,CAAC,IAAqB;IAClD,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,GAAmB;IACzC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE1E,MAAM,KAAK,GAAiC,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAE9B,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,KAAgB;IAClC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,OAAC,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;QAC1B,KAAK,QAAQ;YACX,OAAO,OAAC,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,OAAC,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9C,OAAO,OAAC,CAAC,IAAI,CAAC,IAA6B,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,OAAC,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C;YACE,OAAO,OAAC,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,GAAmB,EAAE,IAAqB;IACtE,IAAI,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC;IAE3B,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACzB,IAAI,IAAI,4FAA4F,CAAC;IACvG,CAAC;IAED,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,IAAI,kBAAkB,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,WAAW;gBAAE,IAAI,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;YAClD,IAAI,CAAC,CAAC,YAAY;gBAAE,IAAI,IAAI,mBAAmB,CAAC,CAAC,YAAY,OAAO,CAAC;YACrE,IAAI,CAAC,CAAC,SAAS;gBAAE,IAAI,IAAI,kBAAkB,CAAC,CAAC,SAAS,EAAE,CAAC;YACzD,IAAI,CAAC,CAAC,eAAe;gBAAE,IAAI,IAAI,wBAAwB,CAAC,CAAC,eAAe,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAC9B,GAAmB,EACnB,IAA6B,EAC7B,IAAqB;IAErB,gBAAgB;IAChB,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACpB,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAElC,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,IAAI,CAC3B,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CACjE,CAAC;YAEF,QAAQ,QAAQ,EAAE,CAAC;gBACjB,KAAK,MAAM;oBACT,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACpE,MAAM;gBACR,KAAK,OAAO;oBACV,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;oBAClC,MAAM;gBACR,KAAK,QAAQ;oBACX,6BAA6B;oBAC7B,MAAM;gBACR,KAAK,MAAM,CAAC;gBACZ;oBACE,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;oBACzB,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,gBAAgB;IAChB,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,QAAQ,EAAE,kBAAkB;KAC7B,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,8DAA8D;QAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC;YAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjG,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,YAAY,GAAgB;YAChC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO;SACR,CAAC;QAEF,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxF,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,YAAY,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,EAAE,CAAC;aACzE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;SAC/G,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { parseFile, parseString } from './parser';
+export { validate } from './validator';
+export { generateMcpServer } from './generators/mcp';
+export type { PasoDeclaration, PasoService, PasoAuth, PasoCapability, PasoInput, PasoOutput, PasoConstraint, PasoPermissions, ValidationError, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,cAAc,EACd,SAAS,EACT,UAAU,EACV,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMcpServer = exports.validate = exports.parseString = exports.parseFile = void 0;
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parseFile", { enumerable: true, get: function () { return parser_1.parseFile; } });
+Object.defineProperty(exports, "parseString", { enumerable: true, get: function () { return parser_1.parseString; } });
+var validator_1 = require("./validator");
+Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return validator_1.validate; } });
+var mcp_1 = require("./generators/mcp");
+Object.defineProperty(exports, "generateMcpServer", { enumerable: true, get: function () { return mcp_1.generateMcpServer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAkD;AAAzC,mGAAA,SAAS,OAAA;AAAE,qGAAA,WAAW,OAAA;AAC/B,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,wCAAqD;AAA5C,wGAAA,iBAAiB,OAAA"}

package/dist/parser.d.ts

@@ -0,0 +1,11 @@
+import { PasoDeclaration } from './types';
+/**
+ * Parse a paso.yaml file from disk and return the raw declaration object.
+ * Does NOT validate — call validate() separately.
+ */
+export declare function parseFile(filePath: string): PasoDeclaration;
+/**
+ * Parse a YAML string into a PasoDeclaration.
+ */
+export declare function parseString(content: string): PasoDeclaration;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAG3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAM5D"}

package/dist/parser.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFile = parseFile;
+exports.parseString = parseString;
+const fs_1 = require("fs");
+const yaml_1 = require("yaml");
+/**
+ * Parse a paso.yaml file from disk and return the raw declaration object.
+ * Does NOT validate — call validate() separately.
+ */
+function parseFile(filePath) {
+    const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+    return parseString(content);
+}
+/**
+ * Parse a YAML string into a PasoDeclaration.
+ */
+function parseString(content) {
+    const parsed = (0, yaml_1.parse)(content);
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error('Invalid YAML: expected an object');
+    }
+    return parsed;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":";;AAQA,8BAGC;AAKD,kCAMC;AAtBD,2BAAkC;AAClC,+BAA0C;AAG1C;;;GAGG;AACH,SAAgB,SAAS,CAAC,QAAgB;IACxC,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,OAAe;IACzC,MAAM,MAAM,GAAG,IAAA,YAAS,EAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAyB,CAAC;AACnC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+export interface PasoDeclaration {
+    version: string;
+    service: PasoService;
+    capabilities: PasoCapability[];
+    permissions?: PasoPermissions;
+}
+export interface PasoService {
+    name: string;
+    description: string;
+    base_url: string;
+    version?: string;
+    auth?: PasoAuth;
+}
+export interface PasoAuth {
+    type: 'api_key' | 'bearer' | 'oauth2' | 'none';
+    header?: string;
+    prefix?: string;
+}
+export interface PasoCapability {
+    name: string;
+    description: string;
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    permission: 'read' | 'write' | 'admin';
+    consent_required?: boolean;
+    inputs?: Record<string, PasoInput>;
+    output?: Record<string, PasoOutput>;
+    constraints?: PasoConstraint[];
+}
+export interface PasoInput {
+    type: 'string' | 'integer' | 'number' | 'boolean' | 'enum' | 'array' | 'object';
+    required?: boolean;
+    description: string;
+    values?: (string | number)[];
+    default?: unknown;
+    in?: 'query' | 'path' | 'body' | 'header';
+}
+export interface PasoOutput {
+    type: 'string' | 'integer' | 'number' | 'boolean' | 'object' | 'array';
+    description?: string;
+}
+export interface PasoConstraint {
+    max_per_hour?: number;
+    max_per_request?: number;
+    max_value?: number;
+    allowed_values?: unknown[];
+    requires_field?: string;
+    description?: string;
+}
+export interface PasoPermissions {
+    read?: string[];
+    write?: string[];
+    admin?: string[];
+    forbidden?: string[];
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validator.d.ts

@@ -0,0 +1,7 @@
+import { PasoDeclaration, ValidationError } from './types';
+/**
+ * Validate a parsed PasoDeclaration against the spec.
+ * Returns an array of errors. Empty array = valid.
+ */
+export declare function validate(decl: PasoDeclaration): ValidationError[];
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,eAAe,EAAE,MAAM,SAAS,CAAC;AAU3E;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,EAAE,CAsFjE"}