@optimizely-opal/opal-tool-ocp-sdk 0.0.0-OCP-1487.1

package/dist/function/ToolFunction.test.js

@@ -0,0 +1,314 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ToolFunction_1 = require("./ToolFunction");
+const Service_1 = require("../service/Service");
+const app_sdk_1 = require("@zaiusinc/app-sdk");
+const TokenVerifier_1 = require("../auth/TokenVerifier");
+// Mock the dependencies
+jest.mock('../service/Service', () => ({
+    toolsService: {
+        processRequest: jest.fn(),
+    },
+}));
+jest.mock('../auth/TokenVerifier', () => ({
+    getTokenVerifier: jest.fn(),
+}));
+jest.mock('@zaiusinc/app-sdk', () => ({
+    Function: class {
+        request;
+        constructor(_name) {
+            this.request = {};
+        }
+    },
+    Request: jest.fn().mockImplementation(() => ({})),
+    Response: jest.fn().mockImplementation((status, data) => ({
+        status,
+        data,
+        bodyJSON: data,
+        bodyAsU8Array: new Uint8Array()
+    })),
+    amendLogContext: jest.fn(),
+    getAppContext: jest.fn(),
+    logger: {
+        info: jest.fn(),
+        error: jest.fn(),
+        warn: jest.fn(),
+        debug: jest.fn(),
+    },
+}));
+// Create a concrete implementation for testing
+class TestToolFunction extends ToolFunction_1.ToolFunction {
+    mockReady;
+    constructor(request) {
+        super(request || {});
+        this.request = request;
+        this.mockReady = jest.fn().mockResolvedValue(true);
+    }
+    // Override the ready method with mock implementation for testing
+    ready() {
+        return this.mockReady();
+    }
+    getRequest() {
+        return this.request;
+    }
+    getMockReady() {
+        return this.mockReady;
+    }
+}
+describe('ToolFunction', () => {
+    let mockRequest;
+    let mockResponse;
+    let toolFunction;
+    let mockProcessRequest;
+    let mockGetTokenVerifier;
+    let mockGetAppContext;
+    let mockTokenVerifier;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        // Create mock token verifier
+        mockTokenVerifier = {
+            verify: jest.fn(),
+        };
+        // Setup the mocks
+        mockProcessRequest = jest.mocked(Service_1.toolsService.processRequest);
+        mockGetTokenVerifier = jest.mocked(TokenVerifier_1.getTokenVerifier);
+        mockGetAppContext = jest.mocked(app_sdk_1.getAppContext);
+        mockGetTokenVerifier.mockResolvedValue(mockTokenVerifier);
+        mockGetAppContext.mockReturnValue({
+            account: {
+                organizationId: 'app-org-123'
+            }
+        });
+        // Create mock request with bodyJSON structure
+        mockRequest = {
+            headers: new Map(),
+            method: 'POST',
+            path: '/test',
+            bodyJSON: {
+                parameters: {
+                    task_id: 'task-123',
+                    content_id: 'content-456'
+                },
+                auth: {
+                    provider: 'OptiID',
+                    credentials: {
+                        token_type: 'Bearer',
+                        access_token: 'valid-access-token',
+                        org_sso_id: 'org-sso-123',
+                        user_id: 'user-456',
+                        instance_id: 'instance-789',
+                        customer_id: 'app-org-123',
+                        product_sku: 'OPAL'
+                    }
+                },
+                environment: {
+                    execution_mode: 'headless'
+                }
+            }
+        };
+        mockResponse = {};
+        toolFunction = new TestToolFunction(mockRequest);
+    });
+    // Helper function to create a ready request with valid auth
+    const createReadyRequestWithAuth = () => ({
+        headers: new Map(),
+        method: 'GET',
+        path: '/ready',
+        bodyJSON: {
+            auth: {
+                provider: 'OptiID',
+                credentials: {
+                    access_token: 'valid-token',
+                    customer_id: 'app-org-123'
+                }
+            }
+        }
+    });
+    // Helper function to setup authorization mocks to pass
+    const setupAuthMocks = () => {
+        mockTokenVerifier.verify.mockResolvedValue(true);
+        mockGetAppContext.mockReturnValue({
+            account: {
+                organizationId: 'app-org-123'
+            }
+        });
+    };
+    describe('/ready endpoint', () => {
+        beforeEach(() => {
+            setupAuthMocks();
+        });
+        it('should return ready: true when ready method returns true', async () => {
+            // Arrange
+            const readyRequest = createReadyRequestWithAuth();
+            toolFunction = new TestToolFunction(readyRequest);
+            toolFunction.getMockReady().mockResolvedValue(true);
+            // Act
+            const result = await toolFunction.perform();
+            // Assert
+            expect(toolFunction.getMockReady()).toHaveBeenCalledTimes(1);
+            expect(result).toEqual(new app_sdk_1.Response(200, { ready: true }));
+            expect(mockProcessRequest).not.toHaveBeenCalled(); // Should not call service
+        });
+        it('should return ready: false when ready method returns false', async () => {
+            // Arrange
+            const readyRequest = createReadyRequestWithAuth();
+            toolFunction = new TestToolFunction(readyRequest);
+            toolFunction.getMockReady().mockResolvedValue(false);
+            // Act
+            const result = await toolFunction.perform();
+            // Assert
+            expect(toolFunction.getMockReady()).toHaveBeenCalledTimes(1);
+            expect(result).toEqual(new app_sdk_1.Response(200, { ready: false }));
+            expect(mockProcessRequest).not.toHaveBeenCalled(); // Should not call service
+        });
+        it('should handle ready method throwing an error', async () => {
+            // Arrange
+            const readyRequest = createReadyRequestWithAuth();
+            toolFunction = new TestToolFunction(readyRequest);
+            toolFunction.getMockReady().mockRejectedValue(new Error('Ready check failed'));
+            // Act & Assert
+            await expect(toolFunction.perform()).rejects.toThrow('Ready check failed');
+            expect(toolFunction.getMockReady()).toHaveBeenCalledTimes(1);
+            expect(mockProcessRequest).not.toHaveBeenCalled(); // Should not call service
+        });
+        it('should use default ready implementation when not overridden', async () => {
+            // Create a class that doesn't override ready method
+            class DefaultReadyToolFunction extends ToolFunction_1.ToolFunction {
+                constructor(request) {
+                    super(request || {});
+                    this.request = request;
+                }
+                getRequest() {
+                    return this.request;
+                }
+            }
+            // Arrange
+            const readyRequest = createReadyRequestWithAuth();
+            const defaultToolFunction = new DefaultReadyToolFunction(readyRequest);
+            // Act
+            const result = await defaultToolFunction.perform();
+            // Assert - Default implementation should return true
+            expect(result).toEqual(new app_sdk_1.Response(200, { ready: true }));
+            expect(mockProcessRequest).not.toHaveBeenCalled(); // Should not call service
+        });
+    });
+    describe('perform', () => {
+        it('should execute successfully with valid token and matching organization', async () => {
+            // Setup mock token verifier to return true for valid token
+            mockTokenVerifier.verify.mockResolvedValue(true);
+            mockProcessRequest.mockResolvedValue(mockResponse);
+            const result = await toolFunction.perform();
+            expect(result).toBe(mockResponse);
+            expect(mockGetTokenVerifier).toHaveBeenCalled();
+            expect(mockTokenVerifier.verify).toHaveBeenCalledWith('valid-access-token');
+            expect(mockGetAppContext).toHaveBeenCalled();
+            expect(mockProcessRequest).toHaveBeenCalledWith(mockRequest, toolFunction);
+        });
+        it('should return 403 response with invalid token', async () => {
+            // Setup mock token verifier to return false
+            mockTokenVerifier.verify.mockResolvedValue(false);
+            const result = await toolFunction.perform();
+            expect(result).toEqual(new app_sdk_1.Response(403, { error: 'Forbidden' }));
+            expect(mockGetTokenVerifier).toHaveBeenCalled();
+            expect(mockTokenVerifier.verify).toHaveBeenCalledWith('valid-access-token');
+            expect(mockProcessRequest).not.toHaveBeenCalled();
+        });
+        it('should return 403 response when organization ID does not match', async () => {
+            // Update mock request with different customer_id
+            const requestWithDifferentOrgId = {
+                ...mockRequest,
+                bodyJSON: {
+                    ...mockRequest.bodyJSON,
+                    auth: {
+                        ...mockRequest.bodyJSON.auth,
+                        credentials: {
+                            ...mockRequest.bodyJSON.auth.credentials,
+                            customer_id: 'different-org-123'
+                        }
+                    }
+                }
+            };
+            const toolFunctionWithDifferentOrgId = new TestToolFunction(requestWithDifferentOrgId);
+            const result = await toolFunctionWithDifferentOrgId.perform();
+            expect(result).toEqual(new app_sdk_1.Response(403, { error: 'Forbidden' }));
+            expect(mockGetAppContext).toHaveBeenCalled();
+            expect(mockProcessRequest).not.toHaveBeenCalled();
+        });
+        it('should return 403 response when access token is missing', async () => {
+            // Create request without access token
+            const requestWithoutToken = {
+                ...mockRequest,
+                bodyJSON: {
+                    ...mockRequest.bodyJSON,
+                    auth: {
+                        ...mockRequest.bodyJSON.auth,
+                        credentials: {
+                            ...mockRequest.bodyJSON.auth.credentials,
+                            access_token: undefined
+                        }
+                    }
+                }
+            };
+            const toolFunctionWithoutToken = new TestToolFunction(requestWithoutToken);
+            const result = await toolFunctionWithoutToken.perform();
+            expect(result).toEqual(new app_sdk_1.Response(403, { error: 'Forbidden' }));
+            expect(mockGetTokenVerifier).not.toHaveBeenCalled();
+            expect(mockProcessRequest).not.toHaveBeenCalled();
+        });
+        it('should return 403 response when organisation id is missing', async () => {
+            // Create request without customer_id
+            const requestWithoutCustomerId = {
+                ...mockRequest,
+                bodyJSON: {
+                    ...mockRequest.bodyJSON,
+                    auth: {
+                        ...mockRequest.bodyJSON.auth,
+                        credentials: {
+                            ...mockRequest.bodyJSON.auth.credentials,
+                            customer_id: undefined
+                        }
+                    }
+                }
+            };
+            const toolFunctionWithoutCustomerId = new TestToolFunction(requestWithoutCustomerId);
+            const result = await toolFunctionWithoutCustomerId.perform();
+            expect(result).toEqual(new app_sdk_1.Response(403, { error: 'Forbidden' }));
+            expect(mockGetTokenVerifier).not.toHaveBeenCalled();
+            expect(mockProcessRequest).not.toHaveBeenCalled();
+        });
+        it('should return 403 response when auth structure is missing', async () => {
+            // Create request without auth structure
+            const requestWithoutAuth = {
+                ...mockRequest,
+                bodyJSON: {
+                    parameters: mockRequest.bodyJSON.parameters,
+                    environment: mockRequest.bodyJSON.environment
+                }
+            };
+            const toolFunctionWithoutAuth = new TestToolFunction(requestWithoutAuth);
+            const result = await toolFunctionWithoutAuth.perform();
+            expect(result).toEqual(new app_sdk_1.Response(403, { error: 'Forbidden' }));
+            expect(mockGetTokenVerifier).not.toHaveBeenCalled();
+            expect(mockProcessRequest).not.toHaveBeenCalled();
+        });
+        it('should return 403 response when token verifier initialization fails', async () => {
+            // Setup mock to fail during token verifier initialization
+            mockGetTokenVerifier.mockRejectedValue(new Error('Failed to initialize token verifier'));
+            const result = await toolFunction.perform();
+            expect(result).toEqual(new app_sdk_1.Response(403, { error: 'Forbidden' }));
+            expect(mockGetTokenVerifier).toHaveBeenCalled();
+            expect(mockProcessRequest).not.toHaveBeenCalled();
+        });
+    });
+    describe('inheritance', () => {
+        it('should be an instance of Function', () => {
+            // Assert
+            expect(toolFunction).toBeInstanceOf(ToolFunction_1.ToolFunction);
+        });
+        it('should have access to the request property', () => {
+            // Assert
+            expect(toolFunction.getRequest()).toBe(mockRequest);
+        });
+    });
+});
+//# sourceMappingURL=ToolFunction.test.js.map

