experimental-ash 0.26.0 → 0.28.0

package/dist/src/execution/subagent-adapter.js

@@ -1,94 +1 @@
-import { resumeHook } from "#compiled/@workflow/core/runtime.js";
-// Import from seed-keys (not keys.ts) to avoid pulling in the runtime
-// channel registry. `runtime/channels/registry` imports this module to
-// compose `FRAMEWORK_ADAPTERS`, and `context/keys` pulls in the same
-// registry through its ChannelKey codec — reading seed keys directly
-// keeps the dependency graph one-way.
-import { ContinuationTokenKey, SessionIdKey } from "#context/seed-keys.js";
-import { createErrorId, createLogger } from "#internal/logging.js";
-const log = createLogger("execution.subagent-adapter");
-/**
- * Durable adapter kind used for delegated subagent child runs.
- *
- * Framework-owned — authored channel code never constructs a subagent
- * adapter directly. Emitted by `buildSubagentRunInput`
- * (`execution/subagent-tool.ts`) when a parent dispatches a child
- * subagent.
- */
-export const SUBAGENT_ADAPTER_KIND = "subagent";
-/**
- * Narrow runtime guard for {@link SubagentAdapterState}.
- *
- * Framework adapters live through a JSON round-trip at every workflow
- * step boundary, so consumers that want to treat the adapter state as
- * a structured record must validate the shape explicitly.
- */
-export function isSubagentAdapterState(value) {
-    if (value === null || typeof value !== "object") {
-        return false;
-    }
-    const state = value;
-    return (typeof state.callId === "string" &&
-        state.callId.length > 0 &&
-        typeof state.parentContinuationToken === "string" &&
-        state.parentContinuationToken.length > 0 &&
-        typeof state.parentSessionId === "string" &&
-        typeof state.subagentName === "string" &&
-        state.subagentName.length > 0);
-}
-/**
- * Framework adapter that bridges a child subagent session to its
- * parent.
- *
- * It proxies child `input.requested` events upward so the parent channel
- * can render HITL prompts and route responses back down to the child.
- */
-export const SUBAGENT_ADAPTER = {
-    kind: SUBAGENT_ADAPTER_KIND,
-    async "input.requested"(data, ctx) {
-        const state = ctx.state;
-        if (!isSubagentAdapterState(state)) {
-            return;
-        }
-        const hookPayload = {
-            callId: state.callId,
-            childContinuationToken: ctx.ctx.require(ContinuationTokenKey),
-            childSessionId: ctx.ctx.require(SessionIdKey),
-            event: {
-                requests: data.requests,
-                sequence: data.sequence,
-                stepIndex: data.stepIndex,
-                turnId: data.turnId,
-            },
-            kind: "subagent-input-request",
-            subagentName: state.subagentName,
-        };
-        await forwardSubagentInputRequestStep({
-            hookPayload,
-            parentContinuationToken: state.parentContinuationToken,
-        });
-    },
-};
-/**
- * Forwards one child HITL batch up to its parent via the durable
- * workflow `resumeHook` path.
- */
-async function forwardSubagentInputRequestStep(input) {
-    "use step";
-    try {
-        await resumeHook(input.parentContinuationToken, input.hookPayload);
-    }
-    catch (error) {
-        const errorId = createErrorId();
-        log.warn("failed to forward proxied HITL batch to parent", {
-            callId: input.hookPayload.callId,
-            childContinuationToken: input.hookPayload.childContinuationToken,
-            childSessionId: input.hookPayload.childSessionId,
-            errorId,
-            parentContinuationToken: input.parentContinuationToken,
-            subagentName: input.hookPayload.subagentName,
-            error,
-        });
-        throw error;
-    }
-}
+import{createErrorId,createLogger}from"#internal/logging.js";import{ContinuationTokenKey,SessionIdKey}from"#context/seed-keys.js";import{resumeHook}from"#compiled/@workflow/core/runtime.js";var log=createLogger(`execution.subagent-adapter`),SUBAGENT_ADAPTER_KIND=`subagent`;function isSubagentAdapterState(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.callId==`string`&&t.callId.length>0&&typeof t.parentContinuationToken==`string`&&t.parentContinuationToken.length>0&&typeof t.parentSessionId==`string`&&typeof t.subagentName==`string`&&t.subagentName.length>0}var SUBAGENT_ADAPTER={kind:SUBAGENT_ADAPTER_KIND,async"input.requested"(e,t){let i=t.state;isSubagentAdapterState(i)&&await forwardSubagentInputRequestStep({hookPayload:{callId:i.callId,childContinuationToken:t.ctx.require(ContinuationTokenKey),childSessionId:t.ctx.require(SessionIdKey),event:{requests:e.requests,sequence:e.sequence,stepIndex:e.stepIndex,turnId:e.turnId},kind:`subagent-input-request`,subagentName:i.subagentName},parentContinuationToken:i.parentContinuationToken})}};async function forwardSubagentInputRequestStep(t){"use step";try{await resumeHook(t.parentContinuationToken,t.hookPayload)}catch(n){let r=createErrorId();throw log.warn(`failed to forward proxied HITL batch to parent`,{callId:t.hookPayload.callId,childContinuationToken:t.hookPayload.childContinuationToken,childSessionId:t.hookPayload.childSessionId,errorId:r,parentContinuationToken:t.parentContinuationToken,subagentName:t.hookPayload.subagentName,error:n}),n}}export{SUBAGENT_ADAPTER,SUBAGENT_ADAPTER_KIND,isSubagentAdapterState};

