@ixo/oracle-runtime 0.0.1

package/dist/modules/messages/messages.service.d.ts

@@ -0,0 +1,112 @@
+import { SessionManagerService, type ListOracleMessagesResponse } from '@ixo/common';
+import { type OnModuleInit } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import type { Request, Response } from 'express';
+import { UserMatrixSqliteSyncService } from '../../matrix/checkpointer/user-matrix-sqlite-sync-service.service.js';
+import { BatchInvoker } from './batch-invoker.js';
+import { type ListMessagesDto } from './dto/list-messages.dto.js';
+import { type SendMessagePayload, type SendMessageResponse } from './dto/send-message.dto.js';
+import { FileProcessingService } from './file-processing.service.js';
+import { MatrixListenerBridge } from './matrix-listener-bridge.js';
+import { PostMessageSyncer } from './post-message-syncer.js';
+import { RequestPreparer } from './request-preparer.js';
+import { SseStreamRunner } from './sse-stream-runner.js';
+/**
+ * Express-side auth shape (as set by `AuthHeaderMiddleware`). Mirrors the
+ * declaration-merged `Request.authData.ucanDelegation` so the controller
+ * can hand it down without translating UCAN's native `can`/`with` naming
+ * into the plugin-API's `action`/`resource` naming at the boundary.
+ * Translation lives in `AgentBuilder` where the value is actually consumed
+ * as a `UcanDelegation`.
+ */
+export interface AuthUcanDelegation {
+    raw: string;
+    issuer: string;
+    audience: string;
+    capabilities: unknown[];
+    expiration?: number;
+}
+export interface SendMessageRequest extends SendMessagePayload {
+    res?: Response;
+    req?: Request;
+    clientType?: 'matrix' | 'slack' | 'portal';
+    msgFromMatrixRoom?: boolean;
+    overrideLangchainThreadId?: string;
+    /**
+     * Authenticated UCAN delegation from `req.authData.ucanDelegation`.
+     * Threaded through to `requestCtx.user.ucanDelegation` so plugins can
+     * mint downstream invocations from the raw header. Absent on the Matrix
+     * listener path — the bot acts as the oracle, not as a user.
+     */
+    ucanDelegation?: AuthUcanDelegation;
+    /** Sender's full Matrix user id (e.g. `@alice:matrix.example`). */
+    senderMatrixUserId?: string;
+    /** Matrix event id of the latest text event the user sent. */
+    matrixEventId?: string;
+    /** Raw `m.mentions` payload from the Matrix event, used by group-chat gating. */
+    matrixMentions?: {
+        user_ids?: string[];
+    };
+    /** Raw `m.relates_to` payload, used to detect reply-to-bot. */
+    matrixRelatesTo?: {
+        'm.in_reply_to'?: {
+            event_id: string;
+        };
+    };
+    /** Room id (mirrors the bridge call) — used for display-name + roomInfo lookups. */
+    matrixRoomId?: string;
+}
+type SendMessageReply = SendMessageResponse;
+/**
+ * Public entry point for the chat HTTP surface. Owns:
+ *
+ *   - the AbortController registry (one in-flight stream per session)
+ *   - the cross-cutting "Matrix replay of the user's text" fire-and-forget
+ *   - delegation to `RequestPreparer` → (`SseStreamRunner` |
+ *     `BatchInvoker`) → `PostMessageSyncer`
+ *
+ * The Matrix listener bridge calls back into `sendMessage({ clientType:
+ * 'matrix' })` for the matrix-room ingress path. That keeps the chat code
+ * path linear: every request, regardless of source, lands here.
+ */
+export declare class MessagesService implements OnModuleInit {
+    private readonly preparer;
+    private readonly streamer;
+    private readonly batchInvoker;
+    private readonly fileProcessing;
+    private readonly checkpointSync;
+    private readonly postSync;
+    private readonly matrixBridge;
+    private readonly sessions;
+    private readonly config;
+    private readonly logger;
+    private readonly abortControllers;
+    constructor(preparer: RequestPreparer, streamer: SseStreamRunner, batchInvoker: BatchInvoker, fileProcessing: FileProcessingService, checkpointSync: UserMatrixSqliteSyncService, postSync: PostMessageSyncer, matrixBridge: MatrixListenerBridge, sessions: SessionManagerService, config: ConfigService);
+    onModuleInit(): void;
+    abortRequest(sessionId: string): boolean;
+    listMessages(params: ListMessagesDto & {
+        did: string;
+        homeServer?: string;
+    }): Promise<ListOracleMessagesResponse>;
+    sendMessage(params: SendMessageRequest): Promise<SendMessageReply | undefined>;
+    private assembleInput;
+    /**
+     * Build the `content` and `additional_kwargs` for the HumanMessage that
+     * lands in graph state. For Matrix-originated turns this is where we:
+     *   - resolve the speaker's display name (via the existing 30-min cache
+     *     on `MatrixManager.getCachedDisplayName`)
+     *   - decide whether the room is a group (memberCount > 2) and prefix
+     *     the content with `[DisplayName]: ` if so — so the agent reads who
+     *     is speaking without any middleware mutating state mid-graph
+     *   - stash speaker + threading metadata + raw `m.mentions` /
+     *     `m.relates_to` on `additional_kwargs` for downstream consumers
+     *     (the group-chat gating middleware reads them)
+     *
+     * Non-Matrix turns (portal, slack) keep the prior behaviour: just
+     * `msgFromMatrixRoom` + `timestamp`.
+     */
+    private buildHumanMessageParts;
+    private firePostSync;
+}
+export {};
+//# sourceMappingURL=messages.service.d.ts.map

