@agenttool/sdk 0.2.4 → 0.2.6

package/dist/index.d.ts

@@ -12,4 +12,4 @@
 export { AgentTool } from "./client.js";
 export { AgentToolError } from "./errors.js";
 export type { Trace, StoreTraceOptions, SearchTracesOptions, TraceSearchResult, TraceChain } from "./traces.js";
-export type { CreateEscrowOptions, CreateWalletOptions, Escrow, ExecuteResult, Memory, ScrapeResult, SearchMemoryOptions, SearchResponse, SearchResult, StoreOptions, UsageStats, VerifyResult, Wallet, WalletPolicy, } from "./types.js";
+export type { CreateEscrowOptions, CreateWalletOptions, DocumentResult, Escrow, ExecuteResult, ParseDocumentOptions, Memory, ScrapeResult, SearchMemoryOptions, SearchResponse, SearchResult, StoreOptions, UsageStats, VerifyResult, Wallet, WalletPolicy, } from "./types.js";

package/dist/tools.d.ts

@@ -1,7 +1,7 @@
 /**
  * Tools client for the agent-tools API.
  */
-import type { ExecuteResult, ScrapeResult, SearchResponse } from "./types.js";
+import type { DocumentResult, ExecuteResult, ParseDocumentOptions, ScrapeResult, SearchResponse } from "./types.js";
 import type { HttpConfig } from "./memory.js";
 /**
  * Client for the agent-tools API (search, scrape, execute).
@@ -45,5 +45,19 @@ export declare class ToolsClient {
     execute(code: string, options?: {
         language?: string;
     }): Promise<ExecuteResult>;
+    /**
+     * Parse a document and extract readable text.
+     * Supports HTML (via Readability) and plain text.
+     *
+     * @param options - Either `url` (fetched server-side) or `base64` encoded content.
+     * @returns DocumentResult with title, content, word_count, metadata.
+     *
+     * @example
+     * ```ts
+     * const doc = await at.tools.parseDocument({ url: "https://example.com/paper.html" });
+     * console.log(doc.title, doc.word_count);
+     * ```
+     */
+    parseDocument(options: ParseDocumentOptions): Promise<DocumentResult>;
     private post;
 }

package/dist/tools.js

@@ -67,6 +67,28 @@ export class ToolsClient {
         const data = await this.post("/v1/execute", body);
         return data;
     }
+    /**
+     * Parse a document and extract readable text.
+     * Supports HTML (via Readability) and plain text.
+     *
+     * @param options - Either `url` (fetched server-side) or `base64` encoded content.
+     * @returns DocumentResult with title, content, word_count, metadata.
+     *
+     * @example
+     * ```ts
+     * const doc = await at.tools.parseDocument({ url: "https://example.com/paper.html" });
+     * console.log(doc.title, doc.word_count);
+     * ```
+     */
+    async parseDocument(options) {
+        if (!options.url && !options.base64) {
+            throw new AgentToolError("parseDocument requires either url or base64.", {
+                hint: "Pass { url: '...' } or { base64: '...', content_type: 'text/html' }",
+            });
+        }
+        const data = await this.post("/v1/document/document", options);
+        return data;
+    }
     // --- internal ---
     async post(path, body) {
         const url = `${this.http.baseUrl}${path}`;

package/dist/types.d.ts

@@ -56,6 +56,21 @@ export interface ScrapeResult {
     status_code: number;
     [key: string]: unknown;
 }
+/** Result of document parsing. */
+export interface DocumentResult {
+    title: string;
+    content: string;
+    word_count: number;
+    content_type: string;
+    metadata: Record<string, unknown>;
+    duration_ms: number;
+}
+/** Options for document parsing. */
+export interface ParseDocumentOptions {
+    url?: string;
+    base64?: string;
+    content_type?: string;
+}
 /** Result of sandboxed code execution. */
 export interface ExecuteResult {
     stdout: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenttool/sdk",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "TypeScript SDK for agenttool.dev — memory and tools for AI agents",
   "type": "module",
   "main": "dist/index.js",