@massa-ai/core 1.2.1

package/dist/services/synapse/session/session-store-pg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store-pg.js","sourceRoot":"","sources":["../../../../src/services/synapse/session/session-store-pg.ts"],"names":[],"mappings":"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"}

package/dist/services/synapse/session/session-store.d.ts

@@ -0,0 +1,23 @@
+import type { AgentSession } from "../types.js";
+import type { WorkingMemoryBufferConfig } from "../buffer/working-memory-buffer.js";
+import { PgSynapseSessionStore } from "./session-store-pg.js";
+export interface SessionStore {
+    save(session: AgentSession): void;
+    load(sessionId: string): AgentSession | null;
+    delete(sessionId: string): void;
+    recordAccess(sessionId: string, memoryId: string, count: number): void;
+    ensureReady(): Promise<void>;
+}
+/** Test double; production always instantiates PgSynapseSessionStore. */
+export declare class MemorySessionStore implements SessionStore {
+    save(): void;
+    load(): AgentSession | null;
+    delete(): void;
+    recordAccess(): void;
+    ensureReady(): Promise<void>;
+}
+export declare function getSessionStore(): PgSynapseSessionStore;
+export declare function resetSessionStore(): void;
+export type { WorkingMemoryBufferConfig };
+export declare function tokenize(text: string): Set<string>;
+//# sourceMappingURL=session-store.d.ts.map

package/dist/services/synapse/session/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../../src/services/synapse/session/session-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,MAAM,WAAW,YAAY;IAAG,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAAE;AACzP,yEAAyE;AACzE,qBAAa,kBAAmB,YAAW,YAAY;IAAG,IAAI,IAAI,IAAI;IAAI,IAAI,IAAI,YAAY,GAAG,IAAI;IAAkB,MAAM,IAAI,IAAI;IAAI,YAAY,IAAI,IAAI;IAAI,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAAgC;AAE7N,wBAAgB,eAAe,IAAI,qBAAqB,CAAgF;AACxI,wBAAgB,iBAAiB,IAAI,IAAI,CAAkB;AAC3D,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAC1C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAsE"}

package/dist/services/synapse/session/session-store.js

@@ -0,0 +1,15 @@
+import { requirePostgresDatabaseUrl } from "@massa-ai/shared/config";
+import { PgSynapseSessionStore } from "./session-store-pg.js";
+/** Test double; production always instantiates PgSynapseSessionStore. */
+export class MemorySessionStore {
+    save() { }
+    load() { return null; }
+    delete() { }
+    recordAccess() { }
+    ensureReady() { return Promise.resolve(); }
+}
+let store = null;
+export function getSessionStore() { requirePostgresDatabaseUrl(); return store ??= new PgSynapseSessionStore(); }
+export function resetSessionStore() { store = null; }
+export function tokenize(text) { return new Set(text.toLowerCase().match(/[a-z0-9_]{2,}/g) ?? []); }
+//# sourceMappingURL=session-store.js.map

package/dist/services/synapse/session/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../../src/services/synapse/session/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAGrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,yEAAyE;AACzE,MAAM,OAAO,kBAAkB;IAA2B,IAAI,KAAU,CAAC;IAAC,IAAI,KAA0B,OAAO,IAAI,CAAC,CAAC,CAAC;IAAC,MAAM,KAAU,CAAC;IAAC,YAAY,KAAU,CAAC;IAAC,WAAW,KAAoB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;CAAE;AAC7N,IAAI,KAAK,GAAiC,IAAI,CAAC;AAC/C,MAAM,UAAU,eAAe,KAA4B,0BAA0B,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,IAAI,qBAAqB,EAAE,CAAC,CAAC,CAAC;AACxI,MAAM,UAAU,iBAAiB,KAAW,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;AAE3D,MAAM,UAAU,QAAQ,CAAC,IAAY,IAAiB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC"}

