@massa-ai/core 1.2.1

package/dist/data/managed-runs/managed-run-contract.js

@@ -0,0 +1,41 @@
+/**
+ * Managed Run Contract — Wave 5 FR-08 / FR-09 / FR-20 / FR-26 / AD-W5-013 /
+ * AD-W5-014 / AD-W5-020.
+ *
+ * Public TypeScript contract for the {@link ManagedRunRepository}. B2/B3
+ * (and any downstream consumer) imports these interfaces verbatim — no
+ * re-implementation. Interface drift fails the batch per FR-26 / AC-28.
+ *
+ * The repository unifies an indexing lease (CAS acquire/heartbeat/release)
+ * with idempotent event_id dedup + FileCursor resume (FR-09 / FR-10). It
+ * mirrors the proven graph_generations lease pattern (Wave 3 MLTS-011) but
+ * is decoupled from the immutable snapshot row (AD-W5-004): an indexing run
+ * is a process-writer concept with a different lifecycle than a generation
+ * snapshot.
+ *
+ * Reaper contract (AD-W5-013): every {@link ManagedRunRepository.begin} call
+ * first issues
+ *   UPDATE managed_runs SET status='aborted'
+ *   WHERE project_id=? AND run_kind=? AND status='active'
+ *     AND lease_expires_at <= clock_timestamp()
+ * inside the same transaction as the subsequent INSERT, BEFORE attempting to
+ * acquire. Stale-but-active rows (orphaned by SIGKILL) are flipped to
+ * 'aborted' so the partial UNIQUE index `managed_runs_one_active_per_project_kind`
+ * (active rows only) stays satisfiable for the new row. Tested by AC-22.
+ *
+ * Race contract (AC-22): the INSERT uses `ON CONFLICT (project_id, run_kind)
+ * WHERE status='active' DO NOTHING` so a concurrent winner is observed as a
+ * clean no-op (0 rows returned) rather than a unique-violation
+ * statement-abort — Prisma's pg adapter cannot ROLLBACK TO SAVEPOINT
+ * transparently, so ON CONFLICT DO NOTHING keeps the transaction clean. The
+ * loser then SELECTs the winner's row to surface `busy` with the winner's
+ * runId. No 500, no `could not serialize access`.
+ *
+ * getActive pin (AD-W5-014): {@link ManagedRunRepository.getActive} filters
+ * by `status='active' AND lease_expires_at > clock_timestamp()
+ * ORDER BY lease_expires_at DESC LIMIT 1` exactly. A stale-but-active row
+ * must NOT be returned as "the active run" — the caller would see a live run
+ * that has already expired. Tested by AC-22.
+ */
+export {};
+//# sourceMappingURL=managed-run-contract.js.map

package/dist/data/managed-runs/managed-run-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-run-contract.js","sourceRoot":"","sources":["../../../src/data/managed-runs/managed-run-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG"}

