@aigentyc/mcp 0.1.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/AGENTS.md +197 -0
- package/LICENSE +21 -0
- package/README.md +112 -0
- package/context7.json +3 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +289 -0
- package/dist/cli.js.map +1 -0
- package/dist/client.d.ts +10 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +70 -0
- package/dist/client.js.map +1 -0
- package/dist/config.d.ts +31 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +79 -0
- package/dist/config.js.map +1 -0
- package/dist/errors.d.ts +10 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +28 -0
- package/dist/errors.js.map +1 -0
- package/dist/fs-safety.d.ts +29 -0
- package/dist/fs-safety.d.ts.map +1 -0
- package/dist/fs-safety.js +107 -0
- package/dist/fs-safety.js.map +1 -0
- package/dist/index.d.ts +5 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -0
- package/dist/llms-full.txt +659 -0
- package/dist/server.d.ts +2 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +57 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/analytics.d.ts +4 -0
- package/dist/tools/analytics.d.ts.map +1 -0
- package/dist/tools/analytics.js +82 -0
- package/dist/tools/analytics.js.map +1 -0
- package/dist/tools/backups.d.ts +4 -0
- package/dist/tools/backups.d.ts.map +1 -0
- package/dist/tools/backups.js +99 -0
- package/dist/tools/backups.js.map +1 -0
- package/dist/tools/config.d.ts +4 -0
- package/dist/tools/config.d.ts.map +1 -0
- package/dist/tools/config.js +84 -0
- package/dist/tools/config.js.map +1 -0
- package/dist/tools/corrections.d.ts +4 -0
- package/dist/tools/corrections.d.ts.map +1 -0
- package/dist/tools/corrections.js +69 -0
- package/dist/tools/corrections.js.map +1 -0
- package/dist/tools/data_stores.d.ts +4 -0
- package/dist/tools/data_stores.d.ts.map +1 -0
- package/dist/tools/data_stores.js +244 -0
- package/dist/tools/data_stores.js.map +1 -0
- package/dist/tools/documents.d.ts +4 -0
- package/dist/tools/documents.d.ts.map +1 -0
- package/dist/tools/documents.js +162 -0
- package/dist/tools/documents.js.map +1 -0
- package/dist/tools/extract.d.ts +4 -0
- package/dist/tools/extract.d.ts.map +1 -0
- package/dist/tools/extract.js +61 -0
- package/dist/tools/extract.js.map +1 -0
- package/dist/tools/files.d.ts +4 -0
- package/dist/tools/files.d.ts.map +1 -0
- package/dist/tools/files.js +198 -0
- package/dist/tools/files.js.map +1 -0
- package/dist/tools/golden_answers.d.ts +4 -0
- package/dist/tools/golden_answers.d.ts.map +1 -0
- package/dist/tools/golden_answers.js +117 -0
- package/dist/tools/golden_answers.js.map +1 -0
- package/dist/tools/helpers.d.ts +5 -0
- package/dist/tools/helpers.d.ts.map +1 -0
- package/dist/tools/helpers.js +10 -0
- package/dist/tools/helpers.js.map +1 -0
- package/dist/tools/index.d.ts +4 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +35 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/jobs.d.ts +4 -0
- package/dist/tools/jobs.d.ts.map +1 -0
- package/dist/tools/jobs.js +78 -0
- package/dist/tools/jobs.js.map +1 -0
- package/dist/tools/link_sources.d.ts +4 -0
- package/dist/tools/link_sources.d.ts.map +1 -0
- package/dist/tools/link_sources.js +155 -0
- package/dist/tools/link_sources.js.map +1 -0
- package/dist/tools/misc.d.ts +8 -0
- package/dist/tools/misc.d.ts.map +1 -0
- package/dist/tools/misc.js +73 -0
- package/dist/tools/misc.js.map +1 -0
- package/dist/tools/page_questions.d.ts +4 -0
- package/dist/tools/page_questions.d.ts.map +1 -0
- package/dist/tools/page_questions.js +77 -0
- package/dist/tools/page_questions.js.map +1 -0
- package/dist/tools/personas.d.ts +4 -0
- package/dist/tools/personas.d.ts.map +1 -0
- package/dist/tools/personas.js +78 -0
- package/dist/tools/personas.js.map +1 -0
- package/dist/tools/tools_crud.d.ts +4 -0
- package/dist/tools/tools_crud.d.ts.map +1 -0
- package/dist/tools/tools_crud.js +207 -0
- package/dist/tools/tools_crud.js.map +1 -0
- package/dist/tools/types.d.ts +25 -0
- package/dist/tools/types.d.ts.map +1 -0
- package/dist/tools/types.js +15 -0
- package/dist/tools/types.js.map +1 -0
- package/llms.txt +150 -0
- package/package.json +53 -0
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { MAX_BATCH_BYTES, MAX_BATCH_FILES, readTextFile, resolveSafeFile, UnsafePathError, } from "../fs-safety.js";
|
|
4
|
+
import { pid, projectIdArg } from "./helpers.js";
|
|
5
|
+
import { defineTool } from "./types.js";
|
|
6
|
+
export function filesTools(client) {
|
|
7
|
+
return [
|
|
8
|
+
defineTool({
|
|
9
|
+
name: "files_list",
|
|
10
|
+
title: "List uploaded files",
|
|
11
|
+
description: "List files uploaded into the project's ingestion pipeline.",
|
|
12
|
+
inputSchema: z.object({
|
|
13
|
+
projectId: projectIdArg,
|
|
14
|
+
page: z.number().int().min(1).default(1),
|
|
15
|
+
pageSize: z.number().int().min(1).max(100).default(20),
|
|
16
|
+
}),
|
|
17
|
+
handler: async (args) => {
|
|
18
|
+
const projectId = pid(client, args.projectId);
|
|
19
|
+
return client.get(`/api/dashboard/${projectId}/files`, {
|
|
20
|
+
page: args.page,
|
|
21
|
+
pageSize: args.pageSize,
|
|
22
|
+
});
|
|
23
|
+
},
|
|
24
|
+
}),
|
|
25
|
+
defineTool({
|
|
26
|
+
name: "files_get",
|
|
27
|
+
title: "Get file details",
|
|
28
|
+
description: "Get metadata + extraction status for a single uploaded file.",
|
|
29
|
+
inputSchema: z.object({
|
|
30
|
+
projectId: projectIdArg,
|
|
31
|
+
fileId: z.string().min(1),
|
|
32
|
+
}),
|
|
33
|
+
handler: async (args) => {
|
|
34
|
+
const projectId = pid(client, args.projectId);
|
|
35
|
+
return client.get(`/api/dashboard/${projectId}/files/${encodeURIComponent(args.fileId)}`);
|
|
36
|
+
},
|
|
37
|
+
}),
|
|
38
|
+
defineTool({
|
|
39
|
+
name: "files_versions",
|
|
40
|
+
title: "List file versions",
|
|
41
|
+
description: "List all versions of a file (same sourceUrl / family).",
|
|
42
|
+
inputSchema: z.object({
|
|
43
|
+
projectId: projectIdArg,
|
|
44
|
+
fileId: z.string().min(1),
|
|
45
|
+
}),
|
|
46
|
+
handler: async (args) => {
|
|
47
|
+
const projectId = pid(client, args.projectId);
|
|
48
|
+
return client.get(`/api/dashboard/${projectId}/files/${encodeURIComponent(args.fileId)}/versions`);
|
|
49
|
+
},
|
|
50
|
+
}),
|
|
51
|
+
defineTool({
|
|
52
|
+
name: "files_delete",
|
|
53
|
+
title: "Delete file",
|
|
54
|
+
description: "Delete an uploaded file and (optionally) its derived documents. Destructive.",
|
|
55
|
+
inputSchema: z.object({
|
|
56
|
+
projectId: projectIdArg,
|
|
57
|
+
fileId: z.string().min(1),
|
|
58
|
+
confirm: z.boolean().default(false),
|
|
59
|
+
}),
|
|
60
|
+
handler: async (args) => {
|
|
61
|
+
if (!args.confirm) {
|
|
62
|
+
return {
|
|
63
|
+
deleted: false,
|
|
64
|
+
reason: "Destructive. Re-invoke with confirm=true.",
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
const projectId = pid(client, args.projectId);
|
|
68
|
+
return client.delete(`/api/dashboard/${projectId}/files/${encodeURIComponent(args.fileId)}`);
|
|
69
|
+
},
|
|
70
|
+
}),
|
|
71
|
+
defineTool({
|
|
72
|
+
name: "files_reprocess",
|
|
73
|
+
title: "Reprocess file",
|
|
74
|
+
description: "Re-run embedding for all current document chunks derived from this file. Use after changing embedding model or chunk settings.",
|
|
75
|
+
inputSchema: z.object({
|
|
76
|
+
projectId: projectIdArg,
|
|
77
|
+
fileId: z.string().min(1),
|
|
78
|
+
}),
|
|
79
|
+
handler: async (args) => {
|
|
80
|
+
const projectId = pid(client, args.projectId);
|
|
81
|
+
return client.post(`/api/dashboard/${projectId}/files/${encodeURIComponent(args.fileId)}/reprocess`, {});
|
|
82
|
+
},
|
|
83
|
+
}),
|
|
84
|
+
defineTool({
|
|
85
|
+
name: "files_upload",
|
|
86
|
+
title: "Upload text files from local FS",
|
|
87
|
+
description: "Read text-based files (.md, .txt, .json, .csv, .html, …) from the user's local filesystem and ingest them into the project. Binary formats (pdf/doc/docx) are not supported in v0.1. Paths must be absolute or relative to CWD, cannot escape \\$HOME, and are capped at 50MB/file and 500MB/batch.",
|
|
88
|
+
inputSchema: z.object({
|
|
89
|
+
projectId: projectIdArg,
|
|
90
|
+
paths: z
|
|
91
|
+
.array(z.string().min(1))
|
|
92
|
+
.min(1)
|
|
93
|
+
.max(MAX_BATCH_FILES)
|
|
94
|
+
.describe("Absolute or CWD-relative paths. No glob expansion."),
|
|
95
|
+
sectorId: z.string().optional(),
|
|
96
|
+
audience: z.array(z.string()).optional(),
|
|
97
|
+
indexAsDocuments: z
|
|
98
|
+
.boolean()
|
|
99
|
+
.default(true)
|
|
100
|
+
.describe("When true (default), also chunks+embeds each file into the KB so it becomes searchable. When false, only records metadata in the uploaded_files table."),
|
|
101
|
+
}),
|
|
102
|
+
handler: async (args) => {
|
|
103
|
+
const projectId = pid(client, args.projectId);
|
|
104
|
+
// Pass 1: validate ALL paths before writing anything.
|
|
105
|
+
const validated = [];
|
|
106
|
+
const failed = [];
|
|
107
|
+
let totalBytes = 0;
|
|
108
|
+
for (const p of args.paths) {
|
|
109
|
+
try {
|
|
110
|
+
const info = await resolveSafeFile(p);
|
|
111
|
+
totalBytes += info.size;
|
|
112
|
+
if (totalBytes > MAX_BATCH_BYTES) {
|
|
113
|
+
throw new UnsafePathError(`Batch total exceeds ${MAX_BATCH_BYTES} bytes`, p);
|
|
114
|
+
}
|
|
115
|
+
validated.push(info);
|
|
116
|
+
}
|
|
117
|
+
catch (err) {
|
|
118
|
+
failed.push({
|
|
119
|
+
path: p,
|
|
120
|
+
reason: err instanceof Error ? err.message : String(err),
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
// Pass 2: upload + optionally index each validated file.
|
|
125
|
+
const uploaded = [];
|
|
126
|
+
for (const info of validated) {
|
|
127
|
+
const fileId = randomUUID();
|
|
128
|
+
try {
|
|
129
|
+
const content = await readTextFile(info);
|
|
130
|
+
await client.post(`/api/dashboard/${projectId}/files`, {
|
|
131
|
+
id: fileId,
|
|
132
|
+
fileName: info.fileName,
|
|
133
|
+
fileType: info.mimeHint,
|
|
134
|
+
fileSize: info.size,
|
|
135
|
+
status: "completed",
|
|
136
|
+
extractedText: content,
|
|
137
|
+
version: 1,
|
|
138
|
+
totalVersions: 1,
|
|
139
|
+
isSaved: true,
|
|
140
|
+
audience: args.audience,
|
|
141
|
+
});
|
|
142
|
+
let documentName;
|
|
143
|
+
let chunksCreated;
|
|
144
|
+
if (args.indexAsDocuments && content.trim().length >= 50) {
|
|
145
|
+
const createResult = await client.post(`/api/dashboard/${projectId}/documents/create`, {
|
|
146
|
+
title: info.fileName,
|
|
147
|
+
content,
|
|
148
|
+
sectorId: args.sectorId,
|
|
149
|
+
sourceType: "file",
|
|
150
|
+
sourceId: fileId,
|
|
151
|
+
audience: args.audience,
|
|
152
|
+
});
|
|
153
|
+
documentName = createResult.documentName;
|
|
154
|
+
chunksCreated = createResult.chunksCreated;
|
|
155
|
+
}
|
|
156
|
+
uploaded.push({
|
|
157
|
+
path: info.path,
|
|
158
|
+
fileId,
|
|
159
|
+
documentName,
|
|
160
|
+
chunksCreated,
|
|
161
|
+
});
|
|
162
|
+
}
|
|
163
|
+
catch (err) {
|
|
164
|
+
failed.push({
|
|
165
|
+
path: info.path,
|
|
166
|
+
reason: err instanceof Error ? err.message : String(err),
|
|
167
|
+
});
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
return {
|
|
171
|
+
uploaded,
|
|
172
|
+
failed,
|
|
173
|
+
totalBytes,
|
|
174
|
+
filesProcessed: uploaded.length,
|
|
175
|
+
filesFailed: failed.length,
|
|
176
|
+
};
|
|
177
|
+
},
|
|
178
|
+
}),
|
|
179
|
+
defineTool({
|
|
180
|
+
name: "files_bulk_audience",
|
|
181
|
+
title: "Bulk update file audience",
|
|
182
|
+
description: "Assign an audience tag to multiple files at once. Audiences gate document visibility in search.",
|
|
183
|
+
inputSchema: z.object({
|
|
184
|
+
projectId: projectIdArg,
|
|
185
|
+
fileIds: z.array(z.string().min(1)).min(1).max(500),
|
|
186
|
+
audience: z.array(z.string()),
|
|
187
|
+
}),
|
|
188
|
+
handler: async (args) => {
|
|
189
|
+
const projectId = pid(client, args.projectId);
|
|
190
|
+
return client.patch(`/api/dashboard/${projectId}/files/bulk-audience`, {
|
|
191
|
+
fileIds: args.fileIds,
|
|
192
|
+
audience: args.audience,
|
|
193
|
+
});
|
|
194
|
+
},
|
|
195
|
+
}),
|
|
196
|
+
];
|
|
197
|
+
}
|
|
198
|
+
//# sourceMappingURL=files.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"golden_answers.d.ts","sourceRoot":"","sources":["../../src/tools/golden_answers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CA+HrE"}
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { pid, projectIdArg } from "./helpers.js";
|
|
3
|
+
import { defineTool } from "./types.js";
|
|
4
|
+
export function goldenAnswersTools(client) {
|
|
5
|
+
return [
|
|
6
|
+
defineTool({
|
|
7
|
+
name: "golden_answers_list",
|
|
8
|
+
title: "List golden answers",
|
|
9
|
+
description: "List high-priority Q&A pairs used for search ranking and fallback responses.",
|
|
10
|
+
inputSchema: z.object({
|
|
11
|
+
projectId: projectIdArg,
|
|
12
|
+
page: z.number().int().min(1).default(1),
|
|
13
|
+
pageSize: z.number().int().min(1).max(100).default(20),
|
|
14
|
+
search: z.string().optional(),
|
|
15
|
+
}),
|
|
16
|
+
handler: async (args) => {
|
|
17
|
+
const projectId = pid(client, args.projectId);
|
|
18
|
+
return client.get(`/api/dashboard/${projectId}/golden-answers`, {
|
|
19
|
+
page: args.page,
|
|
20
|
+
pageSize: args.pageSize,
|
|
21
|
+
search: args.search,
|
|
22
|
+
});
|
|
23
|
+
},
|
|
24
|
+
}),
|
|
25
|
+
defineTool({
|
|
26
|
+
name: "golden_answers_create",
|
|
27
|
+
title: "Create golden answer",
|
|
28
|
+
description: "Create a golden Q&A pair.",
|
|
29
|
+
inputSchema: z.object({
|
|
30
|
+
projectId: projectIdArg,
|
|
31
|
+
query: z.string().min(1),
|
|
32
|
+
response: z.string().min(1),
|
|
33
|
+
variations: z.array(z.string()).optional(),
|
|
34
|
+
}),
|
|
35
|
+
handler: async (args) => {
|
|
36
|
+
const { projectId: rawPid, ...body } = args;
|
|
37
|
+
const projectId = pid(client, rawPid);
|
|
38
|
+
return client.post(`/api/dashboard/${projectId}/golden-answers`, body);
|
|
39
|
+
},
|
|
40
|
+
}),
|
|
41
|
+
defineTool({
|
|
42
|
+
name: "golden_answers_update",
|
|
43
|
+
title: "Update golden answer",
|
|
44
|
+
description: "Patch a golden answer by id.",
|
|
45
|
+
inputSchema: z.object({
|
|
46
|
+
projectId: projectIdArg,
|
|
47
|
+
id: z.string().min(1),
|
|
48
|
+
patch: z.object({
|
|
49
|
+
query: z.string().optional(),
|
|
50
|
+
response: z.string().optional(),
|
|
51
|
+
variations: z.array(z.string()).optional(),
|
|
52
|
+
}),
|
|
53
|
+
}),
|
|
54
|
+
handler: async (args) => {
|
|
55
|
+
const projectId = pid(client, args.projectId);
|
|
56
|
+
return client.patch(`/api/dashboard/${projectId}/golden-answers`, { id: args.id, ...args.patch });
|
|
57
|
+
},
|
|
58
|
+
}),
|
|
59
|
+
defineTool({
|
|
60
|
+
name: "golden_answers_delete",
|
|
61
|
+
title: "Delete golden answer",
|
|
62
|
+
description: "Delete a golden answer by id. Destructive.",
|
|
63
|
+
inputSchema: z.object({
|
|
64
|
+
projectId: projectIdArg,
|
|
65
|
+
id: z.string().min(1),
|
|
66
|
+
confirm: z.boolean().default(false),
|
|
67
|
+
}),
|
|
68
|
+
handler: async (args) => {
|
|
69
|
+
if (!args.confirm) {
|
|
70
|
+
return {
|
|
71
|
+
deleted: false,
|
|
72
|
+
reason: "Destructive. Re-invoke with confirm=true.",
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
const projectId = pid(client, args.projectId);
|
|
76
|
+
return client.delete(`/api/dashboard/${projectId}/golden-answers`, {
|
|
77
|
+
id: args.id,
|
|
78
|
+
});
|
|
79
|
+
},
|
|
80
|
+
}),
|
|
81
|
+
defineTool({
|
|
82
|
+
name: "golden_answers_ai_improve",
|
|
83
|
+
title: "AI-improve response",
|
|
84
|
+
description: "Ask the AI to rewrite a response for a query in a chosen tone. Returns `improvedResponse` — you decide whether to save.",
|
|
85
|
+
inputSchema: z.object({
|
|
86
|
+
projectId: projectIdArg,
|
|
87
|
+
query: z.string().min(1),
|
|
88
|
+
currentResponse: z.string().min(1),
|
|
89
|
+
instructions: z.string().optional(),
|
|
90
|
+
tone: z
|
|
91
|
+
.enum(["professional", "friendly", "concise", "detailed"])
|
|
92
|
+
.default("professional"),
|
|
93
|
+
}),
|
|
94
|
+
handler: async (args) => {
|
|
95
|
+
const { projectId: rawPid, ...body } = args;
|
|
96
|
+
const projectId = pid(client, rawPid);
|
|
97
|
+
return client.post(`/api/dashboard/${projectId}/golden-answers/ai`, { action: "improve", ...body });
|
|
98
|
+
},
|
|
99
|
+
}),
|
|
100
|
+
defineTool({
|
|
101
|
+
name: "golden_answers_ai_generate_variations",
|
|
102
|
+
title: "AI-generate question variations",
|
|
103
|
+
description: "Generate paraphrased variations of a question to improve retrieval. Returns `variations: [{question, context?}]`.",
|
|
104
|
+
inputSchema: z.object({
|
|
105
|
+
projectId: projectIdArg,
|
|
106
|
+
query: z.string().min(1),
|
|
107
|
+
existingVariations: z.array(z.string()).optional(),
|
|
108
|
+
}),
|
|
109
|
+
handler: async (args) => {
|
|
110
|
+
const { projectId: rawPid, ...body } = args;
|
|
111
|
+
const projectId = pid(client, rawPid);
|
|
112
|
+
return client.post(`/api/dashboard/${projectId}/golden-answers/ai`, { action: "generate-questions", ...body });
|
|
113
|
+
},
|
|
114
|
+
}),
|
|
115
|
+
];
|
|
116
|
+
}
|
|
117
|
+
//# sourceMappingURL=golden_answers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"golden_answers.js","sourceRoot":"","sources":["../../src/tools/golden_answers.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { DashboardClient } from "../client.js";
|
|
3
|
+
export declare const projectIdArg: z.ZodOptional<z.ZodString>;
|
|
4
|
+
export declare function pid(client: DashboardClient, projectId: string | undefined): string;
|
|
5
|
+
//# sourceMappingURL=helpers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,YAAY,4BAMtB,CAAC;AAEJ,wBAAgB,GAAG,CACjB,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,CAER"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export const projectIdArg = z
|
|
3
|
+
.string()
|
|
4
|
+
.min(1)
|
|
5
|
+
.optional()
|
|
6
|
+
.describe("Project ID. Defaults to the active profile's projectId if omitted.");
|
|
7
|
+
export function pid(client, projectId) {
|
|
8
|
+
return projectId ?? client.profile.projectId;
|
|
9
|
+
}
|
|
10
|
+
//# sourceMappingURL=helpers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,EAAE;KACV,QAAQ,CACP,oEAAoE,CACrE,CAAC;AAEJ,MAAM,UAAU,GAAG,CACjB,MAAuB,EACvB,SAA6B;IAE7B,OAAO,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;AAC/C,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAgBpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CAkB3D"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { analyticsTools } from "./analytics.js";
|
|
2
|
+
import { backupsTools } from "./backups.js";
|
|
3
|
+
import { configTools } from "./config.js";
|
|
4
|
+
import { correctionsTools } from "./corrections.js";
|
|
5
|
+
import { dataStoresTools } from "./data_stores.js";
|
|
6
|
+
import { documentsTools } from "./documents.js";
|
|
7
|
+
import { extractTools } from "./extract.js";
|
|
8
|
+
import { filesTools } from "./files.js";
|
|
9
|
+
import { goldenAnswersTools } from "./golden_answers.js";
|
|
10
|
+
import { jobsTools } from "./jobs.js";
|
|
11
|
+
import { linkSourcesTools } from "./link_sources.js";
|
|
12
|
+
import { miscTools } from "./misc.js";
|
|
13
|
+
import { pageQuestionsTools } from "./page_questions.js";
|
|
14
|
+
import { personasTools } from "./personas.js";
|
|
15
|
+
import { toolsCrudTools } from "./tools_crud.js";
|
|
16
|
+
export function allTools(client) {
|
|
17
|
+
return [
|
|
18
|
+
...documentsTools(client),
|
|
19
|
+
...filesTools(client),
|
|
20
|
+
...extractTools(client),
|
|
21
|
+
...linkSourcesTools(client),
|
|
22
|
+
...pageQuestionsTools(client),
|
|
23
|
+
...dataStoresTools(client),
|
|
24
|
+
...toolsCrudTools(client),
|
|
25
|
+
...goldenAnswersTools(client),
|
|
26
|
+
...correctionsTools(client),
|
|
27
|
+
...personasTools(client),
|
|
28
|
+
...configTools(client),
|
|
29
|
+
...backupsTools(client),
|
|
30
|
+
...miscTools(client),
|
|
31
|
+
...jobsTools(client),
|
|
32
|
+
...analyticsTools(client),
|
|
33
|
+
];
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,QAAQ,CAAC,MAAuB;IAC9C,OAAO;QACL,GAAG,cAAc,CAAC,MAAM,CAAC;QACzB,GAAG,UAAU,CAAC,MAAM,CAAC;QACrB,GAAG,YAAY,CAAC,MAAM,CAAC;QACvB,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC3B,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC7B,GAAG,eAAe,CAAC,MAAM,CAAC;QAC1B,GAAG,cAAc,CAAC,MAAM,CAAC;QACzB,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC7B,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC3B,GAAG,aAAa,CAAC,MAAM,CAAC;QACxB,GAAG,WAAW,CAAC,MAAM,CAAC;QACtB,GAAG,YAAY,CAAC,MAAM,CAAC;QACvB,GAAG,SAAS,CAAC,MAAM,CAAC;QACpB,GAAG,SAAS,CAAC,MAAM,CAAC;QACpB,GAAG,cAAc,CAAC,MAAM,CAAC;KAC1B,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAkBtD,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CAqF5D"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { AigentycError } from "../errors.js";
|
|
3
|
+
import { defineTool } from "./types.js";
|
|
4
|
+
function pid(client, projectId) {
|
|
5
|
+
return projectId ?? client.profile.projectId;
|
|
6
|
+
}
|
|
7
|
+
export function jobsTools(client) {
|
|
8
|
+
return [
|
|
9
|
+
defineTool({
|
|
10
|
+
name: "jobs_status",
|
|
11
|
+
title: "Get job status",
|
|
12
|
+
description: "Fetch the current status of a long-running job created by another MCP tool.",
|
|
13
|
+
inputSchema: z.object({
|
|
14
|
+
projectId: z.string().optional(),
|
|
15
|
+
jobId: z.string().min(1),
|
|
16
|
+
}),
|
|
17
|
+
handler: async (args) => {
|
|
18
|
+
const projectId = pid(client, args.projectId);
|
|
19
|
+
return client.get(`/api/dashboard/${projectId}/jobs/${encodeURIComponent(args.jobId)}`);
|
|
20
|
+
},
|
|
21
|
+
}),
|
|
22
|
+
defineTool({
|
|
23
|
+
name: "jobs_list",
|
|
24
|
+
title: "List recent jobs",
|
|
25
|
+
description: "List recent long-running jobs for the project. Useful for debugging.",
|
|
26
|
+
inputSchema: z.object({
|
|
27
|
+
projectId: z.string().optional(),
|
|
28
|
+
status: z
|
|
29
|
+
.enum(["queued", "running", "completed", "failed", "cancelled"])
|
|
30
|
+
.optional(),
|
|
31
|
+
type: z.string().optional(),
|
|
32
|
+
limit: z.number().int().min(1).max(200).default(50),
|
|
33
|
+
}),
|
|
34
|
+
handler: async (args) => {
|
|
35
|
+
const projectId = pid(client, args.projectId);
|
|
36
|
+
return client.get(`/api/dashboard/${projectId}/jobs`, {
|
|
37
|
+
status: args.status,
|
|
38
|
+
type: args.type,
|
|
39
|
+
limit: args.limit,
|
|
40
|
+
});
|
|
41
|
+
},
|
|
42
|
+
}),
|
|
43
|
+
defineTool({
|
|
44
|
+
name: "jobs_wait",
|
|
45
|
+
title: "Wait for job to finish",
|
|
46
|
+
description: "Poll a job until it reaches a terminal state (completed, failed, cancelled). Returns the final row.",
|
|
47
|
+
inputSchema: z.object({
|
|
48
|
+
projectId: z.string().optional(),
|
|
49
|
+
jobId: z.string().min(1),
|
|
50
|
+
timeoutMs: z.number().int().min(1000).max(600000).default(120000),
|
|
51
|
+
intervalMs: z.number().int().min(500).max(10000).default(1500),
|
|
52
|
+
}),
|
|
53
|
+
handler: async (args) => {
|
|
54
|
+
const projectId = pid(client, args.projectId);
|
|
55
|
+
const deadline = Date.now() + args.timeoutMs;
|
|
56
|
+
let delay = args.intervalMs;
|
|
57
|
+
while (Date.now() < deadline) {
|
|
58
|
+
const row = await client.get(`/api/dashboard/${projectId}/jobs/${encodeURIComponent(args.jobId)}`);
|
|
59
|
+
if (row.status === "completed" ||
|
|
60
|
+
row.status === "failed" ||
|
|
61
|
+
row.status === "cancelled") {
|
|
62
|
+
if (row.status === "failed") {
|
|
63
|
+
throw new AigentycError("JOB_FAILED", row.error || "Job failed", undefined, undefined, row);
|
|
64
|
+
}
|
|
65
|
+
return row;
|
|
66
|
+
}
|
|
67
|
+
await sleep(Math.min(delay, Math.max(0, deadline - Date.now())));
|
|
68
|
+
delay = Math.min(Math.round(delay * 1.25), 8000);
|
|
69
|
+
}
|
|
70
|
+
throw new AigentycError("JOB_FAILED", `Timeout waiting for job ${args.jobId} after ${args.timeoutMs}ms`);
|
|
71
|
+
},
|
|
72
|
+
}),
|
|
73
|
+
];
|
|
74
|
+
}
|
|
75
|
+
function sleep(ms) {
|
|
76
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=jobs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"link_sources.d.ts","sourceRoot":"","sources":["../../src/tools/link_sources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CA0KnE"}
|