@triplef/agent 0.1.15 → 0.1.17

package/dist/schemas/index.d.ts

@@ -1,11 +1,23 @@
 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-DnxaUhmz.js';
+export { B as BROWSER_TOOL_NAMES, D as DEFAULT_VARIANT_ID, F as FormatZodShapeOptions, a as IMAGE_TASK_TEMPLATES, b as ImageTaskTemplate, I as IntentResult, c as IntentSchema, M as MEMORY_TOOL_NAMES, P as ProviderConfig, d as TOOL_DESCRIPTIONS, e as TOOL_NAMES, T as TemplateName, f as ToolName, g as VARIANT_NAMES, V as VariantName, h as formatZodShape, i as isImageTaskTemplate } from '../intent.schema-Bp3p7h7P.js';
 
 declare const BLOCKED_IMAGE_HOSTS: Set<string>;
 
+declare const EMBEDDABLE_VIDEO_PROVIDER_LABELS = "YouTube, Vimeo, Dailymotion, Loom, Wistia";
+declare const EMBEDDABLE_VIDEO_PROVIDER_CLAUSE = "Only return URLs from supported embeddable providers: YouTube, Vimeo, Dailymotion, Loom, Wistia, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms.";
+
+declare const DEFAULT_MEDIA_COUNT = 6;
+declare const MORE_MEDIA_COUNT = 12;
+
 declare const BLOCKED_URL_HOSTS: Set<string>;
 declare const NON_PAGE_EXTENSIONS: RegExp;
 