package/dist/data/managed-runs/managed-run-repository-pg.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Managed Run Repository — PostgreSQL CAS implementation.
+ *
+ * Wave 5 FR-08 / FR-09 / FR-10 / FR-20 / AD-W5-004 / AD-W5-013 / AD-W5-014.
+ *
+ * Mirrors the proven graph_generations lease pattern (Wave 3 MLTS-011 /
+ * `graph-generation-repository-pg.ts`) but for the standalone
+ * `managed_runs` table. The lease is a process-writer concept (indexing run),
+ * decoupled from the immutable graph_generation snapshot (AD-W5-004).
+ *
+ * Reaper (AD-W5-013): every begin() first UPDATEs expired active rows to
+ * 'aborted' inside the same transaction as the INSERT. This is load-bearing
+ * for the partial UNIQUE index `managed_runs_one_active_per_project_kind`
+ * (project_id, run_kind WHERE status='active'): without the reaper, a stale-
+ * but-active row orphaned by SIGKILL would block a new acquire forever. The
+ * reaper clears that row first, then the INSERT wins the partial unique race.
+ * PostgreSQL rejects `clock_timestamp()` in index predicates (not IMMUTABLE)
+ * so the partial unique is `status='active'` only — the time check is applied
+ * at query time in `getActive()` (AD-W5-014).
+ *
+ * getActive pin (AD-W5-014): `WHERE status='active' AND lease_expires_at >
+ * clock_timestamp() ORDER BY lease_expires_at DESC LIMIT 1` exactly. A stale-
+ * but-active row is NOT returned; the caller observes "no live run" and the
+ * next begin() reaper cleans it up.
+ *
+ * Race contract (AC-22): two concurrent begin() calls — exactly one returns
+ * `acquired`, the other returns `busy` with the winner's runId. The
+ * INSERT uses `ON CONFLICT (project_id, run_kind) WHERE status='active' DO
+ * NOTHING` so the loser is a clean no-op (0 rows returned) rather than a
+ * unique-violation statement-abort — Prisma's pg adapter cannot ROLLBACK TO
+ * SAVEPOINT transparently, so ON CONFLICT DO NOTHING keeps the transaction
+ * clean. The loser then SELECTs the winner's row to surface `busy`. No 500,
+ * no `could not serialize access`.
+ */
+import type { AbortManagedRunOutcome, ActiveManagedRun, BeginManagedRunInput, BeginManagedRunOutcome, CompleteManagedRunOutcome, FileCursor, HeartbeatManagedRunOutcome, ManagedRunKind, ManagedRunLease, ManagedRunRepository } from "./managed-run-contract.js";
+export declare class ManagedRunRepositoryPg implements ManagedRunRepository {
+    private static instance;
+    static getInstance(): ManagedRunRepositoryPg;
+    /** @internal test seam for injecting a mock client. */
+    static _resetForTesting(): void;
+    begin(rawInput: BeginManagedRunInput): Promise<BeginManagedRunOutcome>;
+    heartbeat(lease: ManagedRunLease, leaseTtlMs?: number): Promise<HeartbeatManagedRunOutcome>;
+    complete(lease: ManagedRunLease, fileCursor?: FileCursor): Promise<CompleteManagedRunOutcome>;
+    updateFileCursor(lease: ManagedRunLease, fileCursor: FileCursor): Promise<HeartbeatManagedRunOutcome>;
+    abort(lease: ManagedRunLease): Promise<AbortManagedRunOutcome>;
+    getActive(projectId: string, runKind: ManagedRunKind): Promise<ActiveManagedRun | null>;
+}
+//# sourceMappingURL=managed-run-repository-pg.d.ts.map

package/dist/data/managed-runs/managed-run-repository-pg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-run-repository-pg.d.ts","sourceRoot":"","sources":["../../../src/data/managed-runs/managed-run-repository-pg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,UAAU,EACV,0BAA0B,EAC1B,cAAc,EACd,eAAe,EACf,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAwFnC,qBAAa,sBAAuB,YAAW,oBAAoB;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAE9D,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAI5C,uDAAuD;IACvD,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAEzB,KAAK,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoGtE,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAmB3F,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA0C7F,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAuBrG,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmB9D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAe9F"}

package/dist/data/managed-runs/managed-run-repository-pg.js