package/dist/modules/messages/messages.service.d.ts.map

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

package/dist/modules/messages/messages.service.js

@@ -0,0 +1,279 @@
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var MessagesService_1;
+import { SessionManagerService, transformGraphStateMessageToListMessageResponse, } from '@ixo/common';
+import { MatrixManager } from '@ixo/matrix';
+import { SqliteSaver } from '@ixo/sqlite-saver';
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { AIMessage, HumanMessage } from 'langchain';
+import { UserMatrixSqliteSyncService } from '../../matrix/checkpointer/user-matrix-sqlite-sync-service.service.js';
+import { BatchInvoker } from './batch-invoker.js';
+import { FileProcessingService } from './file-processing.service.js';
+import { MatrixListenerBridge } from './matrix-listener-bridge.js';
+import { PostMessageSyncer } from './post-message-syncer.js';
+import { RequestPreparer } from './request-preparer.js';
+import { SseStreamRunner } from './sse-stream-runner.js';
+/**
+ * Public entry point for the chat HTTP surface. Owns:
+ *
+ *   - the AbortController registry (one in-flight stream per session)
+ *   - the cross-cutting "Matrix replay of the user's text" fire-and-forget
+ *   - delegation to `RequestPreparer` → (`SseStreamRunner` |
+ *     `BatchInvoker`) → `PostMessageSyncer`
+ *
+ * The Matrix listener bridge calls back into `sendMessage({ clientType:
+ * 'matrix' })` for the matrix-room ingress path. That keeps the chat code
+ * path linear: every request, regardless of source, lands here.
+ */
+let MessagesService = MessagesService_1 = class MessagesService {
+    preparer;
+    streamer;
+    batchInvoker;
+    fileProcessing;
+    checkpointSync;
+    postSync;
+    matrixBridge;
+    sessions;
+    config;
+    logger = new Logger(MessagesService_1.name);
+    abortControllers = new Map();
+    constructor(preparer, streamer, batchInvoker, fileProcessing, checkpointSync, postSync, matrixBridge, sessions, config) {
+        this.preparer = preparer;
+        this.streamer = streamer;
+        this.batchInvoker = batchInvoker;
+        this.fileProcessing = fileProcessing;
+        this.checkpointSync = checkpointSync;
+        this.postSync = postSync;
+        this.matrixBridge = matrixBridge;
+        this.sessions = sessions;
+        this.config = config;
+    }
+    onModuleInit() {
+        this.matrixBridge.setDeliverHandler((msg) => this.sendMessage({
+            clientType: 'matrix',
+            message: msg.message,
+            did: msg.did,
+            sessionId: msg.threadId,
+            overrideLangchainThreadId: msg.langchainThreadId,
+            homeServer: msg.homeServer,
+            msgFromMatrixRoom: true,
+            senderMatrixUserId: msg.senderMatrixUserId,
+            matrixEventId: msg.eventId,
+            matrixMentions: msg.mentions,
+            matrixRelatesTo: msg.relatesTo,
+            matrixRoomId: msg.roomId,
+            ...(msg.attachments && { attachments: msg.attachments }),
+        }));
+    }
+    abortRequest(sessionId) {
+        const controller = this.abortControllers.get(sessionId);
+        if (!controller)
+            return false;
+        controller.abort();
+        this.abortControllers.delete(sessionId);
+        return true;
+    }
+    async listMessages(params) {
+        const { did, sessionId } = params;
+        this.preparer.validateSessionId(sessionId, did);
+        this.checkpointSync.markUserActive(did);
+        try {
+            const db = await this.checkpointSync.getUserDatabase(did);
+            const saver = SqliteSaver.fromDatabase(db);
+            const tuple = await saver.getTuple({
+                configurable: { thread_id: sessionId },
+            });
+            const messages = tuple?.checkpoint?.channel_values?.messages ?? [];
+            return transformGraphStateMessageToListMessageResponse(messages);
+        }
+        finally {
+            this.checkpointSync.markUserInactive(did);
+        }
+    }
+    async sendMessage(params) {
+        this.checkpointSync.markUserActive(params.did);
+        try {
+            const prepared = await this.preparer.prepare(params);
+            const inputMessages = await this.assembleInput(params, prepared);
+            const msgFromMatrixRoom = params.msgFromMatrixRoom ?? false;
+            if (!msgFromMatrixRoom) {
+                this.sessions.matrixManger
+                    .sendMessage({
+                    message: params.message,
+                    roomId: prepared.roomId,
+                    threadId: prepared.sessionId,
+                    isOracleAdmin: false,
+                })
+                    .catch((err) => this.logger.error('Matrix replay (user message) failed', err));
+            }
+            if (params.stream && params.res) {
+                await this.streamer.run({
+                    payload: { ...params },
+                    prepared,
+                    inputMessages,
+                    res: params.res,
+                    abortControllers: this.abortControllers,
+                    onComplete: (assistantText) => {
+                        if (!msgFromMatrixRoom && assistantText) {
+                            this.sessions.matrixManger
+                                .sendMessage({
+                                message: assistantText,
+                                roomId: prepared.roomId,
+                                threadId: prepared.sessionId,
+                                isOracleAdmin: true,
+                            })
+                                .catch((err) => this.logger.error('Matrix replay (AI response) failed', err));
+                        }
+                        this.firePostSync(params, prepared);
+                    },
+                });
+                return undefined;
+            }
+            const result = await this.batchInvoker.invoke({
+                payload: { ...params },
+                prepared,
+                inputMessages,
+            });
+            if (!msgFromMatrixRoom) {
+                this.sessions.matrixManger
+                    .sendMessage({
+                    message: result.message.content,
+                    roomId: prepared.roomId,
+                    threadId: prepared.sessionId,
+                    isOracleAdmin: true,
+                })
+                    .catch((err) => this.logger.error('Matrix replay (AI response) failed', err));
+            }
+            this.firePostSync(params, prepared);
+            return result;
+        }
+        finally {
+            this.checkpointSync.markUserInactive(params.did);
+        }
+    }
+    async assembleInput(params, prepared) {
+        const msgFromMatrixRoom = params.msgFromMatrixRoom ?? false;
+        const timestamp = new Date().toISOString();
+        const { content, additionalKwargs } = await this.buildHumanMessageParts(params, prepared, msgFromMatrixRoom, timestamp);
+        const out = [
+            new HumanMessage({
+                content,
+                additional_kwargs: additionalKwargs,
+            }),
+        ];
+        if (!params.attachments?.length)
+            return out;
+        this.logger.log(`sendMessage: ${params.attachments.length} attachment(s) for session ${prepared.sessionId}`);
+        const { texts, metadata } = await this.fileProcessing.processAttachments(params.attachments, prepared.roomId, params.did);
+        texts.forEach((text, i) => {
+            const meta = metadata[i];
+            if (!meta)
+                return;
+            const sourceRef = meta.eventId
+                ? `[source: eventId="${meta.eventId}"]`
+                : meta.mxcUri
+                    ? `[source: url="${meta.mxcUri}"]`
+                    : '';
+            const content = sourceRef ? `${sourceRef}\n${text}` : text;
+            out.push(new AIMessage({
+                content,
+                additional_kwargs: {
+                    msgFromMatrixRoom,
+                    timestamp: new Date().toISOString(),
+                    attachment: meta,
+                },
+            }));
+        });
+        return out;
+    }
+    /**
+     * Build the `content` and `additional_kwargs` for the HumanMessage that
+     * lands in graph state. For Matrix-originated turns this is where we:
+     *   - resolve the speaker's display name (via the existing 30-min cache
+     *     on `MatrixManager.getCachedDisplayName`)
+     *   - decide whether the room is a group (memberCount > 2) and prefix
+     *     the content with `[DisplayName]: ` if so — so the agent reads who
+     *     is speaking without any middleware mutating state mid-graph
+     *   - stash speaker + threading metadata + raw `m.mentions` /
+     *     `m.relates_to` on `additional_kwargs` for downstream consumers
+     *     (the group-chat gating middleware reads them)
+     *
+     * Non-Matrix turns (portal, slack) keep the prior behaviour: just
+     * `msgFromMatrixRoom` + `timestamp`.
+     */
+    async buildHumanMessageParts(params, prepared, msgFromMatrixRoom, timestamp) {
+        const baseKwargs = {
+            msgFromMatrixRoom,
+            timestamp,
+        };
+        if (!msgFromMatrixRoom || !params.senderMatrixUserId) {
+            return { content: params.message, additionalKwargs: baseKwargs };
+        }
+        const roomId = params.matrixRoomId ?? prepared.roomId;
+        const matrixManager = MatrixManager.getInstance();
+        const [displayName, roomInfo] = await Promise.all([
+            matrixManager
+                .getCachedDisplayName(params.senderMatrixUserId, roomId)
+                .catch((err) => {
+                this.logger.warn(`getCachedDisplayName failed for ${params.senderMatrixUserId}: ${err instanceof Error ? err.message : String(err)}`);
+                return params.senderMatrixUserId;
+            }),
+            matrixManager.getRoomInfo(roomId).catch((err) => {
+                this.logger.warn(`getRoomInfo failed for ${roomId}: ${err instanceof Error ? err.message : String(err)}`);
+                return undefined;
+            }),
+        ]);
+        const isGroupRoom = !!roomInfo && !roomInfo.isDirect && roomInfo.memberCount > 2;
+        const prefix = `[${displayName}]: `;
+        const content = isGroupRoom && !params.message.startsWith(prefix)
+            ? `${prefix}${params.message}`
+            : params.message;
+        const additionalKwargs = {
+            ...baseKwargs,
+            senderDid: params.did,
+            senderMatrixUserId: params.senderMatrixUserId,
+            senderDisplayName: displayName,
+            threadId: prepared.sessionId,
+        };
+        if (params.matrixEventId)
+            additionalKwargs.eventId = params.matrixEventId;
+        if (params.matrixMentions)
+            additionalKwargs['m.mentions'] = params.matrixMentions;
+        if (params.matrixRelatesTo)
+            additionalKwargs['m.relates_to'] = params.matrixRelatesTo;
+        return { content, additionalKwargs };
+    }
+    firePostSync(params, prepared) {
+        // Keep the user active for the duration of the fire-and-forget sync —
+        // the matching markUserInactive lives in PostMessageSyncer.
+        this.checkpointSync.markUserActive(params.did);
+        this.postSync.run({
+            did: params.did,
+            sessionId: prepared.sessionId,
+            langchainThreadId: prepared.langchainThreadId,
+            roomId: prepared.roomId,
+            targetSession: prepared.targetSession,
+        });
+    }
+};
+MessagesService = MessagesService_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [RequestPreparer,
+        SseStreamRunner,
+        BatchInvoker,
+        FileProcessingService,
+        UserMatrixSqliteSyncService,
+        PostMessageSyncer,
+        MatrixListenerBridge,
+        SessionManagerService,
+        ConfigService])
+], MessagesService);
+export { MessagesService };

