stratagate-dsh 0.2.90 → 0.2.92

package/dist/plugin.js

@@ -1864,6 +1864,8 @@ function normalizeSnapshot(value) {
   }
   const sourceBlockMap = new Map(snapshot.blocks.map((block) => [block.id, block]));
   for (const event of [...snapshot.events, ...snapshot.agentEvents]) {
+    delete event.narrative;
+    delete event.confidence;
     event.temporal = { ...event.temporal, eventType: normalizeStandardEventType(event.temporal.eventType) };
     if (event.formedTurn === void 0) {
       const sourceBlock = event.sourceBlockId !== void 0 ? sourceBlockMap.get(event.sourceBlockId) : void 0;
@@ -2408,7 +2410,6 @@ function mapEventRows(rows, sourcesByEvent, table) {
     id: row.id,
     title: row.title,
     summary: row.summary,
-    narrative: row.narrative,
     tags: parseJson(row.tags_json, `${table}.tags_json`),
     quotes: parseJson(row.quotes_json, `${table}.quotes_json`),
     sourceMessageIds: sourcesByEvent.get(row.id) ?? [],
@@ -2420,7 +2421,6 @@ function mapEventRows(rows, sourcesByEvent, table) {
     })(),
     scope: row.scope,
     criticality: row.criticality,
-    confidence: row.confidence,
     status: row.status,
     supersededBy: row.superseded_by,
     weight: {
@@ -3043,7 +3043,7 @@ var SqliteStorage = class {
         eventPosition,
         event.title,
         event.summary,
-        event.narrative,
+        event.summary,
         JSON.stringify(event.tags),
         JSON.stringify(event.quotes),
         event.sourceBlockId,
@@ -3051,7 +3051,7 @@ var SqliteStorage = class {
         JSON.stringify(event.temporal),
         event.scope,
         event.criticality,
-        event.confidence,
+        1,
         event.status,
         event.supersededBy,
         event.weight.mentionCount,
@@ -3087,7 +3087,7 @@ var SqliteStorage = class {
         eventPosition,
         event.title,
         event.summary,
-        event.narrative,
+        event.summary,
         JSON.stringify(event.tags),
         JSON.stringify(event.quotes),
         event.sourceBlockId ?? null,
@@ -3095,7 +3095,7 @@ var SqliteStorage = class {
         JSON.stringify(event.temporal),
         event.scope,
         event.criticality,
-        event.confidence,
+        1,
         event.status,
         event.supersededBy,
         event.weight.mentionCount,
@@ -3685,6 +3685,19 @@ function agentEventCandidate(content, category, now, threadId) {
   };
 }
 var DERIVATION_BACKOFF_MS = 1e3;
+function restrictExtractionRelations(temporal, allowedIds) {
+  const result = { ...temporal };
+  if (typeof result.sameEventId !== "string" || !allowedIds.has(result.sameEventId)) {
+    delete result.sameEventId;
+  }
+  for (const field of ["beforeEventIds", "afterEventIds", "supersedesEventIds", "conflictsWithEventIds", "relatedEventIds"]) {
+    const values = temporal[field];
+    const ids = Array.isArray(values) ? [...new Set(values.filter((id) => typeof id === "string" && allowedIds.has(id)))] : [];
+    if (ids.length > 0) result[field] = ids;
+    else delete result[field];
+  }
+  return result;
+}
 var StrataGate = class _StrataGate {
   blockTurnSizeValue;
   blockDecayLambdaValue;
@@ -4636,7 +4649,6 @@ var StrataGate = class _StrataGate {
       [event.summary, 3],
       [event.tags.join(" "), 2],
       [event.quotes.join(" "), 2],
-      [event.narrative, 1],
       [(event.temporal.participants ?? []).join(" "), 5],
       [event.temporal.eventType ?? "", 5],
       [event.temporal.originalText ?? "", 4],
@@ -5383,7 +5395,6 @@ var StrataGate = class _StrataGate {
       formedTurn: parts.formedTurn,
       title: input.title.trim(),
       summary: input.summary.trim(),
-      narrative: input.narrative?.trim() || input.summary.trim(),
       tags: [...new Set(input.tags ?? [])].slice(0, 12),
       quotes: [...new Set(input.quotes ?? [])].slice(0, 12),
       sourceMessageIds: parts.sourceMessageIds,
@@ -5394,7 +5405,6 @@ var StrataGate = class _StrataGate {
       },
       scope: input.scope ?? "user",
       criticality: parts.criticality,
-      confidence: Math.max(0, Math.min(1, input.confidence ?? 1)),
       status: "active",
       supersededBy: null,
       weight: {
@@ -5905,6 +5915,7 @@ var StrataGate = class _StrataGate {
       });
     });
     let result;
+    let allowedTimelineEventIds = /* @__PURE__ */ new Set();
     try {
       const query = [target.l0Title, target.l1Summary, ...target.l2Keypoints ?? []].filter(Boolean).join(" ");
       const relevant = query ? (await this.searchEvents(query, { limit: 8, trackRetrieval: false })).map(({ event }) => event) : [];
@@ -5914,11 +5925,12 @@ var StrataGate = class _StrataGate {
       for (const event of recent) {
         if (!timelineEvents.has(event.id)) timelineEvents.set(event.id, event);
       }
+      allowedTimelineEventIds = new Set(timelineEvents.keys());
       result = await this.extractor({
         previous: threadBlocks.slice(0, targetIndex).reverse().find((block) => block.l2Keypoints !== void 0) ?? null,
         target,
         next,
-        timeline: [...timelineEvents.values()].map((event) => ({ id: event.id, title: event.title, temporal: event.temporal }))
+        timeline: [...timelineEvents.values()].map((event) => ({ id: event.id, title: event.title, temporal: structuredClone(event.temporal) }))
       });
     } catch (error) {
       await this.commitMutation(() => {
@@ -5950,7 +5962,15 @@ var StrataGate = class _StrataGate {
       throw new Error(reason);
     }
     return this.commitMutation(() => {
-      const extracted = result.shouldExtract ? result.events.map((event) => this.addEventInMemory({ ...event, sourceBlockId: target.id })) : [];
+      const allowedIds = new Set([...allowedTimelineEventIds].filter((id) => {
+        const event = this.findEvent(id);
+        return event?.status === "active" || event?.status === "superseded";
+      }));
+      const extracted = result.shouldExtract ? result.events.map((event) => this.addEventInMemory({
+        ...event,
+        sourceBlockId: target.id,
+        ...event.temporal ? { temporal: restrictExtractionRelations(event.temporal, allowedIds) } : {}
+      })) : [];
       if (extracted.length > 0) {
         const ids = extracted.map(({ id }) => id);
         this.queueElementProjection(ids);
@@ -6526,22 +6546,20 @@ var EVENT_ITEM = {
   type: "object",
   additionalProperties: false,
   properties: {
-    title: { type: "string", required: true },
-    summary: { type: "string", required: true },
-    narrative: { type: "string" },
-    tags: STRING_ARRAY,
-    quotes: STRING_ARRAY,
-    sourceMessageIds: { ...STRING_ARRAY, required: true },
-    temporal: OPEN_OBJECT,
-    scope: { type: "string", enum: ["user", "project", "session"] },
-    criticality: { type: "string", enum: ["routine", "preference", "identity", "safety"] },
-    confidence: { type: "number" }
+    title: { type: "string", description: "A short, specific, retrieval-friendly title stating the canonical subject and the single main event or state change. Prefer explicit names, versions, tools, projects, or decisions supported by the source. Avoid pronouns, vague wording, unsupported synonyms, and keyword stuffing.", required: true },
+    summary: { type: "string", description: "A concise, self-contained statement of one event: identify the concrete subject, what happened or became true, and the important result or current status. Preserve exact names and distinctive source-supported terms useful for retrieval. Do not add unstated causes, conclusions, certainty, or relationships.", required: true },
+    tags: { ...STRING_ARRAY, description: "A small set of distinctive retrieval labels that add useful search entry points not already obvious from the event type or participants. Use only source-supported canonical names, projects, tools, versions, technologies, concepts, aliases, or abbreviations. Avoid generic, speculative, weakly related, or redundant tags." },
+    quotes: { ...STRING_ARRAY, description: "A few short verbatim excerpts that directly support the extracted event and whose exact wording has lasting evidential or retrieval value. Copy exactly from the source messages. Do not quote unrelated context, paraphrase, or select wording that changes the original meaning." },
+    sourceMessageIds: { ...STRING_ARRAY, description: "The smallest set of exact message IDs from the target Block that directly supports every material claim in this event. Do not include merely related messages, and do not cite messages that support only background context.", required: true },
+    temporal: { ...OPEN_OBJECT, description: "Structured temporal and event metadata, including when the event happened or was mentioned, its event type, participants, precision, and basis. Preserve uncertainty and do not invent missing times, participants, chronology, or relationships." },
+    scope: { type: "string", enum: ["user", "project", "session"], description: "The memory scope of the event: user for durable user-level facts or preferences, project for project-specific facts and decisions, and session only for temporary context that should not generalize beyond the current session." },
+    criticality: { type: "string", enum: ["routine", "preference", "identity", "safety"], description: "The event's persistence class: routine for ordinary facts and outcomes, preference for durable user preferences, identity for stable identity-related facts, and safety only for safety-critical information. Do not inflate criticality merely because an event seems important." }
   }
 };
 var EXTRACTOR_PARAMETERS = {
-  shouldExtract: { type: "boolean", required: true },
-  reason: { type: "string", required: true },
-  events: { type: "array", items: EVENT_ITEM, required: true }
+  shouldExtract: { type: "boolean", description: "The Event Extractor's final judgment: true only when at least one durable Event is directly supported by target.messages. False when none qualifies, even if the Summarizer pre-screen was true; then return an empty events array.", required: true },
+  reason: { type: "string", description: "Briefly explain the final decision to extract or not extract; do not use this field as Event content.", required: true },
+  events: { type: "array", items: EVENT_ITEM, description: "Zero or more atomic, self-contained Event cards directly supported by target.messages. Separate independently changing, conflicting, or retrievable facts.", required: true }
 };
 var VALUE = {
   oneOf: [
@@ -6656,7 +6674,7 @@ var STRUCTURED_TOOLS = {
   },
   extractor: {
     name: "stratagate_extract_event_cards",
-    description: "Submit durable, evidence-backed event cards from the target block only.",
+    description: "Submit the Event Extractor's final decision and zero or more atomic, self-contained, source-grounded long-term Event cards. Extract only from target.messages; return shouldExtract=false and events=[] when no durable target-supported Event qualifies.",
     parameters: EXTRACTOR_PARAMETERS
   },
   projector: {
@@ -6706,7 +6724,6 @@ function compactGraphProjectionContext(context) {
       id: event.id,
       title: event.title,
       summary: event.summary,
-      narrative: event.narrative,
       tags: event.tags,
       quotes: event.quotes,
       temporal: event.temporal,
@@ -6810,7 +6827,15 @@ var DshModelBridge = class {
     const validMessageIds = new Set(context.target.l5Raw.map((message) => message.id));
     const raw = object(await this.callStructured(
       "extractor",
-      `Extract only durable, evidence-backed events from target.messages, then call ${STRUCTURED_TOOLS.extractor.name} exactly once. target.messages is a provenance-preserving derivation view of the target block: message ids and conversational text are retained, while tool code and oversized tool payloads may be marked compacted. Use the retained tool names, evidence summaries, and excerpts without inventing omitted details. The target block is the only legal source of new facts, quotations, and sourceMessageIds. neighbors.previous and neighbors.next are context-only L2 summaries; never extract from them. Every sourceMessageIds entry must exactly match allowedSourceMessageIds. If a fact appears only in a neighbor, do not extract it in this call. Events must be understandable later without the original chat. Use project scope for repository decisions, user scope for stable preferences/identity, and session scope for temporary task state. temporal.eventType must use exactly one stable value: decision, release, task_completed, plan, change, cancellation, incident, meeting, collaboration, migration, or other. temporal.participants contains canonical entity names. Use ISO-8601 timestamps with the explicit +08:00 offset in temporal fields. Keep happened time separate from mentionedAt; when happened time is unknown omit it and set precision/basis to unknown. Do not turn an assistant statement that merely recalls older memory into a new event; require new human input or a new observable task/tool outcome from target.messages. Do not return the result as text.`,
+      `You are the StrataGate Event Extractor. Make the final extraction decision independently of the Summarizer's high-recall pre-screen. Extract durable, evidence-backed events from target.messages, then call ${STRUCTURED_TOOLS.extractor.name} exactly once. If none qualifies, set shouldExtract=false and events=[]; give a brief reason, not an Event body.
+
+Each Event is one atomic fact, decision, plan, outcome, or state change that can independently be retrieved, updated, superseded, or contradicted. If two facts can change or conflict separately, create separate Events; never combine them merely to reduce the Event count. Make title and summary self-contained: name the concrete subject rather than using it, this project, that tool, this issue, or the previous one. The title names the subject and one main change; the summary states the complete supported fact and current status; tags add distinct source-supported search entry points not already covered by title, summary, participants, or eventType. Keep real canonical names, aliases, abbreviations, versions, tools, technologies, projects, and distinctive concepts useful for later retrieval. Never invent keywords, unsupported synonyms, aliases, causes, relationships, or certainty, and never stuff keywords.
+
+Preserve source certainty and attribution: distinguish a user statement or decision, an assistant proposal or hypothesis, a tool-observed result, a plan, a completed result, and an unresolved possibility. Do not turn a suggestion into a decision, a hypothesis into a cause, or a plan into a completed outcome. Every material claim, quotation, time, status, and relationship must match source evidence.
+
+target.messages is a provenance-preserving derivation view of the target Block: message ids and conversational text are retained, while tool code and oversized tool payloads may be marked compacted. Use only retained tool names, evidence summaries, and excerpts; do not invent omitted details. Only target.messages may supply new facts, exact quotes, and sourceMessageIds. neighbors.previous and neighbors.next are context-only L2 summaries; timeline only helps identify historical relationships. Neither neighbors nor timeline nor an assistant recap of older memory can create a new Event. Require new human input or a new observable task/tool outcome from target.messages. Every sourceMessageIds entry must exactly match allowedSourceMessageIds and directly support the Event.
+
+Use project scope for repository decisions, user scope for stable preferences/identity, and session scope for temporary task state. temporal.eventType must use exactly one stable value: decision, release, task_completed, plan, change, cancellation, incident, meeting, collaboration, migration, or other. temporal.participants contains canonical entity names. Use ISO-8601 timestamps with the explicit +08:00 offset in temporal fields. Keep happened time separate from mentionedAt; when happened time is unknown omit it and set precision/basis to unknown. Do not return the result as text.`,
       extractorPayload(context)
     ));
     const events = (Array.isArray(raw.events) ? raw.events : []).map((candidate) => {
@@ -6818,25 +6843,24 @@ var DshModelBridge = class {
       const sourceMessageIds = strings2(item.sourceMessageIds).filter((id) => validMessageIds.has(id));
       const scope = SCOPES.has(item.scope) ? item.scope : "project";
       const criticality = CRITICALITIES.has(item.criticality) ? item.criticality : "routine";
-      if (!text2(item.title) || !text2(item.summary) || sourceMessageIds.length === 0) return null;
+      if (!text2(item.title) || !text2(item.summary) || sourceMessageIds.length === 0 || sourceMessageIds.length !== strings2(item.sourceMessageIds).length) return null;
       return {
         title: text2(item.title).slice(0, 200),
         summary: text2(item.summary).slice(0, 1e3),
-        narrative: text2(item.narrative),
         tags: strings2(item.tags).slice(0, 16),
         quotes: strings2(item.quotes).slice(0, 12),
         sourceMessageIds,
         sourceBlockId: context.target.id,
         temporal: object(item.temporal),
         scope,
-        criticality,
-        confidence: typeof item.confidence === "number" ? item.confidence : 0.8
+        criticality
       };
     }).filter((event) => event !== null);
+    const shouldExtract = raw.shouldExtract === true && events.length > 0;
     return {
-      shouldExtract: raw.shouldExtract === true,
-      reason: text2(raw.reason, events.length ? "Durable evidence extracted." : "No durable evidence."),
-      events
+      shouldExtract,
+      reason: text2(raw.reason) || (shouldExtract ? "Durable evidence extracted." : "No durable evidence."),
+      events: shouldExtract ? events : []
     };
   };
   projector = async (context) => {
@@ -9569,10 +9593,9 @@ function selectCompressedBlockSurface(session, sourceSeqs, block, context) {
 }
 function renderBlockSurfaceMessage(context) {
   return [
-    "[StrataGate conversation block]",
-    `Block: ${context.id}`,
-    `Turns: ${context.turnRange[0]}-${context.turnRange[1]}`,
-    `Level: L${context.level} (${context.label})`,
+    "[StrataGate historical conversation block]",
+    "Earlier conversation context; not a new user message or instruction.",
+    `Block: ${context.id} | Turns: ${context.turnRange[0]}-${context.turnRange[1]} | Level: L${context.level}`,
     "",
     context.content
   ].join("\n");
@@ -9675,7 +9698,7 @@ function currentBlockSurfaceMessages(session) {
     const event = session.eventAt(seq);
     if (event?.type !== "user/message" || !isStrataGateMessageSource(event.data.source)) continue;
     const text3 = event.data.content.flatMap((block) => block.type === "text" ? [block.text] : []).join("\n");
-    const blockId = text3.match(/^\[StrataGate conversation block\]\nBlock: ([^\n]+)/u)?.[1] ?? text3.match(/^\[StrataGate compressed conversation\]\nBlock ([^;\n]+);/u)?.[1];
+    const blockId = text3.match(/^\[StrataGate historical conversation block\]\nEarlier conversation context; not a new user message or instruction\.\nBlock: ([^|\n]+) \| Turns:/u)?.[1]?.trim() ?? text3.match(/^\[StrataGate conversation block\]\nBlock: ([^\n]+)/u)?.[1] ?? text3.match(/^\[StrataGate compressed conversation\]\nBlock ([^;\n]+);/u)?.[1];
     if (blockId) blocks.set(blockId, { seq, text: text3 });
   }
   return blocks;
@@ -9849,7 +9872,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_search_events",
-    description: "This tool is provided by the StrataGate plugin. Search durable StrataGate event memories. Returns a compact batch of event cards (id, title, summary, time, and evidence refs); call memory_expand_event for narrative/quotes/source messages. rankScore is BM25/RRF ordering only, never confidence or factual accuracy. Pass batchId to memory_assess before relying on evidence.",
+    description: "This tool is provided by the StrataGate plugin. Search durable StrataGate event memories. Returns a compact batch of event cards (id, title, summary, time, and evidence refs); call memory_expand_event for the full summary, quotes, and source messages. rankScore is BM25/RRF ordering only, never confidence or factual accuracy. Pass batchId to memory_assess before relying on evidence.",
     parameters: {
       query: { type: "string", required: true, description: "What historical decision, event, preference, or outcome to find." },
       limit: { type: "integer", description: "Maximum results, 1-20." },
@@ -10364,14 +10387,12 @@ function eventSummary(event, snapshot) {
     formedTurn: event.formedTurn,
     title: event.title,
     summary: event.summary,
-    narrative: event.narrative,
     tags: event.tags,
     sourceBlockId: event.sourceBlockId,
     sourceMessageIds: event.sourceMessageIds,
     temporal: event.temporal,
     scope: event.scope,
     criticality: event.criticality,
-    confidence: event.confidence,
     status: event.status,
     supersededBy: event.supersededBy,
     weight: event.weight,
@@ -11679,6 +11700,19 @@ var STRATAGATE_SETTINGS_NAMESPACE = "stratagate-memory";
 var MEMORY_PROTOCOL = `[StrataGate memory protocol]
 StrataGate provides durable, evidence-gated memory through memory_* tools.
 
+StrataGate represents earlier conversation history as layered Blocks:
+
+- L0: title and topical tags \u2014 the most compressed view.
+- L1: short self-contained summary.
+- L2: key facts, decisions, constraints, preferences, results, and open items.
+- L3: deterministically condensed conversation.
+- L4: readable near-verbatim conversation.
+- L5: complete source messages and tool records.
+
+Higher levels contain more source detail.
+If the current level does not contain enough evidence for the task,
+do not infer omitted details; expand the Block or inspect raw memory.
+
 - Search memory when the current task could depend on prior project decisions, user preferences, people, tools, historical outcomes, or unresolved work. Do not search for facts already established in the current conversation.
 - Start with memory_search_events for decisions and history, or memory_search_graph for the current state of a person/project/tool/place/organization.
 - Every retrieval creates an independent batch. Pass its batchId as batch_id to memory_assess before relying on it, especially when retrievals run in parallel. Adopt only evidenceRefs returned by that exact batch. Omitting batch_id selects the latest batch only for compatibility with strictly sequential calls.