hippo-memory 0.35.0 → 0.37.0

package/dist/client.d.ts

@@ -0,0 +1,54 @@
+/**
+ * HTTP client wrapper for `hippo serve`.
+ *
+ * Mirrors the function signatures in src/api.ts so the CLI can route through
+ * either path uniformly. Each function takes (serverUrl, apiKey?, ...) and
+ * returns the same shape that api.ts would.
+ *
+ * Errors from the server (4xx/5xx) are mapped back into thrown Errors with
+ * the server's `error` message preserved verbatim so existing CLI handlers
+ * that match on substrings (e.g. "not found", "already superseded") still
+ * work unchanged.
+ *
+ * Network errors (ECONNREFUSED on a stale pidfile, etc.) propagate as the
+ * native fetch failure so the caller can detect them and self-heal.
+ */
+import type { AuditEvent } from './audit.js';
+import type { ApiKeyListItem } from './auth.js';
+import type { RememberOpts, RememberResult, RecallOpts, RecallResult, AuthCreateOpts, AuthCreateResult, AuditListOpts } from './api.js';
+export declare function remember(serverUrl: string, apiKey: string | undefined, opts: RememberOpts): Promise<RememberResult>;
+export declare function recall(serverUrl: string, apiKey: string | undefined, opts: RecallOpts): Promise<RecallResult>;
+export declare function forget(serverUrl: string, apiKey: string | undefined, id: string): Promise<{
+    ok: true;
+    id: string;
+}>;
+export declare function promote(serverUrl: string, apiKey: string | undefined, id: string): Promise<{
+    ok: true;
+    sourceId: string;
+    globalId: string;
+}>;
+export declare function supersede(serverUrl: string, apiKey: string | undefined, oldId: string, newContent: string): Promise<{
+    ok: true;
+    oldId: string;
+    newId: string;
+}>;
+export declare function archiveRaw(serverUrl: string, apiKey: string | undefined, id: string, reason: string): Promise<{
+    ok: true;
+    archivedAt: string;
+}>;
+export declare function authCreate(serverUrl: string, apiKey: string | undefined, opts: AuthCreateOpts): Promise<AuthCreateResult>;
+export declare function authList(serverUrl: string, apiKey: string | undefined, opts: {
+    active: boolean;
+}): Promise<ApiKeyListItem[]>;
+export declare function authRevoke(serverUrl: string, apiKey: string | undefined, keyId: string): Promise<{
+    ok: true;
+    revokedAt: string;
+}>;
+export declare function auditList(serverUrl: string, apiKey: string | undefined, opts: AuditListOpts): Promise<AuditEvent[]>;
+/**
+ * True for fetch failures that look like "server not actually running" (the
+ * pidfile said one was, but the connection refused, or DNS / abort errors).
+ * The CLI uses this to detect a stale pidfile and self-heal back to direct mode.
+ */
+export declare function isConnectionRefused(err: unknown): boolean;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAW,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,EACd,MAAM,UAAU,CAAC;AA4BlB,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAQzB;AAED,wBAAsB,MAAM,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,CAAC,CAWvB;AAED,wBAAsB,MAAM,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAOnC;AAED,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAO3D;AAED,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAQrD;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ3C;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAED,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC,CAS3B;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAO1C;AAED,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAavB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAgBzD"}

package/dist/client.js

