@ixo/oracle-runtime 0.0.1

package/dist/plugins/firecrawl/firecrawl.plugin.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { OraclePlugin } from '../../plugin-api/oracle-plugin.js';
+import { createFirecrawlSubAgent } from './firecrawl-agent.js';
+import { createDefaultFirecrawlMcpFactory, createFirecrawlTools, } from './firecrawl-tools.js';
+const configSchema = z.object({
+    FIRECRAWL_MCP_URL: z
+        .string()
+        .url('FIRECRAWL_MCP_URL must be a valid HTTP(S) URL.'),
+});
+const manifest = {
+    title: 'Firecrawl',
+    summary: 'Web search and scraping of human-readable pages via Firecrawl.',
+    whenToUse: [
+        'User asks the agent to search the web for current information.',
+        'User wants the contents of a specific page summarized or extracted.',
+        'A question can only be answered by recent public web content.',
+    ],
+    whenNotToUse: [
+        'Fetching from an API endpoint (URLs containing /api/, /v1/, /v2/, /v3/, or that return JSON/XML) — use the Sandbox instead.',
+        'IXO entity lookups (use the Domain Indexer).',
+        'Personal memory or past-conversation recall (use Memory).',
+    ],
+    examples: [
+        {
+            user: 'What did OpenAI announce at their last event?',
+            thought: 'Recent public web content — delegate to call_firecrawl_agent for a fresh search.',
+            tool: 'call_firecrawl_agent',
+        },
+        {
+            user: 'Pull the key points from this page: https://example.com/blog/post',
+            thought: 'Specific human-readable page — scrape it, summarize.',
+            tool: 'call_firecrawl_agent',
+        },
+    ],
+    tags: ['web', 'search', 'scrape', 'firecrawl'],
+    category: 'data',
+    visibility: 'on-demand',
+    stability: 'stable',
+};
+function resolveFirecrawlUrl(config) {
+    const parsed = configSchema.parse(config);
+    return parsed.FIRECRAWL_MCP_URL;
+}
+/**
+ * Firecrawl plugin. Exposes a sub-agent (`call_firecrawl_agent`) that wraps
+ * the upstream Firecrawl MCP server's `firecrawl_search` and
+ * `firecrawl_scrape` tools.
+ */
+export class FirecrawlPlugin extends OraclePlugin {
+    name = 'firecrawl';
+    version = '1.0.0';
+    manifest = manifest;
+    configSchema = configSchema;
+    autoDetectHint = 'FIRECRAWL_MCP_URL';
+    mcpFactory;
+    constructor(options = {}) {
+        super();
+        this.mcpFactory = options.mcpFactory ?? createDefaultFirecrawlMcpFactory;
+    }
+    autoDetect(env) {
+        return Boolean(env.FIRECRAWL_MCP_URL);
+    }
+    getSubAgents(ctx) {
+        const firecrawlUrl = resolveFirecrawlUrl(ctx.config);
+        const factory = this.mcpFactory(firecrawlUrl);
+        const tools = createFirecrawlTools(factory);
+        return [createFirecrawlSubAgent(tools)];
+    }
+}

package/dist/plugins/firecrawl/index.d.ts

@@ -0,0 +1,3 @@
+export { FirecrawlPlugin, type FirecrawlPluginOptions, } from './firecrawl.plugin.js';
+export { FIRECRAWL_SCRAPE_TOOL, FIRECRAWL_SEARCH_TOOL, type FirecrawlMcpFactory, type FirecrawlMcpProxyTool, } from './firecrawl-tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/firecrawl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/firecrawl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC"}

package/dist/plugins/firecrawl/index.js

@@ -0,0 +1,2 @@
+export { FirecrawlPlugin, } from './firecrawl.plugin.js';
+export { FIRECRAWL_SCRAPE_TOOL, FIRECRAWL_SEARCH_TOOL, } from './firecrawl-tools.js';

package/dist/plugins/index.d.ts