package/dist/modules/messages/oracle-runtime-bundle.d.ts

@@ -0,0 +1,38 @@
+import type { MainAgentHooks } from '../../graph/main-agent-types.js';
+import type { MergedConfig, OracleIdentity } from '../../plugin-api/types.js';
+import type { ConfigSchemaRegistry, ManifestRegistry, MiddlewareRegistry, SharedStateRegistry, SubAgentRegistry, ToolRegistry } from '../../registries/index.js';
+import type { AmbientServices } from '../../runtime-context/ambient.js';
+/** Snapshot of everything `createMainAgent` needs at request time. */
+export interface OracleRuntimeBundle {
+    ambient: AmbientServices;
+    registries: {
+        tools: ToolRegistry;
+        subAgents: SubAgentRegistry;
+        middlewares: MiddlewareRegistry;
+        manifests: ManifestRegistry;
+        configSchema: ConfigSchemaRegistry;
+        sharedState: SharedStateRegistry;
+    };
+    identity: OracleIdentity;
+    config: MergedConfig;
+    availablePlugins: ReadonlySet<string>;
+    hooks?: MainAgentHooks;
+}
+/**
+ * Empty-at-construction Nest provider populated by `createOracleApp` once
+ * Nest's DI container is up and the ambient services are wired. Downstream
+ * services (MessagesService, etc.) inject the holder and read the bundle
+ * per request.
+ *
+ * The holder pattern exists because `AmbientServices` depends on Nest's DI
+ * (UcanService, SecretsService) but `RuntimeAppModule` has to register
+ * MessagesService BEFORE those services exist. The holder breaks the
+ * chicken-and-egg.
+ */
+export declare class OracleRuntimeBundleHolder {
+    private bundle;
+    populate(bundle: OracleRuntimeBundle): void;
+    get(): OracleRuntimeBundle;
+    isReady(): boolean;
+}
+//# sourceMappingURL=oracle-runtime-bundle.d.ts.map

