@ixo/oracle-runtime 0.0.1

package/dist/modules/messages/agent-builder.d.ts

@@ -0,0 +1,64 @@
+import { type BaseMessage } from 'langchain';
+import type { CompiledMainAgent } from '../../graph/main-agent-types.js';
+import type { TMainAgentGraphState } from '../../graph/state.js';
+import type { SendMessageRequest } from './messages.service.js';
+import { OracleRuntimeBundleHolder } from './oracle-runtime-bundle.js';
+import { type PreparedRequest } from './request-preparer.js';
+import { UserContextFetcher } from './user-context-fetcher.js';
+export interface BuildAgentArgs {
+    payload: SendMessageRequest;
+    prepared: PreparedRequest;
+    inputMessages: BaseMessage[];
+}
+export interface BuiltAgent {
+    agent: CompiledMainAgent;
+    stateInput: Partial<TMainAgentGraphState>;
+    /**
+     * Config passed as the 2nd argument to `agent.streamEvents` /
+     * `agent.invoke`. `version: 'v2'` is REQUIRED for streaming — without it
+     * langchain defaults to v1 (or emits nothing) and the SSE connection
+     * hangs with no events on the wire. `streamMode` + `recursionLimit`
+     * match the apps/app reference values.
+     *
+     * Typed loosely (`Record<string, unknown>`) because langchain's
+     * `streamEvents` config union doesn't perfectly intersect with the
+     * langgraph-specific options we pass.
+     */
+    langGraphConfig: Record<string, unknown>;
+}
+/**
+ * Bridges a prepared HTTP request into a compiled `ReactAgent` ready to
+ * stream or invoke.
+ *
+ * The checkpointer is supplied by the bundle's hooks — populated by
+ * `createOracleApp` and NOT overridden here. Forks that pass a custom
+ * `hooks.checkpointerForUser` to `createOracleApp` keep their override;
+ * the runtime's per-user SQLite saver is the default fallback.
+ *
+ * `userContext` (Memory Engine batch) and `userPreferences` (Matrix room
+ * state) are fetched HERE — before `createMainAgent` — and merged into the
+ * build-time state so the system prompt includes them on turn 1.
+ * `UserContextFetcher` caches per room for 3 minutes; `UserPreferencesService`
+ * caches internally too. Both fall through to `priorState` if the fetch
+ * fails or the upstream is unconfigured.
+ *
+ * Reads the prior checkpoint for OTHER build-time decisions: which
+ * on-demand plugins are loaded (`state.loadedPlugins`) and the remembered
+ * `currentEntityDid`. Without this preload, the first turn after restart
+ * would expose no on-demand plugins.
+ *
+ * Per-request overrides from the payload (`metadata.editorRoomId`,
+ * `metadata.spaceId`, `metadata.currentEntityDid`, `tools`, `agActions`)
+ * win over the checkpointed values — both in the build-time state used by
+ * `createMainAgent` and in the `stateInput` fed to `invoke` /
+ * `streamEvents`. The annotation-state reducers persist the new values
+ * on the next checkpoint.
+ */
+export declare class AgentBuilder {
+    private readonly bundleHolder;
+    private readonly userContextFetcher;
+    private readonly logger;
+    constructor(bundleHolder: OracleRuntimeBundleHolder, userContextFetcher: UserContextFetcher);
+    build(args: BuildAgentArgs, abortController?: AbortController): Promise<BuiltAgent>;
+}
+//# sourceMappingURL=agent-builder.d.ts.map

package/dist/modules/messages/agent-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-builder.d.ts","sourceRoot":"","sources":["../../../src/modules/messages/agent-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1C;;;;;;;;;;OAUG;IACH,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAJrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;gBAGrC,YAAY,EAAE,yBAAyB,EACvC,kBAAkB,EAAE,kBAAkB;IAGnD,KAAK,CACT,IAAI,EAAE,cAAc,EACpB,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,UAAU,CAAC;CA6LvB"}

package/dist/modules/messages/agent-builder.js