@@ -0,0 +1,47 @@
+import type { OraclePlugin } from '../plugin-api/oracle-plugin.js';
+import { AGUIPlugin } from './agui/index.js';
+import { ComposioPlugin } from './composio/index.js';
+import { CreditsPlugin } from './credits/index.js';
+import { DomainIndexerPlugin } from './domain-indexer/index.js';
+import { EditorPlugin } from './editor/index.js';
+import { FirecrawlPlugin } from './firecrawl/index.js';
+import { MatrixGroupChatsPlugin } from './matrix-group-chats/index.js';
+import { MemoryPlugin } from './memory/index.js';
+import { PortalPlugin } from './portal/index.js';
+import { SandboxPlugin } from './sandbox/index.js';
+import { SkillsPlugin } from './skills/index.js';
+import { SlackPlugin } from './slack/index.js';
+import { UserPreferencesPlugin } from './user-preferences/index.js';
+export declare const memoryPlugin: MemoryPlugin;
+export declare const portalPlugin: PortalPlugin;
+export declare const firecrawlPlugin: FirecrawlPlugin;
+export declare const domainIndexerPlugin: DomainIndexerPlugin;
+export declare const composioPlugin: ComposioPlugin;
+export declare const sandboxPlugin: SandboxPlugin;
+export declare const skillsPlugin: SkillsPlugin;
+export declare const editorPlugin: EditorPlugin;
+export declare const aguiPlugin: AGUIPlugin;
+export declare const slackPlugin: SlackPlugin;
+export declare const tasksPlugin: OraclePlugin & {
+    readonly name: "tasks";
+};
+export declare const creditsPlugin: CreditsPlugin;
+export declare const callsPlugin: OraclePlugin & {
+    readonly name: "calls";
+};
+export declare const userPreferencesPlugin: UserPreferencesPlugin;
+export declare const matrixGroupChatsPlugin: MatrixGroupChatsPlugin;
+/**
+ * The canonical bundled-plugin set used by `createOracleApp` when the
+ * caller does not supply `bundledPlugins`. Forks that need a custom
+ * bundled set pass their own array via `bundledPlugins`.
+ *
+ * Typed as a readonly tuple via `as const` so `BundledFeatureName` can
+ * derive the literal union of plugin names from this single source.
+ */
+export declare const BUNDLED_PLUGINS: readonly [MemoryPlugin, PortalPlugin, FirecrawlPlugin, DomainIndexerPlugin, ComposioPlugin, SandboxPlugin, SkillsPlugin, EditorPlugin, AGUIPlugin, SlackPlugin, OraclePlugin & {
+    readonly name: "tasks";
+}, CreditsPlugin, OraclePlugin & {
+    readonly name: "calls";
+}, UserPreferencesPlugin, MatrixGroupChatsPlugin];
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAqBpE,eAAO,MAAM,YAAY,cAAqB,CAAC;AAC/C,eAAO,MAAM,YAAY,cAAqB,CAAC;AAC/C,eAAO,MAAM,eAAe,iBAAwB,CAAC;AACrD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAC7D,eAAO,MAAM,cAAc,gBAAuB,CAAC;AACnD,eAAO,MAAM,aAAa,eAAsB,CAAC;AACjD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAC/C,eAAO,MAAM,YAAY,cAAqB,CAAC;AAC/C,eAAO,MAAM,UAAU,YAAmB,CAAC;AAC3C,eAAO,MAAM,WAAW,aAAoB,CAAC;AAC7C,eAAO,MAAM,WAAW;;CAGtB,CAAC;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC;AACjD,eAAO,MAAM,WAAW;;CAAyB,CAAC;AAClD,eAAO,MAAM,qBAAqB,uBAA8B,CAAC;AACjE,eAAO,MAAM,sBAAsB,wBAA+B,CAAC;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;iDAgBoB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,69 @@
+import { AGUIPlugin } from './agui/index.js';
+import { ComposioPlugin } from './composio/index.js';
+import { CreditsPlugin } from './credits/index.js';
+import { DomainIndexerPlugin } from './domain-indexer/index.js';
+import { EditorPlugin } from './editor/index.js';
+import { FirecrawlPlugin } from './firecrawl/index.js';
+import { MatrixGroupChatsPlugin } from './matrix-group-chats/index.js';
+import { MemoryPlugin } from './memory/index.js';
+import { PortalPlugin } from './portal/index.js';
+import { SandboxPlugin } from './sandbox/index.js';
+import { SkillsPlugin } from './skills/index.js';
+import { SlackPlugin } from './slack/index.js';
+import { UserPreferencesPlugin } from './user-preferences/index.js';
+const stubManifest = (title) => ({
+    title,
+    summary: `${title} plugin.`,
+    whenToUse: [],
+    visibility: 'silent',
+    stability: 'experimental',
+});
+const stub = (name, title, extras = {}) => ({
+    version: '0.0.0',
+    manifest: stubManifest(title),
+    ...extras,
+    name,
+});
+export const memoryPlugin = new MemoryPlugin();
+export const portalPlugin = new PortalPlugin();
+export const firecrawlPlugin = new FirecrawlPlugin();
+export const domainIndexerPlugin = new DomainIndexerPlugin();
+export const composioPlugin = new ComposioPlugin();
+export const sandboxPlugin = new SandboxPlugin();
+export const skillsPlugin = new SkillsPlugin();
+export const editorPlugin = new EditorPlugin();
+export const aguiPlugin = new AGUIPlugin();
+export const slackPlugin = new SlackPlugin();
+export const tasksPlugin = stub('tasks', 'Tasks', {
+    autoDetect: (env) => Boolean(env.REDIS_URL),
+    autoDetectHint: 'REDIS_URL',
+});
+export const creditsPlugin = new CreditsPlugin();
+export const callsPlugin = stub('calls', 'Calls');
+export const userPreferencesPlugin = new UserPreferencesPlugin();
+export const matrixGroupChatsPlugin = new MatrixGroupChatsPlugin();
+/**
+ * The canonical bundled-plugin set used by `createOracleApp` when the
+ * caller does not supply `bundledPlugins`. Forks that need a custom
+ * bundled set pass their own array via `bundledPlugins`.
+ *
+ * Typed as a readonly tuple via `as const` so `BundledFeatureName` can
+ * derive the literal union of plugin names from this single source.
+ */
+export const BUNDLED_PLUGINS = [
+    memoryPlugin,
+    portalPlugin,
+    firecrawlPlugin,
+    domainIndexerPlugin,
+    composioPlugin,
+    sandboxPlugin,
+    skillsPlugin,
+    editorPlugin,
+    aguiPlugin,
+    slackPlugin,
+    tasksPlugin,
+    creditsPlugin,
+    callsPlugin,
+    userPreferencesPlugin,
+    matrixGroupChatsPlugin,
+];