@@ -0,0 +1,316 @@
+/**
+ * Managed Run Repository — PostgreSQL CAS implementation.
+ *
+ * Wave 5 FR-08 / FR-09 / FR-10 / FR-20 / AD-W5-004 / AD-W5-013 / AD-W5-014.
+ *
+ * Mirrors the proven graph_generations lease pattern (Wave 3 MLTS-011 /
+ * `graph-generation-repository-pg.ts`) but for the standalone
+ * `managed_runs` table. The lease is a process-writer concept (indexing run),
+ * decoupled from the immutable graph_generation snapshot (AD-W5-004).
+ *
+ * Reaper (AD-W5-013): every begin() first UPDATEs expired active rows to
+ * 'aborted' inside the same transaction as the INSERT. This is load-bearing
+ * for the partial UNIQUE index `managed_runs_one_active_per_project_kind`
+ * (project_id, run_kind WHERE status='active'): without the reaper, a stale-
+ * but-active row orphaned by SIGKILL would block a new acquire forever. The
+ * reaper clears that row first, then the INSERT wins the partial unique race.
+ * PostgreSQL rejects `clock_timestamp()` in index predicates (not IMMUTABLE)
+ * so the partial unique is `status='active'` only — the time check is applied
+ * at query time in `getActive()` (AD-W5-014).
+ *
+ * getActive pin (AD-W5-014): `WHERE status='active' AND lease_expires_at >
+ * clock_timestamp() ORDER BY lease_expires_at DESC LIMIT 1` exactly. A stale-
+ * but-active row is NOT returned; the caller observes "no live run" and the
+ * next begin() reaper cleans it up.
+ *
+ * Race contract (AC-22): two concurrent begin() calls — exactly one returns
+ * `acquired`, the other returns `busy` with the winner's runId. The
+ * INSERT uses `ON CONFLICT (project_id, run_kind) WHERE status='active' DO
+ * NOTHING` so the loser is a clean no-op (0 rows returned) rather than a
+ * unique-violation statement-abort — Prisma's pg adapter cannot ROLLBACK TO
+ * SAVEPOINT transparently, so ON CONFLICT DO NOTHING keeps the transaction
+ * clean. The loser then SELECTs the winner's row to surface `busy`. No 500,
+ * no `could not serialize access`.
+ */
+import { randomUUID } from "node:crypto";
+import { getPrismaClient } from "../../services/query/prisma-client.js";
+const DEFAULT_LEASE_TTL_MS = 90_000; // FR-09: 90s expiry.
+const MIN_LEASE_TTL_MS = 1_000; // 1s floor — anything shorter is a misconfig.
+const MAX_LEASE_TTL_MS = 300_000; // 5min ceiling (matches graph-generation).
+const HEARTBEAT_TTL_MS = 90_000; // Each heartbeat renewal window.
+const MAX_PROJECT_ID = 512;
+const MAX_EVENT_ID = 2_000;
+const MAX_CONTENT_HASH = 2_000;
+const MAX_LEASE_TOKEN = 512;
+function boundedText(value, label, max) {
+    const normalized = value.normalize("NFC").trim();
+    if (!normalized || normalized.length > max || normalized.includes("\0")) {
+        throw new TypeError(`${label} must contain -${max} safe characters`);
+    }
+    return normalized;
+}
+function validateTtl(ttlMs) {
+    const ttl = ttlMs ?? DEFAULT_LEASE_TTL_MS;
+    if (!Number.isInteger(ttl) || ttl < MIN_LEASE_TTL_MS || ttl > MAX_LEASE_TTL_MS) {
+        throw new RangeError(`leaseTtlMs must be ${MIN_LEASE_TTL_MS}-${MAX_LEASE_TTL_MS}`);
+    }
+    return ttl;
+}
+function validateBegin(input) {
+    const projectId = boundedText(input.projectId, "projectId", MAX_PROJECT_ID);
+    const eventId = boundedText(input.eventId, "eventId", MAX_EVENT_ID);
+    const contentHash = input.contentHash !== undefined
+        ? boundedText(input.contentHash, "contentHash", MAX_CONTENT_HASH)
+        : null;
+    const leaseTtlMs = validateTtl(input.leaseTtlMs);
+    return { projectId, runKind: input.runKind, eventId, contentHash, leaseTtlMs };
+}
+function toLease(row, leaseToken) {
+    return {
+        runId: row.id.toString(),
+        projectId: row.project_id,
+        runKind: row.run_kind,
+        leaseToken,
+        leaseExpiresAt: row.lease_expires_at.getTime(),
+        eventId: row.event_id,
+        ...(row.content_hash !== null && { contentHash: row.content_hash }),
+    };
+}
+function toActive(row) {
+    return {
+        runId: row.id.toString(),
+        projectId: row.project_id,
+        runKind: row.run_kind,
+        eventId: row.event_id,
+        contentHash: row.content_hash,
+        fileCursor: row.file_cursor,
+        leaseToken: row.lease_token,
+        leaseExpiresAt: row.lease_expires_at.getTime(),
+        heartbeatAt: row.heartbeat_at?.getTime() ?? null,
+        createdAt: Number(row.created_at),
+    };
+}
+export class ManagedRunRepositoryPg {
+    static instance = null;
+    static getInstance() {
+        return this.instance ??= new ManagedRunRepositoryPg();
+    }
+    /** @internal test seam for injecting a mock client. */
+    static _resetForTesting() { this.instance = null; }
+    async begin(rawInput) {
+        const input = validateBegin(rawInput);
+        const leaseToken = randomUUID();
+        return getPrismaClient().$transaction(async (tx) => {
+            // ── Reaper (AD-W5-013): flip expired active rows for this (project, kind) to 'aborted'.
+            // Best-effort: if zero rows match, this is a no-op. Runs inside the same
+            // transaction as the INSERT so the partial UNIQUE on active rows is
+            // satisfiable for the new row.
+            await tx.$executeRaw `
+        UPDATE managed_runs
+        SET status = 'aborted', completed_at = ${Date.now()}
+        WHERE project_id = ${input.projectId}
+          AND run_kind = ${input.runKind}
+          AND status = 'active'
+          AND lease_expires_at IS NOT NULL
+          AND lease_expires_at <= clock_timestamp()
+      `;
+            // ── Look for an existing live active row (AD-W5-014 pin). If one exists
+            // and is still live, surface `busy` without attempting the INSERT. This
+            // is the fast path: a loser that ran after the winner's INSERT commits
+            // observes the live row and returns `busy` without touching the
+            // partial unique.
+            const live = await tx.$queryRaw `
+        SELECT id, project_id, run_kind, event_id, content_hash, file_cursor,
+               status, lease_token, lease_expires_at, heartbeat_at,
+               created_at, completed_at
+        FROM managed_runs
+        WHERE project_id = ${input.projectId}
+          AND run_kind = ${input.runKind}
+          AND status = 'active'
+          AND lease_expires_at > clock_timestamp()
+        ORDER BY lease_expires_at DESC
+        LIMIT 1
+      `;
+            if (live[0]) {
+                return {
+                    status: "busy",
+                    activeRunId: live[0].id.toString(),
+                    leaseExpiresAt: live[0].lease_expires_at.getTime(),
+                };
+            }
+            // ── Acquire: INSERT with ON CONFLICT DO NOTHING on the partial unique
+            // (project_id, run_kind) WHERE status='active'. This is the race-decider:
+            // if a concurrent begin() won between our reaper and our INSERT, this
+            // INSERT is a no-op (0 rows returned) and we fall through to SELECT the
+            // winner. ON CONFLICT avoids the unique-violation statement-abort that
+            // would otherwise poison the transaction (Prisma cannot ROLLBACK TO
+            // SAVEPOINT transparently across the adapter). AC-22: no 500, no
+            // `could not serialize access`.
+            const created_at = Date.now();
+            const inserted = await tx.$queryRaw `
+        INSERT INTO managed_runs (
+          project_id, run_kind, event_id, content_hash, file_cursor,
+          status, lease_token, lease_expires_at, heartbeat_at,
+          created_at, completed_at
+        ) VALUES (
+          ${input.projectId}, ${input.runKind}, ${input.eventId}, ${input.contentHash}, NULL,
+          'active', ${leaseToken},
+          clock_timestamp() + (${input.leaseTtlMs} * interval '1 millisecond'),
+          clock_timestamp(), ${created_at}, NULL
+        )
+        ON CONFLICT (project_id, run_kind) WHERE status = 'active' DO NOTHING
+        RETURNING id, project_id, run_kind, event_id, content_hash, file_cursor,
+                  status, lease_token, lease_expires_at, heartbeat_at,
+                  created_at, completed_at
+      `;
+            if (inserted[0]) {
+                return { status: "acquired", lease: toLease(inserted[0], leaseToken) };
+            }
+            // ── Lost the race: the winner's row is now active. SELECT it without
+            // touching the partial unique. The transaction is clean (ON CONFLICT
+            // DO NOTHING did not abort), so this SELECT succeeds.
+            const winner = await tx.$queryRaw `
+        SELECT id, project_id, run_kind, event_id, content_hash, file_cursor,
+               status, lease_token, lease_expires_at, heartbeat_at,
+               created_at, completed_at
+        FROM managed_runs
+        WHERE project_id = ${input.projectId}
+          AND run_kind = ${input.runKind}
+          AND status = 'active'
+        ORDER BY lease_expires_at DESC
+        LIMIT 1
+      `;
+            if (!winner[0]) {
+                // No active row + our INSERT returned 0 rows: the partial unique must
+                // have blocked us, but we can't find the blocker. This is a logic
+                // error — fail loud rather than silently returning busy with no id.
+                throw new Error(`managed_runs_begin_no_winner:${input.projectId}:${input.runKind}`);
+            }
+            return {
+                status: "busy",
+                activeRunId: winner[0].id.toString(),
+                leaseExpiresAt: winner[0].lease_expires_at.getTime(),
+            };
+        });
+    }
+    async heartbeat(lease, leaseTtlMs) {
+        const ttl = validateTtl(leaseTtlMs ?? HEARTBEAT_TTL_MS);
+        const leaseToken = boundedText(lease.leaseToken, "leaseToken", MAX_LEASE_TOKEN);
+        const renewed = await getPrismaClient().$queryRaw `
+      UPDATE managed_runs
+      SET lease_expires_at = clock_timestamp() + (${ttl} * interval '1 millisecond'),
+          heartbeat_at = clock_timestamp()
+      WHERE id = ${BigInt(lease.runId)}
+        AND project_id = ${lease.projectId}
+        AND run_kind = ${lease.runKind}
+        AND lease_token = ${leaseToken}
+        AND status = 'active'
+        AND lease_expires_at > clock_timestamp()
+      RETURNING lease_expires_at
+    `;
+        if (!renewed[0])
+            return { status: "lease_lost" };
+        return { status: "renewed", leaseExpiresAt: renewed[0].lease_expires_at.getTime() };
+    }
+    async complete(lease, fileCursor) {
+        const leaseToken = boundedText(lease.leaseToken, "leaseToken", MAX_LEASE_TOKEN);
+        // When fileCursor is undefined (caller has no new cursor to persist),
+        // preserve the existing cursor (the load stage already wrote it via
+        // updateFileCursor). When fileCursor is explicitly null, erase it.
+        // When fileCursor is a FileCursor, overwrite with the new value.
+        if (fileCursor === undefined) {
+            const updated = await getPrismaClient().$queryRaw `
+        UPDATE managed_runs
+        SET status = 'completed',
+            completed_at = ${Date.now()},
+            lease_token = NULL,
+            lease_expires_at = NULL
+        WHERE id = ${BigInt(lease.runId)}
+          AND project_id = ${lease.projectId}
+          AND run_kind = ${lease.runKind}
+          AND lease_token = ${leaseToken}
+          AND status = 'active'
+        RETURNING id
+      `;
+            if (!updated[0])
+                return { status: "lease_lost" };
+            return { status: "completed", runId: updated[0].id.toString() };
+        }
+        const cursorJson = fileCursor;
+        const updated = await getPrismaClient().$queryRaw `
+      UPDATE managed_runs
+      SET status = 'completed',
+          completed_at = ${Date.now()},
+          lease_token = NULL,
+          lease_expires_at = NULL,
+          file_cursor = ${cursorJson}::jsonb
+      WHERE id = ${BigInt(lease.runId)}
+        AND project_id = ${lease.projectId}
+        AND run_kind = ${lease.runKind}
+        AND lease_token = ${leaseToken}
+        AND status = 'active'
+      RETURNING id
+    `;
+        if (!updated[0])
+            return { status: "lease_lost" };
+        return { status: "completed", runId: updated[0].id.toString() };
+    }
+    async updateFileCursor(lease, fileCursor) {
+        const leaseToken = boundedText(lease.leaseToken, "leaseToken", MAX_LEASE_TOKEN);
+        // Heartbeat-renew-and-write-cursor in a single UPDATE: keeps the lease
+        // warm and persists the cursor atomically. WHERE status='active' AND
+        // lease_expires_at > clock_timestamp() so a lost/reaped lease returns
+        // lease_lost (the pipeline's heartbeat loop will abort separately).
+        const renewed = await getPrismaClient().$queryRaw `
+      UPDATE managed_runs
+      SET lease_expires_at = clock_timestamp() + (${HEARTBEAT_TTL_MS} * interval '1 millisecond'),
+          heartbeat_at = clock_timestamp(),
+          file_cursor = ${fileCursor}::jsonb
+      WHERE id = ${BigInt(lease.runId)}
+        AND project_id = ${lease.projectId}
+        AND run_kind = ${lease.runKind}
+        AND lease_token = ${leaseToken}
+        AND status = 'active'
+        AND lease_expires_at > clock_timestamp()
+      RETURNING lease_expires_at
+    `;
+        if (!renewed[0])
+            return { status: "lease_lost" };
+        return { status: "renewed", leaseExpiresAt: renewed[0].lease_expires_at.getTime() };
+    }
+    async abort(lease) {
+        const leaseToken = boundedText(lease.leaseToken, "leaseToken", MAX_LEASE_TOKEN);
+        const updated = await getPrismaClient().$queryRaw `
+      UPDATE managed_runs
+      SET status = 'aborted',
+          completed_at = ${Date.now()},
+          lease_token = NULL,
+          lease_expires_at = NULL
+      WHERE id = ${BigInt(lease.runId)}
+        AND project_id = ${lease.projectId}
+        AND run_kind = ${lease.runKind}
+        AND lease_token = ${leaseToken}
+        AND status = 'active'
+      RETURNING id
+    `;
+        if (!updated[0])
+            return { status: "lease_lost" };
+        return { status: "aborted", runId: updated[0].id.toString() };
+    }
+    async getActive(projectId, runKind) {
+        const rows = await getPrismaClient().$queryRaw `
+      SELECT id, project_id, run_kind, event_id, content_hash, file_cursor,
+             status, lease_token, lease_expires_at, heartbeat_at,
+             created_at, completed_at
+      FROM managed_runs
+      WHERE project_id = ${projectId}
+        AND run_kind = ${runKind}
+        AND status = 'active'
+        AND lease_expires_at > clock_timestamp()
+      ORDER BY lease_expires_at DESC
+      LIMIT 1
+    `;
+        return rows[0] ? toActive(rows[0]) : null;
+    }
+}
+//# sourceMappingURL=managed-run-repository-pg.js.map

