@jungjaehoon/mama-core 2.4.1 → 4.1.0

package/dist/connectors/event-index.js

@@ -1,245 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapConnectorEventIndexRecord = mapConnectorEventIndexRecord;
-exports.connectorEventIndexId = connectorEventIndexId;
-exports.connectorEventContentHash = connectorEventContentHash;
-exports.upsertConnectorEventIndex = upsertConnectorEventIndex;
-exports.getConnectorEventIndexRecord = getConnectorEventIndexRecord;
-exports.readConnectorCursor = readConnectorCursor;
-exports.deleteExpiredConnectorEvents = deleteExpiredConnectorEvents;
-const node_crypto_1 = require("node:crypto");
-const canonicalize_js_1 = require("../canonicalize.js");
-function nowIso() {
-    return new Date().toISOString();
-}
-function eventDateFromMs(ms) {
-    if (ms === null || !Number.isFinite(ms)) {
-        return null;
-    }
-    return new Date(ms).toISOString().slice(0, 10);
-}
-function normalizeTimestampMs(input) {
-    const timestamp = input.source_timestamp_ms ?? input.event_datetime;
-    if (typeof timestamp !== 'number' || !Number.isFinite(timestamp)) {
-        throw new Error('connector_event_index.source_timestamp_ms must be a finite number.');
-    }
-    return Math.floor(timestamp);
-}
-function normalizeEventDatetime(input) {
-    if (input.event_datetime === null || input.event_datetime === undefined) {
-        return normalizeTimestampMs(input);
-    }
-    if (!Number.isFinite(input.event_datetime)) {
-        throw new Error('connector_event_index.event_datetime must be a finite number when provided.');
-    }
-    return Math.floor(input.event_datetime);
-}
-function normalizeMetadataJson(input) {
-    if (input.metadata_json !== undefined) {
-        return input.metadata_json;
-    }
-    if (input.metadata === undefined || input.metadata === null) {
-        return null;
-    }
-    return (0, canonicalize_js_1.canonicalizeJSON)(input.metadata);
-}
-function toBuffer(value) {
-    if (Buffer.isBuffer(value)) {
-        return value;
-    }
-    if (value instanceof Uint8Array) {
-        return Buffer.from(value);
-    }
-    throw new Error('connector_event_index.content_hash must be a 32-byte Buffer.');
-}
-function mapConnectorEventIndexRow(row) {
-    return {
-        event_index_id: String(row.event_index_id),
-        source_connector: String(row.source_connector),
-        source_type: String(row.source_type),
-        source_id: String(row.source_id),
-        source_locator: row.source_locator === null ? null : String(row.source_locator),
-        channel: row.channel === null ? null : String(row.channel),
-        author: row.author === null ? null : String(row.author),
-        title: row.title === null ? null : String(row.title),
-        content: String(row.content),
-        event_datetime: typeof row.event_datetime === 'number' && Number.isFinite(row.event_datetime)
-            ? row.event_datetime
-            : null,
-        event_date: row.event_date === null ? null : String(row.event_date),
-        source_timestamp_ms: Number(row.source_timestamp_ms),
-        source_cursor: row.source_cursor === null ? null : String(row.source_cursor),
-        tenant_id: row.tenant_id === null ? null : String(row.tenant_id),
-        project_id: row.project_id === null ? null : String(row.project_id),
-        memory_scope_kind: row.memory_scope_kind === null ? null : String(row.memory_scope_kind),
-        memory_scope_id: row.memory_scope_id === null ? null : String(row.memory_scope_id),
-        metadata_json: row.metadata_json === null ? null : String(row.metadata_json),
-        artifact_locator: row.artifact_locator === null ? null : String(row.artifact_locator),
-        artifact_title: row.artifact_title === null ? null : String(row.artifact_title),
-        content_hash: toBuffer(row.content_hash),
-        operator_ingest_seq: Number(row.operator_ingest_seq),
-        operator_observation_seq: Number(row.operator_observation_seq),
-        indexed_at: String(row.indexed_at),
-        updated_at: String(row.updated_at),
-        expires_at: row.expires_at === null ? null : String(row.expires_at),
-    };
-}
-function mapConnectorEventIndexRecord(row) {
-    return mapConnectorEventIndexRow(row);
-}
-function mapConnectorCursorRow(row) {
-    return {
-        connector_name: String(row.connector_name),
-        last_seen_timestamp_ms: Number(row.last_seen_timestamp_ms),
-        last_seen_source_id: String(row.last_seen_source_id),
-        last_sweep_at: row.last_sweep_at === null ? null : String(row.last_sweep_at),
-        last_success_at: row.last_success_at === null ? null : String(row.last_success_at),
-        last_error: row.last_error === null ? null : String(row.last_error),
-        last_error_at: row.last_error_at === null ? null : String(row.last_error_at),
-        indexed_count: Number(row.indexed_count),
-    };
-}
-function connectorEventIndexId(sourceConnector, sourceId) {
-    const digest = (0, node_crypto_1.createHash)('sha1').update(`${sourceConnector}\0${sourceId}`, 'utf8').digest('hex');
-    return `evt_${digest.slice(0, 16)}`;
-}
-function connectorEventContentHash(input) {
-    return (0, node_crypto_1.createHash)('sha256')
-        .update((0, canonicalize_js_1.canonicalizeJSON)({
-        source_connector: input.source_connector,
-        source_id: input.source_id,
-        content: input.content,
-        event_datetime: input.event_datetime ?? null,
-    }), 'utf8')
-        .digest();
-}
-function upsertConnectorEventIndex(adapter, input) {
-    const sourceTimestampMs = normalizeTimestampMs(input);
-    const eventDatetime = normalizeEventDatetime(input);
-    const eventDate = input.event_date ?? eventDateFromMs(eventDatetime);
-    const timestamp = input.updated_at ?? nowIso();
-    const eventIndexId = connectorEventIndexId(input.source_connector, input.source_id);
-    const contentHash = input.content_hash
-        ? Buffer.from(input.content_hash)
-        : connectorEventContentHash({
-            source_connector: input.source_connector,
-            source_id: input.source_id,
-            content: input.content,
-            event_datetime: eventDatetime,
-        });
-    if (contentHash.byteLength !== 32) {
-        throw new Error('connector_event_index.content_hash must be exactly 32 bytes.');
-    }
-    const metadataJson = normalizeMetadataJson(input);
-    return adapter.transaction(() => {
-        adapter
-            .prepare(`
-          INSERT INTO connector_event_index (
-            event_index_id, source_connector, source_type, source_id, source_entity_id,
-            source_locator, channel, author, title, content, event_datetime, event_date,
-            source_timestamp_ms, source_cursor, tenant_id, project_id, memory_scope_kind,
-            memory_scope_id, metadata_json, artifact_locator, artifact_title, content_hash,
-            indexed_at, updated_at, expires_at
-          )
-          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-          ON CONFLICT(source_connector, source_id) DO UPDATE SET
-            source_type = excluded.source_type,
-            source_entity_id = excluded.source_entity_id,
-            source_locator = excluded.source_locator,
-            channel = excluded.channel,
-            author = excluded.author,
-            title = excluded.title,
-            content = excluded.content,
-            event_datetime = excluded.event_datetime,
-            event_date = excluded.event_date,
-            source_timestamp_ms = excluded.source_timestamp_ms,
-            source_cursor = excluded.source_cursor,
-            tenant_id = excluded.tenant_id,
-            project_id = excluded.project_id,
-            memory_scope_kind = excluded.memory_scope_kind,
-            memory_scope_id = excluded.memory_scope_id,
-            metadata_json = excluded.metadata_json,
-            artifact_locator = excluded.artifact_locator,
-            artifact_title = excluded.artifact_title,
-            content_hash = excluded.content_hash,
-            updated_at = excluded.updated_at,
-            expires_at = excluded.expires_at,
-            operator_ingest_seq = CASE
-              WHEN connector_event_index.content_hash IS NOT excluded.content_hash
-                OR connector_event_index.metadata_json IS NOT excluded.metadata_json
-                OR connector_event_index.source_timestamp_ms IS NOT excluded.source_timestamp_ms
-                OR connector_event_index.source_type IS NOT excluded.source_type
-                OR connector_event_index.channel IS NOT excluded.channel
-              THEN NULL
-              ELSE connector_event_index.operator_ingest_seq
-            END,
-            operator_observation_seq = CASE
-              WHEN connector_event_index.content_hash IS NOT excluded.content_hash
-                OR connector_event_index.metadata_json IS NOT excluded.metadata_json
-                OR connector_event_index.source_timestamp_ms IS NOT excluded.source_timestamp_ms
-                OR connector_event_index.source_type IS NOT excluded.source_type
-                OR connector_event_index.channel IS NOT excluded.channel
-              THEN NULL
-              ELSE connector_event_index.operator_observation_seq
-            END
-        `)
-            .run(eventIndexId, input.source_connector, input.source_type, input.source_id, input.source_entity_id ?? input.source_id, input.source_locator ?? null, input.channel ?? null, input.author ?? null, input.title ?? null, input.content, eventDatetime, eventDate, sourceTimestampMs, input.source_cursor ?? null, input.tenant_id ?? null, input.project_id ?? null, input.memory_scope_kind ?? null, input.memory_scope_id ?? null, metadataJson, input.artifact_locator ?? null, input.artifact_title ?? null, contentHash, input.indexed_at ?? timestamp, timestamp, input.expires_at ?? null);
-        const saved = getConnectorEventIndexRecord(adapter, input.source_connector, input.source_id);
-        if (!saved) {
-            throw new Error(`Failed to read connector_event_index row after upsert: ${input.source_connector}/${input.source_id}`);
-        }
-        return saved;
-    });
-}
-function getConnectorEventIndexRecord(adapter, sourceConnector, sourceId) {
-    const row = adapter
-        .prepare(`
-        SELECT *
-        FROM connector_event_index
-        WHERE source_connector = ?
-          AND source_id = ?
-        LIMIT 1
-      `)
-        .get(sourceConnector, sourceId);
-    return row ? mapConnectorEventIndexRow(row) : null;
-}
-function readConnectorCursor(adapter, connectorName) {
-    const row = adapter
-        .prepare(`
-        SELECT *
-        FROM connector_event_index_cursors
-        WHERE connector_name = ?
-        LIMIT 1
-      `)
-        .get(connectorName);
-    return row ? mapConnectorCursorRow(row) : null;
-}
-function deleteExpiredConnectorEvents(adapter, input) {
-    if (!Number.isFinite(input.nowMs)) {
-        throw new Error('deleteExpiredConnectorEvents.nowMs must be a finite number.');
-    }
-    if (!Number.isFinite(input.retentionMs) || input.retentionMs < 0) {
-        throw new Error('deleteExpiredConnectorEvents.retentionMs must be a non-negative finite number.');
-    }
-    const cutoffMs = input.nowMs - input.retentionMs;
-    const result = input.connectorName
-        ? adapter
-            .prepare(`
-            DELETE FROM connector_event_index
-            WHERE source_connector = ?
-              AND event_datetime IS NOT NULL
-              AND event_datetime < ?
-              AND artifact_locator IS NULL
-          `)
-            .run(input.connectorName, cutoffMs)
-        : adapter
-            .prepare(`
-            DELETE FROM connector_event_index
-            WHERE event_datetime IS NOT NULL
-              AND event_datetime < ?
-              AND artifact_locator IS NULL
-          `)
-            .run(cutoffMs);
-    return { rows_deleted: result.changes };
-}
-//# sourceMappingURL=event-index.js.map

