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

package/dist/server/online/agent/runner/projection.js

@@ -0,0 +1,171 @@
+import { publicUIPageContext, } from '../../../../shared/ui-message.js';
+import { validateAppUIMessages, } from '../../../../shared/online-agent.js';
+import { messagesRepo, toMessage, } from '../../../core/conversations/conversation.store.js';
+export const runnerMessageId = (runId) => `runner:${runId}`;
+/** Pure projection: no Run inference from prose and no invented tools or approvals. */
+export function runnerUIMessages(rows) {
+    const messages = new Map();
+    for (const row of rows) {
+        const grouped = row.role === 'assistant' && row.runId;
+        const id = grouped ? runnerMessageId(row.runId) : row.id;
+        let message = messages.get(id);
+        if (!message) {
+            message = {
+                id,
+                role: row.role === 'user'
+                    ? 'user'
+                    : row.role === 'assistant'
+                        ? 'assistant'
+                        : 'system',
+                metadata: {
+                    conversationId: row.conversationId,
+                    createdAt: row.createdAt,
+                    revision: row.seq,
+                    seq: row.seq,
+                    ...(row.metadata.clientId ? { clientId: row.metadata.clientId } : {}),
+                    ...(row.metadata.agentId ? { agentId: row.metadata.agentId } : {}),
+                    ...(row.runId ? { executionId: row.runId, turnId: row.runId } : {}),
+                    sourceRecords: [],
+                    ...(row.workContext
+                        ? { context: publicUIPageContext(row.workContext) }
+                        : {}),
+                },
+                parts: [],
+            };
+            messages.set(id, message);
+        }
+        const index = message.parts.length;
+        const partId = `record:${row.id}`;
+        if (row.metadata.notice) {
+            const notice = row.metadata.notice;
+            message.parts.push(notice.code === 'news'
+                ? {
+                    type: 'data-notice',
+                    id: partId,
+                    data: {
+                        type: notice.type,
+                        title: notice.title,
+                        ...(notice.params ? { params: { ...notice.params } } : {}),
+                    },
+                }
+                : {
+                    type: 'data-business',
+                    id: partId,
+                    data: {
+                        kind: notice.code,
+                        id: row.id,
+                        payload: JSON.parse(JSON.stringify(notice)),
+                    },
+                });
+        }
+        else
+            message.parts.push({
+                type: 'text',
+                text: row.content.content,
+                state: 'done',
+            });
+        message.metadata.sourceRecords.push({
+            recordId: row.id,
+            seq: row.seq,
+            partId,
+            partIndex: index,
+            createdAt: row.createdAt,
+        });
+        for (const file of row.attachments ?? []) {
+            message.parts.push({
+                type: 'file',
+                filename: file.filename,
+                mediaType: file.mimeType,
+                url: file.contentUrl,
+            });
+            message.metadata.sourceRecords.push({
+                recordId: row.id,
+                seq: row.seq,
+                partId: `file:${file.id}`,
+                partIndex: message.parts.length - 1,
+                createdAt: row.createdAt,
+            });
+        }
+        message.metadata.revision = Math.max(message.metadata.revision, row.seq);
+    }
+    return [...messages.values()];
+}
+/** Seed a bounded source page, then expand whole Runs and the intervening independent records. */
+export async function runnerUIPage(tx, id, lastSeq, query, basePath) {
+    const repo = messagesRepo(tx.read());
+    const rows = await repo.findMany({
+        filter: (f) => f.and([
+            f.string('conversationId').eq(id),
+            ...(query.ids
+                ? [
+                    f.or(query.ids.map((key) => key.startsWith('runner:')
+                        ? f.string('runId').eq(key.slice(7))
+                        : f.string('id').eq(key))),
+                ]
+                : []),
+            ...(query.before !== undefined
+                ? [f.number('seq').lt(query.before)]
+                : []),
+            ...(query.after !== undefined ? [f.number('seq').gt(query.after)] : []),
+        ]),
+        sort: (s) => query.after !== undefined || query.ids
+            ? s.field('seq').asc()
+            : s.field('seq').desc(),
+        ...(query.ids ? {} : { limit: query.limit + 1 }),
+    });
+    const selected = rows.slice(0, query.ids ? rows.length : query.limit);
+    const runIds = [
+        ...new Set(selected
+            .filter((row) => row.role === 'assistant' && row.runId)
+            .map((row) => row.runId)),
+    ];
+    const groups = runIds.length
+        ? await repo.findMany({
+            filter: (f) => f.and([
+                f.string('conversationId').eq(id),
+                f.string('role').eq('assistant'),
+                f.or(runIds.map((runId) => f.string('runId').eq(runId))),
+            ]),
+            sort: (s) => s.field('seq').asc(),
+        })
+        : [];
+    const gathered = [...selected, ...groups];
+    if (!gathered.length)
+        return { items: [], lastSeq, hasMore: false };
+    const minimum = Math.min(...gathered.map((row) => Number(row.seq)));
+    const maximum = Math.max(...gathered.map((row) => Number(row.seq)));
+    // Notices interleaved with a logical message must be on the same page, never stranded behind its anchor.
+    const interval = query.ids
+        ? gathered
+        : await repo.findMany({
+            filter: (f) => f.and([
+                f.string('conversationId').eq(id),
+                f.number('seq').gte(minimum),
+                f.number('seq').lte(maximum),
+            ]),
+            sort: (s) => s.field('seq').asc(),
+        });
+    const unique = [
+        ...new Map(interval
+            .filter((row) => query.after === undefined ||
+            Number(row.seq) > query.after ||
+            (row.role === 'assistant' && runIds.includes(row.runId)))
+            .map((row) => [row.id, row])).values(),
+    ].sort((a, b) => Number(a.seq) - Number(b.seq));
+    const items = await validateAppUIMessages(runnerUIMessages(unique.map((row) => toMessage(row, basePath))));
+    return {
+        items: query.ids
+            ? items.filter((message) => query.ids.includes(message.id))
+            : items,
+        lastSeq,
+        ...(query.after !== undefined && maximum < lastSeq
+            ? { nextAfter: maximum }
+            : {}),
+        hasMore: query.ids
+            ? false
+            : query.after === undefined
+                ? minimum > 1
+                : maximum < lastSeq,
+    };
+}
+//# sourceMappingURL=projection.js.map

