@massa-ai/core 1.2.1

package/dist/services/graph/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Graph module internal types.
+ *
+ * Shared between GraphStore, GraphQueries, RelationExtractor,
+ * and exposed through MemoryGraphService.
+ */
+import { MemoryEdge, MemoryRelationType } from "@massa-ai/shared";
+/**
+ * A row from the memories table (projection without embedding).
+ */
+export interface MemoryRow {
+    id: string;
+    content: string;
+    type: string;
+    level: number;
+    importance: number;
+    tags: string | null;
+    created_at: number;
+    updated_at: number;
+    access_count: number;
+    user_id: string | null;
+    session_id: string | null;
+    project_id: string | null;
+    agent_id: string | null;
+}
+/**
+ * A row from the memories table that also includes the embedding blob.
+ * Used by RelationExtractor for similarity computation.
+ */
+export interface MemoryRowWithEmbedding extends MemoryRow {
+    embedding: Buffer | null;
+}
+/**
+ * A memory node returned from graph traversal,
+ * including the edge that connects it and its BFS depth.
+ */
+export interface RelatedMemory {
+    memory: MemoryRow;
+    edge: MemoryEdge;
+    depth: number;
+}
+/**
+ * Input shape for creating an edge.
+ *
+ * Canonical form: a single object. Both the PostgreSQL (`GraphStore`) and
+ * PostgreSQL (`GraphStorePg`) implementations accept this shape so callers
+ * are backend-agnostic. `createEdge` is always async because the PG store
+ * requires a Prisma round-trip.
+ */
+export interface EdgeCreateInput {
+    sourceId: string;
+    targetId: string;
+    relationType: MemoryRelationType;
+    weight?: number;
+    evidence?: string;
+    autoExtracted?: boolean;
+}
+/**
+ * Edge filter used by query methods.
+ */
+export interface EdgeFilter {
+    sourceId?: string;
+    targetId?: string;
+    relationTypes?: MemoryRelationType[];
+    minWeight?: number;
+    autoExtractedOnly?: boolean;
+    limit?: number;
+}
+/**
+ * Canonical graph-store contract.
+ *
+ * All methods are async so the contract is backend-agnostic: PostgreSQL
+ * implementations wrap their sync logic in `async`/`Promise.resolve`, while
+ * the PostgreSQL implementation is natively async. This eliminates the
+ * signature divergence (sync positional vs async object) that silently broke
+ * callers when `DATABASE_URL` pointed at PostgreSQL.
+ *
+ * Both `GraphStore` (PostgreSQL) and `GraphStorePg` implement this interface, and
+ * `getGraphStore()` returns an `IGraphStore` so consumers never depend on a
+ * concrete backend.
+ */
+export interface IGraphStore {
+    /** Create (or upsert-weight) an edge. Returns the edge, or null on
+     *  self-reference / failure. */
+    createEdge(edge: EdgeCreateInput): Promise<MemoryEdge | null>;
+    /** Get a specific edge by source, target, and relation type. */
+    getEdge(sourceId: string, targetId: string, relationType: MemoryRelationType): Promise<MemoryEdge | null>;
+    /** All edges connected to a memory (both directions). */
+    getAllEdges(memoryId: string, filter?: EdgeFilter): Promise<MemoryEdge[]>;
+    /** Delete an edge by ID. Returns true if an edge was removed. */
+    deleteEdge(edgeId: string): Promise<boolean>;
+    /** Delete all edges connected to a memory. Returns the count removed. */
+    deleteEdgesForMemory(memoryId: string): Promise<number>;
+    /** Update edge weight (set). Returns true if an edge was updated. */
+    updateWeight(edgeId: string, weight: number): Promise<boolean>;
+    /**
+     * Atomically increment edge weight by delta, capped at maxWeight.
+     * Returns true if an edge was updated.
+     */
+    incrementEdgeWeight(sourceId: string, targetId: string, relationType: MemoryRelationType, delta: number, maxWeight?: number): Promise<boolean>;
+    /**
+     * BFS over outgoing edges from `seedIds`, returning the set of memory ids
+     * reachable within `depth` hops (excluding the seeds). Depth ≥ 1.
+     */
+    bfsNeighbors(seedIds: string[], depth: number): Promise<string[]>;
+    /** Degree centrality for a memory. */
+    getDegree(memoryId: string): Promise<{
+        in: number;
+        out: number;
+        total: number;
+    }>;
+    /** Most-connected memories (hub nodes). */
+    getHubMemories(limit?: number): Promise<{
+        memoryId: string;
+        degree: number;
+    }[]>;
+    /** Graph-level statistics. */
+    getStats(): Promise<{
+        totalEdges: number;
+        byRelation: Record<string, number>;
+        autoExtracted: number;
+        avgWeight: number;
+    }>;
+    /** Clear all edges (primarily for tests). */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/graph/types.d.ts.map

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

package/dist/services/graph/types.js

@@ -0,0 +1,8 @@
+/**
+ * Graph module internal types.
+ *
+ * Shared between GraphStore, GraphQueries, RelationExtractor,
+ * and exposed through MemoryGraphService.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/graph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/graph/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/services/handoff/handoff-auto-injector.d.ts

@@ -0,0 +1,32 @@
+/**
+ * HandoffAutoInjector — Phase 6 auto-inject seam (R3).
+ *
+ * Subscribes to the Phase-3 `observation:ingested` event. When a
+ * `session-start` observation lands, it queries the HandoffService for
+ * pending (`open`) handoffs for that project/target agent and records
+ * (via logger.info) how many were found. This is observability + a
+ * future auto-surface hook; the deterministic surfacing primitive is
+ * `HandoffService.listPending` (invoked directly or via the
+ * `handoff_list_pending` MCP tool).
+ *
+ * Design call: consume `observation:ingested` (already typed, already
+ * fired by the Phase-3 SessionStart hook, already consumed by the
+ * ObservationConsolidationJob). Reusing it keeps a single integration
+ * bus (cross-cutting §3) and avoids coupling the memory recall path to
+ * the handoff table.
+ *
+ * Graceful degradation: when the Phase-3 hook is not installed, the
+ * event never fires and `listPending` still works as the recall-path
+ * check. The injector never blocks the session-start path and never
+ * throws.
+ */
+import type { HandoffService } from "./handoff-service.js";
+export declare class HandoffAutoInjector {
+    private unsubscribe;
+    private readonly service;
+    constructor(service: HandoffService);
+    /** Subscribe to observation:ingested. Returns an unsubscribe fn. */
+    start(): () => void;
+    stop(): void;
+}
+//# sourceMappingURL=handoff-auto-injector.d.ts.map

package/dist/services/handoff/handoff-auto-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-auto-injector.d.ts","sourceRoot":"","sources":["../../../src/services/handoff/handoff-auto-injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,OAAO,EAAE,cAAc;IAInC,oEAAoE;IACpE,KAAK,IAAI,MAAM,IAAI;IA+BnB,IAAI,IAAI,IAAI;CAMb"}

package/dist/services/handoff/handoff-auto-injector.js

@@ -0,0 +1,72 @@
+/**
+ * HandoffAutoInjector — Phase 6 auto-inject seam (R3).
+ *
+ * Subscribes to the Phase-3 `observation:ingested` event. When a
+ * `session-start` observation lands, it queries the HandoffService for
+ * pending (`open`) handoffs for that project/target agent and records
+ * (via logger.info) how many were found. This is observability + a
+ * future auto-surface hook; the deterministic surfacing primitive is
+ * `HandoffService.listPending` (invoked directly or via the
+ * `handoff_list_pending` MCP tool).
+ *
+ * Design call: consume `observation:ingested` (already typed, already
+ * fired by the Phase-3 SessionStart hook, already consumed by the
+ * ObservationConsolidationJob). Reusing it keeps a single integration
+ * bus (cross-cutting §3) and avoids coupling the memory recall path to
+ * the handoff table.
+ *
+ * Graceful degradation: when the Phase-3 hook is not installed, the
+ * event never fires and `listPending` still works as the recall-path
+ * check. The injector never blocks the session-start path and never
+ * throws.
+ */
+import { logger } from "@massa-ai/shared";
+import { eventBus } from "../events/event-bus.js";
+export class HandoffAutoInjector {
+    unsubscribe = null;
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    /** Subscribe to observation:ingested. Returns an unsubscribe fn. */
+    start() {
+        if (this.unsubscribe)
+            return this.unsubscribe;
+        this.unsubscribe = eventBus.subscribe("observation:ingested", (payload) => {
+            if (!payload || payload.source !== "session-start")
+                return;
+            void (async () => {
+                try {
+                    const projectId = payload.projectId;
+                    if (!projectId)
+                        return;
+                    // targetAgent is not in the observation payload directly; derive
+                    // best-effort from agentId if present. listPending with no
+                    // targetAgent returns all open handoffs for the project.
+                    const targetAgent = payload.agentId ?? undefined;
+                    const pending = await this.service.listPending(projectId, targetAgent);
+                    if (pending.length > 0) {
+                        logger.info("HandoffAutoInjector: pending handoffs found", {
+                            projectId,
+                            count: pending.length,
+                            ids: pending.map((h) => h.id),
+                        });
+                    }
+                }
+                catch (e) {
+                    logger.debug("HandoffAutoInjector: error handling session-start", {
+                        error: e.message,
+                    });
+                }
+            })();
+        });
+        return this.unsubscribe;
+    }
+    stop() {
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+    }
+}
+//# sourceMappingURL=handoff-auto-injector.js.map

package/dist/services/handoff/handoff-auto-injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-auto-injector.js","sourceRoot":"","sources":["../../../src/services/handoff/handoff-auto-injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,OAAO,mBAAmB;IACtB,WAAW,GAAwB,IAAI,CAAC;IAC/B,OAAO,CAAiB;IAEzC,YAAY,OAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,oEAAoE;IACpE,KAAK;QACH,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,sBAAsB,EAAE,CAAC,OAAO,EAAE,EAAE;YACxE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,eAAe;gBAAE,OAAO;YAC3D,KAAK,CAAC,KAAK,IAAI,EAAE;gBACf,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;oBACpC,IAAI,CAAC,SAAS;wBAAE,OAAO;oBACvB,iEAAiE;oBACjE,2DAA2D;oBAC3D,yDAAyD;oBACzD,MAAM,WAAW,GACd,OAAgC,CAAC,OAAO,IAAI,SAAS,CAAC;oBACzD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;oBACvE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACvB,MAAM,CAAC,IAAI,CAAC,6CAA6C,EAAE;4BACzD,SAAS;4BACT,KAAK,EAAE,OAAO,CAAC,MAAM;4BACrB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAC9B,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,CAAC,KAAK,CAAC,mDAAmD,EAAE;wBAChE,KAAK,EAAG,CAAW,CAAC,OAAO;qBAC5B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;CACF"}

package/dist/services/handoff/handoff-service.d.ts

@@ -0,0 +1,83 @@
+/**
+ * HandoffService — Phase 6 cross-session handoffs (G2).
+ *
+ * Lets an agent (session A) leave a structured handoff for a later agent
+ * (session B). The handoff is persisted in the Handoff table AND
+ * dual-written as a searchable `conversation` memory (FTS-discoverable
+ * independently of the Handoff table).
+ *
+ * Contract (spec.md R1–R7, NF1–NF5):
+ *  - State machine: open → accepted | expired (both terminal).
+ *  - accept/cancel only valid on an `open` row; everything else is a
+ *    clear `{ok:false, reason}` failure (never a silent no-op).
+ *  - Optional LLM summary-polish and memory dual-write are best-effort.
+ *    Canonical handoff-store failures propagate as sanitized typed errors.
+ *  - Backend-polymorphic via the HandoffStore factory (no
+ *    `isPostgresEnabled()` short-circuit).
+ *
+ * Test-isolation (mirrors Phase-4 BootstrapService): the ctor accepts
+ * injectable `store`, `memoryRepo`, `llm`, and `idFactory` seams.
+ * Defaults resolve lazily at run time so the closed-MemoryRepository
+ * landmine (memory-crud.test.ts) does not poison handoff tests.
+ */
+import { type HandoffRecord, type HandoffStore } from "../../data/handoff/handoff-repository.js";
+import type { InsertMemoryInput } from "../../data/memory/memory-repository.js";
+import type { LlmSurface } from "../memory/consolidator.js";
+export interface BeginHandoffInput {
+    projectId: string;
+    sourceSessionId?: string;
+    targetAgent?: string;
+    summary?: string;
+    openQuestions?: string[];
+    nextSteps?: string[];
+    files?: string[];
+}
+export interface BeginResult {
+    ok: boolean;
+    id?: string;
+    status?: "open";
+    memoryId?: string | null;
+    reason?: string;
+}
+export interface AcceptCancelResult {
+    ok: boolean;
+    handoff?: HandoffRecord;
+    reason?: string;
+}
+/**
+ * Injectable memory-repository seam. The default implementation resolves
+ * getMemoryRepository() lazily inside each method (test-isolation).
+ */
+export interface HandoffMemorySeam {
+    insert(input: InsertMemoryInput): void | Promise<void>;
+}
+export interface HandoffDeps {
+    store?: HandoffStore;
+    memoryRepo?: HandoffMemorySeam;
+    llm?: LlmSurface;
+    idFactory?: () => string;
+}
+export declare class HandoffService {
+    private readonly store;
+    private readonly memoryRepo;
+    private readonly llm;
+    private readonly idFactory;
+    constructor(deps?: HandoffDeps);
+    begin(input: BeginHandoffInput): Promise<BeginResult>;
+    private dualWrite;
+    accept(params: {
+        id: string;
+        projectId?: string;
+    }): Promise<AcceptCancelResult>;
+    cancel(params: {
+        id: string;
+        projectId?: string;
+    }): Promise<AcceptCancelResult>;
+    private terminate;
+    listPending(projectId: string, targetAgent?: string | null): Promise<HandoffRecord[]>;
+}
+export declare function buildHandoffMemoryInput(memId: string, record: HandoffRecord): InsertMemoryInput;
+export declare function formatMemoryContent(record: HandoffRecord): string;
+export declare function getHandoffService(): HandoffService;
+export declare function resetHandoffService(): void;
+//# sourceMappingURL=handoff-service.d.ts.map

package/dist/services/handoff/handoff-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-service.d.ts","sourceRoot":"","sources":["../../../src/services/handoff/handoff-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAGhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAI5D,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAeD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,GAAE,WAAgB;IAgB5B,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;YAiD7C,SAAS;IASjB,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAMzB,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAIjB,SAAS;IAuCjB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAG5F;AAID,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,GACpB,iBAAiB,CAmBnB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAYjE;AAkDD,wBAAgB,iBAAiB,IAAI,cAAc,CAGlD;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/services/handoff/handoff-service.js

@@ -0,0 +1,238 @@
+/**
+ * HandoffService — Phase 6 cross-session handoffs (G2).
+ *
+ * Lets an agent (session A) leave a structured handoff for a later agent
+ * (session B). The handoff is persisted in the Handoff table AND
+ * dual-written as a searchable `conversation` memory (FTS-discoverable
+ * independently of the Handoff table).
+ *
+ * Contract (spec.md R1–R7, NF1–NF5):
+ *  - State machine: open → accepted | expired (both terminal).
+ *  - accept/cancel only valid on an `open` row; everything else is a
+ *    clear `{ok:false, reason}` failure (never a silent no-op).
+ *  - Optional LLM summary-polish and memory dual-write are best-effort.
+ *    Canonical handoff-store failures propagate as sanitized typed errors.
+ *  - Backend-polymorphic via the HandoffStore factory (no
+ *    `isPostgresEnabled()` short-circuit).
+ *
+ * Test-isolation (mirrors Phase-4 BootstrapService): the ctor accepts
+ * injectable `store`, `memoryRepo`, `llm`, and `idFactory` seams.
+ * Defaults resolve lazily at run time so the closed-MemoryRepository
+ * landmine (memory-crud.test.ts) does not poison handoff tests.
+ */
+import { randomUUID } from "crypto";
+import { z } from "zod";
+import { MemoryLevel, MemoryType } from "@massa-ai/shared";
+import { getHandoffStore, newHandoffId, } from "../../data/handoff/handoff-repository.js";
+import { getMemoryRepository } from "../../data/memory/memory-repository-factory.js";
+import { eventBus } from "../events/event-bus.js";
+import { llm as defaultLlmSurface } from "../memory/llm-client.js";
+// ── Constants ───────────────────────────────────────────────────────────────
+const MAX_SUMMARY_CHARS = 1024;
+const HANDOFF_IMPORTANCE = 0.7;
+// ── LLM schema (R7 optional polish) ─────────────────────────────────────────
+const HandoffSummarySchema = z.object({
+    summary: z.string().min(1).max(MAX_SUMMARY_CHARS),
+});
+// ── Service ─────────────────────────────────────────────────────────────────
+export class HandoffService {
+    store;
+    memoryRepo;
+    llm;
+    idFactory;
+    constructor(deps = {}) {
+        this.store = deps.store ?? getHandoffStore();
+        this.llm = deps.llm ?? defaultLlmSurface;
+        this.idFactory = deps.idFactory ?? (() => newHandoffId());
+        // Lazy resolver so the memory repo is touched at run time (not ctor
+        // time) unless a test injects one. Mirrors bootstrap-service.ts.
+        const injectedRepo = deps.memoryRepo;
+        this.memoryRepo =
+            injectedRepo ??
+                {
+                    insert: (i) => getMemoryRepository().insert(i),
+                };
+    }
+    // ── begin (R1, R2, R5, R7) ────────────────────────────────────────────────
+    async begin(input) {
+        if (!input || !input.projectId || !String(input.projectId).trim()) {
+            return { ok: false, reason: "missing-project" };
+        }
+        let summary = truncate(input.summary ?? "", MAX_SUMMARY_CHARS);
+        // R7 optional LLM polish: only when LLM is enabled AND summary is empty.
+        // Best-effort; never blocks begin.
+        if (!summary) {
+            try {
+                if (this.llm.isEnabled()) {
+                    const polished = await polishSummary(this.llm, input);
+                    if (polished)
+                        summary = truncate(polished, MAX_SUMMARY_CHARS);
+                }
+            }
+            catch {
+                /* fall through with empty/auto summary */
+            }
+        }
+        const id = this.idFactory();
+        const now = Date.now();
+        const record = {
+            id,
+            projectId: input.projectId.trim(),
+            sourceSessionId: input.sourceSessionId ?? null,
+            targetAgent: input.targetAgent ?? null,
+            summary,
+            openQuestions: dedupStrings(input.openQuestions),
+            nextSteps: dedupStrings(input.nextSteps),
+            files: dedupStrings(input.files),
+            status: "open",
+            createdAt: now,
+            acceptedAt: null,
+        };
+        await this.store.insert(record);
+        // R5 dual-write: best-effort searchable memory.
+        let memoryId = null;
+        try {
+            memoryId = await this.dualWrite(record);
+        }
+        catch {
+            memoryId = null;
+        }
+        return { ok: true, id, status: "open", memoryId };
+    }
+    async dualWrite(record) {
+        const memId = `handoff-mem-${record.id}-${randomUUID().slice(0, 8)}`;
+        const input = buildHandoffMemoryInput(memId, record);
+        await Promise.resolve(this.memoryRepo.insert(input));
+        return memId;
+    }
+    // ── accept (R1, R2, R6) ───────────────────────────────────────────────────
+    async accept(params) {
+        return this.terminate(params, "accepted");
+    }
+    // ── cancel (R1, R2) ───────────────────────────────────────────────────────
+    async cancel(params) {
+        return this.terminate(params, "expired");
+    }
+    async terminate(params, target) {
+        if (!params || !params.id) {
+            return { ok: false, reason: "missing-id" };
+        }
+        const row = await this.store.getById(params.id);
+        if (!row)
+            return { ok: false, reason: "not-found" };
+        if (params.projectId && row.projectId !== params.projectId) {
+            return { ok: false, reason: "project-mismatch" };
+        }
+        if (row.status !== "open") {
+            return { ok: false, reason: "not-open" };
+        }
+        const acceptedAt = target === "accepted" ? Date.now() : undefined;
+        const updated = await this.store.setStatus(params.id, target, acceptedAt);
+        if (!updated)
+            return { ok: false, reason: "store-failed" };
+        if (updated.status !== target)
+            return { ok: false, reason: "not-open" };
+        // R6 emit (only on accept).
+        if (target === "accepted") {
+            eventBus.publish("handoff:accepted", {
+                handoffId: updated.id,
+                projectId: updated.projectId,
+                sourceSessionId: updated.sourceSessionId ?? undefined,
+                targetAgent: updated.targetAgent ?? undefined,
+                acceptedAt: updated.acceptedAt ?? Date.now(),
+            });
+        }
+        return { ok: true, handoff: updated };
+    }
+    // ── listPending (R3 surfacing) ────────────────────────────────────────────
+    async listPending(projectId, targetAgent) {
+        return this.store.listPending(projectId, targetAgent ?? undefined);
+    }
+}
+// ── Pure helpers ────────────────────────────────────────────────────────────
+export function buildHandoffMemoryInput(memId, record) {
+    const content = formatMemoryContent(record);
+    return {
+        id: memId,
+        content,
+        type: MemoryType.CONVERSATION,
+        level: MemoryLevel.PROJECT,
+        projectId: record.projectId,
+        importance: HANDOFF_IMPORTANCE,
+        tags: ["handoff", `handoff:${record.id}`, `handoff:${record.projectId}`],
+        embedding: [],
+        metadata: {
+            source: "handoff",
+            handoffId: record.id,
+            targetAgent: record.targetAgent,
+            sourceSessionId: record.sourceSessionId,
+        },
+        pinned: false,
+    };
+}
+export function formatMemoryContent(record) {
+    const parts = [`Handoff: ${record.summary || "(no summary)"}`];
+    if (record.openQuestions.length > 0) {
+        parts.push("Open questions: " + record.openQuestions.join("; "));
+    }
+    if (record.nextSteps.length > 0) {
+        parts.push("Next steps: " + record.nextSteps.join("; "));
+    }
+    if (record.files.length > 0) {
+        parts.push("Files: " + record.files.join(", "));
+    }
+    return truncate(parts.join("\n"), 2048);
+}
+async function polishSummary(surface, input) {
+    const prompt = buildPolishPrompt(input);
+    const res = await surface.object(prompt, HandoffSummarySchema);
+    if (!res.ok || !res.value || !res.value.summary)
+        return null;
+    return res.value.summary;
+}
+function buildPolishPrompt(input) {
+    const parts = [
+        "You are drafting a cross-session handoff summary for a software agent.",
+        "Synthesize a concise summary (max 1024 chars) from the open questions and",
+        "next steps below. Return JSON: { summary: string }.",
+    ];
+    if (input.openQuestions && input.openQuestions.length > 0) {
+        parts.push("Open questions:\n" + input.openQuestions.map((q) => "- " + q).join("\n"));
+    }
+    if (input.nextSteps && input.nextSteps.length > 0) {
+        parts.push("Next steps:\n" + input.nextSteps.map((s) => "- " + s).join("\n"));
+    }
+    return parts.join("\n");
+}
+function dedupStrings(arr) {
+    if (!arr || !Array.isArray(arr))
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const s of arr) {
+        const v = String(s).trim();
+        if (!v)
+            continue;
+        if (seen.has(v))
+            continue;
+        seen.add(v);
+        out.push(v);
+    }
+    return out;
+}
+function truncate(s, max) {
+    if (!s)
+        return s;
+    return s.length <= max ? s : s.slice(0, max - 1) + "…";
+}
+// ── Singleton ───────────────────────────────────────────────────────────────
+let cachedService = null;
+export function getHandoffService() {
+    if (!cachedService)
+        cachedService = new HandoffService();
+    return cachedService;
+}
+export function resetHandoffService() {
+    cachedService = null;
+}
+//# sourceMappingURL=handoff-service.js.map

