@crawlcheck/sdk 1.9.2 → 1.10.0

package/README.md

@@ -35,16 +35,19 @@ Since 1.8.0 they also apply the signing policy (https://crawlcheck.io/keys#polic
 Three tools your agent can call itself: `crawlcheck_check_site` (the signed, verified decision for an action on a site, including the business facts the site publishes and which AI engines get them wrong), `crawlcheck_verify_fact` (one signed verdict on a phone number, address, hours or service area you hold: does the business publish it, did it once, or whose is it) and `crawlcheck_fetch` (fetches a page only after its domain, and every redirect hop, is allowed). All fail closed.
 
 ```js
-import { CrawlCheck, agentTools, toolsFor } from "@crawlcheck/sdk";
+import { CrawlCheck, agentTools, toolsFor, vercelTools, langchainTools } from "@crawlcheck/sdk";
 const tools = agentTools(new CrawlCheck(), { agent: "MyAgentBot" });
 
 // OpenAI function calling
 const oa = toolsFor("openai", tools);          // oa.tools → tools: [...]; on a tool call: await oa.call(name, argumentsJson)
 // Anthropic tool use
 const an = toolsFor("anthropic", tools);       // an.tools → tools: [...]; on tool_use: await an.call(block.name, block.input)
-// Vercel AI SDK
-import { tool, jsonSchema } from "ai";
-const vt = Object.fromEntries(tools.map((t) => [t.name, tool({ description: t.description, parameters: jsonSchema(t.parameters), execute: t.execute })]));
+// Vercel AI SDK (1.10.0): one call; the "ai" module is passed in, so this package keeps no dependency
+import * as ai from "ai";
+const vt = vercelTools(new CrawlCheck(), ai);  // generateText({ model, tools: vt, ... })
+// LangChain.js (1.10.0)
+import * as lc from "@langchain/core/tools";
+const lt = langchainTools(new CrawlCheck(), lc); // createAgent({ model, tools: lt }) or model.bindTools(lt)
 // An MCP server you run
 const mc = toolsFor("mcp", tools);             // list mc.tools; answer tools/call with mc.call(name, args)
 ```

package/dist/index.d.ts

@@ -762,4 +762,23 @@ export declare function toolsFor(format: ToolFormat, tools: AgentTool[]): {
     tools: unknown;
     call: (name: string, args: unknown) => Promise<JsonObject>;
 };
+/** Structural view of the Vercel AI SDK module ("ai") - passed in, so this package keeps no dependency. */
+export interface VercelAiModule {
+    tool: (def: any) => any;
+    jsonSchema: (schema: any) => any;
+}
+/** Vercel AI SDK adapter (1.10.0): `import * as ai from "ai"; const tools = vercelTools(cc, ai);` then generateText({ tools, ... }).
+ * Same three tools as agentTools(); they fail closed. The schema is given as both inputSchema (AI SDK 5+) and parameters (AI SDK 4). */
+export declare function vercelTools(cc: CrawlCheck, ai: VercelAiModule, opts?: AgentToolOptions): Record<string, unknown>;
+/** Structural view of "@langchain/core/tools" - passed in, so this package keeps no dependency. */
+export interface LangChainToolsModule {
+    tool: (fn: (input: any) => any, fields: {
+        name: string;
+        description: string;
+        schema: any;
+    }) => any;
+}
+/** LangChain.js adapter (1.10.0): `import * as lc from "@langchain/core/tools"; const tools = langchainTools(cc, lc);`
+ * Same three tools as agentTools(); each returns its result as a JSON string; they fail closed. */
+export declare function langchainTools(cc: CrawlCheck, lc: LangChainToolsModule, opts?: AgentToolOptions): unknown[];
 export default CrawlCheck;

package/dist/index.js

@@ -692,4 +692,18 @@ export function toolsFor(format, tools) {
         return { tools: tools.map((t) => ({ name: t.name, description: t.description, inputSchema: t.parameters, annotations: { readOnlyHint: true, openWorldHint: true } })), call };
     return { tools: Object.fromEntries(tools.map((t) => [t.name, { description: t.description, parameters: t.parameters, execute: t.execute }])), call };
 }
+/** Vercel AI SDK adapter (1.10.0): `import * as ai from "ai"; const tools = vercelTools(cc, ai);` then generateText({ tools, ... }).
+ * Same three tools as agentTools(); they fail closed. The schema is given as both inputSchema (AI SDK 5+) and parameters (AI SDK 4). */
+export function vercelTools(cc, ai, opts = {}) {
+    if (!ai || typeof ai.tool !== "function" || typeof ai.jsonSchema !== "function")
+        throw new Error('vercelTools needs the "ai" module: import * as ai from "ai"');
+    return Object.fromEntries(agentTools(cc, opts).map((t) => { const sc = ai.jsonSchema(t.parameters); return [t.name, ai.tool({ description: t.description, inputSchema: sc, parameters: sc, execute: (args) => t.execute(args) })]; }));
+}
+/** LangChain.js adapter (1.10.0): `import * as lc from "@langchain/core/tools"; const tools = langchainTools(cc, lc);`
+ * Same three tools as agentTools(); each returns its result as a JSON string; they fail closed. */
+export function langchainTools(cc, lc, opts = {}) {
+    if (!lc || typeof lc.tool !== "function")
+        throw new Error('langchainTools needs "@langchain/core/tools": import * as lc from "@langchain/core/tools"');
+    return agentTools(cc, opts).map((t) => lc.tool(async (input) => JSON.stringify(await t.execute(input ?? {})), { name: t.name, description: t.description, schema: t.parameters }));
+}
 export default CrawlCheck;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crawlcheck/sdk",
-  "version": "1.9.2",
+  "version": "1.10.0",
   "description": "Typed client for the CrawlCheck API (generated from its OpenAPI document) and the zero-dependency offline verifier for evidence bundles and remediation receipts.",
   "type": "module",
   "main": "./dist/index.js",