package/dist/modules/messages/oracle-runtime-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-runtime-bundle.d.ts","sourceRoot":"","sources":["../../../src/modules/messages/oracle-runtime-bundle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE;QACV,KAAK,EAAE,YAAY,CAAC;QACpB,SAAS,EAAE,gBAAgB,CAAC;QAC5B,WAAW,EAAE,kBAAkB,CAAC;QAChC,SAAS,EAAE,gBAAgB,CAAC;QAC5B,YAAY,EAAE,oBAAoB,CAAC;QACnC,WAAW,EAAE,mBAAmB,CAAC;KAClC,CAAC;IACF,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,qBACa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAoC;IAElD,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAS3C,GAAG,IAAI,mBAAmB;IAS1B,OAAO,IAAI,OAAO;CAGnB"}

package/dist/modules/messages/oracle-runtime-bundle.js

@@ -0,0 +1,40 @@
+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 { Injectable } from '@nestjs/common';
+/**
+ * Empty-at-construction Nest provider populated by `createOracleApp` once
+ * Nest's DI container is up and the ambient services are wired. Downstream
+ * services (MessagesService, etc.) inject the holder and read the bundle
+ * per request.
+ *
+ * The holder pattern exists because `AmbientServices` depends on Nest's DI
+ * (UcanService, SecretsService) but `RuntimeAppModule` has to register
+ * MessagesService BEFORE those services exist. The holder breaks the
+ * chicken-and-egg.
+ */
+let OracleRuntimeBundleHolder = class OracleRuntimeBundleHolder {
+    bundle = null;
+    populate(bundle) {
+        if (this.bundle !== null) {
+            throw new Error('OracleRuntimeBundleHolder.populate called twice — bundle is single-shot.');
+        }
+        this.bundle = bundle;
+    }
+    get() {
+        if (this.bundle === null) {
+            throw new Error('OracleRuntimeBundleHolder.get called before populate — createOracleApp must run first.');
+        }
+        return this.bundle;
+    }
+    isReady() {
+        return this.bundle !== null;
+    }
+};
+OracleRuntimeBundleHolder = __decorate([
+    Injectable()
+], OracleRuntimeBundleHolder);
+export { OracleRuntimeBundleHolder };

