tomoshi 1.0.0

package/dist/stdio.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { StdioTransport } from "@tmcp/transport-stdio";
+import { createServer } from "./server.js";
+const server = createServer();
+const transport = new StdioTransport(server);
+await transport.listen();
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AAC7C,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC"}

package/dist/tools/discover.d.ts

@@ -0,0 +1,52 @@
+import * as v from "valibot";
+import type { CinderClient } from "../client.js";
+export declare const DiscoverSchema: v.VariantSchema<"action", [v.ObjectSchema<{
+    readonly action: v.SchemaWithPipe<readonly [v.PicklistSchema<["search"], undefined>, v.DescriptionAction<"search", "Web search via SearXNG (Brave fallback)">]>;
+    readonly query: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "The search query">, v.MinLengthAction<string, 1, "Search query cannot be empty">]>;
+    readonly offset: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.DescriptionAction<number, "Pagination offset for results">]>, 0>;
+    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>, v.DescriptionAction<number, "Number of results to return (1-100)">]>, 10>;
+    readonly mode: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["fast"], undefined>, v.DescriptionAction<"fast", "Search speed: 'fast' restricts to recent results (last day)">]>, undefined>;
+    readonly includeDomains: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.DescriptionAction<string[], "Restrict results to these domains">]>, undefined>;
+    readonly excludeDomains: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.DescriptionAction<string[], "Exclude results from these domains">]>, undefined>;
+    readonly requiredText: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.DescriptionAction<string[], "Only return results containing this text">]>, undefined>;
+    readonly maxAge: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<[1, 7, 30], undefined>, v.DescriptionAction<1 | 7 | 30, "Max age in days: 1 (day), 7 (week), 30 (month)">]>, undefined>;
+    readonly category: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["general", "news", "code"], undefined>, v.DescriptionAction<"code" | "general" | "news", "Category filter: general, news, code (maps to SearXNG categories)">]>, undefined>;
+    readonly rerank: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Lightweight TF-IDF re-rank (pure Go, no ONNX) — reorders by query-term score">]>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly action: v.SchemaWithPipe<readonly [v.PicklistSchema<["map"], undefined>, v.DescriptionAction<"map", "Discover URLs on a site via sitemap/link traversal">]>;
+    readonly url: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "The site URL to map (discover URLs via sitemap/link traversal)">, v.UrlAction<string, "Must be a valid URL">]>;
+    readonly search: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Only return URLs containing this substring (e.g. '/docs')">]>, undefined>;
+    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 5000, undefined>, v.DescriptionAction<number, "Maximum URLs to return (1-5000, default 100)">]>, 100>;
+}, undefined>, v.ObjectSchema<{
+    readonly action: v.SchemaWithPipe<readonly [v.PicklistSchema<["crawl"], undefined>, v.DescriptionAction<"crawl", "Enqueue async BFS crawl (requires Redis, returns task ID)">]>;
+    readonly url: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "The root URL to start crawling from">, v.UrlAction<string, "Must be a valid URL">]>;
+    readonly mode: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["smart", "static", "dynamic"], undefined>, v.DescriptionAction<"smart" | "static" | "dynamic", "Scraping mode per page: smart, static, or dynamic">]>, "smart">;
+    readonly render: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Render JavaScript for each page (headless browser)">]>, false>;
+    readonly screenshot: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    readonly images: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    readonly image_format: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["url", "blob"], undefined>, v.DescriptionAction<"url" | "blob", "Image transport: 'url' (metadata only) or 'blob' (base64)">]>, "url">;
+    readonly maxDepth: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 10, undefined>, v.DescriptionAction<number, "Maximum crawl depth (1-10)">]>, 2>;
+    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>, v.DescriptionAction<number, "Maximum number of pages to crawl (1-100)">]>, 10>;
+    readonly include_paths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.DescriptionAction<string[], "Only follow links whose path matches these globs (e.g. ['/blog/*'])">]>, undefined>;
+    readonly exclude_paths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.DescriptionAction<string[], "Never follow links whose path matches these globs (exclusion wins)">]>, undefined>;
+    readonly webhook_url: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "POST the crawl result here on completion">]>, undefined>;
+    readonly webhook_secret: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "HMAC-SHA256 key for the X-Cinder-Signature header">]>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly action: v.SchemaWithPipe<readonly [v.PicklistSchema<["crawl_status"], undefined>, v.DescriptionAction<"crawl_status", "Poll async crawl job status">]>;
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "The task ID returned by cinder_discover action=crawl">, v.MinLengthAction<string, 1, "Task ID is required">]>;
+}, undefined>], undefined>;
+export type DiscoverInput = v.InferOutput<typeof DiscoverSchema>;
+export declare function createDiscoverHandler(client: CinderClient): (input: Record<string, unknown>) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/tools/discover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAC7B,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,cAAc,CAAC;AAkOtB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAKzB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAejE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,IAC1C,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAoJ7C"}

