@botbotgo/agent-harness 0.0.474 → 0.0.476

package/dist/runtime/adapter/tool/tool-hitl.js

@@ -1,346 +1 @@
-import { interrupt } from "@langchain/langgraph";
-import path from "node:path";
-import { validateToolGatewayInput } from "../../harness/tool-gateway/index.js";
-const DEDUPED_REMOTE_TOOL_NAMES = new Set(["builtin.fetch_url", "builtin.web_search"]);
-const PATH_LIKE_INPUT_KEYS = new Set(["path", "root", "dir", "directory", "cwd"]);
-const ROOT_SCOPING_INPUT_KEYS = new Set(["root", "dir", "directory", "cwd"]);
-const SENSITIVE_MEMORY_LEVELS = new Set(["high", "sensitive", "restricted", "secret", "confidential"]);
-const NON_THREAD_MEMORY_SCOPES = new Set(["workspace", "agent", "user", "project"]);
-function asRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value)
-        ? value
-        : undefined;
-}
-function asString(value) {
-    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
-}
-function readApprovalDecisionMode(value) {
-    if (value === "none" ||
-        value === "manual" ||
-        value === "auto-approve" ||
-        value === "auto-reject" ||
-        value === "deny-and-continue") {
-        return value;
-    }
-    return undefined;
-}
-function readApprovalOverride(compiledTool) {
-    if (compiledTool.config?.requireApproval === true) {
-        return true;
-    }
-    const approval = asRecord(compiledTool.config?.approval);
-    if (approval?.required === true || approval?.enabled === true) {
-        return true;
-    }
-    const mcpConfig = asRecord(compiledTool.config?.mcp);
-    return mcpConfig?.requireApproval === true || mcpConfig?.approvalRequired === true;
-}
-function requiresApprovalForSensitiveMemoryWrite(compiledTool) {
-    const memoryConfig = asRecord(compiledTool.config?.memory);
-    if (memoryConfig?.enabled !== true) {
-        return false;
-    }
-    if (memoryConfig.requireApproval === true || memoryConfig.approvalRequired === true) {
-        return true;
-    }
-    const scope = asString(memoryConfig.scope)?.toLowerCase() ?? "session";
-    const sensitivity = asString(memoryConfig.sensitivity)?.toLowerCase();
-    if (sensitivity && SENSITIVE_MEMORY_LEVELS.has(sensitivity)) {
-        return true;
-    }
-    return NON_THREAD_MEMORY_SCOPES.has(scope) && sensitivity !== "public" && sensitivity !== "low";
-}
-function requiresApprovalForHighRiskMcpWrite(compiledTool) {
-    if (compiledTool.type !== "mcp") {
-        return false;
-    }
-    if (readApprovalOverride(compiledTool)) {
-        return true;
-    }
-    const mcpConfig = asRecord(compiledTool.config?.mcp);
-    const mcpServer = asRecord(compiledTool.config?.mcpServer);
-    const access = asString(mcpServer?.access ?? mcpConfig?.access);
-    const approvalPolicy = asString(mcpServer?.approvalPolicy ?? mcpConfig?.approvalPolicy);
-    if (approvalPolicy === "always") {
-        return true;
-    }
-    if (approvalPolicy === "never") {
-        return false;
-    }
-    return access === "read-write";
-}
-function matchesGovernanceToolPolicy(rule, compiledTool) {
-    const match = asRecord(rule.match) ?? rule;
-    const toolName = asString(match.toolName);
-    const category = asString(match.category);
-    const toolType = asString(match.toolType);
-    const compiledCategory = compiledTool.type === "mcp"
-        ? "mcp"
-        : compiledTool.type === "backend"
-            ? "backend"
-            : compiledTool.type === "provider"
-                ? "provider-native"
-                : "local";
-    return (!toolName || toolName === compiledTool.name)
-        && (!category || category === compiledCategory)
-        && (!toolType || toolType === compiledTool.type);
-}
-function readToolApprovalModeFromGovernance(compiledTool, binding) {
-    const governance = asRecord(binding?.harnessRuntime.governance);
-    const overrides = Array.isArray(governance?.toolPolicies) ? governance.toolPolicies : [];
-    for (const rule of overrides) {
-        const typedRule = asRecord(rule);
-        if (!typedRule || !matchesGovernanceToolPolicy(typedRule, compiledTool)) {
-            continue;
-        }
-        const overrideMode = readApprovalDecisionMode(typedRule.decisionMode ?? typedRule.approvalMode);
-        if (overrideMode) {
-            return overrideMode;
-        }
-    }
-    return undefined;
-}
-function readToolApprovalModeFromConfig(compiledTool) {
-    const approval = asRecord(compiledTool.config?.approval);
-    return readApprovalDecisionMode(approval?.mode ??
-        approval?.decisionMode ??
-        compiledTool.config?.approvalMode);
-}
-export function resolveToolApprovalDecisionMode(compiledTool, binding) {
-    if (compiledTool.hitl?.enabled === true) {
-        return "manual";
-    }
-    const governanceMode = readToolApprovalModeFromGovernance(compiledTool, binding);
-    if (governanceMode) {
-        return governanceMode;
-    }
-    const configuredMode = readToolApprovalModeFromConfig(compiledTool);
-    if (configuredMode) {
-        return configuredMode;
-    }
-    if (readApprovalOverride(compiledTool) || requiresApprovalForSensitiveMemoryWrite(compiledTool) || requiresApprovalForHighRiskMcpWrite(compiledTool)) {
-        return "manual";
-    }
-    return "none";
-}
-export function toolRequiresRuntimeApproval(compiledTool) {
-    return resolveToolApprovalDecisionMode(compiledTool) === "manual";
-}
-function toolApprovalReason(compiledTool) {
-    if (compiledTool.hitl?.enabled === true) {
-        return undefined;
-    }
-    if (requiresApprovalForSensitiveMemoryWrite(compiledTool)) {
-        return "sensitive-memory-write";
-    }
-    if (requiresApprovalForHighRiskMcpWrite(compiledTool)) {
-        return "high-risk-mcp-write";
-    }
-    if (readApprovalOverride(compiledTool)) {
-        return "runtime-policy";
-    }
-    return undefined;
-}
-function toInputPreview(input) {
-    if (typeof input === "object" && input && !Array.isArray(input)) {
-        return input;
-    }
-    return { input };
-}
-function resolveApprovedInput(originalInput, resumeValue) {
-    if (resumeValue === "reject") {
-        return Symbol.for("agent-harness.hitl.reject");
-    }
-    if (typeof resumeValue === "object" && resumeValue && "decision" in resumeValue) {
-        const typed = resumeValue;
-        if (typed.decision === "reject") {
-            return Symbol.for("agent-harness.hitl.reject");
-        }
-        if (typed.decision === "edit" && typed.editedInput !== undefined) {
-            return typed.editedInput;
-        }
-    }
-    return originalInput;
-}
-export function wrapToolForHumanInTheLoop(resolvedTool, compiledTool, binding, interruptFn = interrupt) {
-    const decisionMode = resolveToolApprovalDecisionMode(compiledTool, binding);
-    if (decisionMode === "none" || typeof resolvedTool !== "object" || resolvedTool === null) {
-        return resolvedTool;
-    }
-    const target = resolvedTool;
-    const runWithApproval = async (input, config, invokeOriginal) => {
-        const gateway = validateToolGatewayInput({
-            toolName: compiledTool.name,
-            schema: target.schema,
-            args: input,
-            requiresApproval: true,
-        });
-        if (!gateway.ok) {
-            return gateway.error;
-        }
-        if (decisionMode === "auto-approve") {
-            return invokeOriginal(gateway.input, config);
-        }
-        if (decisionMode === "auto-reject" || decisionMode === "deny-and-continue") {
-            return "Tool execution denied by runtime policy.";
-        }
-        const resumed = interruptFn({
-            toolName: compiledTool.name,
-            toolId: compiledTool.id,
-            allowedDecisions: compiledTool.hitl?.allow ?? ["approve", "edit", "reject"],
-            inputPreview: toInputPreview(gateway.input),
-            decisionMode,
-            ...(toolApprovalReason(compiledTool) ? { approvalReason: toolApprovalReason(compiledTool) } : {}),
-        });
-        const approvedInput = resolveApprovedInput(gateway.input, resumed);
-        if (approvedInput === Symbol.for("agent-harness.hitl.reject")) {
-            return "Tool execution rejected by human reviewer.";
-        }
-        return invokeOriginal(approvedInput, config);
-    };
-    return new Proxy(target, {
-        get(obj, prop, receiver) {
-            const value = Reflect.get(obj, prop, receiver);
-            if (prop === "invoke" && typeof value === "function") {
-                return (input, config) => runWithApproval(input, config, (approvedInput, approvedConfig) => obj.invoke(approvedInput, approvedConfig));
-            }
-            if (prop === "call" && typeof value === "function") {
-                return (input, config) => runWithApproval(input, config, (approvedInput, approvedConfig) => obj.call(approvedInput, approvedConfig));
-            }
-            if (prop === "func" && typeof value === "function") {
-                return (input, config) => runWithApproval(input, config, (approvedInput, approvedConfig) => obj.func(approvedInput, approvedConfig));
-            }
-            return value;
-        },
-    });
-}
-function stableStringify(value) {
-    if (value === null || typeof value !== "object") {
-        return JSON.stringify(value);
-    }
-    if (Array.isArray(value)) {
-        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
-    }
-    const entries = Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
-    return `{${entries.map(([key, nested]) => `${JSON.stringify(key)}:${stableStringify(nested)}`).join(",")}}`;
-}
-function createDedupedToolKey(toolName, input) {
-    return `${toolName}:${stableStringify(input)}`;
-}
-function wrapToolWithDedupe(resolvedTool, compiledTool) {
-    if (!DEDUPED_REMOTE_TOOL_NAMES.has(compiledTool.name) || typeof resolvedTool !== "object" || resolvedTool === null) {
-        return resolvedTool;
-    }
-    const target = resolvedTool;
-    const cache = new Map();
-    const dedupeCall = (input, config, invokeOriginal) => {
-        const cacheKey = createDedupedToolKey(compiledTool.name, input);
-        const cached = cache.get(cacheKey);
-        if (cached) {
-            return cached;
-        }
-        const pending = Promise.resolve(invokeOriginal(input, config)).catch((error) => {
-            cache.delete(cacheKey);
-            throw error;
-        });
-        cache.set(cacheKey, pending);
-        return pending;
-    };
-    return new Proxy(target, {
-        get(obj, prop, receiver) {
-            const value = Reflect.get(obj, prop, receiver);
-            if (prop === "invoke" && typeof value === "function") {
-                return (input, config) => dedupeCall(input, config, (approvedInput, approvedConfig) => obj.invoke(approvedInput, approvedConfig));
-            }
-            if (prop === "call" && typeof value === "function") {
-                return (input, config) => dedupeCall(input, config, (approvedInput, approvedConfig) => obj.call(approvedInput, approvedConfig));
-            }
-            if (prop === "func" && typeof value === "function") {
-                return (input, config) => dedupeCall(input, config, (approvedInput, approvedConfig) => obj.func(approvedInput, approvedConfig));
-            }
-            return value;
-        },
-    });
-}
-function shouldConstrainWorkspacePaths(compiledTool) {
-    return compiledTool.type !== "mcp";
-}
-function guardWorkspaceBoundToolInput(input, compiledTool, binding) {
-    const workspaceRoot = binding?.harnessRuntime.workspaceRoot;
-    if (!workspaceRoot || typeof input !== "object" || !input || Array.isArray(input) || !shouldConstrainWorkspacePaths(compiledTool)) {
-        return input;
-    }
-    const record = { ...input };
-    for (const [key, value] of Object.entries(record)) {
-        if (!PATH_LIKE_INPUT_KEYS.has(key) || typeof value !== "string") {
-            continue;
-        }
-        const candidate = value.trim();
-        if (!candidate || /^[a-z]+:\/\//i.test(candidate)) {
-            continue;
-        }
-        const absolute = path.resolve(workspaceRoot, candidate);
-        const relative = path.relative(workspaceRoot, absolute);
-        if (relative.startsWith("..") || path.isAbsolute(relative)) {
-            if (ROOT_SCOPING_INPUT_KEYS.has(key)) {
-                record[key] = workspaceRoot;
-                continue;
-            }
-            throw new Error(`Tool ${compiledTool.name} input ${key} resolves outside the workspace root`);
-        }
-    }
-    return record;
-}
-export function wrapToolForExecution(resolvedTool, compiledTool, binding, interruptFn = interrupt) {
-    const guardedTool = typeof resolvedTool === "object" && resolvedTool !== null
-        ? new Proxy(resolvedTool, {
-            get(obj, prop, receiver) {
-                const value = Reflect.get(obj, prop, receiver);
-                if (prop === "invoke" && typeof value === "function") {
-                    return (input, config) => {
-                        const gateway = validateToolGatewayInput({
-                            toolName: compiledTool.name,
-                            schema: obj.schema,
-                            args: input,
-                            requiresApproval: resolveToolApprovalDecisionMode(compiledTool, binding) !== "none",
-                        });
-                        if (!gateway.ok) {
-                            return gateway.error;
-                        }
-                        return obj.invoke(guardWorkspaceBoundToolInput(gateway.input, compiledTool, binding), config);
-                    };
-                }
-                if (prop === "call" && typeof value === "function") {
-                    return (input, config) => {
-                        const gateway = validateToolGatewayInput({
-                            toolName: compiledTool.name,
-                            schema: obj.schema,
-                            args: input,
-                            requiresApproval: resolveToolApprovalDecisionMode(compiledTool, binding) !== "none",
-                        });
-                        if (!gateway.ok) {
-                            return gateway.error;
-                        }
-                        return obj.call(guardWorkspaceBoundToolInput(gateway.input, compiledTool, binding), config);
-                    };
-                }
-                if (prop === "func" && typeof value === "function") {
-                    return (input, config) => {
-                        const gateway = validateToolGatewayInput({
-                            toolName: compiledTool.name,
-                            schema: obj.schema,
-                            args: input,
-                            requiresApproval: resolveToolApprovalDecisionMode(compiledTool, binding) !== "none",
-                        });
-                        if (!gateway.ok) {
-                            return gateway.error;
-                        }
-                        return obj.func(guardWorkspaceBoundToolInput(gateway.input, compiledTool, binding), config);
-                    };
-                }
-                return value;
-            },
-        })
-        : resolvedTool;
-    return wrapToolWithDedupe(wrapToolForHumanInTheLoop(guardedTool, compiledTool, binding, interruptFn), compiledTool);
-}
+import{interrupt as R}from"@langchain/langgraph";import m from"node:path";import{validateToolGatewayInput as l}from"../../harness/tool-gateway/index.js";const _=new Set(["builtin.fetch_url","builtin.web_search"]),I=new Set(["path","root","dir","directory","cwd"]),O=new Set(["root","dir","directory","cwd"]),q=new Set(["high","sensitive","restricted","secret","confidential"]),C=new Set(["workspace","agent","user","project"]);function d(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}function h(e){return typeof e=="string"&&e.trim().length>0?e.trim():void 0}function k(e){if(e==="none"||e==="manual"||e==="auto-approve"||e==="auto-reject"||e==="deny-and-continue")return e}function A(e){if(e.config?.requireApproval===!0)return!0;const r=d(e.config?.approval);if(r?.required===!0||r?.enabled===!0)return!0;const t=d(e.config?.mcp);return t?.requireApproval===!0||t?.approvalRequired===!0}function P(e){const r=d(e.config?.memory);if(r?.enabled!==!0)return!1;if(r.requireApproval===!0||r.approvalRequired===!0)return!0;const t=h(r.scope)?.toLowerCase()??"session",n=h(r.sensitivity)?.toLowerCase();return n&&q.has(n)?!0:C.has(t)&&n!=="public"&&n!=="low"}function E(e){if(e.type!=="mcp")return!1;if(A(e))return!0;const r=d(e.config?.mcp),t=d(e.config?.mcpServer),n=h(t?.access??r?.access),c=h(t?.approvalPolicy??r?.approvalPolicy);return c==="always"?!0:c==="never"?!1:n==="read-write"}function b(e,r){const t=d(e.match)??e,n=h(t.toolName),c=h(t.category),o=h(t.toolType),u=r.type==="mcp"?"mcp":r.type==="backend"?"backend":r.type==="provider"?"provider-native":"local";return(!n||n===r.name)&&(!c||c===u)&&(!o||o===r.type)}function j(e,r){const t=d(r?.harnessRuntime.governance),n=Array.isArray(t?.toolPolicies)?t.toolPolicies:[];for(const c of n){const o=d(c);if(!o||!b(o,e))continue;const u=k(o.decisionMode??o.approvalMode);if(u)return u}}function x(e){const r=d(e.config?.approval);return k(r?.mode??r?.decisionMode??e.config?.approvalMode)}function w(e,r){if(e.hitl?.enabled===!0)return"manual";const t=j(e,r);if(t)return t;const n=x(e);return n||(A(e)||P(e)||E(e)?"manual":"none")}function U(e){return w(e)==="manual"}function N(e){if(e.hitl?.enabled!==!0){if(P(e))return"sensitive-memory-write";if(E(e))return"high-risk-mcp-write";if(A(e))return"runtime-policy"}}function D(e){return typeof e=="object"&&e&&!Array.isArray(e)?e:{input:e}}function $(e,r){if(r==="reject")return Symbol.for("agent-harness.hitl.reject");if(typeof r=="object"&&r&&"decision"in r){const t=r;if(t.decision==="reject")return Symbol.for("agent-harness.hitl.reject");if(t.decision==="edit"&&t.editedInput!==void 0)return t.editedInput}return e}function L(e,r,t,n=R){const c=w(r,t);if(c==="none"||typeof e!="object"||e===null)return e;const o=e,u=async(p,s,f)=>{const a=l({toolName:r.name,schema:o.schema,args:p,requiresApproval:!0});if(!a.ok)return a.error;if(c==="auto-approve")return f(a.input,s);if(c==="auto-reject"||c==="deny-and-continue")return"Tool execution denied by runtime policy.";const i=n({toolName:r.name,toolId:r.id,allowedDecisions:r.hitl?.allow??["approve","edit","reject"],inputPreview:D(a.input),decisionMode:c,...N(r)?{approvalReason:N(r)}:{}}),y=$(a.input,i);return y===Symbol.for("agent-harness.hitl.reject")?"Tool execution rejected by human reviewer.":f(y,s)};return new Proxy(o,{get(p,s,f){const a=Reflect.get(p,s,f);return s==="invoke"&&typeof a=="function"?(i,y)=>u(i,y,(v,g)=>p.invoke(v,g)):s==="call"&&typeof a=="function"?(i,y)=>u(i,y,(v,g)=>p.call(v,g)):s==="func"&&typeof a=="function"?(i,y)=>u(i,y,(v,g)=>p.func(v,g)):a}})}function S(e){return e===null||typeof e!="object"?JSON.stringify(e):Array.isArray(e)?`[${e.map(t=>S(t)).join(",")}]`:`{${Object.entries(e).sort(([t],[n])=>t.localeCompare(n)).map(([t,n])=>`${JSON.stringify(t)}:${S(n)}`).join(",")}}`}function W(e,r){return`${e}:${S(r)}`}function F(e,r){if(!_.has(r.name)||typeof e!="object"||e===null)return e;const t=e,n=new Map,c=(o,u,p)=>{const s=W(r.name,o),f=n.get(s);if(f)return f;const a=Promise.resolve(p(o,u)).catch(i=>{throw n.delete(s),i});return n.set(s,a),a};return new Proxy(t,{get(o,u,p){const s=Reflect.get(o,u,p);return u==="invoke"&&typeof s=="function"?(f,a)=>c(f,a,(i,y)=>o.invoke(i,y)):u==="call"&&typeof s=="function"?(f,a)=>c(f,a,(i,y)=>o.call(i,y)):u==="func"&&typeof s=="function"?(f,a)=>c(f,a,(i,y)=>o.func(i,y)):s}})}function K(e){return e.type!=="mcp"}function M(e,r,t){const n=t?.harnessRuntime.workspaceRoot;if(!n||typeof e!="object"||!e||Array.isArray(e)||!K(r))return e;const c={...e};for(const[o,u]of Object.entries(c)){if(!I.has(o)||typeof u!="string")continue;const p=u.trim();if(!p||/^[a-z]+:\/\//i.test(p))continue;const s=m.resolve(n,p),f=m.relative(n,s);if(f.startsWith("..")||m.isAbsolute(f)){if(O.has(o)){c[o]=n;continue}throw new Error(`Tool ${r.name} input ${o} resolves outside the workspace root`)}}return c}function J(e,r,t,n=R){const c=typeof e=="object"&&e!==null?new Proxy(e,{get(o,u,p){const s=Reflect.get(o,u,p);return u==="invoke"&&typeof s=="function"?(f,a)=>{const i=l({toolName:r.name,schema:o.schema,args:f,requiresApproval:w(r,t)!=="none"});return i.ok?o.invoke(M(i.input,r,t),a):i.error}:u==="call"&&typeof s=="function"?(f,a)=>{const i=l({toolName:r.name,schema:o.schema,args:f,requiresApproval:w(r,t)!=="none"});return i.ok?o.call(M(i.input,r,t),a):i.error}:u==="func"&&typeof s=="function"?(f,a)=>{const i=l({toolName:r.name,schema:o.schema,args:f,requiresApproval:w(r,t)!=="none"});return i.ok?o.func(M(i.input,r,t),a):i.error}:s}}):e;return F(L(c,r,t,n),r)}export{w as resolveToolApprovalDecisionMode,U as toolRequiresRuntimeApproval,J as wrapToolForExecution,L as wrapToolForHumanInTheLoop};

package/dist/runtime/adapter/tool/tool-name-mapping.js

@@ -1,128 +1 @@
-const MODEL_SAFE_TOOL_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
-const PROVIDER_TOOL_CALL_PREFIXES = ["tool_call_", "tool_call.", "tool_call-", "tool.call_", "tool.call.", "tool-call-"];
-export function stripProviderToolCallPrefix(toolName) {
-    const trimmed = toolName.trim();
-    for (const prefix of PROVIDER_TOOL_CALL_PREFIXES) {
-        if (trimmed.startsWith(prefix)) {
-            return trimmed.substring(prefix.length);
-        }
-    }
-    return null;
-}
-export function createProviderToolCallAliasName(toolName) {
-    return `tool_call_${sanitizeToolNameForModel(toolName)}`;
-}
-export function sanitizeToolNameForModel(name) {
-    const withoutNamespace = name.includes(".") ? name.split(".").at(-1) ?? name : name;
-    const sanitized = withoutNamespace
-        .replaceAll(".", "__")
-        .replace(/[^a-zA-Z0-9_-]+/g, "_")
-        .replace(/^_+|_+$/g, "");
-    return sanitized || "tool";
-}
-export function buildToolNameMapping(tools) {
-    const originalToModelFacing = new Map();
-    const modelFacingToOriginal = new Map();
-    const seen = new Set();
-    for (const tool of tools) {
-        const originalName = tool.name;
-        const baseName = MODEL_SAFE_TOOL_NAME_PATTERN.test(originalName) ? originalName : sanitizeToolNameForModel(originalName);
-        let candidate = baseName;
-        let suffix = 2;
-        while (seen.has(candidate)) {
-            candidate = `${baseName}_${suffix}`;
-            suffix += 1;
-        }
-        seen.add(candidate);
-        originalToModelFacing.set(originalName, candidate);
-        modelFacingToOriginal.set(candidate, originalName);
-    }
-    return { originalToModelFacing, modelFacingToOriginal };
-}
-export function createModelFacingToolNameCandidates(toolName) {
-    const trimmed = toolName.trim();
-    if (!trimmed) {
-        return [];
-    }
-    const lastSegment = trimmed.split(".").at(-1) ?? "";
-    const candidates = new Set([
-        trimmed,
-        sanitizeToolNameForModel(trimmed),
-        lastSegment,
-        lastSegment.trim() ? sanitizeToolNameForModel(lastSegment) : "",
-        trimmed.replace(/[^a-zA-Z0-9_]+/g, ""),
-    ]);
-    candidates.delete("");
-    return [...candidates];
-}
-export function createModelFacingToolNameLookupCandidates(toolName) {
-    const trimmed = toolName.trim();
-    if (!trimmed) {
-        return [];
-    }
-    const candidates = new Set();
-    const add = (value) => {
-        for (const candidate of createModelFacingToolNameCandidates(value)) {
-            candidates.add(candidate);
-        }
-    };
-    const addSuffixStripped = (value) => {
-        const stripped = value.includes(".") ? value.split(".").at(-1) ?? value : value;
-        if (stripped !== value) {
-            add(stripped);
-        }
-    };
-    const addProviderPrefixStripped = (value) => {
-        const stripped = stripProviderToolCallPrefix(value);
-        if (stripped) {
-            add(stripped);
-            addSuffixStripped(stripped);
-        }
-    };
-    add(trimmed);
-    addProviderPrefixStripped(trimmed);
-    if (trimmed.startsWith("functions.")) {
-        const stripped = trimmed.substring("functions.".length);
-        add(stripped);
-        addSuffixStripped(stripped);
-        addProviderPrefixStripped(stripped);
-    }
-    else if (trimmed.startsWith("function.")) {
-        const stripped = trimmed.substring("function.".length);
-        add(stripped);
-        addSuffixStripped(stripped);
-        addProviderPrefixStripped(stripped);
-    }
-    else {
-        addSuffixStripped(trimmed);
-    }
-    return [...candidates];
-}
-export function resolveModelFacingToolName(toolName, mapping, tools) {
-    const candidateNames = createModelFacingToolNameLookupCandidates(toolName);
-    const candidateSet = new Set(candidateNames);
-    for (const candidate of candidateNames) {
-        const mappedToolName = mapping.modelFacingToOriginal.get(candidate);
-        if (mappedToolName) {
-            return mappedToolName;
-        }
-    }
-    for (const candidate of candidateNames) {
-        const directMatch = tools.find((tool) => tool.name === candidate);
-        if (directMatch) {
-            return directMatch.name;
-        }
-    }
-    const candidateMatches = tools.filter((tool) => {
-        const modelFacingCandidates = createModelFacingToolNameCandidates(tool.name);
-        return modelFacingCandidates.some((candidate) => candidateSet.has(candidate));
-    });
-    if (candidateMatches.length === 1) {
-        return candidateMatches[0].name;
-    }
-    const providerPrefixStripped = stripProviderToolCallPrefix(toolName);
-    if (providerPrefixStripped) {
-        return sanitizeToolNameForModel(providerPrefixStripped);
-    }
-    return toolName;
-}
+const u=/^[a-zA-Z0-9_-]+$/,m=["tool_call_","tool_call.","tool_call-","tool.call_","tool.call.","tool-call-"];function f(o){const t=o.trim();for(const i of m)if(t.startsWith(i))return t.substring(i.length);return null}function _(o){return`tool_call_${l(o)}`}function l(o){return(o.includes(".")?o.split(".").at(-1)??o:o).replaceAll(".","__").replace(/[^a-zA-Z0-9_-]+/g,"_").replace(/^_+|_+$/g,"")||"tool"}function T(o){const t=new Map,i=new Map,a=new Set;for(const c of o){const r=c.name,e=u.test(r)?r:l(r);let n=e,s=2;for(;a.has(n);)n=`${e}_${s}`,s+=1;a.add(n),t.set(r,n),i.set(n,r)}return{originalToModelFacing:t,modelFacingToOriginal:i}}function p(o){const t=o.trim();if(!t)return[];const i=t.split(".").at(-1)??"",a=new Set([t,l(t),i,i.trim()?l(i):"",t.replace(/[^a-zA-Z0-9_]+/g,"")]);return a.delete(""),[...a]}function g(o){const t=o.trim();if(!t)return[];const i=new Set,a=e=>{for(const n of p(e))i.add(n)},c=e=>{const n=e.includes(".")?e.split(".").at(-1)??e:e;n!==e&&a(n)},r=e=>{const n=f(e);n&&(a(n),c(n))};if(a(t),r(t),t.startsWith("functions.")){const e=t.substring(10);a(e),c(e),r(e)}else if(t.startsWith("function.")){const e=t.substring(9);a(e),c(e),r(e)}else c(t);return[...i]}function h(o,t,i){const a=g(o),c=new Set(a);for(const n of a){const s=t.modelFacingToOriginal.get(n);if(s)return s}for(const n of a){const s=i.find(d=>d.name===n);if(s)return s.name}const r=i.filter(n=>p(n.name).some(d=>c.has(d)));if(r.length===1)return r[0].name;const e=f(o);return e?l(e):o}export{T as buildToolNameMapping,p as createModelFacingToolNameCandidates,g as createModelFacingToolNameLookupCandidates,_ as createProviderToolCallAliasName,h as resolveModelFacingToolName,l as sanitizeToolNameForModel,f as stripProviderToolCallPrefix};

package/dist/runtime/adapter/tool/tool-output-artifacts.js

@@ -1,88 +1,2 @@
-function asRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value)
-        ? value
-        : undefined;
-}
-function toSerializedToolOutput(output) {
-    if (typeof output === "string") {
-        return output;
-    }
-    try {
-        return JSON.stringify(output, null, 2);
-    }
-    catch {
-        return String(output);
-    }
-}
-function truncatePreview(text, maxChars) {
-    if (text.length <= maxChars) {
-        return text;
-    }
-    return `${text.slice(0, Math.max(0, maxChars - 15))}\n...[truncated]`;
-}
-function sanitizeArtifactToolName(toolName) {
-    return toolName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "tool";
-}
-export function resolveToolRuntimeContext(toolConfig, fallback) {
-    const dynamic = asRecord(toolConfig?.toolRuntimeContext);
-    const configurable = asRecord(toolConfig?.configurable);
-    const fallbackRuntime = asRecord(asRecord(fallback)?.runtime);
-    const fallbackCurrent = asRecord(fallbackRuntime?.current);
-    const resolved = (dynamic ?? fallback);
-    const runtime = asRecord(resolved?.runtime);
-    if (!runtime) {
-        return resolved;
-    }
-    return {
-        ...resolved,
-        runtime: {
-            ...runtime,
-            current: {
-                ...fallbackCurrent,
-                ...asRecord(runtime.current),
-                ...(typeof configurable?.thread_id === "string" ? { sessionId: configurable.thread_id } : {}),
-                ...(typeof configurable?.request_id === "string" ? { requestId: configurable.request_id } : {}),
-            },
-        },
-    };
-}
-export async function maybePersistLargeToolOutput(input) {
-    const maxInlineChars = input.maxInlineChars ?? 12_000;
-    const previewChars = input.previewChars ?? 2_000;
-    const serialized = toSerializedToolOutput(input.output);
-    if (serialized.length <= maxInlineChars) {
-        return input.output;
-    }
-    const runtimeContext = input.toolRuntimeContext;
-    const runtime = runtimeContext?.runtime;
-    const sessionId = runtime?.current?.sessionId;
-    const requestId = runtime?.current?.requestId;
-    const createArtifact = runtime?.artifacts?.create;
-    const createdAt = new Date().toISOString();
-    const safeToolName = sanitizeArtifactToolName(input.toolName);
-    let artifact;
-    if (typeof createArtifact === "function" && typeof sessionId === "string" && typeof requestId === "string") {
-        artifact = await Promise.resolve(createArtifact({
-            sessionId,
-            requestId,
-            kind: "tool-output",
-            path: `artifacts/tool-output-${safeToolName}-${Date.now()}.json`,
-            createdAt,
-            content: {
-                toolName: input.toolName,
-                createdAt,
-                output: input.output,
-            },
-        }));
-    }
-    return {
-        truncated: true,
-        toolName: input.toolName,
-        message: artifact
-            ? "Full tool output was stored as a request artifact because it exceeded the inline size limit."
-            : "Tool output exceeded the inline size limit and was truncated for runtime stability.",
-        originalSizeChars: serialized.length,
-        preview: truncatePreview(serialized, previewChars),
-        ...(artifact ? { artifact } : {}),
-    };
-}
+function n(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)?t:void 0}function m(t){if(typeof t=="string")return t;try{return JSON.stringify(t,null,2)}catch{return String(t)}}function g(t,r){return t.length<=r?t:`${t.slice(0,Math.max(0,r-15))}
+...[truncated]`}function y(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||"tool"}function h(t,r){const u=n(t?.toolRuntimeContext),e=n(t?.configurable),c=n(n(r)?.runtime),s=n(c?.current),o=u??r,i=n(o?.runtime);return i?{...o,runtime:{...i,current:{...s,...n(i.current),...typeof e?.thread_id=="string"?{sessionId:e.thread_id}:{},...typeof e?.request_id=="string"?{requestId:e.request_id}:{}}}}:o}async function p(t){const r=t.maxInlineChars??12e3,u=t.previewChars??2e3,e=m(t.output);if(e.length<=r)return t.output;const s=t.toolRuntimeContext?.runtime,o=s?.current?.sessionId,i=s?.current?.requestId,l=s?.artifacts?.create,f=new Date().toISOString(),d=y(t.toolName);let a;return typeof l=="function"&&typeof o=="string"&&typeof i=="string"&&(a=await Promise.resolve(l({sessionId:o,requestId:i,kind:"tool-output",path:`artifacts/tool-output-${d}-${Date.now()}.json`,createdAt:f,content:{toolName:t.toolName,createdAt:f,output:t.output}}))),{truncated:!0,toolName:t.toolName,message:a?"Full tool output was stored as a request artifact because it exceeded the inline size limit.":"Tool output exceeded the inline size limit and was truncated for runtime stability.",originalSizeChars:e.length,preview:g(e,u),...a?{artifact:a}:{}}}export{p as maybePersistLargeToolOutput,h as resolveToolRuntimeContext};