package/dist/connectors/raw-query.d.ts

@@ -1,40 +0,0 @@
-import type { DatabaseAdapter } from '../db-manager.js';
-import type { RawSearchHit, RawDocument, RawSearchInput, RawSearchResult, RawSearchScopeFilter } from './types.js';
-type RawQueryAdapter = Pick<DatabaseAdapter, 'prepare'>;
-interface RawWindowInput {
-    connectors?: string[];
-    scopes?: RawSearchScopeFilter[];
-    before?: number;
-    after?: number;
-}
-export declare function searchRaw(adapter: RawQueryAdapter, input: RawSearchInput): RawSearchResult;
-export declare function searchAllRaw(adapter: RawQueryAdapter, input: RawSearchInput): RawSearchResult;
-export declare function getRawById(adapter: RawQueryAdapter, rawId: string, visibility: Pick<RawSearchInput, 'connectors' | 'scopes'>): RawDocument | null;
-export declare function getRawWindow(adapter: RawQueryAdapter, rawId: string, input: RawWindowInput): {
-    target: RawSearchHit;
-    items: RawSearchHit[];
-} | null;
-export interface RawHistoryInput {
-    /** The entity whose revisions to read. Provide this OR `rawId`. */
-    entityId?: string;
-    /**
-     * A raw event id (event_index_id) to anchor on: its entity is resolved under the SAME
-     * visibility, then that entity's revisions are returned. An anchor the caller may not see
-     * resolves to nothing, so a rawId cannot widen what the caller can read.
-     */
-    rawId?: string;
-    connectors?: string[];
-    scopes?: RawSearchScopeFilter[];
-    fromMs?: number;
-    toMs?: number;
-    limit?: number;
-    cursor?: string;
-}
-/**
- * Chronological change history of one upstream entity (rows sharing source_entity_id), bounded by
- * the SAME connector/scope visibility as search - a citation must not out-read reading. Oldest first,
- * cursor-paged. Rows with a NULL source_entity_id (no revision grouping) never match an entity query.
- */
-export declare function getRawHistory(adapter: RawQueryAdapter, input: RawHistoryInput): RawSearchResult;
-export type { RawSearchHit, RawSearchInput, RawSearchResult, RawSearchScopeFilter, } from './types.js';
-//# sourceMappingURL=raw-query.d.ts.map