package/dist/src/execution/subagent-hitl-proxy.js

@@ -1,81 +1 @@
-import { emitTurnEpilogue, getHarnessEmissionState, setHarnessEmissionState, } from "#harness/emission.js";
-import { getProxyInputRequests, toProxyInputRequestEntries, } from "#harness/proxy-input-requests.js";
-import { createInputRequestedEvent } from "#protocol/message.js";
-// ---------------------------------------------------------------------------
-// Upward proxy emission
-// ---------------------------------------------------------------------------
-/**
- * Runs the parent-side work when a `subagent-input-request` arrives at
- * the workflow runtime.
- *
- * Conversation mode emits a waiting boundary on the parent stream while
- * the parent harness remains parked on the child call; the returned proxy
- * entries route the eventual response back down to the child.
- */
-export async function emitProxiedInputRequest(input) {
-    await input.emit(createInputRequestedEvent({
-        requests: input.hookPayload.event.requests,
-        sequence: input.hookPayload.event.sequence,
-        stepIndex: input.hookPayload.event.stepIndex,
-        turnId: input.hookPayload.event.turnId,
-    }));
-    let nextSession = input.session;
-    if (input.mode === "conversation") {
-        const state = getHarnessEmissionState(input.session);
-        const nextState = await emitTurnEpilogue(input.emit, state, input.mode);
-        nextSession = setHarnessEmissionState(input.session, nextState);
-    }
-    return {
-        entries: toProxyInputRequestEntries(input.hookPayload),
-        session: nextSession,
-    };
-}
-/**
- * Splits an inbound {@link DeliverPayload} into parent-local and
- * proxied-child buckets based on the session's proxy map.
- *
- * When a payload carries neither a parent-local response nor any
- * adapter-specific field, `forSelf` is `undefined` and the parent
- * should re-park without running a model turn.
- */
-export function routeDeliverPayload(input) {
-    const entries = getProxyInputRequests(input.session);
-    const inputResponses = input.payload.inputResponses ?? [];
-    const responsesByChild = new Map();
-    const unroutedResponses = [];
-    for (const response of inputResponses) {
-        const childContinuationToken = entries.get(response.requestId);
-        if (childContinuationToken === undefined) {
-            unroutedResponses.push(response);
-            continue;
-        }
-        const existing = responsesByChild.get(childContinuationToken);
-        if (existing === undefined) {
-            responsesByChild.set(childContinuationToken, [response]);
-        }
-        else {
-            existing.push(response);
-        }
-    }
-    const forChildren = [...responsesByChild.entries()].map(([childContinuationToken, responses]) => ({
-        childContinuationToken,
-        payload: { inputResponses: responses },
-    }));
-    // Build `forSelf`: keep every non-`inputResponses` field on the
-    // original payload (so adapter-specific data survives) and restore
-    // any un-routed responses. When the resulting payload carries no
-    // actionable signal, return `undefined` so the parent can re-park
-    // without a model turn.
-    const remainder = {};
-    for (const [key, value] of Object.entries(input.payload)) {
-        if (key === "inputResponses" || value === undefined) {
-            continue;
-        }
-        remainder[key] = value;
-    }
-    if (unroutedResponses.length > 0) {
-        remainder.inputResponses = unroutedResponses;
-    }
-    const forSelf = Object.keys(remainder).length > 0 ? remainder : undefined;
-    return { forChildren, forSelf };
-}
+import{createInputRequestedEvent}from"#protocol/message.js";import{emitTurnEpilogue,getHarnessEmissionState,setHarnessEmissionState}from"#harness/emission.js";import{getProxyInputRequests,toProxyInputRequestEntries}from"#harness/proxy-input-requests.js";async function emitProxiedInputRequest(i){await i.emit(createInputRequestedEvent({requests:i.hookPayload.event.requests,sequence:i.hookPayload.event.sequence,stepIndex:i.hookPayload.event.stepIndex,turnId:i.hookPayload.event.turnId}));let o=i.session;if(i.mode===`conversation`){let e=getHarnessEmissionState(i.session),a=await emitTurnEpilogue(i.emit,e,i.mode);o=setHarnessEmissionState(i.session,a)}return{entries:toProxyInputRequestEntries(i.hookPayload),session:o}}function routeDeliverPayload(e){let t=getProxyInputRequests(e.session),n=e.payload.inputResponses??[],r=new Map,a=[];for(let e of n){let n=t.get(e.requestId);if(n===void 0){a.push(e);continue}let i=r.get(n);i===void 0?r.set(n,[e]):i.push(e)}let o=[...r.entries()].map(([e,t])=>({childContinuationToken:e,payload:{inputResponses:t}})),s={};for(let[t,n]of Object.entries(e.payload))t===`inputResponses`||n===void 0||(s[t]=n);return a.length>0&&(s.inputResponses=a),{forChildren:o,forSelf:Object.keys(s).length>0?s:void 0}}export{emitProxiedInputRequest,routeDeliverPayload};