package/dist/services/handoff/handoff-service.js.map

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

package/dist/services/health/local-health-checker.d.ts

@@ -0,0 +1,49 @@
+import { type SearchDiagnostic } from "../search/search-diagnostics.js";
+export interface ServiceStatus {
+    available: boolean;
+    latency?: number;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+export interface LocalHealthReport {
+    status: "healthy" | "degraded" | "unhealthy";
+    mode: "postgresql";
+    timestamp: string;
+    services: {
+        ollama: ServiceStatus;
+        dataDirectory: ServiceStatus;
+        vectorStore: ServiceStatus;
+        keywordSearch: ServiceStatus;
+        cache: ServiceStatus;
+        embeddingCache: ServiceStatus;
+    };
+    diagnostics: {
+        search: readonly SearchDiagnostic[];
+    };
+    summary: {
+        total: number;
+        healthy: number;
+        degraded: number;
+        failed: number;
+    };
+    recommendations: string[];
+}
+export interface OllamaModelInfo {
+    name: string;
+    size: number;
+    digest: string;
+    modified_at: string;
+}
+export declare class LocalHealthChecker {
+    private readonly ollamaBaseUrl;
+    private readonly dataDir;
+    checkAll(): Promise<LocalHealthReport>;
+    checkOllama(): Promise<ServiceStatus>;
+    checkDataDirectory(): Promise<ServiceStatus>;
+    checkPostgres(): Promise<ServiceStatus>;
+    isOllamaReady(): Promise<boolean>;
+    getOllamaModels(): Promise<string[]>;
+    private generateRecommendations;
+}
+export declare function getHealthChecker(): LocalHealthChecker;
+//# sourceMappingURL=local-health-checker.d.ts.map

package/dist/services/health/local-health-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-health-checker.d.ts","sourceRoot":"","sources":["../../../src/services/health/local-health-checker.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,aAAa;IAAG,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAAE;AAC3H,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IACpF,QAAQ,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,aAAa,EAAE,aAAa,CAAC;QAAC,WAAW,EAAE,aAAa,CAAC;QAAC,aAAa,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,aAAa,CAAC;QAAC,cAAc,EAAE,aAAa,CAAC;KAAE,CAAC;IAClL,WAAW,EAAE;QAAE,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;KAAE,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3G;AACD,MAAM,WAAW,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;CAAE;AAErG,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2D;IACzF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAErD,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAUtC,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAYrC,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC;IAS5C,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IAYvC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IACjC,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAC1C,OAAO,CAAC,uBAAuB;CAOhC;AAED,wBAAgB,gBAAgB,IAAI,kBAAkB,CAA+D"}