package/dist/tools/discover.js

@@ -0,0 +1,209 @@
+import * as v from "valibot";
+/**
+ * Resource-oriented multiplexed discovery tool.
+ * Consolidates `cinder_search` + `cinder_map` + `cinder_crawl`
+ * into a single `cinder_discover` resource (3→1).
+ *
+ * Principle: 1 tool per domain resource with `action` enum
+ * (arch.md "Why 7 Tools Instead of 17" — FlarelyLegal 17→7).
+ * Reduces token overhead, improves LLM tool-selection accuracy,
+ * stays well under MCP client limits.
+ *
+ * Actions:
+ * - `search`      — web search via SearXNG/Brave (POST /v1/search)
+ * - `map`         — site URL discovery via sitemap/traversal (POST /v1/map)
+ * - `crawl`       — enqueue async BFS crawl (POST /v1/crawl, Redis)
+ * - `crawl_status`— poll crawl job (GET /v1/crawl/:id, Redis)
+ */
+// ── search ─────────────────────────────────────────────────────────────
+const DiscoverSearchShape = v.object({
+    action: v.pipe(v.picklist(["search"]), v.description("Web search via SearXNG (Brave fallback)")),
+    query: v.pipe(v.string(), v.description("The search query"), v.minLength(1, "Search query cannot be empty")),
+    offset: v.optional(v.pipe(v.number(), v.minValue(0), v.description("Pagination offset for results")), 0),
+    limit: v.optional(v.pipe(v.number(), v.minValue(1), v.maxValue(100), v.description("Number of results to return (1-100)")), 10),
+    mode: v.optional(v.pipe(v.picklist(["fast"]), v.description("Search speed: 'fast' restricts to recent results (last day)"))),
+    includeDomains: v.optional(v.pipe(v.array(v.string()), v.description("Restrict results to these domains"))),
+    excludeDomains: v.optional(v.pipe(v.array(v.string()), v.description("Exclude results from these domains"))),
+    requiredText: v.optional(v.pipe(v.array(v.string()), v.description("Only return results containing this text"))),
+    maxAge: v.optional(v.pipe(v.picklist([1, 7, 30]), v.description("Max age in days: 1 (day), 7 (week), 30 (month)"))),
+    category: v.optional(v.pipe(v.picklist(["general", "news", "code"]), v.description("Category filter: general, news, code (maps to SearXNG categories)"))),
+    rerank: v.optional(v.pipe(v.boolean(), v.description("Lightweight TF-IDF re-rank (pure Go, no ONNX) — reorders by query-term score"))),
+});
+// ── map ────────────────────────────────────────────────────────────────
+const DiscoverMapShape = v.object({
+    action: v.pipe(v.picklist(["map"]), v.description("Discover URLs on a site via sitemap/link traversal")),
+    url: v.pipe(v.string(), v.description("The site URL to map (discover URLs via sitemap/link traversal)"), v.url("Must be a valid URL")),
+    search: v.optional(v.pipe(v.string(), v.description("Only return URLs containing this substring (e.g. '/docs')"))),
+    limit: v.optional(v.pipe(v.number(), v.minValue(1), v.maxValue(5000), v.description("Maximum URLs to return (1-5000, default 100)")), 100),
+});
+// ── crawl (enqueue) ────────────────────────────────────────────────────
+const DiscoverCrawlShape = v.object({
+    action: v.pipe(v.picklist(["crawl"]), v.description("Enqueue async BFS crawl (requires Redis, returns task ID)")),
+    url: v.pipe(v.string(), v.description("The root URL to start crawling from"), v.url("Must be a valid URL")),
+    mode: v.optional(v.pipe(v.picklist(["smart", "static", "dynamic"]), v.description("Scraping mode per page: smart, static, or dynamic")), "smart"),
+    render: v.optional(v.pipe(v.boolean(), v.description("Render JavaScript for each page (headless browser)")), false),
+    screenshot: v.optional(v.boolean(), false),
+    images: v.optional(v.boolean(), false),
+    image_format: v.optional(v.pipe(v.picklist(["url", "blob"]), v.description("Image transport: 'url' (metadata only) or 'blob' (base64)")), "url"),
+    maxDepth: v.optional(v.pipe(v.number(), v.minValue(1), v.maxValue(10), v.description("Maximum crawl depth (1-10)")), 2),
+    limit: v.optional(v.pipe(v.number(), v.minValue(1), v.maxValue(100), v.description("Maximum number of pages to crawl (1-100)")), 10),
+    include_paths: v.optional(v.pipe(v.array(v.string()), v.description("Only follow links whose path matches these globs (e.g. ['/blog/*'])"))),
+    exclude_paths: v.optional(v.pipe(v.array(v.string()), v.description("Never follow links whose path matches these globs (exclusion wins)"))),
+    webhook_url: v.optional(v.pipe(v.string(), v.description("POST the crawl result here on completion"))),
+    webhook_secret: v.optional(v.pipe(v.string(), v.description("HMAC-SHA256 key for the X-Cinder-Signature header"))),
+});
+// ── crawl_status (poll) ────────────────────────────────────────────────
+const DiscoverCrawlStatusShape = v.object({
+    action: v.pipe(v.picklist(["crawl_status"]), v.description("Poll async crawl job status")),
+    id: v.pipe(v.string(), v.description("The task ID returned by cinder_discover action=crawl"), v.minLength(1, "Task ID is required")),
+});
+export const DiscoverSchema = v.variant("action", [
+    DiscoverSearchShape,
+    DiscoverMapShape,
+    DiscoverCrawlShape,
+    DiscoverCrawlStatusShape,
+]);
+function pageTitle(page) {
+    const title = page.title?.trim();
+    if (title)
+        return title;
+    try {
+        const path = new URL(page.url).pathname;
+        const last = path.split("/").filter(Boolean).pop();
+        if (last)
+            return decodeURIComponent(last);
+        return new URL(page.url).hostname;
+    }
+    catch {
+        return page.url;
+    }
+}
+export function createDiscoverHandler(client) {
+    return async (input) => {
+        const { action } = input;
+        try {
+            if (action === "search") {
+                const params = input;
+                const result = await client.search(params);
+                const lines = [
+                    `# Search Results: "${result.query}"`,
+                    "",
+                    `Found ${result.count} results${result.hasMore ? " (more available)" : ""}`,
+                    "",
+                ];
+                for (const item of result.results) {
+                    lines.push(`### ${item.title}`, "", `${item.description}`, "");
+                    if (item.highlights && item.highlights.length > 0) {
+                        lines.push(`> ${item.highlights[0]}`, "");
+                    }
+                    lines.push(`🔗 ${item.url}`);
+                    const meta = [];
+                    if (item.domain)
+                        meta.push(item.domain);
+                    if (item.id)
+                        meta.push(`id: ${item.id}`);
+                    if (typeof item.relevance === "number")
+                        meta.push(`relevance: ${item.relevance.toFixed(3)}`);
+                    if (meta.length > 0)
+                        lines.push(`_${meta.join(" · ")}_`);
+                    lines.push("", "---", "");
+                }
+                if (result.hasMore)
+                    lines.push("", `Use \`cinder_discover\` with \`action: "search"\` and \`offset: ${result.nextOffset}\` to get the next page.`);
+                return { content: [{ type: "text", text: lines.join("\n") }] };
+            }
+            if (action === "map") {
+                const params = input;
+                const result = await client.map(params);
+                const lines = [
+                    `# Map Result: ${result.url}`,
+                    "",
+                    `**Count:** ${result.count}`,
+                    `**Source URL:** ${result.url}`,
+                ];
+                if (params.search)
+                    lines.push(`**Filter:** \`${params.search}\``);
+                lines.push("", "---", "");
+                if (result.links.length === 0)
+                    lines.push("No links discovered (site may have no sitemap and no crawlable links).");
+                else {
+                    lines.push(`## Discovered URLs (${result.links.length})`, "");
+                    for (const link of result.links)
+                        lines.push(`- ${link.url} _(source: ${link.source})_`);
+                }
+                return { content: [{ type: "text", text: lines.join("\n") }] };
+            }
+            if (action === "crawl") {
+                const params = input;
+                const result = await client.crawl(params);
+                const lines = [
+                    "# Crawl Job Enqueued",
+                    "",
+                    `**URL:** ${result.url}`,
+                    `**Task ID:** \`${result.id}\``,
+                    `**Render:** ${result.render}`,
+                    `**Screenshot:** ${result.screenshot}`,
+                    `**Images:** ${result.images}`,
+                    `**Max Depth:** ${result.maxDepth}`,
+                    `**Limit:** ${result.limit}`,
+                ];
+                if (result.image_format)
+                    lines.push(`**Image Format:** ${result.image_format}`);
+                lines.push("", "---", "", `Use \`cinder_discover\` with \`action: "crawl_status"\` and \`id: "${result.id}"\` to poll.`, "The crawl runs asynchronously — poll until state is `completed` or `failed`.", "Requires Redis-backed Cinder instance.");
+                return { content: [{ type: "text", text: lines.join("\n") }] };
+            }
+            // crawl_status
+            const { id } = input;
+            const result = await client.getCrawlStatus(id);
+            const lines = [
+                "# Crawl Status",
+                "",
+                `**Task ID:** \`${result.id}\``,
+                `**State:** ${result.state}`,
+            ];
+            if (result.queue)
+                lines.push(`**Queue:** ${result.queue}`);
+            if (result.state === "completed" && result.crawl) {
+                const c = result.crawl;
+                lines.push("", "---", `## Results (${c.status}, ${c.total_pages} pages, max depth: ${c.max_depth}, limit: ${c.limit})`, "");
+                for (const page of c.pages) {
+                    lines.push(`### ${pageTitle(page)}`);
+                    lines.push(`🔗 ${page.url}`);
+                    if (page.preview)
+                        lines.push("", `> ${page.preview}`, "");
+                    lines.push("");
+                }
+                if (c.failed_urls && c.failed_urls.length > 0) {
+                    lines.push("### Failed URLs", "");
+                    for (const f of c.failed_urls)
+                        lines.push(`- ${f.url}: ${f.error}`);
+                }
+            }
+            else if (result.state === "failed" &&
+                result.failed_urls &&
+                result.failed_urls.length > 0) {
+                lines.push("", "---", "### Failed URLs", "");
+                for (const f of result.failed_urls)
+                    lines.push(`- ${f.url}: ${f.error}`);
+            }
+            if (result.state === "failed")
+                lines.push("", "---", "⚠️ The crawl job failed. Try again with a different URL or fewer pages.");
+            if (result.state === "pending" || result.state === "active")
+                lines.push("", "---", "⏳ The crawl is still in progress. Check back later.");
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Unknown error";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Discover ${action} failed: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    };
+}
+//# sourceMappingURL=discover.js.map

package/dist/tools/discover.js.map

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

package/dist/tools/extract.d.ts

@@ -0,0 +1,147 @@
+import * as v from "valibot";
+import type { CinderClient } from "../client.js";
+export declare const ExtractSchema: v.VariantSchema<"action", [v.ObjectSchema<{
+    readonly action: v.SchemaWithPipe<readonly [v.PicklistSchema<["scrape"], undefined>, v.DescriptionAction<"scrape", "Scrape a single page into markdown">]>;
+    readonly url: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "The URL to scrape">, v.UrlAction<string, "Must be a valid URL">]>;
+    readonly mode: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["smart", "static", "dynamic"], undefined>, v.DescriptionAction<"smart" | "static" | "dynamic", "Scraping mode: smart (auto), static (colly), dynamic (chromedp)">]>, "smart">;
+    readonly screenshot: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Capture a screenshot (needs dynamic/smart)">]>, false>;
+    readonly screenshot_opts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly width: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly height: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly full_page: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly format: v.OptionalSchema<v.PicklistSchema<["jpeg", "png"], undefined>, undefined>;
+        readonly quality: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>]>, undefined>;
+        readonly wait_selector: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.DescriptionAction<{
+        width?: number | undefined;
+        height?: number | undefined;
+        full_page?: boolean | undefined;
+        format?: "jpeg" | "png" | undefined;
+        quality?: number | undefined;
+        wait_selector?: string | undefined;
+    }, "Screenshot configuration (width, height, full_page, format, quality, wait_selector)">]>, undefined>;
+    readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Extract images from the page">]>, false>;
+    readonly image_format: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["url", "blob"], undefined>, v.DescriptionAction<"url" | "blob", "Image transport: 'url' (metadata only) or 'blob' (base64)">]>, "url">;
+    readonly max_images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 50, undefined>, v.DescriptionAction<number, "Max images to extract (default 10)">]>, 10>;
+    readonly max_image_size_kb: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.DescriptionAction<number, "Max individual image size in KB (default 5120)">]>, 5120>;
+    readonly image_process: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly format: v.OptionalSchema<v.PicklistSchema<["jpeg", "png"], undefined>, undefined>;
+        readonly max_width: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly quality: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>]>, undefined>;
+    }, undefined>, v.DescriptionAction<{
+        format?: "jpeg" | "png" | undefined;
+        max_width?: number | undefined;
+        quality?: number | undefined;
+    }, "Resize/re-encode image blobs (format, max_width, quality)">]>, undefined>;
+    readonly actions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
+        readonly type: v.PicklistSchema<["wait_ms", "wait_selector", "click", "scroll_down", "scroll_to_bottom"], undefined>;
+        readonly ms: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly selector: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, v.DescriptionAction<{
+        type: "wait_ms" | "wait_selector" | "click" | "scroll_down" | "scroll_to_bottom";
+        ms?: number | undefined;
+        selector?: string | undefined;
+    }[], "Page interactions before capture (dynamic mode only)">]>, undefined>;
+    readonly extract_schema: v.OptionalSchema<v.SchemaWithPipe<readonly [v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+        readonly selector: v.StringSchema<undefined>;
+        readonly attr: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly multiple: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    }, undefined>, undefined>, v.DescriptionAction<{
+        [x: string]: {
+            selector: string;
+            attr?: string | undefined;
+            multiple?: boolean | undefined;
+        };
+    }, "Deterministic CSS-selector extraction: {field: {selector, attr?, multiple?}}">]>, undefined>;
+    readonly summary: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Return an extractive summary (no LLM)">]>, false>;
+    readonly summary_sentences: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 50, undefined>, v.DescriptionAction<number, "Sentence count for the summary (default 5)">]>, 5>;
+    readonly redact_pii: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Mask emails, phones, and card-shaped numbers">]>, false>;
+    readonly block_ads: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Strip ad/tracker containers before conversion">]>, true>;
+    readonly remove_base64_images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Drop inline data: images before conversion">]>, true>;
+    readonly include_links: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Include extracted links (default true, Firecrawl formats: [\"links\"] parity — enriched to {url, text, isInternal})">]>, true>;
+    readonly render: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Deprecated: behaves like mode=dynamic">]>, false>;
+}, undefined>, v.ObjectSchema<{
+    readonly action: v.SchemaWithPipe<readonly [v.PicklistSchema<["scrape_multi"], undefined>, v.DescriptionAction<"scrape_multi", "Scrape multiple URLs synchronously (max 10, no Redis) — mirrors web_fetch_exa & Firecrawl batch sync">]>;
+    readonly urls: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.UrlAction<string, "Must be a valid URL">]>, undefined>, v.MinLengthAction<string[], 1, "At least one URL is required">, v.MaxLengthAction<string[], 10, "Maximum 10 URLs per sync batch">, v.DescriptionAction<string[], "URLs to scrape synchronously (max 10, no Redis, errgroup limit 5)">]>;
+    readonly mode: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["smart", "static", "dynamic"], undefined>, v.DescriptionAction<"smart" | "static" | "dynamic", "Scraping mode: smart (auto), static (colly), dynamic (chromedp)">]>, "smart">;
+    readonly screenshot: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Capture a screenshot">]>, false>;
+    readonly screenshot_opts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly width: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly height: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly full_page: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly format: v.OptionalSchema<v.PicklistSchema<["jpeg", "png"], undefined>, undefined>;
+        readonly quality: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>]>, undefined>;
+        readonly wait_selector: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.DescriptionAction<{
+        width?: number | undefined;
+        height?: number | undefined;
+        full_page?: boolean | undefined;
+        format?: "jpeg" | "png" | undefined;
+        quality?: number | undefined;
+        wait_selector?: string | undefined;
+    }, "Screenshot configuration">]>, undefined>;
+    readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Extract images">]>, false>;
+    readonly image_format: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["url", "blob"], undefined>, v.DescriptionAction<"url" | "blob", "Image transport: url or blob">]>, "url">;
+    readonly max_images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 50, undefined>]>, 10>;
+    readonly max_image_size_kb: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>]>, 5120>;
+    readonly image_process: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly format: v.OptionalSchema<v.PicklistSchema<["jpeg", "png"], undefined>, undefined>;
+        readonly max_width: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly quality: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>]>, undefined>;
+    }, undefined>, v.DescriptionAction<{
+        format?: "jpeg" | "png" | undefined;
+        max_width?: number | undefined;
+        quality?: number | undefined;
+    }, "Resize/re-encode image blobs">]>, undefined>;
+    readonly actions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
+        readonly type: v.PicklistSchema<["wait_ms", "wait_selector", "click", "scroll_down", "scroll_to_bottom"], undefined>;
+        readonly ms: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly selector: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, v.DescriptionAction<{
+        type: "wait_ms" | "wait_selector" | "click" | "scroll_down" | "scroll_to_bottom";
+        ms?: number | undefined;
+        selector?: string | undefined;
+    }[], "Page interactions before capture (dynamic mode only)">]>, undefined>;
+    readonly extract_schema: v.OptionalSchema<v.SchemaWithPipe<readonly [v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+        readonly selector: v.StringSchema<undefined>;
+        readonly attr: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly multiple: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    }, undefined>, undefined>, v.DescriptionAction<{
+        [x: string]: {
+            selector: string;
+            attr?: string | undefined;
+            multiple?: boolean | undefined;
+        };
+    }, "Deterministic CSS-selector extraction">]>, undefined>;
+    readonly summary: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Return an extractive summary">]>, false>;
+    readonly summary_sentences: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 50, undefined>]>, 5>;
+    readonly redact_pii: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Mask emails, phones, card numbers">]>, false>;
+    readonly block_ads: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Strip ad/tracker containers">]>, true>;
+    readonly remove_base64_images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Drop inline data: images">]>, true>;
+    readonly include_links: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Include extracted links (default true)">]>, true>;
+    readonly render: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Deprecated: behaves like mode=dynamic">]>, false>;
+}, undefined>, v.ObjectSchema<{
+    readonly action: v.SchemaWithPipe<readonly [v.PicklistSchema<["links"], undefined>, v.DescriptionAction<"links", "Extract hyperlinks only (lightweight, no markdown)">]>;
+    readonly url: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "The URL to extract hyperlinks from">, v.UrlAction<string, "Must be a valid URL">]>;
+}, undefined>, v.ObjectSchema<{
+    readonly action: v.SchemaWithPipe<readonly [v.PicklistSchema<["batch"], undefined>, v.DescriptionAction<"batch", "Enqueue async batch scrape (max 20 URLs, requires Redis)">]>;
+    readonly urls: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.UrlAction<string, "Must be a valid URL">]>, undefined>, v.MinLengthAction<string[], 1, "At least one URL is required">, v.MaxLengthAction<string[], 20, "Maximum 20 URLs per batch">, v.DescriptionAction<string[], "URLs to scrape asynchronously (max 20, requires Redis)">]>;
+}, undefined>, v.ObjectSchema<{
+    readonly action: v.SchemaWithPipe<readonly [v.PicklistSchema<["batch_status"], undefined>, v.DescriptionAction<"batch_status", "Poll async batch status">]>;
+    readonly batch_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "Batch ID is required">, v.DescriptionAction<string, "The batch_id returned by cinder_extract action=batch">]>;
+}, undefined>], undefined>;
+export type ExtractInput = v.InferOutput<typeof ExtractSchema>;
+export declare function createExtractHandler(client: CinderClient): (input: Record<string, unknown>) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# 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":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAC7B,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,cAAc,CAAC;AAmWtB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAMxB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE/D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,IACzC,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAyP7C"}