fridayy 1.0.0

package/dist/core/schema/types.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Fridayy - Universal Application-to-MCP Platform
+ * Core Type Definitions
+ */
+export type ToolPermissionType = 'READ' | 'WRITE' | 'DESTRUCTIVE';
+export type ToolRiskLevel = 'low' | 'medium' | 'high';
+export type ToolApprovalStatus = 'APPROVED' | 'PENDING' | 'BLOCKED' | 'REJECTED';
+export type SourceType = 'openapi' | 'rest' | 'nodejs' | 'manual' | 'graphql' | string;
+export type AuthType = 'apiKey' | 'bearer' | 'basic' | 'customHeader' | 'oauth2' | 'none';
+export interface ParameterDefinition {
+    name: string;
+    in: 'path' | 'query' | 'header' | 'cookie';
+    required: boolean;
+    description?: string;
+    schema: Record<string, any>;
+    example?: any;
+}
+export interface RequestBodyDefinition {
+    contentType: string;
+    required: boolean;
+    description?: string;
+    schema: Record<string, any>;
+    example?: any;
+}
+export interface ToolAuthentication {
+    required: boolean;
+    type?: AuthType;
+    envKey?: string;
+    headerName?: string;
+    queryParam?: string;
+    schemeName?: string;
+    description?: string;
+}
+export interface ToolPermissions {
+    type: ToolPermissionType;
+    read: boolean;
+    write: boolean;
+    destructive: boolean;
+    requiresConfirmation?: boolean;
+}
+export interface ToolRateLimit {
+    maxRequests: number;
+    windowSeconds: number;
+}
+export interface FridayyToolDefinition {
+    id: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, any>;
+        required?: string[];
+        additionalProperties?: boolean;
+        [key: string]: any;
+    };
+    outputSchema?: Record<string, any>;
+    source: {
+        type: SourceType;
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | string;
+        url?: string;
+        path?: string;
+        baseUrl?: string;
+        handler?: string;
+        endpoint?: string;
+        operationId?: string;
+        tags?: string[];
+        summary?: string;
+    };
+    parameters?: {
+        path?: ParameterDefinition[];
+        query?: ParameterDefinition[];
+        header?: ParameterDefinition[];
+        cookie?: ParameterDefinition[];
+    };
+    requestBody?: RequestBodyDefinition;
+    authentication?: ToolAuthentication;
+    permissions: ToolPermissions;
+    risk: ToolRiskLevel;
+    status: ToolApprovalStatus;
+    rateLimit?: ToolRateLimit;
+    metadata?: {
+        createdAt?: string;
+        updatedAt?: string;
+        approvedAt?: string;
+        approvedBy?: string;
+        autoGenerated?: boolean;
+        sourceFile?: string;
+        [key: string]: any;
+    };
+}
+export interface FridayyConfig {
+    name: string;
+    version?: string;
+    description?: string;
+    source: {
+        type: 'openapi' | 'rest' | 'nodejs' | 'manual' | 'auto';
+        path?: string;
+        url?: string;
+        baseUrl?: string;
+        rootDir?: string;
+        [key: string]: any;
+    };
+    server?: {
+        name?: string;
+        version?: string;
+        transport?: 'stdio' | 'sse';
+        port?: number;
+        host?: string;
+        maxRequestsPerMinute?: number;
+    };
+    security?: {
+        requireApprovalForDestructive?: boolean;
+        autoApproveRead?: boolean;
+        autoApproveWrite?: boolean;
+        allowlist?: string[];
+        denylist?: string[];
+        rateLimit?: ToolRateLimit;
+        secretEnvPrefix?: string;
+    };
+    auth?: {
+        [schemeName: string]: {
+            type: AuthType;
+            envKey?: string;
+            headerName?: string;
+            queryParam?: string;
+            value?: string;
+        };
+    };
+    logging?: {
+        level?: 'debug' | 'info' | 'warn' | 'error';
+        auditLogPath?: string;
+        maskSecrets?: boolean;
+    };
+    tools?: {
+        autoGenerate?: boolean;
+        toolsFile?: string;
+        includeTags?: string[];
+        excludeTags?: string[];
+        includePaths?: string[];
+        excludePaths?: string[];
+    };
+}
+export interface ToolsFileStructure {
+    version: string;
+    generatedAt: string;
+    source: string;
+    tools: FridayyToolDefinition[];
+}
+export interface ToolExecutionResult {
+    success: boolean;
+    data?: any;
+    error?: {
+        code: string;
+        message: string;
+        details?: any;
+    };
+    metadata?: {
+        statusCode?: number;
+        durationMs: number;
+        timestamp: string;
+        toolName: string;
+    };
+}
+export interface ScanResult {
+    hasOpenApi: boolean;
+    openApiFiles: string[];
+    hasNodeJs: boolean;
+    nodeJsFramework?: 'express' | 'fastify' | 'koa' | 'nestjs' | 'custom' | 'none';
+    discoveredEndpointsCount: number;
+    authSchemesDetected: string[];
+    recommendedConfig: Partial<FridayyConfig>;
+    details: {
+        openApiSpecs?: Array<{
+            path: string;
+            version: string;
+            title: string;
+            endpointsCount: number;
+        }>;
+        routes?: Array<{
+            method: string;
+            path: string;
+            file: string;
+            line: number;
+        }>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/schema/types.d.ts.map

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

package/dist/core/schema/types.js

@@ -0,0 +1,6 @@
+/**
+ * Fridayy - Universal Application-to-MCP Platform
+ * Core Type Definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/schema/types.js.map

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

package/dist/core/tool-generator/description-builder.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Fridayy - Tool Description Builder
+ * Formats rich, semantic tool descriptions for LLMs.
+ */
+export interface DescriptionBuildContext {
+    summary?: string;
+    description?: string;
+    method?: string;
+    path?: string;
+    tags?: string[];
+    permissionType?: string;
+    risk?: string;
+}
+export declare function buildToolDescription(ctx: DescriptionBuildContext): string;
+//# sourceMappingURL=description-builder.d.ts.map

package/dist/core/tool-generator/description-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-builder.d.ts","sourceRoot":"","sources":["../../../src/core/tool-generator/description-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CA4BzE"}

package/dist/core/tool-generator/description-builder.js

@@ -0,0 +1,32 @@
+/**
+ * Fridayy - Tool Description Builder
+ * Formats rich, semantic tool descriptions for LLMs.
+ */
+export function buildToolDescription(ctx) {
+    const parts = [];
+    // 1. Primary summary or description
+    if (ctx.summary) {
+        parts.push(ctx.summary.trim());
+    }
+    else if (ctx.description) {
+        // Take first sentence or full short description
+        const firstLine = ctx.description.split('\n')[0].trim();
+        parts.push(firstLine);
+    }
+    else if (ctx.method && ctx.path) {
+        parts.push(`Execute ${ctx.method.toUpperCase()} request to ${ctx.path}`);
+    }
+    // 2. Additional context if different from summary
+    if (ctx.description && ctx.summary && ctx.description.trim() !== ctx.summary.trim()) {
+        const cleanDesc = ctx.description.replace(/\r?\n/g, ' ').trim();
+        if (cleanDesc.length > 0 && !parts.includes(cleanDesc)) {
+            parts.push(`Details: ${cleanDesc}`);
+        }
+    }
+    // 3. Risk / Permission advisory for LLM safety
+    if (ctx.permissionType === 'DESTRUCTIVE') {
+        parts.push('[CAUTION: Destructive operation - permanent deletion or irreversible state change]');
+    }
+    return parts.join('. ').replace(/\.\./g, '.');
+}
+//# sourceMappingURL=description-builder.js.map

package/dist/core/tool-generator/description-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-builder.js","sourceRoot":"","sources":["../../../src/core/tool-generator/description-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,UAAU,oBAAoB,CAAC,GAA4B;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,oCAAoC;IACpC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;SAAM,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QAC3B,gDAAgD;QAChD,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,kDAAkD;IAClD,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpF,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,YAAY,SAAS,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,GAAG,CAAC,cAAc,KAAK,aAAa,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;IACnG,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC"}

package/dist/core/tool-generator/generator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Fridayy - Tool Generator Engine
+ * Coordinates adapters to generate, filter, and normalize candidate MCP tools.
+ */
+import { FridayyToolDefinition, FridayyConfig } from '../schema/types.js';
+import { AdapterRegistry } from '../../adapters/registry.js';
+export interface GenerationOptions {
+    rootDir?: string;
+    config: FridayyConfig;
+    preserveStatuses?: Map<string, 'APPROVED' | 'PENDING' | 'BLOCKED' | 'REJECTED'>;
+}
+export declare class ToolGenerator {
+    private adapterRegistry;
+    constructor(adapterRegistry?: AdapterRegistry);
+    /**
+     * Generates MCP tools from the configured source adapter.
+     */
+    generate(options: GenerationOptions): Promise<FridayyToolDefinition[]>;
+}
+export declare const defaultToolGenerator: ToolGenerator;
+//# sourceMappingURL=generator.d.ts.map

package/dist/core/tool-generator/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/core/tool-generator/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAA0B,MAAM,4BAA4B,CAAC;AAGrF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;CACjF;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,eAAe,CAAkB;gBAE7B,eAAe,GAAE,eAAwC;IAIrE;;OAEG;IACU,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAiDpF;AAED,eAAO,MAAM,oBAAoB,eAAsB,CAAC"}

package/dist/core/tool-generator/generator.js

@@ -0,0 +1,61 @@
+/**
+ * Fridayy - Tool Generator Engine
+ * Coordinates adapters to generate, filter, and normalize candidate MCP tools.
+ */
+import { defaultAdapterRegistry } from '../../adapters/registry.js';
+import { isToolAllowed } from '../../security/allowlist.js';
+export class ToolGenerator {
+    adapterRegistry;
+    constructor(adapterRegistry = defaultAdapterRegistry) {
+        this.adapterRegistry = adapterRegistry;
+    }
+    /**
+     * Generates MCP tools from the configured source adapter.
+     */
+    async generate(options) {
+        const { config, rootDir = process.cwd(), preserveStatuses } = options;
+        const sourceType = config.source.type || 'openapi';
+        const adapter = this.adapterRegistry.get(sourceType);
+        if (!adapter) {
+            throw new Error(`Unsupported source adapter: "${sourceType}". Registered adapters: [${this.adapterRegistry.getAll().map(a => a.name).join(', ')}]`);
+        }
+        const generatedRawTools = await adapter.generateTools({
+            rootDir,
+            config,
+            sourcePath: config.source.path,
+            sourceUrl: config.source.url
+        });
+        // Filter tools based on config
+        const filteredTools = generatedRawTools.filter(tool => {
+            // 1. Tag filters
+            if (config.tools?.includeTags && config.tools.includeTags.length > 0) {
+                const toolTags = tool.source.tags || [];
+                const hasTag = config.tools.includeTags.some(t => toolTags.includes(t));
+                if (!hasTag)
+                    return false;
+            }
+            if (config.tools?.excludeTags && config.tools.excludeTags.length > 0) {
+                const toolTags = tool.source.tags || [];
+                const hasExcluded = config.tools.excludeTags.some(t => toolTags.includes(t));
+                if (hasExcluded)
+                    return false;
+            }
+            // 2. Allowlist / Denylist
+            return isToolAllowed(tool.name, {
+                allowlist: config.security?.allowlist,
+                denylist: config.security?.denylist
+            });
+        });
+        // Preserve previous approval statuses if available
+        if (preserveStatuses && preserveStatuses.size > 0) {
+            for (const tool of filteredTools) {
+                if (preserveStatuses.has(tool.name)) {
+                    tool.status = preserveStatuses.get(tool.name);
+                }
+            }
+        }
+        return filteredTools;
+    }
+}
+export const defaultToolGenerator = new ToolGenerator();
+//# sourceMappingURL=generator.js.map

package/dist/core/tool-generator/generator.js.map

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

package/dist/core/tool-generator/name-sanitizer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Fridayy - Tool Name Sanitizer & Generator
+ * Converts API operations, methods, and paths into clean snake_case MCP tool names.
+ */
+/**
+ * Sanitizes an operation ID or string to a valid MCP tool name.
+ */
+export declare function sanitizeToolName(name: string): string;
+/**
+ * Generates an intuitive tool name from HTTP method and path if operationId is missing.
+ * E.g.:
+ * - GET /users -> get_users
+ * - GET /users/{id} -> get_user
+ * - POST /orders -> create_order
+ * - PUT /users/{id} -> update_user
+ * - DELETE /users/{id} -> delete_user
+ * - PUT /customers/{id}/profile -> update_customer_profile
+ * - POST /auth/login -> login
+ */
+export declare function generateToolNameFromRoute(method: string, pathStr: string): string;
+//# sourceMappingURL=name-sanitizer.d.ts.map

package/dist/core/tool-generator/name-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-sanitizer.d.ts","sourceRoot":"","sources":["../../../src/core/tool-generator/name-sanitizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA0DjF"}

package/dist/core/tool-generator/name-sanitizer.js

@@ -0,0 +1,84 @@
+/**
+ * Fridayy - Tool Name Sanitizer & Generator
+ * Converts API operations, methods, and paths into clean snake_case MCP tool names.
+ */
+/**
+ * Sanitizes an operation ID or string to a valid MCP tool name.
+ */
+export function sanitizeToolName(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2') // camelCase to snake_case
+        .replace(/[^a-zA-Z0-9_]/g, '_') // replace non-alphanumeric with underscore
+        .replace(/_+/g, '_') // collapse consecutive underscores
+        .replace(/^_+|_+$/g, '') // trim leading/trailing underscores
+        .toLowerCase();
+}
+/**
+ * Generates an intuitive tool name from HTTP method and path if operationId is missing.
+ * E.g.:
+ * - GET /users -> get_users
+ * - GET /users/{id} -> get_user
+ * - POST /orders -> create_order
+ * - PUT /users/{id} -> update_user
+ * - DELETE /users/{id} -> delete_user
+ * - PUT /customers/{id}/profile -> update_customer_profile
+ * - POST /auth/login -> login
+ */
+export function generateToolNameFromRoute(method, pathStr) {
+    const m = method.toLowerCase();
+    // Strip leading and trailing slashes, remove /api/v1, /api prefixes
+    let cleanedPath = pathStr
+        .replace(/^\/?(api\/v\d+|api)\//i, '')
+        .replace(/^\/|\/$/g, '');
+    const rawSegments = cleanedPath.split('/').filter(Boolean);
+    const resourceSegments = [];
+    for (let i = 0; i < rawSegments.length; i++) {
+        const seg = rawSegments[i];
+        if (seg.startsWith('{') || seg.startsWith(':')) {
+            // If previous segment was plural, singularize it
+            if (resourceSegments.length > 0) {
+                const lastIdx = resourceSegments.length - 1;
+                const prev = resourceSegments[lastIdx];
+                if (prev.endsWith('s') && !prev.endsWith('ss') && !prev.endsWith('us')) {
+                    resourceSegments[lastIdx] = prev.slice(0, -1);
+                }
+            }
+        }
+        else {
+            let cleanSeg = seg;
+            // If trailing segment on POST/DELETE/PUT and plural, singularize
+            if ((m === 'post' || m === 'delete' || m === 'put') && i === rawSegments.length - 1) {
+                if (cleanSeg.endsWith('s') && !cleanSeg.endsWith('ss') && !cleanSeg.endsWith('us')) {
+                    cleanSeg = cleanSeg.slice(0, -1);
+                }
+            }
+            resourceSegments.push(cleanSeg);
+        }
+    }
+    let resource = resourceSegments.length > 0 ? resourceSegments.join('_') : 'resource';
+    let prefix = m;
+    if (m === 'get') {
+        prefix = 'get';
+    }
+    else if (m === 'post') {
+        prefix = 'create';
+    }
+    else if (m === 'put') {
+        prefix = 'update';
+    }
+    else if (m === 'patch') {
+        prefix = 'update';
+    }
+    else if (m === 'delete') {
+        prefix = 'delete';
+    }
+    // Handle special cases like /login, /logout, /search, /checkout
+    if (resourceSegments.length === 1) {
+        const single = resourceSegments[0].toLowerCase();
+        if (['login', 'logout', 'search', 'checkout', 'register', 'ping', 'health'].includes(single)) {
+            return sanitizeToolName(single);
+        }
+    }
+    return sanitizeToolName(`${prefix}_${resource}`);
+}
+//# sourceMappingURL=name-sanitizer.js.map

package/dist/core/tool-generator/name-sanitizer.js.map

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