fridayy 1.0.0

package/dist/adapters/nodejs/ast-scanner.js

@@ -0,0 +1,102 @@
+/**
+ * Fridayy - Node.js Route Scanner
+ * Scans JavaScript and TypeScript files for Express/Fastify/Koa route declarations.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+const ROUTE_PATTERN = /(?:app|router|fastify|server)\.(get|post|put|patch|delete|options|head)\s*\(\s*(['"`])([^'"`]+)\2/g;
+export class NodeJsScanner {
+    /**
+     * Scans a directory recursively for Express/Fastify routes.
+     */
+    async scanDirectory(rootDir, maxFiles = 200) {
+        const discovered = [];
+        const files = this.collectSourceFiles(rootDir, maxFiles);
+        for (const file of files) {
+            try {
+                const content = fs.readFileSync(file, 'utf-8');
+                const fileRoutes = this.scanFileContent(content, file);
+                discovered.push(...fileRoutes);
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+        return discovered;
+    }
+    scanFileContent(content, filePath) {
+        const routes = [];
+        const lines = content.split('\n');
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const line = lines[lineIndex];
+            ROUTE_PATTERN.lastIndex = 0;
+            let match;
+            while ((match = ROUTE_PATTERN.exec(line)) !== null) {
+                const method = match[1].toUpperCase();
+                const routePath = match[3];
+                // Extract comment from previous lines
+                let comment;
+                if (lineIndex > 0) {
+                    const prevLine = lines[lineIndex - 1].trim();
+                    if (prevLine.startsWith('//')) {
+                        comment = prevLine.replace(/^\/\/\s*/, '');
+                    }
+                    else if (prevLine.endsWith('*/')) {
+                        // Find start of JSDoc block
+                        let jsDocStart = lineIndex - 1;
+                        while (jsDocStart > 0 && !lines[jsDocStart].includes('/**')) {
+                            jsDocStart--;
+                        }
+                        const block = lines.slice(jsDocStart, lineIndex).join('\n');
+                        const summaryMatch = block.match(/@summary\s+([^\n*]+)/i) || block.match(/\*\s*([^*@\n/]+)/);
+                        if (summaryMatch) {
+                            comment = summaryMatch[1].trim();
+                        }
+                    }
+                }
+                // Extract path parameters like :id or :userId
+                const pathParams = (routePath.match(/:[a-zA-Z0-9_]+/g) || []).map(p => p.slice(1));
+                routes.push({
+                    method,
+                    path: routePath,
+                    file: filePath,
+                    line: lineIndex + 1,
+                    description: comment,
+                    pathParams
+                });
+            }
+        }
+        return routes;
+    }
+    collectSourceFiles(dir, maxFiles, collected = []) {
+        if (!fs.existsSync(dir))
+            return collected;
+        if (collected.length >= maxFiles)
+            return collected;
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (collected.length >= maxFiles)
+                    break;
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    // Ignore heavy or irrelevant folders
+                    if (!['node_modules', 'dist', '.git', '.gemini', 'coverage', 'build', '.next'].includes(entry.name)) {
+                        this.collectSourceFiles(fullPath, maxFiles, collected);
+                    }
+                }
+                else if (entry.isFile()) {
+                    const ext = path.extname(entry.name).toLowerCase();
+                    if (['.js', '.ts', '.mjs', '.cjs'].includes(ext) && !entry.name.endsWith('.d.ts') && !entry.name.includes('.test.')) {
+                        collected.push(fullPath);
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore permission errors
+        }
+        return collected;
+    }
+}
+//# sourceMappingURL=ast-scanner.js.map