@@ -0,0 +1,219 @@
+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 AgentBuilder_1;
+import { Injectable, Logger } from '@nestjs/common';
+import { createMainAgent } from '../../graph/main-agent.js';
+import { UserPreferencesService } from '../../plugins/user-preferences/service/user-preferences.service.js';
+import { OracleRuntimeBundleHolder } from './oracle-runtime-bundle.js';
+import { UserContextFetcher } from './user-context-fetcher.js';
+/**
+ * Bridges a prepared HTTP request into a compiled `ReactAgent` ready to
+ * stream or invoke.
+ *
+ * The checkpointer is supplied by the bundle's hooks — populated by
+ * `createOracleApp` and NOT overridden here. Forks that pass a custom
+ * `hooks.checkpointerForUser` to `createOracleApp` keep their override;
+ * the runtime's per-user SQLite saver is the default fallback.
+ *
+ * `userContext` (Memory Engine batch) and `userPreferences` (Matrix room
+ * state) are fetched HERE — before `createMainAgent` — and merged into the
+ * build-time state so the system prompt includes them on turn 1.
+ * `UserContextFetcher` caches per room for 3 minutes; `UserPreferencesService`
+ * caches internally too. Both fall through to `priorState` if the fetch
+ * fails or the upstream is unconfigured.
+ *
+ * Reads the prior checkpoint for OTHER build-time decisions: which
+ * on-demand plugins are loaded (`state.loadedPlugins`) and the remembered
+ * `currentEntityDid`. Without this preload, the first turn after restart
+ * would expose no on-demand plugins.
+ *
+ * Per-request overrides from the payload (`metadata.editorRoomId`,
+ * `metadata.spaceId`, `metadata.currentEntityDid`, `tools`, `agActions`)
+ * win over the checkpointed values — both in the build-time state used by
+ * `createMainAgent` and in the `stateInput` fed to `invoke` /
+ * `streamEvents`. The annotation-state reducers persist the new values
+ * on the next checkpoint.
+ */
+let AgentBuilder = AgentBuilder_1 = class AgentBuilder {
+    bundleHolder;
+    userContextFetcher;
+    logger = new Logger(AgentBuilder_1.name);
+    constructor(bundleHolder, userContextFetcher) {
+        this.bundleHolder = bundleHolder;
+        this.userContextFetcher = userContextFetcher;
+    }
+    async build(args, abortController) {
+        const { payload, prepared, inputMessages } = args;
+        const bundle = this.bundleHolder.get();
+        const hooks = bundle.hooks ?? {};
+        // ────────────────────────────────────────────────────────────────────
+        // Prior state from the checkpoint — used for build-time decisions that
+        // must survive restarts: `loadedPlugins` (so on-demand capabilities
+        // don't need to be re-loaded each session) and `currentEntityDid`.
+        // We read via `checkpointer.getTuple(config)` — the same call
+        // LangGraph itself makes inside `agent.getState()`. Between invokes
+        // there are no pending writes so the tuple's `channel_values` matches
+        // what `getState().values` would return; reading directly skips a
+        // redundant agent rebuild + state-snapshot materialization.
+        // ────────────────────────────────────────────────────────────────────
+        let checkpointer;
+        if (hooks.checkpointerForUser) {
+            checkpointer = await hooks.checkpointerForUser(payload.did);
+        }
+        let priorState = {};
+        if (checkpointer) {
+            try {
+                const tuple = await checkpointer.getTuple({
+                    configurable: { thread_id: prepared.langchainThreadId },
+                });
+                const channelValues = tuple?.checkpoint?.channel_values;
+                if (channelValues)
+                    priorState = channelValues;
+            }
+            catch {
+                // First message in a thread — no prior tuple. Continue with empty state.
+            }
+        }
+        // ────────────────────────────────────────────────────────────────────
+        // Fetch userContext + userPreferences BEFORE building the agent so the
+        // system prompt sees both on turn 1. The previous middleware approach
+        // wrote them mid-run, by which point the prompt was already locked.
+        // Both are best-effort: failures fall through to checkpointed values
+        // and the agent still works without enrichment.
+        // ────────────────────────────────────────────────────────────────────
+        this.logger.log(`[AgentBuilder] resolving prompt enrichments — roomId=${prepared.roomId}, did=${payload.did}`);
+        const userPrefsService = UserPreferencesService.getInstance();
+        const [freshUserContext, freshUserPreferences] = await Promise.all([
+            this.userContextFetcher
+                .fetch({
+                roomId: prepared.roomId,
+                userDid: payload.did,
+                sessionId: prepared.sessionId,
+            })
+                .catch((err) => {
+                this.logger.warn(`[AgentBuilder] userContext fetch failed: ${err instanceof Error ? err.message : String(err)}`);
+                return undefined;
+            }),
+            userPrefsService.get(prepared.roomId).catch((err) => {
+                this.logger.warn(`[AgentBuilder] userPreferences fetch failed: ${err instanceof Error ? err.message : String(err)}`);
+                return undefined;
+            }),
+        ]);
+        const userContext = freshUserContext ?? priorState.userContext;
+        const userPreferences = freshUserPreferences ?? priorState.userPreferences;
+        this.logger.log(`[AgentBuilder] prompt enrichments resolved — userContext: ${freshUserContext
+            ? `fresh (${Object.keys(freshUserContext).length} keys)`
+            : priorState.userContext
+                ? `checkpoint (${Object.keys(priorState.userContext).length} keys)`
+                : 'none'}, userPreferences: ${freshUserPreferences
+            ? 'fresh'
+            : priorState.userPreferences
+                ? 'checkpoint'
+                : 'none'}`);
+        const clientType = payload.clientType ?? 'portal';
+        const ucanDelegation = payload.ucanDelegation
+            ? {
+                raw: payload.ucanDelegation.raw,
+                issuer: payload.ucanDelegation.issuer,
+                audience: payload.ucanDelegation.audience,
+                // Translate UCAN spec naming (`can`/`with`) to the plugin-API
+                // naming (`action`/`resource`). `nb` (caveats) is dropped here
+                // — plugins that need caveats can read `raw` and re-parse.
+                capabilities: payload.ucanDelegation.capabilities
+                    .map((c) => c)
+                    .map((c) => ({
+                    action: c.can ?? '',
+                    resource: c.with ?? '',
+                })),
+            }
+            : {
+                // Matrix listener path has no per-user UCAN — the bot acts as
+                // the oracle, not as a user. Plugins that need a delegation
+                // should branch on `raw.length === 0` and skip the mint.
+                raw: '',
+            };
+        const requestCtx = {
+            user: {
+                did: payload.did,
+                matrixUserId: `@did-${payload.did.replace(/:/g, '-')}:${prepared.homeServerName}`,
+                ucanDelegation,
+                timezone: prepared.timezone,
+                currentTime: prepared.currentTime,
+            },
+            session: {
+                id: prepared.sessionId,
+                client: clientType,
+                requestId: prepared.requestId,
+                roomId: prepared.roomId,
+            },
+            history: { userContext },
+        };
+        const buildTimeState = {
+            ...priorState,
+            userContext,
+            userPreferences,
+            editorRoomId: payload.metadata?.editorRoomId ?? priorState.editorRoomId,
+            spaceId: payload.metadata?.spaceId ?? priorState.spaceId,
+            currentEntityDid: payload.metadata?.currentEntityDid ?? priorState.currentEntityDid,
+            browserTools: payload.tools ?? priorState.browserTools,
+            agActions: payload.agActions ?? priorState.agActions,
+        };
+        const agent = await createMainAgent({
+            registries: bundle.registries,
+            identity: bundle.identity,
+            config: bundle.config,
+            availablePlugins: bundle.availablePlugins,
+            hooks,
+            ambient: bundle.ambient,
+            requestCtx,
+            state: buildTimeState,
+        });
+        const stateInput = {
+            messages: inputMessages,
+            config: { did: payload.did },
+            client: clientType,
+            ...(userContext !== undefined && { userContext }),
+            ...(userPreferences !== undefined && { userPreferences }),
+            ...(payload.metadata?.editorRoomId !== undefined && {
+                editorRoomId: payload.metadata.editorRoomId,
+            }),
+            ...(payload.metadata?.spaceId !== undefined && {
+                spaceId: payload.metadata.spaceId,
+            }),
+            ...(payload.metadata?.currentEntityDid !== undefined && {
+                currentEntityDid: payload.metadata.currentEntityDid,
+            }),
+            ...(payload.tools !== undefined && { browserTools: payload.tools }),
+            ...(payload.agActions !== undefined && { agActions: payload.agActions }),
+        };
+        // `version: 'v2'` is REQUIRED for `agent.streamEvents` to emit the
+        // `{event, data, tags}` envelope the SSE loop expects. Without it,
+        // langchain defaults to v1 (or emits nothing) and the FE sees a
+        // hanging connection with no events. `streamMode` + `recursionLimit`
+        // mirror the apps/app reference. Typed `Record<string, unknown>`
+        // because the langchain streamEvents config union doesn't perfectly
+        // intersect with the langgraph-specific options here.
+        const langGraphConfig = {
+            version: 'v2',
+            streamMode: ['updates', 'messages'],
+            recursionLimit: 150,
+            configurable: prepared.runnableConfig.configurable,
+            context: requestCtx,
+            ...(abortController && { signal: abortController.signal }),
+        };
+        return { agent, stateInput, langGraphConfig };
+    }
+};
+AgentBuilder = AgentBuilder_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [OracleRuntimeBundleHolder,
+        UserContextFetcher])
+], AgentBuilder);
+export { AgentBuilder };

