@strands-agents/sdk 1.17.0 → 1.19.0

package/dist/src/vended-tools/web-fetch/types.js

@@ -0,0 +1,8 @@
+export const WEB_FETCH_DESCRIPTION_MARKDOWN = 'Fetches an HTTP(S) URL and returns its content as clean markdown. ' +
+    'HTML pages are converted to markdown with scripts, styles, and noise stripped; ' +
+    'other content types are returned as-is.';
+export const WEB_FETCH_DESCRIPTION_AGENTIC = 'Fetches an HTTP(S) URL and answers a prompt about its content. ' +
+    'The analyst processes the page directly so the full content never enters ' +
+    "the main agent's context. " +
+    'The prompt parameter is required.';
+//# sourceMappingURL=types.js.map

package/dist/src/vended-tools/web-fetch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/types.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,8BAA8B,GACzC,oEAAoE;IACpE,iFAAiF;IACjF,yCAAyC,CAAA;AAE3C,MAAM,CAAC,MAAM,6BAA6B,GACxC,iEAAiE;IACjE,2EAA2E;IAC3E,4BAA4B;IAC5B,mCAAmC,CAAA"}

package/dist/src/vended-tools/web-fetch/web-fetch.d.ts

@@ -0,0 +1,14 @@
+import { tool } from '../../tools/tool-factory.js';
+import { type MakeWebFetchOptions } from './types.js';
+export declare const DEFAULT_MAX_BYTES: number;
+export declare const DEFAULT_MAX_CONTENT_CHARS = 50000;
+/**
+ * Create a web fetch tool. The exported {@link webFetch} is a default instance
+ * with conservative limits; use this factory to tune them.
+ */
+export declare function makeWebFetch(options?: MakeWebFetchOptions): ReturnType<typeof tool>;
+/**
+ * Default web fetch tool (agentic mode). See {@link makeWebFetch} to tune limits or switch modes.
+ */
+export declare const webFetch: import("../../index.js").InvokableTool<unknown, import("../../index.js").JSONValue>;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/src/vended-tools/web-fetch/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/web-fetch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAElD,OAAO,EAAE,KAAK,mBAAmB,EAAiE,MAAM,YAAY,CAAA;AAEpH,eAAO,MAAM,iBAAiB,QAAkB,CAAA;AAChD,eAAO,MAAM,yBAAyB,QAAS,CAAA;AA4B/C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAiFvF;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,qFAAiB,CAAA"}

package/dist/src/vended-tools/web-fetch/web-fetch.js