package/dist/src/execution/subagent-invocation.js

@@ -1,16 +1,2 @@
-/**
- * Formats the stable delegated input handed to one child agent invocation.
- */
-export function formatSubagentInvocation(input) {
-    return {
-        message: [
-            `You are the subagent "${input.name}".`,
-            `Description: ${input.description}`,
-            "",
-            "The caller delegated the following task to you. Complete it and return the final result directly.",
-            "",
-            "Caller message:",
-            input.message,
-        ].join("\n"),
-    };
-}
+function formatSubagentInvocation(e){return{message:[`You are the subagent "${e.name}".`,`Description: ${e.description}`,``,`The caller delegated the following task to you. Complete it and return the final result directly.`,``,`Caller message:`,e.message].join(`
+`)}}export{formatSubagentInvocation};

package/dist/src/execution/subagent-tool.js

@@ -1,48 +1 @@
-import { SUBAGENT_ADAPTER_KIND } from "#execution/subagent-adapter.js";
-import { formatSubagentInvocation } from "#execution/subagent-invocation.js";
-import { mintSubagentContinuationToken } from "#execution/session.js";
-/**
- * Builds the {@link RunInput} for one delegated subagent child run.
- */
-export function buildSubagentRunInput(input) {
-    const { action, auth, batchEvent, capabilities, initiatorAuth, session } = input;
-    const childContinuationToken = mintSubagentContinuationToken(`${session.sessionId}:${action.callId}`);
-    const runInput = {
-        adapter: {
-            kind: SUBAGENT_ADAPTER_KIND,
-            state: {
-                callId: action.callId,
-                parentContinuationToken: session.continuationToken,
-                parentSessionId: session.sessionId,
-                subagentName: action.subagentName,
-            },
-        },
-        auth,
-        capabilities,
-        continuationToken: childContinuationToken,
-        initiatorAuth,
-        input: {
-            message: formatSubagentCallInputMessage(action),
-        },
-        mode: "task",
-        parent: {
-            sessionId: session.sessionId,
-            turn: {
-                id: batchEvent.turnId,
-                sequence: batchEvent.sequence,
-            },
-        },
-    };
-    return { childContinuationToken, runInput };
-}
-/**
- * Formats the synthesized child input message for one delegated subagent call.
- */
-function formatSubagentCallInputMessage(action) {
-    const { message } = action.input;
-    return formatSubagentInvocation({
-        description: action.description,
-        message,
-        name: action.subagentName,
-    }).message;
-}
+import{formatSubagentInvocation}from"#execution/subagent-invocation.js";import{SUBAGENT_ADAPTER_KIND}from"#execution/subagent-adapter.js";import{mintSubagentContinuationToken}from"#execution/session.js";function buildSubagentRunInput(e){let{action:r,auth:i,batchEvent:a,capabilities:o,initiatorAuth:s,session:c}=e,l=mintSubagentContinuationToken(`${c.sessionId}:${r.callId}`);return{childContinuationToken:l,runInput:{adapter:{kind:SUBAGENT_ADAPTER_KIND,state:{callId:r.callId,parentContinuationToken:c.continuationToken,parentSessionId:c.sessionId,subagentName:r.subagentName}},auth:i,capabilities:o,continuationToken:l,initiatorAuth:s,input:{message:formatSubagentCallInputMessage(r)},mode:`task`,parent:{sessionId:c.sessionId,turn:{id:a.turnId,sequence:a.sequence}}}}}function formatSubagentCallInputMessage(t){let{message:n}=t.input;return formatSubagentInvocation({description:t.description,message:n,name:t.subagentName}).message}export{buildSubagentRunInput};

