@strands-agents/sdk 1.16.0 → 1.18.0

package/dist/src/vended-tools/shell/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE,eAAO,MAAM,yBAAyB,QAE8C,CAAA;AAEpF;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE,eAAO,MAAM,yBAAyB,QAG8C,CAAA;AAEpF;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;gBAElB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW;CAKnD;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CAC/B"}

package/dist/src/vended-tools/shell/types.js

@@ -5,7 +5,8 @@
  * callers who caught the pre-rename error types keep working.
  */
 import { BashTimeoutError, BashSessionError } from '../bash/types.js';
-export const SANDBOX_SHELL_DESCRIPTION = 'Executes shell commands. Each call runs in a fresh shell; ' +
+export const SANDBOX_SHELL_DESCRIPTION = 'Executes shell commands and returns output (stdout), error (stderr), and exit_code (non-zero means the ' +
+    'command failed). Each call runs in a fresh shell; ' +
     'state such as variables and the working directory does not persist across calls.';
 /**
  * Error thrown when a sandbox-routed shell command exceeds its timeout.
@@ -14,9 +15,13 @@ export const SANDBOX_SHELL_DESCRIPTION = 'Executes shell commands. Each call run
  * type keep working; new code should catch this instead.
  */
 export class ShellTimeoutError extends BashTimeoutError {
-    constructor(message) {
+    /** Output captured before the command was killed, when the sandbox reported it. */
+    partial;
+    constructor(message, partial) {
         super(message);
         this.name = 'ShellTimeoutError';
+        if (partial)
+            this.partial = partial;
     }
 }
 /**

package/dist/src/vended-tools/shell/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/vended-tools/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE,MAAM,CAAC,MAAM,yBAAyB,GACpC,4DAA4D;IAC5D,kFAAkF,CAAA;AAEpF;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/vended-tools/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE,MAAM,CAAC,MAAM,yBAAyB,GACpC,yGAAyG;IACzG,oDAAoD;IACpD,kFAAkF,CAAA;AAEpF;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,mFAAmF;IAC1E,OAAO,CAAc;IAE9B,YAAY,OAAe,EAAE,OAAqB;QAChD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACrC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}

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

@@ -0,0 +1,23 @@
+/**
+ * HTML → markdown extraction for the web fetch tool.
+ *
+ * Delegates HTML-to-markdown conversion to turndown with ATX headings and
+ * fenced code blocks. Non-content elements (scripts, styles, media, forms,
+ * etc.) are dropped entirely. `data:` URI images are replaced with their alt
+ * text (or nothing) to avoid enormous blobs in the output. `javascript:`
+ * hrefs and src values are stripped silently.
+ *
+ * Requires `turndown` as an optional peer dependency.
+ */
+/**
+ * Convert HTML to markdown suitable for a model to read.
+ *
+ * The page title, if present, is rendered as a top-level ATX heading so the
+ * model sees it as part of the document. Returns the original HTML string if
+ * conversion fails.
+ *
+ * @param html - Raw HTML string to convert.
+ * @returns The converted markdown string, or the original HTML if conversion failed.
+ */
+export declare function htmlToMarkdown(html: string): Promise<string>;
+//# sourceMappingURL=extract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyGH;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlE"}

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

@@ -0,0 +1,130 @@
+/**
+ * HTML → markdown extraction for the web fetch tool.
+ *
+ * Delegates HTML-to-markdown conversion to turndown with ATX headings and
+ * fenced code blocks. Non-content elements (scripts, styles, media, forms,
+ * etc.) are dropped entirely. `data:` URI images are replaced with their alt
+ * text (or nothing) to avoid enormous blobs in the output. `javascript:`
+ * hrefs and src values are stripped silently.
+ *
+ * Requires `turndown` as an optional peer dependency.
+ */
+import { logger } from '../../logging/logger.js';
+// Elements whose entire subtree is discarded.
+const DROPPED_ELEMENTS = [
+    'script',
+    'style',
+    'noscript',
+    'template',
+    'svg',
+    'canvas',
+    'iframe',
+    'object',
+    'embed',
+    'video',
+    'audio',
+    'form',
+    'input',
+    'button',
+    'select',
+    'textarea',
+    'nav',
+];
+// Strip invisible characters before URL scheme detection.
+function _stripInvisible(value) {
+    return value.replace(/^[\p{Cc}\p{Cf}\p{Zs}]+/u, '');
+}
+async function loadTurndown() {
+    try {
+        return (await import('turndown')).default;
+    }
+    catch (cause) {
+        throw new Error("web_fetch requires the 'turndown' package. Install it with: npm install turndown", { cause });
+    }
+}
+async function _createTurndownService() {
+    const Turndown = await loadTurndown();
+    const td = new Turndown({
+        headingStyle: 'atx',
+        codeBlockStyle: 'fenced',
+        bulletListMarker: '-',
+        emDelimiter: '*',
+        strongDelimiter: '**',
+        linkStyle: 'inlined',
+    });
+    // Cast needed because svg/noscript/template are absent from HTMLElementTagNameMap.
+    td.remove(DROPPED_ELEMENTS);
+    // Render the <title> as a top-level heading so it appears in the document
+    // body rather than being silently dropped (turndown ignores <head> elements).
+    td.addRule('title', {
+        filter: 'title',
+        replacement: (_content, node) => {
+            const text = node.textContent?.trim() ?? '';
+            return text ? `# ${text}\n\n` : '';
+        },
+    });
+    // Replace data: URI images with alt text only (they can be enormous blobs).
+    // Strip javascript: src values entirely.
+    td.addRule('safeImage', {
+        filter: 'img',
+        replacement: (_content, node) => {
+            const element = node;
+            const src = (element.getAttribute('src') ?? '').trim();
+            const alt = element.getAttribute('alt') ?? '';
+            if (!src)
+                return alt;
+            try {
+                const scheme = new URL(_stripInvisible(src)).protocol;
+                if (scheme === 'javascript:')
+                    return '';
+                if (scheme === 'data:')
+                    return alt;
+            }
+            catch {
+                // not an absolute URL — pass through as-is
+            }
+            return `![${alt}](${src})`;
+        },
+    });
+    // Strip javascript: hrefs — render link text only.
+    td.addRule('safeLink', {
+        filter: (node) => {
+            if (node.nodeName !== 'A')
+                return false;
+            const href = (node.getAttribute('href') ?? '').trim();
+            try {
+                return new URL(_stripInvisible(href)).protocol === 'javascript:';
+            }
+            catch {
+                return false;
+            }
+        },
+        replacement: (content) => content,
+    });
+    return td;
+}
+// Cache the configured service so rules are registered once across all calls.
+let _turndownServicePromise = null;
+/**
+ * Convert HTML to markdown suitable for a model to read.
+ *
+ * The page title, if present, is rendered as a top-level ATX heading so the
+ * model sees it as part of the document. Returns the original HTML string if
+ * conversion fails.
+ *
+ * @param html - Raw HTML string to convert.
+ * @returns The converted markdown string, or the original HTML if conversion failed.
+ */
+export async function htmlToMarkdown(html) {
+    _turndownServicePromise ??= _createTurndownService();
+    const td = await _turndownServicePromise;
+    try {
+        const markdown = td.turndown(html).trim();
+        return markdown ? markdown + '\n' : '';
+    }
+    catch (error) {
+        logger.warn(`error=<${error}> | html_to_markdown failed, returning raw html`);
+        return html;
+    }
+}
+//# sourceMappingURL=extract.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Web fetch tool: fetch a URL and return clean markdown suitable for a model to read.
+ *
+ * Distinct from the http-request tool (raw API calls). See {@link webFetch}.
+ */
+export { webFetch, makeWebFetch } from './web-fetch.js';
+export type { MakeWebFetchOptions } from './types.js';
+export type { WebFetchMarkdownInput, WebFetchAgenticInput } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA"}

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

@@ -0,0 +1,7 @@
+/**
+ * Web fetch tool: fetch a URL and return clean markdown suitable for a model to read.
+ *
+ * Distinct from the http-request tool (raw API calls). See {@link webFetch}.
+ */
+export { webFetch, makeWebFetch } from './web-fetch.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

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

@@ -0,0 +1,40 @@
+import type { Model } from '../../models/model.js';
+/**
+ * Input parameters for the markdown mode web fetch tool.
+ */
+export interface WebFetchMarkdownInput {
+    /** URL to fetch. Must be http:// or https://. */
+    url: string;
+}
+/**
+ * Input parameters for the agentic mode web fetch tool.
+ */
+export interface WebFetchAgenticInput {
+    /** URL to fetch. Must be http:// or https://. */
+    url: string;
+    /** Question or instruction about the page content. */
+    prompt: string;
+}
+export declare const WEB_FETCH_DESCRIPTION_MARKDOWN: string;
+export declare const WEB_FETCH_DESCRIPTION_AGENTIC: string;
+/**
+ * Options for {@link makeWebFetch}.
+ */
+export interface MakeWebFetchOptions {
+    /** Tool name shown to the model. Defaults to `'web_fetch'`. */
+    name?: string;
+    /** Tool description shown to the model. Defaults to a mode-appropriate description. */
+    description?: string;
+    /** Maximum response body size in bytes. Defaults to 5 MiB. */
+    maxBytes?: number;
+    /** Maximum characters of extracted content delivered to the model. Defaults to 50,000. */
+    maxContentChars?: number;
+    /**
+     * Optional model for the analyst agent. Only used when `mode` is `'agentic'`.
+     * Falls back to the host agent's model when not provided.
+     */
+    model?: Model;
+    /** Extraction mode. Defaults to `'agentic'`. */
+    mode?: 'markdown' | 'agentic';
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAA;IACX,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;CACf;AAED,eAAO,MAAM,8BAA8B,QAGA,CAAA;AAE3C,eAAO,MAAM,6BAA6B,QAIL,CAAA;AAErC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,gDAAgD;IAChD,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;CAC9B"}

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.16.0",
+  "version": "1.18.0",
   "description": "TypeScript SDK for Strands Agents framework",
   "main": "dist/src/index.js",
   "module": "dist/src/index.js",
@@ -84,6 +84,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 +166,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 +249,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,14 +261,12 @@
     "openai": "^6.45.0",
     "playwright": "^1.61.0",
     "tsx": "^4.22.5",
+    "turndown": "^7.2.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   },
-  "optionalDependencies": {
-    "@tobilu/qmd": "^2.8.0"
-  },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "repository": {
     "type": "git",
@@ -297,6 +306,7 @@
     "@tobilu/qmd": "^2.8.0",
     "express": "^5.1.0",
     "openai": "^6.45.0",
+    "turndown": "^7.2.4",
     "zod": "^4.1.12"
   },
   "peerDependenciesMeta": {
@@ -359,6 +369,9 @@
     },
     "@tobilu/qmd": {
       "optional": true
+    },
+    "turndown": {
+      "optional": true
     }
   },
   "overrides": {