package/dist/services/synapse/synapse-manager.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SynapseManager — orchestrates the post-retrieval pipeline.
+ *
+ * Composes scoring + inhibition + metacognition over a single result set
+ * plus an optional working-memory buffer keyed by session.
+ *
+ * Order matters:
+ *   0) buffer merge        — fold prior hot results into the fresh ones (opt-in via session)
+ *   1) attention score     — re-rank top-N by multi-signal score (opt-in)
+ *   2) chain inhibition    — boost/suppress by memory type for matched intent
+ *   3) diversity penalty   — re-rank, deduplicate near-clones
+ *   4) temporal inhibition — penalize fresh-but-irrelevant
+ *   5) confidence gate     — drop everything below adaptive threshold
+ *   6) score spectrum      — annotate the survivors with metacognition flags
+ *   7) buffer put          — record final survivors for the next query in the session
+ */
+import type { SearchResult, SynapseRuntimeConfig } from "@massa-ai/shared";
+import type { AgentSession, SynapsePipelineResult } from "./types.js";
+export interface ProcessOptions {
+    sessionId?: string;
+    /** Pre-resolved session for async-backed project-search callers. */
+    session?: AgentSession | null;
+    /** Project boundary used to restrict working-memory candidates. */
+    projectId?: string;
+    /** Disable both buffer reads and writes for valid unscoped sessions. */
+    allowBufferInjection?: boolean;
+    now?: number;
+}
+export declare class SynapseManager {
+    private readonly config;
+    constructor(config: SynapseRuntimeConfig);
+    isEnabled(): boolean;
+    /**
+     * Run the full post-retrieval pipeline. A session is resolved lazily from
+     * the in-memory SessionRegistry when `sessionId` is provided; otherwise
+     * scoring signals that depend on the session degrade gracefully to 0
+     * and the buffer is bypassed entirely.
+     */
+    process(results: SearchResult[], query: string, options?: ProcessOptions): SynapsePipelineResult;
+}
+//# sourceMappingURL=synapse-manager.d.ts.map

package/dist/services/synapse/synapse-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synapse-manager.d.ts","sourceRoot":"","sources":["../../../src/services/synapse/synapse-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAY3E,OAAO,KAAK,EACV,YAAY,EAEZ,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAaD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,oBAAoB;IAEzD,SAAS,IAAI,OAAO;IAIpB;;;;;OAKG;IACH,OAAO,CACL,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,cAAmB,GAC3B,qBAAqB;CA0IzB"}

package/dist/services/synapse/synapse-manager.js

