@forumviriumhelsinki/podio-mcp 2.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +491 -0
- package/build/__tests__/integration/setup.integration.d.ts +104 -0
- package/build/__tests__/integration/setup.integration.d.ts.map +1 -0
- package/build/__tests__/integration/setup.integration.js +233 -0
- package/build/__tests__/integration/setup.integration.js.map +1 -0
- package/build/__tests__/mock-data/items-mock-data.d.ts +168 -0
- package/build/__tests__/mock-data/items-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/items-mock-data.js +370 -0
- package/build/__tests__/mock-data/items-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/notification-mock-data.d.ts +55 -0
- package/build/__tests__/mock-data/notification-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/notification-mock-data.js +190 -0
- package/build/__tests__/mock-data/notification-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/project-epic-mock-data.d.ts +45 -0
- package/build/__tests__/mock-data/project-epic-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/project-epic-mock-data.js +85 -0
- package/build/__tests__/mock-data/project-epic-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/tasks-mock-data.d.ts +27 -0
- package/build/__tests__/mock-data/tasks-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/tasks-mock-data.js +104 -0
- package/build/__tests__/mock-data/tasks-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/utility-mock-data.d.ts +19 -0
- package/build/__tests__/mock-data/utility-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/utility-mock-data.js +165 -0
- package/build/__tests__/mock-data/utility-mock-data.js.map +1 -0
- package/build/__tests__/setup.d.ts +8 -0
- package/build/__tests__/setup.d.ts.map +1 -0
- package/build/__tests__/setup.js +31 -0
- package/build/__tests__/setup.js.map +1 -0
- package/build/__tests__/utils/test-helpers.d.ts +110 -0
- package/build/__tests__/utils/test-helpers.d.ts.map +1 -0
- package/build/__tests__/utils/test-helpers.js +222 -0
- package/build/__tests__/utils/test-helpers.js.map +1 -0
- package/build/api/podio-api-client.d.ts +364 -0
- package/build/api/podio-api-client.d.ts.map +1 -0
- package/build/api/podio-api-client.js +696 -0
- package/build/api/podio-api-client.js.map +1 -0
- package/build/cache/app-cache.d.ts +77 -0
- package/build/cache/app-cache.d.ts.map +1 -0
- package/build/cache/app-cache.js +230 -0
- package/build/cache/app-cache.js.map +1 -0
- package/build/cache/base-cache-manager.d.ts +149 -0
- package/build/cache/base-cache-manager.d.ts.map +1 -0
- package/build/cache/base-cache-manager.js +312 -0
- package/build/cache/base-cache-manager.js.map +1 -0
- package/build/cache/cache-manager.d.ts +230 -0
- package/build/cache/cache-manager.d.ts.map +1 -0
- package/build/cache/cache-manager.js +362 -0
- package/build/cache/cache-manager.js.map +1 -0
- package/build/cache/cache-test.d.ts +9 -0
- package/build/cache/cache-test.d.ts.map +1 -0
- package/build/cache/cache-test.js +169 -0
- package/build/cache/cache-test.js.map +1 -0
- package/build/cache/index.d.ts +18 -0
- package/build/cache/index.d.ts.map +1 -0
- package/build/cache/index.js +20 -0
- package/build/cache/index.js.map +1 -0
- package/build/cache/migration-helper.d.ts +44 -0
- package/build/cache/migration-helper.d.ts.map +1 -0
- package/build/cache/migration-helper.js +235 -0
- package/build/cache/migration-helper.js.map +1 -0
- package/build/cache/project-epic-cache.d.ts +108 -0
- package/build/cache/project-epic-cache.d.ts.map +1 -0
- package/build/cache/project-epic-cache.js +278 -0
- package/build/cache/project-epic-cache.js.map +1 -0
- package/build/cache/space-members-cache.d.ts +99 -0
- package/build/cache/space-members-cache.d.ts.map +1 -0
- package/build/cache/space-members-cache.js +305 -0
- package/build/cache/space-members-cache.js.map +1 -0
- package/build/cache/storage-adapters.d.ts +100 -0
- package/build/cache/storage-adapters.d.ts.map +1 -0
- package/build/cache/storage-adapters.js +297 -0
- package/build/cache/storage-adapters.js.map +1 -0
- package/build/errors/api-errors.d.ts +52 -0
- package/build/errors/api-errors.d.ts.map +1 -0
- package/build/errors/api-errors.js +86 -0
- package/build/errors/api-errors.js.map +1 -0
- package/build/errors/auth-errors.d.ts +67 -0
- package/build/errors/auth-errors.d.ts.map +1 -0
- package/build/errors/auth-errors.js +114 -0
- package/build/errors/auth-errors.js.map +1 -0
- package/build/errors/base.d.ts +102 -0
- package/build/errors/base.d.ts.map +1 -0
- package/build/errors/base.js +131 -0
- package/build/errors/base.js.map +1 -0
- package/build/errors/cache-errors.d.ts +53 -0
- package/build/errors/cache-errors.d.ts.map +1 -0
- package/build/errors/cache-errors.js +83 -0
- package/build/errors/cache-errors.js.map +1 -0
- package/build/errors/config-errors.d.ts +58 -0
- package/build/errors/config-errors.d.ts.map +1 -0
- package/build/errors/config-errors.js +96 -0
- package/build/errors/config-errors.js.map +1 -0
- package/build/errors/index.d.ts +101 -0
- package/build/errors/index.d.ts.map +1 -0
- package/build/errors/index.js +135 -0
- package/build/errors/index.js.map +1 -0
- package/build/errors/structure-errors.d.ts +89 -0
- package/build/errors/structure-errors.d.ts.map +1 -0
- package/build/errors/structure-errors.js +182 -0
- package/build/errors/structure-errors.js.map +1 -0
- package/build/errors/validation-errors.d.ts +81 -0
- package/build/errors/validation-errors.d.ts.map +1 -0
- package/build/errors/validation-errors.js +169 -0
- package/build/errors/validation-errors.js.map +1 -0
- package/build/fields/field-mapper.d.ts +245 -0
- package/build/fields/field-mapper.d.ts.map +1 -0
- package/build/fields/field-mapper.js +404 -0
- package/build/fields/field-mapper.js.map +1 -0
- package/build/index.d.ts +550 -0
- package/build/index.d.ts.map +1 -0
- package/build/index.js +1527 -0
- package/build/index.js.map +1 -0
- package/build/oauth-helper.d.ts +189 -0
- package/build/oauth-helper.d.ts.map +1 -0
- package/build/oauth-helper.js +422 -0
- package/build/oauth-helper.js.map +1 -0
- package/build/services/app-structure-service.d.ts +49 -0
- package/build/services/app-structure-service.d.ts.map +1 -0
- package/build/services/app-structure-service.js +122 -0
- package/build/services/app-structure-service.js.map +1 -0
- package/build/services/code-execution-service.d.ts +88 -0
- package/build/services/code-execution-service.d.ts.map +1 -0
- package/build/services/code-execution-service.js +342 -0
- package/build/services/code-execution-service.js.map +1 -0
- package/build/services/comment-service.d.ts +66 -0
- package/build/services/comment-service.d.ts.map +1 -0
- package/build/services/comment-service.js +139 -0
- package/build/services/comment-service.js.map +1 -0
- package/build/services/index.d.ts +16 -0
- package/build/services/index.d.ts.map +1 -0
- package/build/services/index.js +15 -0
- package/build/services/index.js.map +1 -0
- package/build/services/item-service.d.ts +104 -0
- package/build/services/item-service.d.ts.map +1 -0
- package/build/services/item-service.js +368 -0
- package/build/services/item-service.js.map +1 -0
- package/build/services/notification-service.d.ts +125 -0
- package/build/services/notification-service.d.ts.map +1 -0
- package/build/services/notification-service.js +321 -0
- package/build/services/notification-service.js.map +1 -0
- package/build/services/project-epic-service.d.ts +73 -0
- package/build/services/project-epic-service.d.ts.map +1 -0
- package/build/services/project-epic-service.js +248 -0
- package/build/services/project-epic-service.js.map +1 -0
- package/build/services/response-formatter.d.ts +190 -0
- package/build/services/response-formatter.d.ts.map +1 -0
- package/build/services/response-formatter.js +1221 -0
- package/build/services/response-formatter.js.map +1 -0
- package/build/services/search-service.d.ts +103 -0
- package/build/services/search-service.d.ts.map +1 -0
- package/build/services/search-service.js +273 -0
- package/build/services/search-service.js.map +1 -0
- package/build/services/task-service.d.ts +70 -0
- package/build/services/task-service.d.ts.map +1 -0
- package/build/services/task-service.js +156 -0
- package/build/services/task-service.js.map +1 -0
- package/build/tools/index.d.ts +8 -0
- package/build/tools/index.d.ts.map +1 -0
- package/build/tools/index.js +8 -0
- package/build/tools/index.js.map +1 -0
- package/build/tools/tool-definitions.d.ts +89 -0
- package/build/tools/tool-definitions.d.ts.map +1 -0
- package/build/tools/tool-definitions.js +1167 -0
- package/build/tools/tool-definitions.js.map +1 -0
- package/build/types/api-types.d.ts +106 -0
- package/build/types/api-types.d.ts.map +1 -0
- package/build/types/api-types.js +11 -0
- package/build/types/api-types.js.map +1 -0
- package/build/types/cache-types.d.ts +52 -0
- package/build/types/cache-types.d.ts.map +1 -0
- package/build/types/cache-types.js +12 -0
- package/build/types/cache-types.js.map +1 -0
- package/build/types/index.d.ts +31 -0
- package/build/types/index.d.ts.map +1 -0
- package/build/types/index.js +25 -0
- package/build/types/index.js.map +1 -0
- package/build/types/notification-types.d.ts +154 -0
- package/build/types/notification-types.d.ts.map +1 -0
- package/build/types/notification-types.js +7 -0
- package/build/types/notification-types.js.map +1 -0
- package/build/types/podio-types.d.ts +250 -0
- package/build/types/podio-types.d.ts.map +1 -0
- package/build/types/podio-types.js +11 -0
- package/build/types/podio-types.js.map +1 -0
- package/build/types/search-types.d.ts +188 -0
- package/build/types/search-types.d.ts.map +1 -0
- package/build/types/search-types.js +43 -0
- package/build/types/search-types.js.map +1 -0
- package/build/utils/debug.d.ts +58 -0
- package/build/utils/debug.d.ts.map +1 -0
- package/build/utils/debug.js +147 -0
- package/build/utils/debug.js.map +1 -0
- package/examples/claude-config-example.json +13 -0
- package/package.json +87 -0
- package/scripts/generate-claude-config.js +107 -0
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Task Service
|
|
3
|
+
*
|
|
4
|
+
* This service handles all task-related operations including CRUD operations,
|
|
5
|
+
* filtering, and user resolution.
|
|
6
|
+
*/
|
|
7
|
+
import { PodioValidationError } from '../errors/index.js';
|
|
8
|
+
/**
|
|
9
|
+
* Service class for handling task operations.
|
|
10
|
+
*
|
|
11
|
+
* This class encapsulates all task-related business logic and coordinates
|
|
12
|
+
* between the API client and cache manager.
|
|
13
|
+
*/
|
|
14
|
+
export class TaskService {
|
|
15
|
+
apiClient;
|
|
16
|
+
cacheManager;
|
|
17
|
+
constructor(apiClient, cacheManager) {
|
|
18
|
+
this.apiClient = apiClient;
|
|
19
|
+
this.cacheManager = cacheManager;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* List tasks with optional filtering
|
|
23
|
+
*/
|
|
24
|
+
async listTasks(filters = {}, spaceId) {
|
|
25
|
+
const { assigned_to, status, limit = 20 } = filters;
|
|
26
|
+
// Build filter parameters
|
|
27
|
+
const apiFilters = {};
|
|
28
|
+
if (assigned_to) {
|
|
29
|
+
if (assigned_to === 'me') {
|
|
30
|
+
apiFilters.responsible = '0'; // Current user
|
|
31
|
+
}
|
|
32
|
+
else {
|
|
33
|
+
const userId = await this.resolveUser(assigned_to);
|
|
34
|
+
apiFilters.responsible = userId || assigned_to;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
if (status) {
|
|
38
|
+
if (status === 'completed') {
|
|
39
|
+
apiFilters.completed = 'true';
|
|
40
|
+
}
|
|
41
|
+
else if (status === 'active') {
|
|
42
|
+
apiFilters.completed = 'false';
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
apiFilters.limit = limit.toString();
|
|
46
|
+
// Get tasks
|
|
47
|
+
const tasks = spaceId
|
|
48
|
+
? await this.apiClient.getTasks(spaceId, apiFilters)
|
|
49
|
+
: await this.apiClient.get('/task/', { headers: apiFilters });
|
|
50
|
+
return Array.isArray(tasks) ? tasks : tasks.data || [];
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Create a new task
|
|
54
|
+
*/
|
|
55
|
+
async createTask(taskData) {
|
|
56
|
+
const { text, description, due_date, assigned_to, ref_type, ref_id } = taskData;
|
|
57
|
+
if (!text) {
|
|
58
|
+
throw PodioValidationError.requiredField('text', 'create task');
|
|
59
|
+
}
|
|
60
|
+
const payload = { text };
|
|
61
|
+
if (description)
|
|
62
|
+
payload.description = description;
|
|
63
|
+
if (due_date)
|
|
64
|
+
payload.due_date = due_date;
|
|
65
|
+
if (ref_type && ref_id) {
|
|
66
|
+
payload.ref_type = ref_type;
|
|
67
|
+
payload.ref_id = ref_id;
|
|
68
|
+
}
|
|
69
|
+
if (assigned_to) {
|
|
70
|
+
const userId = await this.resolveUser(assigned_to);
|
|
71
|
+
payload.responsible = userId || assigned_to;
|
|
72
|
+
}
|
|
73
|
+
return await this.apiClient.createTask(payload);
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Create a task for a specific item
|
|
77
|
+
*/
|
|
78
|
+
async createTaskForItem(itemId, taskData) {
|
|
79
|
+
const { text, description, due_date, assigned_to } = taskData;
|
|
80
|
+
if (!itemId || !text) {
|
|
81
|
+
throw PodioValidationError.requiredField('item_id and text', 'create task for item');
|
|
82
|
+
}
|
|
83
|
+
const payload = { text };
|
|
84
|
+
if (description)
|
|
85
|
+
payload.description = description;
|
|
86
|
+
if (due_date)
|
|
87
|
+
payload.due_date = due_date;
|
|
88
|
+
if (assigned_to) {
|
|
89
|
+
const userId = await this.resolveUser(assigned_to);
|
|
90
|
+
payload.responsible = userId || assigned_to;
|
|
91
|
+
}
|
|
92
|
+
const response = await this.apiClient.post(`/task/item/${itemId}/`, payload);
|
|
93
|
+
return response.data;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Update an existing task
|
|
97
|
+
*/
|
|
98
|
+
async updateTask(taskId, updateData) {
|
|
99
|
+
const { text, description, due_date, completed } = updateData;
|
|
100
|
+
if (!taskId) {
|
|
101
|
+
throw PodioValidationError.requiredField('task_id', 'update task');
|
|
102
|
+
}
|
|
103
|
+
const payload = {};
|
|
104
|
+
let hasUpdates = false;
|
|
105
|
+
if (text) {
|
|
106
|
+
payload.text = text;
|
|
107
|
+
hasUpdates = true;
|
|
108
|
+
}
|
|
109
|
+
if (description !== undefined) {
|
|
110
|
+
payload.description = description;
|
|
111
|
+
hasUpdates = true;
|
|
112
|
+
}
|
|
113
|
+
if (due_date !== undefined) {
|
|
114
|
+
payload.due_date = due_date;
|
|
115
|
+
hasUpdates = true;
|
|
116
|
+
}
|
|
117
|
+
if (completed !== undefined) {
|
|
118
|
+
payload.completed = completed;
|
|
119
|
+
hasUpdates = true;
|
|
120
|
+
}
|
|
121
|
+
if (!hasUpdates) {
|
|
122
|
+
throw PodioValidationError.invalidFieldValue('No fields', 'provided for update', 'At least one field must be provided');
|
|
123
|
+
}
|
|
124
|
+
return await this.apiClient.updateTask(taskId, payload);
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* Delete a task
|
|
128
|
+
*/
|
|
129
|
+
async deleteTask(taskId) {
|
|
130
|
+
if (!taskId) {
|
|
131
|
+
throw PodioValidationError.requiredField('task_id', 'delete task');
|
|
132
|
+
}
|
|
133
|
+
await this.apiClient.deleteTask(taskId);
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* Get task details by ID
|
|
137
|
+
*/
|
|
138
|
+
async getTaskDetails(taskId) {
|
|
139
|
+
if (!taskId) {
|
|
140
|
+
throw PodioValidationError.requiredField('task_id', 'get task details');
|
|
141
|
+
}
|
|
142
|
+
const response = await this.apiClient.get(`/task/${taskId}`);
|
|
143
|
+
return response.data;
|
|
144
|
+
}
|
|
145
|
+
// ===============================
|
|
146
|
+
// HELPER METHODS
|
|
147
|
+
// ===============================
|
|
148
|
+
/**
|
|
149
|
+
* Resolve user by name or email to user ID
|
|
150
|
+
*/
|
|
151
|
+
async resolveUser(nameOrEmail) {
|
|
152
|
+
const user = await this.cacheManager.findUser(nameOrEmail);
|
|
153
|
+
return user ? user.member.user.user_id : null;
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
//# sourceMappingURL=task-service.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"task-service.js","sourceRoot":"","sources":["../../src/services/task-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tools Module Index
|
|
3
|
+
*
|
|
4
|
+
* This module exports the tool definitions and related utilities
|
|
5
|
+
* for use throughout the MCP server.
|
|
6
|
+
*/
|
|
7
|
+
export { ToolDefinitions, toolDefinitions, getAllTools, getToolByName, validateToolSchema, type ToolDefinition, type ToolSchema, type ToolCategory, } from './tool-definitions.js';
|
|
8
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tools Module Index
|
|
3
|
+
*
|
|
4
|
+
* This module exports the tool definitions and related utilities
|
|
5
|
+
* for use throughout the MCP server.
|
|
6
|
+
*/
|
|
7
|
+
export { ToolDefinitions, toolDefinitions, getAllTools, getToolByName, validateToolSchema, } from './tool-definitions.js';
|
|
8
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACb,kBAAkB,GAInB,MAAM,uBAAuB,CAAC"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool Definitions and Configuration
|
|
3
|
+
*
|
|
4
|
+
* This module provides a configuration-based system for defining MCP tools,
|
|
5
|
+
* organized by functional categories for better maintainability and testing.
|
|
6
|
+
*/
|
|
7
|
+
export interface ToolSchema {
|
|
8
|
+
type: 'object';
|
|
9
|
+
properties: Record<string, {
|
|
10
|
+
type: string;
|
|
11
|
+
description: string;
|
|
12
|
+
}>;
|
|
13
|
+
required?: string[];
|
|
14
|
+
}
|
|
15
|
+
export interface ToolDefinition {
|
|
16
|
+
name: string;
|
|
17
|
+
description: string;
|
|
18
|
+
inputSchema: ToolSchema;
|
|
19
|
+
category: string;
|
|
20
|
+
}
|
|
21
|
+
export interface ToolCategory {
|
|
22
|
+
name: string;
|
|
23
|
+
description: string;
|
|
24
|
+
tools: ToolDefinition[];
|
|
25
|
+
}
|
|
26
|
+
export declare class ToolDefinitions {
|
|
27
|
+
private static instance;
|
|
28
|
+
private readonly appManagement;
|
|
29
|
+
private readonly itemOperations;
|
|
30
|
+
private readonly taskManagement;
|
|
31
|
+
private readonly projectEpicManagement;
|
|
32
|
+
private readonly notificationManagement;
|
|
33
|
+
private readonly utilityTools;
|
|
34
|
+
private readonly searchOperations;
|
|
35
|
+
private readonly commentActivityOperations;
|
|
36
|
+
private readonly codeExecution;
|
|
37
|
+
private constructor();
|
|
38
|
+
/**
|
|
39
|
+
* Get singleton instance of ToolDefinitions
|
|
40
|
+
*/
|
|
41
|
+
static getInstance(): ToolDefinitions;
|
|
42
|
+
/**
|
|
43
|
+
* Get all tool categories
|
|
44
|
+
*/
|
|
45
|
+
getCategories(): ToolCategory[];
|
|
46
|
+
/**
|
|
47
|
+
* Get tools by category
|
|
48
|
+
*/
|
|
49
|
+
getToolsByCategory(categoryName: string): ToolDefinition[];
|
|
50
|
+
/**
|
|
51
|
+
* Get a specific tool definition by name
|
|
52
|
+
*/
|
|
53
|
+
getToolByName(toolName: string): ToolDefinition | undefined;
|
|
54
|
+
/**
|
|
55
|
+
* Get all tools as a flat array (compatible with MCP server)
|
|
56
|
+
*/
|
|
57
|
+
getAllTools(): ToolDefinition[];
|
|
58
|
+
getMcpTools(): Omit<ToolDefinition, 'category'>[];
|
|
59
|
+
/**
|
|
60
|
+
* Validate a tool's input schema
|
|
61
|
+
*/
|
|
62
|
+
validateToolSchema(toolName: string, input: any): {
|
|
63
|
+
valid: boolean;
|
|
64
|
+
errors: string[];
|
|
65
|
+
};
|
|
66
|
+
/**
|
|
67
|
+
* Get tool statistics
|
|
68
|
+
*/
|
|
69
|
+
getStatistics(): {
|
|
70
|
+
totalTools: number;
|
|
71
|
+
categoryCounts: Record<string, number>;
|
|
72
|
+
toolsWithRequiredParams: number;
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Export the singleton instance for easy use
|
|
77
|
+
*/
|
|
78
|
+
export declare const toolDefinitions: ToolDefinitions;
|
|
79
|
+
/**
|
|
80
|
+
* Export commonly used functions
|
|
81
|
+
*/
|
|
82
|
+
export declare const getAllTools: () => ToolDefinition[];
|
|
83
|
+
export declare const getMcpTools: () => Omit<ToolDefinition, "category">[];
|
|
84
|
+
export declare const getToolByName: (name: string) => ToolDefinition | undefined;
|
|
85
|
+
export declare const validateToolSchema: (toolName: string, input: any) => {
|
|
86
|
+
valid: boolean;
|
|
87
|
+
errors: string[];
|
|
88
|
+
};
|
|
89
|
+
//# sourceMappingURL=tool-definitions.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool-definitions.d.ts","sourceRoot":"","sources":["../../src/tools/tool-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QACE,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CACF,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IAGzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAmI5B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CA8P7B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CA0J7B;IAEF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAuDpC;IAEF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAsFrC;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAmC3B;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAoK/B;IAEF,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAiJxC;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CA0C5B;IAEF,OAAO;IAEP;;OAEG;WACW,WAAW,IAAI,eAAe;IAO5C;;OAEG;IACI,aAAa,IAAI,YAAY,EAAE;IActC;;OAEG;IACI,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE;IAOjE;;OAEG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKlE;;OAEG;IACI,WAAW,IAAI,cAAc,EAAE;IAU/B,WAAW,IAAI,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,EAAE;IAIxD;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAuC7F;;OAEG;IACI,aAAa,IAAI;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,uBAAuB,EAAE,MAAM,CAAC;KACjC;CAqBF;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAgC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,WAAW,wBAAsC,CAAC;AAC/D,eAAO,MAAM,WAAW,0CAAsC,CAAC;AAC/D,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,+BAAwC,CAAC;AACnF,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,EAAE,OAAO,GAAG;WAhFK,OAAO;YAAU,MAAM,EAAE;CAiFxC,CAAC"}
|