package/dist/src/execution/tool-compaction.js

@@ -1,54 +1 @@
-import { loadContext } from "#context/container.js";
-import { createLogger } from "#internal/logging.js";
-const log = createLogger("execution.tool-compaction");
-/**
- * Builds the harness compaction callback for a list of resolved tools.
- *
- * Hooks run in registration order inside the active `AshContext`; throws
- * are logged so one buggy hook cannot block the rest.
- */
-export function createToolCompactionHandler(tools) {
-    // Tools without an `onCompact` hook are filtered once at construction
-    // time so the per-compaction loop only walks participants.
-    const participants = tools.filter((tool) => tool.onCompact !== undefined);
-    return async (session) => {
-        if (participants.length === 0) {
-            return { messages: [], session };
-        }
-        const ctx = loadContext();
-        // v1 has no real cancellation plumbing through the harness yet — pass
-        // a never-aborting signal so hooks can adopt the parameter without a
-        // breaking change later when a real signal is threaded through.
-        const signal = new AbortController().signal;
-        const messages = [];
-        let state = session.state ?? {};
-        let mutated = false;
-        for (const tool of participants) {
-            const hook = tool.onCompact;
-            if (hook === undefined)
-                continue;
-            let result;
-            try {
-                result = (await hook({ ctx, session, signal })) ?? {};
-            }
-            catch (error) {
-                log.warn(`compaction hook for tool "${tool.name}" threw and was skipped`, {
-                    toolName: tool.name,
-                    error,
-                });
-                continue;
-            }
-            if (result.messages !== undefined && result.messages.length > 0) {
-                messages.push(...result.messages);
-            }
-            if (result.sessionPatch !== undefined) {
-                state = { ...state, ...result.sessionPatch };
-                mutated = true;
-            }
-        }
-        return {
-            messages,
-            session: mutated ? { ...session, state } : session,
-        };
-    };
-}
+import{createLogger}from"#internal/logging.js";import{loadContext}from"#context/container.js";var log=createLogger(`execution.tool-compaction`);function createToolCompactionHandler(e){let n=e.filter(e=>e.onCompact!==void 0);return async e=>{if(n.length===0)return{messages:[],session:e};let r=loadContext(),i=new AbortController().signal,a=[],o=e.state??{},s=!1;for(let t of n){let n=t.onCompact;if(n===void 0)continue;let c;try{c=await n({ctx:r,session:e,signal:i})??{}}catch(e){log.warn(`compaction hook for tool "${t.name}" threw and was skipped`,{toolName:t.name,error:e});continue}c.messages!==void 0&&c.messages.length>0&&a.push(...c.messages),c.sessionPatch!==void 0&&(o={...o,...c.sessionPatch},s=!0)}return{messages:a,session:s?{...e,state:o}:e}}}export{createToolCompactionHandler};

