@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.
Files changed (107) hide show
  1. package/AGENTS.md +197 -0
  2. package/LICENSE +21 -0
  3. package/README.md +112 -0
  4. package/context7.json +3 -0
  5. package/dist/cli.d.ts +3 -0
  6. package/dist/cli.d.ts.map +1 -0
  7. package/dist/cli.js +289 -0
  8. package/dist/cli.js.map +1 -0
  9. package/dist/client.d.ts +10 -0
  10. package/dist/client.d.ts.map +1 -0
  11. package/dist/client.js +70 -0
  12. package/dist/client.js.map +1 -0
  13. package/dist/config.d.ts +31 -0
  14. package/dist/config.d.ts.map +1 -0
  15. package/dist/config.js +79 -0
  16. package/dist/config.js.map +1 -0
  17. package/dist/errors.d.ts +10 -0
  18. package/dist/errors.d.ts.map +1 -0
  19. package/dist/errors.js +28 -0
  20. package/dist/errors.js.map +1 -0
  21. package/dist/fs-safety.d.ts +29 -0
  22. package/dist/fs-safety.d.ts.map +1 -0
  23. package/dist/fs-safety.js +107 -0
  24. package/dist/fs-safety.js.map +1 -0
  25. package/dist/index.d.ts +5 -0
  26. package/dist/index.d.ts.map +1 -0
  27. package/dist/index.js +4 -0
  28. package/dist/index.js.map +1 -0
  29. package/dist/llms-full.txt +659 -0
  30. package/dist/server.d.ts +2 -0
  31. package/dist/server.d.ts.map +1 -0
  32. package/dist/server.js +57 -0
  33. package/dist/server.js.map +1 -0
  34. package/dist/tools/analytics.d.ts +4 -0
  35. package/dist/tools/analytics.d.ts.map +1 -0
  36. package/dist/tools/analytics.js +82 -0
  37. package/dist/tools/analytics.js.map +1 -0
  38. package/dist/tools/backups.d.ts +4 -0
  39. package/dist/tools/backups.d.ts.map +1 -0
  40. package/dist/tools/backups.js +99 -0
  41. package/dist/tools/backups.js.map +1 -0
  42. package/dist/tools/config.d.ts +4 -0
  43. package/dist/tools/config.d.ts.map +1 -0
  44. package/dist/tools/config.js +84 -0
  45. package/dist/tools/config.js.map +1 -0
  46. package/dist/tools/corrections.d.ts +4 -0
  47. package/dist/tools/corrections.d.ts.map +1 -0
  48. package/dist/tools/corrections.js +69 -0
  49. package/dist/tools/corrections.js.map +1 -0
  50. package/dist/tools/data_stores.d.ts +4 -0
  51. package/dist/tools/data_stores.d.ts.map +1 -0
  52. package/dist/tools/data_stores.js +244 -0
  53. package/dist/tools/data_stores.js.map +1 -0
  54. package/dist/tools/documents.d.ts +4 -0
  55. package/dist/tools/documents.d.ts.map +1 -0
  56. package/dist/tools/documents.js +162 -0
  57. package/dist/tools/documents.js.map +1 -0
  58. package/dist/tools/extract.d.ts +4 -0
  59. package/dist/tools/extract.d.ts.map +1 -0
  60. package/dist/tools/extract.js +61 -0
  61. package/dist/tools/extract.js.map +1 -0
  62. package/dist/tools/files.d.ts +4 -0
  63. package/dist/tools/files.d.ts.map +1 -0
  64. package/dist/tools/files.js +198 -0
  65. package/dist/tools/files.js.map +1 -0
  66. package/dist/tools/golden_answers.d.ts +4 -0
  67. package/dist/tools/golden_answers.d.ts.map +1 -0
  68. package/dist/tools/golden_answers.js +117 -0
  69. package/dist/tools/golden_answers.js.map +1 -0
  70. package/dist/tools/helpers.d.ts +5 -0
  71. package/dist/tools/helpers.d.ts.map +1 -0
  72. package/dist/tools/helpers.js +10 -0
  73. package/dist/tools/helpers.js.map +1 -0
  74. package/dist/tools/index.d.ts +4 -0
  75. package/dist/tools/index.d.ts.map +1 -0
  76. package/dist/tools/index.js +35 -0
  77. package/dist/tools/index.js.map +1 -0
  78. package/dist/tools/jobs.d.ts +4 -0
  79. package/dist/tools/jobs.d.ts.map +1 -0
  80. package/dist/tools/jobs.js +78 -0
  81. package/dist/tools/jobs.js.map +1 -0
  82. package/dist/tools/link_sources.d.ts +4 -0
  83. package/dist/tools/link_sources.d.ts.map +1 -0
  84. package/dist/tools/link_sources.js +155 -0
  85. package/dist/tools/link_sources.js.map +1 -0
  86. package/dist/tools/misc.d.ts +8 -0
  87. package/dist/tools/misc.d.ts.map +1 -0
  88. package/dist/tools/misc.js +73 -0
  89. package/dist/tools/misc.js.map +1 -0
  90. package/dist/tools/page_questions.d.ts +4 -0
  91. package/dist/tools/page_questions.d.ts.map +1 -0
  92. package/dist/tools/page_questions.js +77 -0
  93. package/dist/tools/page_questions.js.map +1 -0
  94. package/dist/tools/personas.d.ts +4 -0
  95. package/dist/tools/personas.d.ts.map +1 -0
  96. package/dist/tools/personas.js +78 -0
  97. package/dist/tools/personas.js.map +1 -0
  98. package/dist/tools/tools_crud.d.ts +4 -0
  99. package/dist/tools/tools_crud.d.ts.map +1 -0
  100. package/dist/tools/tools_crud.js +207 -0
  101. package/dist/tools/tools_crud.js.map +1 -0
  102. package/dist/tools/types.d.ts +25 -0
  103. package/dist/tools/types.d.ts.map +1 -0
  104. package/dist/tools/types.js +15 -0
  105. package/dist/tools/types.js.map +1 -0
  106. package/llms.txt +150 -0
  107. 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,4 @@
