@cydm/pie 1.0.51 → 2.1.0

package/dist/chunks/{chunk-A644H2XX.js → chunk-PMPD56N2.js}

@@ -1,17 +1,19 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   Agent
-} from "./chunk-B3SMW2XW.js";
+} from "./chunk-QJH6YN2W.js";
 import {
   FileSystemGateway,
-  Type,
   completeSimple,
   detectPlatform,
   getFileSystem,
   getPlatformConfig,
   hashText,
   streamSimple
-} from "./chunk-S2J3SZZX.js";
+} from "./chunk-IM43UYVV.js";
+import {
+  Type
+} from "./chunk-XXGYUYXI.js";
 import {
   __commonJS,
   __toESM
@@ -6254,7 +6256,10 @@ async function askSingleQuestion(args) {
     if (response.type === "multiline_input" && (response.skipped || response.timedOut)) {
       return buildSkippedResult(question, response.timedOut === true);
     }
-    const answer = response.type === "multiline_input" ? response.value : void 0;
+    const answer = response.type === "multiline_input" ? response.value?.trim() : void 0;
+    if (answer === "") {
+      return buildSkippedResult(question, false);
+    }
     if (answer === void 0) {
       return { content: [{ type: "text", text: "User cancelled" }], details: { cancelled: true } };
     }
@@ -6272,7 +6277,12 @@ async function askSingleQuestion(args) {
     id: `ask-user:select:${Date.now()}`,
     prompt: question,
     options: displayOptions,
-    timeoutMs: DEFAULT_ASK_TIMEOUT_MS
+    timeoutMs: DEFAULT_ASK_TIMEOUT_MS,
+    // Tab-style navigation for hosts that support it: ← at the first page
+    // selects Back, → at the last page selects Review (row presence mirrors
+    // allowBack/allowReview). Hosts without shortcut support ignore these.
+    leftShortcut: allowBack ? BACK_OPTION : void 0,
+    rightShortcut: allowReview ? REVIEW_OPTION : void 0
   });
   if (selection.type === "select_one" && (selection.skipped || selection.timedOut)) {
     return buildSkippedResult(question, selection.timedOut === true);
@@ -6297,7 +6307,10 @@ async function askSingleQuestion(args) {
     if (response.type === "text_input" && (response.skipped || response.timedOut)) {
       return buildSkippedResult(question, response.timedOut === true);
     }
-    const customAnswer = response.type === "text_input" ? response.value : void 0;
+    const customAnswer = response.type === "text_input" ? response.value?.trim() : void 0;
+    if (customAnswer === "") {
+      return buildSkippedResult(question, false);
+    }
     if (customAnswer === void 0) {
       return { content: [{ type: "text", text: "User cancelled" }], details: { cancelled: true } };
     }
@@ -6377,8 +6390,11 @@ function createAskUserCapability() {
             }
             answers[q.id] = {
               question: q.question,
-              answer: result.details?.answer || result.content[0].text,
-              ...result.details
+              ...result.details,
+              // After the spread: `answer` wins over the same spread key, and
+              // `??` preserves intentional values (`||` let "" re-clobber the
+              // fallback — a latent trap for any falsy answer).
+              answer: result.details?.answer ?? result.content[0].text
             };
             currentIndex++;
           }
@@ -6387,7 +6403,7 @@ function createAskUserCapability() {
               const reviewOptions = [
                 CONFIRM_OPTION,
                 ...questions.map((q2, i) => {
-                  const answer = answers[q2.id]?.answer || "(not answered)";
+                  const answer = answers[q2.id]?.answer ?? "(not answered)";
                   const displayAnswer = answer.length > 20 ? `${answer.substring(0, 20)}...` : answer;
                   return `\u270F\uFE0F Q${i + 1}: ${displayAnswer}`;
                 }),
@@ -6441,8 +6457,8 @@ function createAskUserCapability() {
               }
               answers[q.id] = {
                 question: q.question,
-                answer: result.details?.answer || result.content[0].text,
-                ...result.details
+                ...result.details,
+                answer: result.details?.answer ?? result.content[0].text
               };
             }
           }
@@ -11651,6 +11667,13 @@ function getModelLabel(model) {
 function textFromAssistant(message) {
   return message.content.filter((block) => block.type === "text").map((block) => block.text).join("\n").trim();
 }
+function classifyUnderstandingFailure(message) {
+  if (/\b40[123]\b|payment required|insufficient[ _-]?balance|arrearage|余额|quota/i.test(message)) return "auth_or_balance";
+  if (/\b429\b|rate.?limit|too many requests/i.test(message)) return "rate_limited";
+  if (/timed? ?out|timeout|etimedout/i.test(message)) return "timeout";
+  if (/does not support|unsupported|multimodal|modality|not declare/i.test(message)) return "unsupported";
+  return "provider_error";
+}
 function modalityForReadFileUnderstandingKind(kind) {
   if (kind === "image") return "image";
   if (kind === "video") return "video";
@@ -11683,83 +11706,147 @@ function createReadFileUnderstandingHandler(deps) {
 }
 async function understandFileWithModel(deps, request) {
   const purpose = `read_file.${request.kind}`;
-  const decision = deps.resolveToolModel(purpose);
   const agentModel = deps.getAgentModel();
-  const routeDetails = {
+  const singleDecision = deps.resolveToolModel(purpose);
+  const candidateDecisions = deps.resolveToolModelCandidates?.(purpose) ?? [singleDecision];
+  const sessionId = deps.getSessionId() || `read-file-${Date.now()}`;
+  const attempts = [];
+  let sendAttemptCount = 0;
+  const baseRouteDetails = {
     purpose,
-    requiredCapability: decision.requiredCapability,
-    routeSource: decision.routeSource,
+    requiredCapability: singleDecision.requiredCapability,
     agentModel: getModelLabel(agentModel),
-    toolModel: getModelLabel(decision.model),
-    fallbackReason: decision.fallbackReason,
     kind: request.kind,
     mimeType: request.mimeType
   };
-  if (!decision.model || !decision.apiKey) {
+  for (const decision of candidateDecisions) {
+    const attemptBase = { toolModel: getModelLabel(decision.model), routeSource: decision.routeSource };
+    if (!decision.model || !decision.apiKey) {
+      attempts.push({
+        ...attemptBase,
+        failureCategory: "unavailable",
+        fallbackReason: decision.fallbackReason,
+        durationMs: 0
+      });
+      continue;
+    }
+    const startedAt = Date.now();
+    sendAttemptCount += 1;
+    try {
+      const directImageContent = buildDirectImageUnderstandingContent(request);
+      const prepared = directImageContent ? { content: directImageContent, details: { inputMode: "inlineDataUrl" } } : await deps.prepareFileContent({
+        request,
+        model: decision.model,
+        apiKey: decision.apiKey,
+        sessionId
+      });
+      const send = deps.sendUnderstandingRequest ?? completeSimple;
+      const response = await send(
+        decision.model,
+        {
+          systemPrompt: "You are a file-understanding tool. Answer only from the provided file. Keep the answer concise and factual.",
+          messages: [{ role: "user", content: [buildReadFileUnderstandingPrompt(request), ...prepared.content], timestamp: Date.now() }]
+        },
+        {
+          apiKey: decision.apiKey,
+          maxTokens: Math.min(decision.model.maxTokens || 4096, 4096),
+          signal: request.signal
+        }
+      );
+      const errorMessage = response.stopReason === "error" || response.stopReason === "aborted" ? response.errorMessage : void 0;
+      const durationMs = Date.now() - startedAt;
+      if (response.stopReason === "aborted") {
+        attempts.push({ ...attemptBase, failureCategory: "aborted", error: errorMessage, durationMs });
+        return {
+          content: [{ type: "text", text: `read_file ${request.kind} understanding failed: ${errorMessage ?? "aborted"}` }],
+          details: { understanding: { ...baseRouteDetails, ...attemptBase, error: errorMessage, attempts } },
+          isError: true
+        };
+      }
+      if (errorMessage) {
+        attempts.push({
+          ...attemptBase,
+          failureCategory: classifyUnderstandingFailure(errorMessage),
+          error: errorMessage,
+          durationMs
+        });
+        continue;
+      }
+      attempts.push({ ...attemptBase, durationMs });
+      const text = textFromAssistant(response) || "(file understanding model returned no text)";
+      return {
+        content: [{ type: "text", text }],
+        details: {
+          understanding: {
+            ...baseRouteDetails,
+            // Capability follows the candidate that actually served the request,
+            // not the first decision's.
+            requiredCapability: decision.requiredCapability,
+            ...attemptBase,
+            fallbackReason: decision.fallbackReason,
+            responseStopReason: response.stopReason,
+            ...prepared.details,
+            attempts
+          }
+        },
+        isError: false
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      const durationMs = Date.now() - startedAt;
+      if (request.signal?.aborted) {
+        attempts.push({ ...attemptBase, failureCategory: "aborted", error: message, durationMs });
+        return {
+          content: [{ type: "text", text: `read_file ${request.kind} understanding failed: ${message}` }],
+          details: { understanding: { ...baseRouteDetails, ...attemptBase, error: message, attempts } },
+          isError: true
+        };
+      }
+      attempts.push({
+        ...attemptBase,
+        failureCategory: classifyUnderstandingFailure(message),
+        error: message,
+        durationMs
+      });
+    }
+  }
+  const routedAttempts = attempts.filter((attempt) => attempt.toolModel !== void 0);
+  if (routedAttempts.length === 0 || sendAttemptCount === 0) {
     return {
       content: [{
         type: "text",
-        text: decision.fallbackReason || `No configured model declares ${request.kind} capability for ${purpose}.`
+        text: singleDecision.fallbackReason || `No configured model declares ${request.kind} capability for ${purpose}.`
       }],
-      details: { understanding: routeDetails },
-      isError: true
-    };
-  }
-  const sessionId = deps.getSessionId() || `read-file-${Date.now()}`;
-  try {
-    const directImageContent = buildDirectImageUnderstandingContent(request);
-    const prepared = directImageContent ? { content: directImageContent, details: { inputMode: "inlineDataUrl" } } : await deps.prepareFileContent({
-      request,
-      model: decision.model,
-      apiKey: decision.apiKey,
-      sessionId
-    });
-    const fileContent = prepared.content;
-    const content = [
-      buildReadFileUnderstandingPrompt(request),
-      ...fileContent
-    ];
-    const response = await completeSimple(
-      decision.model,
-      {
-        systemPrompt: "You are a file-understanding tool. Answer only from the provided file. Keep the answer concise and factual.",
-        messages: [{ role: "user", content, timestamp: Date.now() }]
-      },
-      {
-        apiKey: decision.apiKey,
-        maxTokens: Math.min(decision.model.maxTokens || 4096, 4096),
-        signal: request.signal
-      }
-    );
-    const errorMessage = response.stopReason === "error" || response.stopReason === "aborted" ? response.errorMessage : void 0;
-    const text = textFromAssistant(response) || (errorMessage ? `read_file ${request.kind} understanding failed: ${errorMessage}` : "(file understanding model returned no text)");
-    return {
-      content: [{ type: "text", text }],
-      details: {
-        understanding: {
-          ...routeDetails,
-          toolModel: getModelLabel(decision.model),
-          responseStopReason: response.stopReason,
-          ...prepared.details,
-          ...errorMessage ? { error: errorMessage } : {}
-        }
-      },
-      isError: response.stopReason === "error" || response.stopReason === "aborted"
-    };
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      content: [{ type: "text", text: `read_file ${request.kind} understanding failed: ${message}` }],
       details: {
         understanding: {
-          ...routeDetails,
-          toolModel: getModelLabel(decision.model),
-          error: message
+          ...baseRouteDetails,
+          toolModel: getModelLabel(singleDecision.model),
+          routeSource: singleDecision.routeSource,
+          fallbackReason: singleDecision.fallbackReason,
+          attempts
         }
       },
       isError: true
     };
   }
+  const lastAttempt = routedAttempts[routedAttempts.length - 1];
+  const viaSegments = attempts.filter((attempt) => attempt.error || attempt.fallbackReason).map((attempt) => `via ${attempt.toolModel ?? "unconfigured route"}: ${attempt.error ?? attempt.fallbackReason}`);
+  const firstFailure = attempts.find((attempt) => attempt.error || attempt.fallbackReason);
+  const combinedError = sendAttemptCount === 1 ? `read_file ${request.kind} understanding failed: ${firstFailure?.error ?? firstFailure?.fallbackReason ?? "unknown error"}` : `read_file ${request.kind} understanding failed after ${sendAttemptCount} route(s): ${viaSegments.join("; ")}`;
+  return {
+    content: [{ type: "text", text: combinedError }],
+    details: {
+      understanding: {
+        ...baseRouteDetails,
+        toolModel: lastAttempt.toolModel,
+        routeSource: lastAttempt.routeSource,
+        fallbackReason: lastAttempt.fallbackReason ?? lastAttempt.error,
+        error: combinedError,
+        attempts
+      }
+    },
+    isError: true
+  };
 }
 
 // ../../packages/shared-headless-capabilities/src/session-trace.ts
@@ -13859,7 +13946,7 @@ function createSharedWebFetchTool(deps = {}) {
         const extractionMethod = isHtml ? "html_readability" : isPdf ? "pdf_text" : "plain_text";
         if (isHtml && looksJavaScriptHeavy(raw, text)) {
           return {
-            content: [{ type: "text", text: `web_fetch could not read meaningful content from ${url}; this page appears to require JavaScript. Use Playwright browser tools for browser-rendered content.` }],
+            content: [{ type: "text", text: `web_fetch could not read meaningful content from ${url}; this page appears to require JavaScript. Use the chrome-devtools-axi skill (or computer-use browser tools) for browser-rendered content.` }],
             details: {
               url,
               sourceUrl: url,

package/dist/chunks/{chunk-B3SMW2XW.js → chunk-QJH6YN2W.js}

@@ -3,7 +3,7 @@ import {
   EventStream,
   streamSimple,
   validateToolArguments
-} from "./chunk-S2J3SZZX.js";
+} from "./chunk-IM43UYVV.js";
 
 // ../../packages/agent-core/src/agent-loop.ts
 function createLoopErrorMessage(error, config, signal) {