@nocobase/app-plugin-agents 0.1.0-beta.9 → 1.0.0-beta.16

package/dist/server/online/agent/native/session.js

@@ -0,0 +1,104 @@
+import { OnlineAgentResultError } from '../errors.js';
+import { nativeExecutionStatus } from '../persistence/state.js';
+import { createOutputSchema } from '../messages/validation.js';
+import { conflict, invalid } from '../../../kernel/errors.js';
+class NativeAgentSession {
+    host;
+    context;
+    boundary;
+    sessionId;
+    requestedOverrides;
+    requestedModel;
+    kind;
+    constructor(host, context, session, options, boundary) {
+        this.host = host;
+        this.context = context;
+        this.boundary = boundary;
+        this.sessionId = session.id;
+        this.kind = session.kind;
+        const { sessionId, selectedModel, source: _source, title: _title, showInChatList: _showInChatList, ...requested } = options;
+        this.requestedModel = sessionId ? selectedModel : undefined;
+        this.requestedOverrides =
+            sessionId && Object.keys(requested).length ? requested : undefined;
+        if (sessionId &&
+            (this.requestedOverrides || this.requestedModel) &&
+            (host.isActive(session.id) ||
+                session.call?.state === 'running' ||
+                session.call?.state === 'waitingApproval' ||
+                session.call?.closing)) {
+            throw conflict('This conversation is busy.');
+        }
+    }
+    async status() {
+        const row = await this.host.sessions.load(this.context.user.id, this.sessionId);
+        return nativeExecutionStatus(row.call, this.host.isActive(this.sessionId));
+    }
+    history() {
+        return this.host.sessions.native.history(this.context.user.id, this.sessionId);
+    }
+    abort() {
+        return this.host.abort(this.context, this.sessionId, this.kind);
+    }
+    retryFinalization() {
+        return this.host.retryFinalization(this.context, this.sessionId);
+    }
+    consumed() {
+        this.requestedOverrides = undefined;
+        this.requestedModel = undefined;
+    }
+}
+export class NativeRealtimeOnlineAgent extends NativeAgentSession {
+    backend = 'native';
+    responseExecution;
+    async send(messages, input) {
+        const seq = await this.host.start(this.context, this.sessionId, messages, {
+            ...input,
+            overrides: input?.overrides ?? this.requestedOverrides,
+            selectedModel: input?.selectedModel ?? this.requestedModel,
+            boundary: this.boundary,
+        }, undefined, (execution) => {
+            this.responseExecution = execution;
+        });
+        this.consumed();
+        return seq;
+    }
+    async receive() {
+        await this.host.sessions.load(this.context.user.id, this.sessionId);
+        return this.host.native.receive(this.context.user.id, this.sessionId, this.responseExecution);
+    }
+    approve(input) {
+        return this.host.approve(this.context, this.sessionId, input, (execution) => {
+            this.responseExecution = execution;
+        });
+    }
+    messages(query) {
+        return this.host.sessions.native.page(this.context.user.id, this.sessionId, query);
+    }
+}
+export class NativeBackgroundOnlineAgent extends NativeAgentSession {
+    async run(messages, schema, input) {
+        const output = createOutputSchema(schema);
+        await this.host.start(this.context, this.sessionId, messages, {
+            ...input,
+            overrides: input?.overrides ?? this.requestedOverrides,
+            selectedModel: input?.selectedModel ?? this.requestedModel,
+            boundary: this.boundary,
+        }, output);
+        this.consumed();
+    }
+    async get() {
+        const result = await this.host.observe(this.context.user.id, this.sessionId);
+        if (result.ok)
+            return result.data;
+        if (result.reason === 'pending')
+            throw conflict('The execution has not finished.');
+        throw new OnlineAgentResultError(result.reason, result.error);
+    }
+    try(options) {
+        const wait = options?.wait === undefined ? 0 : options.wait;
+        if (!Number.isFinite(wait) || wait < 0)
+            return Promise.reject(invalid('wait must be a finite non-negative number.'));
+        return this.host.observe(this.context.user.id, this.sessionId, wait);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/server/online/agent/native/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../../server/online/agent/native/session.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAe,kBAAkB;IAOnB;IACA;IAGA;IAVH,SAAS,CAAS;IACjB,kBAAkB,CAAiC;IACnD,cAAc,CAAuB;IAC9B,IAAI,CAA6B;IAElD,YACY,IAAuB,EACvB,OAA2B,EACrC,OAA2B,EAC3B,OAAmC,EACzB,QAA8B;QAJ9B,SAAI,GAAJ,IAAI,CAAmB;QACvB,YAAO,GAAP,OAAO,CAAoB;QAG3B,aAAQ,GAAR,QAAQ,CAAsB;QAExC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,MAAM,EACJ,SAAS,EACT,aAAa,EACb,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,eAAe,EAC/B,GAAG,SAAS,EACb,GAAG,OAAO,CAAC;QACZ,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,IAAI,CAAC,kBAAkB;YACrB,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,IACE,SAAS;YACT,CAAC,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,cAAc,CAAC;YAChD,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS;gBACjC,OAAO,CAAC,IAAI,EAAE,KAAK,KAAK,iBAAiB;gBACzC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EACxB,CAAC;YACD,MAAM,QAAQ,CAAC,4BAA4B,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EACpB,IAAI,CAAC,SAAS,CACf,CAAC;QACF,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CACtC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EACpB,IAAI,CAAC,SAAS,CACf,CAAC;IACJ,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;IAES,QAAQ;QAChB,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,yBACX,SAAQ,kBAAkB;IAGjB,OAAO,GAAG,QAAiB,CAAC;IAC7B,iBAAiB,CAAmC;IAE5D,KAAK,CAAC,IAAI,CACR,QAAwB,EACxB,KAA8B;QAE9B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAC/B,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,SAAS,EACd,QAAQ,EACR;YACE,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,EAAE,SAAS,IAAI,IAAI,CAAC,kBAAkB;YACtD,aAAa,EAAE,KAAK,EAAE,aAAa,IAAI,IAAI,CAAC,cAAc;YAC1D,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,EACD,SAAS,EACT,CAAC,SAAS,EAAE,EAAE;YACZ,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACrC,CAAC,CACF,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EACpB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,iBAAiB,CACvB,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAqB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,SAAS,EACd,KAAK,EACL,CAAC,SAAS,EAAE,EAAE;YACZ,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACrC,CAAC,CACF,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,KAAyB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EACpB,IAAI,CAAC,SAAS,EACd,KAAK,CACN,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,2BACX,SAAQ,kBAAkB;IAG1B,KAAK,CAAC,GAAG,CACP,QAAwB,EACxB,MAAmB,EACnB,KAAoE;QAEpE,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,SAAS,EACd,QAAQ,EACR;YACE,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,EAAE,SAAS,IAAI,IAAI,CAAC,kBAAkB;YACtD,aAAa,EAAE,KAAK,EAAE,aAAa,IAAI,IAAI,CAAC,cAAc;YAC1D,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,EACD,MAAM,CACP,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EACpB,IAAI,CAAC,SAAS,CACf,CAAC;QACF,IAAI,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAClC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAC7B,MAAM,QAAQ,CAAC,iCAAiC,CAAC,CAAC;QACpD,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,GAAG,CAAC,OAA2B;QAC7B,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;YACpC,OAAO,OAAO,CAAC,MAAM,CACnB,OAAO,CAAC,4CAA4C,CAAC,CACtD,CAAC;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/server/online/agent/native/types.d.ts

@@ -0,0 +1,32 @@
+import type { OnlineAgentResult } from '../types.js';
+export type NativeExecution = {
+    admitted?: boolean;
+    abort: AbortController;
+    task?: Promise<void>;
+    finalize?: () => Promise<void>;
+    finalizing?: Promise<void>;
+};
+export type Observation = {
+    result: OnlineAgentResult;
+} | {
+    error: unknown;
+};
+export type OnlineAgentExecution = {
+    admitted?: boolean;
+    observation?: Observation;
+    observers: Set<(value: Observation) => void>;
+    abort: AbortController;
+    task?: Promise<void>;
+    finalize?: () => Promise<void>;
+    finalizing?: Promise<void>;
+};
+export type NativeAcceptance = {
+    resolve(seq: number): void;
+    reject(error: unknown): void;
+};
+export type OnlineAgentAcceptance = {
+    promise: Promise<number>;
+    resolve(seq: number): void;
+    reject(error: unknown): void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/server/online/agent/native/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../server/online/agent/native/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AACF,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,CAAC;IAC7C,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B,CAAC"}

package/dist/server/online/agent/native/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/online/agent/native/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../server/online/agent/native/types.ts"],"names":[],"mappings":""}

package/dist/server/online/agent/persistence/manager.d.ts

@@ -0,0 +1,16 @@
+import type { TxRunner } from '../../../kernel/tx.js';
+import type { IdSource } from '../../../kernel/ids.js';
+import type { ChatAttachmentLinks, ChatAttachmentService } from '../../../core/conversations/attachments.js';
+import type { PageContextKinds } from '../../../core/conversations/page-context.js';
+import type { OnlineAgentSessionManager } from '../contracts.js';
+export declare function createSessionManager(deps: {
+    contextKinds?: PageContextKinds;
+    tx: TxRunner;
+    basePath?: () => string;
+    ids: IdSource;
+    attachments: ChatAttachmentLinks;
+    files?: Pick<ChatAttachmentService, 'content'>;
+    now(): string;
+    measure?: (phase: string, durationMs: number) => void;
+}): OnlineAgentSessionManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/server/online/agent/persistence/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../../server/online/agent/persistence/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAM,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAWvD,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAwBjE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,GAAG,EAAE,QAAQ,CAAC;IACd,WAAW,EAAE,mBAAmB,CAAC;IACjC,KAAK,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;IAC/C,GAAG,IAAI,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD,GAAG,yBAAyB,CAmO5B"}

package/dist/server/online/agent/persistence/manager.js

@@ -0,0 +1,209 @@
+import { asJson, jsonObject } from '../../../kernel/values.js';
+import { conflict, invalid, notFound } from '../../../kernel/errors.js';
+import { lockConversation, conversationsRepo, findConversation, preferencesRepo, settingsRepo, } from '../../../core/conversations/conversation.store.js';
+import { NativeSessionStore } from './store.js';
+import { sessionIdentity } from './state.js';
+function metadata(row) {
+    if (sessionIdentity(row).backend !== 'native')
+        throw invalid('A native OnlineAgent conversation is required.');
+    const found = jsonObject(row.metadata).onlineAgent;
+    if ('permissions' in found.config)
+        throw invalid('Permission-restricted configuration is not supported.');
+    return found;
+}
+function session(row) {
+    const value = metadata(row);
+    if (!row.model || !row.modelService)
+        throw invalid('Select a valid chat model.');
+    return {
+        id: row.id,
+        ...value,
+        lastSeq: Number(row.lastSeq),
+        model: { model: row.model, modelService: row.modelService },
+    };
+}
+export function createSessionManager(deps) {
+    const owned = async (conn, userId, id, lock = false) => {
+        const row = lock
+            ? await lockConversation(conn, id, deps.now())
+            : await findConversation(conn, id);
+        if (!row || row.userId !== userId)
+            throw notFound('Conversation');
+        return row;
+    };
+    const write = async (userId, id, phase, change) => {
+        let start;
+        try {
+            return await deps.tx.run(async ({ conn, emit }) => {
+                start = performance.now();
+                const row = await owned(conn, userId, id, true);
+                const result = await change(conn, row, emit);
+                emit({ type: 'conversation.changed', conversationId: id, userId });
+                return result;
+            });
+        }
+        finally {
+            if (start !== undefined)
+                deps.measure?.(phase, performance.now() - start);
+        }
+    };
+    const saveMetadata = (conn, row, value, extra = {}) => conversationsRepo(conn).updateMany({
+        filter: { id: row.id },
+        values: {
+            metadata: asJson({ ...jsonObject(row.metadata), onlineAgent: value }),
+            ...extra,
+        },
+    });
+    const native = new NativeSessionStore(deps);
+    return {
+        native,
+        async recoverAtStartup() {
+            const startedAt = new Date(performance.timeOrigin);
+            const stale = (row) => {
+                const value = jsonObject(row.metadata).onlineAgent;
+                return (!jsonObject(row.metadata).runnerOnlineAgent &&
+                    value?.version === 1 &&
+                    value.call?.state !== 'waitingApproval' &&
+                    new Date(row.updatedAt) < startedAt &&
+                    (value.call?.state === 'running' ||
+                        value.call?.closing ||
+                        value.call?.requiresEffectReview));
+            };
+            let cursor;
+            for (;;) {
+                let scan = deps.tx
+                    .read()
+                    .query.selectFrom('agConversations')
+                    .select('id')
+                    .where('mode', '=', 'online')
+                    .where('createdAt', '<', startedAt);
+                if (cursor !== undefined)
+                    scan = scan.where('id', '>', cursor);
+                const ids = await scan.orderBy('id').limit(200).execute();
+                if (!ids.length)
+                    break;
+                const rows = await conversationsRepo(deps.tx.read()).findMany({
+                    filter: (f) => f.or(ids.map((row) => f.string('id').eq(String(row.id)))),
+                    sort: (s) => s.field('id').asc(),
+                });
+                cursor = String(ids.at(-1).id);
+                for (const candidate of rows.filter(stale)) {
+                    await write(candidate.userId, candidate.id, 'startup', async (conn, row, emit) => {
+                        if (!stale(row))
+                            return;
+                        const value = metadata(row);
+                        const { closing: _closing, requiresEffectReview: _review, ...call } = value.call;
+                        if (!call.messageId)
+                            throw invalid('An internal UI message identity is required to recover this execution.');
+                        const unfinished = !call.outcome;
+                        const lastSeq = await native.recover(conn, row, call);
+                        await saveMetadata(conn, row, { ...value, call: { ...call, state: 'idle' } }, {
+                            lastSeq,
+                            ...(unfinished
+                                ? { read: false, lastMessageAt: deps.now() }
+                                : {}),
+                            updatedAt: deps.now(),
+                        });
+                        if (call.revision !== undefined)
+                            emit({
+                                type: 'conversation.changed',
+                                conversationId: row.id,
+                                userId: row.userId,
+                                messageId: call.messageId,
+                                revision: call.revision,
+                            });
+                    });
+                }
+                if (ids.length < 200)
+                    break;
+            }
+        },
+        async defaults(userId) {
+            const conn = deps.tx.read();
+            const [personal, system] = await Promise.all([
+                preferencesRepo(conn).findOne({ filter: { userId } }),
+                settingsRepo(conn).findOne({ filter: { key: 'chat' } }),
+            ]);
+            return {
+                ...jsonObject(jsonObject(system?.value).onlineAgent),
+                ...jsonObject(personal?.onlineAgent),
+            };
+        },
+        async create(userId, kind, config, model, info) {
+            const id = deps.ids.next();
+            const now = deps.now();
+            await deps.tx.run(async ({ conn, emit }) => {
+                await conversationsRepo(conn).createOne({
+                    values: {
+                        id,
+                        userId,
+                        mode: 'online',
+                        modelService: model.modelService,
+                        model: model.model,
+                        fallbackFromAgentId: null,
+                        title: info?.title ?? null,
+                        titleSource: info?.title ? 'user' : 'auto',
+                        category: 'chat',
+                        showInChatList: kind === 'background' ? false : (info?.showInChatList ?? true),
+                        source: info?.source ?? 'chat',
+                        read: true,
+                        thread: 0,
+                        lastSeq: 0,
+                        syncRunId: null,
+                        syncSeq: 0,
+                        lastMessageAt: now,
+                        archivedAt: null,
+                        lockedAt: null,
+                        createdAt: now,
+                        updatedAt: now,
+                        metadata: asJson({
+                            onlineAgent: { version: 1, kind, config, call: null },
+                        }),
+                    },
+                });
+                emit({ type: 'conversation.changed', conversationId: id, userId });
+            });
+            return id;
+        },
+        async identify(userId, id) {
+            return sessionIdentity(await owned(deps.tx.read(), userId, id));
+        },
+        async load(userId, id) {
+            return session(await owned(deps.tx.read(), userId, id));
+        },
+        async configure(userId, id, config, model) {
+            await write(userId, id, 'configure', async (conn, row) => {
+                const value = metadata(row);
+                if (value.call?.state === 'running' ||
+                    value.call?.state === 'waitingApproval' ||
+                    value.call?.closing)
+                    throw conflict('This conversation is busy.');
+                await saveMetadata(conn, row, { ...value, config }, {
+                    modelService: model.modelService,
+                    model: model.model,
+                    updatedAt: deps.now(),
+                });
+            });
+        },
+        async history(userId, id) {
+            return (await native.executionHistory(userId, id, undefined, false))
+                .model;
+        },
+        async executionHistory(userId, id, current) {
+            return (await native.executionHistory(userId, id, current)).model;
+        },
+        async finish(userId, id) {
+            await write(userId, id, 'finish', async (conn, row) => {
+                const value = metadata(row);
+                if (!value.call)
+                    throw conflict('No execution is being finalized.');
+                const { closing: _closing, requiresEffectReview: _review, ...call } = value.call;
+                await saveMetadata(conn, row, {
+                    ...value,
+                    call: { ...call, state: 'idle' },
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/server/online/agent/persistence/manager.js.map

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

package/dist/server/online/agent/persistence/state.d.ts

@@ -0,0 +1,11 @@
+import type { ConversationRecord } from '../../../core/conversations/conversation.store.js';
+import type { OnlineAgentSessionIdentity, RunnerOnlineAgentBinding } from './types.js';
+/** Classify persisted bindings without reading configuration through either execution backend. */
+export declare function sessionIdentity(row: ConversationRecord): OnlineAgentSessionIdentity;
+export declare function runnerBinding(metadata: unknown): RunnerOnlineAgentBinding | null;
+/** Shared native occupancy projection; callers supply their already-authorized persisted row. */
+export declare function nativeExecutionStatus(call: {
+    state?: unknown;
+    closing?: unknown;
+} | null | undefined, active: boolean): 'running' | 'idle';
+//# sourceMappingURL=state.d.ts.map

package/dist/server/online/agent/persistence/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../server/online/agent/persistence/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB,kGAAkG;AAClG,wBAAgB,eAAe,CAC7B,GAAG,EAAE,kBAAkB,GACtB,0BAA0B,CA6B5B;AACD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,GAChB,wBAAwB,GAAG,IAAI,CAKjC;AACD,iGAAiG;AACjG,wBAAgB,qBAAqB,CACnC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EAC/D,MAAM,EAAE,OAAO,GACd,SAAS,GAAG,MAAM,CAOpB"}

package/dist/server/online/agent/persistence/state.js

@@ -0,0 +1,45 @@
+import { jsonObject } from '../../../kernel/values.js';
+import { invalid } from '../../../kernel/errors.js';
+/** Classify persisted bindings without reading configuration through either execution backend. */
+export function sessionIdentity(row) {
+    const bindings = jsonObject(row.metadata);
+    if ('onlineAgent' in bindings && 'runnerOnlineAgent' in bindings)
+        throw invalid('Conflicting OnlineAgent backend bindings.');
+    const native = jsonObject(bindings.onlineAgent);
+    const nativeConfig = jsonObject(native.config);
+    if (row.mode === 'online' &&
+        native === bindings.onlineAgent &&
+        native.version === 1 &&
+        nativeConfig === native.config &&
+        (nativeConfig.agentId === undefined || nativeConfig.agentId === 'online') &&
+        (native.kind === 'realtime' || native.kind === 'background'))
+        return { backend: 'native', kind: native.kind };
+    const runner = jsonObject(bindings.runnerOnlineAgent);
+    const runnerConfig = jsonObject(runner.config);
+    if (row.mode === 'runner' &&
+        runner === bindings.runnerOnlineAgent &&
+        runner.version === 1 &&
+        runnerConfig === runner.config &&
+        typeof runnerConfig.agentId === 'string' &&
+        runnerConfig.agentId.length > 0 &&
+        runnerConfig.agentId !== 'online' &&
+        runnerConfig.agentId === row.agentId)
+        return { backend: 'runner', kind: 'realtime' };
+    throw invalid('This conversation has no valid OnlineAgent backend binding.');
+}
+export function runnerBinding(metadata) {
+    const value = jsonObject(jsonObject(metadata).runnerOnlineAgent);
+    return value.version === 1 && typeof value.config === 'object'
+        ? value
+        : null;
+}
+/** Shared native occupancy projection; callers supply their already-authorized persisted row. */
+export function nativeExecutionStatus(call, active) {
+    return active ||
+        call?.state === 'running' ||
+        call?.state === 'waitingApproval' ||
+        call?.closing
+        ? 'running'
+        : 'idle';
+}
+//# sourceMappingURL=state.js.map

package/dist/server/online/agent/persistence/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../../server/online/agent/persistence/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAOpD,kGAAkG;AAClG,MAAM,UAAU,eAAe,CAC7B,GAAuB;IAEvB,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,aAAa,IAAI,QAAQ,IAAI,mBAAmB,IAAI,QAAQ;QAC9D,MAAM,OAAO,CAAC,2CAA2C,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,IACE,GAAG,CAAC,IAAI,KAAK,QAAQ;QACrB,MAAM,KAAK,QAAQ,CAAC,WAAW;QAC/B,MAAM,CAAC,OAAO,KAAK,CAAC;QACpB,YAAY,KAAK,MAAM,CAAC,MAAM;QAC9B,CAAC,YAAY,CAAC,OAAO,KAAK,SAAS,IAAI,YAAY,CAAC,OAAO,KAAK,QAAQ,CAAC;QACzE,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC;QAE5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,IACE,GAAG,CAAC,IAAI,KAAK,QAAQ;QACrB,MAAM,KAAK,QAAQ,CAAC,iBAAiB;QACrC,MAAM,CAAC,OAAO,KAAK,CAAC;QACpB,YAAY,KAAK,MAAM,CAAC,MAAM;QAC9B,OAAO,YAAY,CAAC,OAAO,KAAK,QAAQ;QACxC,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC/B,YAAY,CAAC,OAAO,KAAK,QAAQ;QACjC,YAAY,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO;QAEpC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACjD,MAAM,OAAO,CAAC,6DAA6D,CAAC,CAAC;AAC/E,CAAC;AACD,MAAM,UAAU,aAAa,CAC3B,QAAiB;IAEjB,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAC5D,CAAC,CAAE,KAAkC;QACrC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AACD,iGAAiG;AACjG,MAAM,UAAU,qBAAqB,CACnC,IAA+D,EAC/D,MAAe;IAEf,OAAO,MAAM;QACX,IAAI,EAAE,KAAK,KAAK,SAAS;QACzB,IAAI,EAAE,KAAK,KAAK,iBAAiB;QACjC,IAAI,EAAE,OAAO;QACb,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC;AACb,CAAC"}

package/dist/server/online/agent/persistence/store.d.ts

@@ -0,0 +1,58 @@
+import { type ModelMessage, type UIMessage } from 'ai';
+import type { DatabaseConnection } from '@nocobase/db';
+import { type AppUIMessage } from '../../../../shared/online-agent.js';
+import type { ResolvedPageContext } from '../../../../shared/conversations.js';
+import { type ChatAttachmentService, type ChatAttachmentLinks } from '../../../core/conversations/attachments.js';
+import { type PageContextKinds } from '../../../core/conversations/page-context.js';
+import { type ConversationRecord } from '../../../core/conversations/conversation.store.js';
+import type { Tx, TxRunner } from '../../../kernel/tx.js';
+import type { OnlineAgentConfig, NativeMessage, NativeApproval, NativeSnapshot, NativeHistoryQuery, NativeHistoryPage, NativeInput } from '../types.js';
+import type { OnlineAgentCall } from './types.js';
+import { NativeMessages } from '../messages/projection.js';
+export declare class NativeSessionStore {
+    private deps;
+    messages: NativeMessages;
+    constructor(deps: {
+        tx: TxRunner;
+        attachments: ChatAttachmentLinks;
+        files?: Pick<ChatAttachmentService, 'content'>;
+        contextKinds?: PageContextKinds;
+        basePath?: () => string;
+        now(): string;
+        measure?: (phase: string, durationMs: number) => void;
+    });
+    private owned;
+    private write;
+    private update;
+    /** Independent application notifications, including after the model response has ended. */
+    deliver(userId: string, id: string, messageId: string, parts: AppUIMessage['parts'], outer?: {
+        unit: Tx;
+        row: ConversationRecord;
+    }): Promise<AppUIMessage>;
+    /** Server startup only: the previous process must have exited under single-instance deployment. */
+    recover(conn: DatabaseConnection, row: ConversationRecord, call: OnlineAgentCall): Promise<number>;
+    history(userId: string, id: string, ids?: string[]): Promise<AppUIMessage[]>;
+    page(userId: string, id: string, query: NativeHistoryQuery): Promise<NativeHistoryPage>;
+    executionHistory(userId: string, id: string, context?: ResolvedPageContext, page?: boolean): Promise<{
+        ui: UIMessage[];
+        model: ModelMessage[];
+        page?: ModelMessage;
+    }>;
+    accept(userId: string, id: string, input: NativeInput | NativeInput[], config: OnlineAgentConfig, model: {
+        modelService: string;
+        model: string;
+    }, executionId: string, messageId: string, expected: {
+        config: OnlineAgentConfig;
+        model: {
+            modelService: string;
+            model: string;
+        };
+    }): Promise<number>;
+    approve(userId: string, id: string, input: NativeApproval): Promise<{
+        message: NativeMessage;
+        waiting: boolean;
+    }>;
+    stop(userId: string, id: string): Promise<void>;
+    save(userId: string, id: string, snapshot: NativeSnapshot, call: OnlineAgentCall, revision: number): Promise<AppUIMessage>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/server/online/agent/persistence/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../server/online/agent/persistence/store.ts"],"names":[],"mappings":"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"}