@aigentyc/mcp 0.3.2 → 0.4.1

package/dist/tools/index.js

@@ -16,9 +16,13 @@ import { linkSourcesTools } from "./link_sources.js";
 import { miscTools } from "./misc.js";
 import { pageQuestionsTools } from "./page_questions.js";
 import { personasTools } from "./personas.js";
+import { projectsTools } from "./projects.js";
+import { scrapersTools } from "./scrapers.js";
 import { toolsCrudTools } from "./tools_crud.js";
 export function allTools(client) {
     return [
+        // Project switching — connect once, then "work on project X" (no re-init).
+        ...projectsTools(client),
         // End-to-end discovery + embedding entry points (call these first).
         ...embedTools(client),
         // Content authoring
@@ -28,6 +32,7 @@ export function allTools(client) {
         ...linkSourcesTools(client),
         ...pageQuestionsTools(client),
         ...dataStoresTools(client),
+        ...scrapersTools(client),
         // Custom tools / flows
         ...toolsCrudTools(client),
         // Forms (forms + option sources + provider integrations)

package/dist/tools/index.js.map

@@ -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,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,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,oEAAoE;QACpE,GAAG,UAAU,CAAC,MAAM,CAAC;QACrB,oBAAoB;QACpB,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,uBAAuB;QACvB,GAAG,cAAc,CAAC,MAAM,CAAC;QACzB,yDAAyD;QACzD,GAAG,UAAU,CAAC,MAAM,CAAC;QACrB,GAAG,sBAAsB,CAAC,MAAM,CAAC;QACjC,GAAG,iBAAiB,CAAC,MAAM,CAAC;QAC5B,WAAW;QACX,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC7B,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC3B,GAAG,aAAa,CAAC,MAAM,CAAC;QACxB,cAAc;QACd,GAAG,WAAW,CAAC,MAAM,CAAC;QACtB,GAAG,YAAY,CAAC,MAAM,CAAC;QACvB,uBAAuB;QACvB,GAAG,SAAS,CAAC,MAAM,CAAC;QACpB,GAAG,SAAS,CAAC,MAAM,CAAC;QACpB,GAAG,cAAc,CAAC,MAAM,CAAC;KAC1B,CAAC;AACJ,CAAC"}
+{"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,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,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,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,QAAQ,CAAC,MAAuB;IAC9C,OAAO;QACL,2EAA2E;QAC3E,GAAG,aAAa,CAAC,MAAM,CAAC;QACxB,oEAAoE;QACpE,GAAG,UAAU,CAAC,MAAM,CAAC;QACrB,oBAAoB;QACpB,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,aAAa,CAAC,MAAM,CAAC;QACxB,uBAAuB;QACvB,GAAG,cAAc,CAAC,MAAM,CAAC;QACzB,yDAAyD;QACzD,GAAG,UAAU,CAAC,MAAM,CAAC;QACrB,GAAG,sBAAsB,CAAC,MAAM,CAAC;QACjC,GAAG,iBAAiB,CAAC,MAAM,CAAC;QAC5B,WAAW;QACX,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC7B,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC3B,GAAG,aAAa,CAAC,MAAM,CAAC;QACxB,cAAc;QACd,GAAG,WAAW,CAAC,MAAM,CAAC;QACtB,GAAG,YAAY,CAAC,MAAM,CAAC;QACvB,uBAAuB;QACvB,GAAG,SAAS,CAAC,MAAM,CAAC;QACpB,GAAG,SAAS,CAAC,MAAM,CAAC;QACpB,GAAG,cAAc,CAAC,MAAM,CAAC;KAC1B,CAAC;AACJ,CAAC"}

package/dist/tools/projects.d.ts

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

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

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

package/dist/tools/projects.js

@@ -0,0 +1,164 @@
+import { z } from "zod";
+import { DEFAULT_BASE_URL, loadConfig, requireConfig, saveConfig, setActiveProfile, upsertProfile, } from "../config.js";
+import { AigentycError } from "../errors.js";
+import { verifyKey } from "../verify.js";
+import { defineTool } from "./types.js";
+/**
+ * Resolve a profile by its name, projectId, or (case-insensitive) label so the
+ * agent can switch using whatever the user said ("beta", "proj_123", ...).
+ */
+function resolveProfile(cfg, query) {
+    if (cfg.profiles[query])
+        return { name: query, profile: cfg.profiles[query] };
+    for (const [name, p] of Object.entries(cfg.profiles)) {
+        if (p.projectId === query)
+            return { name, profile: p };
+    }
+    const q = query.toLowerCase();
+    for (const [name, p] of Object.entries(cfg.profiles)) {
+        if (p.label && p.label.toLowerCase() === q)
+            return { name, profile: p };
+    }
+    return null;
+}
+export function projectsTools(client) {
+    return [
+        defineTool({
+            name: "projects_list",
+            title: "List configured projects you can switch between",
+            description: "List every project (profile) configured locally, with its name, label, and projectId, and which one is currently active. Call this first when the user refers to a project by name so you can switch to it with projects_use.",
+            inputSchema: z.object({}),
+            handler: async () => {
+                const cfg = await requireConfig();
+                return {
+                    active: cfg.activeProfile,
+                    projects: Object.entries(cfg.profiles).map(([name, p]) => ({
+                        name,
+                        label: p.label,
+                        projectId: p.projectId,
+                        baseUrl: p.baseUrl,
+                        isActive: name === cfg.activeProfile,
+                    })),
+                };
+            },
+        }),
+        defineTool({
+            name: "projects_current",
+            title: "Show the currently active project",
+            description: "Return the project all other tools currently target (name, label, projectId, baseUrl).",
+            inputSchema: z.object({}),
+            handler: async () => {
+                const cfg = await requireConfig();
+                const p = cfg.profiles[cfg.activeProfile];
+                return {
+                    name: cfg.activeProfile,
+                    label: p?.label,
+                    projectId: p?.projectId,
+                    baseUrl: p?.baseUrl,
+                };
+            },
+        }),
+        defineTool({
+            name: "projects_use",
+            title: "Switch the active project for all subsequent tools",
+            description: "Switch the project that every other tool targets. Accepts a profile name, a projectId, or a label. The switch persists across restarts and stays in effect until changed. Use this when the user says 'work on project X'. Returns a get-started snapshot of the project you switched to.",
+            inputSchema: z.object({
+                project: z
+                    .string()
+                    .min(1)
+                    .describe("Which project to switch to: a profile name, projectId, or label. See projects_list."),
+            }),
+            handler: async ({ project }) => {
+                const cfg = await requireConfig();
+                const match = resolveProfile(cfg, project);
+                if (!match) {
+                    throw new AigentycError("NOT_FOUND", `No configured project matches "${project}". Available: ${Object.keys(cfg.profiles).join(", ") || "(none)"}. Add one with projects_add.`);
+                }
+                // Swap the live credential (apiKey + baseUrl + projectId) and persist.
+                client.useProfile(match.profile);
+                await saveConfig(setActiveProfile(cfg, match.name));
+                let getStarted;
+                try {
+                    getStarted = await client.get(`/api/dashboard/${match.profile.projectId}/get-started`);
+                }
+                catch (err) {
+                    getStarted = {
+                        note: "Switched, but could not load get-started.",
+                        error: err instanceof Error ? err.message : String(err),
+                    };
+                }
+                return {
+                    switchedTo: match.name,
+                    label: match.profile.label,
+                    projectId: match.profile.projectId,
+                    getStarted,
+                };
+            },
+        }),
+        defineTool({
+            name: "projects_add",
+            title: "Connect a new project (one-time) and optionally switch to it",
+            description: "Save a new project locally so you can switch to it later without leaving the conversation. The API key is project-scoped and stored in ~/.aigentyc/config.json with 0600 permissions. The key is verified against the backend before saving. By default the new project becomes active immediately.",
+            inputSchema: z.object({
+                name: z
+                    .string()
+                    .min(1)
+                    .describe("Profile name to save this project under (used to switch)."),
+                projectId: z.string().min(1).describe("The project's ID."),
+                apiKey: z
+                    .string()
+                    .min(1)
+                    .describe("Project-scoped API key (e.g. tyco_...)."),
+                baseUrl: z
+                    .string()
+                    .url()
+                    .optional()
+                    .describe(`Backend base URL. Defaults to ${DEFAULT_BASE_URL}.`),
+                label: z
+                    .string()
+                    .optional()
+                    .describe("Friendly display name used when listing/switching."),
+                allowInsecure: z
+                    .boolean()
+                    .optional()
+                    .describe("Allow plaintext HTTP to non-loopback hosts. Dev only."),
+                activate: z
+                    .boolean()
+                    .optional()
+                    .describe("Switch to this project after adding. Default true."),
+            }),
+            handler: async (args) => {
+                const baseUrl = (args.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+                const result = await verifyKey({
+                    baseUrl,
+                    projectId: args.projectId,
+                    apiKey: args.apiKey,
+                });
+                if (!result.ok) {
+                    throw new AigentycError("UNAUTHORIZED", `${result.error ?? "Key verification failed."} Refusing to save.`);
+                }
+                const profile = {
+                    baseUrl,
+                    projectId: args.projectId,
+                    apiKey: args.apiKey,
+                    label: args.label,
+                    allowInsecure: args.allowInsecure,
+                };
+                const activate = args.activate !== false;
+                const existing = await loadConfig();
+                const next = upsertProfile(existing, args.name, profile, activate);
+                await saveConfig(next);
+                if (activate)
+                    client.useProfile(profile);
+                return {
+                    added: args.name,
+                    label: profile.label,
+                    projectId: profile.projectId,
+                    activeProfile: next.activeProfile,
+                    activated: activate,
+                };
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

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

package/dist/tools/scrapers.d.ts

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

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

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

package/dist/tools/scrapers.js

@@ -0,0 +1,218 @@
+import { z } from "zod";
+import { pid, projectIdArg } from "./helpers.js";
+import { defineTool } from "./types.js";
+// Scrapers store a ScrapeConfig (the "recipe", normally built by the
+// aigentyc-scraper browser extension) plus execution metadata: where results
+// land (destinations), how to dedup (upsertKey), and when to run (cron /
+// webhook / manual). Creating one provisions a backing cron-service job, so
+// trigger + run history flow through that job.
+const scrapeConfig = z
+    .object({
+    url: z.string().url().describe("The list/grid page URL to scrape."),
+    container: z
+        .object({
+        selector: z
+            .string()
+            .min(1)
+            .describe("CSS selector matching EVERY repeating item on the page."),
+    })
+        .passthrough()
+        .describe("How to find the repeating items. Use scrapers_infer_selectors to build this."),
+})
+    .passthrough()
+    .describe("The scrape recipe. Beyond url + container.selector it carries per-field selectors and options (extra keys preserved verbatim).");
+const destinations = z
+    .object({
+    dataStoreId: z
+        .string()
+        .optional()
+        .describe("Data store the scraped rows are upserted into."),
+    kb: z
+        .boolean()
+        .optional()
+        .describe("When true, scraped content is also pushed into the knowledge base."),
+})
+    .describe("Where scraped results land. Empty = saved config only.");
+// Fields shared by create + update. Required-ness differs, so create overrides
+// `config` to be mandatory below.
+const sharedFields = {
+    name: z.string().optional().describe("Display name. Defaults to the start URL."),
+    config: scrapeConfig.optional(),
+    upsertKey: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("Field key used to dedup rows across runs. null = append-only."),
+    destinations: destinations.optional(),
+    cronExpression: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("5-field cron for scheduled runs. null/omit = no schedule (manual/webhook only)."),
+    timezone: z.string().optional().describe("IANA timezone for the cron. Default UTC."),
+    webhookEnabled: z
+        .boolean()
+        .optional()
+        .describe("Mint a per-scraper webhook token so runs can be triggered by URL."),
+    customHeaders: z
+        .record(z.string())
+        .nullable()
+        .optional()
+        .describe("Headers sent on each fetch (e.g. auth). Stored encrypted; never echoed back."),
+    enabled: z.boolean().optional().describe("Whether scheduled runs fire. Default true."),
+};
+export function scrapersTools(client) {
+    return [
+        defineTool({
+            name: "scrapers_list",
+            title: "List scrapers",
+            description: "List every scraper in the project with its name, start URL, schedule, destinations, and enabled state. Secrets (customHeaders) are never returned.",
+            inputSchema: z.object({ projectId: projectIdArg }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.get(`/api/dashboard/${projectId}/scrapers`);
+            },
+        }),
+        defineTool({
+            name: "scrapers_get",
+            title: "Get a scraper",
+            description: "Fetch one scraper including its full `config` recipe (so it can be edited or re-run). customHeaders are never returned.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                scraperId: z.string().min(1),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.get(`/api/dashboard/${projectId}/scrapers/${encodeURIComponent(args.scraperId)}`);
+            },
+        }),
+        defineTool({
+            name: "scrapers_create",
+            title: "Create a scraper",
+            description: [
+                "Create a scraper. `config.url` and `config.container.selector` are required — build the recipe with scrapers_infer_selectors (or the browser extension) first.",
+                "",
+                "Automation: set `cronExpression` for scheduled runs and/or `webhookEnabled` for URL-triggered runs. With neither, it's a saved config you fire manually via scrapers_trigger.",
+                "Set `destinations.dataStoreId` and/or `destinations.kb` to route results.",
+            ].join("\n"),
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                ...sharedFields,
+                config: scrapeConfig,
+            }),
+            handler: async (args) => {
+                const { projectId: rawPid, ...body } = args;
+                const projectId = pid(client, rawPid);
+                return client.post(`/api/dashboard/${projectId}/scrapers`, body);
+            },
+        }),
+        defineTool({
+            name: "scrapers_update",
+            title: "Update a scraper",
+            description: "Update any subset of a scraper's fields. Changing cronExpression/enabled keeps the backing schedule job in sync. Omitted fields keep their stored values; enabling webhookEnabled mints a token if none exists.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                scraperId: z.string().min(1),
+                ...sharedFields,
+            }),
+            handler: async (args) => {
+                const { projectId: rawPid, scraperId, ...body } = args;
+                const projectId = pid(client, rawPid);
+                return client.put(`/api/dashboard/${projectId}/scrapers/${encodeURIComponent(scraperId)}`, body);
+            },
+        }),
+        defineTool({
+            name: "scrapers_delete",
+            title: "Delete a scraper",
+            description: "Delete a scraper and its backing schedule job. Destructive — re-invoke with confirm=true.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                scraperId: 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}/scrapers/${encodeURIComponent(args.scraperId)}`);
+            },
+        }),
+        defineTool({
+            name: "scrapers_trigger",
+            title: "Run a scraper now",
+            description: "Enqueue an immediate (manual) run of the scraper's backing job and return its queueId. Fails if the scraper is disabled or has no execution job configured.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                scraperId: z.string().min(1),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.post(`/api/dashboard/${projectId}/scrapers/${encodeURIComponent(args.scraperId)}/trigger`);
+            },
+        }),
+        defineTool({
+            name: "scrapers_runs_list",
+            title: "List scraper run history",
+            description: "Return recent execution attempts (status, durations, errors) plus permanently-failed dead-letter entries for the scraper's job. Empty when the scraper has never run.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                scraperId: z.string().min(1),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.get(`/api/dashboard/${projectId}/scrapers/${encodeURIComponent(args.scraperId)}/runs`);
+            },
+        }),
+        defineTool({
+            name: "scrapers_run_retry",
+            title: "Retry a failed scraper run",
+            description: "Re-queue a dead-letter (permanently failed) run by its queueId. Get queueIds from scrapers_runs_list's `deadLetter` array.",
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                scraperId: z.string().min(1),
+                queueId: z.string().min(1).describe("Dead-letter entry id to retry."),
+            }),
+            handler: async (args) => {
+                const projectId = pid(client, args.projectId);
+                return client.post(`/api/dashboard/${projectId}/scrapers/${encodeURIComponent(args.scraperId)}/runs`, { queueId: args.queueId });
+            },
+        }),
+        defineTool({
+            name: "scrapers_infer_selectors",
+            title: "Infer scraper selectors from HTML",
+            description: [
+                "Given an HTML fragment of a repeating list, infer the container selector and per-field relative selectors (key, label, type, selector) to build a scrape `config`.",
+                "Synchronous/interactive. Requires the project to have an OpenAI API key configured.",
+            ].join("\n"),
+            inputSchema: z.object({
+                projectId: projectIdArg,
+                html: z
+                    .string()
+                    .min(1)
+                    .describe("HTML fragment of the list/grid (truncated to ~15k chars server-side)."),
+                sample: z
+                    .object({
+                    selector: z.string().optional(),
+                    tagName: z.string().optional(),
+                    text: z.string().optional(),
+                })
+                    .optional()
+                    .describe("The example element the user clicked inside one item."),
+                mode: z
+                    .enum(["container", "fields"])
+                    .optional()
+                    .describe("Restrict inference to just the container or just the fields."),
+            }),
+            handler: async (args) => {
+                const { projectId: rawPid, ...body } = args;
+                const projectId = pid(client, rawPid);
+                return client.post(`/api/dashboard/${projectId}/scraper/infer-selectors`, body);
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=scrapers.js.map

package/dist/tools/scrapers.js.map

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

package/dist/verify.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Verify a project-scoped API key against a backend, shared by the `login`
+ * CLI command and the `projects_add` MCP tool so both apply the same checks.
+ *
+ * In production the auth-service is fronted at the same origin, so
+ * POST /api/auth/api-keys/verify works. In local dev that endpoint 404s, so
+ * we fall back to pinging the dashboard documents route — the canonical
+ * authenticated surface — and infer acceptance from the status code.
+ */
+export interface VerifyResult {
+    ok: boolean;
+    /** projectId the key is scoped to, when the verify endpoint reported one. */
+    scopedProjectId?: string;
+    /** Human-readable reason when ok is false. */
+    error?: string;
+}
+export declare function verifyKey(args: {
+    baseUrl: string;
+    projectId: string;
+    apiKey: string;
+}): Promise<VerifyResult>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,YAAY,CAAC,CA+DxB"}

package/dist/verify.js

@@ -0,0 +1,59 @@
+export async function verifyKey(args) {
+    const baseUrl = args.baseUrl.replace(/\/$/, "");
+    const verifyUrl = `${baseUrl}/api/auth/api-keys/verify`;
+    const pingUrl = `${baseUrl}/api/dashboard/${encodeURIComponent(args.projectId)}/documents?pageSize=1`;
+    // 1. auth-service verify endpoint (production path).
+    try {
+        const res = await fetch(verifyUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ key: args.apiKey }),
+        });
+        if (res.status !== 404) {
+            const body = (await res.json().catch(() => ({})));
+            if (!res.ok || !body.valid) {
+                return { ok: false, error: body.error || `HTTP ${res.status}` };
+            }
+            if (body.projectId && body.projectId !== args.projectId) {
+                return {
+                    ok: false,
+                    scopedProjectId: body.projectId,
+                    error: `API key is scoped to project ${body.projectId}, not ${args.projectId}.`,
+                };
+            }
+            return { ok: true, scopedProjectId: body.projectId };
+        }
+        // 404 → auth endpoint not at this origin (dev). Fall through to ping.
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `Could not reach ${verifyUrl}: ${err.message}`,
+        };
+    }
+    // 2. Dashboard ping fallback (dev path).
+    try {
+        const res = await fetch(pingUrl, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${args.apiKey}` },
+        });
+        if (res.status === 401) {
+            return { ok: false, error: "Key rejected by dashboard (401)." };
+        }
+        if (res.status === 403) {
+            return {
+                ok: false,
+                error: "Key accepted but not authorized for this project (403).",
+            };
+        }
+        // 200 or 404 (project not found) → key was accepted by the auth layer.
+        return { ok: true };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `Could not reach ${pingUrl}: ${err.message}`,
+        };
+    }
+}
+//# sourceMappingURL=verify.js.map

package/dist/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAI/B;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,GAAG,OAAO,2BAA2B,CAAC;IACxD,MAAM,OAAO,GAAG,GAAG,OAAO,kBAAkB,kBAAkB,CAC5D,IAAI,CAAC,SAAS,CACf,uBAAuB,CAAC;IAEzB,qDAAqD;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;YACjC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;SAC3C,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAI/C,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC3B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YAClE,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBACxD,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,eAAe,EAAE,IAAI,CAAC,SAAS;oBAC/B,KAAK,EAAE,gCAAgC,IAAI,CAAC,SAAS,SAAS,IAAI,CAAC,SAAS,GAAG;iBAChF,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACvD,CAAC;QACD,sEAAsE;IACxE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,mBAAmB,SAAS,KAAM,GAAa,CAAC,OAAO,EAAE;SACjE,CAAC;IACJ,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;YAC/B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE;SACpD,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QAClE,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,yDAAyD;aACjE,CAAC;QACJ,CAAC;QACD,uEAAuE;QACvE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,mBAAmB,OAAO,KAAM,GAAa,CAAC,OAAO,EAAE;SAC/D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/llms.txt

@@ -182,4 +182,4 @@ config_update({ patch: { systemPrompt: "You are the support agent for ACME..." }
 
 ## Versioning
 
-Server (`@aigentyc/mcp` on npm) and platform (`app.aigentyc.com`) version independently. The platform maintains backward compatibility with older MCP releases — endpoints aren't broken without deprecation.
+Server (`@aigentyc/mcp` on npm) and platform (`app.aigentyc.ai`) version independently. The platform maintains backward compatibility with older MCP releases — endpoints aren't broken without deprecation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigentyc/mcp",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "Model Context Protocol server for aiGentyc — content & authoring tools for LLM agents",
   "license": "MIT",
   "type": "module",