package/dist/adapters/nodejs/ast-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-scanner.js","sourceRoot":"","sources":["../../../src/adapters/nodejs/ast-scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAW7B,MAAM,aAAa,GAAG,oGAAoG,CAAC;AAE3H,MAAM,OAAO,aAAa;IACxB;;OAEG;IACI,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,QAAQ,GAAG,GAAG;QACxD,MAAM,UAAU,GAAsB,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACvD,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAEM,eAAe,CAAC,OAAe,EAAE,QAAgB;QACtD,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;YAC9B,aAAa,CAAC,SAAS,GAAG,CAAC,CAAC;YAC5B,IAAI,KAA6B,CAAC;YAElC,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBACnD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;gBACtC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAE3B,sCAAsC;gBACtC,IAAI,OAA2B,CAAC;gBAChC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;oBAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC7C,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC9B,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;oBAC7C,CAAC;yBAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;wBACnC,4BAA4B;wBAC5B,IAAI,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC;wBAC/B,OAAO,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;4BAC5D,UAAU,EAAE,CAAC;wBACf,CAAC;wBACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAC5D,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;wBAC7F,IAAI,YAAY,EAAE,CAAC;4BACjB,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;wBACnC,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,8CAA8C;gBAC9C,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAEnF,MAAM,CAAC,IAAI,CAAC;oBACV,MAAM;oBACN,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,SAAS,GAAG,CAAC;oBACnB,WAAW,EAAE,OAAO;oBACpB,UAAU;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,kBAAkB,CAAC,GAAW,EAAE,QAAgB,EAAE,YAAsB,EAAE;QAChF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1C,IAAI,SAAS,CAAC,MAAM,IAAI,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEnD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,SAAS,CAAC,MAAM,IAAI,QAAQ;oBAAE,MAAM;gBAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,qCAAqC;oBACrC,IAAI,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;wBACpG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;oBACzD,CAAC;gBACH,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;oBACnD,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACpH,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC3B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/adapters/openapi/adapter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Fridayy - OpenAPI Adapter
+ * Converts OpenAPI/Swagger specifications into standard Fridayy tool definitions and executes them.
+ */
+import { BaseAdapter, AdapterScanContext, AdapterGenerationContext, AdapterExecutionContext } from '../base.js';
+import { FridayyToolDefinition, ToolExecutionResult } from '../../core/schema/types.js';
+export declare class OpenApiAdapter extends BaseAdapter {
+    readonly name = "openapi";
+    readonly description = "Adapter for OpenAPI 3.0, 3.1, and Swagger 2.0 specifications";
+    private parser;
+    private restExecutor;
+    detect(context: AdapterScanContext): Promise<{
+        detected: boolean;
+        details?: any;
+    }>;
+    generateTools(context: AdapterGenerationContext): Promise<FridayyToolDefinition[]>;
+    executeTool(tool: FridayyToolDefinition, input: Record<string, any>, context?: AdapterExecutionContext): Promise<ToolExecutionResult>;
+    private extractParameters;
+    private extractRequestBody;
+    private extractSecurity;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/openapi/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/openapi/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EAIrB,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAWpC,qBAAa,cAAe,SAAQ,WAAW;IAC7C,SAAgB,IAAI,aAAa;IACjC,SAAgB,WAAW,kEAAkE;IAE7F,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAuB;IAE9B,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IA6BlF,aAAa,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAgIlF,WAAW,CACtB,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,mBAAmB,CAAC;IAwB/B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,eAAe;CA2DxB"}

package/dist/adapters/openapi/adapter.js

@@ -0,0 +1,271 @@
+/**
+ * Fridayy - OpenAPI Adapter
+ * Converts OpenAPI/Swagger specifications into standard Fridayy tool definitions and executes them.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { BaseAdapter } from '../base.js';
+import { OpenApiParser } from './parser.js';
+import { buildUnifiedInputSchema } from '../../core/schema/json-schema.js';
+import { sanitizeToolName, generateToolNameFromRoute } from '../../core/tool-generator/name-sanitizer.js';
+import { buildToolDescription } from '../../core/tool-generator/description-builder.js';
+import { classifyOperation } from '../../core/permissions/classifier.js';
+import { buildHttpRequest } from './request-builder.js';
+import { defaultRestExecutor } from '../rest/executor.js';
+import { AuthenticationManager } from '../../core/authentication/manager.js';
+import { defaultSecretResolver } from '../../core/authentication/secret-resolver.js';
+export class OpenApiAdapter extends BaseAdapter {
+    name = 'openapi';
+    description = 'Adapter for OpenAPI 3.0, 3.1, and Swagger 2.0 specifications';
+    parser = new OpenApiParser();
+    restExecutor = defaultRestExecutor;
+    async detect(context) {
+        const rootDir = context.rootDir;
+        const candidates = [
+            'openapi.yaml',
+            'openapi.yml',
+            'openapi.json',
+            'swagger.yaml',
+            'swagger.yml',
+            'swagger.json',
+            'api/openapi.yaml',
+            'api/openapi.json',
+            'docs/openapi.yaml',
+            'docs/openapi.json'
+        ];
+        const foundFiles = [];
+        for (const rel of candidates) {
+            const full = path.resolve(rootDir, rel);
+            if (fs.existsSync(full)) {
+                foundFiles.push(rel);
+            }
+        }
+        return {
+            detected: foundFiles.length > 0,
+            details: { foundFiles }
+        };
+    }
+    async generateTools(context) {
+        const rootDir = context.rootDir || process.cwd();
+        let specSource = context.sourcePath || context.config?.source?.path || 'openapi.yaml';
+        const spec = await this.parser.parse(specSource, rootDir);
+        const tools = [];
+        const serverBaseUrl = defaultSecretResolver.resolveBaseUrl(context.config?.source?.baseUrl) ||
+            spec.servers[0]?.url ||
+            'http://localhost:3000';
+        const usedToolNames = new Set();
+        for (const [routePath, pathItem] of Object.entries(spec.paths)) {
+            if (!pathItem || typeof pathItem !== 'object')
+                continue;
+            const httpMethods = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+            const pathLevelParams = this.extractParameters(pathItem.parameters);
+            for (const method of httpMethods) {
+                const operation = pathItem[method];
+                if (!operation || typeof operation !== 'object')
+                    continue;
+                // Extract parameters
+                const opParams = this.extractParameters(operation.parameters);
+                const allParams = [...pathLevelParams, ...opParams];
+                const pathParams = allParams.filter(p => p.in === 'path');
+                const queryParams = allParams.filter(p => p.in === 'query');
+                const headerParams = allParams.filter(p => p.in === 'header');
+                const cookieParams = allParams.filter(p => p.in === 'cookie');
+                // Extract request body
+                const requestBody = this.extractRequestBody(operation.requestBody, operation);
+                // Generate tool name
+                let toolName = operation.operationId
+                    ? sanitizeToolName(operation.operationId)
+                    : generateToolNameFromRoute(method, routePath);
+                // Ensure unique tool names
+                if (usedToolNames.has(toolName)) {
+                    let suffix = 2;
+                    while (usedToolNames.has(`${toolName}_${suffix}`)) {
+                        suffix++;
+                    }
+                    toolName = `${toolName}_${suffix}`;
+                }
+                usedToolNames.add(toolName);
+                // Classify permissions
+                const classification = classifyOperation({
+                    method,
+                    path: routePath,
+                    operationId: operation.operationId,
+                    name: toolName,
+                    summary: operation.summary,
+                    description: operation.description,
+                    tags: operation.tags
+                }, context.config);
+                // Build description
+                const description = buildToolDescription({
+                    summary: operation.summary,
+                    description: operation.description,
+                    method,
+                    path: routePath,
+                    tags: operation.tags,
+                    permissionType: classification.permissions.type,
+                    risk: classification.risk
+                });
+                // Build unified input schema
+                const inputSchema = buildUnifiedInputSchema({
+                    parameters: {
+                        path: pathParams,
+                        query: queryParams,
+                        header: headerParams,
+                        cookie: cookieParams
+                    },
+                    requestBody
+                });
+                // Determine authentication requirement
+                const auth = this.extractSecurity(operation.security || spec.rawDoc.security, spec.securityDefinitions);
+                const tool = {
+                    id: `tool_${toolName}`,
+                    name: toolName,
+                    description,
+                    inputSchema,
+                    source: {
+                        type: 'openapi',
+                        method: method.toUpperCase(),
+                        path: routePath,
+                        baseUrl: serverBaseUrl,
+                        operationId: operation.operationId,
+                        tags: operation.tags,
+                        summary: operation.summary
+                    },
+                    parameters: {
+                        path: pathParams,
+                        query: queryParams,
+                        header: headerParams,
+                        cookie: cookieParams
+                    },
+                    requestBody,
+                    authentication: auth,
+                    permissions: classification.permissions,
+                    risk: classification.risk,
+                    status: classification.status,
+                    metadata: {
+                        createdAt: new Date().toISOString(),
+                        autoGenerated: true,
+                        sourceFile: specSource
+                    }
+                };
+                tools.push(tool);
+            }
+        }
+        return tools;
+    }
+    async executeTool(tool, input, context = {}) {
+        const authManager = new AuthenticationManager(context.config);
+        const baseUrl = defaultSecretResolver.resolveBaseUrl(context.config?.source?.baseUrl);
+        // Build base request
+        const preparedReq = buildHttpRequest(tool, input, baseUrl);
+        // Apply custom execution context headers
+        if (context.headers) {
+            Object.assign(preparedReq.headers, context.headers);
+        }
+        // Apply authentication
+        authManager.applyAuth(tool.authentication, {
+            headers: preparedReq.headers,
+            queryParams: {}
+        });
+        // Execute via REST executor
+        return await this.restExecutor.execute(preparedReq, tool.name, {
+            timeoutMs: context.timeoutMs
+        });
+    }
+    extractParameters(rawParams) {
+        if (!rawParams || !Array.isArray(rawParams))
+            return [];
+        return rawParams.map((p) => ({
+            name: p.name,
+            in: p.in || 'query',
+            required: p.required ?? p.in === 'path',
+            description: p.description,
+            schema: p.schema || { type: p.type || 'string' },
+            example: p.example
+        }));
+    }
+    extractRequestBody(rawBody, operation) {
+        // OpenAPI 3.x
+        if (rawBody && rawBody.content) {
+            const contentTypes = Object.keys(rawBody.content);
+            const primaryType = contentTypes.find(t => t.includes('json')) || contentTypes[0] || 'application/json';
+            const contentDef = rawBody.content[primaryType];
+            return {
+                contentType: primaryType,
+                required: rawBody.required ?? false,
+                description: rawBody.description,
+                schema: contentDef?.schema || { type: 'object' },
+                example: contentDef?.example
+            };
+        }
+        // Swagger 2.0 (body parameter)
+        if (operation && operation.parameters && Array.isArray(operation.parameters)) {
+            const bodyParam = operation.parameters.find((p) => p.in === 'body');
+            if (bodyParam) {
+                return {
+                    contentType: 'application/json',
+                    required: bodyParam.required ?? false,
+                    description: bodyParam.description,
+                    schema: bodyParam.schema || { type: 'object' },
+                    example: bodyParam.example
+                };
+            }
+        }
+        return undefined;
+    }
+    extractSecurity(opSecurity, securityDefinitions) {
+        if (!opSecurity || !Array.isArray(opSecurity) || opSecurity.length === 0) {
+            return undefined;
+        }
+        const firstSec = opSecurity[0];
+        const schemeName = Object.keys(firstSec)[0];
+        if (!schemeName)
+            return undefined;
+        const schemeDef = securityDefinitions?.[schemeName];
+        if (!schemeDef) {
+            return {
+                required: true,
+                schemeName,
+                type: 'apiKey'
+            };
+        }
+        if (schemeDef.type === 'http') {
+            if (schemeDef.scheme === 'bearer') {
+                return {
+                    required: true,
+                    type: 'bearer',
+                    schemeName
+                };
+            }
+            if (schemeDef.scheme === 'basic') {
+                return {
+                    required: true,
+                    type: 'basic',
+                    schemeName
+                };
+            }
+        }
+        if (schemeDef.type === 'apiKey') {
+            return {
+                required: true,
+                type: 'apiKey',
+                schemeName,
+                headerName: schemeDef.in === 'header' ? schemeDef.name : undefined,
+                queryParam: schemeDef.in === 'query' ? schemeDef.name : undefined
+            };
+        }
+        if (schemeDef.type === 'oauth2') {
+            return {
+                required: true,
+                type: 'oauth2',
+                schemeName
+            };
+        }
+        return {
+            required: true,
+            schemeName,
+            type: 'apiKey'
+        };
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/openapi/adapter.js.map

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

package/dist/adapters/openapi/parser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Fridayy - OpenAPI / Swagger Specification Parser & $ref Resolver
+ * Supports OpenAPI 3.0.x, 3.1.x, and Swagger 2.0 (YAML & JSON).
+ */
+export interface ParsedOpenApiSpec {
+    version: string;
+    title: string;
+    description?: string;
+    servers: Array<{
+        url: string;
+        description?: string;
+    }>;
+    paths: Record<string, any>;
+    components?: Record<string, any>;
+    securityDefinitions?: Record<string, any>;
+    rawDoc: any;
+}
+export declare class OpenApiParser {
+    /**
+     * Loads and parses an OpenAPI document from a file path, URL, or raw string.
+     */
+    parse(sourcePathOrContent: string, rootDir?: string): Promise<ParsedOpenApiSpec>;
+    /**
+     * Resolves internal $ref pointers (e.g., #/components/schemas/User)
+     */
+    resolveRefs(current: any, root: any, visited?: Set<string>): any;
+    private lookupRef;
+    private normalizeSpec;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/adapters/openapi/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/adapters/openapi/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,CAAC;CACb;AAED,qBAAa,aAAa;IACxB;;OAEG;IACU,KAAK,CAAC,mBAAmB,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgD5G;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,cAAoB,GAAG,GAAG;IAmC7E,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,aAAa;CAqCtB"}

package/dist/adapters/openapi/parser.js

@@ -0,0 +1,136 @@
+/**
+ * Fridayy - OpenAPI / Swagger Specification Parser & $ref Resolver
+ * Supports OpenAPI 3.0.x, 3.1.x, and Swagger 2.0 (YAML & JSON).
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import YAML from 'yaml';
+export class OpenApiParser {
+    /**
+     * Loads and parses an OpenAPI document from a file path, URL, or raw string.
+     */
+    async parse(sourcePathOrContent, rootDir = process.cwd()) {
+        let rawContent;
+        let filePath;
+        if (sourcePathOrContent.startsWith('http://') || sourcePathOrContent.startsWith('https://')) {
+            const res = await fetch(sourcePathOrContent);
+            if (!res.ok) {
+                throw new Error(`Failed to fetch OpenAPI spec from ${sourcePathOrContent}: ${res.status} ${res.statusText}`);
+            }
+            rawContent = await res.text();
+        }
+        else if (sourcePathOrContent.trim().startsWith('{') ||
+            sourcePathOrContent.trim().startsWith('openapi:') ||
+            sourcePathOrContent.trim().startsWith('swagger:')) {
+            rawContent = sourcePathOrContent;
+        }
+        else {
+            filePath = path.isAbsolute(sourcePathOrContent)
+                ? sourcePathOrContent
+                : path.resolve(rootDir, sourcePathOrContent);
+            if (!fs.existsSync(filePath)) {
+                throw new Error(`OpenAPI specification file not found: ${filePath}`);
+            }
+            rawContent = fs.readFileSync(filePath, 'utf-8');
+        }
+        let parsed;
+        try {
+            if (rawContent.trim().startsWith('{')) {
+                parsed = JSON.parse(rawContent);
+            }
+            else {
+                parsed = YAML.parse(rawContent);
+            }
+        }
+        catch (err) {
+            throw new Error(`Failed to parse OpenAPI file as JSON/YAML: ${err.message}`);
+        }
+        if (!parsed || typeof parsed !== 'object') {
+            throw new Error('Invalid OpenAPI document: document must be an object.');
+        }
+        // Resolve all internal $ref references
+        const resolvedDoc = this.resolveRefs(parsed, parsed);
+        return this.normalizeSpec(resolvedDoc);
+    }
+    /**
+     * Resolves internal $ref pointers (e.g., #/components/schemas/User)
+     */
+    resolveRefs(current, root, visited = new Set()) {
+        if (current === null || current === undefined) {
+            return current;
+        }
+        if (Array.isArray(current)) {
+            return current.map(item => this.resolveRefs(item, root, visited));
+        }
+        if (typeof current === 'object') {
+            if (current.$ref && typeof current.$ref === 'string') {
+                const ref = current.$ref;
+                if (ref.startsWith('#/')) {
+                    if (visited.has(ref)) {
+                        // Circular reference detected; return placeholder or shallow copy to prevent infinite loop
+                        return { type: 'object', description: `[Circular Ref: ${ref}]` };
+                    }
+                    visited.add(ref);
+                    const resolved = this.lookupRef(ref, root);
+                    const deepResolved = this.resolveRefs(resolved, root, new Set(visited));
+                    visited.delete(ref);
+                    return deepResolved;
+                }
+            }
+            const result = {};
+            for (const [key, val] of Object.entries(current)) {
+                result[key] = this.resolveRefs(val, root, visited);
+            }
+            return result;
+        }
+        return current;
+    }
+    lookupRef(ref, root) {
+        const parts = ref.replace(/^#\//, '').split('/');
+        let current = root;
+        for (const part of parts) {
+            const unescaped = part.replace(/~1/g, '/').replace(/~0/g, '~');
+            if (current && typeof current === 'object' && unescaped in current) {
+                current = current[unescaped];
+            }
+            else {
+                return { type: 'object', description: `[Unresolved Ref: ${ref}]` };
+            }
+        }
+        return current;
+    }
+    normalizeSpec(doc) {
+        const isSwagger2 = doc.swagger && doc.swagger.startsWith('2.');
+        const version = doc.openapi || doc.swagger || '3.0.0';
+        const title = doc.info?.title || 'API Specification';
+        const description = doc.info?.description;
+        const servers = [];
+        if (doc.servers && Array.isArray(doc.servers)) {
+            servers.push(...doc.servers);
+        }
+        else if (isSwagger2) {
+            const scheme = doc.schemes?.[0] || 'http';
+            const host = doc.host || 'localhost';
+            const basePath = doc.basePath || '';
+            servers.push({ url: `${scheme}://${host}${basePath}` });
+        }
+        if (servers.length === 0) {
+            servers.push({ url: 'http://localhost:3000' });
+        }
+        const components = doc.components || {
+            schemas: doc.definitions || {},
+            securitySchemes: doc.securityDefinitions || {}
+        };
+        return {
+            version,
+            title,
+            description,
+            servers,
+            paths: doc.paths || {},
+            components,
+            securityDefinitions: doc.securityDefinitions || doc.components?.securitySchemes,
+            rawDoc: doc
+        };
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/adapters/openapi/parser.js.map

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

package/dist/adapters/openapi/request-builder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fridayy - HTTP Request Builder
+ * Interpolates URL path params, serializes query strings, and packages payloads for REST execution.
+ */
+import { FridayyToolDefinition } from '../../core/schema/types.js';
+export interface PreparedHttpRequest {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}
+export declare function buildHttpRequest(tool: FridayyToolDefinition, input?: Record<string, any>, baseUrlOverride?: string): PreparedHttpRequest;
+//# sourceMappingURL=request-builder.d.ts.map

package/dist/adapters/openapi/request-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-builder.d.ts","sourceRoot":"","sources":["../../../src/adapters/openapi/request-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,qBAAqB,EAC3B,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAC/B,eAAe,CAAC,EAAE,MAAM,GACvB,mBAAmB,CA0FrB"}