context-dev-ai-tools 0.1.0

package/dist/index.js

@@ -0,0 +1,253 @@
+// src/tools/search.ts
+import { tool } from "ai";
+import { z } from "zod";
+
+// src/client.ts
+import { ContextDev, AuthenticationError, RateLimitError } from "context.dev";
+function createClient(config = {}) {
+  return new ContextDev({
+    apiKey: config.apiKey,
+    baseURL: config.baseURL
+  });
+}
+async function callContext(fn) {
+  try {
+    return await fn();
+  } catch (err) {
+    if (err instanceof RateLimitError) {
+      throw new Error(
+        "context.dev rate limit reached. Wait before retrying, reduce request frequency, or upgrade your plan."
+      );
+    }
+    if (err instanceof AuthenticationError) {
+      throw new Error(
+        "context.dev authentication failed. Check that CONTEXT_DEV_API_KEY is set to a valid key."
+      );
+    }
+    throw err;
+  }
+}
+
+// src/tools/search.ts
+var inputSchema = z.object({
+  query: z.string().describe(
+    "Search query. Accepts natural language as well as Google-style operators such as site:, -site:, inurl:, intitle:, quoted phrases, and OR."
+  ),
+  numResults: z.number().int().min(10).max(100).optional().describe("Number of results to request (10-100). Defaults to 10."),
+  freshness: z.enum(["last_24_hours", "last_week", "last_month", "last_year"]).optional().describe("Restrict results to content published within this window."),
+  includeDomains: z.array(z.string()).optional().describe('Allowlist domains, e.g. ["arxiv.org", "github.com"].'),
+  excludeDomains: z.array(z.string()).optional().describe('Blocklist domains, e.g. ["pinterest.com"].'),
+  country: z.string().length(2).optional().describe("Two-letter ISO 3166-1 alpha-2 country code to localize results, e.g. 'us', 'gb', 'de'.")
+});
+var contextSearch = (config = {}) => {
+  const client = createClient(config);
+  return tool({
+    description: "Search the live web and get back structured results (title, url, snippet) using context.dev's real-time search index.",
+    inputSchema,
+    execute: async ({ country, ...rest }) => callContext(
+      () => client.web.search({ ...rest, country })
+    )
+  });
+};
+
+// src/tools/scrape.ts
+import { tool as tool2 } from "ai";
+import { z as z2 } from "zod";
+var inputSchema2 = z2.object({
+  url: z2.string().url().describe("Full URL to scrape into LLM-usable Markdown (must include http:// or https://)."),
+  includeImages: z2.boolean().optional().describe("Include image references in the Markdown output."),
+  includeLinks: z2.boolean().optional().describe("Preserve hyperlinks in the Markdown output."),
+  useMainContentOnly: z2.boolean().optional().default(true).describe("Strip navigation, ads, and boilerplate, keeping only the main article/content region.")
+});
+var contextScrape = (config = {}) => {
+  const client = createClient(config);
+  return tool2({
+    description: "Scrape a single URL and return clean Markdown with navigation and ads stripped, ready for LLM context.",
+    inputSchema: inputSchema2,
+    execute: async (input) => callContext(() => client.web.webScrapeMd(input))
+  });
+};
+
+// src/tools/crawl.ts
+import { tool as tool3 } from "ai";
+import { z as z3 } from "zod";
+var inputSchema3 = z3.object({
+  url: z3.string().url().describe("The starting URL for the crawl (must include http:// or https://)."),
+  maxPages: z3.number().int().min(1).max(500).optional().default(10).describe(
+    "Maximum number of pages to crawl. Defaults to 10 and is capped here well below the API's own ceiling \u2014 crawling is credit-metered per page, so an agent should not be able to trigger a large crawl without the caller raising this explicitly."
+  ),
+  maxDepth: z3.number().int().min(0).max(10).optional().describe("Maximum link depth from the starting URL (0 = only the starting page). No limit if omitted."),
+  urlRegex: z3.string().optional().describe("Only crawl URLs matching this regular expression."),
+  followSubdomains: z3.boolean().optional().describe("When true, also follow links on subdomains of the starting URL's domain.")
+});
+var contextCrawl = (config = {}) => {
+  const client = createClient(config);
+  return tool3({
+    description: "Crawl a website starting from a URL and return clean Markdown for every reachable page, up to the given limits.",
+    inputSchema: inputSchema3,
+    execute: async (input) => callContext(() => client.web.webCrawlMd(input))
+  });
+};
+
+// src/tools/sitemap.ts
+import { tool as tool4 } from "ai";
+import { z as z4 } from "zod";
+var inputSchema4 = z4.object({
+  domain: z4.string().describe("Domain to build/discover a sitemap for, e.g. 'example.com'."),
+  search: z4.string().optional().describe("Optional search phrase; the sitemap is filtered to pages whose URLs are about that phrase, most relevant first."),
+  urlRegex: z4.string().optional().describe("Only return URLs matching this regular expression."),
+  maxLinks: z4.number().int().min(1).max(1e5).optional().describe("Maximum number of links to return. Defaults to 10,000.")
+});
+var contextSitemap = (config = {}) => {
+  const client = createClient(config);
+  return tool4({
+    description: "Discover a website's URLs via its sitemap, optionally filtered by a search phrase or regex. Useful for planning a crawl before running contextCrawl.",
+    inputSchema: inputSchema4,
+    execute: async (input) => callContext(() => client.web.webScrapeSitemap(input))
+  });
+};
+
+// src/tools/extract.ts
+import { tool as tool5 } from "ai";
+import { z as z5 } from "zod";
+var inputSchema5 = z5.object({
+  url: z5.string().url().describe("The starting website URL to crawl and extract structured data from (must include http:// or https://)."),
+  schema: z5.record(z5.string(), z5.unknown()).describe(
+    "A JSON Schema object (not a Zod schema) describing the shape of data to extract, e.g. { type: 'object', properties: { price: { type: 'number' } } }."
+  ),
+  instructions: z5.string().optional().describe("Optional natural-language instructions to guide the extraction."),
+  factCheck: z5.boolean().optional().describe("When true, every returned value must be grounded in facts stated on the page; ungrounded fields come back null/empty.")
+});
+var contextExtract = (config = {}) => {
+  const client = createClient(config);
+  return tool5({
+    description: "Extract structured data from a URL according to a JSON Schema you provide.",
+    inputSchema: inputSchema5,
+    execute: async (input) => callContext(() => client.web.extract(input))
+  });
+};
+
+// src/tools/screenshot.ts
+import { tool as tool6 } from "ai";
+import { z as z6 } from "zod";
+var inputSchema6 = z6.object({
+  domain: z6.string().optional().describe("Domain to screenshot, e.g. 'example.com'. Provide exactly one of domain or directUrl."),
+  directUrl: z6.string().url().optional().describe("A specific URL to screenshot directly. Provide exactly one of domain or directUrl."),
+  fullScreenshot: z6.boolean().optional().describe("Capture the full scrollable page instead of just the viewport."),
+  colorScheme: z6.enum(["light", "dark"]).optional().describe("Force the site's light or dark visual theme before capture."),
+  clearPopups: z6.boolean().optional().describe("Dismiss detected cookie/consent banners and other obstructive overlays before capture.")
+}).refine((v) => v.domain ? !v.directUrl : !!v.directUrl, {
+  message: "Provide exactly one of `domain` or `directUrl`."
+});
+var contextScreenshot = (config = {}) => {
+  const client = createClient(config);
+  return tool6({
+    description: "Capture a screenshot of a webpage (full page or viewport) and return an image URL.",
+    inputSchema: inputSchema6,
+    execute: async ({ domain, directUrl, fullScreenshot, ...rest }) => callContext(
+      () => client.web.screenshot({
+        ...rest,
+        ...domain ? { domain } : { directUrl },
+        ...fullScreenshot !== void 0 && {
+          fullScreenshot: fullScreenshot ? "true" : "false"
+        }
+      })
+    )
+  });
+};
+
+// src/tools/brand.ts
+import { tool as tool7 } from "ai";
+import { z as z7 } from "zod";
+var inputSchema7 = z7.object({
+  domain: z7.string().describe("Domain to retrieve brand data for, e.g. 'stripe.com'."),
+  maxSpeed: z7.boolean().optional().describe("When true, skip time-consuming operations for a faster response at the cost of less comprehensive data.")
+});
+var contextBrand = (config = {}) => {
+  const client = createClient(config);
+  return tool7({
+    description: "Look up a company's brand profile by domain \u2014 logo, colors, description, social profiles, and industry classification. Only the domain lookup variant is exposed; the underlying API also supports lookup by name/email/ticker.",
+    inputSchema: inputSchema7,
+    execute: async ({ domain, maxSpeed }) => callContext(() => client.brand.retrieve({ domain, type: "by_domain", maxSpeed }))
+  });
+};
+
+// src/tools/news.ts
+import { tool as tool8 } from "ai";
+import { z as z8 } from "zod";
+var inputSchema8 = z8.object({
+  entity: z8.string().describe("The company to search news for \u2014 a name, domain, or stock ticker, matching `entityType`."),
+  entityType: z8.enum(["name", "domain", "ticker"]).optional().default("name").describe("How to interpret `entity`. Defaults to 'name'."),
+  limit: z8.number().int().min(1).max(50).optional().describe("Maximum articles to return. Defaults to 10."),
+  sortBy: z8.enum(["relevance", "newest"]).optional().describe("Result ordering. Defaults to 'newest'.")
+});
+var contextNews = (config = {}) => {
+  const client = createClient(config);
+  return tool8({
+    description: "Search recent news articles about a company, identified by name, domain, or stock ticker.",
+    inputSchema: inputSchema8,
+    execute: async ({ entity, entityType, limit, sortBy }) => callContext(
+      () => client.news.search({
+        searchBy: {
+          type: "entity",
+          entity: entityType === "domain" ? { type: "domain", domain: entity } : entityType === "ticker" ? { type: "ticker", ticker: entity } : { type: "name", name: entity }
+        },
+        limit,
+        sortBy: sortBy ? { type: sortBy } : void 0
+      })
+    )
+  });
+};
+
+// src/tools/parse.ts
+import { tool as tool9 } from "ai";
+import { toFile } from "context.dev";
+import { z as z9 } from "zod";
+var inputSchema9 = z9.object({
+  fileBase64: z9.string().describe("The document's raw bytes, base64-encoded."),
+  extension: z9.string().optional().describe("File extension hint, e.g. 'pdf', 'docx', 'xlsx', 'pptx', 'html', 'csv'. Helps the parser pick the right strategy."),
+  includeImages: z9.boolean().optional().describe("Include image references in the Markdown output."),
+  includeLinks: z9.boolean().optional().describe("Preserve hyperlinks in the Markdown output."),
+  ocr: z9.boolean().optional().describe("For PDFs, OCR pages that have no usable text layer (scans) instead of skipping them.")
+});
+var contextParse = (config = {}) => {
+  const client = createClient(config);
+  return tool9({
+    description: "Parse an uploaded document (PDF, DOCX, PPTX, XLSX, HTML, CSV, and more) into clean Markdown.",
+    inputSchema: inputSchema9,
+    execute: async ({ fileBase64, extension, ...rest }) => callContext(
+      async () => client.parse.handle(await toFile(Buffer.from(fileBase64, "base64")), {
+        ...rest,
+        extension
+      })
+    )
+  });
+};
+
+// src/index.ts
+function contextTools(config = {}) {
+  return {
+    contextSearch: contextSearch(config),
+    contextScrape: contextScrape(config),
+    contextCrawl: contextCrawl(config),
+    contextSitemap: contextSitemap(config),
+    contextExtract: contextExtract(config),
+    contextScreenshot: contextScreenshot(config),
+    contextBrand: contextBrand(config),
+    contextNews: contextNews(config),
+    contextParse: contextParse(config)
+  };
+}
+export {
+  contextBrand,
+  contextCrawl,
+  contextExtract,
+  contextNews,
+  contextParse,
+  contextScrape,
+  contextScreenshot,
+  contextSearch,
+  contextSitemap,
+  contextTools
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/search.ts","../src/client.ts","../src/tools/scrape.ts","../src/tools/crawl.ts","../src/tools/sitemap.ts","../src/tools/extract.ts","../src/tools/screenshot.ts","../src/tools/brand.ts","../src/tools/news.ts","../src/tools/parse.ts","../src/index.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport type { WebSearchParams } from \"context.dev/resources/web\";\nimport { z } from \"zod\";\nimport { createClient, callContext } from \"../client.js\";\nimport type { ContextToolConfig } from \"../types.js\";\n\nconst inputSchema = z.object({\n  query: z\n    .string()\n    .describe(\n      \"Search query. Accepts natural language as well as Google-style operators such as site:, -site:, inurl:, intitle:, quoted phrases, and OR.\",\n    ),\n  numResults: z.number().int().min(10).max(100).optional().describe(\"Number of results to request (10-100). Defaults to 10.\"),\n  freshness: z\n    .enum([\"last_24_hours\", \"last_week\", \"last_month\", \"last_year\"])\n    .optional()\n    .describe(\"Restrict results to content published within this window.\"),\n  includeDomains: z.array(z.string()).optional().describe('Allowlist domains, e.g. [\"arxiv.org\", \"github.com\"].'),\n  excludeDomains: z.array(z.string()).optional().describe('Blocklist domains, e.g. [\"pinterest.com\"].'),\n  country: z\n    .string()\n    .length(2)\n    .optional()\n    .describe(\"Two-letter ISO 3166-1 alpha-2 country code to localize results, e.g. 'us', 'gb', 'de'.\"),\n});\n\nexport const contextSearch = (config: ContextToolConfig = {}) => {\n  const client = createClient(config);\n  return tool({\n    description: \"Search the live web and get back structured results (title, url, snippet) using context.dev's real-time search index.\",\n    inputSchema,\n    execute: async ({ country, ...rest }) =>\n      callContext(() =>\n        client.web.search({ ...rest, country: country as WebSearchParams[\"country\"] }),\n      ),\n  });\n};\n","import { ContextDev, AuthenticationError, RateLimitError } from \"context.dev\";\nimport type { ContextToolConfig } from \"./types.js\";\n\nexport function createClient(config: ContextToolConfig = {}): ContextDev {\n  return new ContextDev({\n    apiKey: config.apiKey,\n    baseURL: config.baseURL,\n  });\n}\n\n/**\n * Runs a context.dev SDK call and rewraps the two error types an agent can\n * plausibly self-correct from mid-run with an actionable message. Every other\n * error is left to throw as-is: the AI SDK catches thrown errors from `execute`\n * automatically and surfaces them to the model as a tool-error step, so no\n * broad try/catch belongs here.\n */\nexport async function callContext<T>(fn: () => Promise<T>): Promise<T> {\n  try {\n    return await fn();\n  } catch (err) {\n    if (err instanceof RateLimitError) {\n      throw new Error(\n        \"context.dev rate limit reached. Wait before retrying, reduce request frequency, or upgrade your plan.\",\n      );\n    }\n    if (err instanceof AuthenticationError) {\n      throw new Error(\n        \"context.dev authentication failed. Check that CONTEXT_DEV_API_KEY is set to a valid key.\",\n      );\n    }\n    throw err;\n  }\n}\n","import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { createClient, callContext } from \"../client.js\";\nimport type { ContextToolConfig } from \"../types.js\";\n\nconst inputSchema = z.object({\n  url: z.string().url().describe(\"Full URL to scrape into LLM-usable Markdown (must include http:// or https://).\"),\n  includeImages: z.boolean().optional().describe(\"Include image references in the Markdown output.\"),\n  includeLinks: z.boolean().optional().describe(\"Preserve hyperlinks in the Markdown output.\"),\n  useMainContentOnly: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe(\"Strip navigation, ads, and boilerplate, keeping only the main article/content region.\"),\n});\n\nexport const contextScrape = (config: ContextToolConfig = {}) => {\n  const client = createClient(config);\n  return tool({\n    description: \"Scrape a single URL and return clean Markdown with navigation and ads stripped, ready for LLM context.\",\n    inputSchema,\n    execute: async (input) => callContext(() => client.web.webScrapeMd(input)),\n  });\n};\n","import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { createClient, callContext } from \"../client.js\";\nimport type { ContextToolConfig } from \"../types.js\";\n\nconst inputSchema = z.object({\n  url: z.string().url().describe(\"The starting URL for the crawl (must include http:// or https://).\"),\n  maxPages: z\n    .number()\n    .int()\n    .min(1)\n    .max(500)\n    .optional()\n    .default(10)\n    .describe(\n      \"Maximum number of pages to crawl. Defaults to 10 and is capped here well below the API's own ceiling — crawling is credit-metered per page, so an agent should not be able to trigger a large crawl without the caller raising this explicitly.\",\n    ),\n  maxDepth: z\n    .number()\n    .int()\n    .min(0)\n    .max(10)\n    .optional()\n    .describe(\"Maximum link depth from the starting URL (0 = only the starting page). No limit if omitted.\"),\n  urlRegex: z.string().optional().describe(\"Only crawl URLs matching this regular expression.\"),\n  followSubdomains: z\n    .boolean()\n    .optional()\n    .describe(\"When true, also follow links on subdomains of the starting URL's domain.\"),\n});\n\nexport const contextCrawl = (config: ContextToolConfig = {}) => {\n  const client = createClient(config);\n  return tool({\n    description: \"Crawl a website starting from a URL and return clean Markdown for every reachable page, up to the given limits.\",\n    inputSchema,\n    execute: async (input) => callContext(() => client.web.webCrawlMd(input)),\n  });\n};\n","import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { createClient, callContext } from \"../client.js\";\nimport type { ContextToolConfig } from \"../types.js\";\n\nconst inputSchema = z.object({\n  domain: z.string().describe(\"Domain to build/discover a sitemap for, e.g. 'example.com'.\"),\n  search: z\n    .string()\n    .optional()\n    .describe(\"Optional search phrase; the sitemap is filtered to pages whose URLs are about that phrase, most relevant first.\"),\n  urlRegex: z.string().optional().describe(\"Only return URLs matching this regular expression.\"),\n  maxLinks: z\n    .number()\n    .int()\n    .min(1)\n    .max(100_000)\n    .optional()\n    .describe(\"Maximum number of links to return. Defaults to 10,000.\"),\n});\n\nexport const contextSitemap = (config: ContextToolConfig = {}) => {\n  const client = createClient(config);\n  return tool({\n    description: \"Discover a website's URLs via its sitemap, optionally filtered by a search phrase or regex. Useful for planning a crawl before running contextCrawl.\",\n    inputSchema,\n    execute: async (input) => callContext(() => client.web.webScrapeSitemap(input)),\n  });\n};\n","import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { createClient, callContext } from \"../client.js\";\nimport type { ContextToolConfig } from \"../types.js\";\n\nconst inputSchema = z.object({\n  url: z.string().url().describe(\"The starting website URL to crawl and extract structured data from (must include http:// or https://).\"),\n  schema: z\n    .record(z.string(), z.unknown())\n    .describe(\n      \"A JSON Schema object (not a Zod schema) describing the shape of data to extract, e.g. { type: 'object', properties: { price: { type: 'number' } } }.\",\n    ),\n  instructions: z.string().optional().describe(\"Optional natural-language instructions to guide the extraction.\"),\n  factCheck: z\n    .boolean()\n    .optional()\n    .describe(\"When true, every returned value must be grounded in facts stated on the page; ungrounded fields come back null/empty.\"),\n});\n\nexport const contextExtract = (config: ContextToolConfig = {}) => {\n  const client = createClient(config);\n  return tool({\n    description: \"Extract structured data from a URL according to a JSON Schema you provide.\",\n    inputSchema,\n    execute: async (input) => callContext(() => client.web.extract(input)),\n  });\n};\n","import { tool } from \"ai\";\nimport type { WebScreenshotParams } from \"context.dev/resources/web\";\nimport { z } from \"zod\";\nimport { createClient, callContext } from \"../client.js\";\nimport type { ContextToolConfig } from \"../types.js\";\n\nconst inputSchema = z\n  .object({\n    domain: z.string().optional().describe(\"Domain to screenshot, e.g. 'example.com'. Provide exactly one of domain or directUrl.\"),\n    directUrl: z.string().url().optional().describe(\"A specific URL to screenshot directly. Provide exactly one of domain or directUrl.\"),\n    fullScreenshot: z.boolean().optional().describe(\"Capture the full scrollable page instead of just the viewport.\"),\n    colorScheme: z.enum([\"light\", \"dark\"]).optional().describe(\"Force the site's light or dark visual theme before capture.\"),\n    clearPopups: z.boolean().optional().describe(\"Dismiss detected cookie/consent banners and other obstructive overlays before capture.\"),\n  })\n  .refine((v) => (v.domain ? !v.directUrl : !!v.directUrl), {\n    message: \"Provide exactly one of `domain` or `directUrl`.\",\n  });\n\nexport const contextScreenshot = (config: ContextToolConfig = {}) => {\n  const client = createClient(config);\n  return tool({\n    description: \"Capture a screenshot of a webpage (full page or viewport) and return an image URL.\",\n    inputSchema,\n    execute: async ({ domain, directUrl, fullScreenshot, ...rest }) =>\n      callContext(() =>\n        client.web.screenshot({\n          ...rest,\n          ...(domain ? { domain } : { directUrl }),\n          ...(fullScreenshot !== undefined && {\n            fullScreenshot: (fullScreenshot ? \"true\" : \"false\") satisfies WebScreenshotParams[\"fullScreenshot\"],\n          }),\n        }),\n      ),\n  });\n};\n","import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { createClient, callContext } from \"../client.js\";\nimport type { ContextToolConfig } from \"../types.js\";\n\nconst inputSchema = z.object({\n  domain: z.string().describe(\"Domain to retrieve brand data for, e.g. 'stripe.com'.\"),\n  maxSpeed: z\n    .boolean()\n    .optional()\n    .describe(\"When true, skip time-consuming operations for a faster response at the cost of less comprehensive data.\"),\n});\n\nexport const contextBrand = (config: ContextToolConfig = {}) => {\n  const client = createClient(config);\n  return tool({\n    description:\n      \"Look up a company's brand profile by domain — logo, colors, description, social profiles, and industry classification. Only the domain lookup variant is exposed; the underlying API also supports lookup by name/email/ticker.\",\n    inputSchema,\n    execute: async ({ domain, maxSpeed }) =>\n      callContext(() => client.brand.retrieve({ domain, type: \"by_domain\", maxSpeed })),\n  });\n};\n","import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { createClient, callContext } from \"../client.js\";\nimport type { ContextToolConfig } from \"../types.js\";\n\nconst inputSchema = z.object({\n  entity: z.string().describe(\"The company to search news for — a name, domain, or stock ticker, matching `entityType`.\"),\n  entityType: z\n    .enum([\"name\", \"domain\", \"ticker\"])\n    .optional()\n    .default(\"name\")\n    .describe(\"How to interpret `entity`. Defaults to 'name'.\"),\n  limit: z.number().int().min(1).max(50).optional().describe(\"Maximum articles to return. Defaults to 10.\"),\n  sortBy: z.enum([\"relevance\", \"newest\"]).optional().describe(\"Result ordering. Defaults to 'newest'.\"),\n});\n\nexport const contextNews = (config: ContextToolConfig = {}) => {\n  const client = createClient(config);\n  return tool({\n    description: \"Search recent news articles about a company, identified by name, domain, or stock ticker.\",\n    inputSchema,\n    execute: async ({ entity, entityType, limit, sortBy }) =>\n      callContext(() =>\n        client.news.search({\n          searchBy: {\n            type: \"entity\",\n            entity:\n              entityType === \"domain\"\n                ? { type: \"domain\", domain: entity }\n                : entityType === \"ticker\"\n                  ? { type: \"ticker\", ticker: entity }\n                  : { type: \"name\", name: entity },\n          },\n          limit,\n          sortBy: sortBy ? { type: sortBy } : undefined,\n        }),\n      ),\n  });\n};\n","import { tool } from \"ai\";\nimport { toFile } from \"context.dev\";\nimport type { ParseHandleParams } from \"context.dev/resources/parse\";\nimport { z } from \"zod\";\nimport { createClient, callContext } from \"../client.js\";\nimport type { ContextToolConfig } from \"../types.js\";\n\nconst inputSchema = z.object({\n  fileBase64: z.string().describe(\"The document's raw bytes, base64-encoded.\"),\n  extension: z\n    .string()\n    .optional()\n    .describe(\"File extension hint, e.g. 'pdf', 'docx', 'xlsx', 'pptx', 'html', 'csv'. Helps the parser pick the right strategy.\"),\n  includeImages: z.boolean().optional().describe(\"Include image references in the Markdown output.\"),\n  includeLinks: z.boolean().optional().describe(\"Preserve hyperlinks in the Markdown output.\"),\n  ocr: z\n    .boolean()\n    .optional()\n    .describe(\"For PDFs, OCR pages that have no usable text layer (scans) instead of skipping them.\"),\n});\n\nexport const contextParse = (config: ContextToolConfig = {}) => {\n  const client = createClient(config);\n  return tool({\n    description: \"Parse an uploaded document (PDF, DOCX, PPTX, XLSX, HTML, CSV, and more) into clean Markdown.\",\n    inputSchema,\n    execute: async ({ fileBase64, extension, ...rest }) =>\n      callContext(async () =>\n        client.parse.handle(await toFile(Buffer.from(fileBase64, \"base64\")), {\n          ...rest,\n          extension: extension as ParseHandleParams[\"extension\"],\n        }),\n      ),\n  });\n};\n","import { contextSearch } from \"./tools/search.js\";\nimport { contextScrape } from \"./tools/scrape.js\";\nimport { contextCrawl } from \"./tools/crawl.js\";\nimport { contextSitemap } from \"./tools/sitemap.js\";\nimport { contextExtract } from \"./tools/extract.js\";\nimport { contextScreenshot } from \"./tools/screenshot.js\";\nimport { contextBrand } from \"./tools/brand.js\";\nimport { contextNews } from \"./tools/news.js\";\nimport { contextParse } from \"./tools/parse.js\";\nimport type { ContextToolConfig } from \"./types.js\";\n\nexport { contextSearch } from \"./tools/search.js\";\nexport { contextScrape } from \"./tools/scrape.js\";\nexport { contextCrawl } from \"./tools/crawl.js\";\nexport { contextSitemap } from \"./tools/sitemap.js\";\nexport { contextExtract } from \"./tools/extract.js\";\nexport { contextScreenshot } from \"./tools/screenshot.js\";\nexport { contextBrand } from \"./tools/brand.js\";\nexport { contextNews } from \"./tools/news.js\";\nexport { contextParse } from \"./tools/parse.js\";\nexport type { ContextToolConfig } from \"./types.js\";\n\n/**\n * Convenience bundle of every tool in this package, ready to spread into an\n * AI SDK `tools` object: `tools: { ...contextTools() }`.\n */\nexport function contextTools(config: ContextToolConfig = {}) {\n  return {\n    contextSearch: contextSearch(config),\n    contextScrape: contextScrape(config),\n    contextCrawl: contextCrawl(config),\n    contextSitemap: contextSitemap(config),\n    contextExtract: contextExtract(config),\n    contextScreenshot: contextScreenshot(config),\n    contextBrand: contextBrand(config),\n    contextNews: contextNews(config),\n    contextParse: contextParse(config),\n  };\n}\n"],"mappings":"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","names":["tool","z","inputSchema","z","tool","tool","z","inputSchema","z","tool","tool","z","inputSchema","z","tool","tool","z","inputSchema","z","tool","tool","z","inputSchema","z","tool","tool","z","inputSchema","z","tool","tool","z","inputSchema","z","tool","tool","z","inputSchema","z","tool"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "context-dev-ai-tools",
+  "version": "0.1.0",
+  "description": "Community-built Vercel AI SDK tools for the context.dev web data API (unofficial).",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "example:smoke": "tsx examples/smoke.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "vercel-ai-sdk",
+    "context.dev",
+    "web-scraping",
+    "agent-tools",
+    "llm-tools"
+  ],
+  "dependencies": {
+    "context.dev": "^2.14.0"
+  },
+  "peerDependencies": {
+    "ai": "^5.0.0 || ^6.0.0 || ^7.0.0",
+    "zod": "^3.25.76 || ^4.1.8"
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^4.0.46",
+    "@types/node": "^22.10.0",
+    "ai": "^7.0.85",
+    "dotenv": "^16.4.7",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.11",
+    "zod": "^4.5.4"
+  }
+}