package/dist/src/execution/turn-workflow.js

@@ -1,95 +1 @@
-import { hasPendingInputBatch } from "#harness/input-requests.js";
-import { hasPendingRuntimeActionBatch } from "#harness/runtime-actions.js";
-import { awaitAuthorizationAndResolve } from "#execution/await-authorization-orchestrator.js";
-import { normalizeSerializableError } from "#execution/workflow-errors.js";
-import { turnStep } from "#execution/workflow-steps.js";
-const TASK_MODE_WAIT_ERROR_MESSAGE = "Task mode cannot wait for follow-up input (`next: null`).";
-/**
- * Short-lived workflow that owns one runtime turn for the durable
- * driver.
- *
- * `parentWritable` is received from the driver input object and
- * threaded into every step so the child's writes land directly on the
- * driver run's stream.
- */
-export async function turnWorkflow(input) {
-    "use workflow";
-    let currentSession = input.session;
-    let currentSerializedContext = input.serializedContext;
-    let currentInput = input.delivery;
-    const parentWritable = input.parentWritable;
-    try {
-        while (true) {
-            const result = await turnStep({
-                input: currentInput,
-                parentWritable,
-                serializedContext: currentSerializedContext,
-                session: currentSession,
-            });
-            currentSession = result.session;
-            currentSerializedContext = result.serializedContext;
-            if (result.action === "done") {
-                await notifyDriverStep({
-                    completionToken: input.completionToken,
-                    payload: {
-                        action: "done",
-                        kind: "turn-result",
-                        output: result.output ?? "",
-                        serializedContext: currentSerializedContext,
-                        session: currentSession,
-                    },
-                });
-                return;
-            }
-            if (result.action === "park") {
-                if (hasPendingRuntimeActionBatch(currentSession) ||
-                    (hasPendingInputBatch(currentSession) && input.capabilities?.requestInput === true) ||
-                    input.mode === "conversation") {
-                    await notifyDriverStep({
-                        completionToken: input.completionToken,
-                        payload: {
-                            action: "park",
-                            kind: "turn-result",
-                            serializedContext: currentSerializedContext,
-                            session: currentSession,
-                        },
-                    });
-                    return;
-                }
-                throw new Error(TASK_MODE_WAIT_ERROR_MESSAGE);
-            }
-            if (result.action === "await-authorization") {
-                const resolved = await awaitAuthorizationAndResolve({
-                    parentWritable,
-                    pendingToolCalls: result.pendingToolCalls,
-                    serializedContext: currentSerializedContext,
-                    session: currentSession,
-                });
-                currentSession = resolved.session;
-                currentSerializedContext = resolved.serializedContext;
-                currentInput = undefined;
-                continue;
-            }
-            currentInput = undefined;
-        }
-    }
-    catch (error) {
-        await notifyDriverStep({
-            completionToken: input.completionToken,
-            payload: {
-                error: normalizeSerializableError(error),
-                kind: "turn-error",
-            },
-        });
-        throw error;
-    }
-}
-/**
- * Completes a driver-owned one-shot hook with the result of the child
- * turn workflow.
- */
-export async function notifyDriverStep(input) {
-    "use step";
-    const { resumeHook } = await import("#compiled/@workflow/core/runtime.js");
-    await resumeHook(input.completionToken, input.payload);
-}
+import{hasPendingInputBatch}from"#harness/input-requests.js";import{hasPendingRuntimeActionBatch}from"#harness/runtime-actions.js";import{awaitAuthorizationAndResolve}from"#execution/await-authorization-orchestrator.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{turnStep}from"#execution/workflow-steps.js";var TASK_MODE_WAIT_ERROR_MESSAGE="Task mode cannot wait for follow-up input (`next: null`).";async function turnWorkflow(r){"use workflow";let i=r.session,a=r.serializedContext,o=r.delivery,s=r.parentWritable;try{for(;;){let n=await turnStep({input:o,parentWritable:s,serializedContext:a,session:i});if(i=n.session,a=n.serializedContext,n.action===`done`){await notifyDriverStep({completionToken:r.completionToken,payload:{action:`done`,kind:`turn-result`,output:n.output??``,serializedContext:a,session:i}});return}if(n.action===`park`){if(hasPendingRuntimeActionBatch(i)||hasPendingInputBatch(i)&&r.capabilities?.requestInput===!0||r.mode===`conversation`){await notifyDriverStep({completionToken:r.completionToken,payload:{action:`park`,kind:`turn-result`,serializedContext:a,session:i}});return}throw Error(TASK_MODE_WAIT_ERROR_MESSAGE)}if(n.action===`await-authorization`){let e=await awaitAuthorizationAndResolve({parentWritable:s,pendingToolCalls:n.pendingToolCalls,serializedContext:a,session:i});i=e.session,a=e.serializedContext,o=void 0;continue}o=void 0}}catch(e){throw await notifyDriverStep({completionToken:r.completionToken,payload:{error:normalizeSerializableError(e),kind:`turn-error`}}),e}}async function notifyDriverStep(e){"use step";let{resumeHook:t}=await import(`#compiled/@workflow/core/runtime.js`);await t(e.completionToken,e.payload)}export{notifyDriverStep,turnWorkflow};

