@yss123/cage-ai 0.0.0-stage → 0.3.0

package/dist/store.js

@@ -0,0 +1,456 @@
+/**
+ * 持久化用户助理会话、运行提交、交互回复、事件和偏好。
+ * HTTP 调用此层验证归属与当前指纹，worker 运行时继承此层推进任务；数据库中接受提交只表示 queued，不等于模型或业务动作已完成。
+ */
+import { randomUUID } from 'node:crypto';
+import { cageError } from '@yss123/cage-kernel';
+import { sql } from 'kysely';
+import { z } from 'zod';
+import { messageInputSchema, interactionResponseSchema, personalitySelectionSchema, } from '@yss123/cage-ai-protocol';
+import { authFingerprint, digest, needUser, parse } from './security.js';
+import { DEFAULT_LIMITS, TERMINAL } from './types.js';
+import { PersonalityManager, personalitySummary } from './personalities.js';
+import { reservedTokens } from './budget.js';
+/**
+ * 将值序列化为数据库 JSON 字段文本；调用方须先完成结构校验，不在此隐藏不可序列化错误。
+ */
+export const json = (value) => JSON.stringify(value);
+/**
+ * 把数据库时间值转为 UTC ISO 字符串供协议 DTO 使用；无效时间直接抛错，不用本机时间静默替代。
+ */
+export const iso = (value) => new Date(value).toISOString();
+/**
+ * 把会话数据库行转换为公开 DTO，保留性格选择版本供并发切换校验，不暴露租户/用户存储字段。
+ */
+const sessionDto = (r) => ({
+    id: r.id,
+    title: r.title,
+    createdAt: iso(r.created_at),
+    updatedAt: iso(r.updated_at),
+    personalityKey: r.personality_key,
+    personalityVersion: r.personality_version,
+});
+/** 所有流事件在持有 run 行锁的事务内编号；断线可以按 sequence 重放。 */
+/**
+ * 在持有运行行锁的事务内递增 sequence 并插入事件，运行更新时间同步刷新。
+ * 调用方必须把业务状态变更放在同一事务，使重连按序重放时不会看见未提交状态；此函数不负责 HTTP 推送。
+ */
+export async function event(tx, runId, type, data) {
+    const row = await tx
+        .updateTable('sys.ai_run')
+        .set({ next_seq: sql `next_seq + 1`, updated_at: sql `now()` })
+        .where('id', '=', runId)
+        .returning('next_seq')
+        .executeTakeFirstOrThrow();
+    await tx
+        .insertInto('sys.ai_event')
+        .values({ run_id: runId, sequence: row.next_seq, type, data: json(data) })
+        .execute();
+}
+/**
+ * 用户助理持久化服务，也是 AiRuntime 的状态存取基础。
+ * 公开读取先验证用户归属、注册表与授权指纹；提交、取消及互动用事务协调并发，模型执行和业务工具调用由运行时承担。
+ */
+export class AiStore {
+    kernel;
+    options;
+    fingerprint;
+    /**
+     * 会话创建、切换和运行快照共用的租户性格服务。
+     */
+    personalities;
+    /**
+     * 绑定内核、AI 声明选项及注册表指纹，并创建共用性格服务；构造时不创建会话或启动 worker。
+     */
+    constructor(kernel, options, fingerprint) {
+        this.kernel = kernel;
+        this.options = options;
+        this.fingerprint = fingerprint;
+        this.personalities = new PersonalityManager(kernel);
+    }
+    /**
+     * 验证助理用户及标题，在事务中确认指定或默认性格存在且启用，再创建归属当前租户/用户的会话。
+     * null 性格 key 表示跟随租户默认项；本步骤不调用模型。
+     */
+    async createSession(ctx, title = '新会话', personalityKey = null) {
+        needUser(ctx);
+        parse(z.string().trim().min(1).max(160), title);
+        return this.kernel.app.transaction().execute(async (tx) => {
+            await this.personalities.resolve(ctx, personalityKey, tx);
+            return sessionDto(await tx
+                .insertInto('sys.ai_session')
+                .values({
+                id: randomUUID(),
+                tenant_id: ctx.tenantId,
+                user_id: ctx.userId,
+                title,
+                personality_key: personalityKey,
+            })
+                .returningAll()
+                .executeTakeFirstOrThrow());
+        });
+    }
+    /**
+     * 返回当前租户用户最近更新的至多 100 个会话；不提供跨用户管理视图或全量导出。
+     */
+    async sessions(ctx) {
+        needUser(ctx);
+        const rows = await this.kernel.app
+            .selectFrom('sys.ai_session')
+            .selectAll()
+            .where('tenant_id', '=', ctx.tenantId)
+            .where('user_id', '=', ctx.userId)
+            .orderBy('updated_at', 'desc')
+            .limit(100)
+            .execute();
+        return rows.map(sessionDto);
+    }
+    /**
+     * 锁定本人会话并比较 personality_version 后切换性格，递增版本。
+     * 目标必须启用，null 表示默认项；只影响以后提交的轮次，不修改运行已经保存的性格快照。
+     */
+    async selectPersonality(ctx, sessionId, raw) {
+        needUser(ctx);
+        const input = parse(personalitySelectionSchema, raw);
+        return this.kernel.app.transaction().execute(async (tx) => {
+            const session = await this.ownedSession(ctx, sessionId, tx, true);
+            if (session.personality_version !== input.version)
+                throw cageError('CONFLICT');
+            await this.personalities.resolve(ctx, input.key, tx);
+            return sessionDto(await tx
+                .updateTable('sys.ai_session')
+                .set({ personality_key: input.key, personality_version: input.version + 1, updated_at: new Date() })
+                .where('id', '=', sessionId)
+                .returningAll()
+                .executeTakeFirstOrThrow());
+        });
+    }
+    /**
+     * 验证 UUID、登录身份和租户/用户归属后读取会话；不存在或无归属统一 NOT_FOUND。
+     * 可在调用方事务中加行锁，用于提交与性格切换的并发协调。
+     */
+    async ownedSession(ctx, id, db = this.kernel.app, lock = false) {
+        needUser(ctx);
+        parse(z.uuid(), id);
+        let query = db
+            .selectFrom('sys.ai_session')
+            .selectAll()
+            .where('id', '=', id)
+            .where('tenant_id', '=', ctx.tenantId)
+            .where('user_id', '=', ctx.userId);
+        if (lock)
+            query = query.forUpdate();
+        const r = await query.executeTakeFirst();
+        if (!r)
+            throw cageError('NOT_FOUND');
+        return r;
+    }
+    /**
+     * 验证运行归属，并拒绝注册声明或授权指纹已变化的旧记录。
+     * 旧回答和事件也可能包含现在不该看到的信息，因此读取同样执行指纹复核；返回内部行供本层转换，不直接作为公开 DTO。
+     */
+    async ownedRun(ctx, id, db = this.kernel.app) {
+        needUser(ctx);
+        parse(z.uuid(), id);
+        const r = await db
+            .selectFrom('sys.ai_run')
+            .selectAll()
+            .where('id', '=', id)
+            .where('tenant_id', '=', ctx.tenantId)
+            .where('user_id', '=', ctx.userId)
+            .executeTakeFirst();
+        if (!r)
+            throw cageError('NOT_FOUND');
+        // 声明可能新增隐藏字段或改变查询含义，旧版本生成的回答和事件也必须停止交付。
+        if (r.fingerprint !== this.fingerprint)
+            throw cageError('CONFLICT', '注册声明已变化，请重新发起任务');
+        if (r.auth_fingerprint && r.auth_fingerprint !== authFingerprint(ctx))
+            throw cageError('FORBIDDEN', '授权已变化，请开启新会话');
+        return r;
+    }
+    /**
+     * 校验启用状态、消息/页面快照及最多 80 KiB 输入，按用户事务锁执行幂等提交。
+     * 相同请求键与内容复用已有运行，不重复占队列；同键不同内容冲突。锁会话后冻结性格、权限和注册表快照，非终态队列默认最多 8 个。
+     * 创建 queued 运行、首个状态事件和会话更新时间共同提交，默认委托期限 30 分钟；返回状态快照，实际工作由 worker 异步执行。
+     */
+    async submit(ctx, sessionId, input, requestKey, authSession) {
+        needUser(ctx);
+        if (!this.options.assistant)
+            throw cageError('NOT_FOUND');
+        const body = parse(messageInputSchema, input);
+        parse(z.string().min(1).max(160), requestKey);
+        if (Buffer.byteLength(json(body)) > 80 * 1024)
+            throw cageError('INVALID_INPUT', '消息上下文超过限制');
+        const hash = digest({ sessionId, body });
+        const id = await this.kernel.app.transaction().execute(async (tx) => {
+            // 同一用户并发请求共享配额锁；幂等键不会因重试消耗第二个队列名额。
+            await sql `select pg_advisory_xact_lock(hashtext(${ctx.tenantId}), hashtext(${ctx.userId}))`.execute(tx);
+            const old = await tx
+                .selectFrom('sys.ai_run')
+                .selectAll()
+                .where('tenant_id', '=', ctx.tenantId)
+                .where('user_id', '=', ctx.userId)
+                .where('request_key', '=', requestKey)
+                .executeTakeFirst();
+            if (old) {
+                if (old.request_hash !== hash)
+                    throw cageError('CONFLICT');
+                return old.id;
+            }
+            const session = await this.ownedSession(ctx, sessionId, tx, true);
+            const personality = await this.personalities.resolve(ctx, session.personality_key, tx);
+            const count = await tx
+                .selectFrom('sys.ai_run')
+                .select(sql `count(*)::int`.as('n'))
+                .where('tenant_id', '=', ctx.tenantId)
+                .where('user_id', '=', ctx.userId)
+                .where('status', 'not in', TERMINAL)
+                .executeTakeFirstOrThrow();
+            if (count.n >= (this.options.maxQueuedPerUser ?? 8))
+                throw cageError('RATE_LIMITED');
+            const id = randomUUID(), assistant = this.options.assistant;
+            await tx
+                .insertInto('sys.ai_run')
+                .values({
+                id,
+                tenant_id: ctx.tenantId,
+                user_id: ctx.userId,
+                session_id: sessionId,
+                mode: 'assistant',
+                status: 'queued',
+                input: body.message,
+                page_context: body.pageContext ? json(body.pageContext) : null,
+                personality: json(personality),
+                model: assistant.model,
+                instructions: assistant.instructions ?? '',
+                limits: json({ ...DEFAULT_LIMITS, ...assistant.limits }),
+                fingerprint: this.fingerprint,
+                auth_fingerprint: authFingerprint(ctx),
+                auth_session: authSession ?? null,
+                delegated_until: new Date(Date.now() + (this.options.delegationTtlMs ?? 30 * 60_000)),
+                step_up_at: ctx.stepUpAt ?? null,
+                request_key: requestKey,
+                request_hash: hash,
+            })
+                .execute();
+            await event(tx, id, 'run.status', { status: 'queued' });
+            await tx
+                .updateTable('sys.ai_session')
+                .set({ updated_at: sql `now()` })
+                .where('id', '=', sessionId)
+                .execute();
+            return id;
+        });
+        return this.run(ctx, id);
+    }
+    /**
+     * 读取经归属/指纹复核的运行 DTO及未回复互动。
+     * 终态一律不再交付待处理互动，避免客户端继续确认已结束任务；不返回内部模型历史、租约或凭据。
+     */
+    async run(ctx, id) {
+        const r = await this.ownedRun(ctx, id);
+        const interactions = await this.kernel.app
+            .selectFrom('sys.ai_interaction')
+            .selectAll()
+            .where('run_id', '=', id)
+            .where('answered_at', 'is', null)
+            .orderBy('created_at')
+            .execute();
+        return {
+            id,
+            sessionId: r.session_id,
+            status: r.status,
+            phase: r.phase,
+            answer: r.answer,
+            error: r.error,
+            steps: r.steps,
+            toolCalls: r.tool_calls,
+            tokens: r.tokens,
+            createdAt: iso(r.created_at),
+            updatedAt: iso(r.updated_at),
+            ...(r.personality ? { personality: personalitySummary(r.personality) } : {}),
+            interactions: TERMINAL.includes(r.status)
+                ? []
+                : interactions.map((i) => ({
+                    id: i.id,
+                    kind: i.kind,
+                    prompt: i.prompt,
+                    data: i.data,
+                    expiresAt: iso(i.expires_at),
+                })),
+        };
+    }
+    /**
+     * 验证本人会话后取最近 100 个运行，再按时间正序逐个执行 run 的指纹检查。
+     * 任一旧记录授权不再匹配时拒绝交付，不把旧敏感答案当作普通会话缓存返回。
+     */
+    async runs(ctx, sessionId) {
+        await this.ownedSession(ctx, sessionId);
+        const rows = await this.kernel.app
+            .selectFrom('sys.ai_run')
+            .select('id')
+            .where('session_id', '=', sessionId)
+            .orderBy('created_at', 'desc')
+            .orderBy('id', 'desc')
+            .limit(100)
+            .execute();
+        const runs = [];
+        for (const r of rows.reverse())
+            runs.push(await this.run(ctx, r.id));
+        return runs;
+    }
+    /**
+     * 读取指定序号之后的单页事件，默认从 0 开始；授权与每页数量规则由 eventPage 统一执行。
+     */
+    async events(ctx, id, after = 0) {
+        return (await this.eventPage(ctx, id, after)).events;
+    }
+    /** SSE 同时读取状态与事件，避免每次追赶都再次查询完整运行及互动列表。 */
+    /**
+     * 验证归属与当前指纹，读取 after 之后最多 200 条有序事件及运行状态/最新序号。
+     * SSE 据此判断是否追平或终止；状态和事件不是额外长事务快照，下一页继续通过序号追赶。
+     */
+    async eventPage(ctx, id, after = 0) {
+        const run = await this.ownedRun(ctx, id);
+        parse(z.number().int().nonnegative(), after);
+        const rows = await this.kernel.app
+            .selectFrom('sys.ai_event')
+            .selectAll()
+            .where('run_id', '=', id)
+            .where('sequence', '>', after)
+            .orderBy('sequence')
+            .limit(200)
+            .execute();
+        return {
+            status: run.status,
+            nextSequence: run.next_seq,
+            events: rows.map((r) => ({
+                runId: id,
+                sequence: r.sequence,
+                type: r.type,
+                data: r.data,
+                createdAt: iso(r.created_at),
+            })),
+        };
+    }
+    /**
+     * 锁定本人运行后标记取消并清除租约，终态重复取消不做变更。
+     * 尚未结算的模型预留按估算一次性计入累计 Token，同时写失败和取消事件；取消阻止后续租约提交，但不会撤销之前已完成的业务命令。
+     */
+    async cancel(ctx, id) {
+        await this.kernel.app.transaction().execute(async (tx) => {
+            await this.ownedRun(ctx, id, tx);
+            const run = await tx
+                .selectFrom('sys.ai_run')
+                .selectAll()
+                .where('id', '=', id)
+                .forUpdate()
+                .executeTakeFirstOrThrow();
+            if (TERMINAL.includes(run.status))
+                return;
+            const charged = run.model_reservation ? reservedTokens(run.model_reservation) : 0;
+            await tx
+                .updateTable('sys.ai_run')
+                .set({
+                cancelled: true,
+                status: 'cancelled',
+                lease_token: null,
+                lease_until: null,
+                model_reservation: null,
+                tokens: run.tokens + charged,
+            })
+                .where('id', '=', id)
+                .execute();
+            if (run.model_reservation)
+                await event(tx, id, 'model.failed', {
+                    attempt: run.model_reservation.attempt,
+                    reason: 'cancelled',
+                    chargedTokens: charged,
+                    usageSource: 'estimate',
+                    retryable: false,
+                });
+            await event(tx, id, 'run.status', { status: 'cancelled' });
+        });
+        return this.run(ctx, id);
+    }
+    /**
+     * 在运行行锁内保存确认、补充输入或页面快照回复，再把等待运行排回 queued。
+     * 相同已回答内容幂等返回，不同内容冲突；拒绝过期、类型不符、其他页面实例或倒退版本快照。
+     * 只记录用户回复，不在 HTTP 事务直接执行工具，worker 恢复时仍重新核验权限与业务状态。
+     */
+    async respond(ctx, id, interactionId, input) {
+        parse(z.uuid(), interactionId);
+        const body = parse(interactionResponseSchema, input);
+        await this.kernel.app.transaction().execute(async (tx) => {
+            await this.ownedRun(ctx, id, tx);
+            const run = await tx
+                .selectFrom('sys.ai_run')
+                .selectAll()
+                .where('id', '=', id)
+                .forUpdate()
+                .executeTakeFirstOrThrow();
+            const interaction = await tx
+                .selectFrom('sys.ai_interaction')
+                .selectAll()
+                .where('id', '=', interactionId)
+                .where('run_id', '=', id)
+                .executeTakeFirst();
+            if (!interaction)
+                throw cageError('NOT_FOUND');
+            if (interaction.answered_at) {
+                if (digest(interaction.response) !== digest(body))
+                    throw cageError('CONFLICT');
+                return;
+            }
+            if (!['waiting_confirmation', 'waiting_input'].includes(run.status) ||
+                new Date(interaction.expires_at).getTime() <= Date.now())
+                throw cageError('CONFLICT');
+            if ((interaction.kind === 'confirmation' && body.approved === undefined) ||
+                (interaction.kind === 'input' && body.answer === undefined) ||
+                (interaction.kind === 'page_context' && !body.pageContext))
+                throw cageError('INVALID_INPUT');
+            if (body.pageContext &&
+                run.page_context &&
+                (body.pageContext.pageInstanceId !== run.page_context.pageInstanceId ||
+                    body.pageContext.revision < run.page_context.revision))
+                throw cageError('CONFLICT', '页面快照来自其他页面或旧版本');
+            await tx
+                .updateTable('sys.ai_interaction')
+                .set({ response: json(body), answered_at: sql `now()` })
+                .where('id', '=', interactionId)
+                .execute();
+            await tx.updateTable('sys.ai_run').set({ status: 'queued', deadline: null }).where('id', '=', id).execute();
+            await event(tx, id, 'run.status', { status: 'queued' });
+        });
+        return this.run(ctx, id);
+    }
+    /**
+     * 返回当前租户用户最近更新的最多 50 条偏好；只读本人数据，内容不因被记忆就获得指令优先级。
+     */
+    async memories(ctx) {
+        needUser(ctx);
+        const rows = await this.kernel.app
+            .selectFrom('sys.ai_memory')
+            .selectAll()
+            .where('tenant_id', '=', ctx.tenantId)
+            .where('user_id', '=', ctx.userId)
+            .orderBy('updated_at', 'desc')
+            .limit(50)
+            .execute();
+        return rows.map((r) => ({ id: r.id, key: r.key, value: r.value, updatedAt: iso(r.updated_at) }));
+    }
+    /**
+     * 按 UUID 和当前租户/用户归属删除偏好；目标不存在时也完成，重复删除不产生额外副作用。
+     */
+    async deleteMemory(ctx, id) {
+        needUser(ctx);
+        parse(z.uuid(), id);
+        await this.kernel.app
+            .deleteFrom('sys.ai_memory')
+            .where('id', '=', id)
+            .where('tenant_id', '=', ctx.tenantId)
+            .where('user_id', '=', ctx.userId)
+            .execute();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/text-stream.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 将模型零碎文本合并为有序、可等待的持久事件提交。
+ * 运行时传入带租约检查的 emit；首段尽快提交，后续短片段合并 40 毫秒，完成和取消时分别冲刷或丢弃尾段，避免迟到文本越过运行终态。
+ */
+/** 首段立即提交，后续最多合并 40ms；持久化不再阻塞每一个模型 token。 */
+/**
+ * 有序文本批处理器，串行等待 emit 并记住首次提交失败。
+ * 普通 token 不逐个阻塞数据库往返，累计到 2048 字符时主动施加背压；不负责网络重试或重建已经丢弃的文本。
+ */
+export declare class TextStream {
+    private readonly emit;
+    private readonly signal;
+    /**
+     * 尚未交给 emit 的文本缓冲，按字符长度触发批次阈值。
+     */
+    private pending;
+    /**
+     * 短片段合并定时器；冲刷、完成或销毁时清理。
+     */
+    private timer;
+    /**
+     * 已排队提交的串行尾 Promise，保证事件顺序。
+     */
+    private tail;
+    /**
+     * 最近捕获的提交失败；后续 push/finish 重新抛出。
+     */
+    private failure;
+    /**
+     * 是否曾提交过非空批次，确保首段不等待定时器。
+     */
+    private started;
+    /**
+     * 是否已完成或销毁，阻止继续追加。
+     */
+    private closed;
+    /**
+     * 绑定异步提交回调和运行取消信号；回调负责实际持久化与租约验证，本类不创建事务。
+     */
+    constructor(emit: (text: string) => Promise<void>, signal: AbortSignal);
+    /**
+     * 追加文本；先检查取消及此前提交失败，再按首段、2048 字符阈值或 40 毫秒定时器触发冲刷。
+     * 关闭后及空文本不再入队；长片段等待提交形成背压，短片段可能先返回。
+     */
+    push(text: string): Promise<void>;
+    /**
+     * 取走当前缓冲并链接到同一提交 Promise，确保各批次顺序不交错。
+     * 清理定时器，捕获异步失败供本次和后续调用重新抛出，失败后不继续发送排队文本。
+     */
+    private flush;
+    /** 完成事件必须排在最后一段文字提交之后。 */
+    /**
+     * 关闭输入并等待尾段提交；调用方必须在此成功后发布模型完成事件，否则界面可能先看到完成再收到文字。
+     */
+    finish(): Promise<void>;
+    /** 失败/取消后丢弃未提交的尾段，等待已开始的事务退出，杜绝迟到文本。 */
+    /**
+     * 取消/失败时丢弃尚未提交的尾段并清理定时器，等待已开始的提交退出。
+     * 不会撤销已提交数据库事件；关闭后 push 不再接收新文字。
+     */
+    dispose(): Promise<void>;
+}

package/dist/text-stream.js

@@ -0,0 +1,99 @@
+/**
+ * 将模型零碎文本合并为有序、可等待的持久事件提交。
+ * 运行时传入带租约检查的 emit；首段尽快提交，后续短片段合并 40 毫秒，完成和取消时分别冲刷或丢弃尾段，避免迟到文本越过运行终态。
+ */
+/** 首段立即提交，后续最多合并 40ms；持久化不再阻塞每一个模型 token。 */
+/**
+ * 有序文本批处理器，串行等待 emit 并记住首次提交失败。
+ * 普通 token 不逐个阻塞数据库往返，累计到 2048 字符时主动施加背压；不负责网络重试或重建已经丢弃的文本。
+ */
+export class TextStream {
+    emit;
+    signal;
+    /**
+     * 尚未交给 emit 的文本缓冲，按字符长度触发批次阈值。
+     */
+    pending = '';
+    /**
+     * 短片段合并定时器；冲刷、完成或销毁时清理。
+     */
+    timer;
+    /**
+     * 已排队提交的串行尾 Promise，保证事件顺序。
+     */
+    tail = Promise.resolve();
+    /**
+     * 最近捕获的提交失败；后续 push/finish 重新抛出。
+     */
+    failure;
+    /**
+     * 是否曾提交过非空批次，确保首段不等待定时器。
+     */
+    started = false;
+    /**
+     * 是否已完成或销毁，阻止继续追加。
+     */
+    closed = false;
+    /**
+     * 绑定异步提交回调和运行取消信号；回调负责实际持久化与租约验证，本类不创建事务。
+     */
+    constructor(emit, signal) {
+        this.emit = emit;
+        this.signal = signal;
+    }
+    /**
+     * 追加文本；先检查取消及此前提交失败，再按首段、2048 字符阈值或 40 毫秒定时器触发冲刷。
+     * 关闭后及空文本不再入队；长片段等待提交形成背压，短片段可能先返回。
+     */
+    async push(text) {
+        this.signal.throwIfAborted();
+        if (this.failure)
+            throw this.failure;
+        if (this.closed || !text)
+            return;
+        this.pending += text;
+        // 长片段施加背压，普通 token 则留给短定时器合并，避免数据库往返降低生成速度。
+        if (!this.started || this.pending.length >= 2048)
+            return this.flush();
+        this.timer ??= setTimeout(() => { void this.flush().catch(() => { }); }, 40);
+    }
+    /**
+     * 取走当前缓冲并链接到同一提交 Promise，确保各批次顺序不交错。
+     * 清理定时器，捕获异步失败供本次和后续调用重新抛出，失败后不继续发送排队文本。
+     */
+    flush() {
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        const text = this.pending;
+        this.pending = '';
+        if (text) {
+            this.started = true;
+            this.tail = this.tail.then(async () => {
+                if (this.failure)
+                    return;
+                this.signal.throwIfAborted();
+                await this.emit(text);
+            }).catch(error => { this.failure = error; });
+        }
+        return this.tail.then(() => { if (this.failure)
+            throw this.failure; });
+    }
+    /** 完成事件必须排在最后一段文字提交之后。 */
+    /**
+     * 关闭输入并等待尾段提交；调用方必须在此成功后发布模型完成事件，否则界面可能先看到完成再收到文字。
+     */
+    async finish() { this.closed = true; await this.flush(); }
+    /** 失败/取消后丢弃未提交的尾段，等待已开始的事务退出，杜绝迟到文本。 */
+    /**
+     * 取消/失败时丢弃尚未提交的尾段并清理定时器，等待已开始的提交退出。
+     * 不会撤销已提交数据库事件；关闭后 push 不再接收新文字。
+     */
+    async dispose() {
+        this.closed = true;
+        this.pending = '';
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        await this.tail;
+    }
+}
+//# sourceMappingURL=text-stream.js.map

package/dist/text-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-stream.js","sourceRoot":"","sources":["../src/text-stream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,6CAA6C;AAC7C;;;GAGG;AACH,MAAM,OAAO,UAAU;IA4BQ;IAAwD;IA3BrF;;OAEG;IACK,OAAO,GAAG,EAAE,CAAC;IACrB;;OAEG;IACK,KAAK,CAA4C;IACzD;;OAEG;IACK,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAChD;;OAEG;IACK,OAAO,CAAU;IACzB;;OAEG;IACK,OAAO,GAAG,KAAK,CAAC;IACxB;;OAEG;IACK,MAAM,GAAG,KAAK,CAAC;IACvB;;OAEG;IACH,YAA6B,IAAqC,EAAmB,MAAmB;QAA3E,SAAI,GAAJ,IAAI,CAAiC;QAAmB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAE5G;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;YAAE,OAAO;QACjC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QACrB,4CAA4C;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QACtE,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD;;;OAGG;IACK,KAAK;QACX,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;QAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;gBACpC,IAAI,IAAI,CAAC,OAAO;oBAAE,OAAO;gBACzB,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC7B,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,0BAA0B;IAC1B;;OAEG;IACH,KAAK,CAAC,MAAM,KAAoB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACzE,wCAAwC;IACxC;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACxF,MAAM,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;CACF"}