package/dist/modules/messages/post-message-syncer.d.ts

@@ -0,0 +1,30 @@
+import { SessionManagerService, type ChatSession } from '@ixo/common';
+import { ConfigService } from '@nestjs/config';
+import { UserMatrixSqliteSyncService } from '../../matrix/checkpointer/user-matrix-sqlite-sync-service.service.js';
+export interface PostSyncInput {
+    did: string;
+    sessionId: string;
+    langchainThreadId: string;
+    roomId: string;
+    targetSession: ChatSession;
+}
+/**
+ * Fire-and-forget session sync that runs after each chat turn. Reads the
+ * just-written checkpoint via the cached SQLite connection (no Matrix
+ * re-sync — the connection is already warm from `RequestPreparer`) and
+ * mirrors the message list + lastProcessedCount into
+ * `SessionManagerService`.
+ *
+ * Ref-counted DB activity is handled by the caller via
+ * `markUserActive` / `markUserInactive` — this service just performs the
+ * read + write without juggling the counter.
+ */
+export declare class PostMessageSyncer {
+    private readonly checkpointSync;
+    private readonly sessions;
+    private readonly config;
+    private readonly logger;
+    constructor(checkpointSync: UserMatrixSqliteSyncService, sessions: SessionManagerService, config: ConfigService);
+    run(input: PostSyncInput): void;
+}
+//# sourceMappingURL=post-message-syncer.d.ts.map