package/dist/data/managed-runs/managed-run-repository-pg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-run-repository-pg.js","sourceRoot":"","sources":["../../../src/data/managed-runs/managed-run-repository-pg.ts"],"names":[],"mappings":"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"}

package/dist/data/memory/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @massa-ai/core - Memory Data Layer
+ */
+export { MemoryRepositoryPg } from "./memory-repository-pg.js";
+export type { MemoryRow, InsertMemoryInput, SearchFilters, UpdateMemoryPatch, } from "./memory-repository-contract.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/data/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/memory/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,iBAAiB,GAClB,MAAM,iCAAiC,CAAC"}

package/dist/data/memory/index.js

@@ -0,0 +1,5 @@
+/**
+ * @massa-ai/core - Memory Data Layer
+ */
+export { MemoryRepositoryPg } from "./memory-repository-pg.js";
+//# sourceMappingURL=index.js.map

package/dist/data/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/data/memory/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/data/memory/memory-repository-contract.d.ts

@@ -0,0 +1,54 @@
+import type { MemoryLevel, MemoryType } from "@massa-ai/shared";
+export interface MemoryRow {
+    id: string;
+    content: string;
+    type: string;
+    level: number;
+    user_id: string | null;
+    session_id: string | null;
+    project_id: string | null;
+    agent_id: string | null;
+    importance: number;
+    tags: string;
+    embedding: Buffer | null;
+    metadata: string | null;
+    created_at: number;
+    updated_at: number;
+    access_count: number;
+    last_accessed: number | null;
+    pinned: number;
+    deleted_at: number | null;
+}
+export interface InsertMemoryInput {
+    id: string;
+    content: string;
+    type: MemoryType;
+    level: MemoryLevel;
+    userId?: string;
+    sessionId?: string;
+    projectId?: string;
+    agentId?: string;
+    importance: number;
+    tags: string[];
+    embedding: number[];
+    metadata?: Record<string, unknown>;
+    pinned?: boolean;
+}
+export interface SearchFilters {
+    userId?: string;
+    sessionId?: string;
+    projectId?: string;
+    agentId?: string;
+    types?: MemoryType[];
+    minImportance: number;
+    includePersistent: boolean;
+    limit: number;
+}
+export interface UpdateMemoryPatch {
+    content?: string;
+    importance?: number;
+    tags?: string[];
+    embedding?: number[];
+    pinned?: boolean;
+}
+//# sourceMappingURL=memory-repository-contract.d.ts.map

