@triplef/agent 0.1.1 → 0.1.3

package/dist/prompts/index.mjs

@@ -368,7 +368,7 @@ var TOOL_DESCRIPTIONS = {
   eodhdIntraday: "Fetch intraday OHLCV bars for an EODHD ticker and return a per-day, per-price-band volume profile as chartData for the client heatmap. Use to render a volume heatmap across fixed price bands.",
   eodhdNews: "Fetch recent financial news for an EODHD ticker \u2014 headlines, links, sources, publish dates. Use to ground a stock-market answer in what is happening around a company.",
   eodhdFundamentals: "Fetch company fundamentals for an EODHD ticker \u2014 general info, valuation, and key financial highlights (sector, market cap, P/E, revenue, margins).",
-  webFetch: "Fetch the full content of a specific URL. Use only when search snippets are insufficient.",
+  webFetch: "Fetch the full content of a specific URL (e.g. a search result page) as clean Markdown. Prefer fetching the most relevant search results to ground the answer in full source text rather than relying on snippets alone.",
   browser_navigate: "Control a real browser: navigate to a URL. Use for interactive browsing \u2014 JS-heavy pages, content behind clicks, tabs, scrolling, or forms \u2014 that static search/fetch cannot reach. Follow up with browser_snapshot to read the page before acting on it.",
   browser_navigate_back: "Go back to the previous page in the browser history.",
   browser_snapshot: "Read the current browser page as an accessibility snapshot (structured text with element refs). The primary way to see page content and obtain the refs that browser_click/browser_type need.",
@@ -2652,6 +2652,12 @@ WHEN TO USE TOOLS
 - user asks about a specific product to buy, prices, or best deals \u2192 product template with a *WebSearch tool, shopping search, and reviews search
 - user asks about specific factual entities, specifications, data, statistics \u2192 the enabled *WebSearch tool
 
+FETCH-AFTER-SEARCH RULES
+- When you include a *WebSearch tool for factual research (article, news, evaluation, product, or text), also include a fetch tool \u2014 webFetch, serperWebpageScrape, or brightDataWebpageScrape \u2014 to fetch the 1-3 most relevant result pages.
+- The fetched full content grounds the answer in source text (not just snippets) and populates the knowledge cache for future turns.
+- You decide which pages are worth fetching: fetch only pages whose full content would meaningfully improve the answer. Skip fetching for trivial lookups, quick facts, or when the snippets already answer the request completely.
+- Prefer webFetch for plain pages; use a scrape tool for pages behind anti-bot protection.
+
 MEDIA-TYPE TOOL SELECTION
 When the user explicitly or implicitly requests specific media types, include the corresponding concrete tools (never category names):
 - images, photos, pictures, screenshots, artwork \u2192 include every enabled *ImageSearch tool (e.g. serperImageSearch)

package/dist/schemas/index.d.ts

@@ -154,6 +154,7 @@ interface LexiconSelectInput {
     query: string;
     documents: LexiconSourceDocument[];
     budgetChars?: number;
+    partitionScope?: string;
 }
 interface LexiconSelectResult {
     chunks: LexiconSelectedChunk[];
@@ -161,6 +162,9 @@ interface LexiconSelectResult {
     selectedChunks: number;
     droppedByThreshold: number;
     inputChunksDropped: number;
+    pastChunks?: LexiconSelectedChunk[];
+    reusedDocs?: number;
+    storedDocs?: number;
 }
 
 declare const ConsolidationVerdictSchema: z.ZodObject<{

package/dist/schemas/index.mjs

@@ -110,7 +110,7 @@ var TOOL_DESCRIPTIONS = {
   eodhdIntraday: "Fetch intraday OHLCV bars for an EODHD ticker and return a per-day, per-price-band volume profile as chartData for the client heatmap. Use to render a volume heatmap across fixed price bands.",
   eodhdNews: "Fetch recent financial news for an EODHD ticker \u2014 headlines, links, sources, publish dates. Use to ground a stock-market answer in what is happening around a company.",
   eodhdFundamentals: "Fetch company fundamentals for an EODHD ticker \u2014 general info, valuation, and key financial highlights (sector, market cap, P/E, revenue, margins).",
-  webFetch: "Fetch the full content of a specific URL. Use only when search snippets are insufficient.",
+  webFetch: "Fetch the full content of a specific URL (e.g. a search result page) as clean Markdown. Prefer fetching the most relevant search results to ground the answer in full source text rather than relying on snippets alone.",
   browser_navigate: "Control a real browser: navigate to a URL. Use for interactive browsing \u2014 JS-heavy pages, content behind clicks, tabs, scrolling, or forms \u2014 that static search/fetch cannot reach. Follow up with browser_snapshot to read the page before acting on it.",
   browser_navigate_back: "Go back to the previous page in the browser history.",
   browser_snapshot: "Read the current browser page as an accessibility snapshot (structured text with element refs). The primary way to see page content and obtain the refs that browser_click/browser_type need.",

package/dist/tools/index.d.ts

@@ -84,12 +84,6 @@ interface MarketDailyBar {
 interface ToolDependencies {
     getLiveConfig: () => ToolConfigSnapshot;
     logger: ToolLogger;
-    compactContent: (content: string, opts?: {
-        model?: string;
-        notify?: (event: string, data?: unknown) => void;
-    }) => Promise<{
-        text: string;
-    }>;
     model?: string;
     notify?: (event: string, data?: unknown) => void;
     getOrFetchHistory?: (ticker: string, from: string, to: string) => Promise<MarketDailyBar[]>;

package/dist/tools/index.mjs

@@ -669,7 +669,7 @@ function createBrightDataWebpageScrape(deps) {
         });
         const content = data.text || "";
         deps.logger.log(`Bright Data webpage scraped ${content.length} chars from "${url}"`);
-        return { content, title: "" };
+        return { url, content, title: "" };
       } catch (err) {
         deps.logger.warn(`Bright Data webpage scrape failed for "${url}": ${String(err)}`);
         return { content: "", error: String(err) };
@@ -1416,7 +1416,7 @@ function createSerperWebpageScrape(deps) {
       const content = data.text || "";
       const title = data.title || "";
       deps.logger.log(`Serper.dev Webpage scraped ${content.length} chars from "${url}"`);
-      return { content, title };
+      return { url, content, title };
     }
   });
 }
@@ -1474,7 +1474,7 @@ function extractArticleText(html) {
 // src/tools/web-fetch/web-fetch.tool.ts
 function createWebFetchTool() {
   return tool({
-    description: "Fetch the full content of a specific URL. Returns the main article text as Markdown (boilerplate removed). Use only when search snippets are insufficient.",
+    description: "Fetch the full content of a specific URL (e.g. a search result page). Returns the main article text as Markdown (boilerplate removed). Prefer fetching the most relevant search results to ground the answer in full source text.",
     inputSchema: webFetchSchema,
     execute: async ({ url }) => {
       const response = await fetchWithTimeout(
@@ -1488,7 +1488,7 @@ function createWebFetchTool() {
         { timeoutMs: SEARCH_TIMEOUT_MS }
       );
       const html = await response.text();
-      return { content: extractArticleText(html) };
+      return { url, content: extractArticleText(html) };
     }
   });
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@triplef/agent",
   "description": "tripleF (3F) agent domain — structured-output schemas, prompt builders, and model tools shared across the apps.",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "packageManager": "pnpm@11.24.0",
   "license": "MIT",
   "type": "module",