@@ -0,0 +1,175 @@
+import { z } from 'zod';
+import { Agent } from '../../agent/agent.js';
+import { tool } from '../../tools/tool-factory.js';
+import { htmlToMarkdown } from './extract.js';
+import { WEB_FETCH_DESCRIPTION_MARKDOWN, WEB_FETCH_DESCRIPTION_AGENTIC } from './types.js';
+export const DEFAULT_MAX_BYTES = 5 * 1024 * 1024; // 5 MiB
+export const DEFAULT_MAX_CONTENT_CHARS = 50_000;
+const _HEADERS = {
+    'User-Agent': 'strands-agents-web-fetch/1.0',
+    Accept: 'text/html,application/xhtml+xml;q=0.9,*/*;q=0.8',
+};
+const _ANALYST_PROMPT = 'You answer a request about a single fetched web page. Use only the provided ' +
+    'content; if it does not contain the answer, say so plainly. Be concise and ' +
+    'factual, and preserve concrete details (names, numbers, quotes, links) ' +
+    'relevant to the request.';
+/**
+ * Zod schema for markdown mode web fetch input validation.
+ */
+const webFetchMarkdownInputSchema = z.object({
+    url: z.string().describe('URL to fetch. Must be http:// or https://.'),
+});
+/**
+ * Zod schema for agentic mode web fetch input validation.
+ */
+const webFetchAgenticInputSchema = z.object({
+    url: z.string().describe('URL to fetch. Must be http:// or https://.'),
+    prompt: z.string().describe('Question or instruction about the page content.'),
+});
+/**
+ * Create a web fetch tool. The exported {@link webFetch} is a default instance
+ * with conservative limits; use this factory to tune them.
+ */
+export function makeWebFetch(options = {}) {
+    const { mode = 'agentic', model: analystModel } = options;
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    const maxContentChars = options.maxContentChars ?? DEFAULT_MAX_CONTENT_CHARS;
+    if (maxBytes <= 0) {
+        throw new Error(`maxBytes must be a positive number, got ${maxBytes}`);
+    }
+    if (maxContentChars <= 0) {
+        throw new Error(`maxContentChars must be a positive number, got ${maxContentChars}`);
+    }
+    const name = options.name ?? 'web_fetch';
+    const description = options.description ?? (mode === 'markdown' ? WEB_FETCH_DESCRIPTION_MARKDOWN : WEB_FETCH_DESCRIPTION_AGENTIC);
+    const markdownTool = tool({
+        name,
+        description,
+        inputSchema: webFetchMarkdownInputSchema,
+        callback: async (input, context) => {
+            const { url } = input;
+            const signal = context?.cancelSignal ?? null;
+            const [contentType, raw] = await fetchOnce(url, maxBytes, signal);
+            const isMarkup = contentType.toLowerCase().includes('html') || contentType.toLowerCase().includes('xml');
+            let content = isMarkup ? await htmlToMarkdown(raw) : raw;
+            if (content.length > maxContentChars) {
+                content = content.slice(0, maxContentChars) + '\n\n[content truncated]';
+            }
+            return content;
+        },
+    });
+    const agenticTool = tool({
+        name,
+        description,
+        inputSchema: webFetchAgenticInputSchema,
+        callback: async (input, context) => {
+            const { url, prompt } = input;
+            if (!prompt.trim()) {
+                throw new Error('web_fetch: agentic mode requires a non-empty prompt.');
+            }
+            const effectiveModel = analystModel ?? context?.agent.model;
+            if (!effectiveModel) {
+                throw new Error('web_fetch: agentic mode requires a model. ' + 'Pass model to makeWebFetch or call the tool from an agent.');
+            }
+            const signal = context?.cancelSignal ?? null;
+            const invokeOptions = context?.cancelSignal ? { cancelSignal: context.cancelSignal } : {};
+            const [contentType, raw] = await fetchOnce(url, maxBytes, signal);
+            const isMarkup = contentType.toLowerCase().includes('html') || contentType.toLowerCase().includes('xml');
+            let content = isMarkup ? await htmlToMarkdown(raw) : raw;
+            if (content.length > maxContentChars) {
+                content = content.slice(0, maxContentChars) + '\n\n[content truncated]';
+            }
+            // Fresh agent per call — no history from one fetch bleeds into the next.
+            const analyst = new Agent({ model: effectiveModel, systemPrompt: _ANALYST_PROMPT, printer: false });
+            const invokePrompt = `URL: ${url}\n\nRequest: ${prompt}\n\n--- Content ---\n${content}`;
+            try {
+                const result = await analyst.invoke(invokePrompt, invokeOptions);
+                return result.lastMessage.content
+                    .filter((block) => block.type === 'textBlock')
+                    .map((block) => block.text)
+                    .join('');
+            }
+            catch (error) {
+                throw new Error(`url=<${url}> | web fetch analyst failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+            }
+        },
+    });
+    return mode === 'markdown' ? markdownTool : agenticTool;
+}
+/**
+ * Default web fetch tool (agentic mode). See {@link makeWebFetch} to tune limits or switch modes.
+ */
+export const webFetch = makeWebFetch();
+// ---- Internals ----
+async function fetchOnce(url, maxBytes, signal) {
+    // Validate scheme before hitting the network
+    if (!URL.canParse(url)) {
+        throw new Error(`url=<${url}> | fetch failed: invalid URL`);
+    }
+    const { protocol } = new URL(url);
+    if (protocol !== 'http:' && protocol !== 'https:') {
+        throw new Error(`url=<${url}> | fetch failed: only http and https URLs are supported`);
+    }
+    let response;
+    try {
+        response = await globalThis.fetch(url, { method: 'GET', headers: _HEADERS, signal });
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error('Web fetch tool request cancelled', { cause: error });
+        }
+        throw new Error(`url=<${url}> | fetch failed: ${error instanceof Error ? error.message : String(error)}`, {
+            cause: error,
+        });
+    }
+    if (!response.ok) {
+        await response.body?.cancel();
+        throw new Error(`HTTP ${response.status} ${response.statusText}: GET ${url}`);
+    }
+    // Stream the body and enforce the size cap on decompressed bytes as they arrive.
+    if (!response.body) {
+        return [response.headers.get('content-type') ?? '', ''];
+    }
+    const contentType = response.headers.get('content-type') ?? '';
+    const charset = _parseCharset(contentType);
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder(charset);
+    const chunks = [];
+    let total = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            total += value.byteLength;
+            if (total > maxBytes) {
+                throw new Error(`Response body exceeded max_bytes=${maxBytes}. Refusing to buffer more.`);
+            }
+            chunks.push(decoder.decode(value, { stream: true }));
+        }
+        chunks.push(decoder.decode());
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error('Web fetch tool request cancelled', { cause: error });
+        }
+        throw error;
+    }
+    finally {
+        reader.cancel().catch(() => { });
+        reader.releaseLock();
+    }
+    return [contentType, chunks.join('')];
+}
+function _parseCharset(contentType) {
+    const match = contentType.match(/charset=(?:"([^"]+)"|'([^']+)'|([^;\s]+))/i);
+    const charset = (match?.[1] ?? match?.[2] ?? match?.[3] ?? 'utf-8').toLowerCase();
+    try {
+        new TextDecoder(charset);
+        return charset;
+    }
+    catch {
+        return 'utf-8';
+    }
+}
+//# sourceMappingURL=web-fetch.js.map

package/dist/src/vended-tools/web-fetch/web-fetch.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strands-agents/sdk",
-  "version": "1.17.0",
+  "version": "1.19.0",
   "description": "TypeScript SDK for Strands Agents framework",
   "main": "dist/src/index.js",
   "module": "dist/src/index.js",
@@ -64,6 +64,10 @@
       "types": "./dist/src/vended-tools/file-editor/index.d.ts",
       "default": "./dist/src/vended-tools/file-editor/index.js"
     },
+    "./vended-tools/handoff-to-user": {
+      "types": "./dist/src/vended-tools/handoff-to-user/index.d.ts",
+      "default": "./dist/src/vended-tools/handoff-to-user/index.js"
+    },
     "./vended-tools/http-request": {
       "types": "./dist/src/vended-tools/http-request/index.d.ts",
       "default": "./dist/src/vended-tools/http-request/index.js"
@@ -84,6 +88,10 @@
       "types": "./dist/src/experimental/vended-tools/stop/index.d.ts",
       "default": "./dist/src/experimental/vended-tools/stop/index.js"
     },
+    "./vended-tools/web-fetch": {
+      "types": "./dist/src/vended-tools/web-fetch/index.d.ts",
+      "default": "./dist/src/vended-tools/web-fetch/index.js"
+    },
     "./a2a": {
       "types": "./dist/src/a2a/index.d.ts",
       "default": "./dist/src/a2a/index.js"
@@ -162,6 +170,12 @@
         "default": "./dist/src/storage/search/qmd.js"
       }
     },
+    "./storage/search/bm25": {
+      "node": {
+        "types": "./dist/src/storage/search/qmd.d.ts",
+        "default": "./dist/src/storage/search/qmd.js"
+      }
+    },
     "./sandbox": {
       "types": "./dist/src/sandbox/index.d.ts",
       "default": "./dist/src/sandbox/index.js"
@@ -239,6 +253,7 @@
     "@smithy/types": "^4.15.1",
     "@types/express": "^5.0.6",
     "@types/node": "^25.9.4",
+    "@types/turndown": "^5.0.6",
     "@typescript-eslint/eslint-plugin": "^8.62.1",
     "@typescript-eslint/parser": "^8.0.0",
     "@vitest/browser": "^4.1.10",
@@ -250,6 +265,7 @@
     "openai": "^6.45.0",
     "playwright": "^1.61.0",
     "tsx": "^4.22.5",
+    "turndown": "^7.2.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   },
@@ -265,11 +281,11 @@
   },
   "homepage": "https://github.com/strands-agents/harness-sdk#readme",
   "dependencies": {
-    "@smithy/fetch-http-handler": "^5.7.2",
-    "@aws-sdk/client-bedrock-runtime": "^3.1112.0",
+    "@smithy/fetch-http-handler": "^5.8.0",
+    "@aws-sdk/client-bedrock-runtime": "^3.1132.0",
     "@types/json-schema": "^7.0.15",
     "uuid": "^14.0.2",
-    "yaml": "^2.8.3"
+    "yaml": "^2.9.1"
   },
   "peerDependencies": {
     "@a2a-js/sdk": "^0.3.10",
@@ -294,6 +310,7 @@
     "@tobilu/qmd": "^2.8.0",
     "express": "^5.1.0",
     "openai": "^6.45.0",
+    "turndown": "^7.2.4",
     "zod": "^4.1.12"
   },
   "peerDependenciesMeta": {
@@ -356,6 +373,9 @@
     },
     "@tobilu/qmd": {
       "optional": true
+    },
+    "turndown": {
+      "optional": true
     }
   },
   "overrides": {