package/dist/plugins/matrix-group-chats/channel-memory.module.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Channel-memory module. Globally exports `ChannelMemoryService` so other
+ * plugins / forks can inject it without re-importing the module.
+ */
+export declare class ChannelMemoryModule {
+}
+//# sourceMappingURL=channel-memory.module.d.ts.map

package/dist/plugins/matrix-group-chats/channel-memory.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-memory.module.d.ts","sourceRoot":"","sources":["../../../src/plugins/matrix-group-chats/channel-memory.module.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAKa,mBAAmB;CAAG"}

package/dist/plugins/matrix-group-chats/channel-memory.module.js

@@ -0,0 +1,22 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Global, Module } from '@nestjs/common';
+import { ChannelMemoryService } from './channel-memory.service.js';
+/**
+ * Channel-memory module. Globally exports `ChannelMemoryService` so other
+ * plugins / forks can inject it without re-importing the module.
+ */
+let ChannelMemoryModule = class ChannelMemoryModule {
+};
+ChannelMemoryModule = __decorate([
+    Global(),
+    Module({
+        providers: [ChannelMemoryService],
+        exports: [ChannelMemoryService],
+    })
+], ChannelMemoryModule);
+export { ChannelMemoryModule };

package/dist/plugins/matrix-group-chats/channel-memory.repo.d.ts