package/dist/function/ToolFunction.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './function/ToolFunction';
+export * from './types/Models';
+export * from './decorator/Decorator';
+export * from './auth/TokenVerifier';
+export { Tool, Interaction, InteractionResult } from './service/Service';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractionResult = exports.Interaction = exports.Tool = void 0;
+__exportStar(require("./function/ToolFunction"), exports);
+__exportStar(require("./types/Models"), exports);
+__exportStar(require("./decorator/Decorator"), exports);
+__exportStar(require("./auth/TokenVerifier"), exports);
+var Service_1 = require("./service/Service");
+Object.defineProperty(exports, "Tool", { enumerable: true, get: function () { return Service_1.Tool; } });
+Object.defineProperty(exports, "Interaction", { enumerable: true, get: function () { return Service_1.Interaction; } });
+Object.defineProperty(exports, "InteractionResult", { enumerable: true, get: function () { return Service_1.InteractionResult; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,iDAA+B;AAC/B,wDAAsC;AACtC,uDAAqC;AACrC,6CAAyE;AAAhE,+FAAA,IAAI,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,4GAAA,iBAAiB,OAAA"}

package/dist/service/Service.d.ts

@@ -0,0 +1,80 @@
+import { AuthRequirement, Parameter } from '../types/Models';
+import * as App from '@zaiusinc/app-sdk';
+import { ToolFunction } from '../function/ToolFunction';
+import { GlobalToolFunction } from '../function/GlobalToolFunction';
+/**
+ * Result type for interaction handlers
+ */
+export declare class InteractionResult {
+    message: string;
+    link?: string | undefined;
+    constructor(message: string, link?: string | undefined);
+}
+/**
+ * Interaction definition for an Opal interaction
+ */
+export declare class Interaction<TAuthData> {
+    name: string;
+    endpoint: string;
+    handler: (functionContext: ToolFunction | GlobalToolFunction, data: unknown, authData?: TAuthData) => Promise<InteractionResult>;
+    constructor(name: string, endpoint: string, handler: (functionContext: ToolFunction | GlobalToolFunction, data: unknown, authData?: TAuthData) => Promise<InteractionResult>);
+}
+/**
+ * Tool definition for an Opal tool
+ */
+export declare class Tool<TAuthData> {
+    name: string;
+    description: string;
+    parameters: Parameter[];
+    endpoint: string;
+    handler: (functionContext: ToolFunction | GlobalToolFunction, params: unknown, authData?: TAuthData) => Promise<unknown>;
+    authRequirements: AuthRequirement[];
+    /**
+     * HTTP method for the endpoint (default: POST)
+     */
+    httpMethod: string;
+    /**
+     * Create a new function definition
+     * @param name Function name
+     * @param description Function description
+     * @param parameters Function parameters
+     * @param endpoint API endpoint
+     * @param handler Function implementing the tool
+     * @param authRequirements Authentication requirements (mandatory - OptiID enforced)
+     */
+    constructor(name: string, description: string, parameters: Parameter[], endpoint: string, handler: (functionContext: ToolFunction | GlobalToolFunction, params: unknown, authData?: TAuthData) => Promise<unknown>, authRequirements?: AuthRequirement[]);
+    /**
+     * Convert to JSON for the discovery endpoint
+     */
+    toJSON(): Record<string, unknown>;
+}
+export declare class ToolsService {
+    private functions;
+    private interactions;
+    /**
+     * Enforce OptiID authentication for tools by ensuring OptiID auth requirement is present
+     * @param authRequirements Original authentication requirements
+     * @returns Enforced authentication requirements with OptiID
+     */
+    private enforceOptiIdAuth;
+    /**
+     * Register a tool function with generic auth data
+     * @param name Tool name
+     * @param description Tool description
+     * @param handler Function implementing the tool
+     * @param parameters List of parameters for the tool
+     * @param endpoint API endpoint for the tool
+     * @param authRequirements Authentication requirements (optional)
+     */
+    registerTool<TAuthData>(name: string, description: string, handler: (functionContext: ToolFunction | GlobalToolFunction, params: unknown, authData?: TAuthData) => Promise<unknown>, parameters: Parameter[], endpoint: string, authRequirements?: AuthRequirement[]): void;
+    /**
+     * Register a tool interaction with generic auth data
+     * @param name Tool name
+     * @param handler Function implementing the tool
+     * @param endpoint API endpoint for the tool
+     */
+    registerInteraction<TAuthData>(name: string, handler: (functionContext: ToolFunction | GlobalToolFunction, data: unknown, authData?: TAuthData) => Promise<InteractionResult>, endpoint: string): void;
+    processRequest(req: App.Request, functionContext: ToolFunction | GlobalToolFunction): Promise<App.Response>;
+}
+export declare const toolsService: ToolsService;
+//# sourceMappingURL=Service.d.ts.map

package/dist/service/Service.d.ts.map

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

package/dist/service/Service.js

@@ -0,0 +1,210 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolsService = exports.ToolsService = exports.Tool = exports.Interaction = exports.InteractionResult = void 0;
+/* eslint-disable max-classes-per-file */
+const Models_1 = require("../types/Models");
+const App = __importStar(require("@zaiusinc/app-sdk"));
+const app_sdk_1 = require("@zaiusinc/app-sdk");
+/**
+ * Default OptiID authentication requirement that will be enforced for all tools
+ */
+const DEFAULT_OPTIID_AUTH = new Models_1.AuthRequirement('OptiID', 'default', true);
+/**
+ * Result type for interaction handlers
+ */
+class InteractionResult {
+    message;
+    link;
+    constructor(message, link) {
+        this.message = message;
+        this.link = link;
+    }
+}
+exports.InteractionResult = InteractionResult;
+/**
+ * Interaction definition for an Opal interaction
+ */
+class Interaction {
+    name;
+    endpoint;
+    handler;
+    constructor(name, endpoint, handler) {
+        this.name = name;
+        this.endpoint = endpoint;
+        this.handler = handler;
+    }
+}
+exports.Interaction = Interaction;
+/**
+ * Tool definition for an Opal tool
+ */
+class Tool {
+    name;
+    description;
+    parameters;
+    endpoint;
+    handler;
+    authRequirements;
+    /**
+     * HTTP method for the endpoint (default: POST)
+     */
+    httpMethod = 'POST';
+    /**
+     * Create a new function definition
+     * @param name Function name
+     * @param description Function description
+     * @param parameters Function parameters
+     * @param endpoint API endpoint
+     * @param handler Function implementing the tool
+     * @param authRequirements Authentication requirements (mandatory - OptiID enforced)
+     */
+    constructor(name, description, parameters, endpoint, handler, authRequirements = [DEFAULT_OPTIID_AUTH]) {
+        this.name = name;
+        this.description = description;
+        this.parameters = parameters;
+        this.endpoint = endpoint;
+        this.handler = handler;
+        this.authRequirements = authRequirements;
+    }
+    /**
+     * Convert to JSON for the discovery endpoint
+     */
+    toJSON() {
+        const result = {
+            name: this.name,
+            description: this.description,
+            parameters: this.parameters.map((p) => p.toJSON()),
+            endpoint: this.endpoint,
+            http_method: this.httpMethod,
+            auth_requirements: this.authRequirements.map((auth) => auth.toJSON())
+        };
+        return result;
+    }
+}
+exports.Tool = Tool;
+class ToolsService {
+    functions = new Map();
+    interactions = new Map();
+    /**
+     * Enforce OptiID authentication for tools by ensuring OptiID auth requirement is present
+     * @param authRequirements Original authentication requirements
+     * @returns Enforced authentication requirements with OptiID
+     */
+    enforceOptiIdAuth(authRequirements) {
+        const hasOptiIdProvider = authRequirements
+            && authRequirements.some((auth) => auth.provider.toLowerCase() === 'optiid');
+        if (hasOptiIdProvider) {
+            return authRequirements;
+        }
+        return [...(authRequirements || []), DEFAULT_OPTIID_AUTH];
+    }
+    /**
+     * Register a tool function with generic auth data
+     * @param name Tool name
+     * @param description Tool description
+     * @param handler Function implementing the tool
+     * @param parameters List of parameters for the tool
+     * @param endpoint API endpoint for the tool
+     * @param authRequirements Authentication requirements (optional)
+     */
+    registerTool(name, description, handler, parameters, endpoint, authRequirements) {
+        // Enforce OptiID authentication for all tools
+        const enforcedAuthRequirements = this.enforceOptiIdAuth(authRequirements);
+        const func = new Tool(name, description, parameters, endpoint, handler, enforcedAuthRequirements);
+        this.functions.set(endpoint, func);
+    }
+    /**
+     * Register a tool interaction with generic auth data
+     * @param name Tool name
+     * @param handler Function implementing the tool
+     * @param endpoint API endpoint for the tool
+     */
+    registerInteraction(name, handler, endpoint) {
+        const func = new Interaction(name, endpoint, handler);
+        this.interactions.set(endpoint, func);
+    }
+    async processRequest(req, functionContext) {
+        if (req.path === '/discovery') {
+            return new App.Response(200, { functions: Array.from(this.functions.values()).map((f) => f.toJSON()) });
+        }
+        else {
+            const func = this.functions.get(req.path);
+            if (func) {
+                try {
+                    let params;
+                    if (req.bodyJSON && req.bodyJSON.parameters) {
+                        params = req.bodyJSON.parameters;
+                    }
+                    else {
+                        params = req.bodyJSON;
+                    }
+                    // Extract auth data from body JSON
+                    const authData = req.bodyJSON ? req.bodyJSON.auth : undefined;
+                    const result = await func.handler(functionContext, params, authData);
+                    return new App.Response(200, result);
+                }
+                catch (error) {
+                    app_sdk_1.logger.error(`Error in function ${func.name}:`, error);
+                    return new App.Response(500, { error: error.message || 'Unknown error' });
+                }
+            }
+            const interaction = this.interactions.get(req.path);
+            if (interaction) {
+                try {
+                    let params;
+                    if (req.bodyJSON && req.bodyJSON.data) {
+                        params = req.bodyJSON.data;
+                    }
+                    else {
+                        params = req.bodyJSON;
+                    }
+                    // Extract auth data from body JSON
+                    const authData = req.bodyJSON ? req.bodyJSON.auth : undefined;
+                    const result = await interaction.handler(functionContext, params, authData);
+                    return new App.Response(200, result);
+                }
+                catch (error) {
+                    app_sdk_1.logger.error(`Error in function ${interaction.name}:`, error);
+                    return new App.Response(500, { error: error.message || 'Unknown error' });
+                }
+            }
+            return new App.Response(404, 'Function not found');
+        }
+    }
+}
+exports.ToolsService = ToolsService;
+exports.toolsService = new ToolsService();
+//# sourceMappingURL=Service.js.map