@aliou/pi-synthetic 0.16.0 → 0.17.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-synthetic",
-  "version": "0.16.0",
+  "version": "0.17.1",
   "license": "MIT",
   "type": "module",
   "private": false,
@@ -32,18 +32,18 @@
     "README.md"
   ],
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "0.72.0",
-    "@mariozechner/pi-tui": "0.72.0"
+    "@earendil-works/pi-coding-agent": "0.74.0",
+    "@earendil-works/pi-tui": "0.74.0"
   },
   "dependencies": {
-    "@aliou/pi-utils-settings": "^0.13.0",
-    "@aliou/pi-utils-ui": "^0.1.2"
+    "@aliou/pi-utils-settings": "^0.15.0",
+    "@aliou/pi-utils-ui": "^0.4.0"
   },
   "devDependencies": {
     "@aliou/biome-plugins": "^0.7.0",
     "@biomejs/biome": "^2.4.2",
     "@changesets/cli": "^2.27.11",
-    "@mariozechner/pi-coding-agent": "0.72.0",
+    "@earendil-works/pi-coding-agent": "0.74.0",
     "typebox": "^1.1.37",
     "@types/node": "^25.0.10",
     "husky": "^9.1.7",
@@ -51,10 +51,10 @@
     "vitest": "^4.0.18"
   },
   "peerDependenciesMeta": {
-    "@mariozechner/pi-coding-agent": {
+    "@earendil-works/pi-coding-agent": {
       "optional": true
     },
-    "@mariozechner/pi-tui": {
+    "@earendil-works/pi-tui": {
       "optional": true
     }
   },

package/src/config.ts

@@ -4,8 +4,8 @@ import {
   registerSettingsCommand,
   type SettingsSection,
 } from "@aliou/pi-utils-settings";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import type { SettingItem } from "@mariozechner/pi-tui";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { SettingItem } from "@earendil-works/pi-tui";
 import pkg from "../package.json" with { type: "json" };
 
 export type SyntheticFeatureId =

package/src/extensions/command-quotas/command.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { configLoader } from "../../config";
 import { getSyntheticApiKey } from "../../lib/env";
 import { fetchQuotas } from "../../utils/quotas";

package/src/extensions/command-quotas/components/quotas-display.ts

@@ -1,7 +1,7 @@
-import type { Theme } from "@mariozechner/pi-coding-agent";
-import { DynamicBorder } from "@mariozechner/pi-coding-agent";
-import type { Component, TUI } from "@mariozechner/pi-tui";
-import { Loader, matchesKey, truncateToWidth } from "@mariozechner/pi-tui";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { DynamicBorder } from "@earendil-works/pi-coding-agent";
+import type { Component, TUI } from "@earendil-works/pi-tui";
+import { Loader, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
 import type { QuotasResponse } from "../../../types/quotas";
 import {
   assessWindow,

package/src/extensions/command-quotas/index.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import {
   configLoader,
   SYNTHETIC_EXTENSIONS_REGISTER_EVENT,

package/src/extensions/provider/context-overflow.ts

@@ -0,0 +1,20 @@
+/**
+ * Synthetic-specific context overflow error detection.
+ *
+ * Some Synthetic backend errors are not matched by Pi's built-in
+ * isContextOverflow() patterns. This module provides the regex
+ * to detect them so the provider extension can normalize the
+ * errorMessage with the `context_length_exceeded:` prefix that
+ * Pi recognizes.
+ */
+
+/**
+ * Matches Synthetic context overflow errors that Pi's built-in
+ * overflow detector does not catch:
+ *
+ * 1. "Error from inference backend: 400 The input (N tokens) is longer
+ *    than the model's context length (M tokens)."
+ * 2. "Context limit exceeded"
+ */
+export const SYNTHETIC_OVERFLOW_PATTERN =
+  /input \(\d+ tokens\) is longer than the model's context length|Context limit exceeded/i;

package/src/extensions/provider/index.ts

@@ -1,4 +1,7 @@
-import type { AuthStorage, ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type {
+  AuthStorage,
+  ExtensionAPI,
+} from "@earendil-works/pi-coding-agent";
 import {
   configLoader,
   emitSyntheticConfigUpdated,
@@ -24,6 +27,7 @@ import {
   type SyntheticQuotasRequestPayload,
 } from "../../types/quotas";
 import { fetchQuotas } from "../../utils/quotas";
+import { SYNTHETIC_OVERFLOW_PATTERN } from "./context-overflow";
 import { SYNTHETIC_MODELS } from "./models";
 
 export function buildSyntheticProviderModels(includeProxiedModels: boolean) {
@@ -108,6 +112,24 @@ export default async function (pi: ExtensionAPI) {
     if (quotas) quotaStore.ingest(quotas, "header");
   });
 
+  pi.on("message_end", (event) => {
+    const msg = event.message;
+    if (msg.role !== "assistant") return;
+    if (msg.stopReason !== "error") return;
+    if (msg.provider !== "synthetic") return;
+
+    const errorMessage = msg.errorMessage ?? "";
+    if (errorMessage.includes("context_length_exceeded")) return;
+    if (!SYNTHETIC_OVERFLOW_PATTERN.test(errorMessage)) return;
+
+    return {
+      message: {
+        ...msg,
+        errorMessage: `context_length_exceeded: ${errorMessage}`,
+      },
+    };
+  });
+
   pi.events.on(SYNTHETIC_QUOTAS_REQUEST_EVENT, async (data: unknown) => {
     const payload = data as SyntheticQuotasRequestPayload | undefined;
     const snapshot = await quotaStore.refreshFromApi(fetchQuotasFromAuth);

package/src/extensions/provider/models.ts

@@ -2,7 +2,7 @@
 // Source: https://api.synthetic.new/openai/v1/models
 // maxTokens sourced from https://models.dev/api.json (synthetic provider)
 
-import type { ProviderModelConfig } from "@mariozechner/pi-coding-agent";
+import type { ProviderModelConfig } from "@earendil-works/pi-coding-agent";
 
 export interface SyntheticModelConfig extends ProviderModelConfig {
   /** Upstream backend Synthetic proxies this model through (e.g. "fireworks", "together", "synthetic"). */

package/src/extensions/quota-warnings/index.ts

@@ -1,7 +1,7 @@
 import type {
   ExtensionAPI,
   ExtensionContext,
-} from "@mariozechner/pi-coding-agent";
+} from "@earendil-works/pi-coding-agent";
 import {
   configLoader,
   SYNTHETIC_CONFIG_UPDATED_EVENT,

package/src/extensions/sub-bar-integration/index.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import {
   configLoader,
   SYNTHETIC_CONFIG_UPDATED_EVENT,

package/src/extensions/usage-status/index.ts

@@ -1,7 +1,7 @@
 import type {
   ExtensionAPI,
   ExtensionContext,
-} from "@mariozechner/pi-coding-agent";
+} from "@earendil-works/pi-coding-agent";
 import {
   configLoader,
   SYNTHETIC_CONFIG_UPDATED_EVENT,

package/src/extensions/web-search/index.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import {
   configLoader,
   SYNTHETIC_CONFIG_UPDATED_EVENT,

package/src/extensions/web-search/tool.ts

@@ -1,3 +1,7 @@
+import { randomBytes } from "node:crypto";
+import { writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
 import { ToolCallHeader, ToolFooter } from "@aliou/pi-utils-ui";
 import type {
   AgentToolResult,
@@ -5,9 +9,15 @@ import type {
   ExtensionContext,
   Theme,
   ToolRenderResultOptions,
-} from "@mariozechner/pi-coding-agent";
-import { getMarkdownTheme, keyHint } from "@mariozechner/pi-coding-agent";
-import { Container, Markdown, Text } from "@mariozechner/pi-tui";
+} from "@earendil-works/pi-coding-agent";
+import {
+  DEFAULT_MAX_BYTES,
+  DEFAULT_MAX_LINES,
+  formatSize,
+  keyHint,
+  truncateHead,
+} from "@earendil-works/pi-coding-agent";
+import { Container, Text } from "@earendil-works/pi-tui";
 import { type Static, Type } from "typebox";
 import { configLoader } from "../../config";
 import { getSyntheticApiKey } from "../../lib/env";
@@ -25,8 +35,20 @@ interface SyntheticSearchResponse {
   results: SyntheticSearchResult[];
 }
 
+interface WebSearchResultDetails {
+  title: string;
+  url: string;
+  published: string;
+  truncated: boolean;
+  tempFilePath?: string;
+  totalLines: number;
+  totalBytes: number;
+  outputLines: number;
+  outputBytes: number;
+}
+
 interface WebSearchDetails {
-  results?: SyntheticSearchResult[];
+  results?: WebSearchResultDetails[];
   query?: string;
 }
 
@@ -42,8 +64,7 @@ export function registerSyntheticWebSearchTool(pi: ExtensionAPI): void {
   pi.registerTool<typeof SearchParams, WebSearchDetails>({
     name: SYNTHETIC_WEB_SEARCH_TOOL,
     label: "Synthetic: Web Search",
-    description:
-      "Search the web using Synthetic's zero-data-retention API. Returns search results with titles, URLs, content snippets, and publication dates. Use for finding documentation, articles, recent information, or any web content. Results are fresh and not cached by Synthetic.",
+    description: `Search the web using Synthetic's zero-data-retention API. Returns search results with titles, URLs, content snippets, and publication dates. Use for finding documentation, articles, recent information, or any web content. Results are fresh and not cached by Synthetic. Results are truncated to ${DEFAULT_MAX_LINES} lines or ${formatSize(DEFAULT_MAX_BYTES)} (whichever is hit first). If truncated, full output is saved to a temp file.`,
     promptSnippet: "Search the web using Synthetic's zero-data-retention API",
     promptGuidelines: [
       "Use synthetic_web_search for finding documentation, articles, recent information, or any web content.",
@@ -106,18 +127,55 @@ export function registerSyntheticWebSearchTool(pi: ExtensionAPI): void {
       }
 
       let content = `Found ${data.results.length} result(s):\n\n`;
-      for (const result of data.results) {
+      const resultDetails: WebSearchResultDetails[] = [];
+
+      for (let i = 0; i < data.results.length; i++) {
+        const result = data.results[i];
+        const slug = result.title
+          .toLowerCase()
+          .replace(/[^a-z0-9]+/g, "-")
+          .replace(/(^-|-$)/g, "")
+          .slice(0, 40);
+        const truncation = truncateHead(result.text, {
+          maxLines: DEFAULT_MAX_LINES,
+          maxBytes: DEFAULT_MAX_BYTES,
+        });
+
+        let preview = truncation.content;
+        let tempFilePath: string | undefined;
+
+        if (truncation.truncated) {
+          tempFilePath = join(
+            tmpdir(),
+            `pi-synthetic-search-${slug}-${randomBytes(4).toString("hex")}.md`,
+          );
+          await writeFile(tempFilePath, result.text, "utf8");
+          preview += `\n\n[Result truncated: ${truncation.outputLines} of ${truncation.totalLines} lines (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)}). Full result: ${tempFilePath}]`;
+        }
+
         content += `## ${result.title}\n`;
         content += `URL: ${result.url}\n`;
         content += `Published: ${result.published}\n`;
-        content += `\n${result.text}\n`;
+        content += `\n${preview}\n`;
         content += "\n---\n\n";
+
+        resultDetails.push({
+          title: result.title,
+          url: result.url,
+          published: result.published,
+          truncated: truncation.truncated,
+          tempFilePath,
+          totalLines: truncation.totalLines,
+          totalBytes: truncation.totalBytes,
+          outputLines: truncation.outputLines,
+          outputBytes: truncation.outputBytes,
+        });
       }
 
       return {
         content: [{ type: "text", text: content }],
         details: {
-          results: data.results,
+          results: resultDetails,
           query: params.query,
         },
       };
@@ -140,7 +198,6 @@ export function registerSyntheticWebSearchTool(pi: ExtensionAPI): void {
       theme: Theme,
     ) {
       const { expanded, isPartial } = options;
-      const SNIPPET_LINES = 5;
 
       if (isPartial) {
         return new Text(
@@ -165,6 +222,8 @@ export function registerSyntheticWebSearchTool(pi: ExtensionAPI): void {
         return container;
       }
 
+      const hasTruncation = results.some((r) => r.truncated);
+
       if (results.length === 0) {
         container.addChild(
           new Text(theme.fg("muted", "Synthetic: WebSearch: no results"), 0, 0),
@@ -172,6 +231,9 @@ export function registerSyntheticWebSearchTool(pi: ExtensionAPI): void {
       } else if (!expanded) {
         // Collapsed: show result count + first result title
         let text = theme.fg("success", `Found ${results.length} result(s)`);
+        if (hasTruncation) {
+          text += theme.fg("warning", " (truncated)");
+        }
         const first = results[0];
         if (first) {
           text += `\n  ${theme.fg("dim", first.title)}`;
@@ -214,26 +276,40 @@ export function registerSyntheticWebSearchTool(pi: ExtensionAPI): void {
             );
           }
 
-          if (r.text) {
-            container.addChild(new Text("", 0, 0));
-            const snippet = r.text
-              .split("\n")
-              .slice(0, SNIPPET_LINES)
-              .map((line) => `> ${line}`)
-              .join("\n");
+          if (r.truncated) {
             container.addChild(
-              new Markdown(snippet, 0, 0, getMarkdownTheme(), {
-                color: (text: string) => theme.fg("toolOutput", text),
-              }),
+              new Text(
+                `  ${theme.fg("warning", `Truncated: ${r.outputLines} of ${r.totalLines} lines (${formatSize(r.outputBytes)} of ${formatSize(r.totalBytes)}). Full content: ${r.tempFilePath}`)}`,
+                0,
+                0,
+              ),
             );
           }
         }
       }
 
+      const footerItems: { label: string; value: string }[] = [];
+      footerItems.push({
+        label: "results",
+        value: `${results.length} result(s)`,
+      });
+      if (hasTruncation) {
+        const truncatedCount = results.filter((r) => r.truncated).length;
+        footerItems.push({
+          label: "truncated",
+          value: `${truncatedCount}`,
+        });
+      }
+      if (!expanded) {
+        footerItems.push({
+          label: "",
+          value: keyHint("app.tools.expand", "to expand"),
+        });
+      }
       container.addChild(new Text("", 0, 0));
       container.addChild(
         new ToolFooter(theme, {
-          items: [{ label: "results", value: `${results.length} result(s)` }],
+          items: footerItems,
           separator: " | ",
         }),
       );

package/src/lib/env.ts

@@ -1,4 +1,4 @@
-import type { AuthStorage } from "@mariozechner/pi-coding-agent";
+import type { AuthStorage } from "@earendil-works/pi-coding-agent";
 
 const PROVIDER_ID = "synthetic";