@@ -0,0 +1,62 @@
+import { type ChannelMemoryChunk, type ChannelMember, type PinnedFact } from './channel-memory.types.js';
+export interface TierRollupCandidate {
+    /** Inclusive lower bound of the bucket window (epoch ms). */
+    windowStart: number;
+    /** Exclusive upper bound. */
+    windowEnd: number;
+    /** Tier the rollup will produce (2 or 3). */
+    toTier: number;
+    /** Source chunks being consolidated. */
+    chunks: ChannelMemoryChunk[];
+}
+/**
+ * SQLite repository for channel memory chunks, pinned facts, and roster.
+ *
+ * One DB file per room. better-sqlite3 (already a transitive dep via the
+ * checkpointer) + FTS5 (built-in) for chunk search. Schema is created
+ * idempotently on init.
+ */
+export declare class ChannelMemoryRepo {
+    private readonly db;
+    constructor(databasePath: string);
+    private bootstrap;
+    insertChunk(chunk: ChannelMemoryChunk): void;
+    recentChunks(roomId: string, limit: number, tier?: number): ChannelMemoryChunk[];
+    oldestChunks(roomId: string, limit: number): ChannelMemoryChunk[];
+    countChunks(roomId: string): number;
+    /**
+     * Find tier=N chunks older than `olderThanTs` and return them grouped into
+     * fixed time buckets (week or month). Used by the tier scheduler to roll
+     * granular tier-1 chunks into a tier-2 weekly summary, then tier-2 into
+     * tier-3 monthly summaries.
+     */
+    findRollupCandidates(roomId: string, args: {
+        sourceTier: number;
+        olderThanTs: number;
+        bucketMs: number;
+        minChunksPerBucket: number;
+    }): TierRollupCandidate[];
+    /**
+     * Atomically delete a list of source chunks and insert a rollup. Used by the
+     * tier scheduler — keeps the DB consistent if the process is interrupted
+     * mid-rollup.
+     */
+    replaceWithRollup(sourceIds: string[], rollup: ChannelMemoryChunk): void;
+    searchChunks(roomId: string, query: string, limit: number): ChannelMemoryChunk[];
+    insertPinnedFact(fact: PinnedFact): void;
+    listPinnedFacts(roomId: string, limit?: number): PinnedFact[];
+    deletePinnedFact(roomId: string, factId: string): boolean;
+    upsertMembers(roomId: string, members: ChannelMember[]): void;
+    getMembers(roomId: string): ChannelMember[];
+    /**
+     * Force the SQLite WAL to disk before snapshot / upload, so the file on
+     * disk reflects every committed transaction. Cheap; safe to call often.
+     */
+    checkpoint(): void;
+    /** List every room this DB has ever stored data for. */
+    listRoomIds(): string[];
+    close(): void;
+    private rowToChunk;
+    private rowToFact;
+}
+//# sourceMappingURL=channel-memory.repo.d.ts.map

package/dist/plugins/matrix-group-chats/channel-memory.repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-memory.repo.d.ts","sourceRoot":"","sources":["../../../src/plugins/matrix-group-chats/channel-memory.repo.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBAEtB,YAAY,EAAE,MAAM;IAShC,OAAO,CAAC,SAAS;IAmEjB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAwB5C,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,kBAAkB,EAAE;IAY3E,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAYjE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IASnC;;;;;OAKG;IACH,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,GACA,mBAAmB,EAAE;IAmCxB;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAaxE,YAAY,CACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,kBAAkB,EAAE;IAsCvB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAiBxC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,UAAU,EAAE;IAY1D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAOzD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI;IAY7D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE;IAoB3C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAUlB,wDAAwD;IACxD,WAAW,IAAI,MAAM,EAAE;IAWvB,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,UAAU,CAaf;IAEH,OAAO,CAAC,SAAS,CAOd;CACJ"}

package/dist/plugins/matrix-group-chats/channel-memory.repo.js

