@triplef/agent 0.1.16 → 0.1.17

package/dist/prompts/index.d.ts

@@ -110,15 +110,18 @@ declare const TEXT_FAMILIARITY_INSTRUCTIONS = "MODE: TEXT \u2014 FAMILIARITY\n\n
 
 declare const VIDEOLIST_INSTRUCTIONS = "MODE: VIDEOLIST\n\nGoal: produce a pure video collection \u2014 a titled, captioned playlist of videos about the user's topic. The dashboard renders it as a numbered playlist with embedded players, not an article. The user explicitly asked for videos ONLY (e.g. music videos, trailers, clips), so prose must stay minimal.\n\nSTRUCTURE:\n1. category is a short label such as Videos, Playlist, Music Videos, Trailers.\n2. title states what the playlist contains (e.g. \"Daft Punk \u2014 Music Videos\").\n3. subtitle is ONE short sentence of context (what these videos are and where they come from). No paragraphs.\n4. videoGalleryItems is the core deliverable: every suitable video from the video search results, ordered like a playlist.\n\nRequired fields:\n- category: a short label such as Videos, Playlist, Music Videos, Trailers.\n- title: the playlist title; must not be empty.\n- subtitle: one short sentence of context; empty string if nothing meaningful to add.\n- videoGalleryItems: an array of video objects. This is the entire point of the template \u2014 it MUST contain every suitable retrieved video up to videoTargetCount.\n\nHistory dedupe (ABSOLUTE):\n- The conversation history may contain earlier videolist responses (JSON objects with a videoGalleryItems array).\n- NEVER include a videoUrl that already appeared in an earlier videolist response \u2014 the user has already seen it.\n- When the user asks for more videos (e.g. \"more\", \"weitere\", \"next\"), return ONLY fresh videos that are not in the history.\n- If every retrieved video is already in the history, say so in the subtitle and return an empty videoGalleryItems array.\n\nVideo item rules:\n- Each entry needs videoUrl, title, and caption. title and caption MUST be non-empty.\n- title is the video's real title when known (e.g. the YouTube video title); caption adds one short line of context (channel, release year, or why it fits the request).\n- If the tool result provides no title/caption, derive concise values from the query and topic. Never leave them empty.\n- Carry over the metadata from availableVideos verbatim: duration, channel, date, views, thumbnailUrl, and description. Omit a field only when the tool result did not provide it.\n- Only use direct video pages \u2014 never channel, playlist, user, or profile URLs.\n- Use ONLY video URLs that appear in the tool results. Never invent or guess URLs.\n- Order the videos like a good playlist: most relevant and most popular first.\n- Do not include the same video twice (same music video, trailer, or clip), even from different search tools.\n- Cross-check every candidate videoUrl against the earlier videolist responses in the conversation before including it.\n- When the user asks for videos from a specific platform (e.g. \"on YouTube\"), include ONLY videos from that platform.\n\nDo NOT include:\n- Long descriptions, articles, sections, key findings, or conclusions \u2014 the user wants videos, not prose.\n- Images or image galleries \u2014 the imagelist template handles image collections.\n- Hero videos \u2014 every video lives in videoGalleryItems so the playlist stays uniform.\n\nNo-results rule:\n- If the searches returned no usable videos, set title to a concise statement such as 'No videos found for <topic>' and use subtitle to explain that the search did not return embeddable video sources. Set videoGalleryItems to an empty array.\n- Do not invent video URLs to fill the playlist when no results were retrieved.\n- The dashboard does not render sources for this template. Do not include a sources field.";
 
