@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/runtime/parsing/output-recovery.js

@@ -1,213 +1,3 @@
-import { EXECUTION_WITH_TOOL_EVIDENCE_RETRY_INSTRUCTION, INTERNAL_RUNTIME_SPILL_PATH_INSTRUCTION, REQUIRED_EXECUTION_CONTINUATION_INSTRUCTION, STRICT_TOOL_JSON_INSTRUCTION, WORKSPACE_RELATIVE_PATH_INSTRUCTION, WRITE_TODOS_FULL_ENTRY_INSTRUCTION, WRITE_TODOS_NON_EMPTY_INITIAL_LIST_INSTRUCTION, WRITE_TODOS_REQUIRED_PLAN_INSTRUCTION, } from "../prompts/runtime-prompts.js";
-import { wrapNormalizedMessage, readTextContent } from "./output-content.js";
-import { salvageJsonToolCalls } from "./output-tool-args.js";
-function collectRequestMessages(request) {
-    if (typeof request !== "object" || !request || Array.isArray(request)) {
-        return [];
-    }
-    const typed = request;
-    return Array.isArray(typed.messages)
-        ? typed.messages.filter((message) => typeof message === "object" && !!message && !Array.isArray(message))
-        : [];
-}
-function readMessageRole(message) {
-    return typeof message.role === "string" ? message.role.trim().toLowerCase() : "";
-}
-function readLatestUserRequestText(request) {
-    const messages = collectRequestMessages(request);
-    for (let index = messages.length - 1; index >= 0; index -= 1) {
-        const message = messages[index];
-        if (readMessageRole(message) !== "user") {
-            continue;
-        }
-        const content = readTextContent(message.content).trim();
-        if (content) {
-            return content;
-        }
-    }
-    return "";
-}
-function readSystemInstructionText(request) {
-    return collectRequestMessages(request)
-        .filter((message) => readMessageRole(message) === "system")
-        .map((message) => readTextContent(message.content).trim())
-        .filter(Boolean)
-        .join("\n\n");
-}
-function isToolCallParseFailure(error) {
-    return error instanceof Error && /error parsing tool call:/i.test(error.message);
-}
-function isStructuredValidationIssue(value) {
-    if (typeof value !== "object" || !value || Array.isArray(value))
-        return false;
-    const typed = value;
-    return typeof typed.code === "string" && Array.isArray(typed.path) && (typed.message === undefined || typeof typed.message === "string");
-}
-export function isToolCallValidationFailure(error) {
-    if (!(error instanceof Error))
-        return false;
-    const message = error.message.trim();
-    if (!message)
-        return false;
-    try {
-        const direct = JSON.parse(message);
-        if (Array.isArray(direct) && direct.length > 0 && direct.every((issue) => isStructuredValidationIssue(issue) && issue.path.length > 0)) {
-            return true;
-        }
-    }
-    catch { }
-    if (/Invalid input:\s*expected .* received undefined/i.test(message) && /"path"\s*:\s*\[/.test(message)) {
-        return true;
-    }
-    return /Received tool input did not match expected schema/i.test(message)
-        && (/(?:→\s*at|at)\s+[\w[\].]+/i.test(message) || /\bDetails:/i.test(message));
-}
-function collectErrorMessages(error) {
-    if (!error)
-        return [];
-    if (error instanceof Error) {
-        const nested = Array.isArray(error.errors)
-            ? (error.errors ?? []).flatMap((item) => collectErrorMessages(item))
-            : [];
-        return [error.message, ...nested].filter((value) => typeof value === "string" && value.trim().length > 0);
-    }
-    if (typeof error === "string" && error.trim().length > 0)
-        return [error];
-    if (typeof error === "object") {
-        const record = error;
-        return [record.message, record.error, record.details].flatMap((item) => collectErrorMessages(item));
-    }
-    return [];
-}
-export function isWorkspacePathScopeFailure(error) {
-    return collectErrorMessages(error).some((message) => /outside the workspace root|workspace-relative path/i.test(message));
-}
-export function isInternalRuntimeSpillPathFailure(error) {
-    return collectErrorMessages(error).some((message) => /\/large_tool_results\/|internal runtime spill path/i.test(message));
-}
-export function isRepairableWriteTodosContentFailure(error) {
-    return error instanceof Error && /write_todos/i.test(error.message) && /todos\[\d+\]\.content/i.test(error.message);
-}
-export function isRepairableWriteTodosEmptyFailure(error) {
-    return error instanceof Error && /write_todos/i.test(error.message) && /Initial write_todos call cannot use an empty todo list/i.test(error.message);
-}
-export function isToolCallRecoveryFailure(error) {
-    return (isToolCallParseFailure(error) ||
-        isToolCallValidationFailure(error) ||
-        isRepairableWriteTodosEmptyFailure(error) ||
-        isInternalRuntimeSpillPathFailure(error) ||
-        isWorkspacePathScopeFailure(error));
-}
-export function isRetrySafeInvalidToolSelectionError(value) {
-    const text = readTextContent(value).trim();
-    return !!text && /is not a valid tool, try one of \[/i.test(text);
-}
-export function shouldValidateExecutionWithoutToolEvidence(request) {
-    const userText = readLatestUserRequestText(request);
-    if (userText) {
-        return true;
-    }
-    return readSystemInstructionText(request).length > 0;
-}
-export function resolveMissingPlanRecoveryInstruction(params) {
-    const hasPlanEvidence = params.hasWriteTodosEvidence === true
-        || params.hasPlanStateEvidence === true;
-    if (params.requiresPlan !== true || hasPlanEvidence) {
-        return null;
-    }
-    return WRITE_TODOS_REQUIRED_PLAN_INSTRUCTION;
-}
-export function resolveExecutionWithoutToolEvidenceInstruction(request, result) {
-    const assistantText = readTextContent(result).trim();
-    return resolveExecutionWithoutToolEvidenceTextInstruction(request, assistantText, false, {});
-}
-export function resolveExecutionWithoutToolEvidenceTextInstruction(request, assistantText, toolCallEvidence = false, resultEvidence = {}) {
-    if (!shouldValidateExecutionWithoutToolEvidence(request)) {
-        return null;
-    }
-    const normalizedText = assistantText.trim();
-    const missingPlanRecoveryInstruction = resolveMissingPlanRecoveryInstruction({
-        request,
-        assistantText: normalizedText,
-        requiresPlan: resultEvidence.requiresPlan,
-        hasWriteTodosEvidence: resultEvidence.hasWriteTodosEvidence,
-        hasPlanStateEvidence: resultEvidence.hasIncompletePlanState === true || resultEvidence.hasPlanStateEvidence === true,
-        hasToolResultEvidence: resultEvidence.hasToolResultEvidence,
-    });
-    if (missingPlanRecoveryInstruction) {
-        return missingPlanRecoveryInstruction;
-    }
-    const hasUnfinishedExecution = resultEvidence.hasIncompletePlanState === true
-        || resultEvidence.hasOpenTaskDelegation === true
-        || resultEvidence.hasMissingDelegatedExecutionEvidence === true;
-    if (salvageJsonToolCalls(normalizedText).length > 0) {
-        return STRICT_TOOL_JSON_INSTRUCTION;
-    }
-    const hasExecutionEvidence = toolCallEvidence
-        || resultEvidence.hasWriteTodosEvidence === true
-        || resultEvidence.hasToolResultEvidence === true;
-    if (!normalizedText || !hasUnfinishedExecution) {
-        return null;
-    }
-    return hasExecutionEvidence ? REQUIRED_EXECUTION_CONTINUATION_INSTRUCTION : null;
-}
-export function resolveToolCallRecoveryInstruction(error) {
-    if (isRepairableWriteTodosEmptyFailure(error))
-        return WRITE_TODOS_NON_EMPTY_INITIAL_LIST_INSTRUCTION;
-    if (isRepairableWriteTodosContentFailure(error))
-        return WRITE_TODOS_FULL_ENTRY_INSTRUCTION;
-    if (isInternalRuntimeSpillPathFailure(error))
-        return INTERNAL_RUNTIME_SPILL_PATH_INSTRUCTION;
-    if (isWorkspacePathScopeFailure(error))
-        return WORKSPACE_RELATIVE_PATH_INSTRUCTION;
-    if (isToolCallRecoveryFailure(error))
-        return STRICT_TOOL_JSON_INSTRUCTION;
-    return null;
-}
-export function appendToolRecoveryInstruction(input, instruction) {
-    if (Array.isArray(input)) {
-        return [...input, { role: "system", content: instruction }];
-    }
-    if (typeof input === "object" && input && Array.isArray(input.messages)) {
-        return {
-            ...input,
-            messages: [...(input.messages), { role: "system", content: instruction }],
-        };
-    }
-    return input;
-}
-export function wrapResolvedModel(value) {
-    if (typeof value !== "object" || value === null)
-        return value;
-    const target = value;
-    return new Proxy(target, {
-        get(currentTarget, prop, receiver) {
-            const member = Reflect.get(currentTarget, prop, receiver);
-            if (prop === "invoke" && typeof member === "function") {
-                return async (...args) => {
-                    let activeArgs = [...args];
-                    for (let attempt = 0; attempt < 3; attempt += 1) {
-                        try {
-                            return wrapNormalizedMessage(await member.apply(currentTarget, activeArgs));
-                        }
-                        catch (error) {
-                            const recoveryInstruction = resolveToolCallRecoveryInstruction(error);
-                            if (!recoveryInstruction || attempt === 2) {
-                                throw error;
-                            }
-                            activeArgs = [...activeArgs];
-                            activeArgs[0] = appendToolRecoveryInstruction(activeArgs[0], attempt === 0 ? recoveryInstruction : EXECUTION_WITH_TOOL_EVIDENCE_RETRY_INSTRUCTION);
-                        }
-                    }
-                    throw new Error("Model invocation retry loop exited unexpectedly.");
-                };
-            }
-            if ((prop === "bindTools" || prop === "withConfig" || prop === "withStructuredOutput") && typeof member === "function") {
-                return (...args) => wrapResolvedModel(member.apply(currentTarget, args));
-            }
-            if (typeof member === "function")
-                return member.bind(currentTarget);
-            return member;
-        },
-    });
-}
+import{EXECUTION_WITH_TOOL_EVIDENCE_RETRY_INSTRUCTION as E,INTERNAL_RUNTIME_SPILL_PATH_INSTRUCTION as g,REQUIRED_EXECUTION_CONTINUATION_INSTRUCTION as R,STRICT_TOOL_JSON_INSTRUCTION as d,WORKSPACE_RELATIVE_PATH_INSTRUCTION as _,WRITE_TODOS_FULL_ENTRY_INSTRUCTION as x,WRITE_TODOS_NON_EMPTY_INITIAL_LIST_INSTRUCTION as N,WRITE_TODOS_REQUIRED_PLAN_INSTRUCTION as S}from"../prompts/runtime-prompts.js";import{wrapNormalizedMessage as O,readTextContent as c}from"./output-content.js";import{salvageJsonToolCalls as A}from"./output-tool-args.js";function y(t){if(typeof t!="object"||!t||Array.isArray(t))return[];const e=t;return Array.isArray(e.messages)?e.messages.filter(n=>typeof n=="object"&&!!n&&!Array.isArray(n)):[]}function p(t){return typeof t.role=="string"?t.role.trim().toLowerCase():""}function C(t){const e=y(t);for(let n=e.length-1;n>=0;n-=1){const r=e[n];if(p(r)!=="user")continue;const i=c(r.content).trim();if(i)return i}return""}function v(t){return y(t).filter(e=>p(e)==="system").map(e=>c(e.content).trim()).filter(Boolean).join(`
+
+`)}function P(t){return t instanceof Error&&/error parsing tool call:/i.test(t.message)}function U(t){if(typeof t!="object"||!t||Array.isArray(t))return!1;const e=t;return typeof e.code=="string"&&Array.isArray(e.path)&&(e.message===void 0||typeof e.message=="string")}function w(t){if(!(t instanceof Error))return!1;const e=t.message.trim();if(!e)return!1;try{const n=JSON.parse(e);if(Array.isArray(n)&&n.length>0&&n.every(r=>U(r)&&r.path.length>0))return!0}catch{}return/Invalid input:\s*expected .* received undefined/i.test(e)&&/"path"\s*:\s*\[/.test(e)?!0:/Received tool input did not match expected schema/i.test(e)&&(/(?:→\s*at|at)\s+[\w[\].]+/i.test(e)||/\bDetails:/i.test(e))}function u(t){if(!t)return[];if(t instanceof Error){const e=Array.isArray(t.errors)?(t.errors??[]).flatMap(n=>u(n)):[];return[t.message,...e].filter(n=>typeof n=="string"&&n.trim().length>0)}if(typeof t=="string"&&t.trim().length>0)return[t];if(typeof t=="object"){const e=t;return[e.message,e.error,e.details].flatMap(n=>u(n))}return[]}function I(t){return u(t).some(e=>/outside the workspace root|workspace-relative path/i.test(e))}function m(t){return u(t).some(e=>/\/large_tool_results\/|internal runtime spill path/i.test(e))}function W(t){return t instanceof Error&&/write_todos/i.test(t.message)&&/todos\[\d+\]\.content/i.test(t.message)}function h(t){return t instanceof Error&&/write_todos/i.test(t.message)&&/Initial write_todos call cannot use an empty todo list/i.test(t.message)}function L(t){return P(t)||w(t)||h(t)||m(t)||I(t)}function Y(t){const e=c(t).trim();return!!e&&/is not a valid tool, try one of \[/i.test(e)}function b(t){return C(t)?!0:v(t).length>0}function M(t){const e=t.hasWriteTodosEvidence===!0||t.hasPlanStateEvidence===!0;return t.requiresPlan!==!0||e?null:S}function z(t,e){const n=c(e).trim();return D(t,n,!1,{})}function D(t,e,n=!1,r={}){if(!b(t))return null;const i=e.trim(),o=M({request:t,assistantText:i,requiresPlan:r.requiresPlan,hasWriteTodosEvidence:r.hasWriteTodosEvidence,hasPlanStateEvidence:r.hasIncompletePlanState===!0||r.hasPlanStateEvidence===!0,hasToolResultEvidence:r.hasToolResultEvidence});if(o)return o;const a=r.hasIncompletePlanState===!0||r.hasOpenTaskDelegation===!0||r.hasMissingDelegatedExecutionEvidence===!0;if(A(i).length>0)return d;const s=n||r.hasWriteTodosEvidence===!0||r.hasToolResultEvidence===!0;return!i||!a?null:s?R:null}function F(t){return h(t)?N:W(t)?x:m(t)?g:I(t)?_:L(t)?d:null}function j(t,e){return Array.isArray(t)?[...t,{role:"system",content:e}]:typeof t=="object"&&t&&Array.isArray(t.messages)?{...t,messages:[...t.messages,{role:"system",content:e}]}:t}function k(t){if(typeof t!="object"||t===null)return t;const e=t;return new Proxy(e,{get(n,r,i){const o=Reflect.get(n,r,i);return r==="invoke"&&typeof o=="function"?async(...a)=>{let s=[...a];for(let l=0;l<3;l+=1)try{return O(await o.apply(n,s))}catch(f){const T=F(f);if(!T||l===2)throw f;s=[...s],s[0]=j(s[0],l===0?T:E)}throw new Error("Model invocation retry loop exited unexpectedly.")}:(r==="bindTools"||r==="withConfig"||r==="withStructuredOutput")&&typeof o=="function"?(...a)=>k(o.apply(n,a)):typeof o=="function"?o.bind(n):o}})}export{j as appendToolRecoveryInstruction,m as isInternalRuntimeSpillPathFailure,W as isRepairableWriteTodosContentFailure,h as isRepairableWriteTodosEmptyFailure,Y as isRetrySafeInvalidToolSelectionError,L as isToolCallRecoveryFailure,w as isToolCallValidationFailure,I as isWorkspacePathScopeFailure,z as resolveExecutionWithoutToolEvidenceInstruction,D as resolveExecutionWithoutToolEvidenceTextInstruction,M as resolveMissingPlanRecoveryInstruction,F as resolveToolCallRecoveryInstruction,b as shouldValidateExecutionWithoutToolEvidence,k as wrapResolvedModel};