@@ -0,0 +1,311 @@
+import { Logger } from '@nestjs/common';
+import Database from 'better-sqlite3';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const logger = new Logger('ChannelMemoryRepo');
+/**
+ * SQLite repository for channel memory chunks, pinned facts, and roster.
+ *
+ * One DB file per room. better-sqlite3 (already a transitive dep via the
+ * checkpointer) + FTS5 (built-in) for chunk search. Schema is created
+ * idempotently on init.
+ */
+export class ChannelMemoryRepo {
+    db;
+    constructor(databasePath) {
+        fs.mkdirSync(path.dirname(databasePath), { recursive: true });
+        this.db = new Database(databasePath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('busy_timeout = 5000');
+        this.db.pragma('synchronous = NORMAL');
+        this.bootstrap();
+    }
+    bootstrap() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS channel_memory_chunks (
+        id                TEXT PRIMARY KEY,
+        room_id           TEXT NOT NULL,
+        summary           TEXT NOT NULL,
+        from_event_id     TEXT NOT NULL,
+        to_event_id       TEXT NOT NULL,
+        from_ts           INTEGER NOT NULL,
+        to_ts             INTEGER NOT NULL,
+        message_count     INTEGER NOT NULL,
+        participants_json TEXT NOT NULL,
+        thread_ids_json   TEXT NOT NULL,
+        tier              INTEGER NOT NULL DEFAULT 1,
+        created_at        INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_chunks_room_ts
+        ON channel_memory_chunks(room_id, to_ts DESC);
+      CREATE INDEX IF NOT EXISTS idx_chunks_room_tier_ts
+        ON channel_memory_chunks(room_id, tier, to_ts DESC);
+
+      CREATE TABLE IF NOT EXISTS channel_pinned_facts (
+        id              TEXT PRIMARY KEY,
+        room_id         TEXT NOT NULL,
+        fact            TEXT NOT NULL,
+        pinned_by_did   TEXT NOT NULL,
+        source_event_id TEXT,
+        created_at      INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_facts_room
+        ON channel_pinned_facts(room_id, created_at DESC);
+
+      CREATE TABLE IF NOT EXISTS channel_meta (
+        room_id      TEXT PRIMARY KEY,
+        members_json TEXT NOT NULL DEFAULT '[]',
+        updated_at   INTEGER NOT NULL
+      );
+    `);
+        // FTS5 virtual table. Skip silently if SQLite was built without FTS5.
+        try {
+            this.db.exec(`
+        CREATE VIRTUAL TABLE IF NOT EXISTS channel_memory_chunks_fts USING fts5(
+          summary,
+          room_id UNINDEXED,
+          content='channel_memory_chunks',
+          content_rowid='rowid',
+          tokenize='porter unicode61'
+        );
+        CREATE TRIGGER IF NOT EXISTS chunks_ai AFTER INSERT ON channel_memory_chunks
+        BEGIN
+          INSERT INTO channel_memory_chunks_fts(rowid, summary, room_id)
+            VALUES (new.rowid, new.summary, new.room_id);
+        END;
+        CREATE TRIGGER IF NOT EXISTS chunks_ad AFTER DELETE ON channel_memory_chunks
+        BEGIN
+          INSERT INTO channel_memory_chunks_fts(channel_memory_chunks_fts, rowid, summary, room_id)
+            VALUES ('delete', old.rowid, old.summary, old.room_id);
+        END;
+      `);
+        }
+        catch (err) {
+            logger.warn(`[ChannelMemoryRepo] FTS5 bootstrap failed; search will use LIKE fallback. ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    insertChunk(chunk) {
+        this.db
+            .prepare(`INSERT INTO channel_memory_chunks (
+          id, room_id, summary, from_event_id, to_event_id, from_ts, to_ts,
+          message_count, participants_json, thread_ids_json, tier, created_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(chunk.id, chunk.roomId, chunk.summary, chunk.fromEventId, chunk.toEventId, chunk.fromTimestamp, chunk.toTimestamp, chunk.messageCount, JSON.stringify(chunk.participants), JSON.stringify(chunk.threadIds), chunk.tier, chunk.createdAt);
+    }
+    recentChunks(roomId, limit, tier = 1) {
+        const rows = this.db
+            .prepare(`SELECT * FROM channel_memory_chunks
+           WHERE room_id = ? AND tier = ?
+           ORDER BY to_ts DESC
+           LIMIT ?`)
+            .all(roomId, tier, limit);
+        return rows.map(this.rowToChunk);
+    }
+    oldestChunks(roomId, limit) {
+        const rows = this.db
+            .prepare(`SELECT * FROM channel_memory_chunks
+           WHERE room_id = ?
+           ORDER BY to_ts ASC
+           LIMIT ?`)
+            .all(roomId, limit);
+        return rows.map(this.rowToChunk);
+    }
+    countChunks(roomId) {
+        const row = this.db
+            .prepare(`SELECT COUNT(*) AS n FROM channel_memory_chunks WHERE room_id = ?`)
+            .get(roomId);
+        return row?.n ?? 0;
+    }
+    /**
+     * Find tier=N chunks older than `olderThanTs` and return them grouped into
+     * fixed time buckets (week or month). Used by the tier scheduler to roll
+     * granular tier-1 chunks into a tier-2 weekly summary, then tier-2 into
+     * tier-3 monthly summaries.
+     */
+    findRollupCandidates(roomId, args) {
+        const rows = this.db
+            .prepare(`SELECT * FROM channel_memory_chunks
+           WHERE room_id = ? AND tier = ? AND to_ts < ?
+           ORDER BY to_ts ASC`)
+            .all(roomId, args.sourceTier, args.olderThanTs);
+        if (rows.length === 0)
+            return [];
+        const buckets = new Map();
+        for (const row of rows) {
+            const chunk = this.rowToChunk(row);
+            const bucketKey = Math.floor(chunk.toTimestamp / args.bucketMs) * args.bucketMs;
+            const list = buckets.get(bucketKey) ?? [];
+            list.push(chunk);
+            buckets.set(bucketKey, list);
+        }
+        const candidates = [];
+        for (const [bucketKey, chunks] of buckets.entries()) {
+            if (chunks.length < args.minChunksPerBucket)
+                continue;
+            candidates.push({
+                windowStart: bucketKey,
+                windowEnd: bucketKey + args.bucketMs,
+                toTier: args.sourceTier + 1,
+                chunks,
+            });
+        }
+        return candidates;
+    }
+    /**
+     * Atomically delete a list of source chunks and insert a rollup. Used by the
+     * tier scheduler — keeps the DB consistent if the process is interrupted
+     * mid-rollup.
+     */
+    replaceWithRollup(sourceIds, rollup) {
+        const tx = this.db.transaction((ids, chunk) => {
+            const del = this.db.prepare(`DELETE FROM channel_memory_chunks WHERE id = ?`);
+            for (const id of ids)
+                del.run(id);
+            this.insertChunk(chunk);
+        });
+        tx(sourceIds, rollup);
+    }
+    searchChunks(roomId, query, limit) {
+        const trimmed = query.trim();
+        if (!trimmed)
+            return this.recentChunks(roomId, limit);
+        const words = trimmed.split(/\s+/).filter(Boolean);
+        const ftsQuery = words.length > 1 ? words.join(' OR ') : trimmed;
+        try {
+            const rows = this.db
+                .prepare(`SELECT c.* FROM channel_memory_chunks c
+             JOIN channel_memory_chunks_fts f ON f.rowid = c.rowid
+             WHERE c.room_id = ? AND channel_memory_chunks_fts MATCH ?
+             ORDER BY rank LIMIT ?`)
+                .all(roomId, ftsQuery, limit);
+            return rows.map(this.rowToChunk);
+        }
+        catch (err) {
+            logger.debug?.(`[ChannelMemoryRepo] FTS query failed (${err instanceof Error ? err.message : String(err)}); falling back to LIKE`);
+            const likeConditions = words
+                .map(() => `summary LIKE ? ESCAPE '\\'`)
+                .join(' AND ');
+            const likeValues = words.map((w) => `%${w.replace(/[%_]/g, (c) => `\\${c}`)}%`);
+            const rows = this.db
+                .prepare(`SELECT * FROM channel_memory_chunks
+             WHERE room_id = ? AND ${likeConditions}
+             ORDER BY to_ts DESC LIMIT ?`)
+                .all(roomId, ...likeValues, limit);
+            return rows.map(this.rowToChunk);
+        }
+    }
+    insertPinnedFact(fact) {
+        this.db
+            .prepare(`INSERT INTO channel_pinned_facts (
+          id, room_id, fact, pinned_by_did, source_event_id, created_at
+        ) VALUES (?, ?, ?, ?, ?, ?)`)
+            .run(fact.id, fact.roomId, fact.fact, fact.pinnedByDid, fact.sourceEventId ?? null, fact.createdAt);
+    }
+    listPinnedFacts(roomId, limit = 100) {
+        const rows = this.db
+            .prepare(`SELECT * FROM channel_pinned_facts
+           WHERE room_id = ?
+           ORDER BY created_at DESC
+           LIMIT ?`)
+            .all(roomId, limit);
+        return rows.map(this.rowToFact);
+    }
+    deletePinnedFact(roomId, factId) {
+        const result = this.db
+            .prepare(`DELETE FROM channel_pinned_facts WHERE room_id = ? AND id = ?`)
+            .run(roomId, factId);
+        return result.changes > 0;
+    }
+    upsertMembers(roomId, members) {
+        this.db
+            .prepare(`INSERT INTO channel_meta (room_id, members_json, updated_at)
+         VALUES (?, ?, ?)
+         ON CONFLICT(room_id) DO UPDATE SET
+           members_json = excluded.members_json,
+           updated_at   = excluded.updated_at`)
+            .run(roomId, JSON.stringify(members), Date.now());
+    }
+    getMembers(roomId) {
+        const row = this.db
+            .prepare(`SELECT members_json FROM channel_meta WHERE room_id = ?`)
+            .get(roomId);
+        if (!row?.members_json)
+            return [];
+        try {
+            const parsed = JSON.parse(row.members_json);
+            if (!Array.isArray(parsed))
+                return [];
+            return parsed.filter((m) => !!m &&
+                typeof m === 'object' &&
+                typeof m.matrixUserId === 'string' &&
+                typeof m.displayName === 'string');
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Force the SQLite WAL to disk before snapshot / upload, so the file on
+     * disk reflects every committed transaction. Cheap; safe to call often.
+     */
+    checkpoint() {
+        try {
+            this.db.pragma('wal_checkpoint(TRUNCATE)');
+        }
+        catch (err) {
+            logger.warn(`[ChannelMemoryRepo] WAL checkpoint failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** List every room this DB has ever stored data for. */
+    listRoomIds() {
+        const rows = this.db
+            .prepare(`SELECT DISTINCT room_id FROM channel_memory_chunks
+         UNION
+         SELECT DISTINCT room_id FROM channel_meta`)
+            .all();
+        return rows.map((r) => r.room_id);
+    }
+    close() {
+        try {
+            this.db.close();
+        }
+        catch (err) {
+            logger.warn(`[ChannelMemoryRepo] close failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    rowToChunk = (row) => ({
+        id: row.id,
+        roomId: row.room_id,
+        summary: row.summary,
+        fromEventId: row.from_event_id,
+        toEventId: row.to_event_id,
+        fromTimestamp: row.from_ts,
+        toTimestamp: row.to_ts,
+        messageCount: row.message_count,
+        participants: safeJsonArray(row.participants_json),
+        threadIds: safeJsonArray(row.thread_ids_json),
+        tier: row.tier ?? 1,
+        createdAt: row.created_at,
+    });
+    rowToFact = (row) => ({
+        id: row.id,
+        roomId: row.room_id,
+        fact: row.fact,
+        pinnedByDid: row.pinned_by_did,
+        sourceEventId: row.source_event_id ?? undefined,
+        createdAt: row.created_at,
+    });
+}
+function safeJsonArray(raw) {
+    if (typeof raw !== 'string' || !raw.length)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed)
+            ? parsed.filter((s) => typeof s === 'string')
+            : [];
+    }
+    catch {
+        return [];
+    }
+}