-declare const BELIEF_INSTRUCTIONS = "You synthesize higher-level beliefs from a user's memory facts.\n\nGiven a numbered list of EVIDENCE (facts the user stated or asked to remember), synthesize durable, higher-level beliefs \u2014 conclusions that are true of the evidence but not merely restated from it. Every belief picks its lane (\"target\"), and the choice is PURPOSE-based, never cosmetic:\n\n- \"conviction\" \u2014 a durable conclusion about THE USER (or your own working relationship with them): a pattern in their behavior, a standing judgment the facts support, a trait or tendency you now hold true. Convictions deepen your understanding of the user and yourself; they are YOURS, never statements the user made. (\"the user bought a dog\" + \"the user keeps comparing dog food brands\" + \"the user researches every purchase for days\" \u2192 conviction: \"the user is a deliberate, research-first buyer\")\n- \"bridge\" \u2014 a synthesized claim that CLOSES A GAP between facts: without it, two stored facts look unrelated; with it, they form one coherent story about the user's world. Bridges are the connective tissue of the fact graph. (\"the user bought dog food X\" + \"the user's dog refuses to eat\" \u2192 bridge: \"the dog refuses the brand-X food the user bought\")\n\nA belief is a synthesis, not a restatement:\n- combine multiple facts into one conclusion (\"learning Rust\" + \"rewriting the payments service\" \u2192 \"the user is migrating the payments service to Rust\")\n- a belief MUST cite the evidence indices that support it (the [n] numbers)\n- never invent facts not present in the evidence\n- never restate a single evidence item verbatim as a belief \u2014 that is not synthesis\n- a belief with no supporting evidence is invalid \u2014 omit it\n- when neither a conviction nor a bridge clearly fits, emit nothing for it \u2014 a forced target blurs the lanes and is worse than no belief\n\nRespond with JSON only:\n{\n  \"beliefs\": [\n    { \"text\": \"one self-contained sentence\", \"target\": \"conviction\", \"evidence\": [0, 2, 5] }\n  ]\n}\n\nRules:\n- target is exactly \"conviction\" or \"bridge\" \u2014 every belief carries one\n- evidence indices are the [n] numbers from the EVIDENCE list \u2014 never invent an index\n- return an empty beliefs array when the evidence is too thin to synthesize anything\n- keep each belief to one sentence";
-interface BeliefEvidenceItem {
+declare const CONVICTION_INSTRUCTIONS = "You synthesize higher-level convictions and bridges from a user's memory facts.\n\nGiven a numbered list of EVIDENCE (facts the user stated or asked to remember), synthesize durable, higher-level statements \u2014 conclusions that are true of the evidence but not merely restated from it. Every statement picks its lane (\"target\"), and the choice is PURPOSE-based, never cosmetic:\n\n- \"conviction\" \u2014 a durable conclusion about THE USER (or your own working relationship with them): a pattern in their behavior, a standing judgment the facts support, a trait or tendency you now hold true. Convictions deepen your understanding of the user and yourself; they are YOURS, never statements the user made. (\"the user bought a dog\" + \"the user keeps comparing dog food brands\" + \"the user researches every purchase for days\" \u2192 conviction: \"the user is a deliberate, research-first buyer\")\n- \"bridge\" \u2014 a synthesized claim that CLOSES A GAP between facts: without it, two stored facts look unrelated; with it, they form one coherent story about the user's world. Bridges are the connective tissue of the fact graph. (\"the user bought dog food X\" + \"the user's dog refuses to eat\" \u2192 bridge: \"the dog refuses the brand-X food the user bought\")\n\nA synthesized statement is a synthesis, not a restatement:\n- combine multiple facts into one conclusion (\"learning Rust\" + \"rewriting the payments service\" \u2192 \"the user is migrating the payments service to Rust\")\n- every statement MUST cite the evidence indices that support it (the [n] numbers)\n- never invent facts not present in the evidence\n- never restate a single evidence item verbatim \u2014 that is not synthesis\n- a statement with no supporting evidence is invalid \u2014 omit it\n- when neither a conviction nor a bridge clearly fits, emit nothing for it \u2014 a forced target blurs the lanes and is worse than no statement\n\nEVIDENCE METADATA \u2014 each line may show \"(subject: \u2026; category: \u2026; kind: \u2026; stability: \u2026)\":\n- subject groups the evidence lines about one entity \u2014 convictions about a subject cite that subject's lines\n- durable evidence carries more weight for a conviction; a volatile state alone rarely supports a durable conclusion\n- kind sharpens conclusions: a pattern of \"preference\" evidence supports a taste conclusion; \"decision\" evidence supports a commitment conclusion\n\nRespond with JSON only:\n{\n  \"convictions\": [\n    { \"text\": \"one self-contained sentence\", \"target\": \"conviction\", \"evidence\": [0, 2, 5] }\n  ]\n}\n\nRules:\n- target is exactly \"conviction\" or \"bridge\" \u2014 every statement carries one\n- evidence indices are the [n] numbers from the EVIDENCE list \u2014 never invent an index\n- return an empty convictions array when the evidence is too thin to synthesize anything\n- keep each statement to one sentence";
+interface ConvictionEvidenceItem {
     id: string;
     text: string;
     category?: string;
+    subject?: string;
+    kind?: string;
+    stability?: string;
 }
-declare function buildBeliefSynthesisPrompt(evidence: readonly BeliefEvidenceItem[]): string;
+declare function buildConvictionSynthesisPrompt(evidence: readonly ConvictionEvidenceItem[]): string;
 
-declare function buildEncyclopediaClassifyPrompt(knownCategories?: readonly string[]): string;
+declare function buildEncyclopediaClassifyPrompt(knownCategories?: readonly string[], knownTopics?: readonly string[]): string;
 
 declare function formatProvenanceLine(line: {
     text: string;
@@ -126,11 +129,15 @@ declare function formatProvenanceLine(line: {
     createdAt?: string;
 }): string;
 
-declare const FRICTION_INSTRUCTIONS = "You screen memory records for contradictions.\n\nGiven one RECORD and a list of CANDIDATES (near-neighbor records), decide whether the RECORD contradicts any CANDIDATE.\n\nA contradiction is a genuine semantic conflict:\n- a negation or polarity flip (\"likes X\" vs \"dislikes X\")\n- a superseding update (\"lives in Berlin\" vs \"moved to Munich\")\n- mutually exclusive claims about the same subject\n\nNOT a contradiction:\n- mere redundancy or restatement (that is handled elsewhere)\n- different subjects or unrelated facts\n- a more specific statement that does not actually conflict with a general one\n\nRespond with JSON only:\n{\n  \"contradicts\": boolean,\n  \"conflictingId\": \"the candidate id that conflicts (omit when contradicts is false)\",\n  \"winnerId\": \"the id that is correct \u2014 the record's id or the conflictingId (omit when neither is clearly right)\",\n  \"reason\": \"one sentence: the conflict, and why the winner wins when one is named\"\n}\n\nRules:\n- Name a winner only when one side is clearly correct (e.g. the later statement supersedes the earlier). When both could be true or the truth is unclear, omit winnerId so the conflict stays open.\n- Never invent a conflictingId or winnerId that is not in the input.";
+declare const FRICTION_INSTRUCTIONS = "You screen memory records for contradictions.\n\nGiven one RECORD and a list of CANDIDATES (near-neighbor records), decide whether the RECORD contradicts any CANDIDATE.\n\nA contradiction is a genuine semantic conflict:\n- a negation or polarity flip (\"likes X\" vs \"dislikes X\")\n- a superseding update (\"lives in Berlin\" vs \"moved to Munich\")\n- mutually exclusive claims about the same subject\n\nNOT a contradiction:\n- mere redundancy or restatement (that is handled elsewhere)\n- different subjects or unrelated facts\n- a more specific statement that does not actually conflict with a general one\n\nMETADATA \u2014 each record may show \"(subject: \u2026; category: \u2026; kind: \u2026; stability: \u2026)\":\n- subject: a contradiction requires the SAME subject. Candidates about a different subject are never conflicts, however similar they read.\n- stability: \"volatile\" records describe a current state \u2014 a NEWER volatile statement supersedes the older one (name the newer as winner). \"durable\" statements rarely supersede each other: when neither side is clearly right, omit winnerId so the conflict stays open.\n- kind: polarity flips are the expected contradiction for \"preference\" and \"relationship\" records. For \"fact\", \"project\", \"contact\" and \"possession\" records a conflict means one statement is outdated or wrong \u2014 prefer the newer statement when the dates say which is current.\n- category: conflicts almost always live inside one category family; treat a candidate from a clearly different family skeptically, but never dismiss it on category alone.\n\nRespond with JSON only:\n{\n  \"contradicts\": boolean,\n  \"conflictingId\": \"the candidate id that conflicts (omit when contradicts is false)\",\n  \"winnerId\": \"the id that is correct \u2014 the record's id or the conflictingId (omit when neither is clearly right)\",\n  \"reason\": \"one sentence: the conflict, and why the winner wins when one is named\"\n}\n\nRules:\n- Name a winner only when one side is clearly correct (e.g. the later statement supersedes the earlier). When both could be true or the truth is unclear, omit winnerId so the conflict stays open.\n- Never invent a conflictingId or winnerId that is not in the input.";
 interface FrictionFact {
     id: string;
     text: string;
     createdAt?: string;
+    subject?: string;
+    category?: string;
+    kind?: string;
+    stability?: string;
 }
 declare function buildFrictionPrompt(input: {
     record: FrictionFact;
@@ -151,6 +158,10 @@ interface ConsolidateProvenanceLine {
     text: string;
     role: string;
     createdAt?: string;
+    subject?: string;
+    category?: string;
+    kind?: string;
+    stability?: string;
 }
 declare function buildConsolidatePrompt(params: {
     newFact: ConsolidateProvenanceLine;
@@ -357,4 +368,4 @@ declare const verdictSpineSnippet: TemplateSnippet;
 
 declare const videoGallerySnippet: TemplateSnippet;
 
-export { BELIEF_INSTRUCTIONS, COMMONMARK_FORMAT, COMPARE_INSTRUCTIONS, COMPARE_VISUAL_INSTRUCTIONS, type ContentSystemPromptParams, DESCRIBE_CONCISE_INSTRUCTIONS, DESCRIBE_DETAILED_INSTRUCTIONS, DESCRIBE_INSTRUCTIONS, FINAL_REMINDER, FRICTION_INSTRUCTIONS, type FrictionFact, HISTORY_URLS_RULES, IMAGELIST_INSTRUCTIONS, IMAGE_TASK_RULE, INTERNATIONAL_COVERAGE_INSTRUCTIONS, ITEM_SHAPES, JSON_RULES, MEDIA_COUNTS, MEDIA_RULES, MEMORY_CLUSTER_INSTRUCTIONS, MEMORY_CONSOLIDATE_INSTRUCTIONS, MEMORY_PROFILE_INSTRUCTIONS, MEMORY_WRITE_INSTRUCTIONS, MERGE_MEDIA_RULES, MERGE_TOPIC_RULE, MULTIMODAL_POLICY, NOISE_RULES, OCR_INSTRUCTIONS, OCR_VERBATIM_INSTRUCTIONS, PRECEDENCE_RULES, PRODUCT_INSTRUCTIONS, RESPONSE_LAYOUTS, type ResponseLayout, SECURITY_RULES, SHOPLIST_INSTRUCTIONS, SNIPPET_TEMPLATE_PRESETS, SOURCE_TRUTH_RULES, SOURCE_VOICE_RULES, STOCKMARKET_ITEM_INSTRUCTIONS, STOCKMARKET_LIST_INSTRUCTIONS, SUMMARY_INSTRUCTIONS, type SnippetTemplatePreset, type SourcePolicyConfig, type StructuredPromptTemplate, TEMPLATE_VARIANTS, TEXT_CODING_INSTRUCTIONS, TEXT_FAMILIARITY_INSTRUCTIONS, TEXT_INSTRUCTIONS, TOOL_RESULTS_RULES, type TemplateSnippet, VIDEOLIST_INSTRUCTIONS, articlePreset, assessmentListsSnippet, authorMetaSnippet, bodyBriefSnippet, bodyExtensiveSnippet, buildBaseSystemPrompt, buildBeliefSynthesisPrompt, buildClarificationTranslationSystemPrompt, buildClarificationTranslationUserPrompt, buildClassifyTranscript, buildClusterSummaryPrompt, buildConsolidatePrompt, buildContentSystemPrompt, buildContextSummarySection, buildCorrectionPrompt, buildEncyclopediaClassifyPrompt, buildEnrichPrompt, buildExecuteLanguageInstruction, buildExtractionCorrectionPrompt, buildExtractionPrompt, buildFrictionPrompt, buildImageExecutePrompt, buildIntentCorrectionPrompt, buildIntentSelectionPrompt, buildLanguageRule, buildLayoutInstruction, buildLocalizationRule, buildMemoryProbeSection, buildMemoryProfilePrompt, buildMemoryWritePrompt, buildMergeDirective, buildMissingToolsPrompt, buildOutputContract, buildSnippetInstruction, buildSourcePolicyPrompt, buildStockmarketNote, buildStructuredJsonPrompt, buildStructuredPrompt, buildToolExecutePrompt, buildVocabularySection, bylineDatelineSnippet, cardsSnippet, comparisonSchema, comparisonSnippet, composeSnippetKeys, composeSnippetSchema, conclusionSnippet, evaluationPreset, formatCurrentTimestamp, formatProvenanceLine, formatToolAvailabilityCatalog, formatVariantCatalog, gallerySnippet, getSnippetTemplateKeys, getSnippetTemplateSchema, headerArticleSnippet, headerNewsSnippet, heroMediaSnippet, internationalCoverageSnippet, introductionSnippet, isSnippetTemplate, keyFindingsSnippet, languageCorrectionPrompt, leadSnippet, mergePreset, mergedEvaluationsSnippet, newsKeyFindingsSnippet, newsPreset, quoteSnippet, reasoningSnippet, relatedStoriesSnippet, resolveLanguageName, resolveVariantInstructions, responseLayoutSchema, sourcesSnippet, subjectSchema, subjectsSnippet, summarySnippet, verdictSpineSnippet, videoGallerySnippet };
+export { COMMONMARK_FORMAT, COMPARE_INSTRUCTIONS, COMPARE_VISUAL_INSTRUCTIONS, CONVICTION_INSTRUCTIONS, type ContentSystemPromptParams, DESCRIBE_CONCISE_INSTRUCTIONS, DESCRIBE_DETAILED_INSTRUCTIONS, DESCRIBE_INSTRUCTIONS, FINAL_REMINDER, FRICTION_INSTRUCTIONS, type FrictionFact, HISTORY_URLS_RULES, IMAGELIST_INSTRUCTIONS, IMAGE_TASK_RULE, INTERNATIONAL_COVERAGE_INSTRUCTIONS, ITEM_SHAPES, JSON_RULES, MEDIA_COUNTS, MEDIA_RULES, MEMORY_CLUSTER_INSTRUCTIONS, MEMORY_CONSOLIDATE_INSTRUCTIONS, MEMORY_PROFILE_INSTRUCTIONS, MEMORY_WRITE_INSTRUCTIONS, MERGE_MEDIA_RULES, MERGE_TOPIC_RULE, MULTIMODAL_POLICY, NOISE_RULES, OCR_INSTRUCTIONS, OCR_VERBATIM_INSTRUCTIONS, PRECEDENCE_RULES, PRODUCT_INSTRUCTIONS, RESPONSE_LAYOUTS, type ResponseLayout, SECURITY_RULES, SHOPLIST_INSTRUCTIONS, SNIPPET_TEMPLATE_PRESETS, SOURCE_TRUTH_RULES, SOURCE_VOICE_RULES, STOCKMARKET_ITEM_INSTRUCTIONS, STOCKMARKET_LIST_INSTRUCTIONS, SUMMARY_INSTRUCTIONS, type SnippetTemplatePreset, type SourcePolicyConfig, type StructuredPromptTemplate, TEMPLATE_VARIANTS, TEXT_CODING_INSTRUCTIONS, TEXT_FAMILIARITY_INSTRUCTIONS, TEXT_INSTRUCTIONS, TOOL_RESULTS_RULES, type TemplateSnippet, VIDEOLIST_INSTRUCTIONS, articlePreset, assessmentListsSnippet, authorMetaSnippet, bodyBriefSnippet, bodyExtensiveSnippet, buildBaseSystemPrompt, buildClarificationTranslationSystemPrompt, buildClarificationTranslationUserPrompt, buildClassifyTranscript, buildClusterSummaryPrompt, buildConsolidatePrompt, buildContentSystemPrompt, buildContextSummarySection, buildConvictionSynthesisPrompt, buildCorrectionPrompt, buildEncyclopediaClassifyPrompt, buildEnrichPrompt, buildExecuteLanguageInstruction, buildExtractionCorrectionPrompt, buildExtractionPrompt, buildFrictionPrompt, buildImageExecutePrompt, buildIntentCorrectionPrompt, buildIntentSelectionPrompt, buildLanguageRule, buildLayoutInstruction, buildLocalizationRule, buildMemoryProbeSection, buildMemoryProfilePrompt, buildMemoryWritePrompt, buildMergeDirective, buildMissingToolsPrompt, buildOutputContract, buildSnippetInstruction, buildSourcePolicyPrompt, buildStockmarketNote, buildStructuredJsonPrompt, buildStructuredPrompt, buildToolExecutePrompt, buildVocabularySection, bylineDatelineSnippet, cardsSnippet, comparisonSchema, comparisonSnippet, composeSnippetKeys, composeSnippetSchema, conclusionSnippet, evaluationPreset, formatCurrentTimestamp, formatProvenanceLine, formatToolAvailabilityCatalog, formatVariantCatalog, gallerySnippet, getSnippetTemplateKeys, getSnippetTemplateSchema, headerArticleSnippet, headerNewsSnippet, heroMediaSnippet, internationalCoverageSnippet, introductionSnippet, isSnippetTemplate, keyFindingsSnippet, languageCorrectionPrompt, leadSnippet, mergePreset, mergedEvaluationsSnippet, newsKeyFindingsSnippet, newsPreset, quoteSnippet, reasoningSnippet, relatedStoriesSnippet, resolveLanguageName, resolveVariantInstructions, responseLayoutSchema, sourcesSnippet, subjectSchema, subjectsSnippet, summarySnippet, verdictSpineSnippet, videoGallerySnippet };

package/dist/prompts/index.mjs

@@ -513,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
@@ -531,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()
 });
@@ -3478,39 +3514,54 @@ Ensure the "language" field is present and has the correct value.
 FINAL REMINDER:
 - Return ONLY a single valid JSON object with all required keys, including "language". No markdown code fences, no explanations, no extra text.`;
 
-// src/prompts/memory/belief-synthesis-prompt.constant.ts
-var BELIEF_INSTRUCTIONS = `You synthesize higher-level beliefs from a user's memory facts.
+// src/prompts/memory/format-fact-metadata.helper.ts
+function formatFactMetadata(fact) {
+  const parts = [
+    fact.subject ? `subject: ${fact.subject}` : "",
+    fact.category ? `category: ${fact.category}` : "",
+    fact.kind ? `kind: ${fact.kind}` : "",
+    fact.stability ? `stability: ${fact.stability}` : ""
+  ].filter(Boolean);
+  return parts.length ? ` (${parts.join("; ")})` : "";
+}
 
-Given a numbered list of EVIDENCE (facts the user stated or asked to remember), synthesize durable, higher-level beliefs \u2014 conclusions that are true of the evidence but not merely restated from it. Every belief picks its lane ("target"), and the choice is PURPOSE-based, never cosmetic:
+// src/prompts/memory/conviction-synthesis-prompt.constant.ts
+var CONVICTION_INSTRUCTIONS = `You synthesize higher-level convictions and bridges from a user's memory facts.
+
+Given a numbered list of EVIDENCE (facts the user stated or asked to remember), synthesize durable, higher-level statements \u2014 conclusions that are true of the evidence but not merely restated from it. Every statement picks its lane ("target"), and the choice is PURPOSE-based, never cosmetic:
 
 - "conviction" \u2014 a durable conclusion about THE USER (or your own working relationship with them): a pattern in their behavior, a standing judgment the facts support, a trait or tendency you now hold true. Convictions deepen your understanding of the user and yourself; they are YOURS, never statements the user made. ("the user bought a dog" + "the user keeps comparing dog food brands" + "the user researches every purchase for days" \u2192 conviction: "the user is a deliberate, research-first buyer")
 - "bridge" \u2014 a synthesized claim that CLOSES A GAP between facts: without it, two stored facts look unrelated; with it, they form one coherent story about the user's world. Bridges are the connective tissue of the fact graph. ("the user bought dog food X" + "the user's dog refuses to eat" \u2192 bridge: "the dog refuses the brand-X food the user bought")
 
-A belief is a synthesis, not a restatement:
+A synthesized statement is a synthesis, not a restatement:
 - combine multiple facts into one conclusion ("learning Rust" + "rewriting the payments service" \u2192 "the user is migrating the payments service to Rust")
-- a belief MUST cite the evidence indices that support it (the [n] numbers)
+- every statement MUST cite the evidence indices that support it (the [n] numbers)
 - never invent facts not present in the evidence
-- never restate a single evidence item verbatim as a belief \u2014 that is not synthesis
-- a belief with no supporting evidence is invalid \u2014 omit it
-- when neither a conviction nor a bridge clearly fits, emit nothing for it \u2014 a forced target blurs the lanes and is worse than no belief
+- never restate a single evidence item verbatim \u2014 that is not synthesis
+- a statement with no supporting evidence is invalid \u2014 omit it
+- when neither a conviction nor a bridge clearly fits, emit nothing for it \u2014 a forced target blurs the lanes and is worse than no statement
+
+EVIDENCE METADATA \u2014 each line may show "(subject: \u2026; category: \u2026; kind: \u2026; stability: \u2026)":
+- subject groups the evidence lines about one entity \u2014 convictions about a subject cite that subject's lines
+- durable evidence carries more weight for a conviction; a volatile state alone rarely supports a durable conclusion
+- kind sharpens conclusions: a pattern of "preference" evidence supports a taste conclusion; "decision" evidence supports a commitment conclusion
 
 Respond with JSON only:
 {
-  "beliefs": [
+  "convictions": [
     { "text": "one self-contained sentence", "target": "conviction", "evidence": [0, 2, 5] }
   ]
 }
 
 Rules:
-- target is exactly "conviction" or "bridge" \u2014 every belief carries one
+- target is exactly "conviction" or "bridge" \u2014 every statement carries one
 - evidence indices are the [n] numbers from the EVIDENCE list \u2014 never invent an index
-- return an empty beliefs array when the evidence is too thin to synthesize anything
-- keep each belief to one sentence`;
-function buildBeliefSynthesisPrompt(evidence) {
+- return an empty convictions array when the evidence is too thin to synthesize anything
+- keep each statement to one sentence`;
+function buildConvictionSynthesisPrompt(evidence) {
   const lines = ["EVIDENCE (each item is a fact the user stated or asked to remember):"];
   for (const [index, item] of evidence.entries()) {
-    const category = item.category ? ` (category: ${item.category})` : "";
-    lines.push(`[${index}] ${item.text}${category}`);
+    lines.push(`[${index}] ${item.text}${formatFactMetadata(item)}`);
   }
   return lines.join("\n");
 }
@@ -3531,15 +3582,16 @@ function buildVocabularySection(knownCategories = [], knownTags = []) {
 }
 
 // src/prompts/memory/encyclopedia-classify-prompt.constant.ts
-function buildEncyclopediaClassifyPrompt(knownCategories = []) {
+function buildEncyclopediaClassifyPrompt(knownCategories = [], knownTopics = []) {
   return buildStructuredPrompt(EncyclopediaClassifySchema, {
     before: "OUTPUT FORMAT \u2014 output ONLY valid JSON matching this exact schema:",
     after: `
 YOUR TASK \u2014 label one stored source document with its broad category and the topic it is about:
 - The document may be a fetched web page, an uploaded file, or a search-result snippet. Classify by its CONTENT, never by its source shape \u2014 a file has no domain, and that must not matter.
 - category: ONE broad lowercase PLURAL family noun (e.g. "games", "work", "health", "finance") that groups the topic into a family. Never a specific entity, product, company, or title.
-- topic: the narrow subject the document is about (e.g. "wuthering waves", "q3 budget", "rust borrow checker"). A short, specific, reusable label \u2014 not a sentence, not a URL, not a filename.
-${buildVocabularySection(knownCategories)}
+- topic: the narrow subject the document is about (e.g. "wuthering waves", "q3 budget", "rust borrow checker"). A short, specific, reusable label \u2014 not a sentence, not a URL, not a filename, never a domain or a site name.
+- When the document is about a KNOWN TOPIC, output that label VERBATIM \u2014 prefer "neverness to everness" over minting a variant like "nte".
+${buildVocabularySection(knownCategories, knownTopics)}
 RULES:
 - Return ONLY a single valid JSON object matching the exact schema above.
 - No markdown code fences, no explanations, preamble, or postscript.
@@ -3565,6 +3617,12 @@ NOT a contradiction:
 - different subjects or unrelated facts
 - a more specific statement that does not actually conflict with a general one
 
+METADATA \u2014 each record may show "(subject: \u2026; category: \u2026; kind: \u2026; stability: \u2026)":
+- subject: a contradiction requires the SAME subject. Candidates about a different subject are never conflicts, however similar they read.
+- stability: "volatile" records describe a current state \u2014 a NEWER volatile statement supersedes the older one (name the newer as winner). "durable" statements rarely supersede each other: when neither side is clearly right, omit winnerId so the conflict stays open.
+- kind: polarity flips are the expected contradiction for "preference" and "relationship" records. For "fact", "project", "contact" and "possession" records a conflict means one statement is outdated or wrong \u2014 prefer the newer statement when the dates say which is current.
+- category: conflicts almost always live inside one category family; treat a candidate from a clearly different family skeptically, but never dismiss it on category alone.
+
 Respond with JSON only:
 {
   "contradicts": boolean,
@@ -3578,7 +3636,7 @@ Rules:
 - Never invent a conflictingId or winnerId that is not in the input.`;
 function buildFrictionPrompt(input) {
   const lines = [];
-  lines.push(`RECORD (id: ${input.record.id}):`);
+  lines.push(`RECORD (id: ${input.record.id})${formatFactMetadata(input.record)}:`);
   lines.push(input.record.text);
   if (input.record.createdAt) {
     lines.push(`(created: ${input.record.createdAt})`);
@@ -3589,7 +3647,7 @@ function buildFrictionPrompt(input) {
     lines.push("(none)");
   } else {
     for (const candidate of input.candidates) {
-      lines.push(`- id: ${candidate.id}`);
+      lines.push(`- id: ${candidate.id}${formatFactMetadata(candidate)}`);
       lines.push(`  text: ${candidate.text}`);
       if (candidate.createdAt) {
         lines.push(`  created: ${candidate.createdAt}`);
@@ -3640,14 +3698,19 @@ Decide exactly one verdict:
 POLARITY RULE (ABSOLUTE): a flip or addition of negation ("allergic" vs "not allergic", "likes" vs "dislikes") is NEW information \u2014 it is never "redundant"; if it corrects a stored statement, merge with the corrected statement.
 PROVENANCE RULE (ABSOLUTE): a statement the user made outweighs assistant-derived wording \u2014 mergedText preserves the user's claim; when candidate origins conflict on facts, the user's version wins.
 
+METADATA \u2014 each record may show "(subject: \u2026; category: \u2026; kind: \u2026; stability: \u2026)":
+- subject: merge requires the SAME subject; facts about different subjects are always "keep".
+- kind: two "contact" or "state" records about the same subject usually merge into the fuller one. Two "decision" or "preference" records with different content are different facts \u2014 keep both.
+- stability: a newer "volatile" state normally replaces the older record via merge.
+
 OUTPUT FORMAT \u2014 output ONLY valid JSON:`,
   after: 'No markdown fences, no explanations. mergedText is required with verdict "merge" and omitted otherwise.'
 });
 function buildConsolidatePrompt(params) {
-  const candidates = params.candidates.length ? params.candidates.map((c) => `- ${formatProvenanceLine(c)}`).join("\n") : "(none)";
+  const candidates = params.candidates.length ? params.candidates.map((c) => `- ${formatProvenanceLine(c)}${formatFactMetadata(c)}`).join("\n") : "(none)";
   return [
     `NEW FACT:
-- ${formatProvenanceLine(params.newFact)}`,
+- ${formatProvenanceLine(params.newFact)}${formatFactMetadata(params.newFact)}`,
     `EXISTING CANDIDATES:
 ${candidates}`,
     "Decide exactly one verdict (keep / redundant / merge) and output ONLY the JSON object."
@@ -3809,6 +3872,21 @@ YOUR TASK \u2014 decide what is worth remembering:
 - Facts must be self-contained \u2014 no "this"/"that" references; write them as third-person statements.
 - Storage mechanics: each fact is embedded as a whole and matched sentence-by-sentence at recall time (multi-variant retrieval). One dense sentence is fine \u2014 put the subject up front ("User prefers single-line if statements", not "They prefer that style").
 - Skip transient content: greetings, small talk, one-off instructions, filler \u2014 anything with no future recall value. When in doubt about whether a detail is durable, keep it: a durable detail is cheaper to store than to lose.
+
+FACT METADATA \u2014 every fact object carries the fields the maintenance passes (consolidate/reflect/conviction) interpret:
+- text: the statement itself.
+- subject (optional): the lowercase entity the fact is about \u2014 "user" by default, or a person, product, or project name ("sam", "stellar blade", "payments service"). Maintenance only ever compares facts about the SAME subject, so name it whenever the fact is about a specific entity.
+- category (optional): ONE broad lowercase PLURAL family label for this fact, reusing the known vocabulary \u2014 inherits the turn-side category when omitted.
+- kind (required): what kind of durable thing it is:
+  - preference \u2014 likes, dislikes, wants, style choices
+  - decision \u2014 a choice that was made (adoptions, migrations, purchases committed to)
+  - state \u2014 the CURRENT, changeable situation (lives in X, uses version Y, runs Z) \u2014 newer statements supersede these
+  - contact \u2014 contact details of a person (phone, email, address)
+  - project \u2014 facts about ongoing work or projects
+  - possession \u2014 things owned
+  - relationship \u2014 how people relate ("sam is the user's brother")
+  - fact \u2014 any other durable fact
+- stability (required): "durable" \u2014 a long-term truth that should survive until contradicted (decisions, traits, history) \u2014 or "volatile" \u2014 a current state a newer statement is EXPECTED to replace (location, tooling, versions). When in doubt, choose durable.
 - Tags: 2 to 6 stable, reusable, lowercase topic labels describing what the text is about (e.g. "work", "rust", "contacts", "amd", "stellar blade"). Tags are NARROW and specific \u2014 entity names, product names, game titles. They are the vocabulary for topic-filtered recall later.
 - Category: ONE broad lowercase PLURAL family noun for the whole text (e.g. "stocks", "pets", "games", "health") that groups the narrow tags into one topic family. A category is NEVER a specific entity, product, company, or game title: "amd" belongs under "stocks"; "stellar blade" and "stellar blade blood rain" belong under "games". Always include it when facts are emitted; omit it when nothing durable is found.
 - If nothing durable is found, return an empty facts array; tags may still label the topic when useful.
@@ -3833,8 +3911,8 @@ function buildExtractionCorrectionPrompt(error) {
 Error: ${error}
 
 Return ONLY a single valid JSON object matching the extraction schema exactly:
-{"facts": [string, ...], "tags": [string, ...], "category": "string"}
-All object keys must be quoted with double quotes.
+{"facts": [{"text": "string", "subject": "string", "category": "string", "kind": "preference|decision|state|contact|project|possession|relationship|fact", "stability": "durable|volatile"}, ...], "tags": [string, ...], "category": "string"}
+All object keys must be quoted with double quotes. "subject" and the per-fact "category" are optional; "kind" and "stability" are required on every fact.
 Do not add markdown code fences, explanations, or extra text.
 
 FINAL REMINDER:
@@ -3868,4 +3946,4 @@ Compose the response from the snippets below. Include every snippet you can subs
 ${parts.join("\n\n")}`;
 }
 
-export { BELIEF_INSTRUCTIONS, COMMONMARK_FORMAT, COMPARE_INSTRUCTIONS, COMPARE_VISUAL_INSTRUCTIONS, DEFAULT_VARIANT_ID, DESCRIBE_CONCISE_INSTRUCTIONS, DESCRIBE_DETAILED_INSTRUCTIONS, DESCRIBE_INSTRUCTIONS, FINAL_REMINDER, FRICTION_INSTRUCTIONS, HISTORY_URLS_RULES, IMAGELIST_INSTRUCTIONS, IMAGE_TASK_RULE, INTERNATIONAL_COVERAGE_INSTRUCTIONS, ITEM_SHAPES, JSON_RULES, MEDIA_COUNTS, MEDIA_RULES, MEMORY_CLUSTER_INSTRUCTIONS, MEMORY_CONSOLIDATE_INSTRUCTIONS, MEMORY_PROFILE_INSTRUCTIONS, MEMORY_WRITE_INSTRUCTIONS, MERGE_MEDIA_RULES, MERGE_TOPIC_RULE, MULTIMODAL_POLICY, NOISE_RULES, OCR_INSTRUCTIONS, OCR_VERBATIM_INSTRUCTIONS, PRECEDENCE_RULES, PRODUCT_INSTRUCTIONS, RESPONSE_LAYOUTS, SECURITY_RULES, SHOPLIST_INSTRUCTIONS, SNIPPET_TEMPLATE_PRESETS, SOURCE_TRUTH_RULES, SOURCE_VOICE_RULES, STOCKMARKET_ITEM_INSTRUCTIONS, STOCKMARKET_LIST_INSTRUCTIONS, SUMMARY_INSTRUCTIONS, TEMPLATE_VARIANTS, TEXT_CODING_INSTRUCTIONS, TEXT_FAMILIARITY_INSTRUCTIONS, TEXT_INSTRUCTIONS, TOOL_RESULTS_RULES, VIDEOLIST_INSTRUCTIONS, articlePreset, assessmentListsSnippet, authorMetaSnippet, bodyBriefSnippet, bodyExtensiveSnippet, buildBaseSystemPrompt, buildBeliefSynthesisPrompt, buildClarificationTranslationSystemPrompt, buildClarificationTranslationUserPrompt, buildClassifyTranscript, buildClusterSummaryPrompt, buildConsolidatePrompt, buildContentSystemPrompt, buildContextSummarySection, buildCorrectionPrompt, buildEncyclopediaClassifyPrompt, buildEnrichPrompt, buildExecuteLanguageInstruction, buildExtractionCorrectionPrompt, buildExtractionPrompt, buildFrictionPrompt, buildImageExecutePrompt, buildIntentCorrectionPrompt, buildIntentSelectionPrompt, buildLanguageRule, buildLayoutInstruction, buildLocalizationRule, buildMemoryProbeSection, buildMemoryProfilePrompt, buildMemoryWritePrompt, buildMergeDirective, buildMissingToolsPrompt, buildOutputContract, buildSnippetInstruction, buildSourcePolicyPrompt, buildStockmarketNote, buildStructuredJsonPrompt, buildStructuredPrompt, buildToolExecutePrompt, buildVocabularySection, bylineDatelineSnippet, cardsSnippet, comparisonSchema, comparisonSnippet, composeSnippetKeys, composeSnippetSchema, conclusionSnippet, evaluationPreset, formatCurrentTimestamp, formatProvenanceLine, formatToolAvailabilityCatalog, formatVariantCatalog, gallerySnippet, getSnippetTemplateKeys, getSnippetTemplateSchema, headerArticleSnippet, headerNewsSnippet, heroMediaSnippet, internationalCoverageSnippet, introductionSnippet, isSnippetTemplate, keyFindingsSnippet, languageCorrectionPrompt, leadSnippet, mergePreset, mergedEvaluationsSnippet, newsKeyFindingsSnippet, newsPreset, quoteSnippet, reasoningSnippet, relatedStoriesSnippet, resolveLanguageName, resolveVariantInstructions, responseLayoutSchema, sourcesSnippet, subjectSchema, subjectsSnippet, summarySnippet, verdictSpineSnippet, videoGallerySnippet };
+export { COMMONMARK_FORMAT, COMPARE_INSTRUCTIONS, COMPARE_VISUAL_INSTRUCTIONS, CONVICTION_INSTRUCTIONS, DEFAULT_VARIANT_ID, DESCRIBE_CONCISE_INSTRUCTIONS, DESCRIBE_DETAILED_INSTRUCTIONS, DESCRIBE_INSTRUCTIONS, FINAL_REMINDER, FRICTION_INSTRUCTIONS, HISTORY_URLS_RULES, IMAGELIST_INSTRUCTIONS, IMAGE_TASK_RULE, INTERNATIONAL_COVERAGE_INSTRUCTIONS, ITEM_SHAPES, JSON_RULES, MEDIA_COUNTS, MEDIA_RULES, MEMORY_CLUSTER_INSTRUCTIONS, MEMORY_CONSOLIDATE_INSTRUCTIONS, MEMORY_PROFILE_INSTRUCTIONS, MEMORY_WRITE_INSTRUCTIONS, MERGE_MEDIA_RULES, MERGE_TOPIC_RULE, MULTIMODAL_POLICY, NOISE_RULES, OCR_INSTRUCTIONS, OCR_VERBATIM_INSTRUCTIONS, PRECEDENCE_RULES, PRODUCT_INSTRUCTIONS, RESPONSE_LAYOUTS, SECURITY_RULES, SHOPLIST_INSTRUCTIONS, SNIPPET_TEMPLATE_PRESETS, SOURCE_TRUTH_RULES, SOURCE_VOICE_RULES, STOCKMARKET_ITEM_INSTRUCTIONS, STOCKMARKET_LIST_INSTRUCTIONS, SUMMARY_INSTRUCTIONS, TEMPLATE_VARIANTS, TEXT_CODING_INSTRUCTIONS, TEXT_FAMILIARITY_INSTRUCTIONS, TEXT_INSTRUCTIONS, TOOL_RESULTS_RULES, VIDEOLIST_INSTRUCTIONS, articlePreset, assessmentListsSnippet, authorMetaSnippet, bodyBriefSnippet, bodyExtensiveSnippet, buildBaseSystemPrompt, buildClarificationTranslationSystemPrompt, buildClarificationTranslationUserPrompt, buildClassifyTranscript, buildClusterSummaryPrompt, buildConsolidatePrompt, buildContentSystemPrompt, buildContextSummarySection, buildConvictionSynthesisPrompt, buildCorrectionPrompt, buildEncyclopediaClassifyPrompt, buildEnrichPrompt, buildExecuteLanguageInstruction, buildExtractionCorrectionPrompt, buildExtractionPrompt, buildFrictionPrompt, buildImageExecutePrompt, buildIntentCorrectionPrompt, buildIntentSelectionPrompt, buildLanguageRule, buildLayoutInstruction, buildLocalizationRule, buildMemoryProbeSection, buildMemoryProfilePrompt, buildMemoryWritePrompt, buildMergeDirective, buildMissingToolsPrompt, buildOutputContract, buildSnippetInstruction, buildSourcePolicyPrompt, buildStockmarketNote, buildStructuredJsonPrompt, buildStructuredPrompt, buildToolExecutePrompt, buildVocabularySection, bylineDatelineSnippet, cardsSnippet, comparisonSchema, comparisonSnippet, composeSnippetKeys, composeSnippetSchema, conclusionSnippet, evaluationPreset, formatCurrentTimestamp, formatProvenanceLine, formatToolAvailabilityCatalog, formatVariantCatalog, gallerySnippet, getSnippetTemplateKeys, getSnippetTemplateSchema, headerArticleSnippet, headerNewsSnippet, heroMediaSnippet, internationalCoverageSnippet, introductionSnippet, isSnippetTemplate, keyFindingsSnippet, languageCorrectionPrompt, leadSnippet, mergePreset, mergedEvaluationsSnippet, newsKeyFindingsSnippet, newsPreset, quoteSnippet, reasoningSnippet, relatedStoriesSnippet, resolveLanguageName, resolveVariantInstructions, responseLayoutSchema, sourcesSnippet, subjectSchema, subjectsSnippet, summarySnippet, verdictSpineSnippet, videoGallerySnippet };

package/dist/schemas/index.d.ts

@@ -110,8 +110,48 @@ declare const MemoryEnrichmentSchema: z.ZodObject<{
 }, 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>;
@@ -833,4 +873,4 @@ declare const videolistSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 
-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, ExtractionSchema, 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 };
+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

@@ -513,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
@@ -531,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()
 });
@@ -1117,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_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, ExtractionSchema, 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 };
+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/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.16",
+  "version": "0.1.17",
   "packageManager": "pnpm@11.25.0",
   "license": "MIT",
   "type": "module",