@mondaydotcomorg/atp-server 0.17.14

package/dist/openapi/index.d.ts

@@ -0,0 +1,133 @@
+import type { APIGroupConfig } from '@mondaydotcomorg/atp-protocol';
+interface OpenAPISpec {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    paths: Record<string, Record<string, OpenAPIOperation>>;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    components?: {
+        schemas?: Record<string, unknown>;
+        securitySchemes?: Record<string, OpenAPISecurityScheme>;
+    };
+    security?: Array<Record<string, string[]>>;
+}
+interface OpenAPISecurityScheme {
+    type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+    description?: string;
+    name?: string;
+    in?: 'query' | 'header' | 'cookie';
+    scheme?: string;
+    bearerFormat?: string;
+    flows?: {
+        clientCredentials?: {
+            tokenUrl: string;
+            refreshUrl?: string;
+            scopes?: Record<string, string>;
+        };
+        authorizationCode?: {
+            authorizationUrl: string;
+            tokenUrl: string;
+            refreshUrl?: string;
+            scopes?: Record<string, string>;
+        };
+        implicit?: {
+            authorizationUrl: string;
+            scopes?: Record<string, string>;
+        };
+        password?: {
+            tokenUrl: string;
+            refreshUrl?: string;
+            scopes?: Record<string, string>;
+        };
+    };
+}
+interface OpenAPIOperation {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    parameters?: Array<{
+        name: string;
+        in: string;
+        required?: boolean;
+        schema?: {
+            type?: string;
+            description?: string;
+        };
+        description?: string;
+    }>;
+    requestBody?: {
+        content?: {
+            'application/json'?: {
+                schema?: unknown;
+            };
+        };
+    };
+    responses?: Record<string, unknown>;
+    /** Per-operation security requirements */
+    security?: Array<Record<string, string[]>>;
+}
+/**
+ * OpenAPIConverter converts OpenAPI specifications to Agent Tool Protocol API groups.
+ */
+export declare class OpenAPIConverter {
+    /**
+     * Converts an OpenAPI specification to an API group configuration.
+     * @param spec - OpenAPI specification object
+     * @param httpClient - Function to execute HTTP requests (optional)
+     * @param authEnvVarPrefix - Prefix for environment variables (e.g., 'GITHUB' -> 'GITHUB_API_KEY')
+     * @returns APIGroupConfig object
+     */
+    static fromSpec(spec: OpenAPISpec, httpClient?: (method: string, path: string, params?: unknown) => Promise<unknown>, authEnvVarPrefix?: string): APIGroupConfig;
+    /**
+     * Converts an OpenAPI operation to a function definition.
+     */
+    private static convertOperation;
+    /**
+     * Builds JSON schema from OpenAPI operation parameters and request body.
+     */
+    private static buildInputSchema;
+    /**
+     * Generates a function name from HTTP method and path.
+     */
+    private static generateFunctionName;
+    /**
+     * Sanitizes a name for use as an API group name.
+     */
+    private static sanitizeName;
+    /**
+     * Extracts required OAuth scopes from security requirements
+     */
+    private static extractRequiredScopes;
+    /**
+     * Infers operation type from HTTP method
+     */
+    private static inferOperationType;
+    /**
+     * Parses authentication from OpenAPI security schemes
+     */
+    private static parseAuthentication;
+    /**
+     * Loads OpenAPI spec from a URL.
+     * @param url - URL to fetch OpenAPI spec from
+     * @param httpClient - Optional HTTP client function
+     * @param authEnvVarPrefix - Prefix for environment variables
+     * @returns APIGroupConfig object
+     */
+    static fromURL(url: string, httpClient?: (method: string, path: string, params?: unknown) => Promise<unknown>, authEnvVarPrefix?: string): Promise<APIGroupConfig>;
+    /**
+     * Loads OpenAPI spec from a file path.
+     * @param filePath - Path to OpenAPI spec file
+     * @param httpClient - Optional HTTP client function
+     * @param authEnvVarPrefix - Prefix for environment variables
+     * @returns APIGroupConfig object
+     */
+    static fromFile(filePath: string, httpClient?: (method: string, path: string, params?: unknown) => Promise<unknown>, authEnvVarPrefix?: string): Promise<APIGroupConfig>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/openapi/index.js

@@ -0,0 +1,235 @@
+import { readFile } from 'node:fs/promises';
+/**
+ * OpenAPIConverter converts OpenAPI specifications to Agent Tool Protocol API groups.
+ */
+export class OpenAPIConverter {
+    /**
+     * Converts an OpenAPI specification to an API group configuration.
+     * @param spec - OpenAPI specification object
+     * @param httpClient - Function to execute HTTP requests (optional)
+     * @param authEnvVarPrefix - Prefix for environment variables (e.g., 'GITHUB' -> 'GITHUB_API_KEY')
+     * @returns APIGroupConfig object
+     */
+    static fromSpec(spec, httpClient, authEnvVarPrefix) {
+        const functions = [];
+        const baseUrl = spec.servers?.[0]?.url || '';
+        const globalSecurity = spec.security;
+        for (const [path, methods] of Object.entries(spec.paths)) {
+            for (const [method, operation] of Object.entries(methods)) {
+                const func = this.convertOperation(path, method, operation, httpClient, globalSecurity);
+                if (func) {
+                    functions.push(func);
+                }
+            }
+        }
+        const auth = this.parseAuthentication(spec, authEnvVarPrefix);
+        return {
+            name: this.sanitizeName(spec.info.title),
+            type: 'openapi',
+            spec,
+            functions,
+            url: baseUrl,
+            auth,
+        };
+    }
+    /**
+     * Converts an OpenAPI operation to a function definition.
+     */
+    static convertOperation(path, method, operation, httpClient, globalSecurity) {
+        const functionName = operation.operationId || this.generateFunctionName(method, path);
+        const description = operation.summary || operation.description || `${method.toUpperCase()} ${path}`;
+        const inputSchema = this.buildInputSchema(operation);
+        const requiredScopes = this.extractRequiredScopes(operation.security || globalSecurity);
+        const operationType = this.inferOperationType(method);
+        const handler = httpClient
+            ? async (input) => {
+                return await httpClient(method, path, input);
+            }
+            : async (input) => {
+                throw new Error(`No HTTP client configured for ${functionName}`);
+            };
+        return {
+            name: functionName,
+            description,
+            inputSchema,
+            handler,
+            metadata: {
+                operationType,
+                ...(requiredScopes.length > 0 && { requiredScopes }),
+            },
+        };
+    }
+    /**
+     * Builds JSON schema from OpenAPI operation parameters and request body.
+     */
+    static buildInputSchema(operation) {
+        const properties = {};
+        const required = [];
+        if (operation.parameters) {
+            for (const param of operation.parameters) {
+                properties[param.name] = {
+                    type: param.schema?.type || 'string',
+                    description: param.description || param.schema?.description,
+                };
+                if (param.required) {
+                    required.push(param.name);
+                }
+            }
+        }
+        if (operation.requestBody?.content?.['application/json']?.schema) {
+            const bodySchema = operation.requestBody.content['application/json'].schema;
+            if (bodySchema.properties) {
+                Object.assign(properties, bodySchema.properties);
+            }
+            if (bodySchema.required) {
+                required.push(...bodySchema.required);
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            ...(required.length > 0 && { required }),
+        };
+    }
+    /**
+     * Generates a function name from HTTP method and path.
+     */
+    static generateFunctionName(method, path) {
+        const cleanPath = path
+            .replace(/^[^a-zA-Z0-9_]+/, '')
+            .replace(/\{([^}]+)\}/g, 'By_$1')
+            .replace(/[^a-zA-Z0-9_]/g, '_')
+            .replace(/_+/g, '_')
+            .replace(/^_|_$/g, '');
+        return `${method}_${cleanPath}`;
+    }
+    /**
+     * Sanitizes a name for use as an API group name.
+     */
+    static sanitizeName(name) {
+        return name
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '_')
+            .replace(/^_|_$/g, '');
+    }
+    /**
+     * Extracts required OAuth scopes from security requirements
+     */
+    static extractRequiredScopes(security) {
+        if (!security || security.length === 0) {
+            return [];
+        }
+        const allScopes = new Set();
+        for (const secReq of security) {
+            for (const scopes of Object.values(secReq)) {
+                scopes.forEach((scope) => allScopes.add(scope));
+            }
+        }
+        return Array.from(allScopes);
+    }
+    /**
+     * Infers operation type from HTTP method
+     */
+    static inferOperationType(method) {
+        const m = method.toLowerCase();
+        if (m === 'get' || m === 'head' || m === 'options') {
+            return 'read';
+        }
+        if (m === 'delete') {
+            return 'destructive';
+        }
+        return 'write';
+    }
+    /**
+     * Parses authentication from OpenAPI security schemes
+     */
+    static parseAuthentication(spec, envVarPrefix) {
+        if (!spec.security || spec.security.length === 0) {
+            return undefined;
+        }
+        const securityReq = spec.security[0];
+        if (!securityReq) {
+            return undefined;
+        }
+        const schemeName = Object.keys(securityReq)[0];
+        if (!schemeName || !spec.components?.securitySchemes) {
+            return undefined;
+        }
+        const scheme = spec.components.securitySchemes[schemeName];
+        if (!scheme) {
+            return undefined;
+        }
+        const envPrefix = envVarPrefix || this.sanitizeName(spec.info.title).toUpperCase();
+        switch (scheme.type) {
+            case 'apiKey':
+                return {
+                    scheme: 'apiKey',
+                    in: scheme.in === 'query' ? 'query' : 'header',
+                    name: scheme.name || 'X-API-Key',
+                    envVar: `${envPrefix}_API_KEY`,
+                };
+            case 'http':
+                if (scheme.scheme === 'bearer') {
+                    return {
+                        scheme: 'bearer',
+                        bearerFormat: scheme.bearerFormat,
+                        envVar: `${envPrefix}_TOKEN`,
+                    };
+                }
+                else if (scheme.scheme === 'basic') {
+                    return {
+                        scheme: 'basic',
+                        usernameEnvVar: `${envPrefix}_USERNAME`,
+                        passwordEnvVar: `${envPrefix}_PASSWORD`,
+                    };
+                }
+                break;
+            case 'oauth2':
+                if (scheme.flows?.clientCredentials) {
+                    return {
+                        scheme: 'oauth2',
+                        flow: 'clientCredentials',
+                        tokenUrl: scheme.flows.clientCredentials.tokenUrl,
+                        clientIdEnvVar: `${envPrefix}_CLIENT_ID`,
+                        clientSecretEnvVar: `${envPrefix}_CLIENT_SECRET`,
+                        scopes: scheme.flows.clientCredentials.scopes
+                            ? Object.keys(scheme.flows.clientCredentials.scopes)
+                            : undefined,
+                    };
+                }
+                return {
+                    scheme: 'bearer',
+                    envVar: `${envPrefix}_TOKEN`,
+                };
+        }
+        return undefined;
+    }
+    /**
+     * Loads OpenAPI spec from a URL.
+     * @param url - URL to fetch OpenAPI spec from
+     * @param httpClient - Optional HTTP client function
+     * @param authEnvVarPrefix - Prefix for environment variables
+     * @returns APIGroupConfig object
+     */
+    static async fromURL(url, httpClient, authEnvVarPrefix) {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch OpenAPI spec from ${url}: ${response.statusText}`);
+        }
+        const spec = (await response.json());
+        return this.fromSpec(spec, httpClient, authEnvVarPrefix);
+    }
+    /**
+     * Loads OpenAPI spec from a file path.
+     * @param filePath - Path to OpenAPI spec file
+     * @param httpClient - Optional HTTP client function
+     * @param authEnvVarPrefix - Prefix for environment variables
+     * @returns APIGroupConfig object
+     */
+    static async fromFile(filePath, httpClient, authEnvVarPrefix) {
+        const content = await readFile(filePath, 'utf-8');
+        const spec = JSON.parse(content);
+        return this.fromSpec(spec, httpClient, authEnvVarPrefix);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

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

package/dist/openapi-loader.d.ts

@@ -0,0 +1,87 @@
+import type { APIGroupConfig, AuthProvider } from '@mondaydotcomorg/atp-protocol';
+interface OpenAPIOperation {
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    deprecated?: boolean;
+    parameters?: Array<OpenAPIParameter>;
+    requestBody?: OpenAPIRequestBody;
+    responses?: Record<string, OpenAPIResponse>;
+    security?: Array<Record<string, string[]>>;
+    'x-destructive'?: boolean;
+    'x-requires-approval'?: boolean;
+    'x-risk-level'?: 'low' | 'medium' | 'high' | 'critical';
+    'x-confirm-prompt'?: string;
+    [key: string]: unknown;
+}
+interface OpenAPIParameter {
+    name: string;
+    in: 'query' | 'header' | 'path' | 'cookie';
+    required?: boolean;
+    schema?: OpenAPISchema;
+    description?: string;
+}
+interface OpenAPIRequestBody {
+    required?: boolean;
+    content?: Record<string, {
+        schema?: OpenAPISchema;
+    }>;
+}
+interface OpenAPIResponse {
+    description?: string;
+    content?: Record<string, {
+        schema?: OpenAPISchema;
+    }>;
+}
+interface OpenAPISchema {
+    type?: string;
+    properties?: Record<string, OpenAPISchema>;
+    items?: OpenAPISchema;
+    required?: string[];
+    enum?: string[];
+    $ref?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * Options for loading OpenAPI spec
+ */
+export interface LoadOpenAPIOptions {
+    /** API group name */
+    name?: string;
+    /** Filter operations */
+    filter?: {
+        /** Include only these tags */
+        tags?: string[];
+        /** Include only paths matching these patterns */
+        paths?: string[];
+        /** Exclude paths matching these patterns */
+        exclude?: string[];
+        /** Include only these HTTP methods */
+        methods?: string[];
+        /** Custom filter function */
+        operation?: (op: OpenAPIOperation, path: string, method: string) => boolean;
+    };
+    /** Override descriptions for better LLM understanding */
+    descriptions?: Record<string, string>;
+    /** Annotation mapping */
+    annotations?: {
+        /** Map OpenAPI extensions to annotations */
+        fromExtensions?: Record<string, string>;
+        /** Global annotations for all operations */
+        global?: Record<string, unknown>;
+        /** Per-operation annotations */
+        operations?: Record<string, Record<string, unknown>>;
+    };
+    /** Auth provider (optional, uses server's if not provided) */
+    authProvider?: AuthProvider;
+    /** Base URL override (if different from spec servers) */
+    baseURL?: string;
+}
+/**
+ * Load OpenAPI specification and convert to ATP API group
+ */
+export declare function loadOpenAPI(source: string, options?: LoadOpenAPIOptions): Promise<APIGroupConfig>;
+export {};
+//# sourceMappingURL=openapi-loader.d.ts.map

package/dist/openapi-loader.d.ts.map

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