package/dist/modules/messages/post-message-syncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-message-syncer.d.ts","sourceRoot":"","sources":["../../../src/modules/messages/post-message-syncer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sEAAsE,CAAC;AAEnH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,WAAW,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,qBACa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;gBAG1C,cAAc,EAAE,2BAA2B,EAC3C,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,EAAE,aAAa;IAGxC,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;CAgChC"}

package/dist/modules/messages/post-message-syncer.js

@@ -0,0 +1,73 @@
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var PostMessageSyncer_1;
+import { SessionManagerService, transformGraphStateMessageToListMessageResponse, } from '@ixo/common';
+import { SqliteSaver } from '@ixo/sqlite-saver';
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { UserMatrixSqliteSyncService } from '../../matrix/checkpointer/user-matrix-sqlite-sync-service.service.js';
+/**
+ * Fire-and-forget session sync that runs after each chat turn. Reads the
+ * just-written checkpoint via the cached SQLite connection (no Matrix
+ * re-sync — the connection is already warm from `RequestPreparer`) and
+ * mirrors the message list + lastProcessedCount into
+ * `SessionManagerService`.
+ *
+ * Ref-counted DB activity is handled by the caller via
+ * `markUserActive` / `markUserInactive` — this service just performs the
+ * read + write without juggling the counter.
+ */
+let PostMessageSyncer = PostMessageSyncer_1 = class PostMessageSyncer {
+    checkpointSync;
+    sessions;
+    config;
+    logger = new Logger(PostMessageSyncer_1.name);
+    constructor(checkpointSync, sessions, config) {
+        this.checkpointSync = checkpointSync;
+        this.sessions = sessions;
+        this.config = config;
+    }
+    run(input) {
+        void Promise.resolve().then(async () => {
+            try {
+                const db = await this.checkpointSync.getUserDatabaseNoSync(input.did);
+                const saver = SqliteSaver.fromDatabase(db);
+                const tuple = await saver.getTuple({
+                    configurable: { thread_id: input.langchainThreadId },
+                });
+                const messages = tuple?.checkpoint?.channel_values?.messages ?? [];
+                const transformed = transformGraphStateMessageToListMessageResponse(messages);
+                await this.sessions.syncSessionSet({
+                    sessionId: input.sessionId,
+                    oracleName: this.config.getOrThrow('ORACLE_NAME'),
+                    did: input.did,
+                    messages: transformed.messages.map((m) => m.content.toString()),
+                    oracleDid: this.config.getOrThrow('ORACLE_DID'),
+                    oracleEntityDid: this.config.getOrThrow('ORACLE_ENTITY_DID'),
+                    lastProcessedCount: input.targetSession?.lastProcessedCount ?? 0,
+                    roomId: input.roomId,
+                });
+            }
+            catch (error) {
+                this.logger.error('Failed to perform post-message sync', error);
+            }
+            finally {
+                this.checkpointSync.markUserInactive(input.did);
+            }
+        });
+    }
+};
+PostMessageSyncer = PostMessageSyncer_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [UserMatrixSqliteSyncService,
+        SessionManagerService,
+        ConfigService])
+], PostMessageSyncer);
+export { PostMessageSyncer };

