@triplef/agent 0.1.2 → 0.1.3

package/dist/prompts/index.d.ts

@@ -1,5 +1,5 @@
-import { T as TemplateName, F as FormatZodShapeOptions } from '../intent.schema-BbIiFHUW.js';
-export { D as DEFAULT_VARIANT_ID } from '../intent.schema-BbIiFHUW.js';
+import { T as TemplateName, F as FormatZodShapeOptions } from '../intent.schema-BFsi1OVf.js';
+export { D as DEFAULT_VARIANT_ID } from '../intent.schema-BFsi1OVf.js';
 import * as zod from 'zod';
 import { z, ZodTypeAny, ZodType } from 'zod';
 import * as zod_v4_core from 'zod/v4/core';

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export { D as DEFAULT_VARIANT_ID, F as FormatZodShapeOptions, I as IntentResult, a as IntentSchema, T as TemplateName, f as formatZodShape } from '../intent.schema-BbIiFHUW.js';
+export { D as DEFAULT_VARIANT_ID, F as FormatZodShapeOptions, I as IntentResult, a as IntentSchema, T as TemplateName, f as formatZodShape } from '../intent.schema-BFsi1OVf.js';
 
 declare const BLOCKED_IMAGE_HOSTS: Set<string>;
 

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.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.2",
+  "version": "0.1.3",
   "packageManager": "pnpm@11.24.0",
   "license": "MIT",
   "type": "module",

package/dist/{intent.schema-BbIiFHUW.d.ts → intent.schema-BFsi1OVf.d.ts}

@@ -10,7 +10,6 @@ declare const TEMPLATES: readonly ["article", "news", "describe", "compare", "oc
 type TemplateName = (typeof TEMPLATES)[number];
 declare const IntentSchema: z.ZodObject<{
     template: z.ZodEnum<{
-        text: "text";
         article: "article";
         news: "news";
         describe: "describe";
@@ -25,6 +24,7 @@ declare const IntentSchema: z.ZodObject<{
         stockmarketitem: "stockmarketitem";
         stockmarketlist: "stockmarketlist";
         merge: "merge";
+        text: "text";
     }>;
     prompt: z.ZodDefault<z.ZodString>;
     tools: z.ZodArray<z.ZodEnum<{