package/dist/src/execution/web-fetch/html.js

@@ -1,60 +1,7 @@
-import TurndownService from "#compiled/turndown/index.js";
-/**
- * Converts an HTML string to Markdown using Turndown.
- *
- * Removes `<script>`, `<style>`, `<meta>`, and `<link>` elements before
- * conversion to keep the output focused on document content.
- */
-export function convertHtmlToMarkdown(html) {
-    const service = new TurndownService({
-        bulletListMarker: "-",
-        codeBlockStyle: "fenced",
-        emDelimiter: "*",
-        headingStyle: "atx",
-        hr: "---",
-    });
-    service.remove(["script", "style", "meta", "link"]);
-    return service.turndown(html);
-}
-/**
- * Strips HTML tags and extracts readable text content.
- *
- * Removes content inside `<script>`, `<style>`, and `<noscript>` elements,
- * replaces block-level tags with newlines, decodes common HTML entities, and
- * normalises whitespace.
- */
-export function extractTextFromHtml(html) {
-    let text = html;
-    // Remove content inside script, style, and noscript elements.
-    text = text.replace(/<(script|style|noscript)\b[^>]*>[\s\S]*?<\/\1>/gi, "");
-    // Replace block-level closing tags with newlines for readable output.
-    text = text.replace(/<\/(p|div|br|h[1-6]|li|tr|blockquote|pre|section|article|header|footer|nav|aside|main|figure|figcaption|details|summary)>/gi, "\n");
-    // Replace self-closing <br> variants with newlines.
-    text = text.replace(/<br\s*\/?>/gi, "\n");
-    // Strip all remaining HTML tags.
-    text = text.replace(/<[^>]+>/g, "");
-    // Decode common HTML entities.
-    text = decodeHtmlEntities(text);
-    // Collapse runs of whitespace on each line, then collapse blank lines.
-    text = text
-        .split("\n")
-        .map((line) => line.replace(/[ \t]+/g, " ").trim())
-        .join("\n")
-        .replace(/\n{3,}/g, "\n\n")
-        .trim();
-    return text;
-}
-const ENTITY_MAP = {
-    "&amp;": "&",
-    "&gt;": ">",
-    "&lt;": "<",
-    "&nbsp;": " ",
-    "&quot;": '"',
-    "&#39;": "'",
-    "&#x27;": "'",
-    "&#x2F;": "/",
-};
-const ENTITY_PATTERN = new RegExp(Object.keys(ENTITY_MAP).join("|"), "gi");
-function decodeHtmlEntities(text) {
-    return text.replace(ENTITY_PATTERN, (match) => ENTITY_MAP[match.toLowerCase()] ?? match);
-}
+import TurndownService from"#compiled/turndown/index.js";function convertHtmlToMarkdown(t){let n=new TurndownService({bulletListMarker:`-`,codeBlockStyle:`fenced`,emDelimiter:`*`,headingStyle:`atx`,hr:`---`});return n.remove([`script`,`style`,`meta`,`link`]),n.turndown(t)}function extractTextFromHtml(e){let t=e;return t=t.replace(/<(script|style|noscript)\b[^>]*>[\s\S]*?<\/\1>/gi,``),t=t.replace(/<\/(p|div|br|h[1-6]|li|tr|blockquote|pre|section|article|header|footer|nav|aside|main|figure|figcaption|details|summary)>/gi,`
+`),t=t.replace(/<br\s*\/?>/gi,`
+`),t=t.replace(/<[^>]+>/g,``),t=decodeHtmlEntities(t),t=t.split(`
+`).map(e=>e.replace(/[ \t]+/g,` `).trim()).join(`
+`).replace(/\n{3,}/g,`
+
+`).trim(),t}var ENTITY_MAP={"&amp;":`&`,"&gt;":`>`,"&lt;":`<`,"&nbsp;":` `,"&quot;":`"`,"&#39;":`'`,"&#x27;":`'`,"&#x2F;":`/`},ENTITY_PATTERN=new RegExp(Object.keys(ENTITY_MAP).join(`|`),`gi`);function decodeHtmlEntities(e){return e.replace(ENTITY_PATTERN,e=>ENTITY_MAP[e.toLowerCase()]??e)}export{convertHtmlToMarkdown,extractTextFromHtml};

