@cognipeer/agent-sdk 0.10.2 → 0.10.3

package/dist/index.d.cts

@@ -1522,6 +1522,13 @@ type SummaryFactItem = {
     source?: string;
 };
 type StructuredSummary = {
+    /**
+     * Standing instructions the user gave that still apply ("answer in Turkish",
+     * "never restart prod"). Kept verbatim across summaries: a directive dropped
+     * by a later summary counts as critical loss and is merged forward, unless
+     * the user explicitly revoked it (listed in `discarded_obsolete`).
+     */
+    user_directives?: string[];
     stable_facts: SummaryFactItem[];
     active_goals: string[];
     open_questions: string[];

package/dist/index.d.ts

@@ -1522,6 +1522,13 @@ type SummaryFactItem = {
     source?: string;
 };
 type StructuredSummary = {
+    /**
+     * Standing instructions the user gave that still apply ("answer in Turkish",
+     * "never restart prod"). Kept verbatim across summaries: a directive dropped
+     * by a later summary counts as critical loss and is merged forward, unless
+     * the user explicitly revoked it (listed in `discarded_obsolete`).
+     */
+    user_directives?: string[];
     stable_facts: SummaryFactItem[];
     active_goals: string[];
     open_questions: string[];

package/dist/index.mjs

@@ -6146,6 +6146,9 @@ function isSyntheticSummaryMessage(message) {
   }
   return false;
 }
+function isCompactedToolContent(content) {
+  return typeof content === "string" && (content === "SUMMARIZED" || content.startsWith("SUMMARIZED_TOOL_RESPONSE") || content.startsWith("ARCHIVED_TOOL_RESPONSE") || content.startsWith("STRUCTURED_TOOL_RESPONSE") || content.startsWith("DROPPED_TOOL_RESPONSE"));
+}
 
 // src/structuredOutput/manager.ts
 var StructuredOutputManager = class {
@@ -8062,6 +8065,10 @@ function collectRecentTurns(messages, lastTurnsToKeep) {
 function renderStructuredSummary(summary) {
   if (!summary) return "";
   const lines = ["Context summary:"];
+  if (summary.user_directives && summary.user_directives.length > 0) {
+    lines.push("User directives (still in force \u2014 follow them):");
+    lines.push(...summary.user_directives.map((directive) => `- ${directive}`));
+  }
   if (summary.stable_facts.length > 0) {
     lines.push("Stable facts:");
     lines.push(...summary.stable_facts.map((fact) => `- ${fact.key}: ${fact.value}`));
@@ -8137,17 +8144,46 @@ function clampToBudget(messages, maxContextTokens) {
   }
   return working;
 }
+function collectSummaryOnlyBody(body, hasSummary, lastTurnsToKeep) {
+  if (!hasSummary) {
+    return collectRecentTurns(body, Math.max(1, lastTurnsToKeep));
+  }
+  let boundary = -1;
+  for (let index = body.length - 1; index >= 0; index -= 1) {
+    if (isSyntheticSummaryMessage(body[index])) {
+      boundary = index;
+      break;
+    }
+  }
+  let lastUserIndex = -1;
+  for (let index = body.length - 1; index >= 0; index -= 1) {
+    if (body[index].role === "user") {
+      lastUserIndex = index;
+      break;
+    }
+  }
+  const keep = /* @__PURE__ */ new Set();
+  const firstUserIndex = body.findIndex((message) => message.role === "user");
+  if (firstUserIndex >= 0) keep.add(firstUserIndex);
+  const verbatimFrom = Math.min(lastUserIndex >= 0 ? lastUserIndex : body.length, boundary + 1);
+  for (let index = Math.max(0, verbatimFrom); index < body.length; index += 1) {
+    if (!isSyntheticSummaryMessage(body[index])) keep.add(index);
+  }
+  return body.filter((_, index) => keep.has(index));
+}
 function buildModelMessages(state, config) {
   const rawMessages = state.messages || [];
   if (config.context.policy === "raw") {
     return clampToBudget(rawMessages, config.limits.maxContextTokens);
   }
-  const recentMessages = collectRecentTurns(rawMessages, config.context.lastTurnsToKeep);
   const latestSummary = state.summaryRecords?.[state.summaryRecords.length - 1];
   const summaryText = renderStructuredSummary(latestSummary);
   const memoryText = renderMemoryBlock(state.memoryFacts);
-  const systemMessage2 = recentMessages[0]?.role === "system" ? recentMessages[0] : void 0;
-  const body = systemMessage2 ? recentMessages.slice(1) : recentMessages;
+  const systemMessage2 = rawMessages[0]?.role === "system" ? rawMessages[0] : void 0;
+  const body = config.context.policy === "summary_only" ? collectSummaryOnlyBody(systemMessage2 ? rawMessages.slice(1) : rawMessages, Boolean(summaryText), config.context.lastTurnsToKeep) : (() => {
+    const recentMessages = collectRecentTurns(rawMessages, config.context.lastTurnsToKeep);
+    return recentMessages[0]?.role === "system" ? recentMessages.slice(1) : recentMessages;
+  })();
   const syntheticContextMessages = [];
   if (summaryText) {
     syntheticContextMessages.push({ role: "system", name: "context_summary", content: summaryText });
@@ -8158,7 +8194,7 @@ function buildModelMessages(state, config) {
   const assembled = [
     ...systemMessage2 ? [systemMessage2] : [],
     ...syntheticContextMessages,
-    ...config.context.policy === "summary_only" ? body.filter((message) => message.role === "user" || message.role === "assistant").slice(-2) : body
+    ...body
   ];
   return clampToBudget(assembled, config.limits.maxContextTokens);
 }
@@ -8203,6 +8239,7 @@ function extractJsonObject(text) {
 }
 function normalizeStructuredSummary(input, fallbackText) {
   const summary = {
+    user_directives: Array.isArray(input?.user_directives) ? input.user_directives.map((directive) => String(directive ?? "").trim()).filter(Boolean) : [],
     stable_facts: Array.isArray(input?.stable_facts) ? input.stable_facts.filter((fact) => fact && typeof fact === "object").map((fact) => ({
       key: String(fact.key || "unknown"),
       value: String(fact.value || ""),
@@ -8263,7 +8300,7 @@ function extractCanonicalFacts(messages) {
   return [...facts.values()];
 }
 function isSummarizedToolPlaceholder(content) {
-  return typeof content === "string" && (content === "SUMMARIZED" || content.startsWith("SUMMARIZED_TOOL_RESPONSE") || content.startsWith("ARCHIVED_TOOL_RESPONSE") || content.startsWith("STRUCTURED_TOOL_RESPONSE") || content.startsWith("DROPPED_TOOL_RESPONSE"));
+  return isCompactedToolContent(content);
 }
 function collectLatestTurnToolCallIds(messages) {
   const ids = /* @__PURE__ */ new Set();
@@ -8322,11 +8359,16 @@ function runIntegrityCheck(previous, current) {
   const previousKeys = new Set((previous?.stable_facts || []).map((fact) => fact.key));
   const currentKeys = new Set(current.stable_facts.map((fact) => fact.key));
   const obsoleteKeys = new Set(current.discarded_obsolete);
-  const criticalFactLoss = [...previousKeys].some((key) => !obsoleteKeys.has(key) && !currentKeys.has(key));
+  const currentDirectives = new Set(current.user_directives || []);
+  const lostDirectives = (previous?.user_directives || []).filter((directive) => !currentDirectives.has(directive) && !obsoleteKeys.has(directive));
+  const criticalFactLoss = [...previousKeys].some((key) => !obsoleteKeys.has(key) && !currentKeys.has(key)) || lostDirectives.length > 0;
   const obsoleteFactRevived = current.stable_facts.some((fact) => obsoleteKeys.has(fact.key));
   if (criticalFactLoss) {
     notes.push("Missing previously retained facts; merged forward during integrity repair.");
   }
+  if (lostDirectives.length > 0) {
+    notes.push(`Dropped ${lostDirectives.length} user directive(s); merged forward during integrity repair.`);
+  }
   if (obsoleteFactRevived) {
     notes.push("Obsolete facts reappeared; removed during integrity repair.");
   }
@@ -8349,7 +8391,13 @@ function repairStructuredSummary(previous, current, integrity) {
     }
   }
   const filteredFacts = integrity.obsoleteFactRevived ? nextFacts.filter((fact) => !current.discarded_obsolete.includes(fact.key)) : nextFacts;
-  return { ...current, stable_facts: filteredFacts };
+  const directives = [...current.user_directives || []];
+  for (const directive of previous.user_directives || []) {
+    if (!directives.includes(directive) && !current.discarded_obsolete.includes(directive)) {
+      directives.push(directive);
+    }
+  }
+  return { ...current, user_directives: directives, stable_facts: filteredFacts };
 }
 function createContextSummarizeNode(opts) {
   return async (state) => {
@@ -8423,6 +8471,7 @@ function createContextSummarizeNode(opts) {
 
 Return exactly one JSON object with this schema:
 {
+  "user_directives": [string],
   "stable_facts": [{ "key": string, "value": string, "confidence": number }],
   "active_goals": [string],
   "open_questions": [string],
@@ -8431,6 +8480,7 @@ Return exactly one JSON object with this schema:
 }
 
 Rules:
+- user_directives: standing instructions the user gave about HOW to work or answer for the rest of the conversation (language, format, tone, scope, things to always or never do) that still apply. NOT the tasks or questions themselves \u2014 "read the logs" is a task (an active goal), "always answer in Turkish" is a directive. Copy each directive close to verbatim; never merge, soften or drop one. Carry forward every directive from the previous structured summary unless the user explicitly revoked it \u2014 then put its exact text in discarded_obsolete.
 - Keep stable_facts only for facts that future turns must remember.
 - Put invalidated or superseded fact keys in discarded_obsolete.
 - Preserve active_goals still relevant to the user.
@@ -8498,6 +8548,7 @@ ${canonicalFacts.length > 0 ? canonicalFacts.map((fact) => `- ${fact.key}: ${fac
       durationMs = Date.now() - startTime;
       structuredSummary = normalizeStructuredSummary(void 0, previousSummary || conversationText.slice(0, 800));
       structuredSummary = mergeStableFacts(structuredSummary, canonicalFacts);
+      structuredSummary.user_directives = [...previousStructuredSummary?.user_directives || []];
       integrity = { passed: true, criticalFactLoss: false, obsoleteFactRevived: false, notes: ["Fallback summary generated locally."] };
       summaryText = renderStructuredSummary(structuredSummary);
       const errorEvent = {