@@ -0,0 +1,167 @@
+/**
+ * SynapseManager — orchestrates the post-retrieval pipeline.
+ *
+ * Composes scoring + inhibition + metacognition over a single result set
+ * plus an optional working-memory buffer keyed by session.
+ *
+ * Order matters:
+ *   0) buffer merge        — fold prior hot results into the fresh ones (opt-in via session)
+ *   1) attention score     — re-rank top-N by multi-signal score (opt-in)
+ *   2) chain inhibition    — boost/suppress by memory type for matched intent
+ *   3) diversity penalty   — re-rank, deduplicate near-clones
+ *   4) temporal inhibition — penalize fresh-but-irrelevant
+ *   5) confidence gate     — drop everything below adaptive threshold
+ *   6) score spectrum      — annotate the survivors with metacognition flags
+ *   7) buffer put          — record final survivors for the next query in the session
+ */
+import { applyDiversityPenalty, applyTemporalInhibition, applyConfidenceGate, applyChainInhibition, prefilterByRawScore, DEFAULT_CHAIN_BOOSTS, } from "./inhibition/index.js";
+import { applyAttentionScore } from "./scoring/index.js";
+import { analyzeSpectrum } from "./metacognition/index.js";
+import { getSessionRegistry } from "./session/index.js";
+/** Merge two result lists by id, keeping the highest score per id. */
+function mergeById(a, b) {
+    const map = new Map();
+    for (const r of a)
+        map.set(r.id, r);
+    for (const r of b) {
+        const existing = map.get(r.id);
+        if (!existing || r.score > existing.score)
+            map.set(r.id, r);
+    }
+    return [...map.values()].sort((x, y) => y.score - x.score);
+}
+export class SynapseManager {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Run the full post-retrieval pipeline. A session is resolved lazily from
+     * the in-memory SessionRegistry when `sessionId` is provided; otherwise
+     * scoring signals that depend on the session degrade gracefully to 0
+     * and the buffer is bypassed entirely.
+     */
+    process(results, query, options = {}) {
+        const now = options.now ?? Date.now();
+        const applied = [];
+        if (!this.config.enabled) {
+            return {
+                results,
+                flags: {
+                    lowConfidence: false,
+                    noStrongMatch: false,
+                    definitiveMatch: false,
+                    spread: 0,
+                    mean: 0,
+                    confidence: 0,
+                },
+                queryClass: "broad",
+                appliedFilters: applied,
+                intent: "general",
+            };
+        }
+        let stream = results;
+        let intent = "general";
+        const session = options.session !== undefined
+            ? options.session
+            : options.sessionId
+                ? getSessionRegistry().get(options.sessionId, now)
+                : null;
+        // 0) Buffer merge — pull warm hits from the session and fold them into the
+        // fresh stream. Hits already carry hitBoost via the buffer.
+        const buffer = this.config.buffer?.enabled && options.allowBufferInjection !== false
+            ? session?.buffer
+            : undefined;
+        if (buffer) {
+            const hot = buffer.get(query, now);
+            const scopedHotResults = options.projectId
+                ? hot.results.filter((result) => {
+                    const metadata = result.metadata;
+                    return metadata?.projectId === options.projectId;
+                })
+                : hot.results;
+            if (scopedHotResults.length > 0) {
+                stream = mergeById(stream, scopedHotResults);
+                applied.push("buffer-hit");
+            }
+        }
+        // 0.5) Pre-filter by raw vector score (IMP-16). Skips the expensive
+        // attention/chain/diversity work for results that would be cut by the
+        // final gate anyway. Only acts on results with a raw cosine attached;
+        // results without raw scores continue through the pipeline untouched.
+        const gateCfg = this.config.inhibition.confidenceGate;
+        if (gateCfg.enabled) {
+            const pre = prefilterByRawScore(stream, query, gateCfg);
+            if (pre.cut > 0) {
+                stream = pre.results;
+                applied.push("pre-gate");
+            }
+        }
+        const attention = this.config.scoring?.attention;
+        if (attention?.enabled) {
+            const out = applyAttentionScore(stream, {
+                enabled: true,
+                weights: attention.weights,
+                rerankWindow: attention.rerankWindow,
+                recencyHalfLifeMs: attention.recencyHalfLifeMs,
+                semanticScale: attention.semanticScale,
+            }, session, now);
+            stream = out.results;
+            applied.push("attention");
+        }
+        const chainCfg = this.config.inhibition.chainInhibition;
+        if (chainCfg?.enabled) {
+            const out = applyChainInhibition(stream, query, {
+                enabled: true,
+                boosts: chainCfg.boosts ?? DEFAULT_CHAIN_BOOSTS,
+            });
+            stream = out.results;
+            intent = out.intent;
+            applied.push("chain");
+        }
+        const diversity = this.config.inhibition.diversityPenalty;
+        if (diversity.enabled) {
+            stream = applyDiversityPenalty(stream, diversity);
+            applied.push("diversity");
+        }
+        const temporal = this.config.inhibition.temporalInhibition;
+        if (temporal.enabled) {
+            stream = applyTemporalInhibition(stream, query, temporal, now);
+            applied.push("temporal");
+        }
+        const gate = applyConfidenceGate(stream, query, this.config.inhibition.confidenceGate);
+        if (this.config.inhibition.confidenceGate.enabled)
+            applied.push("confidence-gate");
+        const flags = analyzeSpectrum(gate.results.map((r) => r.score), gate.threshold, this.config.metacognition);
+        if (this.config.metacognition.enabled)
+            applied.push("spectrum");
+        // 7) Persist final survivors back into the buffer so the next query in
+        // this session can see them. The buffer stores the *raw* (pre-pipeline)
+        // score per id when available (via metadata._rrfRawVectorScore or the
+        // original `results` input score) to prevent score drift on subsequent
+        // hits (IMP-8).
+        if (buffer && gate.results.length > 0) {
+            const rawScores = new Map();
+            // Prefer the original input score (pre-modulation) over the post-
+            // pipeline one — `results` is the parameter, untouched by us.
+            for (const r of results) {
+                const meta = r.metadata;
+                const raw = meta?._rrfRawVectorScore;
+                rawScores.set(r.id, typeof raw === "number" ? raw : r.score);
+            }
+            buffer.put(gate.results, query, now, rawScores);
+            applied.push("buffer-put");
+        }
+        return {
+            results: gate.results,
+            flags,
+            queryClass: gate.queryClass,
+            appliedFilters: applied,
+            intent,
+        };
+    }
+}
+//# sourceMappingURL=synapse-manager.js.map

package/dist/services/synapse/synapse-manager.js.map

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

