@aigentyc/mcp 0.1.0

package/dist/tools/data_stores.js

@@ -0,0 +1,244 @@
+import { z } from "zod";
+import { pid, projectIdArg } from "./helpers.js";
+import { defineTool } from "./types.js";
+const columnType = z.enum([
+    "text",
+    "longtext",
+    "number",
+    "boolean",
+    "url",
+    "image",
+    "date",
+    "json",
+]);
+const columnSpec = z.object({
+    key: z.string().min(1),
+    label: z.string().optional(),
+    type: columnType.default("text"),
+});
+export function dataStoresTools(client) {
+    return [
+        defineTool({
+            name: "data_stores_list",
+            title: "List data stores",
+            description: "List structured data tables (data stores) in the project.",
+            inputSchema: z.object({ projectId: projectIdArg }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.get(`/api/dashboard/${projectId}/data-stores`);
+            },
+        }),
+        defineTool({
+            name: "data_stores_create",
+            title: "Create data store",
+            description: "Create a new data store (structured table) with a schema.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                name: z.string().min(1).max(255),
+                description: z.string().optional(),
+                columns: z.array(columnSpec).min(1).max(50),
+                settings: z.record(z.unknown()).optional(),
+            }),
+            handler: async (args) => {
+                const { projectId: rawPid, ...body } = args;
+                const projectId = pid(client, rawPid);
+                return client.post(`/api/dashboard/${projectId}/data-stores`, body);
+            },
+        }),
+        defineTool({
+            name: "data_stores_get",
+            title: "Get data store",
+            description: "Fetch a data store's schema + metadata.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.get(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}`);
+            },
+        }),
+        defineTool({
+            name: "data_stores_update",
+            title: "Update data store",
+            description: "Patch a data store's name, description, columns, or settings.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                patch: z.object({
+                    name: z.string().optional(),
+                    description: z.string().optional(),
+                    columns: z.array(columnSpec).max(50).optional(),
+                    settings: z.record(z.unknown()).optional(),
+                }),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.patch(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}`, args.patch);
+            },
+        }),
+        defineTool({
+            name: "data_stores_delete",
+            title: "Delete data store",
+            description: "Delete a data store and all its rows. Destructive.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                confirm: z.boolean().default(false),
+            }),
+            handler: async (args) => {
+                if (!args.confirm) {
+                    return {
+                        deleted: false,
+                        reason: "Destructive. Re-invoke with confirm=true.",
+                    };
+                }
+                const projectId = pid(client, args.projectId);
+                return client.delete(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}`);
+            },
+        }),
+        defineTool({
+            name: "data_stores_list_rows",
+            title: "List rows",
+            description: "List rows in a data store with pagination + optional search.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                page: z.number().int().min(1).default(1),
+                pageSize: z.number().int().min(1).max(200).default(50),
+                search: z.string().optional(),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.get(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}/rows`, { page: args.page, pageSize: args.pageSize, search: args.search });
+            },
+        }),
+        defineTool({
+            name: "data_stores_create_row",
+            title: "Create row",
+            description: "Insert one row into a data store.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                data: z.record(z.unknown()),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.post(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}/rows`, { data: args.data });
+            },
+        }),
+        defineTool({
+            name: "data_stores_update_row",
+            title: "Update row",
+            description: "Update one row in a data store by id.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                rowId: z.string().min(1),
+                data: z.record(z.unknown()),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.patch(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}/rows/${encodeURIComponent(args.rowId)}`, { data: args.data });
+            },
+        }),
+        defineTool({
+            name: "data_stores_delete_row",
+            title: "Delete row",
+            description: "Delete one row by id.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                rowId: z.string().min(1),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.delete(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}/rows/${encodeURIComponent(args.rowId)}`);
+            },
+        }),
+        defineTool({
+            name: "data_stores_bulk_upsert",
+            title: "Bulk upsert rows",
+            description: "Insert many rows at once (max 10k). Does not dedupe by default.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                rows: z.array(z.record(z.unknown())).min(1).max(10_000),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.post(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}/rows/bulk`, { rows: args.rows });
+            },
+        }),
+        defineTool({
+            name: "data_stores_bulk_delete",
+            title: "Bulk delete rows",
+            description: "Delete multiple rows by id in one call. Destructive.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                rowIds: z.array(z.string().min(1)).min(1).max(10_000),
+                confirm: z.boolean().default(false),
+            }),
+            handler: async (args) => {
+                if (!args.confirm) {
+                    return {
+                        deleted: false,
+                        reason: "Destructive. Re-invoke with confirm=true.",
+                    };
+                }
+                const projectId = pid(client, args.projectId);
+                return client.delete(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}/rows/bulk`, { rowIds: args.rowIds });
+            },
+        }),
+        defineTool({
+            name: "data_stores_import",
+            title: "Import rows",
+            description: "Bulk-import rows (≤10k) with optional column schema. `replaceExisting: true` wipes existing rows first.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                columns: z.array(columnSpec).max(50).optional(),
+                rows: z.array(z.record(z.unknown())).min(1).max(10_000),
+                replaceExisting: z.boolean().default(false),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.post(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}/import`, {
+                    columns: args.columns,
+                    rows: args.rows,
+                    replaceExisting: args.replaceExisting,
+                });
+            },
+        }),
+        defineTool({
+            name: "data_stores_export",
+            title: "Export rows",
+            description: "Export all rows of a data store as JSON.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.get(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}/export`);
+            },
+        }),
+        defineTool({
+            name: "data_stores_scan_website",
+            title: "Scan website into data store",
+            description: "Crawl a website and extract structured rows into the store. Returns a jobId; use jobs_wait to block until done.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                storeId: z.string().min(1),
+                url: z.string().url(),
+                maxPages: z.number().int().min(1).max(500).default(20),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.post(`/api/dashboard/${projectId}/data-stores/${encodeURIComponent(args.storeId)}/scan`, { url: args.url, maxPages: args.maxPages });
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=data_stores.js.map

package/dist/tools/data_stores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data_stores.js","sourceRoot":"","sources":["../../src/tools/data_stores.ts"],"names":[],"mappings":"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"}

package/dist/tools/documents.d.ts

@@ -0,0 +1,4 @@
+import type { DashboardClient } from "../client.js";
+import { type ToolDef } from "./types.js";
+export declare function documentsTools(client: DashboardClient): ToolDef[];
+//# sourceMappingURL=documents.d.ts.map

package/dist/tools/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AActD,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CA0KjE"}

package/dist/tools/documents.js

@@ -0,0 +1,162 @@
+import { z } from "zod";
+import { defineTool } from "./types.js";
+const projectIdArg = z
+    .string()
+    .min(1)
+    .optional()
+    .describe("Project ID. Defaults to the active profile's projectId if omitted.");
+function pid(client, projectId) {
+    return projectId ?? client.profile.projectId;
+}
+export function documentsTools(client) {
+    return [
+        defineTool({
+            name: "documents_list",
+            title: "List documents",
+            description: "List documents in a project with pagination, search, and filtering. Returns document summaries (name, chunk count, source).",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                search: z.string().optional(),
+                sourceType: z.enum(["pdf", "url", "manual"]).optional(),
+                sectorId: z
+                    .string()
+                    .optional()
+                    .describe("Filter by sector, or '_unassigned' for docs without one."),
+                page: z.number().int().min(1).default(1),
+                pageSize: z.number().int().min(1).max(100).default(20),
+                sortBy: z.enum(["extractedAt", "chunks"]).default("extractedAt"),
+                sortOrder: z.enum(["asc", "desc"]).default("desc"),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.get(`/api/dashboard/${projectId}/documents`, {
+                    search: args.search,
+                    sourceType: args.sourceType,
+                    sectorId: args.sectorId,
+                    page: args.page,
+                    pageSize: args.pageSize,
+                    sortBy: args.sortBy,
+                    sortOrder: args.sortOrder,
+                });
+            },
+        }),
+        defineTool({
+            name: "documents_get",
+            title: "Get document chunks",
+            description: "Get all chunks of a single document by name, including enrichment metadata.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                documentName: z.string().min(1),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.get(`/api/dashboard/${projectId}/documents`, {
+                    documentName: args.documentName,
+                });
+            },
+        }),
+        defineTool({
+            name: "documents_delete",
+            title: "Delete document",
+            description: "Delete all chunks of a document (including non-current versions) from MySQL and Qdrant. Destructive.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                documentName: z.string().min(1),
+                confirm: z
+                    .boolean()
+                    .default(false)
+                    .describe("Required true to actually delete. Guards against misfires."),
+            }),
+            handler: async (args) => {
+                if (!args.confirm) {
+                    return {
+                        deleted: false,
+                        reason: "Destructive operation. Re-invoke with confirm=true to proceed.",
+                    };
+                }
+                const projectId = pid(client, args.projectId);
+                return client.delete(`/api/dashboard/${projectId}/documents`, {
+                    documentName: args.documentName,
+                });
+            },
+        }),
+        defineTool({
+            name: "documents_create_from_text",
+            title: "Create document from text",
+            description: "Create a new manual-text document in the knowledge base. Chunks, embeds, and indexes synchronously. Shows up under the dashboard's 'Text' tab. For URL-sourced content use extract_from_urls instead (it goes through the crawler and links to a link_source). For file uploads use files_upload.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                title: z.string().min(1).max(200),
+                content: z.string().min(50),
+                sectorId: z.string().optional(),
+                audience: z.array(z.string()).optional(),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.post(`/api/dashboard/${projectId}/documents/create`, {
+                    title: args.title,
+                    content: args.content,
+                    sectorId: args.sectorId,
+                    sourceType: "manual",
+                    audience: args.audience,
+                });
+            },
+        }),
+        defineTool({
+            name: "documents_merge",
+            title: "Merge two consecutive chunks",
+            description: "Merge two consecutive chunks of the same document into one. Re-embeds the merged content and updates Qdrant. Provide the merged content verbatim.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                chunkId1: z.number().int(),
+                chunkId2: z.number().int(),
+                mergedContent: z.string().min(1),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.post(`/api/dashboard/${projectId}/documents/merge`, {
+                    chunkId1: args.chunkId1,
+                    chunkId2: args.chunkId2,
+                    mergedContent: args.mergedContent,
+                });
+            },
+        }),
+        defineTool({
+            name: "documents_versions",
+            title: "List or create document versions",
+            description: "action=list → return version history for a specific chunk (documentName + chunkIndex). action=create → create a new version of a chunk (documentId + newContent + changeReason).",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                action: z.enum(["list", "create"]).default("list"),
+                documentName: z.string().optional(),
+                chunkIndex: z.number().int().optional(),
+                documentId: z.number().int().optional(),
+                newContent: z.string().optional(),
+                changeReason: z.string().optional(),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                if (args.action === "list") {
+                    if (!args.documentName || args.chunkIndex === undefined) {
+                        throw new Error("action=list requires documentName and chunkIndex");
+                    }
+                    return client.get(`/api/dashboard/${projectId}/documents/versions`, {
+                        documentName: args.documentName,
+                        chunkIndex: args.chunkIndex,
+                    });
+                }
+                if (args.documentId === undefined ||
+                    !args.newContent ||
+                    !args.changeReason) {
+                    throw new Error("action=create requires documentId, newContent, and changeReason");
+                }
+                return client.post(`/api/dashboard/${projectId}/documents/versions`, {
+                    documentId: args.documentId,
+                    newContent: args.newContent,
+                    changeReason: args.changeReason,
+                });
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=documents.js.map

package/dist/tools/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAEtD,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,EAAE;KACV,QAAQ,CACP,oEAAoE,CACrE,CAAC;AAEJ,SAAS,GAAG,CAAC,MAAuB,EAAE,SAA6B;IACjE,OAAO,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO;QACL,UAAU,CAAC;YACT,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,gBAAgB;YACvB,WAAW,EACT,6HAA6H;YAC/H,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC7B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;gBACvD,QAAQ,EAAE,CAAC;qBACR,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CACP,0DAA0D,CAC3D;gBACH,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,IAAI,CAAC,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;gBAChE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;aACnD,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,YAAY,EAAE;oBACzD,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EACT,6EAA6E;YAC/E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;aAChC,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,YAAY,EAAE;oBACzD,YAAY,EAAE,IAAI,CAAC,YAAY;iBAChC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,iBAAiB;YACxB,WAAW,EACT,sGAAsG;YACxG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/B,OAAO,EAAE,CAAC;qBACP,OAAO,EAAE;qBACT,OAAO,CAAC,KAAK,CAAC;qBACd,QAAQ,CACP,4DAA4D,CAC7D;aACJ,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,EACJ,gEAAgE;qBACnE,CAAC;gBACJ,CAAC;gBACD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAkB,SAAS,YAAY,EAAE;oBAC5D,YAAY,EAAE,IAAI,CAAC,YAAY;iBAChC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,4BAA4B;YAClC,KAAK,EAAE,2BAA2B;YAClC,WAAW,EACT,mSAAmS;YACrS,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;gBACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC/B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;aACzC,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,IAAI,CAAC,kBAAkB,SAAS,mBAAmB,EAAE;oBACjE,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,UAAU,EAAE,QAAQ;oBACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;iBACxB,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,8BAA8B;YACrC,WAAW,EACT,mJAAmJ;YACrJ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;gBAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;gBAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;aACjC,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,IAAI,CAAC,kBAAkB,SAAS,kBAAkB,EAAE;oBAChE,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,aAAa,EAAE,IAAI,CAAC,aAAa;iBAClC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,oBAAoB;YAC1B,KAAK,EAAE,kCAAkC;YACzC,WAAW,EACT,kLAAkL;YACpL,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,SAAS,EAAE,YAAY;gBACvB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;gBAClD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;gBACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;gBACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aACpC,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC3B,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;wBACxD,MAAM,IAAI,KAAK,CACb,kDAAkD,CACnD,CAAC;oBACJ,CAAC;oBACD,OAAO,MAAM,CAAC,GAAG,CACf,kBAAkB,SAAS,qBAAqB,EAChD;wBACE,YAAY,EAAE,IAAI,CAAC,YAAY;wBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;qBAC5B,CACF,CAAC;gBACJ,CAAC;gBACD,IACE,IAAI,CAAC,UAAU,KAAK,SAAS;oBAC7B,CAAC,IAAI,CAAC,UAAU;oBAChB,CAAC,IAAI,CAAC,YAAY,EAClB,CAAC;oBACD,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;gBACJ,CAAC;gBACD,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,SAAS,qBAAqB,EAAE;oBACnE,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;iBAChC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/extract.d.ts

@@ -0,0 +1,4 @@
+import type { DashboardClient } from "../client.js";
+import { type ToolDef } from "./types.js";
+export declare function extractTools(client: DashboardClient): ToolDef[];
+//# sourceMappingURL=extract.d.ts.map

package/dist/tools/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/tools/extract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CA+B/D"}

package/dist/tools/extract.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { pid, projectIdArg } from "./helpers.js";
+import { defineTool } from "./types.js";
+export function extractTools(client) {
+    return [
+        defineTool({
+            name: "extract_from_urls",
+            title: "Extract documents from URLs",
+            description: "Batch-extract documents from a list of URLs into the project's knowledge base. Returns synchronously when fast; for large batches the backend may return a jobId (then use jobs_wait).",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                urls: z.array(z.string().url()).min(1).max(500),
+                concurrency: z.number().int().min(1).max(10).default(3),
+                sectorId: z.string().optional(),
+                audience: z.array(z.string()).optional(),
+            }),
+            handler: async (args) => {
+                for (const url of args.urls) {
+                    assertPublicUrl(url);
+                }
+                const projectId = pid(client, args.projectId);
+                return client.post(`/api/dashboard/${projectId}/extract-documents`, {
+                    urls: args.urls,
+                    concurrency: args.concurrency,
+                    sectorId: args.sectorId,
+                    audience: args.audience,
+                });
+            },
+        }),
+    ];
+}
+/**
+ * Defense-in-depth against SSRF: refuse private IP ranges and metadata
+ * endpoints before we even hit the server. The server also validates.
+ */
+function assertPublicUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid URL: ${url}`);
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`Only http/https URLs allowed: ${url}`);
+    }
+    const host = parsed.hostname.toLowerCase();
+    if (host === "localhost" ||
+        host === "127.0.0.1" ||
+        host === "::1" ||
+        host === "169.254.169.254" ||
+        host === "metadata.google.internal" ||
+        host.endsWith(".localhost") ||
+        host.endsWith(".local")) {
+        throw new Error(`Refusing local/metadata host: ${host}`);
+    }
+    if (/^10\./.test(host) || /^192\.168\./.test(host) || /^172\.(1[6-9]|2\d|3[01])\./.test(host)) {
+        throw new Error(`Refusing private IP range: ${host}`);
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/tools/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/tools/extract.ts"],"names":[],"mappings":"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"}

package/dist/tools/files.d.ts

@@ -0,0 +1,4 @@
+import type { DashboardClient } from "../client.js";
+import { type ToolDef } from "./types.js";
+export declare function filesTools(client: DashboardClient): ToolDef[];
+//# sourceMappingURL=files.d.ts.map

package/dist/tools/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAUpD,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CAkO7D"}