@@ -0,0 +1,181 @@
+/**
+ * HTTP client wrapper for `hippo serve`.
+ *
+ * Mirrors the function signatures in src/api.ts so the CLI can route through
+ * either path uniformly. Each function takes (serverUrl, apiKey?, ...) and
+ * returns the same shape that api.ts would.
+ *
+ * Errors from the server (4xx/5xx) are mapped back into thrown Errors with
+ * the server's `error` message preserved verbatim so existing CLI handlers
+ * that match on substrings (e.g. "not found", "already superseded") still
+ * work unchanged.
+ *
+ * Network errors (ECONNREFUSED on a stale pidfile, etc.) propagate as the
+ * native fetch failure so the caller can detect them and self-heal.
+ */
+function buildHeaders(apiKey, withBody) {
+    const headers = {};
+    if (withBody)
+        headers['content-type'] = 'application/json';
+    if (apiKey)
+        headers['authorization'] = `Bearer ${apiKey}`;
+    return headers;
+}
+/**
+ * Throw an Error matching the server's error message. Keeps message strings
+ * intact so cli.ts handlers can match on the same substrings ("not found",
+ * "already superseded", "Unknown key_id") whether the call went through
+ * api.ts or client.ts.
+ */
+async function throwForStatus(res) {
+    let message = `${res.status} ${res.statusText}`;
+    try {
+        const body = await res.json();
+        if (body && typeof body.error === 'string' && body.error.length > 0) {
+            message = body.error;
+        }
+    }
+    catch {
+        // body wasn't JSON; fall back to status line.
+    }
+    throw new Error(message);
+}
+export async function remember(serverUrl, apiKey, opts) {
+    const res = await fetch(`${serverUrl}/v1/memories`, {
+        method: 'POST',
+        headers: buildHeaders(apiKey, true),
+        body: JSON.stringify(opts),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+export async function recall(serverUrl, apiKey, opts) {
+    const params = new URLSearchParams();
+    params.set('q', opts.query);
+    if (opts.limit !== undefined)
+        params.set('limit', String(opts.limit));
+    if (opts.mode !== undefined)
+        params.set('mode', opts.mode);
+    const res = await fetch(`${serverUrl}/v1/memories?${params.toString()}`, {
+        method: 'GET',
+        headers: buildHeaders(apiKey, false),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+export async function forget(serverUrl, apiKey, id) {
+    const res = await fetch(`${serverUrl}/v1/memories/${encodeURIComponent(id)}`, {
+        method: 'DELETE',
+        headers: buildHeaders(apiKey, false),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+export async function promote(serverUrl, apiKey, id) {
+    const res = await fetch(`${serverUrl}/v1/memories/${encodeURIComponent(id)}/promote`, {
+        method: 'POST',
+        headers: buildHeaders(apiKey, false),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+export async function supersede(serverUrl, apiKey, oldId, newContent) {
+    const res = await fetch(`${serverUrl}/v1/memories/${encodeURIComponent(oldId)}/supersede`, {
+        method: 'POST',
+        headers: buildHeaders(apiKey, true),
+        body: JSON.stringify({ content: newContent }),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+export async function archiveRaw(serverUrl, apiKey, id, reason) {
+    const res = await fetch(`${serverUrl}/v1/memories/${encodeURIComponent(id)}/archive`, {
+        method: 'POST',
+        headers: buildHeaders(apiKey, true),
+        body: JSON.stringify({ reason }),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+export async function authCreate(serverUrl, apiKey, opts) {
+    const res = await fetch(`${serverUrl}/v1/auth/keys`, {
+        method: 'POST',
+        headers: buildHeaders(apiKey, true),
+        body: JSON.stringify(opts),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+export async function authList(serverUrl, apiKey, opts) {
+    const params = new URLSearchParams();
+    params.set('active', opts.active ? 'true' : 'false');
+    const res = await fetch(`${serverUrl}/v1/auth/keys?${params.toString()}`, {
+        method: 'GET',
+        headers: buildHeaders(apiKey, false),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+export async function authRevoke(serverUrl, apiKey, keyId) {
+    const res = await fetch(`${serverUrl}/v1/auth/keys/${encodeURIComponent(keyId)}`, {
+        method: 'DELETE',
+        headers: buildHeaders(apiKey, false),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+export async function auditList(serverUrl, apiKey, opts) {
+    const params = new URLSearchParams();
+    if (opts.op !== undefined)
+        params.set('op', opts.op);
+    if (opts.since !== undefined)
+        params.set('since', opts.since);
+    if (opts.limit !== undefined)
+        params.set('limit', String(opts.limit));
+    const qs = params.toString();
+    const url = qs.length > 0 ? `${serverUrl}/v1/audit?${qs}` : `${serverUrl}/v1/audit`;
+    const res = await fetch(url, {
+        method: 'GET',
+        headers: buildHeaders(apiKey, false),
+    });
+    if (!res.ok)
+        await throwForStatus(res);
+    return await res.json();
+}
+/**
+ * True for fetch failures that look like "server not actually running" (the
+ * pidfile said one was, but the connection refused, or DNS / abort errors).
+ * The CLI uses this to detect a stale pidfile and self-heal back to direct mode.
+ */
+export function isConnectionRefused(err) {
+    if (!(err instanceof Error))
+        return false;
+    const message = err.message.toLowerCase();
+    // Node fetch wraps the underlying cause; the surface message contains 'fetch failed'
+    // and the cause has the syscall code. We check both shapes.
+    if (message.includes('econnrefused'))
+        return true;
+    if (message.includes('connect econnrefused'))
+        return true;
+    const cause = err.cause;
+    if (cause && typeof cause === 'object') {
+        const code = cause.code;
+        if (code === 'ECONNREFUSED' || code === 'ECONNRESET')
+            return true;
+    }
+    // Fallthrough: 'fetch failed' alone is suspicious. Treat as connection failure
+    // so the CLI heals on a stale pidfile rather than surfacing a cryptic error.
+    if (message.includes('fetch failed'))
+        return true;
+    return false;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/connectors/slack/backfill.d.ts

@@ -0,0 +1,42 @@
+import type { Context } from '../../api.js';
+import type { SlackMessageEvent } from './types.js';
+import type { ChannelMeta } from './scope.js';
+export interface SlackHistoryPage {
+    messages: SlackMessageEvent[];
+    next_cursor: string | null;
+}
+export type SlackHistoryFetcher = (args: {
+    channelId: string;
+    /** Slack's opaque pagination token. Null on first page of a backfill run. */
+    cursor: string | null;
+    /**
+     * Incremental-resume bound: skip messages with ts <= oldest. Set from
+     * `slack_cursors.latest_ts` on the FIRST page of a rerun; unused on
+     * subsequent pages within one run (where `cursor` carries us forward).
+     * Distinct from `cursor` because Slack treats `cursor` as opaque token
+     * and `oldest` as a numeric ts — feeding `latest_ts` as `cursor` breaks
+     * against the live API even though it round-trips through test fetchers.
+     */
+    oldest?: string;
+}) => Promise<SlackHistoryPage>;
+export interface BackfillOpts {
+    teamId: string;
+    channel: ChannelMeta;
+    fetcher: SlackHistoryFetcher;
+    /** Stop after this many messages. Default: unlimited. */
+    maxMessages?: number;
+}
+/**
+ * Page through `conversations.history` via the injected fetcher and ingest each
+ * message. The cursor is persisted to `slack_cursors` after every page so a
+ * crash mid-backfill resumes near where it left off.
+ *
+ * Each ingested message uses a synthesized eventId of the form
+ * `backfill:${teamId}:${channelId}:${ts}`. Reruns dedupe via the
+ * `slack_event_log` PK so calling `backfillChannel` twice is safe.
+ */
+export declare function backfillChannel(ctx: Context, opts: BackfillOpts): Promise<{
+    ingested: number;
+    pages: number;
+}>;
+//# sourceMappingURL=backfill.d.ts.map

package/dist/connectors/slack/backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../../src/connectors/slack/backfill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA+BD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAoC9C"}

package/dist/connectors/slack/backfill.js

@@ -0,0 +1,76 @@
+import { openHippoDb, closeHippoDb } from '../../db.js';
+import { ingestMessage } from './ingest.js';
+function readCursor(root, tenantId, channelId) {
+    const db = openHippoDb(root);
+    try {
+        const row = db
+            .prepare(`SELECT latest_ts FROM slack_cursors WHERE tenant_id=? AND channel_id=?`)
+            .get(tenantId, channelId);
+        return row?.latest_ts ?? null;
+    }
+    finally {
+        closeHippoDb(db);
+    }
+}
+function writeCursor(root, tenantId, channelId, latestTs) {
+    const db = openHippoDb(root);
+    try {
+        db.prepare(`INSERT INTO slack_cursors (tenant_id, channel_id, latest_ts, updated_at) VALUES (?,?,?,?)
+       ON CONFLICT(tenant_id, channel_id) DO UPDATE SET latest_ts = excluded.latest_ts, updated_at = excluded.updated_at`).run(tenantId, channelId, latestTs, new Date().toISOString());
+    }
+    finally {
+        closeHippoDb(db);
+    }
+}
+/**
+ * Page through `conversations.history` via the injected fetcher and ingest each
+ * message. The cursor is persisted to `slack_cursors` after every page so a
+ * crash mid-backfill resumes near where it left off.
+ *
+ * Each ingested message uses a synthesized eventId of the form
+ * `backfill:${teamId}:${channelId}:${ts}`. Reruns dedupe via the
+ * `slack_event_log` PK so calling `backfillChannel` twice is safe.
+ */
+export async function backfillChannel(ctx, opts) {
+    // Resume bound from previous run; passed as `oldest` (numeric ts) on the
+    // first page only. `cursor` starts null — Slack mints the next-page token
+    // and we feed it back. Mixing the two would feed a numeric ts as an opaque
+    // cursor and break against the live API on rerun.
+    const resumeFrom = readCursor(ctx.hippoRoot, ctx.tenantId, opts.channel.id);
+    let cursor = null;
+    let ingested = 0;
+    let pages = 0;
+    let latestTs = resumeFrom;
+    while (true) {
+        const page = await opts.fetcher({
+            channelId: opts.channel.id,
+            cursor,
+            oldest: pages === 0 && resumeFrom ? resumeFrom : undefined,
+        });
+        pages++;
+        for (const msg of page.messages) {
+            const r = ingestMessage(ctx, {
+                teamId: opts.teamId,
+                channel: opts.channel,
+                message: msg,
+                eventId: `backfill:${opts.teamId}:${opts.channel.id}:${msg.ts}`,
+            });
+            if (r.status === 'ingested')
+                ingested++;
+            if (!latestTs || msg.ts > latestTs)
+                latestTs = msg.ts;
+            if (opts.maxMessages && ingested >= opts.maxMessages) {
+                if (latestTs)
+                    writeCursor(ctx.hippoRoot, ctx.tenantId, opts.channel.id, latestTs);
+                return { ingested, pages };
+            }
+        }
+        if (latestTs)
+            writeCursor(ctx.hippoRoot, ctx.tenantId, opts.channel.id, latestTs);
+        if (!page.next_cursor)
+            break;
+        cursor = page.next_cursor;
+    }
+    return { ingested, pages };
+}
+//# sourceMappingURL=backfill.js.map

package/dist/connectors/slack/backfill.js.map

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

package/dist/connectors/slack/deletion.d.ts

@@ -0,0 +1,14 @@
+import { type Context } from '../../api.js';
+export interface DeletionInput {
+    teamId: string;
+    channelId: string;
+    deletedTs: string;
+    eventId: string;
+}
+export type DeletionStatus = 'archived' | 'not_found' | 'duplicate';
+export interface DeletionResult {
+    status: DeletionStatus;
+    memoryId: string | null;
+}
+export declare function handleMessageDeleted(ctx: Context, input: DeletionInput): DeletionResult;
+//# sourceMappingURL=deletion.d.ts.map

package/dist/connectors/slack/deletion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deletion.d.ts","sourceRoot":"","sources":["../../../src/connectors/slack/deletion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAIxD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,cAAc,CAgCvF"}

package/dist/connectors/slack/deletion.js

@@ -0,0 +1,46 @@
+import { archiveRaw } from '../../api.js';
+import { openHippoDb, closeHippoDb } from '../../db.js';
+import { markEventSeen, hasSeenEvent } from './idempotency.js';
+export function handleMessageDeleted(ctx, input) {
+    const db = openHippoDb(ctx.hippoRoot);
+    let memoryId = null;
+    try {
+        if (hasSeenEvent(db, input.eventId)) {
+            return { status: 'duplicate', memoryId: null };
+        }
+        const ref = `slack://${input.teamId}/${input.channelId}/${input.deletedTs}`;
+        // Tenant scope is load-bearing: without `tenant_id = ?` a deletion event
+        // from tenant A could archive tenant B's raw row sharing the same
+        // artifact_ref. The `kind = 'raw'` filter prevents accidentally targeting
+        // distilled rows.
+        const row = db
+            .prepare(`SELECT id FROM memories WHERE artifact_ref = ? AND tenant_id = ? AND kind = 'raw'`)
+            .get(ref, ctx.tenantId);
+        memoryId = row?.id ?? null;
+    }
+    finally {
+        closeHippoDb(db);
+    }
+    if (!memoryId) {
+        const db2 = openHippoDb(ctx.hippoRoot);
+        try {
+            markEventSeen(db2, input.eventId, null);
+        }
+        finally {
+            closeHippoDb(db2);
+        }
+        return { status: 'not_found', memoryId: null };
+    }
+    // api.archiveRaw now handles legacy mirror cleanup centrally so every caller
+    // (CLI, REST route, MCP tool, this connector) gets the GDPR-correct archive.
+    archiveRaw(ctx, memoryId, `source_deleted:slack:${input.teamId}:${input.channelId}:${input.deletedTs}`);
+    const db3 = openHippoDb(ctx.hippoRoot);
+    try {
+        markEventSeen(db3, input.eventId, memoryId);
+    }
+    finally {
+        closeHippoDb(db3);
+    }
+    return { status: 'archived', memoryId };
+}
+//# sourceMappingURL=deletion.js.map

package/dist/connectors/slack/deletion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deletion.js","sourceRoot":"","sources":["../../../src/connectors/slack/deletion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgB/D,MAAM,UAAU,oBAAoB,CAAC,GAAY,EAAE,KAAoB;IACrE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,IAAI,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC;QACD,MAAM,GAAG,GAAG,WAAW,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAC5E,yEAAyE;QACzE,kEAAkE;QAClE,0EAA0E;QAC1E,kBAAkB;QAClB,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CAAC,mFAAmF,CAAC;aAC5F,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAgC,CAAC;QACzD,QAAQ,GAAG,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC;IAC7B,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC;YAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAAC,CAAC;gBACxC,CAAC;YAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;IACD,6EAA6E;IAC7E,6EAA6E;IAC7E,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,wBAAwB,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxG,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC;QAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAAC,CAAC;YAC5C,CAAC;QAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC"}

package/dist/connectors/slack/dlq.d.ts

@@ -0,0 +1,21 @@
+import type { DatabaseSyncLike } from '../../db.js';
+export interface DlqItem {
+    id: number;
+    tenantId: string;
+    rawPayload: string;
+    error: string;
+    receivedAt: string;
+    retriedAt: string | null;
+}
+export interface WriteDlqOpts {
+    tenantId: string;
+    rawPayload: string;
+    error: string;
+}
+export declare function writeToDlq(db: DatabaseSyncLike, opts: WriteDlqOpts): number;
+export declare function listDlq(db: DatabaseSyncLike, opts: {
+    tenantId: string;
+    limit?: number;
+}): DlqItem[];
+export declare function markDlqRetried(db: DatabaseSyncLike, id: number): void;
+//# sourceMappingURL=dlq.d.ts.map

package/dist/connectors/slack/dlq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.d.ts","sourceRoot":"","sources":["../../../src/connectors/slack/dlq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAK3E;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,EAAE,CAYnG;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAErE"}

package/dist/connectors/slack/dlq.js

@@ -0,0 +1,23 @@
+export function writeToDlq(db, opts) {
+    const result = db
+        .prepare(`INSERT INTO slack_dlq (tenant_id, raw_payload, error, received_at) VALUES (?, ?, ?, ?)`)
+        .run(opts.tenantId, opts.rawPayload, opts.error, new Date().toISOString());
+    return Number(result.lastInsertRowid);
+}
+export function listDlq(db, opts) {
+    const rows = db
+        .prepare(`SELECT id, tenant_id, raw_payload, error, received_at, retried_at FROM slack_dlq WHERE tenant_id = ? ORDER BY received_at ASC LIMIT ?`)
+        .all(opts.tenantId, opts.limit ?? 100);
+    return rows.map((r) => ({
+        id: Number(r.id),
+        tenantId: String(r.tenant_id),
+        rawPayload: String(r.raw_payload),
+        error: String(r.error),
+        receivedAt: String(r.received_at),
+        retriedAt: r.retried_at == null ? null : String(r.retried_at),
+    }));
+}
+export function markDlqRetried(db, id) {
+    db.prepare(`UPDATE slack_dlq SET retried_at = ? WHERE id = ?`).run(new Date().toISOString(), id);
+}
+//# sourceMappingURL=dlq.js.map

package/dist/connectors/slack/dlq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.js","sourceRoot":"","sources":["../../../src/connectors/slack/dlq.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,UAAU,CAAC,EAAoB,EAAE,IAAkB;IACjE,MAAM,MAAM,GAAG,EAAE;SACd,OAAO,CAAC,wFAAwF,CAAC;SACjG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7E,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAoB,EAAE,IAA0C;IACtF,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,uIAAuI,CAAC;SAChJ,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,CAAmC,CAAC;IAC3E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;QACjC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;QACjC,SAAS,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;KAC9D,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAoB,EAAE,EAAU;IAC7D,EAAE,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;AACnG,CAAC"}

package/dist/connectors/slack/idempotency.d.ts

@@ -0,0 +1,5 @@
+import type { DatabaseSyncLike } from '../../db.js';
+export declare function hasSeenEvent(db: DatabaseSyncLike, eventId: string): boolean;
+export declare function markEventSeen(db: DatabaseSyncLike, eventId: string, memoryId: string | null): void;
+export declare function lookupMemoryByEvent(db: DatabaseSyncLike, eventId: string): string | null;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/connectors/slack/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../../src/connectors/slack/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,wBAAgB,YAAY,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAG3E;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAGlG;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKxF"}

package/dist/connectors/slack/idempotency.js

@@ -0,0 +1,13 @@
+export function hasSeenEvent(db, eventId) {
+    const row = db.prepare(`SELECT 1 FROM slack_event_log WHERE event_id = ?`).get(eventId);
+    return !!row;
+}
+export function markEventSeen(db, eventId, memoryId) {
+    db.prepare(`INSERT OR IGNORE INTO slack_event_log (event_id, ingested_at, memory_id) VALUES (?, ?, ?)`)
+        .run(eventId, new Date().toISOString(), memoryId);
+}
+export function lookupMemoryByEvent(db, eventId) {
+    const row = db.prepare(`SELECT memory_id FROM slack_event_log WHERE event_id = ?`).get(eventId);
+    return row?.memory_id ?? null;
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/connectors/slack/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../../src/connectors/slack/idempotency.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,EAAoB,EAAE,OAAe;IAChE,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxF,OAAO,CAAC,CAAC,GAAG,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAoB,EAAE,OAAe,EAAE,QAAuB;IAC1F,EAAE,CAAC,OAAO,CAAC,2FAA2F,CAAC;SACpG,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAoB,EAAE,OAAe;IACvE,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,0DAA0D,CAAC,CAAC,GAAG,CAAC,OAAO,CAEjF,CAAC;IACd,OAAO,GAAG,EAAE,SAAS,IAAI,IAAI,CAAC;AAChC,CAAC"}

package/dist/connectors/slack/ingest.d.ts

@@ -0,0 +1,27 @@
+import { type Context } from '../../api.js';
+import type { ChannelMeta } from './scope.js';
+import type { SlackMessageEvent } from './types.js';
+export interface IngestInput {
+    teamId: string;
+    channel: ChannelMeta;
+    message: SlackMessageEvent;
+    /** Slack event_id for the envelope (or for backfill, a synthesized stable id). */
+    eventId: string;
+}
+export type IngestStatus = 'ingested' | 'duplicate' | 'skipped';
+export interface IngestResult {
+    status: IngestStatus;
+    memoryId: string | null;
+}
+/**
+ * Ingest a Slack message into hippo as a kind='raw' memory.
+ *
+ * - Idempotency-checked via slack_event_log (Slack retries within 1 minute).
+ * - The memory write and the slack_event_log mark commit atomically through
+ *   `api.remember`'s `afterWrite` hook — a crash between the two cannot
+ *   produce a duplicate on the next retry.
+ * - Empty-body messages return 'skipped' but still mark seen so a replay
+ *   returns 'duplicate' rather than re-running the transform.
+ */
+export declare function ingestMessage(ctx: Context, input: IngestInput): IngestResult;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/connectors/slack/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../src/connectors/slack/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAItD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,YAAY,CAmC5E"}

package/dist/connectors/slack/ingest.js

@@ -0,0 +1,48 @@
+import { remember } from '../../api.js';
+import { openHippoDb, closeHippoDb } from '../../db.js';
+import { hasSeenEvent, markEventSeen, lookupMemoryByEvent } from './idempotency.js';
+import { messageToRememberOpts } from './transform.js';
+/**
+ * Ingest a Slack message into hippo as a kind='raw' memory.
+ *
+ * - Idempotency-checked via slack_event_log (Slack retries within 1 minute).
+ * - The memory write and the slack_event_log mark commit atomically through
+ *   `api.remember`'s `afterWrite` hook — a crash between the two cannot
+ *   produce a duplicate on the next retry.
+ * - Empty-body messages return 'skipped' but still mark seen so a replay
+ *   returns 'duplicate' rather than re-running the transform.
+ */
+export function ingestMessage(ctx, input) {
+    // Idempotency check: if already seen, return the cached memory_id without
+    // re-running the transform or hitting api.remember.
+    const db = openHippoDb(ctx.hippoRoot);
+    try {
+        if (hasSeenEvent(db, input.eventId)) {
+            return { status: 'duplicate', memoryId: lookupMemoryByEvent(db, input.eventId) };
+        }
+    }
+    finally {
+        closeHippoDb(db);
+    }
+    const opts = messageToRememberOpts(input);
+    if (!opts) {
+        const db2 = openHippoDb(ctx.hippoRoot);
+        try {
+            markEventSeen(db2, input.eventId, null);
+        }
+        finally {
+            closeHippoDb(db2);
+        }
+        return { status: 'skipped', memoryId: null };
+    }
+    // Atomic write: the afterWrite callback runs inside writeEntry's SAVEPOINT,
+    // so the memory row and the slack_event_log row commit (or roll back)
+    // together. Slack's 1-minute retry window can no longer produce a duplicate
+    // via the crash-between-handles race.
+    const result = remember({ ...ctx, actor: ctx.actor || 'connector:slack' }, {
+        ...opts,
+        afterWrite: (db, memoryId) => markEventSeen(db, input.eventId, memoryId),
+    });
+    return { status: 'ingested', memoryId: result.id };
+}
+//# sourceMappingURL=ingest.js.map

package/dist/connectors/slack/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../src/connectors/slack/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAgB,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAmBvD;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,KAAkB;IAC5D,0EAA0E;IAC1E,oDAAoD;IACpD,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,IAAI,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnF,CAAC;IACH,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,4EAA4E;IAC5E,sEAAsE;IACtE,4EAA4E;IAC5E,sCAAsC;IACtC,MAAM,MAAM,GAAG,QAAQ,CACrB,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,iBAAiB,EAAE,EACjD;QACE,GAAG,IAAI;QACP,UAAU,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;KACzE,CACF,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;AACrD,CAAC"}

package/dist/connectors/slack/ratelimit.d.ts

@@ -0,0 +1,9 @@
+export interface RetryOpts {
+    url: string;
+    init?: RequestInit;
+    fetchImpl?: typeof fetch;
+    sleep?: (ms: number) => Promise<void>;
+    maxRetries?: number;
+}
+export declare function fetchWithRetry(opts: RetryOpts): Promise<Response>;
+//# sourceMappingURL=ratelimit.d.ts.map

package/dist/connectors/slack/ratelimit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratelimit.d.ts","sourceRoot":"","sources":["../../../src/connectors/slack/ratelimit.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAcvE"}