package/dist/services/synapse/task-envelope.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Task Envelope Service — Wave 5 FR-14 / FR-25 / AD-W5-019.
+ *
+ * Collapses 5 Synapse moves into a single `begin` call:
+ *   1. create session
+ *   2. prime buffer (if entries provided)
+ *   3. search (the first search of the task)
+ *   4. prefetch first hit (if search returned results)
+ *   5. record access (for the first hit)
+ *
+ * Partial-failure contract (AD-W5-019 / FR-25):
+ *   - The session is ALWAYS returned (created in step 1; survives all later
+ *     failures). The caller can retry or end via synapse_task_end.
+ *   - `partial: true` + `errors: string[]` when any sub-step fails.
+ *   - `search` may be `null` when the search sub-step (step 3) failed.
+ *   - Each sub-step is independent — a failure in step 4 does not prevent
+ *     step 5 (though step 5 is skipped if step 3 produced no results).
+ *
+ * The service delegates to the existing Synapse session registry + search
+ * controller. It does NOT re-implement search or session logic — it
+ * orchestrates the existing primitives in sequence.
+ */
+import { SearchController } from "../../controllers/search-controller.js";
+/**
+ * Input for `synapse_task_begin`.
+ */
+export interface TaskBeginInput {
+    /** Stable identifier of the calling agent. */
+    agentId: string;
+    /** One-sentence description of the current task. */
+    taskContext?: string;
+    /** Project ID this session is scoped to. */
+    workspaceId?: string;
+    /** The search query for the first search. */
+    query: string;
+    /** Project ID for the search. */
+    projectId: string;
+    /** Optional entries to prime the buffer with (from recall). */
+    entries?: Array<{
+        id: string;
+        content: string;
+        score?: number;
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Max results for the first search (default 10). */
+    limit?: number;
+}
+/**
+ * Result of `synapse_task_begin`. Per AD-W5-019, the session is always
+ * returned; `partial` + `errors` indicate sub-step failures; `search` may
+ * be null when the search sub-step failed.
+ */
+export interface TaskBeginResult {
+    /** The created session ID (always present). */
+    sessionId: string;
+    /** The search result (null when the search sub-step failed). */
+    search: unknown | null;
+    /** Number of entries primed into the buffer (0 if step 2 failed/skipped). */
+    primed: number;
+    /** True when any sub-step failed. */
+    partial: boolean;
+    /** List of failed sub-step names (e.g. ["search", "prefetch"]). */
+    errors: string[];
+}
+/**
+ * Result of `synapse_task_end` (FR-15). Returns a summary + deletes the
+ * session. A follow-up GET on the session ID returns 404 after this.
+ */
+export interface TaskEndResult {
+    /** The session ID that was ended. */
+    sessionId: string;
+    /** Session duration in milliseconds (createdAt → end). */
+    durationMs: number;
+    /** Number of unique files/memories accessed during the session. */
+    accessCount: number;
+    /** Top accessed files (memoryId), sorted by access count descending. */
+    topFiles: string[];
+}
+/**
+ * Task Envelope Service — orchestrates the 5-move begin sequence.
+ */
+export declare class TaskEnvelopeService {
+    private searchController;
+    constructor(searchController?: SearchController);
+    /**
+     * Begin a task: create session → prime → search → prefetch first hit →
+     * record access. Each step is independent; failures set partial=true.
+     * The session is always returned.
+     */
+    begin(input: TaskBeginInput): Promise<TaskBeginResult>;
+    /**
+     * End a task: compute summary (accessCount, topFiles), DELETE the session,
+     * and return the summary. A follow-up GET on the session ID returns 404.
+     *
+     * FR-15 / AC-12: returns { sessionId, durationMs, accessCount, topFiles }.
+     */
+    end(sessionId: string): TaskEndResult | null;
+}
+//# sourceMappingURL=task-envelope.d.ts.map

package/dist/services/synapse/task-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-envelope.d.ts","sourceRoot":"","sources":["../../../src/services/synapse/task-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;IACH,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,gBAAgB,CAAC,EAAE,gBAAgB;IAI/C;;;;OAIG;IACG,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA8H5D;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;CA2B7C"}

package/dist/services/synapse/task-envelope.js

@@ -0,0 +1,192 @@
+/**
+ * Task Envelope Service — Wave 5 FR-14 / FR-25 / AD-W5-019.
+ *
+ * Collapses 5 Synapse moves into a single `begin` call:
+ *   1. create session
+ *   2. prime buffer (if entries provided)
+ *   3. search (the first search of the task)
+ *   4. prefetch first hit (if search returned results)
+ *   5. record access (for the first hit)
+ *
+ * Partial-failure contract (AD-W5-019 / FR-25):
+ *   - The session is ALWAYS returned (created in step 1; survives all later
+ *     failures). The caller can retry or end via synapse_task_end.
+ *   - `partial: true` + `errors: string[]` when any sub-step fails.
+ *   - `search` may be `null` when the search sub-step (step 3) failed.
+ *   - Each sub-step is independent — a failure in step 4 does not prevent
+ *     step 5 (though step 5 is skipped if step 3 produced no results).
+ *
+ * The service delegates to the existing Synapse session registry + search
+ * controller. It does NOT re-implement search or session logic — it
+ * orchestrates the existing primitives in sequence.
+ */
+import { logger } from "@massa-ai/shared";
+import { getSessionRegistry } from "../synapse/session/index.js";
+import { DEFAULT_BUFFER_CONFIG } from "../synapse/buffer/index.js";
+import { SearchController } from "../../controllers/search-controller.js";
+import { SearchSource as SearchSourceEnum } from "@massa-ai/shared";
+/**
+ * Task Envelope Service — orchestrates the 5-move begin sequence.
+ */
+export class TaskEnvelopeService {
+    searchController;
+    constructor(searchController) {
+        this.searchController = searchController ?? SearchController.getInstance();
+    }
+    /**
+     * Begin a task: create session → prime → search → prefetch first hit →
+     * record access. Each step is independent; failures set partial=true.
+     * The session is always returned.
+     */
+    async begin(input) {
+        const errors = [];
+        let primed = 0;
+        let search = null;
+        // Step 1: create session. This is the anchor — it must succeed for the
+        // envelope to return a sessionId. If it fails, we cannot continue.
+        const registry = getSessionRegistry();
+        let sessionId;
+        try {
+            sessionId = `syn_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+            registry.create({
+                sessionId,
+                agentId: input.agentId,
+                workspaceId: input.workspaceId,
+                taskContext: input.taskContext,
+                bufferConfig: DEFAULT_BUFFER_CONFIG,
+            });
+        }
+        catch (err) {
+            // Session creation failure is fatal — no sessionId to return.
+            throw new Error(`synapse_task_begin: session creation failed — ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Step 2: prime buffer (if entries provided). Failure is partial.
+        if (input.entries && input.entries.length > 0) {
+            try {
+                const session = registry.get(sessionId);
+                if (session?.buffer) {
+                    const results = input.entries.map((e) => ({
+                        id: e.id,
+                        content: e.content,
+                        score: e.score ?? 0.7,
+                        source: SearchSourceEnum.VECTOR,
+                        metadata: (e.metadata ?? {}),
+                    }));
+                    session.buffer.prime(results);
+                    primed = results.length;
+                }
+            }
+            catch (err) {
+                errors.push("prime");
+                logger.warn("synapse_task_begin: prime sub-step failed", {
+                    sessionId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        // Step 3: search. Failure is partial; search stays null.
+        let firstHitId = null;
+        let firstHitFile = null;
+        try {
+            const result = await this.searchController.searchProject({
+                query: input.query,
+                projectId: input.projectId,
+                maxResults: input.limit ?? 10,
+                sessionId,
+            });
+            search = result;
+            // Extract the first hit for prefetch + access (step 4 + 5).
+            if (result.results && result.results.length > 0) {
+                const first = result.results[0];
+                firstHitId = first.id;
+                firstHitFile = first.filePath ?? null;
+            }
+        }
+        catch (err) {
+            errors.push("search");
+            logger.warn("synapse_task_begin: search sub-step failed", {
+                sessionId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        // Step 4: prefetch first hit (if search produced a result with a file).
+        if (firstHitFile) {
+            try {
+                const session = registry.get(sessionId);
+                if (session?.buffer) {
+                    // Prefetch is best-effort — we prime with the first hit's metadata
+                    // so the buffer has the most relevant context for the task.
+                    // The full prefetch plan requires memory search; here we use the
+                    // search result itself as the prefetch entry (simplified envelope).
+                    if (firstHitId) {
+                        session.buffer.prime([
+                            {
+                                id: firstHitId,
+                                content: "", // content already in the search result
+                                score: 0.8,
+                                source: SearchSourceEnum.VECTOR,
+                                metadata: { filePath: firstHitFile, prefetched: true },
+                            },
+                        ]);
+                    }
+                }
+            }
+            catch (err) {
+                errors.push("prefetch");
+                logger.warn("synapse_task_begin: prefetch sub-step failed", {
+                    sessionId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        // Step 5: record access (for the first hit). Best-effort.
+        if (firstHitId) {
+            try {
+                registry.recordAccess(sessionId, firstHitId);
+            }
+            catch (err) {
+                errors.push("access");
+                logger.warn("synapse_task_begin: access sub-step failed", {
+                    sessionId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return {
+            sessionId,
+            search,
+            primed,
+            partial: errors.length > 0,
+            errors,
+        };
+    }
+    /**
+     * End a task: compute summary (accessCount, topFiles), DELETE the session,
+     * and return the summary. A follow-up GET on the session ID returns 404.
+     *
+     * FR-15 / AC-12: returns { sessionId, durationMs, accessCount, topFiles }.
+     */
+    end(sessionId) {
+        const registry = getSessionRegistry();
+        const session = registry.get(sessionId);
+        if (!session) {
+            return null;
+        }
+        const durationMs = Date.now() - session.createdAt;
+        // Compute accessCount (unique files/memories accessed).
+        const accessCount = session.accessHistory.size;
+        // Compute topFiles: sort access history by count descending, take top 10.
+        const entries = Array.from(session.accessHistory.entries());
+        entries.sort((a, b) => b[1] - a[1]);
+        const topFiles = entries.slice(0, 10).map(([id]) => id);
+        // Delete the session.
+        registry.delete(sessionId);
+        return {
+            sessionId,
+            durationMs,
+            accessCount,
+            topFiles,
+        };
+    }
+}
+//# sourceMappingURL=task-envelope.js.map

package/dist/services/synapse/task-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-envelope.js","sourceRoot":"","sources":["../../../src/services/synapse/task-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA4DpE;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACtB,gBAAgB,CAAmB;IAE3C,YAAY,gBAAmC;QAC7C,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,IAAI,gBAAgB,CAAC,WAAW,EAAE,CAAC;IAC7E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,KAAqB;QAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAM,GAAmB,IAAI,CAAC;QAElC,uEAAuE;QACvE,mEAAmE;QACnE,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;QACtC,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,SAAS,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACxF,QAAQ,CAAC,MAAM,CAAC;gBACd,SAAS;gBACT,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,YAAY,EAAE,qBAAqB;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,8DAA8D;YAC9D,MAAM,IAAI,KAAK,CACb,iDAAiD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpG,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACxC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;oBACpB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACxC,EAAE,EAAE,CAAC,CAAC,EAAE;wBACR,OAAO,EAAE,CAAC,CAAC,OAAO;wBAClB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG;wBACrB,MAAM,EAAE,gBAAgB,CAAC,MAAsB;wBAC/C,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAQ;qBACpC,CAAC,CAAC,CAAC;oBACJ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAC9B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBAC1B,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE;oBACvD,SAAS;oBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,yDAAyD;QACzD,IAAI,UAAU,GAAkB,IAAI,CAAC;QACrC,IAAI,YAAY,GAAkB,IAAI,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC;gBACvD,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;gBAC7B,SAAS;aACV,CAAC,CAAC;YACH,MAAM,GAAG,MAAM,CAAC;YAChB,4DAA4D;YAC5D,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAChC,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC;gBACtB,YAAY,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;YACxC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,4CAA4C,EAAE;gBACxD,SAAS;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;QAED,wEAAwE;QACxE,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACxC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;oBACpB,mEAAmE;oBACnE,4DAA4D;oBAC5D,iEAAiE;oBACjE,oEAAoE;oBACpE,IAAI,UAAU,EAAE,CAAC;wBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;4BACnB;gCACE,EAAE,EAAE,UAAU;gCACd,OAAO,EAAE,EAAE,EAAE,uCAAuC;gCACpD,KAAK,EAAE,GAAG;gCACV,MAAM,EAAE,gBAAgB,CAAC,MAAsB;gCAC/C,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAS;6BAC9D;yBACF,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE;oBAC1D,SAAS;oBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,0DAA0D;QAC1D,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,4CAA4C,EAAE;oBACxD,SAAS;oBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,SAAS;YACT,MAAM;YACN,MAAM;YACN,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;YAC1B,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAiB;QACnB,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;QAElD,wDAAwD;QACxD,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;QAE/C,0EAA0E;QAC1E,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAExD,sBAAsB;QACtB,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE3B,OAAO;YACL,SAAS;YACT,UAAU;YACV,WAAW;YACX,QAAQ;SACT,CAAC;IACJ,CAAC;CACF"}