@remnic/core 9.6.30 → 9.6.32

package/dist/{chunk-77UPM7P3.js → chunk-TVIVY7KU.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-LUPVCGYK.js";
 import {
   buildEvidencePack
-} from "./chunk-R26WO46Z.js";
+} from "./chunk-DGFU5MSX.js";
 import {
   lcmArchiveRowId,
   lcmEvidenceIdentity
@@ -343,7 +343,8 @@ async function buildExplicitCueRecallSection(options) {
     maxItemChars: normalizePositiveInteger(
       options.maxItemChars,
       DEFAULT_MAX_ITEM_CHARS
-    )
+    ),
+    ...options.onEvidenceSelected ? { onSelection: options.onEvidenceSelected } : {}
   });
 }
 function buildEvidenceFocusQuery(query, options) {
@@ -392,8 +393,29 @@ async function buildTrajectoryAnalysisRecallSection(options) {
     return "";
   }
   const clipped = truncateTrajectoryAnalysisLines(lines, bodyBudget);
-  return clipped.length === 0 ? "" : `${header}
-${clipped.join("\n")}`;
+  if (clipped.length === 0) return "";
+  const text = `${header}
+${clipped.map((line) => line.text).join("\n")}`;
+  if (options.onLineSelected) {
+    let lineStart = header.length + 1;
+    for (const line of clipped) {
+      const lineEnd = lineStart + line.text.length;
+      options.onLineSelected({
+        lineStart,
+        lineEnd,
+        lineageStatus: line.lineageStatus,
+        actionArchiveRowIds: [...line.actionArchiveRowIds],
+        observationArchiveRowIds: [...line.observationArchiveRowIds]
+      });
+      lineStart = lineEnd + 1;
+    }
+  }
+  return text;
+}
+function uniqueSortedArchiveRowIds(values) {
+  return [...new Set(values.filter(
+    (value) => typeof value === "number" && Number.isSafeInteger(value) && value > 0
+  ))].sort((left, right) => left - right);
 }
 async function collectTurnReferenceEvidence(options) {
   if (!options.sessionId) {
@@ -846,6 +868,40 @@ async function collectLexicalCueEvidence(options) {
     }
   }
 }
