@winmatrix/protocol 1.0.5 → 1.0.7

package/dist/chatPresentation.js

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+import { MessageKindSchema } from './messageView.js';
+export const ChatPresentationFinalKind = 'final-response';
+export const CONVERSATION_CHAT_ACCEPTED_SCHEMA_VERSION = 1;
+const PresentationOrderCursorSchema = z.string().regex(/^(0|[1-9]\d*)$/);
+/** 首条消息由服务端分配真实会话 ID 后的 WS 确认帧。 */
+export const ConversationChatAcceptedSchema = z.object({
+    type: z.literal('conversation:chat_accepted'),
+    schemaVersion: z.literal(CONVERSATION_CHAT_ACCEPTED_SCHEMA_VERSION),
+    conversationId: z.string().min(1).max(200),
+});
+/**
+ * user 消息落库回执帧：前端 pending 区据落库 presentationOrder 转正归位。
+ * ack 丢失无补偿——由前端重叠窗口回读自愈（spec §4.2）。
+ */
+export const MessageAckFrameSchema = z.object({
+    type: z.literal('conversation:message_ack'),
+    conversationId: z.string().min(1).max(200),
+    userMessageId: z.string().min(1).max(200),
+    presentationOrder: PresentationOrderCursorSchema,
+    turnKey: z.string().min(1).max(300),
+});
+export const ChatPresentationLifecycleSchema = z.enum([
+    'open',
+    'patch',
+    'settled',
+    'discarded',
+]);
+export const ChatPresentationAnchorSchema = z.object({
+    afterMessageId: z.string().min(1),
+    slot: z.number().int().nonnegative(),
+    tieBreaker: z.string().min(1),
+});
+export const EmployeePresentationAuthorSchema = z.object({
+    kind: z.literal('employee'),
+    roleId: z.string().min(1),
+    digitalEmployeeName: z.string().min(1),
+    digitalEmployeeId: z.string().min(1).optional(),
+});
+export const SystemPresentationAuthorSchema = z.object({
+    kind: z.literal('system'),
+    displayName: z.string().min(1),
+});
+export const UserPresentationAuthorSchema = z.object({
+    kind: z.literal('user'),
+    displayName: z.string().min(1).optional(),
+});
+export const ChatPresentationAuthorSchema = z.discriminatedUnion('kind', [
+    UserPresentationAuthorSchema,
+    EmployeePresentationAuthorSchema,
+    SystemPresentationAuthorSchema,
+]);
+export const ChatPresentationProducerSchema = z.object({
+    module: z.string().min(1),
+    runId: z.string().min(1).optional(),
+    sourceId: z.string().min(1).optional(),
+});
+/**
+ * step 身份嵌套对象（converge-message-id-identity design D2）。
+ * 全字段 optional：旧磁带/DB 事件回读经同一 schema，缺失 step 不拒 parse。
+ */
+export const ChatPresentationStepSchema = z.object({
+    workerBriefId: z.string().min(1).optional(),
+    workerStepId: z.string().min(1).optional(),
+    stepKey: z.string().min(1).optional(),
+    roleId: z.string().min(1).optional(),
+    attemptNo: z.number().int().positive().optional(),
+    repairRound: z.number().int().positive().optional(),
+});
+const ChatPresentationEventBaseSchema = z.object({
+    eventId: z.string().min(1),
+    conversationId: z.string().min(1),
+    turnId: z.string().min(1),
+    presentationId: z.string().min(1),
+    kind: MessageKindSchema,
+    lifecycle: ChatPresentationLifecycleSchema,
+    revision: z.number().int().nonnegative(),
+    /** 服务端发布时刻；仅用于当前页的同锚点因果排序，历史仍按 presentationOrder。 */
+    emittedAt: z.number().int().nonnegative(),
+    anchor: ChatPresentationAnchorSchema,
+    producer: ChatPresentationProducerSchema,
+    author: ChatPresentationAuthorSchema.optional(),
+    payload: z.record(z.string(), z.unknown()),
+    step: ChatPresentationStepSchema.optional(),
+});
+export const ChatPresentationEventSchema = ChatPresentationEventBaseSchema.superRefine((event, context) => {
+    if (event.kind === ChatPresentationFinalKind && !event.author) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'final-response requires an explicit employee or system author',
+            path: ['author'],
+        });
+    }
+});
+const PresentationIntentBaseSchema = z.object({
+    conversationId: z.string().min(1),
+    turnId: z.string().min(1),
+    presentationId: z.string().min(1).optional(),
+    anchor: ChatPresentationAnchorSchema.optional(),
+    afterMessageId: z.string().min(1).optional(),
+    tieBreaker: z.string().min(1).optional(),
+    kind: MessageKindSchema,
+    lifecycle: ChatPresentationLifecycleSchema,
+    producer: ChatPresentationProducerSchema,
+    author: ChatPresentationAuthorSchema.optional(),
+    payload: z.record(z.string(), z.unknown()),
+    // 阻断修复（design D2）：final 族必经 createEvent → PresentationIntentSchema.parse，
+    // zod 默认剥未知键——intent 不带 step 则服务端注入的身份在 publisher 边界静默消失。
+    step: ChatPresentationStepSchema.optional(),
+});
+export const PresentationIntentSchema = PresentationIntentBaseSchema.superRefine((intent, context) => {
+    if (intent.kind === ChatPresentationFinalKind && !intent.author) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'final-response requires an explicit employee or system author',
+            path: ['author'],
+        });
+    }
+});
+export function compareHistoryPresentationOrder(left, right) {
+    if (left.presentationOrder !== right.presentationOrder) {
+        return left.presentationOrder < right.presentationOrder ? -1 : 1;
+    }
+    return left.id.localeCompare(right.id);
+}
+export function compareLivePresentationAnchor(left, right) {
+    if (left.afterMessageId !== right.afterMessageId) {
+        return left.afterMessageId.localeCompare(right.afterMessageId);
+    }
+    if (left.slot !== right.slot)
+        return left.slot - right.slot;
+    return left.tieBreaker.localeCompare(right.tieBreaker);
+}
+/**
+ * execution-surface 消息的合成 presentationId（converge-message-id-identity）。
+ * 与服务端/前端历史拼串字面量 `execution-surface:${turnId}` 逐字等价；
+ * 服务端 3 处 + 前端 3 处拼串改引本 helper（tasks 2.3）。
+ */
+export function executionSurfacePresentationId(turnId) {
+    return `execution-surface:${turnId}`;
+}
+/** brief 过程帧 presentationId 前缀（`brief-message:<briefId>`，同 brief 重试覆盖旧帧）。 */
+export const BRIEF_PROCESS_FRAME_PREFIX = 'brief-message:';
+//# sourceMappingURL=chatPresentation.js.map

package/dist/chatPresentation.js.map

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