@aquex/cmos-mcp 1.0.0

package/dist/intelligence/compression-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression-rules.js","sourceRoot":"","sources":["../../src/intelligence/compression-rules.ts"],"names":[],"mappings":"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"}

package/dist/intelligence/content-sanitizer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * One sanitized field entry surfaced on a tool response.
+ * Populated when a write-path handler strips an artifact before persisting.
+ */
+export interface SanitizedField {
+    /** The field name (or array path like `decisions[2]`) that was sanitized. */
+    field: string;
+    /** Short human-readable explanation of what was stripped. */
+    reason: string;
+}
+/** Result of sanitizing a single string value. */
+export interface SanitizerResult {
+    /** The cleaned string. Identical to input when no artifact was found. */
+    cleaned: string;
+    /** Whether the input was modified. */
+    wasModified: boolean;
+    /** Short reason string, present only when `wasModified` is true. */
+    reason?: string;
+}
+/**
+ * Sanitize a single free-text field.
+ *
+ * Finds the first XML marshalling artifact outside any triple-backtick code
+ * fence, strips from that position to end-of-string, and trims the trailing
+ * whitespace so the cleaned value doesn't carry orphan newlines.
+ *
+ * @param input - The raw field value as received from the tool caller.
+ * @returns The cleaned string and whether anything was stripped.
+ */
+export declare function sanitizeContentField(input: string): SanitizerResult;
+/**
+ * Sanitize a named record of fields in one pass.
+ *
+ * @param input - The record to sanitize. Non-string values are passed through.
+ * @param fieldNames - The subset of fields to scan for artifacts.
+ * @returns A shallow-copied record with cleaned values, plus the per-field
+ *   entries that changed. Pass through unchanged when nothing was stripped.
+ */
+export declare function sanitizeFields<T extends Record<string, unknown>>(input: T, fieldNames: ReadonlyArray<keyof T>): {
+    sanitized: T;
+    sanitizedFields: SanitizedField[];
+};
+/**
+ * Sanitize a homogeneous array of strings (e.g. `decisions[]`, `nextSteps[]`).
+ *
+ * Sanitized indices are reported as `${fieldName}[${i}]` so the caller can
+ * tell which array entry was altered.
+ *
+ * @param fieldName - The array's name, used to build field-path labels.
+ * @param values - The array to sanitize. Non-string entries are passed through.
+ * @returns Cleaned array plus a list of altered entries.
+ */
+export declare function sanitizeStringArray(fieldName: string, values: readonly string[] | undefined): {
+    cleaned: string[] | undefined;
+    sanitizedFields: SanitizedField[];
+};
+/**
+ * Merge multiple `sanitizedFields` arrays, de-duplicating by field name (first wins).
+ */
+export declare function mergeSanitizedFields(...groups: ReadonlyArray<ReadonlyArray<SanitizedField>>): SanitizedField[];
+//# sourceMappingURL=content-sanitizer.d.ts.map

package/dist/intelligence/content-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-sanitizer.d.ts","sourceRoot":"","sources":["../../src/intelligence/content-sanitizer.ts"],"names":[],"mappings":"AAoCA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqBD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CA4BnE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,KAAK,EAAE,CAAC,EACR,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,GACjC;IAAE,SAAS,EAAE,CAAC,CAAC;IAAC,eAAe,EAAE,cAAc,EAAE,CAAA;CAAE,CAuBrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACpC;IAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAAC,eAAe,EAAE,cAAc,EAAE,CAAA;CAAE,CA2BtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,GACtD,cAAc,EAAE,CAWlB"}

package/dist/intelligence/content-sanitizer.js