package/dist/connectors/raw-query.js

@@ -1,412 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.searchRaw = searchRaw;
-exports.searchAllRaw = searchAllRaw;
-exports.getRawById = getRawById;
-exports.getRawWindow = getRawWindow;
-exports.getRawHistory = getRawHistory;
-const types_js_1 = require("../memory/types.js");
-const event_index_js_1 = require("./event-index.js");
-const DEFAULT_RAW_LIMIT = 25;
-const MAX_RAW_LIMIT = 100;
-const DEFAULT_WINDOW_SIZE = 5;
-const MAX_WINDOW_SIZE = 50;
-const VALID_SCOPE_KINDS = new Set(types_js_1.MEMORY_SCOPE_KINDS);
-function placeholders(values) {
-    if (values.length === 0) {
-        throw new Error('Cannot build SQL placeholders for an empty list.');
-    }
-    return values.map(() => '?').join(', ');
-}
-function normalizeLimit(value) {
-    if (value === undefined) {
-        return DEFAULT_RAW_LIMIT;
-    }
-    return Math.min(MAX_RAW_LIMIT, Math.max(0, Math.floor(value)));
-}
-function normalizeWindowSize(value) {
-    if (value === undefined) {
-        return DEFAULT_WINDOW_SIZE;
-    }
-    return Math.min(MAX_WINDOW_SIZE, Math.max(0, Math.floor(value)));
-}
-function escapeFtsQuery(query) {
-    return `"${query.replace(/"/g, '""')}"`;
-}
-function encodeCursor(row) {
-    return Buffer.from(JSON.stringify({
-        rank: row.rank,
-        timestampMs: row.source_timestamp_ms,
-        rawId: row.event_index_id,
-    }), 'utf8').toString('base64url');
-}
-function decodeCursor(cursor) {
-    if (!cursor) {
-        return null;
-    }
-    try {
-        const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
-        if (typeof parsed.rank !== 'number' ||
-            !Number.isFinite(parsed.rank) ||
-            typeof parsed.timestampMs !== 'number' ||
-            !Number.isFinite(parsed.timestampMs) ||
-            typeof parsed.rawId !== 'string' ||
-            parsed.rawId.length === 0) {
-            throw new Error('invalid shape');
-        }
-        return {
-            rank: parsed.rank,
-            timestampMs: parsed.timestampMs,
-            rawId: parsed.rawId,
-        };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        throw new Error(`Invalid raw search cursor: ${message}`);
-    }
-}
-function normalizeConnectors(connectors) {
-    return [...new Set((connectors ?? []).map((connector) => connector.trim()).filter(Boolean))];
-}
-function normalizeScopes(scopes) {
-    return (scopes ?? [])
-        .map((scope) => {
-        const kind = scope.kind.trim();
-        if (!VALID_SCOPE_KINDS.has(kind)) {
-            throw new Error(`Invalid raw search scope kind: ${kind}`);
-        }
-        return { kind: kind, id: scope.id.trim() };
-    })
-        .filter((scope) => scope.id.length > 0);
-}
-function appendFilters(clauses, params, input, alias = 'e') {
-    const connectors = normalizeConnectors(input.connectors);
-    if (connectors.length > 0) {
-        clauses.push(`${alias}.source_connector IN (${placeholders(connectors)})`);
-        params.push(...connectors);
-    }
-    const scopes = normalizeScopes(input.scopes);
-    if (scopes.length > 0) {
-        clauses.push(`(${scopes.map(() => `(${alias}.memory_scope_kind = ? AND ${alias}.memory_scope_id = ?)`).join(' OR ')})`);
-        for (const scope of scopes) {
-            params.push(scope.kind, scope.id);
-        }
-    }
-    if (input.fromMs !== undefined) {
-        clauses.push(`${alias}.source_timestamp_ms >= ?`);
-        params.push(input.fromMs);
-    }
-    if (input.toMs !== undefined) {
-        clauses.push(`${alias}.source_timestamp_ms <= ?`);
-        params.push(input.toMs);
-    }
-}
-function appendCursorFilter(clauses, params, cursor) {
-    if (!cursor) {
-        return;
-    }
-    clauses.push(`(rank > ? OR (rank = ? AND source_timestamp_ms < ?) OR ` +
-        `(rank = ? AND source_timestamp_ms = ? AND event_index_id > ?))`);
-    params.push(cursor.rank, cursor.rank, cursor.timestampMs, cursor.rank, cursor.timestampMs, cursor.rawId);
-}
-function parseMetadata(metadataJson) {
-    if (!metadataJson) {
-        return {};
-    }
-    try {
-        const parsed = JSON.parse(metadataJson);
-        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
-            ? parsed
-            : {};
-    }
-    catch {
-        return {};
-    }
-}
-function contentPreview(content) {
-    const compact = content.replace(/\s+/g, ' ').trim();
-    return compact.length > 240 ? `${compact.slice(0, 237)}...` : compact;
-}
-function scoreFromRank(rank) {
-    return Number.isFinite(rank) ? 1 / (1 + Math.exp(rank)) : 0;
-}
-function timestampToIso(timestampMs) {
-    if (timestampMs === null || !Number.isFinite(timestampMs)) {
-        return null;
-    }
-    return new Date(timestampMs).toISOString();
-}
-function toRawHit(row) {
-    const record = (0, event_index_js_1.mapConnectorEventIndexRecord)(row);
-    return {
-        raw_id: record.event_index_id,
-        connector: record.source_connector,
-        source_id: record.source_id,
-        channel_id: record.channel,
-        author_label: record.author,
-        created_at: timestampToIso(record.event_datetime ?? record.source_timestamp_ms),
-        content_preview: contentPreview(record.content),
-        score: scoreFromRank(Number(row.rank)),
-        source_ref: record.source_locator ?? record.artifact_locator,
-        metadata: parseMetadata(record.metadata_json),
-    };
-}
-function runSearch(adapter, input) {
-    const query = input.query.trim();
-    if (query.length === 0) {
-        return { hits: [], next_cursor: null };
-    }
-    const limit = normalizeLimit(input.limit);
-    if (limit === 0) {
-        return { hits: [], next_cursor: null };
-    }
-    const params = [escapeFtsQuery(query)];
-    const clauses = [];
-    appendFilters(clauses, params, input);
-    const cursor = decodeCursor(input.cursor);
-    const outerClauses = [];
-    const outerParams = [];
-    appendCursorFilter(outerClauses, outerParams, cursor);
-    const whereSql = clauses.length > 0 ? `AND ${clauses.join(' AND ')}` : '';
-    const cursorSql = outerClauses.length > 0 ? `WHERE ${outerClauses.join(' AND ')}` : '';
-    const rows = adapter
-        .prepare(`
-        WITH ranked AS (
-          SELECT e.*, bm25(connector_event_index_fts) AS rank
-          FROM connector_event_index_fts
-          JOIN connector_event_index e
-            ON e.event_index_id = connector_event_index_fts.event_index_id
-          WHERE connector_event_index_fts MATCH ?
-            ${whereSql}
-        )
-        SELECT *
-        FROM ranked
-        ${cursorSql}
-        ORDER BY rank ASC, source_timestamp_ms DESC, event_index_id ASC
-        LIMIT ?
-      `)
-        .all(...params, ...outerParams, limit + 1);
-    const pageRows = rows.slice(0, limit);
-    const nextRow = rows.length > limit ? pageRows[pageRows.length - 1] : undefined;
-    return {
-        hits: pageRows.map(toRawHit),
-        next_cursor: nextRow
-            ? encodeCursor({
-                rank: Number(nextRow.rank),
-                source_timestamp_ms: Number(nextRow.source_timestamp_ms),
-                event_index_id: String(nextRow.event_index_id),
-            })
-            : null,
-    };
-}
-function searchRaw(adapter, input) {
-    const connectors = normalizeConnectors(input.connectors);
-    if (connectors.length !== 1) {
-        throw new Error('searchRaw requires exactly one connector filter.');
-    }
-    return runSearch(adapter, { ...input, connectors });
-}
-function searchAllRaw(adapter, input) {
-    return runSearch(adapter, input);
-}
-function getRawById(adapter, rawId, visibility) {
-    const params = [rawId];
-    const clauses = ['e.event_index_id = ?'];
-    appendFilters(clauses, params, { query: '*', ...visibility });
-    const row = adapter
-        .prepare(`
-        SELECT e.*, 0 AS rank
-        FROM connector_event_index e
-        WHERE ${clauses.join(' AND ')}
-        LIMIT 1
-      `)
-        .get(...params);
-    return row ? { ...toRawHit(row), content: String(row.content) } : null;
-}
-function getRawWindow(adapter, rawId, input) {
-    const targetParams = [rawId];
-    const targetClauses = ['e.event_index_id = ?'];
-    appendFilters(targetClauses, targetParams, {
-        query: '*',
-        connectors: input.connectors,
-        scopes: input.scopes,
-    });
-    const targetRow = adapter
-        .prepare(`
-        SELECT e.*, 0 AS rank
-        FROM connector_event_index e
-        WHERE ${targetClauses.join(' AND ')}
-        LIMIT 1
-      `)
-        .get(...targetParams);
-    if (!targetRow) {
-        return null;
-    }
-    const target = (0, event_index_js_1.mapConnectorEventIndexRecord)(targetRow);
-    const before = normalizeWindowSize(input.before);
-    const after = normalizeWindowSize(input.after);
-    const beforeRows = beforeWindowRows(adapter, target, input, before);
-    const afterRows = afterWindowRows(adapter, target, input, after);
-    const targetHit = toRawHit(targetRow);
-    return {
-        target: targetHit,
-        items: [...beforeRows.reverse().map(toRawHit), targetHit, ...afterRows.map(toRawHit)],
-    };
-}
-function beforeWindowRows(adapter, target, input, limit) {
-    if (limit === 0) {
-        return [];
-    }
-    const params = [target.source_connector, target.channel, target.source_timestamp_ms];
-    const clauses = [
-        'e.source_connector = ?',
-        target.channel === null ? 'e.channel IS ?' : 'e.channel = ?',
-        'e.source_timestamp_ms < ?',
-    ];
-    appendFilters(clauses, params, {
-        query: '*',
-        connectors: input.connectors,
-        scopes: input.scopes,
-    });
-    return adapter
-        .prepare(`
-        SELECT e.*, 0 AS rank
-        FROM connector_event_index e
-        WHERE ${clauses.join(' AND ')}
-        ORDER BY e.source_timestamp_ms DESC, e.event_index_id DESC
-        LIMIT ?
-      `)
-        .all(...params, limit);
-}
-function afterWindowRows(adapter, target, input, limit) {
-    if (limit === 0) {
-        return [];
-    }
-    const params = [target.source_connector, target.channel, target.source_timestamp_ms];
-    const clauses = [
-        'e.source_connector = ?',
-        target.channel === null ? 'e.channel IS ?' : 'e.channel = ?',
-        'e.source_timestamp_ms > ?',
-    ];
-    appendFilters(clauses, params, {
-        query: '*',
-        connectors: input.connectors,
-        scopes: input.scopes,
-    });
-    return adapter
-        .prepare(`
-        SELECT e.*, 0 AS rank
-        FROM connector_event_index e
-        WHERE ${clauses.join(' AND ')}
-        ORDER BY e.source_timestamp_ms ASC, e.event_index_id ASC
-        LIMIT ?
-      `)
-        .all(...params, limit);
-}
-// The entity a raw event belongs to, plus its connector. source_entity_id is unique only WITHIN a
-// connector, so history must carry the connector too or two connectors sharing an id would merge.
-function resolveEntityAnchor(adapter, rawId, visibility) {
-    const clauses = ['e.event_index_id = ?'];
-    const params = [rawId];
-    appendFilters(clauses, params, { query: '*', ...visibility });
-    const row = adapter
-        .prepare(`SELECT source_entity_id, source_connector FROM connector_event_index e WHERE ${clauses.join(' AND ')} LIMIT 1`)
-        .get(...params);
-    return row &&
-        typeof row.source_entity_id === 'string' &&
-        row.source_entity_id.length > 0 &&
-        typeof row.source_connector === 'string' &&
-        row.source_connector.length > 0
-        ? { entityId: row.source_entity_id, connector: row.source_connector }
-        : null;
-}
-function singleConnector(connectors) {
-    const normalized = normalizeConnectors(connectors);
-    return normalized.length === 1 ? normalized[0] : null;
-}
-function encodeHistoryCursor(row) {
-    return Buffer.from(JSON.stringify({ timestampMs: row.source_timestamp_ms, rawId: row.event_index_id }), 'utf8').toString('base64url');
-}
-function decodeHistoryCursor(cursor) {
-    if (!cursor) {
-        return null;
-    }
-    try {
-        const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
-        if (typeof parsed.timestampMs !== 'number' ||
-            !Number.isFinite(parsed.timestampMs) ||
-            typeof parsed.rawId !== 'string' ||
-            parsed.rawId.length === 0) {
-            throw new Error('invalid shape');
-        }
-        return { timestampMs: parsed.timestampMs, rawId: parsed.rawId };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        throw new Error(`Invalid raw history cursor: ${message}`);
-    }
-}
-/**
- * Chronological change history of one upstream entity (rows sharing source_entity_id), bounded by
- * the SAME connector/scope visibility as search - a citation must not out-read reading. Oldest first,
- * cursor-paged. Rows with a NULL source_entity_id (no revision grouping) never match an entity query.
- */
-function getRawHistory(adapter, input) {
-    // Revision identity is connector-scoped. The rawId path takes the anchor's own connector; the
-    // entityId path requires the caller to name exactly one connector, since an entity id alone is
-    // ambiguous across connectors.
-    const trimmedEntityId = input.entityId?.trim() ?? '';
-    const anchor = trimmedEntityId.length > 0
-        ? (() => {
-            const connector = singleConnector(input.connectors);
-            return connector ? { entityId: trimmedEntityId, connector } : null;
-        })()
-        : input.rawId && input.rawId.trim().length > 0
-            ? resolveEntityAnchor(adapter, input.rawId.trim(), {
-                connectors: input.connectors,
-                scopes: input.scopes,
-            })
-            : null;
-    if (!anchor) {
-        return { hits: [], next_cursor: null };
-    }
-    const limit = normalizeLimit(input.limit);
-    if (limit === 0) {
-        return { hits: [], next_cursor: null };
-    }
-    const clauses = ['e.source_entity_id = ?'];
-    const params = [anchor.entityId];
-    appendFilters(clauses, params, {
-        query: '*',
-        connectors: [anchor.connector],
-        scopes: input.scopes,
-        fromMs: input.fromMs,
-        toMs: input.toMs,
-    });
-    const cursor = decodeHistoryCursor(input.cursor);
-    if (cursor) {
-        clauses.push('(e.source_timestamp_ms > ? OR (e.source_timestamp_ms = ? AND e.event_index_id > ?))');
-        params.push(cursor.timestampMs, cursor.timestampMs, cursor.rawId);
-    }
-    const rows = adapter
-        .prepare(`
-        SELECT e.*, 0 AS rank
-        FROM connector_event_index e
-        WHERE ${clauses.join(' AND ')}
-        ORDER BY e.source_timestamp_ms ASC, e.event_index_id ASC
-        LIMIT ?
-      `)
-        .all(...params, limit + 1);
-    const pageRows = rows.slice(0, limit);
-    const nextRow = rows.length > limit ? pageRows[pageRows.length - 1] : undefined;
-    return {
-        hits: pageRows.map(toRawHit),
-        next_cursor: nextRow
-            ? encodeHistoryCursor({
-                source_timestamp_ms: Number(nextRow.source_timestamp_ms),
-                event_index_id: String(nextRow.event_index_id),
-            })
-            : null,
-    };
-}
-//# sourceMappingURL=raw-query.js.map