@quercle/ai-sdk 0.2.0 → 1.0.0

package/README.md

@@ -1,22 +1,18 @@
 # @quercle/ai-sdk
 
-Quercle web tools for the [Vercel AI SDK](https://sdk.vercel.ai/).
-
-Provides `quercleSearch` and `quercleFetch` tools that integrate seamlessly with AI applications built on the Vercel AI SDK.
+Quercle web search and fetch tools for the [Vercel AI SDK](https://sdk.vercel.ai/).
 
 ## Installation
 
 ```bash
 bun add @quercle/ai-sdk
-```
-
-```bash
+# or
 npm install @quercle/ai-sdk
 ```
 
 ## Setup
 
-Set your Quercle API key as an environment variable:
+Set your API key as an environment variable:
 
 ```bash
 export QUERCLE_API_KEY=qk_...
@@ -24,76 +20,154 @@ export QUERCLE_API_KEY=qk_...
 
 Get your API key at [quercle.dev](https://quercle.dev).
 
-## Usage
+## Tools
+
+| Tool | Description | Parameters |
+|---|---|---|
+| `quercleSearch` | Search the web and get AI-synthesized answers with citations | `query`, `allowedDomains?`, `blockedDomains?` |
+| `quercleFetch` | Fetch a URL and analyze its content with AI | `url`, `prompt` |
+| `quercleRawSearch` | Raw web search results without AI synthesis | `query`, `format?` (`markdown` \| `json`), `useSafeguard?` |
+| `quercleRawFetch` | Fetch raw page content without AI processing | `url`, `format?` (`markdown` \| `html`), `useSafeguard?` |
+| `quercleExtract` | Extract content relevant to a query from a URL | `url`, `query`, `format?` (`markdown` \| `json`), `useSafeguard?` |
 
-### With generateText
+## Quick Start
 
-```typescript
-import { quercleSearch, quercleFetch } from "@quercle/ai-sdk";
+```ts
+import { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract } from "@quercle/ai-sdk";
 import { generateText } from "ai";
 import { openai } from "@ai-sdk/openai";
 
-const result = await generateText({
+const { text } = await generateText({
   model: openai("gpt-4o"),
-  tools: { quercleSearch, quercleFetch },
-  prompt: "Search for the latest news about AI and summarize",
+  tools: { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract },
+  maxSteps: 5,
+  prompt: "Search for the latest news about AI agents and summarize what you find",
 });
-```
-
-### With streamText
 
-```typescript
-import { quercleSearch, quercleFetch } from "@quercle/ai-sdk";
-import { streamText } from "ai";
-import { openai } from "@ai-sdk/openai";
-
-const stream = streamText({
-  model: openai("gpt-4o"),
-  tools: { quercleSearch, quercleFetch },
-  prompt: "Find information about TypeScript 5",
-});
+console.log(text);
+```
 
-for await (const chunk of stream.textStream) {
-  console.log(chunk);
-}
+## Direct Tool Usage
+
+Use the tools directly without an LLM:
+
+```ts
+import { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract } from "@quercle/ai-sdk";
+
+// Search with AI-synthesized answer
+const searchResult = await quercleSearch.execute(
+  { query: "best practices for building AI agents" },
+  { toolCallId: "1", messages: [] },
+);
+console.log(searchResult);
+
+// Search with domain filtering
+const filtered = await quercleSearch.execute(
+  {
+    query: "TypeScript documentation",
+    allowedDomains: ["typescriptlang.org"],
+  },
+  { toolCallId: "2", messages: [] },
+);
+
+// Fetch and analyze a page
+const fetchResult = await quercleFetch.execute(
+  {
+    url: "https://en.wikipedia.org/wiki/TypeScript",
+    prompt: "Summarize the key features of TypeScript",
+  },
+  { toolCallId: "3", messages: [] },
+);
+console.log(fetchResult);
+
+// Raw search results (markdown or JSON)
+const rawResults = await quercleRawSearch.execute(
+  { query: "TypeScript 5 features", format: "json" },
+  { toolCallId: "4", messages: [] },
+);
+console.log(rawResults);
+
+// Raw page content
+const rawPage = await quercleRawFetch.execute(
+  { url: "https://en.wikipedia.org/wiki/TypeScript", format: "markdown" },
+  { toolCallId: "5", messages: [] },
+);
+console.log(rawPage);
+
+// Extract relevant content from a page
+const extracted = await quercleExtract.execute(
+  {
+    url: "https://en.wikipedia.org/wiki/TypeScript",
+    query: "type system features",
+    format: "markdown",
+  },
+  { toolCallId: "6", messages: [] },
+);
+console.log(extracted);
 ```
 
-### With Custom API Key
+### Custom API Key
 
-```typescript
+```ts
 import { createQuercleTools } from "@quercle/ai-sdk";
-import { generateText } from "ai";
-import { openai } from "@ai-sdk/openai";
 
-const { quercleSearch, quercleFetch } = createQuercleTools({
+const { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract } = createQuercleTools({
   apiKey: "qk_...",
 });
+```
 
-const result = await generateText({
-  model: openai("gpt-4o"),
-  tools: { quercleSearch, quercleFetch },
-  prompt: "Search for TypeScript best practices",
+## Agentic Usage
+
+### Multi-Step with generateText
+
+```ts
+import { quercleSearch, quercleFetch, quercleExtract } from "@quercle/ai-sdk";
+import { generateText } from "ai";
+import { anthropic } from "@ai-sdk/anthropic";
+
+const { text, steps } = await generateText({
+  model: anthropic("claude-sonnet-4-20250514"),
+  tools: { quercleSearch, quercleFetch, quercleExtract },
+  maxSteps: 10,
+  prompt: "Research the latest developments in WebAssembly and write a summary",
+  onStepFinish({ text, toolCalls, finishReason }) {
+    console.log("Step finished:", finishReason, toolCalls.length, "tool calls");
+  },
 });
-```
 
-## Tools
+console.log(text);
+console.log(`Completed in ${steps.length} steps`);
+```
 
-### quercleSearch
+### Streaming with streamText
 
-Search the web and get AI-synthesized answers with citations.
+```ts
+import { quercleSearch, quercleFetch } from "@quercle/ai-sdk";
+import { streamText } from "ai";
+import { openai } from "@ai-sdk/openai";
 
-**Parameters:**
-- `query` (string, required): The search query
-- `allowedDomains` (string[], optional): Only include results from these domains
-- `blockedDomains` (string[], optional): Exclude results from these domains
+const result = streamText({
+  model: openai("gpt-4o"),
+  tools: { quercleSearch, quercleFetch },
+  maxSteps: 5,
+  prompt: "Find and summarize the top 3 trending AI papers this week",
+});
 
-### quercleFetch
+for await (const chunk of result.textStream) {
+  process.stdout.write(chunk);
+}
+```
 
-Fetch a URL and analyze its content with AI.
+## API Reference
 
-**Parameters:**
-- `url` (string, required): The URL to fetch
-- `prompt` (string, required): Instructions for how to analyze the content
+| Export | Description |
+|---|---|
+| `quercleSearch` | AI SDK tool for web search with AI-synthesized answers (uses `QUERCLE_API_KEY` env var) |
+| `quercleFetch` | AI SDK tool for URL fetch + AI analysis (uses `QUERCLE_API_KEY` env var) |
+| `quercleRawSearch` | AI SDK tool for raw web search results (uses `QUERCLE_API_KEY` env var) |
+| `quercleRawFetch` | AI SDK tool for raw page content fetching (uses `QUERCLE_API_KEY` env var) |
+| `quercleExtract` | AI SDK tool for extracting relevant content from a URL (uses `QUERCLE_API_KEY` env var) |
+| `createQuercleTools(options?)` | Factory that returns all 5 tools with a custom API key or config |
 
 ## License
 

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { quercleSearch, quercleFetch, createQuercleTools } from "./tools.js";
-export type { QuercleConfig, SearchOptions, SearchResponse, FetchResponse, } from "@quercle/sdk";
+export { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract, createQuercleTools, } from "./tools.js";
+export type { QuercleClientOptions, SearchOptions, SearchResponse, FetchResponse, RawSearchOptions, RawSearchResponse, RawFetchOptions, RawFetchResponse, ExtractOptions, ExtractResponse, } from "@quercle/sdk";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG7E,YAAY,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { quercleSearch, quercleFetch, createQuercleTools } from "./tools.js";
+export { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract, createQuercleTools, } from "./tools.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/tools.d.ts

@@ -1,4 +1,4 @@
-import { type QuercleConfig } from "@quercle/sdk";
+import { type QuercleClientOptions } from "@quercle/sdk";
 /**
  * Search the web using Quercle and get AI-synthesized answers with citations.
  *
@@ -44,6 +44,76 @@ export declare const quercleFetch: import("ai").Tool<{
     url: string;
     prompt: string;
 }, string>;
+/**
+ * Run a web search using Quercle and return raw results.
+ *
+ * Uses the QUERCLE_API_KEY environment variable for authentication.
+ *
+ * @example
+ * ```typescript
+ * import { quercleRawSearch } from "@quercle/ai-sdk";
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const result = await generateText({
+ *   model: openai("gpt-4"),
+ *   tools: { quercleRawSearch },
+ *   prompt: "Search for the latest news about AI",
+ * });
+ * ```
+ */
+export declare const quercleRawSearch: import("ai").Tool<{
+    query: string;
+    format?: "markdown" | "json" | undefined;
+    useSafeguard?: boolean | undefined;
+}, string>;
+/**
+ * Fetch a URL using Quercle and return raw markdown or HTML.
+ *
+ * Uses the QUERCLE_API_KEY environment variable for authentication.
+ *
+ * @example
+ * ```typescript
+ * import { quercleRawFetch } from "@quercle/ai-sdk";
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const result = await generateText({
+ *   model: openai("gpt-4"),
+ *   tools: { quercleRawFetch },
+ *   prompt: "Fetch https://example.com and return its content",
+ * });
+ * ```
+ */
+export declare const quercleRawFetch: import("ai").Tool<{
+    url: string;
+    format?: "markdown" | "html" | undefined;
+    useSafeguard?: boolean | undefined;
+}, string>;
+/**
+ * Fetch a URL using Quercle and return chunks relevant to a query.
+ *
+ * Uses the QUERCLE_API_KEY environment variable for authentication.
+ *
+ * @example
+ * ```typescript
+ * import { quercleExtract } from "@quercle/ai-sdk";
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const result = await generateText({
+ *   model: openai("gpt-4"),
+ *   tools: { quercleExtract },
+ *   prompt: "Extract pricing info from https://example.com",
+ * });
+ * ```
+ */
+export declare const quercleExtract: import("ai").Tool<{
+    query: string;
+    url: string;
+    format?: "markdown" | "json" | undefined;
+    useSafeguard?: boolean | undefined;
+}, string>;
 /**
  * Create Quercle tools with custom configuration.
  *
@@ -56,18 +126,18 @@ export declare const quercleFetch: import("ai").Tool<{
  * import { generateText } from "ai";
  * import { openai } from "@ai-sdk/openai";
  *
- * const { quercleSearch, quercleFetch } = createQuercleTools({
+ * const { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract } = createQuercleTools({
  *   apiKey: "qk_...",
  * });
  *
  * const result = await generateText({
  *   model: openai("gpt-4"),
- *   tools: { quercleSearch, quercleFetch },
+ *   tools: { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract },
  *   prompt: "Search for TypeScript best practices",
  * });
  * ```
  */
-export declare function createQuercleTools(config?: QuercleConfig): {
+export declare function createQuercleTools(config?: QuercleClientOptions): {
     quercleSearch: import("ai").Tool<{
         query: string;
         allowedDomains?: string[] | undefined;
@@ -77,5 +147,21 @@ export declare function createQuercleTools(config?: QuercleConfig): {
         url: string;
         prompt: string;
     }, string>;
+    quercleRawSearch: import("ai").Tool<{
+        query: string;
+        format?: "markdown" | "json" | undefined;
+        useSafeguard?: boolean | undefined;
+    }, string>;
+    quercleRawFetch: import("ai").Tool<{
+        url: string;
+        format?: "markdown" | "html" | undefined;
+        useSafeguard?: boolean | undefined;
+    }, string>;
+    quercleExtract: import("ai").Tool<{
+        query: string;
+        url: string;
+        format?: "markdown" | "json" | undefined;
+        useSafeguard?: boolean | undefined;
+    }, string>;
 };
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,aAAa,EAGnB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa;;;;UAOxB,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY;;;UAOvB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,aAAa;;;;;;;;;;EAmBxD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AA4DtB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa;;;;UAMxB,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY;;;UAMvB,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB;;;;UAO3B,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,eAAe;;;;UAO1B,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc;;;;;UAOzB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;EA2C/D"}

package/dist/tools.js

@@ -1,5 +1,50 @@
 import { tool } from "ai";
-import { QuercleClient, TOOL_DESCRIPTIONS, searchToolSchema, fetchToolSchema, } from "@quercle/sdk";
+import { QuercleClient, toolMetadata, } from "@quercle/sdk";
+import { z } from "zod";
+const searchToolSchema = z.object({
+    query: z.string().describe(toolMetadata.search.parameters.query),
+    allowedDomains: z.array(z.string()).optional().describe(toolMetadata.search.parameters.allowed_domains),
+    blockedDomains: z.array(z.string()).optional().describe(toolMetadata.search.parameters.blocked_domains),
+});
+const fetchToolSchema = z.object({
+    url: z.string().describe(toolMetadata.fetch.parameters.url),
+    prompt: z.string().describe(toolMetadata.fetch.parameters.prompt),
+});
+const rawSearchToolSchema = z.object({
+    query: z.string().describe(toolMetadata.rawSearch.parameters.query),
+    format: z.enum(["markdown", "json"]).optional().describe(toolMetadata.rawSearch.parameters.format),
+    useSafeguard: z.boolean().optional().describe(toolMetadata.rawSearch.parameters.use_safeguard),
+});
+const rawFetchToolSchema = z.object({
+    url: z.string().describe(toolMetadata.rawFetch.parameters.url),
+    format: z.enum(["markdown", "html"]).optional().describe(toolMetadata.rawFetch.parameters.format),
+    useSafeguard: z.boolean().optional().describe(toolMetadata.rawFetch.parameters.use_safeguard),
+});
+const extractToolSchema = z.object({
+    url: z.string().describe(toolMetadata.extract.parameters.url),
+    query: z.string().describe(toolMetadata.extract.parameters.query),
+    format: z.enum(["markdown", "json"]).optional().describe(toolMetadata.extract.parameters.format),
+    useSafeguard: z.boolean().optional().describe(toolMetadata.extract.parameters.use_safeguard),
+});
+/**
+ * Format a raw/extract response result as a string.
+ *
+ * If the result is already a string it is returned directly.
+ * If it is an array it is JSON-stringified.
+ * When the response is flagged as unsafe, the string is prefixed with "[UNSAFE] ".
+ */
+function formatRawResult(result, unsafe) {
+    const text = typeof result === "string" ? result : JSON.stringify(result);
+    return unsafe ? `[UNSAFE] ${text}` : text;
+}
+/** Shared default client instance, lazily initialized on first use. */
+let _defaultClient;
+function getDefaultClient() {
+    if (!_defaultClient) {
+        _defaultClient = new QuercleClient();
+    }
+    return _defaultClient;
+}
 /**
  * Search the web using Quercle and get AI-synthesized answers with citations.
  *
@@ -19,11 +64,10 @@ import { QuercleClient, TOOL_DESCRIPTIONS, searchToolSchema, fetchToolSchema, }
  * ```
  */
 export const quercleSearch = tool({
-    description: TOOL_DESCRIPTIONS.SEARCH,
+    description: toolMetadata.search.description,
     inputSchema: searchToolSchema,
     execute: async ({ query, allowedDomains, blockedDomains }) => {
-        const client = new QuercleClient();
-        return await client.search(query, { allowedDomains, blockedDomains });
+        return (await getDefaultClient().search(query, { allowedDomains, blockedDomains })).result;
     },
 });
 /**
@@ -45,11 +89,88 @@ export const quercleSearch = tool({
  * ```
  */
 export const quercleFetch = tool({
-    description: TOOL_DESCRIPTIONS.FETCH,
+    description: toolMetadata.fetch.description,
     inputSchema: fetchToolSchema,
     execute: async ({ url, prompt }) => {
-        const client = new QuercleClient();
-        return await client.fetch(url, prompt);
+        return (await getDefaultClient().fetch(url, prompt)).result;
+    },
+});
+/**
+ * Run a web search using Quercle and return raw results.
+ *
+ * Uses the QUERCLE_API_KEY environment variable for authentication.
+ *
+ * @example
+ * ```typescript
+ * import { quercleRawSearch } from "@quercle/ai-sdk";
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const result = await generateText({
+ *   model: openai("gpt-4"),
+ *   tools: { quercleRawSearch },
+ *   prompt: "Search for the latest news about AI",
+ * });
+ * ```
+ */
+export const quercleRawSearch = tool({
+    description: toolMetadata.rawSearch.description,
+    inputSchema: rawSearchToolSchema,
+    execute: async ({ query, format, useSafeguard }) => {
+        const response = await getDefaultClient().rawSearch(query, { format, useSafeguard });
+        return formatRawResult(response.result, response.unsafe);
+    },
+});
+/**
+ * Fetch a URL using Quercle and return raw markdown or HTML.
+ *
+ * Uses the QUERCLE_API_KEY environment variable for authentication.
+ *
+ * @example
+ * ```typescript
+ * import { quercleRawFetch } from "@quercle/ai-sdk";
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const result = await generateText({
+ *   model: openai("gpt-4"),
+ *   tools: { quercleRawFetch },
+ *   prompt: "Fetch https://example.com and return its content",
+ * });
+ * ```
+ */
+export const quercleRawFetch = tool({
+    description: toolMetadata.rawFetch.description,
+    inputSchema: rawFetchToolSchema,
+    execute: async ({ url, format, useSafeguard }) => {
+        const response = await getDefaultClient().rawFetch(url, { format, useSafeguard });
+        return formatRawResult(response.result, response.unsafe);
+    },
+});
+/**
+ * Fetch a URL using Quercle and return chunks relevant to a query.
+ *
+ * Uses the QUERCLE_API_KEY environment variable for authentication.
+ *
+ * @example
+ * ```typescript
+ * import { quercleExtract } from "@quercle/ai-sdk";
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const result = await generateText({
+ *   model: openai("gpt-4"),
+ *   tools: { quercleExtract },
+ *   prompt: "Extract pricing info from https://example.com",
+ * });
+ * ```
+ */
+export const quercleExtract = tool({
+    description: toolMetadata.extract.description,
+    inputSchema: extractToolSchema,
+    execute: async ({ url, query, format, useSafeguard }) => {
+        const response = await getDefaultClient().extract(url, query, { format, useSafeguard });
+        return formatRawResult(response.result, response.unsafe);
     },
 });
 /**
@@ -64,13 +185,13 @@ export const quercleFetch = tool({
  * import { generateText } from "ai";
  * import { openai } from "@ai-sdk/openai";
  *
- * const { quercleSearch, quercleFetch } = createQuercleTools({
+ * const { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract } = createQuercleTools({
  *   apiKey: "qk_...",
  * });
  *
  * const result = await generateText({
  *   model: openai("gpt-4"),
- *   tools: { quercleSearch, quercleFetch },
+ *   tools: { quercleSearch, quercleFetch, quercleRawSearch, quercleRawFetch, quercleExtract },
  *   prompt: "Search for TypeScript best practices",
  * });
  * ```
@@ -79,17 +200,41 @@ export function createQuercleTools(config) {
     const client = new QuercleClient(config);
     return {
         quercleSearch: tool({
-            description: TOOL_DESCRIPTIONS.SEARCH,
+            description: toolMetadata.search.description,
             inputSchema: searchToolSchema,
             execute: async ({ query, allowedDomains, blockedDomains }) => {
-                return await client.search(query, { allowedDomains, blockedDomains });
+                return (await client.search(query, { allowedDomains, blockedDomains })).result;
             },
         }),
         quercleFetch: tool({
-            description: TOOL_DESCRIPTIONS.FETCH,
+            description: toolMetadata.fetch.description,
             inputSchema: fetchToolSchema,
             execute: async ({ url, prompt }) => {
-                return await client.fetch(url, prompt);
+                return (await client.fetch(url, prompt)).result;
+            },
+        }),
+        quercleRawSearch: tool({
+            description: toolMetadata.rawSearch.description,
+            inputSchema: rawSearchToolSchema,
+            execute: async ({ query, format, useSafeguard }) => {
+                const response = await client.rawSearch(query, { format, useSafeguard });
+                return formatRawResult(response.result, response.unsafe);
+            },
+        }),
+        quercleRawFetch: tool({
+            description: toolMetadata.rawFetch.description,
+            inputSchema: rawFetchToolSchema,
+            execute: async ({ url, format, useSafeguard }) => {
+                const response = await client.rawFetch(url, { format, useSafeguard });
+                return formatRawResult(response.result, response.unsafe);
+            },
+        }),
+        quercleExtract: tool({
+            description: toolMetadata.extract.description,
+            inputSchema: extractToolSchema,
+            execute: async ({ url, query, format, useSafeguard }) => {
+                const response = await client.extract(url, query, { format, useSafeguard });
+                return formatRawResult(response.result, response.unsafe);
             },
         }),
     };

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAIhB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAA0B;IACzD,WAAW,EAAE,iBAAiB,CAAC,MAAM;IACrC,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,EAAE,EAAE;QAC3D,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC;IACxE,CAAC;CACF,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAyB;IACvD,WAAW,EAAE,iBAAiB,CAAC,KAAK;IACpC,WAAW,EAAE,eAAe;IAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAEzC,OAAO;QACL,aAAa,EAAE,IAAI,CAA0B;YAC3C,WAAW,EAAE,iBAAiB,CAAC,MAAM;YACrC,WAAW,EAAE,gBAAgB;YAC7B,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,EAAE,EAAE;gBAC3D,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC;YACxE,CAAC;SACF,CAAC;QACF,YAAY,EAAE,IAAI,CAAyB;YACzC,WAAW,EAAE,iBAAiB,CAAC,KAAK;YACpC,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;gBACjC,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACzC,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quercle/ai-sdk",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "description": "Quercle web tools for Vercel AI SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -19,17 +19,17 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@quercle/sdk": "^0.2.4",
-    "ai": "^5.0.0",
-    "zod": "^3.24.0"
+    "@quercle/sdk": "^1.0.0",
+    "ai": "^5.0.124",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "@types/bun": "^1.3.3",
-    "@types/node": "^22.0.0",
-    "eslint": "^9.39.1",
-    "typescript": "^5.7.0",
-    "typescript-eslint": "^8.48.1"
+    "@eslint/js": "^9.39.2",
+    "@types/bun": "^1.3.8",
+    "@types/node": "^22.19.7",
+    "eslint": "^9.39.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0"
   },
   "peerDependencies": {
     "ai": ">=5.0.0"
@@ -40,6 +40,9 @@
   "files": [
     "dist"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "keywords": [
     "quercle",
     "ai",