package/dist/src/execution/web-fetch/tool.js

@@ -1,90 +1 @@
-import { ASH_PACKAGE_NAME } from "#internal/package-name.js";
-import { truncateHead } from "#execution/sandbox/truncate-output.js";
-import { convertHtmlToMarkdown, extractTextFromHtml } from "#execution/web-fetch/html.js";
-const MAX_RESPONSE_SIZE = 5 * 1024 * 1024; // 5 MB
-const DEFAULT_TIMEOUT_MS = 30_000; // 30 seconds
-const MAX_TIMEOUT_MS = 120_000; // 2 minutes
-/**
- * Browser-like User-Agent used for the initial request so servers return
- * full-fidelity content rather than bot-degraded pages.
- */
-const BROWSER_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36";
-/**
- * Executes the `web_fetch` framework tool.
- *
- * Fetches the content at the given URL and returns it in the requested
- * format. HTML responses are automatically converted to Markdown or
- * plain text when the caller requests those formats. Responses up to
- * 5 MB are accepted, and the returned {@link WebFetchResult.content}
- * is capped at the shared tool-output budget (50 KB / 2000 lines) so
- * large pages do not exhaust the model's context window.
- */
-export async function executeWebFetchTool(args) {
-    const { url, format = "markdown", timeout } = args;
-    if (!url.startsWith("http://") && !url.startsWith("https://")) {
-        throw new Error("URL must start with http:// or https://");
-    }
-    const timeoutMs = Math.min(timeout !== undefined ? timeout * 1000 : DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS);
-    const signal = AbortSignal.timeout(timeoutMs);
-    const headers = buildHeaders(format);
-    const initial = await fetch(url, { headers, signal });
-    // Cloudflare may reject browser-like UA strings from Node.js runtimes
-    // because the TLS fingerprint does not match a real browser. Retry with
-    // an honest UA to bypass the challenge.
-    const response = initial.status === 403 && initial.headers.get("cf-mitigated") === "challenge"
-        ? await fetch(url, {
-            headers: { ...headers, "User-Agent": ASH_PACKAGE_NAME },
-            signal,
-        })
-        : initial;
-    if (!response.ok) {
-        throw new Error(`Request failed with status code: ${response.status}`);
-    }
-    const declaredLength = response.headers.get("content-length");
-    if (declaredLength !== null && parseInt(declaredLength, 10) > MAX_RESPONSE_SIZE) {
-        throw new Error("Response too large (exceeds 5 MB limit).");
-    }
-    const buffer = await response.arrayBuffer();
-    if (buffer.byteLength > MAX_RESPONSE_SIZE) {
-        throw new Error("Response too large (exceeds 5 MB limit).");
-    }
-    const contentType = response.headers.get("content-type") ?? "";
-    const isHtml = contentType.includes("text/html");
-    const body = new TextDecoder().decode(buffer);
-    let rawContent;
-    if (format === "markdown" && isHtml) {
-        rawContent = convertHtmlToMarkdown(body);
-    }
-    else if (format === "text" && isHtml) {
-        rawContent = extractTextFromHtml(body);
-    }
-    else {
-        rawContent = body;
-    }
-    const { output: content, truncated } = truncateHead(rawContent);
-    return {
-        content,
-        contentType,
-        truncated,
-        url,
-    };
-}
-function buildHeaders(format) {
-    let accept;
-    if (format === "markdown") {
-        accept =
-            "text/markdown;q=1.0, text/x-markdown;q=0.9, text/plain;q=0.8, text/html;q=0.7, */*;q=0.1";
-    }
-    else if (format === "text") {
-        accept = "text/plain;q=1.0, text/markdown;q=0.9, text/html;q=0.8, */*;q=0.1";
-    }
-    else {
-        accept =
-            "text/html;q=1.0, application/xhtml+xml;q=0.9, text/plain;q=0.8, text/markdown;q=0.7, */*;q=0.1";
-    }
-    return {
-        Accept: accept,
-        "Accept-Language": "en-US,en;q=0.9",
-        "User-Agent": BROWSER_USER_AGENT,
-    };
-}
+import{truncateHead}from"#execution/sandbox/truncate-output.js";import{ASH_PACKAGE_NAME}from"#internal/package-name.js";import{convertHtmlToMarkdown,extractTextFromHtml}from"#execution/web-fetch/html.js";var MAX_RESPONSE_SIZE=5*1024*1024,DEFAULT_TIMEOUT_MS=3e4,MAX_TIMEOUT_MS=12e4,BROWSER_USER_AGENT=`Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36`;async function executeWebFetchTool(n){let{url:r,format:i=`markdown`,timeout:a}=n;if(!r.startsWith(`http://`)&&!r.startsWith(`https://`))throw Error(`URL must start with http:// or https://`);let o=Math.min(a===void 0?DEFAULT_TIMEOUT_MS:a*1e3,MAX_TIMEOUT_MS),s=AbortSignal.timeout(o),c=buildHeaders(i),l=await fetch(r,{headers:c,signal:s}),u=l.status===403&&l.headers.get(`cf-mitigated`)===`challenge`?await fetch(r,{headers:{...c,"User-Agent":ASH_PACKAGE_NAME},signal:s}):l;if(!u.ok)throw Error(`Request failed with status code: ${u.status}`);let d=u.headers.get(`content-length`);if(d!==null&&parseInt(d,10)>MAX_RESPONSE_SIZE)throw Error(`Response too large (exceeds 5 MB limit).`);let f=await u.arrayBuffer();if(f.byteLength>MAX_RESPONSE_SIZE)throw Error(`Response too large (exceeds 5 MB limit).`);let p=u.headers.get(`content-type`)??``,m=p.includes(`text/html`),h=new TextDecoder().decode(f),g;g=i===`markdown`&&m?convertHtmlToMarkdown(h):i===`text`&&m?extractTextFromHtml(h):h;let{output:_,truncated:v}=truncateHead(g);return{content:_,contentType:p,truncated:v,url:r}}function buildHeaders(e){let t;return t=e===`markdown`?`text/markdown;q=1.0, text/x-markdown;q=0.9, text/plain;q=0.8, text/html;q=0.7, */*;q=0.1`:e===`text`?`text/plain;q=1.0, text/markdown;q=0.9, text/html;q=0.8, */*;q=0.1`:`text/html;q=1.0, application/xhtml+xml;q=0.9, text/plain;q=0.8, text/markdown;q=0.7, */*;q=0.1`,{Accept:t,"Accept-Language":`en-US,en;q=0.9`,"User-Agent":BROWSER_USER_AGENT}}export{executeWebFetchTool};