mcp4openapi 0.1.0

package/dist/schema-validator.js

@@ -0,0 +1,126 @@
+/**
+ * Request body schema validator
+ *
+ * Why: Catch invalid requests before sending to API. Better error messages for users.
+ * Validates against OpenAPI schema definitions.
+ */
+export class SchemaValidator {
+    /**
+     * Validate request body against OpenAPI schema
+     *
+     * Why: Prevents sending malformed requests. OpenAPI schema is the source of truth.
+     */
+    validateRequestBody(operation, body) {
+        if (!operation.requestBody?.content['application/json']?.schema) {
+            return { valid: true };
+        }
+        const schema = operation.requestBody.content['application/json'].schema;
+        const errors = [];
+        this.validateAgainstSchema(body, schema, '', errors);
+        return {
+            valid: errors.length === 0,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    /**
+     * Recursively validate data against schema
+     */
+    validateAgainstSchema(data, schema, path, errors) {
+        // Null/undefined handling
+        if (data === null || data === undefined) {
+            if (schema.type && schema.type !== 'null') {
+                errors.push({
+                    path: path || '(root)',
+                    message: `Expected ${schema.type}, got ${data}`,
+                    schema,
+                    value: data,
+                });
+            }
+            return;
+        }
+        // Type validation
+        if (schema.type) {
+            const actualType = Array.isArray(data) ? 'array' : typeof data;
+            if (actualType !== schema.type) {
+                errors.push({
+                    path: path || '(root)',
+                    message: `Expected ${schema.type}, got ${actualType}`,
+                    schema,
+                    value: data,
+                });
+                return; // Stop validation if type is wrong
+            }
+        }
+        // Enum validation
+        // Note: Using 'as any' here is safe - we're checking if value exists in enum array
+        // TypeScript doesn't know the enum values at compile time
+        if (schema.enum && !schema.enum.includes(data)) {
+            errors.push({
+                path: path || '(root)',
+                message: `Value must be one of: ${schema.enum.join(', ')}`,
+                schema,
+                value: data,
+            });
+        }
+        // Object properties validation
+        if (schema.type === 'object' && schema.properties) {
+            const obj = data;
+            // Check required properties
+            for (const required of schema.required || []) {
+                if (obj[required] === undefined) {
+                    errors.push({
+                        path: path ? `${path}.${required}` : required,
+                        message: 'Required property is missing',
+                        schema,
+                        value: undefined,
+                    });
+                }
+            }
+            // Validate each property
+            for (const [key, value] of Object.entries(obj)) {
+                if (schema.properties[key]) {
+                    this.validateAgainstSchema(value, schema.properties[key], path ? `${path}.${key}` : key, errors);
+                }
+                // Note: Not validating additionalProperties (too strict for most APIs)
+            }
+        }
+        // Array items validation
+        if (schema.type === 'array' && schema.items && Array.isArray(data)) {
+            data.forEach((item, index) => {
+                this.validateAgainstSchema(item, schema.items, `${path}[${index}]`, errors);
+            });
+        }
+        // String format validation (basic)
+        if (schema.type === 'string' && schema.format && typeof data === 'string') {
+            if (schema.format === 'email' && !this.isEmail(data)) {
+                errors.push({
+                    path: path || '(root)',
+                    message: 'Invalid email format',
+                    schema,
+                    value: data,
+                });
+            }
+            if (schema.format === 'uri' && !this.isUri(data)) {
+                errors.push({
+                    path: path || '(root)',
+                    message: 'Invalid URI format',
+                    schema,
+                    value: data,
+                });
+            }
+        }
+    }
+    isEmail(value) {
+        return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
+    }
+    isUri(value) {
+        try {
+            new URL(value);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/schema-validator.js.map

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

package/dist/scripts/validate-profile.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Profile validation script
+ *
+ * Why: Validates profile JSON against schema and checks logical consistency
+ * without requiring API access or tokens.
+ */
+export {};
+//# sourceMappingURL=validate-profile.d.ts.map

package/dist/scripts/validate-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-profile.d.ts","sourceRoot":"","sources":["../../scripts/validate-profile.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/scripts/validate-profile.js

@@ -0,0 +1,289 @@
+#!/usr/bin/env node
+/**
+ * Profile validation script
+ *
+ * Why: Validates profile JSON against schema and checks logical consistency
+ * without requiring API access or tokens.
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { ProfileLoader } from '../dist/profile-loader.js';
+import { OpenAPIParser } from '../dist/openapi-parser.js';
+import { ToolGenerator } from '../dist/tool-generator.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+async function validateProfile(profilePath, specPath) {
+    const result = {
+        valid: true,
+        errors: [],
+        warnings: [],
+        info: {},
+    };
+    try {
+        // 1. Check if profile file exists
+        try {
+            await fs.access(profilePath);
+        }
+        catch {
+            result.valid = false;
+            result.errors.push(`Profile file not found: ${profilePath}`);
+            return result;
+        }
+        // 2. Check if it's valid JSON
+        let profileContent;
+        try {
+            profileContent = await fs.readFile(profilePath, 'utf-8');
+            JSON.parse(profileContent);
+        }
+        catch (e) {
+            result.valid = false;
+            result.errors.push(`Invalid JSON: ${e.message}`);
+            return result;
+        }
+        // 3. Validate against schema using ProfileLoader
+        const loader = new ProfileLoader();
+        let profile;
+        try {
+            profile = await loader.load(profilePath);
+            result.info.profileName = profile.profile_name;
+            result.info.toolCount = profile.tools.length;
+            result.info.hasInterceptors = !!profile.interceptors;
+        }
+        catch (e) {
+            result.valid = false;
+            result.errors.push(`Schema validation failed: ${e.message}`);
+            return result;
+        }
+        // 4. Check for common issues
+        // Check for duplicate tool names
+        const toolNames = new Set();
+        for (const tool of profile.tools) {
+            if (toolNames.has(tool.name)) {
+                result.valid = false;
+                result.errors.push(`Duplicate tool name: ${tool.name}`);
+            }
+            toolNames.add(tool.name);
+        }
+        // Check for missing action parameter in non-composite tools
+        for (const tool of profile.tools) {
+            if (!tool.composite && tool.operations) {
+                const actionCount = Object.keys(tool.operations).length;
+                if (actionCount > 1 && !tool.parameters.action) {
+                    result.warnings.push(`Tool '${tool.name}' has ${actionCount} operations but no 'action' parameter`);
+                }
+            }
+        }
+        // Check for metadata_params that don't exist in parameters
+        for (const tool of profile.tools) {
+            if (tool.metadata_params) {
+                for (const metaParam of tool.metadata_params) {
+                    if (!tool.parameters[metaParam]) {
+                        result.warnings.push(`Tool '${tool.name}': metadata_param '${metaParam}' not found in parameters`);
+                    }
+                }
+            }
+        }
+        // Check for required_for references to non-existent actions
+        for (const tool of profile.tools) {
+            if (!tool.operations)
+                continue;
+            // Extract valid actions from operation keys
+            // Supports patterns: "action", "action_suffix", "prefix_action"
+            const validActions = new Set();
+            for (const opKey of Object.keys(tool.operations)) {
+                validActions.add(opKey); // Add full key (e.g., "list_project")
+                // Extract parts: "approve_project" → ["approve", "project"]
+                const parts = opKey.split('_');
+                for (let i = 1; i <= parts.length; i++) {
+                    // Add combinations: "approve", "approve_project"
+                    validActions.add(parts.slice(0, i).join('_'));
+                }
+            }
+            for (const [paramName, param] of Object.entries(tool.parameters)) {
+                if (param.required_for) {
+                    for (const action of param.required_for) {
+                        if (!validActions.has(action)) {
+                            result.warnings.push(`Tool '${tool.name}', param '${paramName}': required_for '${action}' not found in operations: ${Object.keys(tool.operations).join(', ')}`);
+                        }
+                    }
+                }
+            }
+        }
+        // 5. If OpenAPI spec provided, validate operations exist
+        if (specPath) {
+            try {
+                await fs.access(specPath);
+                const parser = new OpenAPIParser();
+                await parser.load(specPath);
+                let operationCount = 0;
+                const missingOps = [];
+                for (const tool of profile.tools) {
+                    if (tool.operations) {
+                        for (const [action, operationId] of Object.entries(tool.operations)) {
+                            operationCount++;
+                            try {
+                                parser.getOperation(operationId);
+                            }
+                            catch {
+                                missingOps.push(`${tool.name}.${action} → ${operationId}`);
+                            }
+                        }
+                    }
+                    if (tool.steps) {
+                        for (const step of tool.steps) {
+                            operationCount++;
+                            try {
+                                parser.getOperation(step.call);
+                            }
+                            catch {
+                                missingOps.push(`${tool.name} step → ${step.call}`);
+                            }
+                        }
+                    }
+                }
+                result.info.operations = operationCount;
+                if (missingOps.length > 0) {
+                    result.valid = false;
+                    result.errors.push(`Missing operations in OpenAPI spec:\n  - ${missingOps.join('\n  - ')}`);
+                }
+            }
+            catch (e) {
+                result.warnings.push(`Could not validate against OpenAPI spec: ${e.message}`);
+            }
+        }
+        else {
+            result.warnings.push('OpenAPI spec not provided, skipping operation validation');
+        }
+        // 6. Validate tool generation (smoke test)
+        if (specPath) {
+            try {
+                const parser = new OpenAPIParser();
+                await parser.load(specPath);
+                const generator = new ToolGenerator(parser);
+                for (const toolDef of profile.tools) {
+                    try {
+                        generator.generateTool(toolDef);
+                    }
+                    catch (e) {
+                        result.warnings.push(`Tool generation failed for '${toolDef.name}': ${e.message}`);
+                    }
+                }
+            }
+            catch {
+                // Already handled above
+            }
+        }
+        // 7. Check for best practices
+        // Warn if too many tools (context pollution)
+        if (profile.tools.length > 20) {
+            result.warnings.push(`Profile has ${profile.tools.length} tools. Consider aggregating related operations to reduce LLM context pollution.`);
+        }
+        // Warn if no interceptors (likely needs auth)
+        if (!profile.interceptors || !profile.interceptors.auth) {
+            result.warnings.push('No authentication configured. Most APIs require authentication.');
+        }
+    }
+    catch (e) {
+        result.valid = false;
+        result.errors.push(`Unexpected error: ${e.message}`);
+    }
+    return result;
+}
+function printResult(result) {
+    console.log('');
+    console.log('═══════════════════════════════════════════════════');
+    console.log('  PROFILE VALIDATION RESULTS');
+    console.log('═══════════════════════════════════════════════════');
+    console.log('');
+    // Info
+    if (result.info.profileName) {
+        console.log(`Profile: ${result.info.profileName}`);
+    }
+    if (result.info.toolCount !== undefined) {
+        console.log(`Tools: ${result.info.toolCount}`);
+    }
+    if (result.info.operations !== undefined) {
+        console.log(`Operations: ${result.info.operations}`);
+    }
+    if (result.info.hasInterceptors !== undefined) {
+        console.log(`Interceptors: ${result.info.hasInterceptors ? 'configured' : 'none'}`);
+    }
+    console.log('');
+    // Errors
+    if (result.errors.length > 0) {
+        console.log('❌ ERRORS:');
+        for (const error of result.errors) {
+            console.log(`  • ${error}`);
+        }
+        console.log('');
+    }
+    // Warnings
+    if (result.warnings.length > 0) {
+        console.log('⚠️  WARNINGS:');
+        for (const warning of result.warnings) {
+            console.log(`  • ${warning}`);
+        }
+        console.log('');
+    }
+    // Status
+    if (result.valid && result.errors.length === 0) {
+        if (result.warnings.length === 0) {
+            console.log('✅ VALID - No issues found');
+        }
+        else {
+            console.log('✅ VALID - Profile is valid but has warnings');
+        }
+    }
+    else {
+        console.log('❌ INVALID - Profile has errors');
+    }
+    console.log('');
+    console.log('═══════════════════════════════════════════════════');
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+        console.log(`
+Usage: npm run validate -- <profile.json> [openapi.yaml]
+
+Validates MCP profile configuration without requiring API access.
+
+Arguments:
+  <profile.json>    Path to profile file (required)
+  [openapi.yaml]    Path to OpenAPI spec (optional, enables operation validation)
+
+Options:
+  --help, -h        Show this help message
+
+Examples:
+  npm run validate -- profiles/my-api-profile.json
+  npm run validate -- profiles/my-api-profile.json openapi.yaml
+
+What is validated:
+  ✓ JSON syntax
+  ✓ Schema compliance (types, required fields, enums)
+  ✓ Logical consistency (required_for references, metadata_params)
+  ✓ No duplicate tool names
+  ✓ Operations exist in OpenAPI spec (if provided)
+  ✓ Tool generation (smoke test)
+  ✓ Best practices (tool count, auth configuration)
+`);
+        process.exit(0);
+    }
+    const profilePath = path.resolve(process.cwd(), args[0]);
+    const specPath = args[1] ? path.resolve(process.cwd(), args[1]) : undefined;
+    console.log('Validating profile...');
+    console.log(`Profile: ${profilePath}`);
+    if (specPath) {
+        console.log(`OpenAPI Spec: ${specPath}`);
+    }
+    const result = await validateProfile(profilePath, specPath);
+    printResult(result);
+    process.exit(result.valid ? 0 : 1);
+}
+main().catch((e) => {
+    console.error('Fatal error:', e);
+    process.exit(1);
+});
+//# sourceMappingURL=validate-profile.js.map

package/dist/scripts/validate-profile.js.map

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

package/dist/scripts/validate-schema.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Validates profile-schema.json against JSON Schema Draft-07 meta-schema
+ *
+ * Why: Ensures our schema is valid before users rely on it for validation
+ */
+declare function validateSchema(): Promise<void>;
+export { validateSchema };
+//# sourceMappingURL=validate-schema.d.ts.map

package/dist/scripts/validate-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-schema.d.ts","sourceRoot":"","sources":["../../scripts/validate-schema.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAWH,iBAAe,cAAc,kBAyE5B;AAOD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/scripts/validate-schema.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+/**
+ * Validates profile-schema.json against JSON Schema Draft-07 meta-schema
+ *
+ * Why: Ensures our schema is valid before users rely on it for validation
+ */
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+async function validateSchema() {
+    try {
+        // Read our profile schema (from project root)
+        const schemaPath = path.resolve(process.cwd(), 'profile-schema.json');
+        const schemaContent = await fs.readFile(schemaPath, 'utf-8');
+        const profileSchema = JSON.parse(schemaContent);
+        // Create Ajv instance with Draft-07 support
+        const ajv = new Ajv.default({
+            strict: true,
+            allErrors: true,
+            verbose: true,
+        });
+        // Add format validators (uri, etc.)
+        addFormats.default(ajv);
+        // Validate against meta-schema (Draft-07)
+        const validate = ajv.compile(ajv.getSchema('http://json-schema.org/draft-07/schema')?.schema || {});
+        const valid = validate(profileSchema);
+        console.log('');
+        console.log('═══════════════════════════════════════════════════');
+        console.log('  PROFILE SCHEMA VALIDATION');
+        console.log('═══════════════════════════════════════════════════');
+        console.log('');
+        console.log(`Schema: ${schemaPath}`);
+        console.log(`Meta-Schema: JSON Schema Draft-07`);
+        console.log('');
+        if (valid) {
+            console.log('✅ VALID - profile-schema.json is a valid JSON Schema');
+            console.log('');
+            // Test that it can compile
+            try {
+                ajv.compile(profileSchema);
+                console.log('✅ COMPILABLE - Schema can be used for validation');
+            }
+            catch (e) {
+                console.log('⚠️  WARNING - Schema is valid but may have compilation issues:');
+                console.log(`  ${e.message}`);
+            }
+            console.log('');
+            console.log('Schema Statistics:');
+            console.log(`  Definitions: ${Object.keys(profileSchema.definitions || {}).length}`);
+            console.log(`  Root properties: ${Object.keys(profileSchema.properties || {}).length}`);
+            console.log(`  Required fields: ${(profileSchema.required || []).length}`);
+        }
+        else {
+            console.log('❌ INVALID - profile-schema.json has errors:');
+            console.log('');
+            if (validate.errors) {
+                for (const error of validate.errors) {
+                    console.log(`  • ${error.instancePath || '/'}: ${error.message}`);
+                    if (error.params) {
+                        console.log(`    ${JSON.stringify(error.params)}`);
+                    }
+                }
+            }
+            console.log('');
+            process.exit(1);
+        }
+        console.log('');
+        console.log('═══════════════════════════════════════════════════');
+    }
+    catch (e) {
+        console.error('Fatal error:', e.message);
+        process.exit(1);
+    }
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    validateSchema();
+}
+export { validateSchema };
+//# sourceMappingURL=validate-schema.js.map

package/dist/scripts/validate-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-schema.js","sourceRoot":"","sources":["../../scripts/validate-schema.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC;QACH,8CAA8C;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,qBAAqB,CAAC,CAAC;QACtE,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAEhD,4CAA4C;QAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC;YAC1B,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,oCAAoC;QACpC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAExB,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,wCAAwC,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;QACpG,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;QAEtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;YACpE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEhB,2BAA2B;YAC3B,IAAI,CAAC;gBACH,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;YAClE,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;gBAC9E,OAAO,CAAC,GAAG,CAAC,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACrF,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACxF,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAE7E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEhB,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACpB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACpC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,YAAY,IAAI,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;oBAClE,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;wBACjB,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IAErE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,cAAc,EAAG,CAAW,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,yBAAyB;AACzB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,cAAc,EAAE,CAAC;AACnB,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/src/composite-executor.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Composite action executor for chaining API calls
+ *
+ * Why: Reduces roundtrips by fetching related data in sequence (e.g., MR + comments).
+ * Aggregates results into single JSON structure as defined by store_as paths.
+ */
+import type { CompositeStep } from './types/profile.js';
+import type { HttpClient } from './interceptors.js';
+import { OpenAPIParser } from './openapi-parser.js';
+export interface CompositeResult {
+    data: Record<string, unknown>;
+    completed_steps: number;
+    total_steps: number;
+    errors?: StepError[];
+}
+export interface StepError {
+    step_index: number;
+    step_call: string;
+    error: string;
+    timestamp: string;
+}
+export declare class CompositeExecutor {
+    private parser;
+    private httpClient?;
+    constructor(parser: OpenAPIParser, httpClient?: HttpClient | undefined);
+    /**
+     * Execute a series of API calls and merge results
+     *
+     * Why parallel: Steps may have dependencies, but independent steps can run concurrently.
+     * Uses DAG analysis to determine safe parallelization while maintaining correctness.
+     *
+     * Supports partial results: If allowPartial=true, continues after errors and returns
+     * what was completed. Useful for composite actions where some data is better than none.
+     */
+    execute(steps: CompositeStep[], args: Record<string, unknown>, allowPartial?: boolean, httpClient?: HttpClient): Promise<CompositeResult>;
+    /**
+     * Execute single composite step (extracted for parallel execution)
+     *
+     * @param step The composite step to execute
+     * @param stepIndex Original index for error reporting
+     * @param args Arguments for parameter substitution
+     * @param httpClient Optional HTTP client override
+     * @returns Promise resolving to HTTP response
+     */
+    private executeStep;
+    /**
+     * Parse composite step call syntax
+     *
+     * Format: "GET /projects/{id}/merge_requests/{iid}"
+     */
+    private parseCall;
+    /**
+     * Resolve path template with actual values
+     *
+     * Example: "/projects/{id}" + {id: "123"} => "/projects/123"
+     */
+    private resolvePath;
+    /**
+     * Extract query parameters from args based on operation definition
+     */
+    private extractQueryParams;
+    /**
+     * Store value at JSONPath-like location
+     *
+     * Why nested: Allows semantic structure (comments belong under merge_request object).
+     *
+     * Examples:
+     * - "merge_request" => { merge_request: value }
+     * - "merge_request.comments" => { merge_request: { comments: value } }
+     *
+     * Validates path navigation to prevent overwriting non-object values.
+     */
+    private storeResult;
+}
+//# sourceMappingURL=composite-executor.d.ts.map

package/dist/src/composite-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-executor.d.ts","sourceRoot":"","sources":["../../src/composite-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,UAAU,CAAC;gBADX,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,UAAU,YAAA;IAGjC;;;;;;;;OAQG;IACG,OAAO,CACX,KAAK,EAAE,aAAa,EAAE,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,GAAE,OAAe,EAC7B,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,eAAe,CAAC;IA+D3B;;;;;;;;OAQG;YACW,WAAW;IA6BzB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAQjB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;CAwBpB"}