+declare const EncyclopediaClassifySchema: z.ZodObject<{
+    category: z.ZodString;
+    topic: z.ZodString;
+}, z.core.$strip>;
+type EncyclopediaClassification = z.infer<typeof EncyclopediaClassifySchema>;
+
 interface EncyclopediaSourceDocument {
     url?: string;
     title?: string;
@@ -44,104 +56,6 @@ interface EncyclopediaSelectResult {
 
 declare function categorizeTools(toolNames: readonly string[]): Record<string, string[]>;
 
-declare const VARIANT_NAMES: readonly ["grayscale", "denoised", "sharpened", "clahe"];
-type VariantName = (typeof VARIANT_NAMES)[number];
-declare const TOOL_DESCRIPTIONS: Record<string, string>;
-declare const BROWSER_TOOL_NAMES: readonly ["browser_navigate", "browser_navigate_back", "browser_snapshot", "browser_click", "browser_type", "browser_fill_form", "browser_select_option", "browser_press_key", "browser_wait_for", "browser_take_screenshot", "browser_tabs", "browser_console_messages", "browser_network_requests", "browser_verify_element_visible", "browser_verify_text_visible"];
-declare const MEMORY_TOOL_NAMES: readonly ["memory-partition-remember", "memory-partition-recall", "memory-partition-delete", "memory-cognition-remember", "memory-cognition-forget"];
-declare const TOOL_NAMES: readonly ["webFetch", "brightDataWebSearch", "brightDataImageSearch", "brightDataNewsSearch", "brightDataPlacesSearch", "brightDataShoppingSearch", "brightDataVideoSearch", "brightDataWebpageScrape", "serperWebSearch", "serperImageSearch", "serperNewsSearch", "serperPlacesSearch", "serperShoppingSearch", "serperBusinessReviewsSearch", "serperVideoSearch", "serperWebpageScrape", "youtubeVideoSearch", "eodhdSearch", "eodhdQuote", "eodhdHistory", "eodhdTechnical", "eodhdIntraday", "eodhdNews", "eodhdFundamentals", "requestGrayscale", "requestDenoised", "requestSharpened", "requestClahe", "memory-partition-remember", "memory-partition-recall", "memory-partition-delete", "memory-cognition-remember", "memory-cognition-forget", "browser_navigate", "browser_navigate_back", "browser_snapshot", "browser_click", "browser_type", "browser_fill_form", "browser_select_option", "browser_press_key", "browser_wait_for", "browser_take_screenshot", "browser_tabs", "browser_console_messages", "browser_network_requests", "browser_verify_element_visible", "browser_verify_text_visible"];
-type ToolName = (typeof TOOL_NAMES)[number];
-type ProviderConfig = {
-    serper: {
-        enabled: boolean;
-        apiKey?: string;
-        web: {
-            enabled: boolean;
-        };
-        images: {
-            enabled: boolean;
-        };
-        news: {
-            enabled: boolean;
-        };
-        places: {
-            enabled: boolean;
-        };
-        shopping: {
-            enabled: boolean;
-        };
-        reviews: {
-            enabled: boolean;
-        };
-        videos: {
-            enabled: boolean;
-        };
-        scrape: {
-            enabled: boolean;
-        };
-    };
-    youtube: {
-        enabled: boolean;
-        apiKey?: string;
-        videos: {
-            enabled: boolean;
-        };
-    };
-    brightData: {
-        enabled: boolean;
-        apiKey?: string;
-        web: {
-            enabled: boolean;
-        };
-        images: {
-            enabled: boolean;
-        };
-        news: {
-            enabled: boolean;
-        };
-        places: {
-            enabled: boolean;
-        };
-        shopping: {
-            enabled: boolean;
-        };
-        videos: {
-            enabled: boolean;
-        };
-        scrape: {
-            enabled: boolean;
-        };
-    };
-    eodhd: {
-        enabled: boolean;
-        apiKey?: string;
-        search: {
-            enabled: boolean;
-        };
-        quote: {
-            enabled: boolean;
-        };
-        history: {
-            enabled: boolean;
-        };
-        technical: {
-            enabled: boolean;
-        };
-        intraday: {
-            enabled: boolean;
-        };
-        news: {
-            enabled: boolean;
-        };
-        fundamentals: {
-            enabled: boolean;
-        };
-    };
-    playwright: {
-        enabled: boolean;
-    };
-};
-
 declare function hasBlockedImageHost(url: string): boolean;
 
 declare function isPrivateOrLocalhost(hostname: string): boolean;
@@ -175,6 +89,12 @@ declare function deriveSchemaKeys(schema: z.ZodType): {
 
 declare function formatZodIssues(issues: z.ZodIssue[]): string;
 
+declare const MemoryClusterSummarySchema: z.ZodObject<{
+    title: z.ZodString;
+    summary: z.ZodString;
+}, z.core.$strip>;
+type MemoryClusterSummary = z.infer<typeof MemoryClusterSummarySchema>;
+
 declare const ConsolidationVerdictSchema: z.ZodObject<{
     verdict: z.ZodEnum<{
         merge: "merge";
@@ -185,19 +105,53 @@ declare const ConsolidationVerdictSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ConsolidationVerdict = z.infer<typeof ConsolidationVerdictSchema>;
 
-declare const MemoryClusterSummarySchema: z.ZodObject<{
-    title: z.ZodString;
-    summary: z.ZodString;
-}, z.core.$strip>;
-type MemoryClusterSummary = z.infer<typeof MemoryClusterSummarySchema>;
-
 declare const MemoryEnrichmentSchema: z.ZodObject<{
     tags: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 type MemoryEnrichment = z.infer<typeof MemoryEnrichmentSchema>;
 
+declare const FACT_KINDS: readonly ["preference", "decision", "state", "contact", "project", "possession", "relationship", "fact"];
+declare const FACT_STABILITIES: readonly ["durable", "volatile"];
+declare const ExtractedFactSchema: z.ZodObject<{
+    text: z.ZodString;
+    subject: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        preference: "preference";
+        decision: "decision";
+        state: "state";
+        contact: "contact";
+        project: "project";
+        possession: "possession";
+        relationship: "relationship";
+        fact: "fact";
+    }>;
+    stability: z.ZodEnum<{
+        durable: "durable";
+        volatile: "volatile";
+    }>;
+}, z.core.$strip>;
+type ExtractedFact = z.infer<typeof ExtractedFactSchema>;
 declare const ExtractionSchema: z.ZodObject<{
-    facts: z.ZodArray<z.ZodString>;
+    facts: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        subject: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            preference: "preference";
+            decision: "decision";
+            state: "state";
+            contact: "contact";
+            project: "project";
+            possession: "possession";
+            relationship: "relationship";
+            fact: "fact";
+        }>;
+        stability: z.ZodEnum<{
+            durable: "durable";
+            volatile: "volatile";
+        }>;
+    }, z.core.$strip>>;
     tags: z.ZodArray<z.ZodString>;
     category: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -919,4 +873,4 @@ declare const videolistSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 
-export { BLOCKED_IMAGE_HOSTS, BLOCKED_URL_HOSTS, BROWSER_TOOL_NAMES, COGNITION_LIMIT_DEFAULT, COGNITION_LIMIT_MAX, COGNITION_LIMIT_MIN, COGNITION_PURGE_BATCH, CONVICTION_TAGS, CONVICTION_TEXT_LIMIT, type ConsolidationVerdict, ConsolidationVerdictSchema, EPISODE_PROBE_LIMIT_DEFAULT, EPISODE_PROBE_LIMIT_MIN, EPISODE_RECENCY_MIDPOINT_DEFAULT, EPISODE_RECENCY_MIDPOINT_MAX, EPISODE_RECENCY_MIDPOINT_MIN, EPISODE_RECENCY_SCALE_SECONDS_DEFAULT, EPISODE_RECENCY_SCALE_SECONDS_MAX, EPISODE_RECENCY_SCALE_SECONDS_MIN, EPISODE_RECENCY_WEIGHT_DEFAULT, EPISODE_RECENCY_WEIGHT_MAX, EPISODE_RECENCY_WEIGHT_MIN, EPISODE_SCORE_THRESHOLD_DEFAULT, EPISODE_SCORE_THRESHOLD_MAX, EPISODE_SCORE_THRESHOLD_MIN, EPISODE_TAGS, EPISODE_TEXT_LIMIT, type EncyclopediaSearchResult, type EncyclopediaSelectInput, type EncyclopediaSelectResult, type EncyclopediaSelectedChunk, type EncyclopediaSourceDocument, ExtractionSchema, HERO_VIDEO_TITLE_ISSUE, INSIGHTS_MAX_PER_TURN, INSIGHT_TAGS, INSIGHT_TEXT_LIMIT, MEMORY_TOOL_NAMES, type MemoryClusterSummary, MemoryClusterSummarySchema, type MemoryCognitionProfile, type MemoryEnrichment, MemoryEnrichmentSchema, type MemoryExtraction, type MemoryProfileInsight, type MemoryProfileResponse, NON_PAGE_EXTENSIONS, type ProviderConfig, TOOL_DESCRIPTIONS, TOOL_NAMES, type ToolName, VARIANT_NAMES, type VariantName, cardSchema, categorizeTools, clampCognitionLimit, clampEpisodeProbeLimit, clampEpisodeRecencyMidpoint, clampEpisodeRecencyScaleSeconds, clampEpisodeRecencyWeight, clampEpisodeScoreThreshold, compareSchema, createTextItemSchema, deriveSchemaKeys, describeSchema, discardedReferenceSchema, formatZodIssues, galleryItemSchema, hasBlockedImageHost, heroVideoHasTitle, imagelistSchema, internationalCoverageSchema, isAllFieldsNullWipe, isPrivateOrLocalhost, isTrustedImageUrl, isTrustedUrl, markerSchema, memoryProfileResponseSchema, mergeCognitionProfiles, normalizeInsightPath, ocrSchema, parseStoredProfile, productSchema, referenceGalleryItemSchema, referenceLineSchema, relatedStorySchema, safeMediaUrl, safeMediaUrlOrEmpty, safeUrl, safeVideoUrl, safeVideoUrlOrEmpty, shoplistSchema, sourceSchema, stockmarketItemSchema, stockmarketListSchema, summarySchema, videoGalleryItemSchema, videolistSchema };
+export { BLOCKED_IMAGE_HOSTS, BLOCKED_URL_HOSTS, COGNITION_LIMIT_DEFAULT, COGNITION_LIMIT_MAX, COGNITION_LIMIT_MIN, COGNITION_PURGE_BATCH, CONVICTION_TAGS, CONVICTION_TEXT_LIMIT, type ConsolidationVerdict, ConsolidationVerdictSchema, DEFAULT_MEDIA_COUNT, EMBEDDABLE_VIDEO_PROVIDER_CLAUSE, EMBEDDABLE_VIDEO_PROVIDER_LABELS, EPISODE_PROBE_LIMIT_DEFAULT, EPISODE_PROBE_LIMIT_MIN, EPISODE_RECENCY_MIDPOINT_DEFAULT, EPISODE_RECENCY_MIDPOINT_MAX, EPISODE_RECENCY_MIDPOINT_MIN, EPISODE_RECENCY_SCALE_SECONDS_DEFAULT, EPISODE_RECENCY_SCALE_SECONDS_MAX, EPISODE_RECENCY_SCALE_SECONDS_MIN, EPISODE_RECENCY_WEIGHT_DEFAULT, EPISODE_RECENCY_WEIGHT_MAX, EPISODE_RECENCY_WEIGHT_MIN, EPISODE_SCORE_THRESHOLD_DEFAULT, EPISODE_SCORE_THRESHOLD_MAX, EPISODE_SCORE_THRESHOLD_MIN, EPISODE_TAGS, EPISODE_TEXT_LIMIT, type EncyclopediaClassification, EncyclopediaClassifySchema, type EncyclopediaSearchResult, type EncyclopediaSelectInput, type EncyclopediaSelectResult, type EncyclopediaSelectedChunk, type EncyclopediaSourceDocument, type ExtractedFact, ExtractedFactSchema, ExtractionSchema, FACT_KINDS, FACT_STABILITIES, HERO_VIDEO_TITLE_ISSUE, INSIGHTS_MAX_PER_TURN, INSIGHT_TAGS, INSIGHT_TEXT_LIMIT, MORE_MEDIA_COUNT, type MemoryClusterSummary, MemoryClusterSummarySchema, type MemoryCognitionProfile, type MemoryEnrichment, MemoryEnrichmentSchema, type MemoryExtraction, type MemoryProfileInsight, type MemoryProfileResponse, NON_PAGE_EXTENSIONS, cardSchema, categorizeTools, clampCognitionLimit, clampEpisodeProbeLimit, clampEpisodeRecencyMidpoint, clampEpisodeRecencyScaleSeconds, clampEpisodeRecencyWeight, clampEpisodeScoreThreshold, compareSchema, createTextItemSchema, deriveSchemaKeys, describeSchema, discardedReferenceSchema, formatZodIssues, galleryItemSchema, hasBlockedImageHost, heroVideoHasTitle, imagelistSchema, internationalCoverageSchema, isAllFieldsNullWipe, isPrivateOrLocalhost, isTrustedImageUrl, isTrustedUrl, markerSchema, memoryProfileResponseSchema, mergeCognitionProfiles, normalizeInsightPath, ocrSchema, parseStoredProfile, productSchema, referenceGalleryItemSchema, referenceLineSchema, relatedStorySchema, safeMediaUrl, safeMediaUrlOrEmpty, safeUrl, safeVideoUrl, safeVideoUrlOrEmpty, shoplistSchema, sourceSchema, stockmarketItemSchema, stockmarketListSchema, summarySchema, videoGalleryItemSchema, videolistSchema };

package/dist/schemas/index.mjs

@@ -31,6 +31,14 @@ var BLOCKED_IMAGE_HOSTS = /* @__PURE__ */ new Set([
   "lh6.googleusercontent.com"
 ]);
 
+// src/schemas/constants/embeddable-video-providers.constant.ts
+var EMBEDDABLE_VIDEO_PROVIDER_LABELS = "YouTube, Vimeo, Dailymotion, Loom, Wistia";
+var EMBEDDABLE_VIDEO_PROVIDER_CLAUSE = `Only return URLs from supported embeddable providers: ${EMBEDDABLE_VIDEO_PROVIDER_LABELS}, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms.`;
+
+// src/schemas/constants/media-counts.constant.ts
+var DEFAULT_MEDIA_COUNT = 6;
+var MORE_MEDIA_COUNT = 12;
+
 // src/schemas/constants/url-trust.constants.ts
 var BLOCKED_URL_HOSTS = /* @__PURE__ */ new Set([
   // Google thumbnail / static asset proxies
@@ -60,6 +68,20 @@ var BLOCKED_URL_HOSTS = /* @__PURE__ */ new Set([
   "lh6.googleusercontent.com"
 ]);
 var NON_PAGE_EXTENSIONS = /\.(js|css|json|xml|svg|png|jpg|jpeg|gif|webp|ico|mp4|webm|ogg|mov|mkv|avi|flv|m3u8|mpd|pdf|zip|tar|gz|rar|exe|dmg|pkg|deb|rpm|woff|woff2|ttf|otf|eot)(\?.*)?$/i;
+var EncyclopediaClassifySchema = z.object({
+  /**
+   * One broad lowercase PLURAL family label for the document (e.g. `games`,
+   * `work`, `health`) — the constellation's cluster tier. Never a specific
+   * entity, product, company, or title.
+   */
+  category: z.string(),
+  /**
+   * The narrow topic the document is about (e.g. `wuthering waves`,
+   * `q3 budget`) — the constellation's cluster tier. A short, specific,
+   * reusable label, not a sentence and not a URL.
+   */
+  topic: z.string()
+});
 
 // src/schemas/helpers/tools/categorize-tools.helper.ts
 function categorizeTools(toolNames) {
@@ -92,7 +114,7 @@ var TOOL_DESCRIPTIONS = {
   brightDataNewsSearch: "Search latest news using Bright Data SERP API. Returns headlines, sources, dates, and snippets. Supports an optional recency window (day/week/month/year).",
   brightDataPlacesSearch: "Search places and businesses using Bright Data SERP API (Google Maps). Returns addresses, phone numbers, ratings, review counts, and coordinates. Query with a business name or business type plus location.",
   brightDataShoppingSearch: "Search for products using Bright Data SERP API (Google Shopping). Returns prices, sellers, images, and ratings. Query with the bare product name and model number.",
-  brightDataVideoSearch: "Search for videos using Bright Data SERP API. Returns titles, links, channel names, duration, and publish dates. Supports an optional recency window (day/week/month/year). Only return URLs from supported embeddable providers: YouTube, Vimeo, Dailymotion, Loom, Wistia, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms.",
+  brightDataVideoSearch: `Search for videos using Bright Data SERP API. Returns titles, links, channel names, duration, and publish dates. Supports an optional recency window (day/week/month/year) for fresh results. ${EMBEDDABLE_VIDEO_PROVIDER_CLAUSE}`,
   brightDataWebpageScrape: "Fetch and render a full webpage using Bright Data Web Unlocker API. Returns clean Markdown text. Use for pages behind anti-bot protection that plain fetch cannot reach.",
   serperWebSearch: "Search the web using Serper.dev (Google). Returns organic results with titles, snippets, and links. Supports an optional recency window (day/week/month/year) for fresh results.",
   serperImageSearch: "Search for images using Serper.dev (Google Images). Prefers 2560\xD71440 (1440p) images and enforces a minimum of 1280\xD7720 (720p) via the Google Images tbs size filter and a client-side dimension filter. Supports an optional recency window (day/week/month/year).",
@@ -100,7 +122,7 @@ var TOOL_DESCRIPTIONS = {
   serperPlacesSearch: "Search places and businesses using Serper.dev (Google Maps). Returns addresses, phone numbers, ratings, review counts, and coordinates. Query with a business name or business type plus location.",
   serperShoppingSearch: "Search for products using Serper.dev (Google Shopping). Returns prices, sellers, delivery info, images, and per-offer ratings. Query with the bare product name and model number.",
   serperBusinessReviewsSearch: "Fetch Google Maps reviews for a specific business or place using Serper.dev. Returns reviewer snippets with author names, star ratings, and dates. Use for seller/business reputation, not editorial product reviews.",
-  serperVideoSearch: "Search for videos using Serper.dev. Returns titles, links, channel names, duration, and publish dates. Supports an optional recency window (day/week/month/year). Only return URLs from supported embeddable providers: YouTube, Vimeo, Dailymotion, Loom, Wistia, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms.",
+  serperVideoSearch: `Search for videos using Serper.dev. Returns titles, links, channel names, duration, and publish dates. Supports an optional recency window (day/week/month/year) for fresh results. ${EMBEDDABLE_VIDEO_PROVIDER_CLAUSE}`,
   serperWebpageScrape: "Fetch and render a full webpage using Serper.dev scrape API. Returns clean rendered text with its title.",
   youtubeVideoSearch: "Search YouTube using the official YouTube Data API. Returns titles, links, channel names, durations, view counts, upload dates, and direct thumbnails. All results are embeddable YouTube videos.",
   eodhdSearch: 'Resolve a company, ETF, or index name to an EODHD ticker code (e.g. "Nvidia" \u2192 NVDA.US). Use before fetching quotes, history, technicals, or news for a named entity.',
@@ -428,6 +450,10 @@ var TEMPLATES = [
   "merge",
   "text"
 ];
+var IMAGE_TASK_TEMPLATES = ["describe", "compare", "ocr"];
+function isImageTaskTemplate(template) {
+  return IMAGE_TASK_TEMPLATES.includes(template);
+}
 var ImagePlanSchema = z.object({
   resize: z.boolean().default(true).describe(
     "Whether to resize the original images before sending them to the response model. Default true when images are present."
@@ -448,10 +474,10 @@ var IntentSchema = z.object({
     'Whether search queries should be anchored on the current date so results bias toward recent information. Default true. Set to false ONLY for timeless general-knowledge, historical, or conceptual requests where recency does not matter (e.g. "how does photosynthesis work", "history of the Roman Empire", "explain quantum entanglement", creative writing).'
   ),
   imageCount: z.preprocess((val) => val === null ? 0 : val, z.number().int().min(0).max(50).default(0)).describe(
-    "Number of images to retrieve when an imageSearch tool is selected. Only set when the user explicitly requests a specific number; otherwise omit or set to 0 and the system will default to 6."
+    `Number of images to retrieve when an imageSearch tool is selected. Only set when the user explicitly requests a specific number; otherwise omit or set to 0 and the system will default to ${DEFAULT_MEDIA_COUNT}.`
   ),
   videoCount: z.preprocess((val) => val === null ? 0 : val, z.number().int().min(0).max(50).default(0)).describe(
-    "Number of videos to retrieve when a videoSearch tool is selected. Only set when the user explicitly requests a specific number; otherwise omit or set to 0 and the system will default to 6."
+    `Number of videos to retrieve when a videoSearch tool is selected. Only set when the user explicitly requests a specific number; otherwise omit or set to 0 and the system will default to ${DEFAULT_MEDIA_COUNT}.`
   ),
   reasoning: z.string().describe("Short explanation of why this template, prompt, and these tools were chosen."),
   contextSummary: z.string().default("").describe(
@@ -468,20 +494,18 @@ var IntentSchema = z.object({
     images: ImagePlanSchema.optional().describe("Image processing plan. Only present when images are attached.")
   }).default({}).describe("Execution plan for the response step.")
 });
+var MemoryClusterSummarySchema = z.object({
+  title: z.string().describe('A short noun-phrase label for the cluster (2\u20136 words), e.g. "gaming preferences" or "work projects".'),
+  summary: z.string().describe(
+    "One or two sentences summarizing what this cluster of memories is about \u2014 the shared theme, the key facts, and how they relate."
+  )
+});
 var ConsolidationVerdictSchema = z.object({
   verdict: z.enum(["keep", "redundant", "merge"]).describe(
     "keep = the new fact adds information not covered by the candidates; redundant = fully covered already (same claim, no new detail, same polarity); merge = it refines/corrects/completes a candidate and mergedText carries the fuller statement."
   ),
   mergedText: z.string().optional().describe("Required with verdict=merge: one fuller self-contained statement (full restatement, never a diff).")
 });
-var MemoryClusterSummarySchema = z.object({
-  title: z.string().describe(
-    'A short noun-phrase label for the cluster (2\u20136 words), e.g. "gaming preferences" or "work projects".'
-  ),
-  summary: z.string().describe(
-    "One or two sentences summarizing what this cluster of memories is about \u2014 the shared theme, the key facts, and how they relate."
-  )
-});
 var MemoryEnrichmentSchema = z.object({
   /**
    * 2–6 stable, reusable lowercase topic labels for the record — the existing
@@ -489,13 +513,48 @@ var MemoryEnrichmentSchema = z.object({
    */
   tags: z.array(z.string())
 });
+var FACT_KINDS = [
+  "preference",
+  "decision",
+  "state",
+  "contact",
+  "project",
+  "possession",
+  "relationship",
+  "fact"
+];
+var FACT_STABILITIES = ["durable", "volatile"];
+var ExtractedFactSchema = z.object({
+  /**
+   * The self-contained durable statement — third person, subject up front,
+   * no "this"/"that" references.
+   */
+  text: z.string(),
+  /**
+   * The lowercase entity the fact is about (default `user`; a person,
+   * product, or project name). Maintenance adjudication only ever compares
+   * facts about the SAME subject.
+   */
+  subject: z.string().optional(),
+  /**
+   * One broad lowercase PLURAL family label for THIS fact (e.g. `stocks`,
+   * `pets`, `games`) — inherits the turn-side category when omitted. Never
+   * a specific entity, product, company, or game title.
+   */
+  category: z.string().optional(),
+  /** What kind of durable thing this is (see FACT_KINDS). */
+  kind: z.enum(FACT_KINDS),
+  /** Whether a newer statement is expected to replace this one (see FACT_STABILITIES). */
+  stability: z.enum(FACT_STABILITIES)
+});
 var ExtractionSchema = z.object({
   /**
    * Durable, self-contained facts worth remembering in a later, unrelated
-   * conversation (preferences, decisions, contact details, project facts).
-   * Empty when nothing in the text is worth remembering.
+   * conversation (preferences, decisions, contact details, project facts),
+   * each carrying its maintenance metadata (subject, category, kind,
+   * stability). Empty when nothing in the text is worth remembering.
    */
-  facts: z.array(z.string()),
+  facts: z.array(ExtractedFactSchema),
   /**
    * 2–6 stable, reusable lowercase topic labels describing the text; the open
    * vocabulary that powers topic-filtered recall. Tags are NARROW and
@@ -507,9 +566,10 @@ var ExtractionSchema = z.object({
    * One broad lowercase PLURAL family label for the whole turn-side (e.g.
    * `stocks`, `pets`, `games`) — groups the narrow tags into one topic family
    * for the constellation's community tier and the relink job's per-category
-   * passes. Never a specific entity, product, company, or game title: `amd`
-   * belongs under `stocks`; `stellar blade` belongs under `games`. Optional:
-   * a turn with nothing durable may omit it.
+   * passes, and backstops facts that omit their own `category`. Never a
+   * specific entity, product, company, or game title: `amd` belongs under
+   * `stocks`; `stellar blade` belongs under `games`. Optional: a turn with
+   * nothing durable may omit it.
    */
   category: z.string().optional()
 });
@@ -1093,4 +1153,4 @@ var videolistSchema = z.object({
   internationalCoverage: internationalCoverageSchema.optional()
 });
 
-export { BLOCKED_IMAGE_HOSTS, BLOCKED_URL_HOSTS, BROWSER_TOOL_NAMES, COGNITION_LIMIT_DEFAULT, COGNITION_LIMIT_MAX, COGNITION_LIMIT_MIN, COGNITION_PURGE_BATCH, CONVICTION_TAGS, CONVICTION_TEXT_LIMIT, ConsolidationVerdictSchema, DEFAULT_VARIANT_ID, EPISODE_PROBE_LIMIT_DEFAULT, EPISODE_PROBE_LIMIT_MIN, EPISODE_RECENCY_MIDPOINT_DEFAULT, EPISODE_RECENCY_MIDPOINT_MAX, EPISODE_RECENCY_MIDPOINT_MIN, EPISODE_RECENCY_SCALE_SECONDS_DEFAULT, EPISODE_RECENCY_SCALE_SECONDS_MAX, EPISODE_RECENCY_SCALE_SECONDS_MIN, EPISODE_RECENCY_WEIGHT_DEFAULT, EPISODE_RECENCY_WEIGHT_MAX, EPISODE_RECENCY_WEIGHT_MIN, EPISODE_SCORE_THRESHOLD_DEFAULT, EPISODE_SCORE_THRESHOLD_MAX, EPISODE_SCORE_THRESHOLD_MIN, EPISODE_TAGS, EPISODE_TEXT_LIMIT, ExtractionSchema, HERO_VIDEO_TITLE_ISSUE, INSIGHTS_MAX_PER_TURN, INSIGHT_TAGS, INSIGHT_TEXT_LIMIT, IntentSchema, MEMORY_TOOL_NAMES, MemoryClusterSummarySchema, MemoryEnrichmentSchema, NON_PAGE_EXTENSIONS, TOOL_DESCRIPTIONS, TOOL_NAMES, VARIANT_NAMES, cardSchema, categorizeTools, clampCognitionLimit, clampEpisodeProbeLimit, clampEpisodeRecencyMidpoint, clampEpisodeRecencyScaleSeconds, clampEpisodeRecencyWeight, clampEpisodeScoreThreshold, compareSchema, createTextItemSchema, deriveSchemaKeys, describeSchema, discardedReferenceSchema, formatZodIssues, formatZodShape, galleryItemSchema, hasBlockedImageHost, heroVideoHasTitle, imagelistSchema, internationalCoverageSchema, isAllFieldsNullWipe, isPrivateOrLocalhost, isTrustedImageUrl, isTrustedUrl, markerSchema, memoryProfileResponseSchema, mergeCognitionProfiles, normalizeInsightPath, ocrSchema, parseStoredProfile, productSchema, referenceGalleryItemSchema, referenceLineSchema, relatedStorySchema, safeMediaUrl, safeMediaUrlOrEmpty, safeUrl, safeVideoUrl, safeVideoUrlOrEmpty, shoplistSchema, sourceSchema, stockmarketItemSchema, stockmarketListSchema, summarySchema, videoGalleryItemSchema, videolistSchema };
+export { BLOCKED_IMAGE_HOSTS, BLOCKED_URL_HOSTS, BROWSER_TOOL_NAMES, COGNITION_LIMIT_DEFAULT, COGNITION_LIMIT_MAX, COGNITION_LIMIT_MIN, COGNITION_PURGE_BATCH, CONVICTION_TAGS, CONVICTION_TEXT_LIMIT, ConsolidationVerdictSchema, DEFAULT_MEDIA_COUNT, DEFAULT_VARIANT_ID, EMBEDDABLE_VIDEO_PROVIDER_CLAUSE, EMBEDDABLE_VIDEO_PROVIDER_LABELS, EPISODE_PROBE_LIMIT_DEFAULT, EPISODE_PROBE_LIMIT_MIN, EPISODE_RECENCY_MIDPOINT_DEFAULT, EPISODE_RECENCY_MIDPOINT_MAX, EPISODE_RECENCY_MIDPOINT_MIN, EPISODE_RECENCY_SCALE_SECONDS_DEFAULT, EPISODE_RECENCY_SCALE_SECONDS_MAX, EPISODE_RECENCY_SCALE_SECONDS_MIN, EPISODE_RECENCY_WEIGHT_DEFAULT, EPISODE_RECENCY_WEIGHT_MAX, EPISODE_RECENCY_WEIGHT_MIN, EPISODE_SCORE_THRESHOLD_DEFAULT, EPISODE_SCORE_THRESHOLD_MAX, EPISODE_SCORE_THRESHOLD_MIN, EPISODE_TAGS, EPISODE_TEXT_LIMIT, EncyclopediaClassifySchema, ExtractedFactSchema, ExtractionSchema, FACT_KINDS, FACT_STABILITIES, HERO_VIDEO_TITLE_ISSUE, IMAGE_TASK_TEMPLATES, INSIGHTS_MAX_PER_TURN, INSIGHT_TAGS, INSIGHT_TEXT_LIMIT, IntentSchema, MEMORY_TOOL_NAMES, MORE_MEDIA_COUNT, MemoryClusterSummarySchema, MemoryEnrichmentSchema, NON_PAGE_EXTENSIONS, TOOL_DESCRIPTIONS, TOOL_NAMES, VARIANT_NAMES, cardSchema, categorizeTools, clampCognitionLimit, clampEpisodeProbeLimit, clampEpisodeRecencyMidpoint, clampEpisodeRecencyScaleSeconds, clampEpisodeRecencyWeight, clampEpisodeScoreThreshold, compareSchema, createTextItemSchema, deriveSchemaKeys, describeSchema, discardedReferenceSchema, formatZodIssues, formatZodShape, galleryItemSchema, hasBlockedImageHost, heroVideoHasTitle, imagelistSchema, internationalCoverageSchema, isAllFieldsNullWipe, isImageTaskTemplate, isPrivateOrLocalhost, isTrustedImageUrl, isTrustedUrl, markerSchema, memoryProfileResponseSchema, mergeCognitionProfiles, normalizeInsightPath, ocrSchema, parseStoredProfile, productSchema, referenceGalleryItemSchema, referenceLineSchema, relatedStorySchema, safeMediaUrl, safeMediaUrlOrEmpty, safeUrl, safeVideoUrl, safeVideoUrlOrEmpty, shoplistSchema, sourceSchema, stockmarketItemSchema, stockmarketListSchema, summarySchema, videoGalleryItemSchema, videolistSchema };

package/dist/tools/index.d.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod';
 import { Tool } from 'ai';
+import { M as MemoryPoint } from '../memory-point.model-C4wvvjAY.js';
+export { a as MemoryRole } from '../memory-point.model-C4wvvjAY.js';
 
 interface ProviderEndpointConfig {
     enabled: boolean;
@@ -387,27 +389,6 @@ declare const memoryPartitionRecallSchema: z.ZodObject<{
 }, z.core.$strip>;
 type MemoryPartitionRecallInput = z.infer<typeof memoryPartitionRecallSchema>;
 
-type MemoryRole = 'user' | 'assistant';
-interface MemoryPoint {
-    id: string;
-    memoryPartition?: string;
-    memoryCognition?: string;
-    role: MemoryRole;
-    sessionId?: string;
-    conversationId?: string;
-    requestId?: string;
-    text: string;
-    tags: string[];
-    path?: string;
-    createdAt: string;
-    score?: number;
-    isConsolidated?: boolean;
-    isReflected?: boolean;
-    isFriction?: boolean;
-    superseded?: boolean;
-    supersededBy?: string;
-}
-
 interface MemoryPartitionRecallDeps {
     scope: MemoryToolScope;
     searchByText: (input: {
@@ -724,4 +705,4 @@ interface VideoStats {
     lang?: string;
 }
 
-export { BRIGHT_DATA_TIMEOUT_MS, type BrightDataConfig, type BrightDataImageSearchInput, type BrightDataImageSearchResponse, type BrightDataNewsSearchInput, type BrightDataNewsSearchResponse, type BrightDataPlacesSearchInput, type BrightDataPlacesSearchResponse, type BrightDataShoppingSearchInput, type BrightDataShoppingSearchResponse, type BrightDataVideoSearchInput, type BrightDataVideoSearchResponse, type BrightDataWebSearchInput, type BrightDataWebSearchResponse, type BrightDataWebpageScrapeInput, type BrightDataWebpageScrapeResponse, type EodhdConfig, type EodhdNewsConfig, type FilterVariant, HEADERS, MIN_IMAGE_HEIGHT, MIN_IMAGE_WIDTH, type MarketDailyBar, type MemoryCognitionForgetInput, type MemoryCognitionRememberInput, type MemoryPartitionDeleteInput, type MemoryPartitionRecallInput, type MemoryPartitionRememberInput, type MemoryPoint, type MemoryRole, type MemoryToolScope, type ProviderEndpointConfig, RECENCY_DESCRIPTION, type ResolvableOffer, SEARCH_RETRIES, SEARCH_TIMEOUT_MS, SOURCE, STANDALONE_QUERY_DESCRIPTION, STANDALONE_QUERY_TOOL_CLAUSE, type SearchRecency, type SerperBusinessReviewsSearchInput, type SerperBusinessReviewsSearchResponse, type SerperConfig, type SerperImageSearchInput, type SerperImageSearchResponse, type SerperNewsSearchInput, type SerperNewsSearchResponse, type SerperPlacesSearchInput, type SerperPlacesSearchResponse, type SerperShoppingSearchInput, type SerperShoppingSearchResponse, type SerperVideoSearchInput, type SerperVideoSearchResponse, type SerperWebSearchInput, type SerperWebSearchResponse, type SerperWebpageScrapeInput, type SerperWebpageScrapeResponse, type SourcesConfig, type ToolConfigSnapshot, type ToolDependencies, type ToolLogger, type ToolSummaryFn, type ToolWithSummary, type Variant, type VideoStats, type WebFetchInput, type YoutubeConfig, type YoutubeSearchResponse, type YoutubeVideoSearchInput, type YoutubeVideosResponse, applyLocaleParams, applyRecencyParam, brightDataImageSearchSchema, brightDataNewsSearchSchema, brightDataPlacesSearchSchema, brightDataShoppingSearchSchema, brightDataVideoSearchSchema, brightDataWebSearchSchema, brightDataWebpageScrapeSchema, buildGoogleUrl, buildYoutubeThumbnailUrl, createBrightDataImageSearch, createBrightDataNewsSearch, createBrightDataPlacesSearch, createBrightDataShoppingSearch, createBrightDataVideoSearch, createBrightDataWebSearch, createBrightDataWebpageScrape, createMemoryCognitionForgetTool, createMemoryCognitionRememberTool, createMemoryPartitionDeleteTool, createMemoryPartitionRecallTool, createMemoryPartitionRememberTool, createSerperBusinessReviewsSearch, createSerperImageSearch, createSerperNewsSearch, createSerperPlacesSearch, createSerperShoppingSearch, createSerperVideoSearch, createSerperWebSearch, createSerperWebpageScrape, createVariantRequestTool, createWebFetchTool, createYoutubeVideoSearch, defaultSummarize, engineEnabled, fetchWithTimeout, isGoogleHostUrl, localizedQuerySuffix, meetsMinimumImageDimensions, memoryCognitionForgetSchema, memoryCognitionRememberSchema, memoryPartitionDeleteSchema, memoryPartitionRecallSchema, memoryPartitionRememberSchema, pickMerchantResult, requestBrightData, resolveSerperShopOfferLinks, serperBusinessReviewsSearchSchema, serperImageSearchSchema, serperNewsSearchSchema, serperPlacesSearchSchema, serperShoppingSearchSchema, serperVideoSearchSchema, serperWebSearchSchema, serperWebpageScrapeSchema, storeHostToken, summarizeContent, summarizeFound, summarizeResults, tbsSizeLabelForPixels, variantRequestSchema, webFetchSchema, withSummary, youtubeVideoSearchSchema };
+export { BRIGHT_DATA_TIMEOUT_MS, type BrightDataConfig, type BrightDataImageSearchInput, type BrightDataImageSearchResponse, type BrightDataNewsSearchInput, type BrightDataNewsSearchResponse, type BrightDataPlacesSearchInput, type BrightDataPlacesSearchResponse, type BrightDataShoppingSearchInput, type BrightDataShoppingSearchResponse, type BrightDataVideoSearchInput, type BrightDataVideoSearchResponse, type BrightDataWebSearchInput, type BrightDataWebSearchResponse, type BrightDataWebpageScrapeInput, type BrightDataWebpageScrapeResponse, type EodhdConfig, type EodhdNewsConfig, type FilterVariant, HEADERS, MIN_IMAGE_HEIGHT, MIN_IMAGE_WIDTH, type MarketDailyBar, type MemoryCognitionForgetInput, type MemoryCognitionRememberInput, type MemoryPartitionDeleteInput, type MemoryPartitionRecallInput, type MemoryPartitionRememberInput, MemoryPoint, type MemoryToolScope, type ProviderEndpointConfig, RECENCY_DESCRIPTION, type ResolvableOffer, SEARCH_RETRIES, SEARCH_TIMEOUT_MS, SOURCE, STANDALONE_QUERY_DESCRIPTION, STANDALONE_QUERY_TOOL_CLAUSE, type SearchRecency, type SerperBusinessReviewsSearchInput, type SerperBusinessReviewsSearchResponse, type SerperConfig, type SerperImageSearchInput, type SerperImageSearchResponse, type SerperNewsSearchInput, type SerperNewsSearchResponse, type SerperPlacesSearchInput, type SerperPlacesSearchResponse, type SerperShoppingSearchInput, type SerperShoppingSearchResponse, type SerperVideoSearchInput, type SerperVideoSearchResponse, type SerperWebSearchInput, type SerperWebSearchResponse, type SerperWebpageScrapeInput, type SerperWebpageScrapeResponse, type SourcesConfig, type ToolConfigSnapshot, type ToolDependencies, type ToolLogger, type ToolSummaryFn, type ToolWithSummary, type Variant, type VideoStats, type WebFetchInput, type YoutubeConfig, type YoutubeSearchResponse, type YoutubeVideoSearchInput, type YoutubeVideosResponse, applyLocaleParams, applyRecencyParam, brightDataImageSearchSchema, brightDataNewsSearchSchema, brightDataPlacesSearchSchema, brightDataShoppingSearchSchema, brightDataVideoSearchSchema, brightDataWebSearchSchema, brightDataWebpageScrapeSchema, buildGoogleUrl, buildYoutubeThumbnailUrl, createBrightDataImageSearch, createBrightDataNewsSearch, createBrightDataPlacesSearch, createBrightDataShoppingSearch, createBrightDataVideoSearch, createBrightDataWebSearch, createBrightDataWebpageScrape, createMemoryCognitionForgetTool, createMemoryCognitionRememberTool, createMemoryPartitionDeleteTool, createMemoryPartitionRecallTool, createMemoryPartitionRememberTool, createSerperBusinessReviewsSearch, createSerperImageSearch, createSerperNewsSearch, createSerperPlacesSearch, createSerperShoppingSearch, createSerperVideoSearch, createSerperWebSearch, createSerperWebpageScrape, createVariantRequestTool, createWebFetchTool, createYoutubeVideoSearch, defaultSummarize, engineEnabled, fetchWithTimeout, isGoogleHostUrl, localizedQuerySuffix, meetsMinimumImageDimensions, memoryCognitionForgetSchema, memoryCognitionRememberSchema, memoryPartitionDeleteSchema, memoryPartitionRecallSchema, memoryPartitionRememberSchema, pickMerchantResult, requestBrightData, resolveSerperShopOfferLinks, serperBusinessReviewsSearchSchema, serperImageSearchSchema, serperNewsSearchSchema, serperPlacesSearchSchema, serperShoppingSearchSchema, serperVideoSearchSchema, serperWebSearchSchema, serperWebpageScrapeSchema, storeHostToken, summarizeContent, summarizeFound, summarizeResults, tbsSizeLabelForPixels, variantRequestSchema, webFetchSchema, withSummary, youtubeVideoSearchSchema };

package/dist/tools/index.mjs

@@ -520,6 +520,10 @@ var brightDataVideoSearchSchema = z.object({
   lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
 });
 
+// src/schemas/constants/embeddable-video-providers.constant.ts
+var EMBEDDABLE_VIDEO_PROVIDER_LABELS = "YouTube, Vimeo, Dailymotion, Loom, Wistia";
+var EMBEDDABLE_VIDEO_PROVIDER_CLAUSE = `Only return URLs from supported embeddable providers: ${EMBEDDABLE_VIDEO_PROVIDER_LABELS}, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms.`;
+
 // src/tools/helpers/localized-query-suffix.helper.ts
 function localizedQuerySuffix(lang) {
   if (!lang) return "";
@@ -585,7 +589,7 @@ function mapBrightDataVideoResult(r) {
 // src/tools/bright-data/video-search.tool.ts
 function createBrightDataVideoSearch(deps) {
   return tool({
-    description: 'Search for videos using Bright Data SERP API (Google Videos). Returns titles, links, snippets, and duration. Only return URLs from supported embeddable providers: YouTube, Vimeo, Dailymotion, Loom, Wistia, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms. Pass recency ("day"|"week"|"month"|"year") to restrict to recently uploaded videos. ' + STANDALONE_QUERY_TOOL_CLAUSE,
+    description: `Search for videos using Bright Data SERP API (Google Videos). Returns titles, links, snippets, and duration. ${EMBEDDABLE_VIDEO_PROVIDER_CLAUSE} Pass recency ("day"|"week"|"month"|"year") to restrict to recently uploaded videos. ` + STANDALONE_QUERY_TOOL_CLAUSE,
     inputSchema: brightDataVideoSearchSchema,
     execute: async ({ query, count: reqCount, recency, lang }) => {
       const cfg = deps.getLiveConfig().brightData;
@@ -1439,7 +1443,7 @@ function mapSerperVideoResult(input) {
 // src/tools/serper/video-search.tool.ts
 function createSerperVideoSearch(deps) {
   return tool({
-    description: 'Search for videos using Serper.dev. Returns titles, links, channel names, duration, and publish dates. Only return URLs from supported embeddable providers: YouTube, Vimeo, Dailymotion, Loom, Wistia, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms. Pass recency ("day"|"week"|"month"|"year") to restrict to recently uploaded videos. ' + STANDALONE_QUERY_TOOL_CLAUSE,
+    description: `Search for videos using Serper.dev. Returns titles, links, channel names, duration, and publish dates. ${EMBEDDABLE_VIDEO_PROVIDER_CLAUSE} Pass recency ("day"|"week"|"month"|"year") to restrict to recently uploaded videos. ` + STANDALONE_QUERY_TOOL_CLAUSE,
     inputSchema: serperVideoSearchSchema,
     execute: async ({ query, count: reqCount, recency, lang }) => {
       const cfg = deps.getLiveConfig().serper;

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.15",
+  "version": "0.1.17",
   "packageManager": "pnpm@11.25.0",
   "license": "MIT",
   "type": "module",
@@ -60,7 +60,7 @@
     "turndown": "^7.2.4"
   },
   "peerDependencies": {
-    "ai": "^7.0.89",
+    "ai": "^7.0.90",
     "zod": "^4.5.4"
   },
   "peerDependenciesMeta": {