package/dist/modules/messages/batch-invoker.d.ts

@@ -0,0 +1,36 @@
+import { type ListOracleMessagesResponse } from '@ixo/common';
+import { type BaseMessage } from 'langchain';
+import { AgentBuilder } from './agent-builder.js';
+import { type SendMessagePayload } from './dto/send-message.dto.js';
+import { type PreparedRequest } from './request-preparer.js';
+export interface BatchInvokeInput {
+    payload: SendMessagePayload & {
+        msgFromMatrixRoom?: boolean;
+        clientType?: 'matrix' | 'slack' | 'portal';
+    };
+    prepared: PreparedRequest;
+    inputMessages: BaseMessage[];
+}
+export interface BatchInvokeResult {
+    message: {
+        type: string;
+        content: string;
+        id: string;
+    };
+    sessionId: string;
+    messages?: ListOracleMessagesResponse['messages'];
+}
+/**
+ * Non-streaming chat path: builds the agent, invokes it once, returns the
+ * last assistant message.
+ *
+ * Mirrors the streaming runner's agent-build contract so adding state
+ * fields (browser tools, AG-UI actions, editor room, etc.) automatically
+ * applies to both paths — same AgentBuilder, same per-request state shape.
+ */
+export declare class BatchInvoker {
+    private readonly agentBuilder;
+    constructor(agentBuilder: AgentBuilder);
+    invoke(input: BatchInvokeInput): Promise<BatchInvokeResult>;
+}
+//# sourceMappingURL=batch-invoker.d.ts.map

