@pikku/core 0.8.1 → 0.9.0

package/src/wirings/mcp/mcp-endpoint-registry.test.js

@@ -0,0 +1,338 @@
+import { test, describe, beforeEach } from 'node:test';
+import * as assert from 'assert';
+import { MCPEndpointRegistry } from './mcp-endpoint-registry.js';
+describe('MCPEndpointRegistry', () => {
+    let registry;
+    beforeEach(() => {
+        registry = new MCPEndpointRegistry();
+    });
+    describe('constructor', () => {
+        test('should initialize with empty maps', () => {
+            assert.deepStrictEqual(registry.getTools(), []);
+            assert.deepStrictEqual(registry.getResources(), []);
+            assert.deepStrictEqual(registry.getPrompts(), []);
+        });
+    });
+    describe('loadFromMCPJson', () => {
+        test('should load tools from MCP JSON', async () => {
+            const mockData = {
+                tools: [
+                    {
+                        name: 'test-tool',
+                        title: 'Test Tool',
+                        description: 'A test tool',
+                        parameters: { type: 'object' },
+                        returns: { type: 'string' },
+                        enabled: true,
+                    },
+                ],
+            };
+            await registry.loadFromMCPJson(mockData);
+            const tools = registry.getTools();
+            assert.strictEqual(tools.length, 1);
+            assert.strictEqual(tools[0].name, 'test-tool');
+            assert.strictEqual(tools[0].title, 'Test Tool');
+            assert.strictEqual(tools[0].description, 'A test tool');
+            assert.deepStrictEqual(tools[0].inputSchema, { type: 'object' });
+            assert.deepStrictEqual(tools[0].outputSchema, { type: 'string' });
+            assert.strictEqual(tools[0].enabled, true);
+        });
+        test('should load resources from MCP JSON', async () => {
+            const mockData = {
+                resources: [
+                    {
+                        name: 'test-resource',
+                        uri: 'file://test.txt',
+                        description: 'A test resource',
+                        parameters: { type: 'object' },
+                        enabled: false,
+                    },
+                ],
+            };
+            await registry.loadFromMCPJson(mockData);
+            const resources = registry.getResources();
+            assert.strictEqual(resources.length, 1);
+            assert.strictEqual(resources[0].title, 'test-resource');
+            assert.strictEqual(resources[0].uri, 'file://test.txt');
+            assert.strictEqual(resources[0].description, 'A test resource');
+            assert.deepStrictEqual(resources[0].inputSchema, { type: 'object' });
+            assert.strictEqual(resources[0].enabled, false);
+        });
+        test('should load prompts from MCP JSON', async () => {
+            const mockData = {
+                prompts: [
+                    {
+                        name: 'test-prompt',
+                        description: 'A test prompt',
+                        arguments: { type: 'object' },
+                    },
+                ],
+            };
+            await registry.loadFromMCPJson(mockData);
+            const prompts = registry.getPrompts();
+            assert.strictEqual(prompts.length, 1);
+            assert.strictEqual(prompts[0].name, 'test-prompt');
+            assert.strictEqual(prompts[0].description, 'A test prompt');
+            assert.deepStrictEqual(prompts[0].inputSchema, { type: 'object' });
+            assert.strictEqual(prompts[0].enabled, true);
+        });
+        test('should handle tools with default enabled state', async () => {
+            const mockData = {
+                tools: [
+                    {
+                        name: 'default-tool',
+                        title: 'Default Tool',
+                        description: 'Tool with default enabled state',
+                    },
+                ],
+            };
+            await registry.loadFromMCPJson(mockData);
+            const tools = registry.getTools();
+            assert.strictEqual(tools.length, 1);
+            assert.strictEqual(tools[0].enabled, true);
+        });
+        test('should handle empty arrays', async () => {
+            const mockData = {
+                tools: [],
+                resources: [],
+                prompts: [],
+            };
+            await registry.loadFromMCPJson(mockData);
+            assert.deepStrictEqual(registry.getTools(), []);
+            assert.deepStrictEqual(registry.getResources(), []);
+            assert.deepStrictEqual(registry.getPrompts(), []);
+        });
+        test('should handle missing arrays', async () => {
+            const mockData = {};
+            await registry.loadFromMCPJson(mockData);
+            assert.deepStrictEqual(registry.getTools(), []);
+            assert.deepStrictEqual(registry.getResources(), []);
+            assert.deepStrictEqual(registry.getPrompts(), []);
+        });
+        test('should handle empty object gracefully', async () => {
+            await registry.loadFromMCPJson({});
+            assert.deepStrictEqual(registry.getTools(), []);
+            assert.deepStrictEqual(registry.getResources(), []);
+            assert.deepStrictEqual(registry.getPrompts(), []);
+        });
+    });
+    describe('meta setters and getters', () => {
+        test('should set and check resource meta', () => {
+            const meta = {
+                'test-resource': {
+                    uri: 'file://test.txt',
+                    title: 'Test Resource',
+                    description: 'Test description',
+                    pikkuFuncName: 'testResource',
+                    inputSchema: null,
+                    outputSchema: null,
+                    mimeType: 'text/plain',
+                },
+            };
+            registry.setResourcesMeta(meta);
+            assert.strictEqual(registry.hasResource('test-resource'), true);
+            assert.strictEqual(registry.hasResource('nonexistent'), false);
+        });
+        test('should set and check tool meta', () => {
+            const meta = {
+                'test-tool': {
+                    name: 'test-tool',
+                    title: 'Test Tool',
+                    description: 'Test description',
+                    pikkuFuncName: 'testTool',
+                    inputSchema: null,
+                    outputSchema: null,
+                },
+            };
+            registry.setToolsMeta(meta);
+            assert.strictEqual(registry.hasTool('test-tool'), true);
+            assert.strictEqual(registry.hasTool('nonexistent'), false);
+        });
+        test('should set and check prompt meta', () => {
+            const meta = {
+                'test-prompt': {
+                    name: 'test-prompt',
+                    description: 'Test Prompt',
+                    pikkuFuncName: 'testPrompt',
+                    inputSchema: null,
+                    outputSchema: null,
+                    arguments: [],
+                },
+            };
+            registry.setPromptsMeta(meta);
+            assert.strictEqual(registry.hasPrompt('test-prompt'), true);
+            assert.strictEqual(registry.hasPrompt('nonexistent'), false);
+        });
+    });
+    describe('individual item getters', () => {
+        beforeEach(async () => {
+            const mockData = {
+                tools: [
+                    {
+                        name: 'tool1',
+                        title: 'Tool 1',
+                        description: 'First tool',
+                        enabled: true,
+                    },
+                ],
+                resources: [
+                    {
+                        name: 'resource1',
+                        uri: 'file://resource1.txt',
+                        description: 'First resource',
+                        enabled: true,
+                    },
+                ],
+                prompts: [
+                    {
+                        name: 'prompt1',
+                        description: 'First prompt',
+                        enabled: true,
+                    },
+                ],
+            };
+            await registry.loadFromMCPJson(mockData);
+        });
+        test('should get tool by name', () => {
+            const tool = registry.getTool('tool1');
+            assert.strictEqual(tool?.name, 'tool1');
+            assert.strictEqual(tool?.title, 'Tool 1');
+            assert.strictEqual(registry.getTool('nonexistent'), undefined);
+        });
+        test('should get resource by name', () => {
+            const resource = registry.getResource('resource1');
+            assert.strictEqual(resource?.title, 'resource1');
+            assert.strictEqual(resource?.uri, 'file://resource1.txt');
+            assert.strictEqual(registry.getResource('nonexistent'), undefined);
+        });
+        test('should get prompt by name', () => {
+            const prompt = registry.getPrompt('prompt1');
+            assert.strictEqual(prompt?.name, 'prompt1');
+            assert.strictEqual(prompt?.description, 'First prompt');
+            assert.strictEqual(registry.getPrompt('nonexistent'), undefined);
+        });
+    });
+    describe('getTools filters enabled tools', () => {
+        test('should only return enabled tools', async () => {
+            const mockData = {
+                tools: [
+                    {
+                        name: 'enabled-tool',
+                        title: 'Enabled Tool',
+                        description: 'This tool is enabled',
+                        enabled: true,
+                    },
+                    {
+                        name: 'disabled-tool',
+                        title: 'Disabled Tool',
+                        description: 'This tool is disabled',
+                        enabled: false,
+                    },
+                ],
+            };
+            await registry.loadFromMCPJson(mockData);
+            const tools = registry.getTools();
+            assert.strictEqual(tools.length, 1);
+            assert.strictEqual(tools[0].name, 'enabled-tool');
+        });
+    });
+    describe('enable/disable methods', () => {
+        beforeEach(async () => {
+            const mockData = {
+                tools: [
+                    {
+                        name: 'tool1',
+                        title: 'Tool 1',
+                        description: 'First tool',
+                        enabled: true,
+                    },
+                    {
+                        name: 'tool2',
+                        title: 'Tool 2',
+                        description: 'Second tool',
+                        enabled: false,
+                    },
+                ],
+                resources: [
+                    {
+                        name: 'resource1',
+                        uri: 'file://resource1.txt',
+                        description: 'First resource',
+                        enabled: true,
+                    },
+                ],
+                prompts: [
+                    {
+                        name: 'prompt1',
+                        description: 'First prompt',
+                        enabled: true,
+                    },
+                ],
+            };
+            await registry.loadFromMCPJson(mockData);
+        });
+        test('should enable/disable tools and return change status', () => {
+            let changed = registry.enableTools({ tool1: false, tool2: true });
+            assert.strictEqual(changed, true);
+            const tool1 = registry.getTool('tool1');
+            const tool2 = registry.getTool('tool2');
+            assert.strictEqual(tool1?.enabled, false);
+            assert.strictEqual(tool2?.enabled, true);
+            changed = registry.enableTools({ tool1: false, tool2: true });
+            assert.strictEqual(changed, false);
+        });
+        test('should handle nonexistent tools', () => {
+            const changed = registry.enableTools({ nonexistent: true });
+            assert.strictEqual(changed, false);
+        });
+        test('should enable/disable prompts and return change status', () => {
+            let changed = registry.enablePrompts({ prompt1: false });
+            assert.strictEqual(changed, true);
+            const prompt1 = registry.getPrompt('prompt1');
+            assert.strictEqual(prompt1?.enabled, false);
+            changed = registry.enablePrompts({ prompt1: false });
+            assert.strictEqual(changed, false);
+        });
+        test('should handle nonexistent prompts', () => {
+            const changed = registry.enablePrompts({ nonexistent: true });
+            assert.strictEqual(changed, false);
+        });
+        test('should enable/disable resources', () => {
+            const changed = registry.enableResources({ resource1: false });
+            assert.strictEqual(changed, true);
+            const resource1 = registry.getResource('resource1');
+            assert.strictEqual(resource1?.enabled, false);
+        });
+    });
+    describe('edge cases', () => {
+        test('should handle null/undefined values in MCP JSON', async () => {
+            const mockData = {
+                tools: [
+                    {
+                        name: 'incomplete-tool',
+                        title: null,
+                        description: undefined,
+                    },
+                ],
+            };
+            await registry.loadFromMCPJson(mockData);
+            const tools = registry.getTools();
+            assert.strictEqual(tools.length, 1);
+            assert.strictEqual(tools[0].name, 'incomplete-tool');
+            assert.strictEqual(tools[0].title, null);
+            assert.strictEqual(tools[0].description, undefined);
+        });
+        test('should handle non-array values for tools/resources/prompts', async () => {
+            const mockData = {
+                tools: 'not an array',
+                resources: null,
+                prompts: undefined,
+            };
+            await registry.loadFromMCPJson(mockData);
+            assert.deepStrictEqual(registry.getTools(), []);
+            assert.deepStrictEqual(registry.getResources(), []);
+            assert.deepStrictEqual(registry.getPrompts(), []);
+        });
+    });
+});
+//# sourceMappingURL=mcp-endpoint-registry.test.js.map

