stratagate-dsh 0.2.91 → 0.2.93

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);
@@ -6181,7 +6201,7 @@ var StrataGate = class _StrataGate {
 import { readFileSync } from "node:fs";
 import { createRequire } from "node:module";
 var nodeRequire = createRequire(import.meta.url);
-var RUNTIME_PACKAGES = [
+var CORE_RUNTIME_PACKAGES = [
   "@deepseek-ai/cordis",
   "@deepseek-ai/dsh-agent-default-model",
   "@deepseek-ai/dsh-client-ui-conversation",
@@ -6193,6 +6213,12 @@ var RUNTIME_PACKAGES = [
   "@deepseek-ai/dsh-tools",
   "@deepseek-ai/schemastery"
 ];
+var SESSION_FORMAT_PACKAGES = [
+  "@deepseek-ai/dsh-session-format",
+  "@deepseek-ai/dsh-session-format-catalog",
+  "@deepseek-ai/dsh-session-format-v0-to-v1"
+];
+var RUNTIME_PACKAGES = [...CORE_RUNTIME_PACKAGES, ...SESSION_FORMAT_PACKAGES];
 var SUPPORTED_RUNTIME_FAMILIES = [
   {
     cli: "0.1.2-rc.1",
@@ -6271,8 +6297,15 @@ var SUPPORTED_RUNTIME_FAMILIES = [
   }
 ];
 var STRATAGATE_MESSAGE_SOURCE_KIND = "plugin:stratagate-memory";
+function isDsh020Version(version) {
+  const match = /^0\.2\.0(?:-([0-9A-Za-z.-]+))?(?:\+([0-9A-Za-z.-]+))?$/.exec(version);
+  if (!match) return false;
+  const prerelease = match[1]?.split(".") ?? [];
+  const build = match[2]?.split(".") ?? [];
+  return [...prerelease, ...build].every((part) => part.length > 0) && prerelease.every((part) => !/^\d+$/.test(part) || part === "0" || !part.startsWith("0"));
+}
 function buildDshMessageSource(version, form) {
-  const source = /^0\.1\.7(?:-|$)/.test(version) ? { kind: STRATAGATE_MESSAGE_SOURCE_KIND } : { kind: "plugin", plugin: "stratagate-memory" };
+  const source = /^0\.1\.7(?:-|$)/.test(version) || isDsh020Version(version) ? { kind: STRATAGATE_MESSAGE_SOURCE_KIND } : { kind: "plugin", plugin: "stratagate-memory" };
   return form ? { ...source, form } : source;
 }
 function installedVersion(packageName) {
@@ -6303,16 +6336,17 @@ function isCompatiblePatch(version, major, minor, minimumPatch) {
   return !!match && Number(match[1]) === major && Number(match[2]) === minor && Number(match[3]) >= minimumPatch;
 }
 function classifyDshRuntime(packageVersions) {
-  const family = SUPPORTED_RUNTIME_FAMILIES.find(({ versions }) => RUNTIME_PACKAGES.every((name2) => packageVersions[name2] === versions[name2]));
+  const family = SUPPORTED_RUNTIME_FAMILIES.find(({ versions }) => CORE_RUNTIME_PACKAGES.every((name2) => packageVersions[name2] === versions[name2]));
   if (family) return { cliVersion: family.cli, packageVersions };
   const dshVersion = packageVersions["@deepseek-ai/dsh-session"];
-  const sameDshFamily = RUNTIME_PACKAGES.filter((name2) => name2.startsWith("@deepseek-ai/dsh-")).every((name2) => packageVersions[name2] === dshVersion);
-  if ((/^0\.1\.7-rc\.[1-9]\d*$/.test(dshVersion) || dshVersion === "0.1.7") && sameDshFamily && isCompatiblePatch(packageVersions["@deepseek-ai/cordis"], 4, 0, 4) && isCompatiblePatch(packageVersions["@deepseek-ai/schemastery"], 3, 18, 4)) {
+  const sameDshFamily = CORE_RUNTIME_PACKAGES.filter((name2) => name2.startsWith("@deepseek-ai/dsh-")).every((name2) => packageVersions[name2] === dshVersion);
+  const sameSessionFormatFamily = !isDsh020Version(dshVersion) || SESSION_FORMAT_PACKAGES.every((name2) => packageVersions[name2] === dshVersion);
+  if ((/^0\.1\.7-rc\.[1-9]\d*$/.test(dshVersion) || dshVersion === "0.1.7" || isDsh020Version(dshVersion)) && sameDshFamily && sameSessionFormatFamily && isCompatiblePatch(packageVersions["@deepseek-ai/cordis"], 4, 0, 4) && isCompatiblePatch(packageVersions["@deepseek-ai/schemastery"], 3, 18, 4)) {
     return { cliVersion: dshVersion, packageVersions };
   }
   const found = RUNTIME_PACKAGES.map((name2) => `${name2}@${packageVersions[name2]}`).join(", ");
   throw new Error(
-    `StrataGate cannot start because this DSH profile resolves an unsupported or mixed core runtime. Resolved: ${found}. Supported hosts are @deepseek-ai/dsh@0.1.2-rc.1 (internal DSH packages 0.1.2-rc.1) and @deepseek-ai/dsh@0.1.5-rc.1 (its real dependency tree uses internal DSH packages 0.1.5-rc.2), and @deepseek-ai/dsh@0.1.6-alpha.1 (internal DSH packages 0.1.6-alpha.1), and the coherent DSH 0.1.7 family from rc.1 through the 0.1.7 release (Cordis 4.0.x from 4.0.4, Schemastery 3.18.x from 3.18.4). Reinstall or update stratagate-dsh through \`dsh plugin --profile <name> add <package>\` so the host supplies its peers.`
+    `StrataGate cannot start because this DSH profile resolves an unsupported or mixed core runtime. Resolved: ${found}. Supported hosts are @deepseek-ai/dsh@0.1.2-rc.1 (internal DSH packages 0.1.2-rc.1) and @deepseek-ai/dsh@0.1.5-rc.1 (its real dependency tree uses internal DSH packages 0.1.5-rc.2), and @deepseek-ai/dsh@0.1.6-alpha.1 (internal DSH packages 0.1.6-alpha.1), and the coherent DSH 0.1.7 family from rc.1 through the 0.1.7 release, and the complete DSH 0.2.0 family (all alpha, beta, rc, and stable versions; >=0.2.0-0 <0.2.1-0) (Cordis 4.0.x from 4.0.4, Schemastery 3.18.x from 3.18.4). Reinstall or update stratagate-dsh through \`dsh plugin --profile <name> add <package>\` so the host supplies its peers.`
   );
 }
 function assertCompatibleDshRuntime() {
@@ -6526,22 +6560,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 +6688,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 +6738,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 +6841,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 +6857,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) => {
@@ -9848,7 +9886,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." },
@@ -10363,14 +10401,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,