@@ -0,0 +1,170 @@
+"use strict";
+// ABOUTME: Detects and strips XML sibling-absorption artifacts from free-text fields written through CMOS tools.
+// ABOUTME: Strip-and-surface semantics: cleaned content is written, field names bubble up via sanitizedFields.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeContentField = sanitizeContentField;
+exports.sanitizeFields = sanitizeFields;
+exports.sanitizeStringArray = sanitizeStringArray;
+exports.mergeSanitizedFields = mergeSanitizedFields;
+/**
+ * Content sanitizer for XML marshalling artifacts.
+ *
+ * Sprint 56 m02 — root cause: when an agent emits a tool call like
+ *   <parameter name="content">...text...</content>
+ * with a misspelled closing tag (e.g. `</content` missing the trailing `>`),
+ * the harness's XML→JSON marshaller absorbs the following
+ * `<parameter name="missionId">` block as literal string content. The JSON
+ * that reaches the MCP server is schema-valid (the `content` field is just
+ * a very long string), so the write succeeds and corruption lives forever.
+ *
+ * Strategy: scan incoming free-text fields for the literal `<parameter …>`
+ * or `</parameter …>` / `<content …>` / `</content …>` patterns outside
+ * triple-backtick code fences. When detected, strip from the artifact
+ * onwards and surface a per-field warning on the tool response so the
+ * calling agent can re-emit.
+ *
+ * Legitimate content inside ```…``` fences (e.g. embedded code samples) is
+ * preserved — that is the one place an agent may genuinely include these
+ * tokens.
+ *
+ * @module intelligence/content-sanitizer
+ */
+/** Tag names that trigger sanitization when they appear as literal XML/XML-like markup. */
+const ARTIFACT_TAG_NAMES = ['content', 'parameter', 'invoke', 'function_calls'];
+/** Matches any `<tag …>` or `</tag …>` for one of the tracked tag names. */
+const ARTIFACT_PATTERN = new RegExp(`<\\/?(?:${ARTIFACT_TAG_NAMES.join('|')})\\b[^>]*>`, 'g');
+/** Matches a balanced triple-backtick code fence. `[\s\S]` keeps newlines in scope. */
+const CODE_FENCE_PATTERN = /```[\s\S]*?```/g;
+function findCodeFenceRanges(input) {
+    const ranges = [];
+    let match;
+    CODE_FENCE_PATTERN.lastIndex = 0;
+    while ((match = CODE_FENCE_PATTERN.exec(input)) !== null) {
+        ranges.push([match.index, match.index + match[0].length]);
+    }
+    return ranges;
+}
+function isInsideAny(index, ranges) {
+    for (const [start, end] of ranges) {
+        if (index >= start && index < end) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Sanitize a single free-text field.
+ *
+ * Finds the first XML marshalling artifact outside any triple-backtick code
+ * fence, strips from that position to end-of-string, and trims the trailing
+ * whitespace so the cleaned value doesn't carry orphan newlines.
+ *
+ * @param input - The raw field value as received from the tool caller.
+ * @returns The cleaned string and whether anything was stripped.
+ */
+function sanitizeContentField(input) {
+    if (!input || typeof input !== 'string') {
+        return { cleaned: input, wasModified: false };
+    }
+    const fences = findCodeFenceRanges(input);
+    ARTIFACT_PATTERN.lastIndex = 0;
+    let firstIndex = -1;
+    let firstMatchText = null;
+    let match;
+    while ((match = ARTIFACT_PATTERN.exec(input)) !== null) {
+        if (!isInsideAny(match.index, fences)) {
+            firstIndex = match.index;
+            firstMatchText = match[0];
+            break;
+        }
+    }
+    if (firstIndex === -1 || firstMatchText === null) {
+        return { cleaned: input, wasModified: false };
+    }
+    const cleaned = input.slice(0, firstIndex).replace(/\s+$/, '');
+    const snippet = firstMatchText.length > 40 ? `${firstMatchText.slice(0, 40)}…` : firstMatchText;
+    const reason = `Stripped XML marshalling artifact starting with ${JSON.stringify(snippet)} — the tool harness absorbed a sibling parameter into this field; re-emit the content without the spurious tag.`;
+    return { cleaned, wasModified: true, reason };
+}
+/**
+ * Sanitize a named record of fields in one pass.
+ *
+ * @param input - The record to sanitize. Non-string values are passed through.
+ * @param fieldNames - The subset of fields to scan for artifacts.
+ * @returns A shallow-copied record with cleaned values, plus the per-field
+ *   entries that changed. Pass through unchanged when nothing was stripped.
+ */
+function sanitizeFields(input, fieldNames) {
+    let copy = null;
+    const sanitizedFields = [];
+    for (const field of fieldNames) {
+        const value = input[field];
+        if (typeof value !== 'string') {
+            continue;
+        }
+        const result = sanitizeContentField(value);
+        if (result.wasModified) {
+            if (copy === null) {
+                copy = { ...input };
+            }
+            copy[field] = result.cleaned;
+            sanitizedFields.push({
+                field: field,
+                reason: result.reason ?? 'Stripped XML marshalling artifact.',
+            });
+        }
+    }
+    return { sanitized: copy ?? input, sanitizedFields };
+}
+/**
+ * Sanitize a homogeneous array of strings (e.g. `decisions[]`, `nextSteps[]`).
+ *
+ * Sanitized indices are reported as `${fieldName}[${i}]` so the caller can
+ * tell which array entry was altered.
+ *
+ * @param fieldName - The array's name, used to build field-path labels.
+ * @param values - The array to sanitize. Non-string entries are passed through.
+ * @returns Cleaned array plus a list of altered entries.
+ */
+function sanitizeStringArray(fieldName, values) {
+    if (!values) {
+        return { cleaned: values, sanitizedFields: [] };
+    }
+    const cleaned = new Array(values.length);
+    const sanitizedFields = [];
+    let anyModified = false;
+    for (let i = 0; i < values.length; i++) {
+        const value = values[i];
+        if (typeof value !== 'string') {
+            cleaned[i] = value;
+            continue;
+        }
+        const result = sanitizeContentField(value);
+        cleaned[i] = result.cleaned;
+        if (result.wasModified) {
+            anyModified = true;
+            sanitizedFields.push({
+                field: `${fieldName}[${i}]`,
+                reason: result.reason ?? 'Stripped XML marshalling artifact.',
+            });
+        }
+    }
+    return { cleaned: anyModified ? cleaned : values, sanitizedFields };
+}
+/**
+ * Merge multiple `sanitizedFields` arrays, de-duplicating by field name (first wins).
+ */
+function mergeSanitizedFields(...groups) {
+    const seen = new Set();
+    const out = [];
+    for (const group of groups) {
+        for (const entry of group) {
+            if (seen.has(entry.field))
+                continue;
+            seen.add(entry.field);
+            out.push(entry);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=content-sanitizer.js.map

package/dist/intelligence/content-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-sanitizer.js","sourceRoot":"","sources":["../../src/intelligence/content-sanitizer.ts"],"names":[],"mappings":"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"}

package/dist/intelligence/context-propagator-v2.d.ts

@@ -0,0 +1,23 @@
+import { ContextPropagator, ContextPropagatorConfig, ContextSummary, SubMissionResult } from './context-propagator';
+import { MissionHistoryAnalyzer, MissionHistoryHighlight } from './mission-history';
+export interface ContextSummaryV2 extends ContextSummary {
+    historyHighlights: MissionHistoryHighlight[];
+}
+export interface ContextPropagatorV2Options {
+    includeHistory?: boolean;
+    relatedMissionIds?: string[];
+    historyLimitPerMission?: number;
+}
+/**
+ * ContextPropagatorV2
+ *
+ * Builds on the base context propagator by enriching the propagated payload with
+ * recent mission history. This gives downstream tooling visibility into relevant
+ * completions that shape the current mission context.
+ */
+export declare class ContextPropagatorV2 extends ContextPropagator {
+    private readonly historyAnalyzer;
+    constructor(config: ContextPropagatorConfig, historyAnalyzer?: MissionHistoryAnalyzer);
+    propagateContext(originalMission: string, completedResults: SubMissionResult[], currentSubMission: string, options?: ContextPropagatorV2Options): Promise<ContextSummaryV2>;
+}
+//# sourceMappingURL=context-propagator-v2.d.ts.map

package/dist/intelligence/context-propagator-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-propagator-v2.d.ts","sourceRoot":"","sources":["../../src/intelligence/context-propagator-v2.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEpF,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,iBAAiB,EAAE,uBAAuB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IAGtD,OAAO,CAAC,QAAQ,CAAC,eAAe;gBADhC,MAAM,EAAE,uBAAuB,EACd,eAAe,GAAE,sBAAqD;IAKnF,gBAAgB,CACpB,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,gBAAgB,EAAE,EACpC,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,gBAAgB,CAAC;CA2B7B"}

package/dist/intelligence/context-propagator-v2.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextPropagatorV2 = void 0;
+const context_propagator_1 = require("./context-propagator");
+const mission_history_1 = require("./mission-history");
+/**
+ * ContextPropagatorV2
+ *
+ * Builds on the base context propagator by enriching the propagated payload with
+ * recent mission history. This gives downstream tooling visibility into relevant
+ * completions that shape the current mission context.
+ */
+class ContextPropagatorV2 extends context_propagator_1.ContextPropagator {
+    constructor(config, historyAnalyzer = new mission_history_1.MissionHistoryAnalyzer()) {
+        super(config);
+        this.historyAnalyzer = historyAnalyzer;
+    }
+    async propagateContext(originalMission, completedResults, currentSubMission, options = {}) {
+        const summary = await super.propagateContext(originalMission, completedResults, currentSubMission);
+        if (options.includeHistory === false) {
+            return {
+                ...summary,
+                historyHighlights: [],
+            };
+        }
+        const relatedMissionIds = options.relatedMissionIds ?? [];
+        const historyHighlights = relatedMissionIds.length
+            ? await this.historyAnalyzer.collectHighlights(relatedMissionIds, options.historyLimitPerMission ?? 1)
+            : [];
+        return {
+            ...summary,
+            historyHighlights,
+        };
+    }
+}
+exports.ContextPropagatorV2 = ContextPropagatorV2;
+//# sourceMappingURL=context-propagator-v2.js.map

package/dist/intelligence/context-propagator-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-propagator-v2.js","sourceRoot":"","sources":["../../src/intelligence/context-propagator-v2.ts"],"names":[],"mappings":";;;AAAA,6DAK8B;AAC9B,uDAAoF;AAYpF;;;;;;GAMG;AACH,MAAa,mBAAoB,SAAQ,sCAAiB;IACxD,YACE,MAA+B,EACd,kBAA0C,IAAI,wCAAsB,EAAE;QAEvF,KAAK,CAAC,MAAM,CAAC,CAAC;QAFG,oBAAe,GAAf,eAAe,CAAuD;IAGzF,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,eAAuB,EACvB,gBAAoC,EACpC,iBAAyB,EACzB,UAAsC,EAAE;QAExC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAC1C,eAAe,EACf,gBAAgB,EAChB,iBAAiB,CAClB,CAAC;QAEF,IAAI,OAAO,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;YACrC,OAAO;gBACL,GAAG,OAAO;gBACV,iBAAiB,EAAE,EAAE;aACtB,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC;QAC1D,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,MAAM;YAChD,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAC1C,iBAAiB,EACjB,OAAO,CAAC,sBAAsB,IAAI,CAAC,CACpC;YACH,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,GAAG,OAAO;YACV,iBAAiB;SAClB,CAAC;IACJ,CAAC;CACF;AAxCD,kDAwCC"}

package/dist/intelligence/context-propagator-v3.d.ts

@@ -0,0 +1,46 @@
+import { ContextPropagatorConfig, SubMissionResult } from './context-propagator';
+import { ContextPropagatorV2, ContextPropagatorV2Options, ContextSummaryV2 } from './context-propagator-v2';
+import { MissionHistoryAnalyzer } from './mission-history';
+export interface HybridRetrievalOptions extends ContextPropagatorV2Options {
+    query?: string;
+    retrievalCount?: number;
+    chunkTokens?: number;
+    chunkOverlapTokens?: number;
+    sparseWeight?: number;
+    denseWeight?: number;
+}
+export interface RetrievedChunk {
+    missionId: string;
+    source: 'input' | 'output';
+    text: string;
+    sparseScore: number;
+    denseScore: number;
+    combinedScore: number;
+}
+export interface HybridRetrievalStats {
+    totalChunks: number;
+    topK: number;
+    sparseWeight: number;
+    denseWeight: number;
+}
+export interface ContextSummaryV3 extends ContextSummaryV2 {
+    retrievedChunks: RetrievedChunk[];
+    retrievalStats: HybridRetrievalStats;
+}
+export declare class ContextPropagatorV3 extends ContextPropagatorV2 {
+    private readonly defaultChunkTokens;
+    private readonly defaultChunkOverlap;
+    constructor(config: ContextPropagatorConfig, historyAnalyzer?: MissionHistoryAnalyzer);
+    propagateContext(originalMission: string, completedResults: SubMissionResult[], currentSubMission: string, options?: HybridRetrievalOptions): Promise<ContextSummaryV3>;
+    private runHybridRetrieval;
+    private buildQuery;
+    private buildCorpus;
+    private chunkText;
+    private tokenize;
+    private toVector;
+    private computeSparseScore;
+    private computeDenseScore;
+    private composeContextBlock;
+    private normalizeWeight;
+}
+//# sourceMappingURL=context-propagator-v3.d.ts.map

package/dist/intelligence/context-propagator-v3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-propagator-v3.d.ts","sourceRoot":"","sources":["../../src/intelligence/context-propagator-v3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,sBAAuB,SAAQ,0BAA0B;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAgDD,qBAAa,mBAAoB,SAAQ,mBAAmB;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAG3C,MAAM,EAAE,uBAAuB,EAC/B,eAAe,GAAE,sBAAyE;IAOtF,gBAAgB,CACpB,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,gBAAgB,EAAE,EACpC,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,gBAAgB,CAAC;IAuB5B,OAAO,CAAC,kBAAkB;IA6G1B,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,WAAW;IA4CnB,OAAO,CAAC,SAAS;IAmBjB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,eAAe;CAMxB"}

package/dist/intelligence/context-propagator-v3.js

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextPropagatorV3 = void 0;
+const context_propagator_v2_1 = require("./context-propagator-v2");
+const mission_history_1 = require("./mission-history");
+const STOP_WORDS = new Set([
+    'the',
+    'and',
+    'for',
+    'that',
+    'with',
+    'from',
+    'this',
+    'have',
+    'will',
+    'into',
+    'your',
+    'about',
+    'over',
+    'under',
+    'between',
+    'within',
+    'through',
+    'while',
+    'where',
+    'which',
+    'when',
+    'what',
+    'shall',
+    'should',
+    'would',
+    'could',
+    'into',
+    'onto',
+    'across',
+    'their',
+    'there',
+]);
+class ContextPropagatorV3 extends context_propagator_v2_1.ContextPropagatorV2 {
+    constructor(config, historyAnalyzer = new mission_history_1.MissionHistoryAnalyzer({ sessionsPath: '' })) {
+        super(config, historyAnalyzer);
+        this.defaultChunkTokens = Math.max(120, Math.floor(config.maxContextTokens / 6));
+        this.defaultChunkOverlap = Math.max(20, Math.floor(this.defaultChunkTokens / 6));
+    }
+    async propagateContext(originalMission, completedResults, currentSubMission, options = {}) {
+        const baseSummary = await super.propagateContext(originalMission, completedResults, currentSubMission, options);
+        const retrieval = this.runHybridRetrieval(originalMission, completedResults, options);
+        const augmentedSummary = retrieval.contextBlock.length === 0
+            ? baseSummary.summary
+            : `${baseSummary.summary}\n\n${retrieval.contextBlock}`;
+        return {
+            ...baseSummary,
+            summary: augmentedSummary,
+            retrievedChunks: retrieval.retrievedChunks,
+            retrievalStats: retrieval.stats,
+        };
+    }
+    runHybridRetrieval(originalMission, completedResults, options) {
+        const retrievalCount = Math.max(1, options.retrievalCount ?? 4);
+        const chunkTokens = Math.max(40, options.chunkTokens ?? this.defaultChunkTokens);
+        const overlapTokens = Math.min(Math.floor(chunkTokens / 2), Math.max(10, options.chunkOverlapTokens ?? this.defaultChunkOverlap));
+        const sparseWeight = this.normalizeWeight(options.sparseWeight ?? 0.55);
+        const denseWeight = this.normalizeWeight(options.denseWeight ?? 0.45);
+        if (completedResults.length === 0) {
+            return {
+                contextBlock: '',
+                retrievedChunks: [],
+                stats: {
+                    totalChunks: 0,
+                    topK: 0,
+                    sparseWeight,
+                    denseWeight,
+                },
+            };
+        }
+        const queryText = (options.query ?? this.buildQuery(originalMission, completedResults)).trim();
+        if (queryText.length === 0) {
+            return {
+                contextBlock: '',
+                retrievedChunks: [],
+                stats: {
+                    totalChunks: 0,
+                    topK: 0,
+                    sparseWeight,
+                    denseWeight,
+                },
+            };
+        }
+        const corpus = this.buildCorpus(completedResults, chunkTokens, overlapTokens);
+        if (corpus.length === 0) {
+            return {
+                contextBlock: '',
+                retrievedChunks: [],
+                stats: {
+                    totalChunks: 0,
+                    topK: 0,
+                    sparseWeight,
+                    denseWeight,
+                },
+            };
+        }
+        const queryTokens = this.tokenize(queryText);
+        if (queryTokens.length === 0) {
+            return {
+                contextBlock: '',
+                retrievedChunks: [],
+                stats: {
+                    totalChunks: corpus.length,
+                    topK: 0,
+                    sparseWeight,
+                    denseWeight,
+                },
+            };
+        }
+        const queryVector = this.toVector(queryTokens);
+        const scoredChunks = corpus.map((chunk) => {
+            const sparseScore = this.computeSparseScore(queryTokens, chunk.tokens);
+            const denseScore = this.computeDenseScore(queryVector, this.toVector(chunk.tokens));
+            const combinedScore = sparseWeight * sparseScore + denseWeight * denseScore;
+            return {
+                missionId: chunk.missionId,
+                source: chunk.source,
+                text: chunk.text,
+                sparseScore,
+                denseScore,
+                combinedScore,
+            };
+        });
+        const retrievedChunks = scoredChunks
+            .sort((a, b) => b.combinedScore - a.combinedScore)
+            .slice(0, retrievalCount)
+            .filter((chunk) => chunk.combinedScore > 0);
+        const contextBlock = retrievedChunks.length === 0 ? '' : this.composeContextBlock(retrievedChunks);
+        return {
+            contextBlock,
+            retrievedChunks,
+            stats: {
+                totalChunks: corpus.length,
+                topK: retrievedChunks.length,
+                sparseWeight,
+                denseWeight,
+            },
+        };
+    }
+    buildQuery(originalMission, completedResults) {
+        const parts = [originalMission];
+        const lastResult = completedResults[completedResults.length - 1];
+        if (lastResult) {
+            if (lastResult.output?.length) {
+                parts.push(lastResult.output);
+            }
+            if (lastResult.input?.length) {
+                parts.push(lastResult.input);
+            }
+        }
+        return parts.join('\n');
+    }
+    buildCorpus(completedResults, chunkTokens, overlapTokens) {
+        const chunks = [];
+        for (const result of completedResults) {
+            const missionId = result.missionId;
+            if (result.input?.trim()) {
+                const inputChunks = this.chunkText(result.input, chunkTokens, overlapTokens);
+                for (const text of inputChunks) {
+                    const tokens = this.tokenize(text);
+                    if (tokens.length > 0) {
+                        chunks.push({
+                            missionId,
+                            source: 'input',
+                            text,
+                            tokens,
+                        });
+                    }
+                }
+            }
+            if (result.output?.trim()) {
+                const outputChunks = this.chunkText(result.output, chunkTokens, overlapTokens);
+                for (const text of outputChunks) {
+                    const tokens = this.tokenize(text);
+                    if (tokens.length > 0) {
+                        chunks.push({
+                            missionId,
+                            source: 'output',
+                            text,
+                            tokens,
+                        });
+                    }
+                }
+            }
+        }
+        return chunks;
+    }
+    chunkText(text, targetTokens, overlapTokens) {
+        const words = text.split(/\s+/).filter((word) => word.trim().length > 0);
+        const chunks = [];
+        let start = 0;
+        while (start < words.length) {
+            const end = Math.min(words.length, start + targetTokens);
+            const slice = words.slice(start, end).join(' ');
+            chunks.push(slice.trim());
+            if (end === words.length) {
+                break;
+            }
+            start = Math.max(0, end - overlapTokens);
+        }
+        return chunks;
+    }
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .split(/[^a-z0-9]+/)
+            .map((token) => token.trim())
+            .filter((token) => token.length > 2 && !STOP_WORDS.has(token));
+    }
+    toVector(tokens) {
+        const weights = new Map();
+        for (const token of tokens) {
+            weights.set(token, (weights.get(token) ?? 0) + 1);
+        }
+        let normSquared = 0;
+        for (const value of weights.values()) {
+            normSquared += value * value;
+        }
+        return {
+            weights,
+            norm: Math.sqrt(normSquared),
+        };
+    }
+    computeSparseScore(queryTokens, chunkTokens) {
+        const querySet = new Set(queryTokens);
+        let matches = 0;
+        for (const token of chunkTokens) {
+            if (querySet.has(token)) {
+                matches += 1;
+            }
+        }
+        return matches / querySet.size;
+    }
+    computeDenseScore(queryVector, chunkVector) {
+        let dot = 0;
+        for (const [token, weight] of queryVector.weights.entries()) {
+            const other = chunkVector.weights.get(token);
+            if (other) {
+                dot += weight * other;
+            }
+        }
+        return dot / (queryVector.norm * chunkVector.norm);
+    }
+    composeContextBlock(retrievedChunks) {
+        const lines = ['=== HYBRID RAG CONTEXT ==='];
+        retrievedChunks.forEach((chunk, index) => {
+            const header = `Chunk ${index + 1} | Mission ${chunk.missionId} (${chunk.source}) | score=${chunk.combinedScore.toFixed(2)}`;
+            lines.push(header);
+            lines.push(chunk.text.trim());
+        });
+        return lines.join('\n');
+    }
+    normalizeWeight(weight) {
+        if (!Number.isFinite(weight) || weight <= 0) {
+            return 0.5;
+        }
+        return Math.min(1, Math.max(0, weight));
+    }
+}
+exports.ContextPropagatorV3 = ContextPropagatorV3;
+//# sourceMappingURL=context-propagator-v3.js.map