package/src/wirings/mcp/mcp-endpoint-registry.test.js.map

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

package/src/{events → wirings}/mcp/mcp-endpoint-registry.ts

@@ -1,4 +1,3 @@
-import { readFile } from 'fs/promises'
 import { MCPResourceMeta, MCPToolMeta, MCPPromptMeta } from '@pikku/core'
 
 export interface MCPToolEndpoint {
@@ -34,15 +33,6 @@ export class MCPEndpointRegistry {
   private toolsMeta: MCPToolMeta = {}
   private promptsMeta: MCPPromptMeta = {}
 
-  async loadFromMCPJsonFile(mcpJsonPath: string): Promise<void> {
-    try {
-      const mcpJsonContent = await readFile(mcpJsonPath, 'utf-8')
-      await this.loadFromMCPJson(JSON.parse(mcpJsonContent))
-    } catch (error) {
-      throw new Error(`Failed to load MCP JSON from ${mcpJsonPath}: ${error}`)
-    }
-  }
-
   async loadFromMCPJson(mcpData: any): Promise<void> {
     if (mcpData.tools && Array.isArray(mcpData.tools)) {
       for (const tool of mcpData.tools) {

package/src/{events → wirings}/mcp/mcp-runner.ts

@@ -13,7 +13,7 @@ import type {
   JsonRpcErrorResponse,
   PikkuMCP,
 } from './mcp.types.js'
-import type { CoreAPIFunctionSessionless } from '../../function/functions.types.js'
+import type { CorePikkuFunctionSessionless } from '../../function/functions.types.js'
 import { getErrorResponse } from '../../errors/error-handler.js'
 import { closeSessionServices } from '../../utils.js'
 import { pikkuState } from '../../pikku-state.js'
@@ -46,10 +46,10 @@ export type JsonRpcError = {
   data?: any
 }
 
-export const addMCPResource = <
-  APIFunction extends CoreAPIFunctionSessionless<any, any>,
+export const wireMCPResource = <
+  PikkuFunction extends CorePikkuFunctionSessionless<any, any>,
 >(
-  mcpResource: CoreMCPResource<APIFunction>
+  mcpResource: CoreMCPResource<PikkuFunction>
 ) => {
   const resourcesMeta = pikkuState('mcp', 'resourcesMeta')
   const mcpResourceMeta = resourcesMeta[mcpResource.uri]
@@ -66,10 +66,10 @@ export const addMCPResource = <
   resources.set(mcpResource.uri, mcpResource)
 }
 
-export const addMCPTool = <
-  APIFunction extends CoreAPIFunctionSessionless<any, any>,
+export const wireMCPTool = <
+  PikkuFunction extends CorePikkuFunctionSessionless<any, any>,
 >(
-  mcpTool: CoreMCPTool<APIFunction>
+  mcpTool: CoreMCPTool<PikkuFunction>
 ) => {
   const toolsMeta = pikkuState('mcp', 'toolsMeta')
   const mcpToolMeta = toolsMeta[mcpTool.name]
@@ -86,10 +86,10 @@ export const addMCPTool = <
   tools.set(mcpTool.name, mcpTool)
 }
 
-export const addMCPPrompt = <
-  APIFunction extends CoreAPIFunctionSessionless<any, any>,
+export const wireMCPPrompt = <
+  PikkuFunction extends CorePikkuFunctionSessionless<any, any>,
 >(
-  mcpPrompt: CoreMCPPrompt<APIFunction>
+  mcpPrompt: CoreMCPPrompt<PikkuFunction>
 ) => {
   const promptsMeta = pikkuState('mcp', 'promptsMeta')
   const mcpPromptMeta = promptsMeta[mcpPrompt.name]

package/src/{events → wirings}/mcp/mcp.types.ts

@@ -1,4 +1,4 @@
-import { CoreAPIFunctionSessionless } from '../../function/functions.types.js'
+import { CorePikkuFunctionSessionless } from '../../function/functions.types.js'
 
 export type PikkuMCP<Tools extends string = any> = {
   // elicitInput: <Input>(message: string) => Promise<{ action: string, content: Input }>
@@ -54,7 +54,7 @@ export type MCPPromptMeta = Record<
  * Represents an MCP resource with specific properties.
  */
 export type CoreMCPResource<
-  APIFunction = CoreAPIFunctionSessionless<any, any>,
+  PikkuFunction = CorePikkuFunctionSessionless<any, any>,
 > = {
   uri: string
   title: string
@@ -62,19 +62,21 @@ export type CoreMCPResource<
   mimeType?: string
   size?: number
   streaming?: boolean
-  func: APIFunction
+  func: PikkuFunction
   tags?: string[]
 }
 
 /**
  * Represents an MCP tool with specific properties.
  */
-export type CoreMCPTool<APIFunction = CoreAPIFunctionSessionless<any, any>> = {
+export type CoreMCPTool<
+  PikkuFunction = CorePikkuFunctionSessionless<any, any>,
+> = {
   name: string
   title?: string
   description: string
   annotations?: Record<string, any>
-  func: APIFunction
+  func: PikkuFunction
   tags?: string[]
   streaming?: boolean
 }
@@ -83,11 +85,11 @@ export type CoreMCPTool<APIFunction = CoreAPIFunctionSessionless<any, any>> = {
  * Represents an MCP prompt with specific properties.
  */
 export type CoreMCPPrompt<
-  APIFunction = CoreAPIFunctionSessionless<any, MCPPromptResponse>,
+  PikkuFunction = CorePikkuFunctionSessionless<any, MCPPromptResponse>,
 > = {
   name: string
   description?: string
-  func: APIFunction
+  func: PikkuFunction
   tags?: string[]
 }
 

package/src/{events → wirings}/queue/index.ts

@@ -3,7 +3,7 @@ export type * from './queue.types.js'
 
 // Queue processor management
 export {
-  addQueueWorker,
+  wireQueueWorker,
   runQueueJob,
   getQueueWorkers,
   removeQueueWorker,

package/src/{events → wirings}/queue/queue-runner.ts

@@ -1,6 +1,6 @@
 import type { CoreServices } from '../../types/core.types.js'
 import type { CoreQueueWorker, QueueJob } from './queue.types.js'
-import type { CoreAPIFunctionSessionless } from '../../function/functions.types.js'
+import type { CorePikkuFunctionSessionless } from '../../function/functions.types.js'
 import { getErrorResponse } from '../../errors/error-handler.js'
 import { pikkuState } from '../../pikku-state.js'
 import { addFunction, runPikkuFunc } from '../../function/function-runner.js'
@@ -17,15 +17,15 @@ class QueueWorkerNotFoundError extends Error {
 /**
  * Add a queue processor to the system
  */
-export const addQueueWorker = <
+export const wireQueueWorker = <
   InputData = any,
   OutputData = any,
-  APIFunction extends CoreAPIFunctionSessionless<
+  PikkuFunction extends CorePikkuFunctionSessionless<
     InputData,
     OutputData
-  > = CoreAPIFunctionSessionless<InputData, OutputData>,
+  > = CorePikkuFunctionSessionless<InputData, OutputData>,
 >(
-  queueWorker: CoreQueueWorker<APIFunction>
+  queueWorker: CoreQueueWorker<PikkuFunction>
 ) => {
   // Get processor metadata
   const meta = pikkuState('queue', 'meta')

package/src/{events → wirings}/queue/queue.types.ts

@@ -1,5 +1,5 @@
 import { APIDocs } from '../../types/core.types.js'
-import { CoreAPIFunctionSessionless } from '../../function/functions.types.js'
+import { CorePikkuFunctionSessionless } from '../../function/functions.types.js'
 import { QueueConfigMapping } from './validate-worker-config.js'
 
 /**
@@ -165,10 +165,10 @@ export type queueWorkersMeta = Record<
  * Core queue processor definition
  */
 export type CoreQueueWorker<
-  APIFunction = CoreAPIFunctionSessionless<any, any>,
+  PikkuFunction = CorePikkuFunctionSessionless<any, any>,
 > = {
   queueName: string
-  func: APIFunction
+  func: PikkuFunction
   config?: PikkuWorkerConfig
   docs?: APIDocs
   session?: undefined

package/src/{events → wirings}/scheduler/index.ts

@@ -2,7 +2,7 @@ export * from './scheduler.types.js'
 
 export {
   runScheduledTask,
-  addScheduledTask,
+  wireScheduler,
   getScheduledTasks,
 } from './scheduler-runner.js'
 

package/src/{events → wirings}/scheduler/scheduler-runner.ts

@@ -5,7 +5,7 @@ import type {
   CreateSessionServices,
 } from '../../types/core.types.js'
 import type { CoreScheduledTask } from './scheduler.types.js'
-import type { CoreAPIFunctionSessionless } from '../../function/functions.types.js'
+import type { CorePikkuFunctionSessionless } from '../../function/functions.types.js'
 import { getErrorResponse } from '../../errors/error-handler.js'
 import { closeSessionServices } from '../../utils.js'
 import { pikkuState } from '../../pikku-state.js'
@@ -23,10 +23,10 @@ export type RunScheduledTasksParams = {
   >
 }
 
-export const addScheduledTask = <
-  APIFunction extends CoreAPIFunctionSessionless<void, void>,
+export const wireScheduler = <
+  PikkuFunction extends CorePikkuFunctionSessionless<void, void>,
 >(
-  scheduledTask: CoreScheduledTask<APIFunction>
+  scheduledTask: CoreScheduledTask<PikkuFunction>
 ) => {
   const meta = pikkuState('scheduler', 'meta')
   const taskMeta = meta[scheduledTask.name]

package/src/{events → wirings}/scheduler/scheduler.types.ts

@@ -1,5 +1,5 @@
 import { APIDocs, CoreUserSession } from '../../types/core.types.js'
-import { CoreAPIFunctionSessionless } from '../../function/functions.types.js'
+import { CorePikkuFunctionSessionless } from '../../function/functions.types.js'
 
 /**
  * Represents metadata for scheduled tasks, including title, schedule, and documentation.
@@ -21,11 +21,11 @@ export type ScheduledTasksMeta<UserSession extends CoreUserSession = any> =
  * Represents a core scheduled task.
  */
 export type CoreScheduledTask<
-  APIFunction = CoreAPIFunctionSessionless<void, void>,
+  PikkuFunction = CorePikkuFunctionSessionless<void, void>,
 > = {
   name: string
   schedule: string
-  func: APIFunction
+  func: PikkuFunction
   docs?: APIDocs
   tags?: string[]
 }