1
+ import type { DashboardClient } from "../client.js";
2
+ import { type ToolDef } from "./types.js";
3
+ export declare function goldenAnswersTools(client: DashboardClient): ToolDef[];
4
+ //# sourceMappingURL=golden_answers.d.ts.map
@@ -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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAEtD,MAAM,UAAU,kBAAkB,CAAC,MAAuB;IACxD,OAAO;QACL,UAAU,CAAC;YACT,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EACT,8EAA8E;YAChF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC9B,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC9C,OAAO,MAAM,CAAC,GAAG,CAAC,kBAAkB,SAAS,iBAAiB,EAAE;oBAC9D,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EAAE,2BAA2B;YACxC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC3B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;aAC3C,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;gBAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACtC,OAAO,MAAM,CAAC,IAAI,CAChB,kBAAkB,SAAS,iBAAiB,EAC5C,IAAI,CACL,CAAC;YACJ,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EAAE,8BAA8B;YAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;oBACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC/B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;iBAC3C,CAAC;aACH,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC9C,OAAO,MAAM,CAAC,KAAK,CACjB,kBAAkB,SAAS,iBAAiB,EAC5C,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAC/B,CAAC;YACJ,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EAAE,4CAA4C;YACzD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;aACpC,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;oBAClB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,2CAA2C;qBACpD,CAAC;gBACJ,CAAC;gBACD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAkB,SAAS,iBAAiB,EAAE;oBACjE,EAAE,EAAE,IAAI,CAAC,EAAE;iBACZ,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EACT,yHAAyH;YAC3H,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACnC,IAAI,EAAE,CAAC;qBACJ,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;qBACzD,OAAO,CAAC,cAAc,CAAC;aAC3B,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;gBAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACtC,OAAO,MAAM,CAAC,IAAI,CAChB,kBAAkB,SAAS,oBAAoB,EAC/C,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,CAC/B,CAAC;YACJ,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,uCAAuC;YAC7C,KAAK,EAAE,iCAAiC;YACxC,WAAW,EACT,mHAAmH;YACrH,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxB,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;aACnD,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;gBAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACtC,OAAO,MAAM,CAAC,IAAI,CAChB,kBAAkB,SAAS,oBAAoB,EAC/C,EAAE,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,CAC1C,CAAC;YACJ,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}
@@ -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,4 @@
1
+ import type { DashboardClient } from "../client.js";
2
+ import type { ToolDef } from "./types.js";
3
+ export declare function allTools(client: DashboardClient): ToolDef[];
4
+ //# sourceMappingURL=index.d.ts.map
@@ -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,4 @@
1
+ import type { DashboardClient } from "../client.js";
2
+ import { type ToolDef } from "./types.js";
3
+ export declare function jobsTools(client: DashboardClient): ToolDef[];
4
+ //# sourceMappingURL=jobs.d.ts.map
@@ -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,4 @@
1
+ import type { DashboardClient } from "../client.js";
2
+ import { type ToolDef } from "./types.js";
3
+ export declare function linkSourcesTools(client: DashboardClient): ToolDef[];
4
+ //# sourceMappingURL=link_sources.d.ts.map
@@ -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"}