+var TrajectoryAnalysisLines = class extends Array {
+  sources = /* @__PURE__ */ new Map();
+  pushWithSources(text, actionSteps = [], observationSteps = []) {
+    const index = this.length;
+    const length = super.push(text);
+    const hasUnavailableSource = actionSteps.some(
+      (step) => lcmArchiveRowId({ id: step.actionArchiveRowId }) === void 0
+    ) || observationSteps.some(
+      (step) => lcmArchiveRowId({ id: step.observationArchiveRowId }) === void 0
+    );
+    this.sources.set(index, {
+      lineageStatus: hasUnavailableSource ? "unavailable" : "exact",
+      actionArchiveRowIds: hasUnavailableSource ? [] : uniqueSortedArchiveRowIds(
+        actionSteps.map((step) => step.actionArchiveRowId)
+      ),
+      observationArchiveRowIds: hasUnavailableSource ? [] : uniqueSortedArchiveRowIds(
+        observationSteps.map((step) => step.observationArchiveRowId)
+      )
+    });
+    return length;
+  }
+  sourceAt(index) {
+    const source = this.sources.get(index);
+    return source ? {
+      lineageStatus: source.lineageStatus,
+      actionArchiveRowIds: [...source.actionArchiveRowIds],
+      observationArchiveRowIds: [...source.observationArchiveRowIds]
+    } : {
+      lineageStatus: "unavailable",
+      actionArchiveRowIds: [],
+      observationArchiveRowIds: []
+    };
+  }
+};
 function hasTrajectoryAnalysisIntent(query) {
   const normalized = normalizeTrajectoryQuery(query);
   if (collectExplicitTurnReferences(query).length > 0) {
@@ -968,9 +1024,10 @@ function inferTrajectoryBounds(query, trajectory) {
 function buildTrajectoryAnalysisLines(query, trajectory, bounds) {
   const normalized = normalizeTrajectoryQuery(query);
   const explicitReferences = collectExplicitTurnReferences(query);
-  const lines = [
+  const lines = new TrajectoryAnalysisLines();
+  lines.pushWithSources(
     `Analyzed labeled action/observation transcript window: steps ${bounds.start}-${bounds.end} (${bounds.reason}).`
-  ];
+  );
   const hasQuotedObservationPair = extractQuotedObservations(query).length >= 2;
   const transition = findObservationTransition(query, trajectory);
   const entities = extractNumberedEntities(query);
@@ -983,8 +1040,14 @@ function buildTrajectoryAnalysisLines(query, trajectory, bounds) {
   const asksEntityState = /\bstate\b/.test(normalized) || /\bchanges?\s+history\b/.test(normalized) || /\bwhole\s+changes?\s+history\b/.test(normalized);
   const asksResultingObservation = /\bresulting\s+state\b/.test(normalized) || /\bprovide\s+the\s+full\s+observation\b/.test(normalized) || /\bwhat\s+will\s+be\s+the\s+resulting\b/.test(normalized);
   if (transition) {
-    lines.push(
-      `Matched quoted observations: Observation ${transition.fromStep} -> Observation ${transition.toStep}.`
+    const fromStep = trajectory.find((step) => step.step === transition.fromStep);
+    const toStep = trajectory.find((step) => step.step === transition.toStep);
+    lines.pushWithSources(
+      `Matched quoted observations: Observation ${transition.fromStep} -> Observation ${transition.toStep}.`,
+      [],
+      [fromStep, toStep].filter(
+        (step) => step !== void 0
+      )
     );
     appendActionSequenceSummary(
       lines,
@@ -1048,7 +1111,7 @@ function buildTrajectoryAnalysisLines(query, trajectory, bounds) {
       });
     }
   }
-  return lines.length === 1 ? [] : lines;
+  return lines.length === 1 ? new TrajectoryAnalysisLines() : lines;
 }
 function appendReferencedTrajectoryLines(lines, trajectory, references, options) {
   const byStep = new Map(trajectory.map((step) => [step.step, step]));
@@ -1056,13 +1119,17 @@ function appendReferencedTrajectoryLines(lines, trajectory, references, options)
   if (window.length === 0) {
     return;
   }
-  lines.push(options.heading);
+  lines.pushWithSources(options.heading);
   for (const step of window) {
     if (step.action) {
-      lines.push(`[Action ${step.step}]: ${step.action}`);
+      lines.pushWithSources(`[Action ${step.step}]: ${step.action}`, [step]);
     }
     if (options.includeObservations && step.observation) {
-      lines.push(`[Observation ${step.step}]: ${oneLine(step.observation)}`);
+      lines.pushWithSources(
+        `[Observation ${step.step}]: ${oneLine(step.observation)}`,
+        [],
+        [step]
+      );
     }
   }
 }
@@ -1077,31 +1144,40 @@ function appendActionRangeLines(lines, trajectory, start, end, options) {
   if (window.length === 0) {
     return;
   }
-  lines.push(options.heading);
+  lines.pushWithSources(options.heading);
   for (const step of window) {
     if (step.action) {
-      lines.push(`[Action ${step.step}]: ${step.action}`);
+      lines.pushWithSources(`[Action ${step.step}]: ${step.action}`, [step]);
     }
     if (options.includeObservations && step.observation) {
-      lines.push(`[Observation ${step.step}]: ${oneLine(step.observation)}`);
+      lines.pushWithSources(
+        `[Observation ${step.step}]: ${oneLine(step.observation)}`,
+        [],
+        [step]
+      );
     }
   }
 }
 function appendActionSequenceSummary(lines, trajectory, start, end, heading) {
   const low = Math.min(start, end);
   const high = Math.max(start, end);
-  const actions = trajectory.filter((step) => step.step >= low && step.step <= high && step.action).map((step) => `step ${step.step}: ${step.action}`);
+  const actionSteps = trajectory.filter((step) => step.step >= low && step.step <= high && step.action);
+  const actions = actionSteps.map((step) => `step ${step.step}: ${step.action}`);
   if (actions.length === 0) {
     return;
   }
-  lines.push(`${heading} ${actions.join("; ")}.`);
+  lines.pushWithSources(`${heading} ${actions.join("; ")}.`, actionSteps);
 }
 function appendResultingObservationLine(lines, trajectory, stepNumber) {
   const step = trajectory.find((candidate) => candidate.step === stepNumber);
   if (!step?.observation) {
     return;
   }
-  lines.push(`Resulting observation after Action ${step.step}: ${oneLine(step.observation)}`);
+  lines.pushWithSources(
+    `Resulting observation after Action ${step.step}: ${oneLine(step.observation)}`,
+    [],
+    [step]
+  );
 }
 function appendSpatialTrajectoryInferenceLines(lines, query, trajectory, bounds) {
   const normalized = normalizeTrajectoryQuery(query);
@@ -1119,22 +1195,22 @@ function appendSpatialTrajectoryInferenceLines(lines, query, trajectory, bounds)
   const window = spatialTrajectoryWindowForQuery(query, trajectory, bounds);
   const counterfactualContactLines = collectCounterfactualContactLines(query, trajectory, normalized);
   if (counterfactualContactLines.length > 0) {
-    lines.push("Counterfactual contact cues:");
+    lines.pushWithSources("Counterfactual contact cues:");
     lines.push(...counterfactualContactLines);
   }
   const selfReversingLines = collectSelfReversingProgressLines(query, window, normalized);
   if (selfReversingLines.length > 0) {
-    lines.push("Self-reversing sequence cues:");
+    lines.pushWithSources("Self-reversing sequence cues:");
     lines.push(...selfReversingLines);
   }
   const onlyEffectiveActionLines = collectOnlyEffectiveActionLines(window, normalized);
   if (onlyEffectiveActionLines.length > 0) {
-    lines.push("Only-effective action cues:");
+    lines.pushWithSources("Only-effective action cues:");
     lines.push(...onlyEffectiveActionLines);
   }
   const pushedPhraseGroupLines = collectPushedPhraseGroupShiftLines(query, window, normalized);
   if (pushedPhraseGroupLines.length > 0) {
-    lines.push("Pushed phrase-group shift cues:");
+    lines.pushWithSources("Pushed phrase-group shift cues:");
     lines.push(...pushedPhraseGroupLines);
   }
   const suppressMovementProgressEvidence = onlyEffectiveActionLines.length > 0 || selfReversingLines.some(
@@ -1142,12 +1218,12 @@ function appendSpatialTrajectoryInferenceLines(lines, query, trajectory, bounds)
   ) || pushedPhraseGroupLines.length > 0;
   const actionMovementLines = suppressMovementProgressEvidence ? [] : collectActionMovementSummaryLines(query, window, bounds);
   if (actionMovementLines.length > 0) {
-    lines.push("Action movement summary cues:");
+    lines.pushWithSources("Action movement summary cues:");
     lines.push(...actionMovementLines);
   }
   const movementLines = suppressMovementProgressEvidence ? [] : collectMovementDeltaLines(query, window);
   if (movementLines.length > 0) {
-    lines.push("Relative-position movement cues:");
+    lines.pushWithSources("Relative-position movement cues:");
     lines.push(...movementLines);
   }
   const objectAlignmentWindow = objectAlignmentWindowForQuery(query, trajectory, bounds);
@@ -1157,77 +1233,77 @@ function appendSpatialTrajectoryInferenceLines(lines, query, trajectory, bounds)
     normalized
   );
   if (objectAlignmentLines.length > 0) {
-    lines.push("Object alignment cues:");
+    lines.pushWithSources("Object alignment cues:");
     lines.push(...objectAlignmentLines);
   }
   const alternativeActionLines = collectAlternativeActionLines(query, trajectory);
   if (alternativeActionLines.length > 0) {
-    lines.push("Counterfactual action cues:");
+    lines.pushWithSources("Counterfactual action cues:");
     lines.push(...alternativeActionLines);
   }
   const adjacentRuleSetupLines = collectAdjacentRuleSetupLines(window, normalized);
   if (adjacentRuleSetupLines.length > 0) {
-    lines.push("Adjacent rule-block setup cues:");
+    lines.pushWithSources("Adjacent rule-block setup cues:");
     lines.push(...adjacentRuleSetupLines);
   }
   const blockedMoveLines = collectBlockedMoveLines(query, window, normalized);
   if (blockedMoveLines.length > 0) {
-    lines.push("Blocked-move cues:");
+    lines.pushWithSources("Blocked-move cues:");
     lines.push(...blockedMoveLines);
   }
   const failedEscapeLines = collectFailedEscapeLines(query, trajectory, normalized);
   if (failedEscapeLines.length > 0) {
-    lines.push("Failed-move escape cues:");
+    lines.pushWithSources("Failed-move escape cues:");
     lines.push(...failedEscapeLines);
   }
   const sameRelativeTextPushLines = collectSameRelativeTextPushLines(window, normalized);
   if (sameRelativeTextPushLines.length > 0) {
-    lines.push("Same-relative text-push cues:");
+    lines.pushWithSources("Same-relative text-push cues:");
     lines.push(...sameRelativeTextPushLines);
   }
   const failedContactLines = sameRelativeTextPushLines.length > 0 ? [] : collectFailedContactBoundaryLines(window, normalized);
   if (failedContactLines.length > 0) {
-    lines.push("Failed-push boundary cues:");
+    lines.pushWithSources("Failed-push boundary cues:");
     lines.push(...failedContactLines);
   }
   const transformationLines = collectTemporaryRuleTransformationLines(window, normalized);
   if (transformationLines.length > 0) {
-    lines.push("Temporary transformation cues:");
+    lines.pushWithSources("Temporary transformation cues:");
     lines.push(...transformationLines);
   }
   const wholeConfigurationShiftLines = collectWholeConfigurationShiftLines(window, normalized);
   if (wholeConfigurationShiftLines.length > 0) {
-    lines.push("Whole-configuration shift cues:");
+    lines.pushWithSources("Whole-configuration shift cues:");
     lines.push(...wholeConfigurationShiftLines);
   }
   const ruleInterventionLines = collectRuleInterventionStrategyLines(window, normalized);
   if (ruleInterventionLines.length > 0) {
-    lines.push("Rule-intervention strategy cues:");
+    lines.pushWithSources("Rule-intervention strategy cues:");
     lines.push(...ruleInterventionLines);
   }
   const missingPushTargetLines = collectMissingPushTargetLines(window, normalized);
   if (missingPushTargetLines.length > 0) {
-    lines.push("Missing-interaction cues:");
+    lines.pushWithSources("Missing-interaction cues:");
     lines.push(...missingPushTargetLines);
   }
   const rulePhraseAlignmentLines = collectRulePhraseAlignmentLines(window, normalized);
   if (rulePhraseAlignmentLines.length > 0) {
-    lines.push("Rule-phrase alignment cues:");
+    lines.pushWithSources("Rule-phrase alignment cues:");
     lines.push(...rulePhraseAlignmentLines);
   }
   const controlRuleInteractionLines = collectControlRuleInteractionLines(window, normalized);
   if (controlRuleInteractionLines.length > 0) {
-    lines.push("Control-rule interaction cues:");
+    lines.pushWithSources("Control-rule interaction cues:");
     lines.push(...controlRuleInteractionLines);
   }
   const ruleTextPositionLines = suppressMovementProgressEvidence ? [] : collectRuleTextPositionLines(window, normalized);
   if (ruleTextPositionLines.length > 0) {
-    lines.push("Rule-text positioning cues:");
+    lines.pushWithSources("Rule-text positioning cues:");
     lines.push(...ruleTextPositionLines);
   }
   const ruleLines = collectRuleStateLines(window, normalized);
   if (ruleLines.length > 0) {
-    lines.push("Rule-state cues:");
+    lines.pushWithSources("Rule-state cues:");
     lines.push(...ruleLines);
   }
 }
@@ -2527,8 +2603,11 @@ function uniqueLines(lines) {
   return [...new Set(lines)];
 }
 function appendActionFrequencyLines(lines, trajectory, bounds) {
+  const actionSteps = boundedTrajectory(trajectory, bounds).filter(
+    (step) => step.action !== void 0
+  );
   const counts = /* @__PURE__ */ new Map();
-  for (const step of boundedTrajectory(trajectory, bounds)) {
+  for (const step of actionSteps) {
     if (!step.action) continue;
     const verb = normalizeActionVerb(step.action);
     if (!verb) continue;
@@ -2540,8 +2619,9 @@ function appendActionFrequencyLines(lines, trajectory, bounds) {
   const frequencies = [...counts.entries()].sort(
     (left, right) => right[1] - left[1] || left[0].localeCompare(right[0])
   );
-  lines.push(
-    `Action frequency through requested window: ${frequencies.map(([verb, count]) => `${verb}=${count}`).join(", ")}.`
+  lines.pushWithSources(
+    `Action frequency through requested window: ${frequencies.map(([verb, count]) => `${verb}=${count}`).join(", ")}.`,
+    actionSteps
   );
 }
 function appendInventoryChangeLines(lines, trajectory, bounds) {
@@ -2557,13 +2637,16 @@ function appendInventoryChangeLines(lines, trajectory, bounds) {
   if (changes.length === 0) {
     return;
   }
-  lines.push("Inventory changes from action transcript:");
+  const changeSteps = changes.map((change) => trajectory.find((step) => step.step === change.step)).filter((step) => step !== void 0);
+  lines.pushWithSources("Inventory changes from action transcript:");
   if (changes.length > 5) {
-    lines.push(
-      `First five inventory changes: ${formatInventoryChangeSummary(changes.slice(0, 5))}.`
+    lines.pushWithSources(
+      `First five inventory changes: ${formatInventoryChangeSummary(changes.slice(0, 5))}.`,
+      changeSteps.slice(0, 5)
     );
-    lines.push(
-      `Complete inventory changes: ${formatInventoryChangeSummary(changes)}.`
+    lines.pushWithSources(
+      `Complete inventory changes: ${formatInventoryChangeSummary(changes)}.`,
+      changeSteps
     );
   }
   for (const change of changes) {
@@ -2589,9 +2672,13 @@ function appendContainerStateChangeLines(lines, trajectory, bounds) {
   if (changes.length === 0) {
     return;
   }
-  lines.push("Container open/close state changes:");
+  lines.pushWithSources("Container open/close state changes:");
   for (const change of changes) {
-    lines.push(`[Action ${change.step}]: ${change.action} => ${change.entity} ${change.state}`);
+    const step = trajectory.find((candidate) => candidate.step === change.step);
+    lines.pushWithSources(
+      `[Action ${change.step}]: ${change.action} => ${change.entity} ${change.state}`,
+      step ? [step] : []
+    );
   }
 }
 function appendEntityTimelineLines(lines, trajectory, bounds, entities, options) {
@@ -2609,26 +2696,33 @@ function appendEntityTimelineLines(lines, trajectory, bounds, entities, options)
     if (directActions.length === 0 && stateChanges.length === 0 && objectTransfers.length === 0) {
       continue;
     }
-    lines.push(`Timeline for ${entity}:`);
+    lines.pushWithSources(`Timeline for ${entity}:`);
     for (const step of directActions) {
-      lines.push(`[Action ${step.step}]: ${step.action}`);
+      lines.pushWithSources(`[Action ${step.step}]: ${step.action}`, [step]);
     }
     if (objectTransfers.length > 0) {
-      lines.push(`Object transfers involving ${entity}:`);
+      lines.pushWithSources(`Object transfers involving ${entity}:`);
       for (const transfer of objectTransfers) {
-        lines.push(`[Action ${transfer.step}]: ${transfer.action} => ${formatContainerTransfer(transfer)}`);
+        const step = trajectory.find((candidate) => candidate.step === transfer.step);
+        lines.pushWithSources(
+          `[Action ${transfer.step}]: ${transfer.action} => ${formatContainerTransfer(transfer)}`,
+          step ? [step] : []
+        );
       }
     }
     const inferredLocation = inferEntityLocation(trajectory, bounds, entity);
     if (inferredLocation) {
-      lines.push(
-        `Inferred ${entity} location at step ${bounds.end}: ${inferredLocation}.`
+      lines.pushWithSources(
+        `Inferred ${entity} location at step ${bounds.end}: ${inferredLocation.location}.`,
+        [inferredLocation.sourceStep]
       );
     }
     if (stateChanges.length > 0) {
       const latest = stateChanges[stateChanges.length - 1];
-      lines.push(
-        `Latest ${entity} state at step ${bounds.end}: ${latest.state}; state changes: ${stateChanges.map((change) => `${change.step}:${change.state}`).join(", ")}.`
+      const stateSteps = stateChanges.map((change) => trajectory.find((step) => step.step === change.step)).filter((step) => step !== void 0);
+      lines.pushWithSources(
+        `Latest ${entity} state at step ${bounds.end}: ${latest.state}; state changes: ${stateChanges.map((change) => `${change.step}:${change.state}`).join(", ")}.`,
+        stateSteps
       );
     }
   }
@@ -2887,12 +2981,14 @@ function isLikelyContainerEntity(entity) {
 function inferEntityLocation(trajectory, bounds, entity) {
   const normalizedEntity = normalizeEntity(entity);
   let location;
+  let sourceStep;
   for (const step of boundedTrajectory(trajectory, bounds)) {
     if (!step.action) continue;
     const action = step.action.trim();
     const take = /^take\s+(.+?)\s+from\s+(.+)$/i.exec(action);
     if (take && normalizeEntity(take[1]) === normalizedEntity) {
       location = "inventory";
+      sourceStep = step;
       continue;
     }
     const move = /^(?:move|put|place|insert)\s+(.+?)\s+(?:to|in|into|on)\s+(.+)$/i.exec(
@@ -2900,9 +2996,10 @@ function inferEntityLocation(trajectory, bounds, entity) {
     );
     if (move && normalizeEntity(move[1]) === normalizedEntity) {
       location = move[2].trim();
+      sourceStep = step;
     }
   }
-  return location;
+  return location && sourceStep ? { location, sourceStep } : void 0;
 }
 function normalizeActionVerb(action) {
   const match = /^([a-z][a-z0-9_-]*)\b/i.exec(action.trim());
@@ -2931,7 +3028,9 @@ function normalizeTurnExpansionEnd(stats) {
 function truncateTrajectoryAnalysisLines(lines, maxChars) {
   const result = [];
   let used = 0;
-  for (const line of lines.slice(0, TRAJECTORY_ANALYSIS_MAX_LINES)) {
+  const limit = Math.min(lines.length, TRAJECTORY_ANALYSIS_MAX_LINES);
+  for (let index = 0; index < limit; index += 1) {
+    const line = lines[index];
     const separator = result.length === 0 ? 0 : 1;
     const remaining = maxChars - used - separator;
     if (remaining <= 0) {
@@ -2941,7 +3040,7 @@ function truncateTrajectoryAnalysisLines(lines, maxChars) {
     if (clipped.length === 0) {
       break;
     }
-    result.push(clipped);
+    result.push({ text: clipped, ...lines.sourceAt(index) });
     used += separator + clipped.length;
   }
   return result;
@@ -4159,4 +4258,4 @@ export {
   collectStructuredPlanCues,
   collectTemporalLexicalCues
 };
-//# sourceMappingURL=chunk-77UPM7P3.js.map
+//# sourceMappingURL=chunk-TVIVY7KU.js.map