package/dist/runtime/adapter/tool/tool-replay.js

@@ -1,37 +1 @@
-import { createModelFacingToolNameLookupCandidates, resolveModelFacingToolName } from "./tool-name-mapping.js";
-import { isLangChainBinding } from "../../support/compiled-binding.js";
-const DEEPAGENTS_LOCAL_REPLAY_COMPATIBILITY_TOOLS = new Set([
-    "write_todos",
-    "read_todos",
-    "ls",
-    "read_file",
-    "write_file",
-    "edit_file",
-    "glob",
-    "grep",
-    "execute",
-]);
-function isDeepAgentsLocalReplayCompatibilityTool(toolName) {
-    return DEEPAGENTS_LOCAL_REPLAY_COMPATIBILITY_TOOLS.has(toolName.trim().toLowerCase());
-}
-export function canReplayToolCallsLocally(binding, toolCalls, primaryTools, toolNameMapping, executableTools, builtinExecutableTools) {
-    if (toolCalls.length === 0) {
-        return false;
-    }
-    if (isLangChainBinding(binding)) {
-        return true;
-    }
-    return toolCalls.every((toolCall) => {
-        const resolvedToolName = resolveModelFacingToolName(toolCall.name, toolNameMapping, primaryTools);
-        if (!isDeepAgentsLocalReplayCompatibilityTool(toolCall.name)
-            && !isDeepAgentsLocalReplayCompatibilityTool(resolvedToolName)) {
-            return false;
-        }
-        const builtinExecutable = builtinExecutableTools.get(toolCall.name) ??
-            builtinExecutableTools.get(resolvedToolName) ??
-            createModelFacingToolNameLookupCandidates(toolCall.name)
-                .map((candidate) => builtinExecutableTools.get(candidate))
-                .find((candidate) => candidate !== undefined);
-        return builtinExecutable !== undefined;
-    });
-}
+import{createModelFacingToolNameLookupCandidates as s,resolveModelFacingToolName as m}from"./tool-name-mapping.js";import{isLangChainBinding as u}from"../../support/compiled-binding.js";const c=new Set(["write_todos","read_todos","ls","read_file","write_file","edit_file","glob","grep","execute"]);function a(n){return c.has(n.trim().toLowerCase())}function _(n,i,d,f,l,t){return i.length===0?!1:u(n)?!0:i.every(e=>{const o=m(e.name,f,d);return!a(e.name)&&!a(o)?!1:(t.get(e.name)??t.get(o)??s(e.name).map(r=>t.get(r)).find(r=>r!==void 0))!==void 0})}export{_ as canReplayToolCallsLocally};