package/dist/modules/messages/batch-invoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-invoker.d.ts","sourceRoot":"","sources":["../../../src/modules/messages/batch-invoker.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,kBAAkB,GAAG;QAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;KAC5C,CAAC;IACF,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,0BAA0B,CAAC,UAAU,CAAC,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,qBACa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAEjD,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAmClE"}

package/dist/modules/messages/batch-invoker.js

@@ -0,0 +1,58 @@
+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);
+};
+import { transformGraphStateMessageToListMessageResponse, } from '@ixo/common';
+import { BadRequestException, Injectable } from '@nestjs/common';
+import { AgentBuilder } from './agent-builder.js';
+/**
+ * Non-streaming chat path: builds the agent, invokes it once, returns the
+ * last assistant message.
+ *
+ * Mirrors the streaming runner's agent-build contract so adding state
+ * fields (browser tools, AG-UI actions, editor room, etc.) automatically
+ * applies to both paths — same AgentBuilder, same per-request state shape.
+ */
+let BatchInvoker = class BatchInvoker {
+    agentBuilder;
+    constructor(agentBuilder) {
+        this.agentBuilder = agentBuilder;
+    }
+    async invoke(input) {
+        const { payload, prepared, inputMessages } = input;
+        const { agent, stateInput, langGraphConfig } = await this.agentBuilder.build({ payload, prepared, inputMessages });
+        // The shared config from AgentBuilder is tuned for `streamEvents`
+        // (`version: 'v2'`, `streamMode: ['updates','messages']`). Passing a
+        // non-'values' streamMode to `.invoke()` makes LangGraph return the
+        // accumulated stream chunks (Array<[mode, data]>) instead of the final
+        // state — strip those keys here so invoke returns TMainAgentGraphState.
+        const { streamMode: _sm, version: _v, ...invokeConfig } = langGraphConfig;
+        const result = await agent.invoke(stateInput, invokeConfig);
+        const messages = result.messages;
+        const lastMessage = messages?.at(-1);
+        if (!lastMessage) {
+            throw new BadRequestException('No message returned from the oracle');
+        }
+        return {
+            message: {
+                type: lastMessage.type,
+                content: String(lastMessage.content),
+                id: lastMessage.id ?? '',
+            },
+            sessionId: prepared.sessionId,
+            ...(payload.returnAllMessages && {
+                messages: transformGraphStateMessageToListMessageResponse(messages).messages,
+            }),
+        };
+    }
+};
+BatchInvoker = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [AgentBuilder])
+], BatchInvoker);
+export { BatchInvoker };

package/dist/modules/messages/dto/list-messages.dto.d.ts

@@ -0,0 +1,4 @@
+export declare class ListMessagesDto {
+    sessionId: string;
+}
+//# sourceMappingURL=list-messages.dto.d.ts.map

