@vibescope/mcp-server 0.4.5 → 0.4.6
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/CHANGELOG.md +84 -84
- package/README.md +194 -194
- package/dist/api-client/project.d.ts +1 -0
- package/dist/api-client.d.ts +1 -0
- package/dist/cli-init.js +21 -21
- package/dist/cli.js +26 -26
- package/dist/handlers/chat.d.ts +2 -0
- package/dist/handlers/chat.js +25 -0
- package/dist/handlers/discovery.js +12 -0
- package/dist/handlers/project.js +4 -2
- package/dist/handlers/tool-docs.js +1203 -1137
- package/dist/index.js +73 -73
- package/dist/templates/agent-guidelines.d.ts +1 -1
- package/dist/templates/agent-guidelines.js +205 -187
- package/dist/templates/help-content.js +1621 -1621
- package/dist/tools/bodies-of-work.js +6 -6
- package/dist/tools/chat.d.ts +1 -0
- package/dist/tools/chat.js +24 -0
- package/dist/tools/cloud-agents.js +22 -22
- package/dist/tools/features.d.ts +13 -0
- package/dist/tools/features.js +151 -0
- package/dist/tools/index.d.ts +3 -1
- package/dist/tools/index.js +4 -1
- package/dist/tools/milestones.js +2 -2
- package/dist/tools/project.js +4 -0
- package/dist/tools/requests.js +1 -1
- package/dist/tools/session.js +11 -11
- package/dist/tools/sprints.js +9 -9
- package/dist/tools/tasks.js +35 -35
- package/dist/tools/worktrees.js +14 -14
- package/dist/tools.d.ts +2 -0
- package/dist/tools.js +3602 -0
- package/dist/utils.js +11 -11
- package/docs/TOOLS.md +2663 -2559
- package/package.json +53 -53
- package/scripts/generate-docs.ts +212 -212
- package/scripts/version-bump.ts +203 -203
- package/src/api-client/blockers.ts +86 -86
- package/src/api-client/bodies-of-work.ts +194 -194
- package/src/api-client/chat.ts +50 -50
- package/src/api-client/connectors.ts +152 -152
- package/src/api-client/cost.ts +185 -185
- package/src/api-client/decisions.ts +87 -87
- package/src/api-client/deployment.ts +313 -313
- package/src/api-client/discovery.ts +81 -81
- package/src/api-client/fallback.ts +52 -52
- package/src/api-client/file-checkouts.ts +115 -115
- package/src/api-client/findings.ts +100 -100
- package/src/api-client/git-issues.ts +88 -88
- package/src/api-client/ideas.ts +112 -112
- package/src/api-client/index.ts +592 -592
- package/src/api-client/milestones.ts +83 -83
- package/src/api-client/organizations.ts +185 -185
- package/src/api-client/progress.ts +94 -94
- package/src/api-client/project.ts +180 -179
- package/src/api-client/requests.ts +54 -54
- package/src/api-client/session.ts +220 -220
- package/src/api-client/sprints.ts +227 -227
- package/src/api-client/subtasks.ts +57 -57
- package/src/api-client/tasks.ts +450 -450
- package/src/api-client/types.ts +32 -32
- package/src/api-client/validation.ts +60 -60
- package/src/api-client/worktrees.ts +53 -53
- package/src/api-client.test.ts +847 -847
- package/src/api-client.ts +2707 -2706
- package/src/cli-init.ts +557 -557
- package/src/cli.test.ts +284 -284
- package/src/cli.ts +204 -204
- package/src/handlers/__test-setup__.ts +240 -240
- package/src/handlers/__test-utils__.ts +89 -89
- package/src/handlers/blockers.test.ts +468 -468
- package/src/handlers/blockers.ts +172 -172
- package/src/handlers/bodies-of-work.test.ts +704 -704
- package/src/handlers/bodies-of-work.ts +526 -526
- package/src/handlers/chat.test.ts +185 -185
- package/src/handlers/chat.ts +101 -69
- package/src/handlers/cloud-agents.test.ts +438 -438
- package/src/handlers/cloud-agents.ts +156 -156
- package/src/handlers/connectors.test.ts +834 -834
- package/src/handlers/connectors.ts +229 -229
- package/src/handlers/cost.test.ts +462 -462
- package/src/handlers/cost.ts +285 -285
- package/src/handlers/decisions.test.ts +382 -382
- package/src/handlers/decisions.ts +153 -153
- package/src/handlers/deployment.test.ts +551 -551
- package/src/handlers/deployment.ts +570 -570
- package/src/handlers/discovery.test.ts +206 -206
- package/src/handlers/discovery.ts +427 -415
- package/src/handlers/fallback.test.ts +537 -537
- package/src/handlers/fallback.ts +194 -194
- package/src/handlers/file-checkouts.test.ts +750 -750
- package/src/handlers/file-checkouts.ts +185 -185
- package/src/handlers/findings.test.ts +633 -633
- package/src/handlers/findings.ts +239 -239
- package/src/handlers/git-issues.test.ts +631 -631
- package/src/handlers/git-issues.ts +136 -136
- package/src/handlers/ideas.test.ts +644 -644
- package/src/handlers/ideas.ts +207 -207
- package/src/handlers/index.ts +93 -93
- package/src/handlers/milestones.test.ts +475 -475
- package/src/handlers/milestones.ts +180 -180
- package/src/handlers/organizations.test.ts +826 -826
- package/src/handlers/organizations.ts +315 -315
- package/src/handlers/progress.test.ts +269 -269
- package/src/handlers/progress.ts +77 -77
- package/src/handlers/project.test.ts +546 -546
- package/src/handlers/project.ts +242 -239
- package/src/handlers/requests.test.ts +303 -303
- package/src/handlers/requests.ts +99 -99
- package/src/handlers/roles.test.ts +305 -305
- package/src/handlers/roles.ts +219 -219
- package/src/handlers/session.test.ts +998 -998
- package/src/handlers/session.ts +1105 -1105
- package/src/handlers/sprints.test.ts +732 -732
- package/src/handlers/sprints.ts +537 -537
- package/src/handlers/tasks.test.ts +931 -931
- package/src/handlers/tasks.ts +1133 -1133
- package/src/handlers/tool-categories.test.ts +66 -66
- package/src/handlers/tool-docs.test.ts +511 -511
- package/src/handlers/tool-docs.ts +1571 -1499
- package/src/handlers/types.test.ts +259 -259
- package/src/handlers/types.ts +176 -176
- package/src/handlers/validation.test.ts +582 -582
- package/src/handlers/validation.ts +164 -164
- package/src/handlers/version.ts +63 -63
- package/src/index.test.ts +674 -674
- package/src/index.ts +807 -807
- package/src/setup.test.ts +233 -233
- package/src/setup.ts +404 -404
- package/src/templates/agent-guidelines.ts +233 -215
- package/src/templates/help-content.ts +1751 -1751
- package/src/token-tracking.test.ts +463 -463
- package/src/token-tracking.ts +167 -167
- package/src/tools/blockers.ts +122 -122
- package/src/tools/bodies-of-work.ts +283 -283
- package/src/tools/chat.ts +72 -46
- package/src/tools/cloud-agents.ts +101 -101
- package/src/tools/connectors.ts +191 -191
- package/src/tools/cost.ts +111 -111
- package/src/tools/decisions.ts +111 -111
- package/src/tools/deployment.ts +455 -455
- package/src/tools/discovery.ts +76 -76
- package/src/tools/fallback.ts +111 -111
- package/src/tools/features.ts +154 -0
- package/src/tools/file-checkouts.ts +145 -145
- package/src/tools/findings.ts +101 -101
- package/src/tools/git-issues.ts +130 -130
- package/src/tools/ideas.ts +162 -162
- package/src/tools/index.ts +141 -137
- package/src/tools/milestones.ts +118 -118
- package/src/tools/organizations.ts +224 -224
- package/src/tools/progress.ts +73 -73
- package/src/tools/project.ts +206 -202
- package/src/tools/requests.ts +68 -68
- package/src/tools/roles.ts +112 -112
- package/src/tools/session.ts +181 -181
- package/src/tools/sprints.ts +298 -298
- package/src/tools/tasks.ts +550 -550
- package/src/tools/tools.test.ts +222 -222
- package/src/tools/types.ts +9 -9
- package/src/tools/validation.ts +75 -75
- package/src/tools/version.ts +34 -34
- package/src/tools/worktrees.ts +66 -66
- package/src/tools.test.ts +416 -416
- package/src/utils.test.ts +1014 -1014
- package/src/utils.ts +586 -586
- package/src/validators.test.ts +223 -223
- package/src/validators.ts +249 -249
- package/src/version.ts +109 -109
- package/tsconfig.json +16 -16
- package/vitest.config.ts +14 -14
|
@@ -1,152 +1,152 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Connectors API Methods
|
|
3
|
-
*
|
|
4
|
-
* Methods for external integrations (Slack, Discord, webhooks, etc.):
|
|
5
|
-
* - getConnectors: List connectors for a project
|
|
6
|
-
* - getConnector: Get a single connector
|
|
7
|
-
* - addConnector: Add a new connector
|
|
8
|
-
* - updateConnector: Update connector configuration
|
|
9
|
-
* - deleteConnector: Delete a connector
|
|
10
|
-
* - testConnector: Send a test event to a connector
|
|
11
|
-
* - getConnectorEvents: Get event history for a connector
|
|
12
|
-
*/
|
|
13
|
-
|
|
14
|
-
import type { ApiResponse, ProxyFn } from './types.js';
|
|
15
|
-
|
|
16
|
-
export interface ConnectorsMethods {
|
|
17
|
-
getConnectors(projectId: string, params?: {
|
|
18
|
-
type?: string;
|
|
19
|
-
status?: string;
|
|
20
|
-
limit?: number;
|
|
21
|
-
offset?: number;
|
|
22
|
-
}): Promise<ApiResponse<{
|
|
23
|
-
connectors: Array<{
|
|
24
|
-
id: string;
|
|
25
|
-
name: string;
|
|
26
|
-
type: string;
|
|
27
|
-
description?: string;
|
|
28
|
-
status: string;
|
|
29
|
-
events: Record<string, boolean>;
|
|
30
|
-
events_sent: number;
|
|
31
|
-
last_triggered_at?: string;
|
|
32
|
-
last_error?: string;
|
|
33
|
-
last_error_at?: string;
|
|
34
|
-
created_at: string;
|
|
35
|
-
}>;
|
|
36
|
-
total_count: number;
|
|
37
|
-
has_more: boolean;
|
|
38
|
-
}>>;
|
|
39
|
-
|
|
40
|
-
getConnector(connectorId: string): Promise<ApiResponse<{
|
|
41
|
-
connector: {
|
|
42
|
-
id: string;
|
|
43
|
-
name: string;
|
|
44
|
-
type: string;
|
|
45
|
-
description?: string;
|
|
46
|
-
config: Record<string, unknown>;
|
|
47
|
-
events: Record<string, boolean>;
|
|
48
|
-
status: string;
|
|
49
|
-
events_sent: number;
|
|
50
|
-
last_triggered_at?: string;
|
|
51
|
-
last_error?: string;
|
|
52
|
-
last_error_at?: string;
|
|
53
|
-
created_at: string;
|
|
54
|
-
};
|
|
55
|
-
}>>;
|
|
56
|
-
|
|
57
|
-
addConnector(projectId: string, params: {
|
|
58
|
-
name: string;
|
|
59
|
-
type: string;
|
|
60
|
-
description?: string;
|
|
61
|
-
config?: Record<string, unknown>;
|
|
62
|
-
events?: Record<string, boolean>;
|
|
63
|
-
}): Promise<ApiResponse<{
|
|
64
|
-
success: boolean;
|
|
65
|
-
connector_id: string;
|
|
66
|
-
}>>;
|
|
67
|
-
|
|
68
|
-
updateConnector(connectorId: string, updates: {
|
|
69
|
-
name?: string;
|
|
70
|
-
description?: string;
|
|
71
|
-
config?: Record<string, unknown>;
|
|
72
|
-
events?: Record<string, boolean>;
|
|
73
|
-
status?: string;
|
|
74
|
-
}): Promise<ApiResponse<{
|
|
75
|
-
success: boolean;
|
|
76
|
-
connector_id: string;
|
|
77
|
-
}>>;
|
|
78
|
-
|
|
79
|
-
deleteConnector(connectorId: string): Promise<ApiResponse<{
|
|
80
|
-
success: boolean;
|
|
81
|
-
}>>;
|
|
82
|
-
|
|
83
|
-
testConnector(connectorId: string): Promise<ApiResponse<{
|
|
84
|
-
success: boolean;
|
|
85
|
-
event_id: string;
|
|
86
|
-
status?: number;
|
|
87
|
-
error?: string;
|
|
88
|
-
}>>;
|
|
89
|
-
|
|
90
|
-
getConnectorEvents(params: {
|
|
91
|
-
connector_id?: string;
|
|
92
|
-
project_id?: string;
|
|
93
|
-
status?: string;
|
|
94
|
-
limit?: number;
|
|
95
|
-
offset?: number;
|
|
96
|
-
}): Promise<ApiResponse<{
|
|
97
|
-
events: Array<{
|
|
98
|
-
id: string;
|
|
99
|
-
connector_id: string;
|
|
100
|
-
event_type: string;
|
|
101
|
-
status: string;
|
|
102
|
-
response_status?: number;
|
|
103
|
-
error_message?: string;
|
|
104
|
-
attempts: number;
|
|
105
|
-
created_at: string;
|
|
106
|
-
sent_at?: string;
|
|
107
|
-
}>;
|
|
108
|
-
total_count: number;
|
|
109
|
-
has_more: boolean;
|
|
110
|
-
}>>;
|
|
111
|
-
}
|
|
112
|
-
|
|
113
|
-
export function createConnectorsMethods(proxy: ProxyFn): ConnectorsMethods {
|
|
114
|
-
return {
|
|
115
|
-
async getConnectors(projectId, params) {
|
|
116
|
-
return proxy('get_connectors', {
|
|
117
|
-
project_id: projectId,
|
|
118
|
-
...params
|
|
119
|
-
});
|
|
120
|
-
},
|
|
121
|
-
|
|
122
|
-
async getConnector(connectorId) {
|
|
123
|
-
return proxy('get_connector', { connector_id: connectorId });
|
|
124
|
-
},
|
|
125
|
-
|
|
126
|
-
async addConnector(projectId, params) {
|
|
127
|
-
return proxy('add_connector', {
|
|
128
|
-
project_id: projectId,
|
|
129
|
-
...params
|
|
130
|
-
});
|
|
131
|
-
},
|
|
132
|
-
|
|
133
|
-
async updateConnector(connectorId, updates) {
|
|
134
|
-
return proxy('update_connector', {
|
|
135
|
-
connector_id: connectorId,
|
|
136
|
-
...updates
|
|
137
|
-
});
|
|
138
|
-
},
|
|
139
|
-
|
|
140
|
-
async deleteConnector(connectorId) {
|
|
141
|
-
return proxy('delete_connector', { connector_id: connectorId });
|
|
142
|
-
},
|
|
143
|
-
|
|
144
|
-
async testConnector(connectorId) {
|
|
145
|
-
return proxy('test_connector', { connector_id: connectorId });
|
|
146
|
-
},
|
|
147
|
-
|
|
148
|
-
async getConnectorEvents(params) {
|
|
149
|
-
return proxy('get_connector_events', params as Record<string, unknown>);
|
|
150
|
-
}
|
|
151
|
-
};
|
|
152
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Connectors API Methods
|
|
3
|
+
*
|
|
4
|
+
* Methods for external integrations (Slack, Discord, webhooks, etc.):
|
|
5
|
+
* - getConnectors: List connectors for a project
|
|
6
|
+
* - getConnector: Get a single connector
|
|
7
|
+
* - addConnector: Add a new connector
|
|
8
|
+
* - updateConnector: Update connector configuration
|
|
9
|
+
* - deleteConnector: Delete a connector
|
|
10
|
+
* - testConnector: Send a test event to a connector
|
|
11
|
+
* - getConnectorEvents: Get event history for a connector
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
import type { ApiResponse, ProxyFn } from './types.js';
|
|
15
|
+
|
|
16
|
+
export interface ConnectorsMethods {
|
|
17
|
+
getConnectors(projectId: string, params?: {
|
|
18
|
+
type?: string;
|
|
19
|
+
status?: string;
|
|
20
|
+
limit?: number;
|
|
21
|
+
offset?: number;
|
|
22
|
+
}): Promise<ApiResponse<{
|
|
23
|
+
connectors: Array<{
|
|
24
|
+
id: string;
|
|
25
|
+
name: string;
|
|
26
|
+
type: string;
|
|
27
|
+
description?: string;
|
|
28
|
+
status: string;
|
|
29
|
+
events: Record<string, boolean>;
|
|
30
|
+
events_sent: number;
|
|
31
|
+
last_triggered_at?: string;
|
|
32
|
+
last_error?: string;
|
|
33
|
+
last_error_at?: string;
|
|
34
|
+
created_at: string;
|
|
35
|
+
}>;
|
|
36
|
+
total_count: number;
|
|
37
|
+
has_more: boolean;
|
|
38
|
+
}>>;
|
|
39
|
+
|
|
40
|
+
getConnector(connectorId: string): Promise<ApiResponse<{
|
|
41
|
+
connector: {
|
|
42
|
+
id: string;
|
|
43
|
+
name: string;
|
|
44
|
+
type: string;
|
|
45
|
+
description?: string;
|
|
46
|
+
config: Record<string, unknown>;
|
|
47
|
+
events: Record<string, boolean>;
|
|
48
|
+
status: string;
|
|
49
|
+
events_sent: number;
|
|
50
|
+
last_triggered_at?: string;
|
|
51
|
+
last_error?: string;
|
|
52
|
+
last_error_at?: string;
|
|
53
|
+
created_at: string;
|
|
54
|
+
};
|
|
55
|
+
}>>;
|
|
56
|
+
|
|
57
|
+
addConnector(projectId: string, params: {
|
|
58
|
+
name: string;
|
|
59
|
+
type: string;
|
|
60
|
+
description?: string;
|
|
61
|
+
config?: Record<string, unknown>;
|
|
62
|
+
events?: Record<string, boolean>;
|
|
63
|
+
}): Promise<ApiResponse<{
|
|
64
|
+
success: boolean;
|
|
65
|
+
connector_id: string;
|
|
66
|
+
}>>;
|
|
67
|
+
|
|
68
|
+
updateConnector(connectorId: string, updates: {
|
|
69
|
+
name?: string;
|
|
70
|
+
description?: string;
|
|
71
|
+
config?: Record<string, unknown>;
|
|
72
|
+
events?: Record<string, boolean>;
|
|
73
|
+
status?: string;
|
|
74
|
+
}): Promise<ApiResponse<{
|
|
75
|
+
success: boolean;
|
|
76
|
+
connector_id: string;
|
|
77
|
+
}>>;
|
|
78
|
+
|
|
79
|
+
deleteConnector(connectorId: string): Promise<ApiResponse<{
|
|
80
|
+
success: boolean;
|
|
81
|
+
}>>;
|
|
82
|
+
|
|
83
|
+
testConnector(connectorId: string): Promise<ApiResponse<{
|
|
84
|
+
success: boolean;
|
|
85
|
+
event_id: string;
|
|
86
|
+
status?: number;
|
|
87
|
+
error?: string;
|
|
88
|
+
}>>;
|
|
89
|
+
|
|
90
|
+
getConnectorEvents(params: {
|
|
91
|
+
connector_id?: string;
|
|
92
|
+
project_id?: string;
|
|
93
|
+
status?: string;
|
|
94
|
+
limit?: number;
|
|
95
|
+
offset?: number;
|
|
96
|
+
}): Promise<ApiResponse<{
|
|
97
|
+
events: Array<{
|
|
98
|
+
id: string;
|
|
99
|
+
connector_id: string;
|
|
100
|
+
event_type: string;
|
|
101
|
+
status: string;
|
|
102
|
+
response_status?: number;
|
|
103
|
+
error_message?: string;
|
|
104
|
+
attempts: number;
|
|
105
|
+
created_at: string;
|
|
106
|
+
sent_at?: string;
|
|
107
|
+
}>;
|
|
108
|
+
total_count: number;
|
|
109
|
+
has_more: boolean;
|
|
110
|
+
}>>;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
export function createConnectorsMethods(proxy: ProxyFn): ConnectorsMethods {
|
|
114
|
+
return {
|
|
115
|
+
async getConnectors(projectId, params) {
|
|
116
|
+
return proxy('get_connectors', {
|
|
117
|
+
project_id: projectId,
|
|
118
|
+
...params
|
|
119
|
+
});
|
|
120
|
+
},
|
|
121
|
+
|
|
122
|
+
async getConnector(connectorId) {
|
|
123
|
+
return proxy('get_connector', { connector_id: connectorId });
|
|
124
|
+
},
|
|
125
|
+
|
|
126
|
+
async addConnector(projectId, params) {
|
|
127
|
+
return proxy('add_connector', {
|
|
128
|
+
project_id: projectId,
|
|
129
|
+
...params
|
|
130
|
+
});
|
|
131
|
+
},
|
|
132
|
+
|
|
133
|
+
async updateConnector(connectorId, updates) {
|
|
134
|
+
return proxy('update_connector', {
|
|
135
|
+
connector_id: connectorId,
|
|
136
|
+
...updates
|
|
137
|
+
});
|
|
138
|
+
},
|
|
139
|
+
|
|
140
|
+
async deleteConnector(connectorId) {
|
|
141
|
+
return proxy('delete_connector', { connector_id: connectorId });
|
|
142
|
+
},
|
|
143
|
+
|
|
144
|
+
async testConnector(connectorId) {
|
|
145
|
+
return proxy('test_connector', { connector_id: connectorId });
|
|
146
|
+
},
|
|
147
|
+
|
|
148
|
+
async getConnectorEvents(params) {
|
|
149
|
+
return proxy('get_connector_events', params as Record<string, unknown>);
|
|
150
|
+
}
|
|
151
|
+
};
|
|
152
|
+
}
|
package/src/api-client/cost.ts
CHANGED
|
@@ -1,185 +1,185 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Cost API Methods
|
|
3
|
-
*
|
|
4
|
-
* Methods for cost tracking and alerts:
|
|
5
|
-
* - getCostSummary: Get cost summary by period
|
|
6
|
-
* - getCostAlerts: List cost alerts
|
|
7
|
-
* - addCostAlert: Create a cost alert
|
|
8
|
-
* - updateCostAlert: Update a cost alert
|
|
9
|
-
* - deleteCostAlert: Delete a cost alert
|
|
10
|
-
* - getTaskCosts: Get costs by task
|
|
11
|
-
* - getBodyOfWorkCosts: Get costs by body of work
|
|
12
|
-
* - getSprintCosts: Get costs by sprint
|
|
13
|
-
* - getTokenUsage: Get token usage stats
|
|
14
|
-
* - reportTokenUsage: Report token usage
|
|
15
|
-
*/
|
|
16
|
-
|
|
17
|
-
import type { ApiResponse, RequestFn } from './types.js';
|
|
18
|
-
|
|
19
|
-
export interface CostMethods {
|
|
20
|
-
getCostSummary(projectId: string, params?: {
|
|
21
|
-
period?: 'daily' | 'weekly' | 'monthly';
|
|
22
|
-
limit?: number;
|
|
23
|
-
}): Promise<ApiResponse<{
|
|
24
|
-
summary: Array<{
|
|
25
|
-
period: string;
|
|
26
|
-
total_cost: number;
|
|
27
|
-
input_tokens: number;
|
|
28
|
-
output_tokens: number;
|
|
29
|
-
api_calls: number;
|
|
30
|
-
}>;
|
|
31
|
-
}>>;
|
|
32
|
-
|
|
33
|
-
getCostAlerts(): Promise<ApiResponse<{
|
|
34
|
-
alerts: Array<{
|
|
35
|
-
id: string;
|
|
36
|
-
project_id?: string;
|
|
37
|
-
threshold_amount: number;
|
|
38
|
-
threshold_period: string;
|
|
39
|
-
alert_type: string;
|
|
40
|
-
enabled: boolean;
|
|
41
|
-
}>;
|
|
42
|
-
}>>;
|
|
43
|
-
|
|
44
|
-
addCostAlert(params: {
|
|
45
|
-
project_id?: string;
|
|
46
|
-
threshold_amount: number;
|
|
47
|
-
threshold_period: 'daily' | 'weekly' | 'monthly';
|
|
48
|
-
alert_type?: 'warning' | 'critical';
|
|
49
|
-
}): Promise<ApiResponse<{
|
|
50
|
-
success: boolean;
|
|
51
|
-
alert_id: string;
|
|
52
|
-
}>>;
|
|
53
|
-
|
|
54
|
-
updateCostAlert(alertId: string, updates: {
|
|
55
|
-
threshold_amount?: number;
|
|
56
|
-
threshold_period?: 'daily' | 'weekly' | 'monthly';
|
|
57
|
-
alert_type?: 'warning' | 'critical';
|
|
58
|
-
enabled?: boolean;
|
|
59
|
-
}): Promise<ApiResponse<{
|
|
60
|
-
success: boolean;
|
|
61
|
-
alert_id: string;
|
|
62
|
-
}>>;
|
|
63
|
-
|
|
64
|
-
deleteCostAlert(alertId: string): Promise<ApiResponse<{
|
|
65
|
-
success: boolean;
|
|
66
|
-
}>>;
|
|
67
|
-
|
|
68
|
-
getTaskCosts(projectId: string, limit?: number): Promise<ApiResponse<{
|
|
69
|
-
tasks: Array<{
|
|
70
|
-
task_id: string;
|
|
71
|
-
task_title: string;
|
|
72
|
-
total_cost: number;
|
|
73
|
-
input_tokens: number;
|
|
74
|
-
output_tokens: number;
|
|
75
|
-
}>;
|
|
76
|
-
}>>;
|
|
77
|
-
|
|
78
|
-
getBodyOfWorkCosts(params: {
|
|
79
|
-
body_of_work_id?: string;
|
|
80
|
-
project_id?: string;
|
|
81
|
-
limit?: number;
|
|
82
|
-
}): Promise<ApiResponse<{
|
|
83
|
-
bodies_of_work: Array<{
|
|
84
|
-
body_of_work_id: string;
|
|
85
|
-
title: string;
|
|
86
|
-
total_cost: number;
|
|
87
|
-
task_count: number;
|
|
88
|
-
}>;
|
|
89
|
-
}>>;
|
|
90
|
-
|
|
91
|
-
getSprintCosts(params: {
|
|
92
|
-
sprint_id?: string;
|
|
93
|
-
project_id?: string;
|
|
94
|
-
limit?: number;
|
|
95
|
-
}): Promise<ApiResponse<{
|
|
96
|
-
sprints: Array<{
|
|
97
|
-
sprint_id: string;
|
|
98
|
-
name: string;
|
|
99
|
-
total_cost: number;
|
|
100
|
-
task_count: number;
|
|
101
|
-
}>;
|
|
102
|
-
}>>;
|
|
103
|
-
|
|
104
|
-
getTokenUsage(): Promise<ApiResponse<{
|
|
105
|
-
session_tokens: {
|
|
106
|
-
input: number;
|
|
107
|
-
output: number;
|
|
108
|
-
};
|
|
109
|
-
estimated_cost: number;
|
|
110
|
-
}>>;
|
|
111
|
-
|
|
112
|
-
reportTokenUsage(sessionId: string, params: {
|
|
113
|
-
input_tokens: number;
|
|
114
|
-
output_tokens: number;
|
|
115
|
-
model?: string;
|
|
116
|
-
}): Promise<ApiResponse<{
|
|
117
|
-
success: boolean;
|
|
118
|
-
session_id: string;
|
|
119
|
-
total_input_tokens: number;
|
|
120
|
-
total_output_tokens: number;
|
|
121
|
-
}>>;
|
|
122
|
-
}
|
|
123
|
-
|
|
124
|
-
export function createCostMethods(request: RequestFn): CostMethods {
|
|
125
|
-
return {
|
|
126
|
-
async getCostSummary(projectId, params) {
|
|
127
|
-
const queryParams = new URLSearchParams();
|
|
128
|
-
if (params?.period) queryParams.set('period', params.period);
|
|
129
|
-
if (params?.limit) queryParams.set('limit', params.limit.toString());
|
|
130
|
-
const query = queryParams.toString();
|
|
131
|
-
const url = `/api/mcp/projects/${projectId}/cost-summary${query ? `?${query}` : ''}`;
|
|
132
|
-
return request('GET', url);
|
|
133
|
-
},
|
|
134
|
-
|
|
135
|
-
async getCostAlerts() {
|
|
136
|
-
return request('GET', '/api/mcp/cost-alerts');
|
|
137
|
-
},
|
|
138
|
-
|
|
139
|
-
async addCostAlert(params) {
|
|
140
|
-
return request('POST', '/api/mcp/cost-alerts', params);
|
|
141
|
-
},
|
|
142
|
-
|
|
143
|
-
async updateCostAlert(alertId, updates) {
|
|
144
|
-
return request('PATCH', `/api/mcp/cost-alerts/${alertId}`, updates);
|
|
145
|
-
},
|
|
146
|
-
|
|
147
|
-
async deleteCostAlert(alertId) {
|
|
148
|
-
return request('DELETE', `/api/mcp/cost-alerts/${alertId}`);
|
|
149
|
-
},
|
|
150
|
-
|
|
151
|
-
async getTaskCosts(projectId, limit) {
|
|
152
|
-
const url = limit
|
|
153
|
-
? `/api/mcp/projects/${projectId}/task-costs?limit=${limit}`
|
|
154
|
-
: `/api/mcp/projects/${projectId}/task-costs`;
|
|
155
|
-
return request('GET', url);
|
|
156
|
-
},
|
|
157
|
-
|
|
158
|
-
async getBodyOfWorkCosts(params) {
|
|
159
|
-
const queryParams = new URLSearchParams();
|
|
160
|
-
if (params.body_of_work_id) queryParams.set('body_of_work_id', params.body_of_work_id);
|
|
161
|
-
if (params.project_id) queryParams.set('project_id', params.project_id);
|
|
162
|
-
if (params.limit) queryParams.set('limit', params.limit.toString());
|
|
163
|
-
return request('GET', `/api/mcp/cost/bodies-of-work?${queryParams.toString()}`);
|
|
164
|
-
},
|
|
165
|
-
|
|
166
|
-
async getSprintCosts(params) {
|
|
167
|
-
const queryParams = new URLSearchParams();
|
|
168
|
-
if (params.sprint_id) queryParams.set('sprint_id', params.sprint_id);
|
|
169
|
-
if (params.project_id) queryParams.set('project_id', params.project_id);
|
|
170
|
-
if (params.limit) queryParams.set('limit', params.limit.toString());
|
|
171
|
-
return request('GET', `/api/mcp/cost/sprints?${queryParams.toString()}`);
|
|
172
|
-
},
|
|
173
|
-
|
|
174
|
-
async getTokenUsage() {
|
|
175
|
-
return request('GET', '/api/mcp/sessions/token-usage');
|
|
176
|
-
},
|
|
177
|
-
|
|
178
|
-
async reportTokenUsage(sessionId, params) {
|
|
179
|
-
return request('POST', '/api/mcp/sessions/token-usage', {
|
|
180
|
-
session_id: sessionId,
|
|
181
|
-
...params
|
|
182
|
-
});
|
|
183
|
-
}
|
|
184
|
-
};
|
|
185
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Cost API Methods
|
|
3
|
+
*
|
|
4
|
+
* Methods for cost tracking and alerts:
|
|
5
|
+
* - getCostSummary: Get cost summary by period
|
|
6
|
+
* - getCostAlerts: List cost alerts
|
|
7
|
+
* - addCostAlert: Create a cost alert
|
|
8
|
+
* - updateCostAlert: Update a cost alert
|
|
9
|
+
* - deleteCostAlert: Delete a cost alert
|
|
10
|
+
* - getTaskCosts: Get costs by task
|
|
11
|
+
* - getBodyOfWorkCosts: Get costs by body of work
|
|
12
|
+
* - getSprintCosts: Get costs by sprint
|
|
13
|
+
* - getTokenUsage: Get token usage stats
|
|
14
|
+
* - reportTokenUsage: Report token usage
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
import type { ApiResponse, RequestFn } from './types.js';
|
|
18
|
+
|
|
19
|
+
export interface CostMethods {
|
|
20
|
+
getCostSummary(projectId: string, params?: {
|
|
21
|
+
period?: 'daily' | 'weekly' | 'monthly';
|
|
22
|
+
limit?: number;
|
|
23
|
+
}): Promise<ApiResponse<{
|
|
24
|
+
summary: Array<{
|
|
25
|
+
period: string;
|
|
26
|
+
total_cost: number;
|
|
27
|
+
input_tokens: number;
|
|
28
|
+
output_tokens: number;
|
|
29
|
+
api_calls: number;
|
|
30
|
+
}>;
|
|
31
|
+
}>>;
|
|
32
|
+
|
|
33
|
+
getCostAlerts(): Promise<ApiResponse<{
|
|
34
|
+
alerts: Array<{
|
|
35
|
+
id: string;
|
|
36
|
+
project_id?: string;
|
|
37
|
+
threshold_amount: number;
|
|
38
|
+
threshold_period: string;
|
|
39
|
+
alert_type: string;
|
|
40
|
+
enabled: boolean;
|
|
41
|
+
}>;
|
|
42
|
+
}>>;
|
|
43
|
+
|
|
44
|
+
addCostAlert(params: {
|
|
45
|
+
project_id?: string;
|
|
46
|
+
threshold_amount: number;
|
|
47
|
+
threshold_period: 'daily' | 'weekly' | 'monthly';
|
|
48
|
+
alert_type?: 'warning' | 'critical';
|
|
49
|
+
}): Promise<ApiResponse<{
|
|
50
|
+
success: boolean;
|
|
51
|
+
alert_id: string;
|
|
52
|
+
}>>;
|
|
53
|
+
|
|
54
|
+
updateCostAlert(alertId: string, updates: {
|
|
55
|
+
threshold_amount?: number;
|
|
56
|
+
threshold_period?: 'daily' | 'weekly' | 'monthly';
|
|
57
|
+
alert_type?: 'warning' | 'critical';
|
|
58
|
+
enabled?: boolean;
|
|
59
|
+
}): Promise<ApiResponse<{
|
|
60
|
+
success: boolean;
|
|
61
|
+
alert_id: string;
|
|
62
|
+
}>>;
|
|
63
|
+
|
|
64
|
+
deleteCostAlert(alertId: string): Promise<ApiResponse<{
|
|
65
|
+
success: boolean;
|
|
66
|
+
}>>;
|
|
67
|
+
|
|
68
|
+
getTaskCosts(projectId: string, limit?: number): Promise<ApiResponse<{
|
|
69
|
+
tasks: Array<{
|
|
70
|
+
task_id: string;
|
|
71
|
+
task_title: string;
|
|
72
|
+
total_cost: number;
|
|
73
|
+
input_tokens: number;
|
|
74
|
+
output_tokens: number;
|
|
75
|
+
}>;
|
|
76
|
+
}>>;
|
|
77
|
+
|
|
78
|
+
getBodyOfWorkCosts(params: {
|
|
79
|
+
body_of_work_id?: string;
|
|
80
|
+
project_id?: string;
|
|
81
|
+
limit?: number;
|
|
82
|
+
}): Promise<ApiResponse<{
|
|
83
|
+
bodies_of_work: Array<{
|
|
84
|
+
body_of_work_id: string;
|
|
85
|
+
title: string;
|
|
86
|
+
total_cost: number;
|
|
87
|
+
task_count: number;
|
|
88
|
+
}>;
|
|
89
|
+
}>>;
|
|
90
|
+
|
|
91
|
+
getSprintCosts(params: {
|
|
92
|
+
sprint_id?: string;
|
|
93
|
+
project_id?: string;
|
|
94
|
+
limit?: number;
|
|
95
|
+
}): Promise<ApiResponse<{
|
|
96
|
+
sprints: Array<{
|
|
97
|
+
sprint_id: string;
|
|
98
|
+
name: string;
|
|
99
|
+
total_cost: number;
|
|
100
|
+
task_count: number;
|
|
101
|
+
}>;
|
|
102
|
+
}>>;
|
|
103
|
+
|
|
104
|
+
getTokenUsage(): Promise<ApiResponse<{
|
|
105
|
+
session_tokens: {
|
|
106
|
+
input: number;
|
|
107
|
+
output: number;
|
|
108
|
+
};
|
|
109
|
+
estimated_cost: number;
|
|
110
|
+
}>>;
|
|
111
|
+
|
|
112
|
+
reportTokenUsage(sessionId: string, params: {
|
|
113
|
+
input_tokens: number;
|
|
114
|
+
output_tokens: number;
|
|
115
|
+
model?: string;
|
|
116
|
+
}): Promise<ApiResponse<{
|
|
117
|
+
success: boolean;
|
|
118
|
+
session_id: string;
|
|
119
|
+
total_input_tokens: number;
|
|
120
|
+
total_output_tokens: number;
|
|
121
|
+
}>>;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
export function createCostMethods(request: RequestFn): CostMethods {
|
|
125
|
+
return {
|
|
126
|
+
async getCostSummary(projectId, params) {
|
|
127
|
+
const queryParams = new URLSearchParams();
|
|
128
|
+
if (params?.period) queryParams.set('period', params.period);
|
|
129
|
+
if (params?.limit) queryParams.set('limit', params.limit.toString());
|
|
130
|
+
const query = queryParams.toString();
|
|
131
|
+
const url = `/api/mcp/projects/${projectId}/cost-summary${query ? `?${query}` : ''}`;
|
|
132
|
+
return request('GET', url);
|
|
133
|
+
},
|
|
134
|
+
|
|
135
|
+
async getCostAlerts() {
|
|
136
|
+
return request('GET', '/api/mcp/cost-alerts');
|
|
137
|
+
},
|
|
138
|
+
|
|
139
|
+
async addCostAlert(params) {
|
|
140
|
+
return request('POST', '/api/mcp/cost-alerts', params);
|
|
141
|
+
},
|
|
142
|
+
|
|
143
|
+
async updateCostAlert(alertId, updates) {
|
|
144
|
+
return request('PATCH', `/api/mcp/cost-alerts/${alertId}`, updates);
|
|
145
|
+
},
|
|
146
|
+
|
|
147
|
+
async deleteCostAlert(alertId) {
|
|
148
|
+
return request('DELETE', `/api/mcp/cost-alerts/${alertId}`);
|
|
149
|
+
},
|
|
150
|
+
|
|
151
|
+
async getTaskCosts(projectId, limit) {
|
|
152
|
+
const url = limit
|
|
153
|
+
? `/api/mcp/projects/${projectId}/task-costs?limit=${limit}`
|
|
154
|
+
: `/api/mcp/projects/${projectId}/task-costs`;
|
|
155
|
+
return request('GET', url);
|
|
156
|
+
},
|
|
157
|
+
|
|
158
|
+
async getBodyOfWorkCosts(params) {
|
|
159
|
+
const queryParams = new URLSearchParams();
|
|
160
|
+
if (params.body_of_work_id) queryParams.set('body_of_work_id', params.body_of_work_id);
|
|
161
|
+
if (params.project_id) queryParams.set('project_id', params.project_id);
|
|
162
|
+
if (params.limit) queryParams.set('limit', params.limit.toString());
|
|
163
|
+
return request('GET', `/api/mcp/cost/bodies-of-work?${queryParams.toString()}`);
|
|
164
|
+
},
|
|
165
|
+
|
|
166
|
+
async getSprintCosts(params) {
|
|
167
|
+
const queryParams = new URLSearchParams();
|
|
168
|
+
if (params.sprint_id) queryParams.set('sprint_id', params.sprint_id);
|
|
169
|
+
if (params.project_id) queryParams.set('project_id', params.project_id);
|
|
170
|
+
if (params.limit) queryParams.set('limit', params.limit.toString());
|
|
171
|
+
return request('GET', `/api/mcp/cost/sprints?${queryParams.toString()}`);
|
|
172
|
+
},
|
|
173
|
+
|
|
174
|
+
async getTokenUsage() {
|
|
175
|
+
return request('GET', '/api/mcp/sessions/token-usage');
|
|
176
|
+
},
|
|
177
|
+
|
|
178
|
+
async reportTokenUsage(sessionId, params) {
|
|
179
|
+
return request('POST', '/api/mcp/sessions/token-usage', {
|
|
180
|
+
session_id: sessionId,
|
|
181
|
+
...params
|
|
182
|
+
});
|
|
183
|
+
}
|
|
184
|
+
};
|
|
185
|
+
}
|