package/dist/data/memory/memory-repository-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-repository-contract.d.ts","sourceRoot":"","sources":["../../../src/data/memory/memory-repository-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IACzD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACtG,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpF,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3F,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AACD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1E,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC/G;AACD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1E,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CACxF;AACD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAChG"}

package/dist/data/memory/memory-repository-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-repository-contract.js.map

package/dist/data/memory/memory-repository-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-repository-contract.js","sourceRoot":"","sources":["../../../src/data/memory/memory-repository-contract.ts"],"names":[],"mappings":""}

package/dist/data/memory/memory-repository-factory.d.ts

@@ -0,0 +1,4 @@
+import { MemoryRepositoryPg } from "./memory-repository-pg.js";
+/** Backend-neutral entry point. PostgreSQL is mandatory. */
+export declare function getMemoryRepository(): MemoryRepositoryPg;
+//# sourceMappingURL=memory-repository-factory.d.ts.map

package/dist/data/memory/memory-repository-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-repository-factory.d.ts","sourceRoot":"","sources":["../../../src/data/memory/memory-repository-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,4DAA4D;AAC5D,wBAAgB,mBAAmB,IAAI,kBAAkB,CAGxD"}

package/dist/data/memory/memory-repository-factory.js

@@ -0,0 +1,8 @@
+import { requirePostgresDatabaseUrl } from "@massa-ai/shared/config";
+import { MemoryRepositoryPg } from "./memory-repository-pg.js";
+/** Backend-neutral entry point. PostgreSQL is mandatory. */
+export function getMemoryRepository() {
+    requirePostgresDatabaseUrl();
+    return MemoryRepositoryPg.getInstance();
+}
+//# sourceMappingURL=memory-repository-factory.js.map