package/dist/modules/messages/dto/list-messages.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-messages.dto.d.ts","sourceRoot":"","sources":["../../../../src/modules/messages/dto/list-messages.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,eAAe;IAE1B,SAAS,EAAG,MAAM,CAAC;CACpB"}

package/dist/modules/messages/dto/list-messages.dto.js

@@ -0,0 +1,17 @@
+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);
+};
+import { ApiProperty } from '@nestjs/swagger';
+export class ListMessagesDto {
+    sessionId;
+}
+__decorate([
+    ApiProperty(),
+    __metadata("design:type", String)
+], ListMessagesDto.prototype, "sessionId", void 0);

package/dist/modules/messages/dto/send-message.dto.d.ts

@@ -0,0 +1,73 @@
+import { type ListOracleMessagesResponse } from '@ixo/common';
+export declare class BrowserToolCallDto {
+    name: string;
+    schema: Record<string, unknown>;
+    description: string;
+}
+export declare class AgActionDto {
+    name: string;
+    description: string;
+    schema: Record<string, unknown>;
+    hasRender?: boolean;
+}
+export declare class AttachmentDto {
+    mxcUri?: string;
+    eventId?: string;
+    filename: string;
+    mimetype: string;
+    size?: number;
+}
+export declare class SendMessageDto {
+    stream?: boolean;
+    returnAllMessages?: boolean;
+    message: string;
+    tools?: BrowserToolCallDto[];
+    agActions?: AgActionDto[];
+    metadata?: Record<string, unknown> & {
+        editorRoomId?: string;
+        spaceId?: string;
+    };
+    timezone?: string;
+    homeServer?: string;
+    mcpInvocations?: Record<string, string>;
+    attachments?: AttachmentDto[];
+}
+export declare class SendMessagePayload {
+    stream?: boolean;
+    returnAllMessages?: boolean;
+    message: string;
+    sessionId: string;
+    did: string;
+    tools?: BrowserToolCallDto[];
+    agActions?: AgActionDto[];
+    timezone?: string;
+    homeServer?: string;
+    metadata?: {
+        editorRoomId?: string;
+        currentEntityDid?: string;
+        spaceId?: string;
+    };
+    /**
+     * UCAN invocations for protected MCP tools.
+     * Map of tool names (e.g., "postgres__query") to base64-encoded CAR invocations.
+     */
+    mcpInvocations?: Record<string, string>;
+    attachments?: AttachmentDto[];
+}
+/**
+ * Shape returned by `POST /messages/:sessionId` when `stream` is false.
+ * `messages` is only present when the request set `returnAllMessages: true`.
+ */
+export interface SendMessageResponse {
+    message: {
+        type: string;
+        content: string;
+        id: string;
+    };
+    sessionId: string;
+    messages?: ListOracleMessagesResponse['messages'];
+}
+export declare class AbortRequestDto {
+    sessionId: string;
+}
+//# sourceMappingURL=send-message.dto.d.ts.map

package/dist/modules/messages/dto/send-message.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-message.dto.d.ts","sourceRoot":"","sources":["../../../../src/modules/messages/dto/send-message.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAkB9D,qBAAa,kBAAkB;IAQ7B,IAAI,EAAG,MAAM,CAAC;IASd,MAAM,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IASjC,WAAW,EAAG,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IAQtB,IAAI,EAAG,MAAM,CAAC;IASd,WAAW,EAAG,MAAM,CAAC;IASrB,MAAM,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IASjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,aAAa;IAcxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAahB,OAAO,CAAC,EAAE,MAAM,CAAC;IAWjB,QAAQ,EAAG,MAAM,CAAC;IAUlB,QAAQ,EAAG,MAAM,CAAC;IASlB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,cAAc;IASzB,MAAM,CAAC,EAAE,OAAO,CAAC;IAWjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAU5B,OAAO,EAAG,MAAM,CAAC;IAWjB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAW7B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAS1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QACnC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAUF,QAAQ,CAAC,EAAE,MAAM,CAAC;IASlB,UAAU,CAAC,EAAE,MAAM,CAAC;IAcpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAYxC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;CAC/B;AAED,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAG,MAAM,CAAC;IACjB,SAAS,EAAG,MAAM,CAAC;IACnB,GAAG,EAAG,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE;QACT,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,0BAA0B,CAAC,UAAU,CAAC,CAAC;CACnD;AAED,qBAAa,eAAe;IAQ1B,SAAS,EAAG,MAAM,CAAC;CACpB"}