package/dist/server/online/agent/runner/projection.js.map

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

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

@@ -0,0 +1,44 @@
+import type { OnlineAgentUIStreams, UIStreamChannel } from '../transport/streams.js';
+import type { AppUIMessage } from '../../../../shared/online-agent.js';
+import type { ConversationService } from '../../../core/conversations/ports.js';
+import type { TxRunner } from '../../../kernel/tx.js';
+import type { OnlineAgentConfigurator } from '../configuration.js';
+export type Execution = {
+    id: string;
+    userId: string;
+    runId?: string;
+    cursor: number;
+    writer: UIStreamChannel;
+    published: Set<string>;
+    ready: boolean;
+    started: boolean;
+    snapshot?: AppUIMessage;
+    pending?: Promise<void>;
+    again: boolean;
+    timer?: ReturnType<typeof setTimeout>;
+    cleared?: boolean;
+};
+export type RunnerDependencies = {
+    tx: TxRunner;
+    conversations: ConversationService;
+    streams: OnlineAgentUIStreams;
+    configurator: OnlineAgentConfigurator;
+    now(): string;
+    basePath(): string;
+    onError(error: unknown): void;
+    measure?(phase: string, durationMs: number): void;
+};
+export type RunnerState = {
+    active: Map<string, Execution>;
+    admitting: Set<string>;
+    admissions: Set<Promise<unknown>>;
+    stopping: boolean;
+    detaching: boolean;
+};
+export type RunnerSessionHost = {
+    deps: RunnerDependencies;
+    state: RunnerState;
+    refresh(execution: Execution): Promise<void>;
+    finalizeSavedRun(userId: string, id: string, runId: string): Promise<void>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../server/online/agent/runner/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,mBAAmB,CAAC;IACnC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,YAAY,EAAE,uBAAuB,CAAC;IACtC,GAAG,IAAI,MAAM,CAAC;IACd,QAAQ,IAAI,MAAM,CAAC;IACnB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACnD,CAAC;AACF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E,CAAC"}

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

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

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

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

package/dist/server/online/agent/service.d.ts

@@ -0,0 +1,47 @@
+import type { LanguageModel } from 'ai';
+import type { ServiceResolver } from '@nocobase/service-provider';
+import type { BackgroundOnlineAgent, RealtimeOnlineAgent, OnlineAgentBackend, OnlineAgentSessionManager } from './contracts.js';
+import type { OnlineAgentBoundary, OnlineAgentConfiguration, OnlineAgentContext, OnlineAgentOptions, OnlineAgentRealtimeOptions } from './types.js';
+import { OnlineAgentUIStreams } from './transport/streams.js';
+import { OnlineAgentConfigurator } from './configuration.js';
+import type { IdSource } from '../../kernel/ids.js';
+import type { ModelRef } from '../../../shared/models.js';
+/** Trusted application entry and backend orchestration; executions belong to their backend. */
+export declare class OnlineAgentService {
+    private deps;
+    readonly configurator: OnlineAgentConfigurator;
+    readonly uiStreams: OnlineAgentUIStreams;
+    private readonly native;
+    private stopping;
+    constructor(deps: {
+        sessions: OnlineAgentSessionManager;
+        runner?: OnlineAgentBackend;
+        configurator?: OnlineAgentConfigurator;
+        ids: IdSource;
+        resolver?: ServiceResolver;
+        model(ref: ModelRef, sessionId: string): Promise<LanguageModel>;
+        defaultModel(): Promise<ModelRef | null>;
+        uiStreams?: OnlineAgentUIStreams;
+        onError(error: unknown): void;
+    });
+    /** Only the owning Provider invokes startup recovery before serving requests. */
+    recoverAtStartup(): Promise<void>;
+    shutdown(): Promise<void>;
+    get recovery(): 'shared' | 'live';
+    /** Native status projection uses local occupancy even without a realtime output channel. */
+    producerAvailable(id: string, persistedRunning?: boolean): Promise<boolean>;
+    configure(context: OnlineAgentContext, id: string, options: OnlineAgentOptions, selectedModel?: ModelRef, boundary?: OnlineAgentBoundary): Promise<OnlineAgentConfiguration>;
+    configuration(context: OnlineAgentContext, id: string): Promise<OnlineAgentConfiguration>;
+    realtime(context: OnlineAgentContext, options?: OnlineAgentRealtimeOptions, boundary?: OnlineAgentBoundary): Promise<RealtimeOnlineAgent>;
+    background(context: OnlineAgentContext, options?: OnlineAgentOptions & {
+        sessionId?: string;
+        selectedModel?: ModelRef;
+        source?: string;
+        title?: string;
+    }, boundary?: OnlineAgentBoundary): Promise<BackgroundOnlineAgent>;
+    private initial;
+    private selectedBackend;
+    private persistedBackend;
+    private trusted;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/server/online/agent/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../server/online/agent/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EAExB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,+FAA+F;AAC/F,qBAAa,kBAAkB;IAO3B,OAAO,CAAC,IAAI;IANd,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAS;gBAGf,IAAI,EAAE;QACZ,QAAQ,EAAE,yBAAyB,CAAC;QACpC,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,YAAY,CAAC,EAAE,uBAAuB,CAAC;QACvC,GAAG,EAAE,QAAQ,CAAC;QACd,QAAQ,CAAC,EAAE,eAAe,CAAC;QAC3B,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QAChE,YAAY,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;QACzC,SAAS,CAAC,EAAE,oBAAoB,CAAC;QACjC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;KAC/B;IAaH,iFAAiF;IAC3E,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B,IAAI,QAAQ,IAAI,QAAQ,GAAG,MAAM,CAEhC;IAED,4FAA4F;IACtF,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,gBAAgB,GAAE,OAAc,GAC/B,OAAO,CAAC,OAAO,CAAC;IAOb,SAAS,CACb,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,kBAAkB,EAC3B,aAAa,CAAC,EAAE,QAAQ,EACxB,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IAW9B,aAAa,CACjB,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,wBAAwB,CAAC;IAQ9B,QAAQ,CACZ,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,0BAA+B,EACxC,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAmBzB,UAAU,CACd,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,kBAAkB,GAAG;QAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,QAAQ,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,EACN,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,qBAAqB,CAAC;YAmBnB,OAAO;IAqBrB,OAAO,CAAC,eAAe;YAST,gBAAgB;IAU9B,OAAO,CAAC,OAAO;CAchB"}

package/dist/server/online/agent/service.js

@@ -0,0 +1,111 @@
+import { NativeOnlineAgentBackend } from './native/backend.js';
+import { OnlineAgentUIStreams } from './transport/streams.js';
+import { OnlineAgentConfigurator } from './configuration.js';
+import { conflict, invalid } from '../../kernel/errors.js';
+/** Trusted application entry and backend orchestration; executions belong to their backend. */
+export class OnlineAgentService {
+    deps;
+    configurator;
+    uiStreams;
+    native;
+    stopping = false;
+    constructor(deps) {
+        this.deps = deps;
+        this.configurator = deps.configurator ?? new OnlineAgentConfigurator();
+        this.uiStreams =
+            deps.uiStreams ??
+                new OnlineAgentUIStreams({ onError: (error) => deps.onError(error) });
+        this.native = new NativeOnlineAgentBackend({
+            ...deps,
+            configurator: this.configurator,
+            uiStreams: this.uiStreams,
+        });
+    }
+    /** Only the owning Provider invokes startup recovery before serving requests. */
+    async recoverAtStartup() {
+        await this.deps.sessions.recoverAtStartup();
+    }
+    async shutdown() {
+        this.stopping = true;
+        // Both backends settle their work before the one owner closes their shared transport.
+        const results = await Promise.allSettled([
+            this.native.shutdown(),
+            this.deps.runner?.shutdown(),
+        ]);
+        await this.uiStreams.shutdown();
+        const errors = results.flatMap((result) => result.status === 'rejected' ? [result.reason] : []);
+        if (errors.length)
+            throw new AggregateError(errors, 'OnlineAgent backends could not shut down.');
+    }
+    get recovery() {
+        return this.uiStreams.enabled ? 'shared' : 'live';
+    }
+    /** Native status projection uses local occupancy even without a realtime output channel. */
+    async producerAvailable(id, persistedRunning = true) {
+        return (this.native.hasLocalExecution(id) ||
+            (persistedRunning && (await this.uiStreams.producerAvailable(id))));
+    }
+    async configure(context, id, options, selectedModel, boundary) {
+        this.trusted(context);
+        return (await this.persistedBackend(context, id)).configure(context, id, options, selectedModel, boundary);
+    }
+    async configuration(context, id) {
+        this.trusted(context);
+        return (await this.persistedBackend(context, id)).configuration(context, id);
+    }
+    async realtime(context, options = {}, boundary) {
+        this.trusted(context);
+        if (options.sessionId) {
+            const backend = await this.persistedBackend(context, options.sessionId);
+            return backend.restoreRealtime(context, { ...options, sessionId: options.sessionId }, boundary);
+        }
+        const initial = await this.initial(context, options, boundary);
+        return this.selectedBackend(initial).createRealtime(context, initial, options, boundary);
+    }
+    async background(context, options = {}, boundary) {
+        this.trusted(context);
+        if (options.sessionId) {
+            const backend = await this.persistedBackend(context, options.sessionId);
+            return backend.restoreBackground(context, { ...options, sessionId: options.sessionId }, boundary);
+        }
+        const initial = await this.initial(context, options, boundary);
+        return this.selectedBackend(initial).createBackground(context, initial, options, boundary);
+    }
+    async initial(context, options, boundary) {
+        const defaults = await this.deps.sessions.defaults(context.user.id);
+        // Backend selection precedes Native model lookup and validation.
+        const resolved = await this.configurator.resolveSelection(context, {
+            ...options,
+            scope: options.scope ?? defaults.scope,
+        }, undefined, [], boundary === 'http');
+        this.trusted(context);
+        return { ...resolved, defaultModel: defaults.model };
+    }
+    selectedBackend(initial) {
+        if (!initial.config.agentId || initial.config.agentId === 'online')
+            return this.native;
+        if (!this.deps.runner)
+            throw invalid('Runner execution is unavailable.');
+        return this.deps.runner;
+    }
+    async persistedBackend(context, id) {
+        const identity = await this.deps.sessions.identify(context.user.id, id);
+        if (identity.backend === 'native')
+            return this.native;
+        if (!this.deps.runner)
+            throw invalid('Runner execution is unavailable.');
+        return this.deps.runner;
+    }
+    trusted(context) {
+        if (!context.user.id ||
+            !context.authorization ||
+            context.credentials === undefined ||
+            context.credentials === null ||
+            context.authorization.identity.principal?.type !== 'user' ||
+            context.authorization.identity.principal.id !== context.user.id)
+            throw invalid('A trusted user, authorization and full entry credentials are required.');
+        if (this.stopping)
+            throw conflict('OnlineAgent is stopping.');
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/server/online/agent/service.js.map

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

package/dist/server/online/agent/transport/streams.d.ts

@@ -0,0 +1,54 @@
+import type { TxRunner } from '../../../kernel/tx.js';
+import type { NativeUIChunk, OnlineAgentRecoveryConfig, UIStreamAssociation } from '../types.js';
+/** Single bounded response. Neither cancellation nor a slow subscriber cancels its producer. */
+export declare class UIStreamChannel {
+    readonly association: UIStreamAssociation;
+    private onError;
+    private controller;
+    private ended;
+    private bytes;
+    private claimed;
+    private initial?;
+    readonly source: ReadableStream<NativeUIChunk>;
+    constructor(association: UIStreamAssociation, onError: (error: unknown) => void);
+    attach(stream: ReadableStream<string>): void;
+    take(): ReadableStream<string> | undefined;
+    write(chunk: NativeUIChunk): void;
+    fail(error: unknown): void;
+    close(): void;
+}
+/** SDK framing and the upstream resumable-stream engine, never a second replay implementation. */
+export declare class OnlineAgentUIStreams {
+    private deps;
+    private publisher?;
+    private subscriber?;
+    private context?;
+    private ready?;
+    private callbacks;
+    private tasks;
+    private readers;
+    private channels;
+    constructor(deps: {
+        tx?: TxRunner;
+        recovery?: OnlineAgentRecoveryConfig;
+        onError(error: unknown): void;
+        measure?(phase: string, durationMs: number): void;
+    });
+    get enabled(): boolean;
+    private key;
+    private fail;
+    producerAvailable(id: string): Promise<boolean>;
+    preflight(): Promise<void>;
+    private association;
+    open(userId: string, id: string, executionId: string, backend: UIStreamAssociation['backend'], stop?: () => void): Promise<UIStreamChannel>;
+    bind(id: string, channel: UIStreamChannel, executionId: string): Promise<void>;
+    release(id: string, channel: UIStreamChannel): Promise<void>;
+    close(id: string, channel: UIStreamChannel): Promise<void>;
+    /** Called only after the adapter verified a terminal Run and completed its canonical synchronization. */
+    forgetCompleted(userId: string, id: string, executionId: string): Promise<void>;
+    /** Authorized business Stop, separate from cancelling any browser subscription. */
+    requestStop(userId: string, id: string, executionId: string): Promise<boolean>;
+    receive(userId: string, id: string, channel?: UIStreamChannel): Promise<ReadableStream<NativeUIChunk> | null>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=streams.d.ts.map

package/dist/server/online/agent/transport/streams.d.ts.map

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