package/dist/modules/messages/request-preparer.d.ts

@@ -0,0 +1,53 @@
+import { SessionManagerService, type ChatSession } from '@ixo/common';
+import { ConfigService } from '@nestjs/config';
+import type { Request } from 'express';
+import { UserMatrixSqliteSyncService } from '../../matrix/checkpointer/user-matrix-sqlite-sync-service.service.js';
+import { type SendMessagePayload } from './dto/send-message.dto.js';
+import { HomeServerCache } from './homeserver-cache.js';
+export interface RuntimeRequestConfig {
+    configurable: {
+        thread_id: string;
+        requestId: string;
+        sessionId: string;
+    };
+}
+export interface PreparedRequest {
+    sessionId: string;
+    langchainThreadId: string;
+    roomId: string;
+    homeServerName: string;
+    requestId: string;
+    runnableConfig: RuntimeRequestConfig;
+    targetSession: ChatSession;
+    timezone?: string;
+    currentTime?: string;
+}
+export type PrepareInput = SendMessagePayload & {
+    req?: Request;
+    overrideLangchainThreadId?: string;
+};
+/**
+ * Resolves everything the agent build needs from the incoming request:
+ *
+ *   - session lookup (parallel with the Matrix → SQLite sync triggered the
+ *     first time we see this user this process)
+ *   - room id resolution (uses the cached value when present, otherwise asks
+ *     Matrix)
+ *   - per-DID home-server cache
+ *   - timezone / current-time extraction
+ *   - the `runnableConfig` LangGraph needs for checkpointing
+ *
+ * Construction is hot-path code — every chat request runs this once.
+ */
+export declare class RequestPreparer {
+    private readonly sessions;
+    private readonly checkpointSync;
+    private readonly homeServerCache;
+    private readonly config;
+    constructor(sessions: SessionManagerService, checkpointSync: UserMatrixSqliteSyncService, homeServerCache: HomeServerCache, config: ConfigService);
+    prepare(payload: PrepareInput): Promise<PreparedRequest>;
+    validateSessionId(sessionId: string | undefined, did: string | undefined): void;
+    private resolveTimezone;
+    private formatTimeInTimezone;
+}
+//# sourceMappingURL=request-preparer.d.ts.map

package/dist/modules/messages/request-preparer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-preparer.d.ts","sourceRoot":"","sources":["../../../src/modules/messages/request-preparer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAMtE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,sEAAsE,CAAC;AACnH,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,oBAAoB,CAAC;IACrC,aAAa,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG;IAC9C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBACa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHN,QAAQ,EAAE,qBAAqB,EAC/B,cAAc,EAAE,2BAA2B,EAC3C,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,aAAa;IAGlC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAmE9D,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS;IAMxE,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,oBAAoB;CAoB7B"}