package/dist/data/memory/memory-repository-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-repository-factory.js","sourceRoot":"","sources":["../../../src/data/memory/memory-repository-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB;IACjC,0BAA0B,EAAE,CAAC;IAC7B,OAAO,kBAAkB,CAAC,WAAW,EAAE,CAAC;AAC1C,CAAC"}

package/dist/data/memory/memory-repository-pg.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Memory Repository - PostgreSQL Implementation (raw SQL)
+ *
+ * All queries use $executeRaw / $queryRaw to avoid the Prisma 7.7.0 +
+ * @prisma/adapter-pg + Bun incompatibility (isObjectEnumValue bug).
+ *
+ * ORM filter methods (findMany, updateMany, create, etc.) crash at runtime
+ * with: "(0, Ao.isObjectEnumValue) is not a function".
+ * Raw-SQL paths work correctly — both in the API server and in bun:test.
+ */
+import { MemoryType } from "@massa-ai/shared";
+import type { InsertMemoryInput, MemoryRow, SearchFilters, UpdateMemoryPatch } from "./memory-repository-contract.js";
+export declare class MemoryRepositoryPg {
+    private static instance;
+    private prisma;
+    private constructor();
+    static getInstance(): MemoryRepositoryPg;
+    /** Convert a raw DB row to the MemoryRow interface used by the rest of the app. */
+    private toMemoryRow;
+    /**
+     * Insert a new memory using raw SQL ($executeRaw).
+     * Bypasses Prisma ORM to avoid the isObjectEnumValue Bun incompatibility.
+     */
+    insert(input: InsertMemoryInput): Promise<void>;
+    /**
+     * Get a single memory by ID.
+     */
+    getById(id: string): Promise<MemoryRow | null>;
+    /**
+     * Search memories with filters (used by MemoryConsolidationJob, etc.)
+     */
+    search(filters: SearchFilters): Promise<MemoryRow[]>;
+    /**
+     * Full-text search: word-level ILIKE OR matching, with scope filters.
+     * Mirrors the PostgreSQL FTS5 behaviour: each whitespace-separated token is
+     * searched independently; results are returned if ANY token matches.
+     */
+    fullTextSearch(query: string, limit: number, filters?: {
+        userId?: string;
+        sessionId?: string;
+        projectId?: string;
+        agentId?: string;
+        minImportance?: number;
+        types?: MemoryType[];
+    }): Promise<MemoryRow[]>;
+    /**
+     * Update importance score.
+     */
+    updateImportance(id: string, importance: number): Promise<void>;
+    /**
+     * Increment access count and set last_accessed timestamp.
+     */
+    incrementAccessCount(id: string): Promise<void>;
+    /**
+     * Delete a memory by ID.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Delete a memory by ID. Returns true if a row was deleted.
+     * Uses RETURNING so an absent id reports false (idempotent).
+     */
+    deleteById(id: string): Promise<boolean>;
+    /**
+     * Partially update a memory. Only provided fields are changed.
+     * PostgreSQL uses ILIKE (no external FTS table), so no FTS reindex needed.
+     * Returns true if a row was updated.
+     */
+    update(id: string, patch: UpdateMemoryPatch): Promise<boolean>;
+    /**
+     * Soft-delete a single memory by id (Phase 1). Sets `deleted_at`; the row
+     * is hidden from recall by the `deleted_at IS NULL` filters. Returns true
+     * only if a previously-live row was tombstoned. Idempotent.
+     */
+    softDeleteById(id: string): Promise<boolean>;
+    /**
+     * Delete all memories for a project. Returns the count deleted.
+     */
+    deleteByProject(projectId: string): Promise<number>;
+    /**
+     * List memories with pagination.
+     */
+    list(limit: number, offset: number): Promise<MemoryRow[]>;
+    /**
+     * Find recent memories that contain a given tag, scoped to session/project,
+     * within a time window. Used by CoRetrievalHook to find co-session memories.
+     */
+    findRecentByTag(tag: string, opts: {
+        sessionId?: string;
+        projectId?: string;
+        excludeId?: string;
+        sinceMs: number;
+        limit: number;
+    }): Promise<Array<{
+        id: string;
+    }>>;
+    /**
+     * Find recent memories that have an embedding, for cosine-similarity
+     * comparisons in RelationExtractor. Scoped to a project when provided.
+     */
+    findRecentWithEmbeddings(excludeId: string, projectId: string | null, limit: number): Promise<MemoryRow[]>;
+    /**
+     * List live, non-pinned memories with embeddings older than `staleSinceMs`
+     * for the consolidation job (Phase 1). Bounded by `limit`.
+     */
+    listConsolidationCandidates(staleSinceMs: number, limit?: number): Promise<MemoryRow[]>;
+    /**
+     * No-op — connection is managed by the singleton PrismaClient.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=memory-repository-pg.d.ts.map