@winmatrix/protocol 1.0.5 → 1.0.6

package/dist/chatPresentation.d.ts

@@ -0,0 +1,548 @@
+import { z } from 'zod';
+export declare const ChatPresentationFinalKind = "final-response";
+export declare const CONVERSATION_CHAT_ACCEPTED_SCHEMA_VERSION = 1;
+/** 首条消息由服务端分配真实会话 ID 后的 WS 确认帧。 */
+export declare const ConversationChatAcceptedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation:chat_accepted">;
+    schemaVersion: z.ZodLiteral<1>;
+    conversationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "conversation:chat_accepted";
+    schemaVersion: 1;
+    conversationId: string;
+}, {
+    type: "conversation:chat_accepted";
+    schemaVersion: 1;
+    conversationId: string;
+}>;
+/**
+ * user 消息落库回执帧：前端 pending 区据落库 presentationOrder 转正归位。
+ * ack 丢失无补偿——由前端重叠窗口回读自愈（spec §4.2）。
+ */
+export declare const MessageAckFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation:message_ack">;
+    conversationId: z.ZodString;
+    userMessageId: z.ZodString;
+    presentationOrder: z.ZodString;
+    turnKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "conversation:message_ack";
+    turnKey: string;
+    presentationOrder: string;
+    conversationId: string;
+    userMessageId: string;
+}, {
+    type: "conversation:message_ack";
+    turnKey: string;
+    presentationOrder: string;
+    conversationId: string;
+    userMessageId: string;
+}>;
+export declare const ChatPresentationLifecycleSchema: z.ZodEnum<["open", "patch", "settled", "discarded"]>;
+export declare const ChatPresentationAnchorSchema: z.ZodObject<{
+    afterMessageId: z.ZodString;
+    slot: z.ZodNumber;
+    tieBreaker: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    afterMessageId: string;
+    slot: number;
+    tieBreaker: string;
+}, {
+    afterMessageId: string;
+    slot: number;
+    tieBreaker: string;
+}>;
+export declare const EmployeePresentationAuthorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"employee">;
+    roleId: z.ZodString;
+    digitalEmployeeName: z.ZodString;
+    digitalEmployeeId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    roleId: string;
+    kind: "employee";
+    digitalEmployeeName: string;
+    digitalEmployeeId?: string | undefined;
+}, {
+    roleId: string;
+    kind: "employee";
+    digitalEmployeeName: string;
+    digitalEmployeeId?: string | undefined;
+}>;
+export declare const SystemPresentationAuthorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"system">;
+    displayName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "system";
+    displayName: string;
+}, {
+    kind: "system";
+    displayName: string;
+}>;
+export declare const UserPresentationAuthorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"user">;
+    displayName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "user";
+    displayName?: string | undefined;
+}, {
+    kind: "user";
+    displayName?: string | undefined;
+}>;
+export declare const ChatPresentationAuthorSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"user">;
+    displayName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "user";
+    displayName?: string | undefined;
+}, {
+    kind: "user";
+    displayName?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"employee">;
+    roleId: z.ZodString;
+    digitalEmployeeName: z.ZodString;
+    digitalEmployeeId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    roleId: string;
+    kind: "employee";
+    digitalEmployeeName: string;
+    digitalEmployeeId?: string | undefined;
+}, {
+    roleId: string;
+    kind: "employee";
+    digitalEmployeeName: string;
+    digitalEmployeeId?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"system">;
+    displayName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "system";
+    displayName: string;
+}, {
+    kind: "system";
+    displayName: string;
+}>]>;
+export declare const ChatPresentationProducerSchema: z.ZodObject<{
+    module: z.ZodString;
+    runId: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    module: string;
+    runId?: string | undefined;
+    sourceId?: string | undefined;
+}, {
+    module: string;
+    runId?: string | undefined;
+    sourceId?: string | undefined;
+}>;
+export declare const ChatPresentationEventSchema: z.ZodEffects<z.ZodObject<{
+    eventId: z.ZodString;
+    conversationId: z.ZodString;
+    turnId: z.ZodString;
+    presentationId: z.ZodString;
+    kind: z.ZodEnum<["final-response", "final-draft", "transient-thinking", "tool-execution", "orchestration", "execution-surface", "artifacts"]>;
+    lifecycle: z.ZodEnum<["open", "patch", "settled", "discarded"]>;
+    revision: z.ZodNumber;
+    /** 服务端发布时刻；仅用于当前页的同锚点因果排序，历史仍按 presentationOrder。 */
+    emittedAt: z.ZodNumber;
+    anchor: z.ZodObject<{
+        afterMessageId: z.ZodString;
+        slot: z.ZodNumber;
+        tieBreaker: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    }, {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    }>;
+    producer: z.ZodObject<{
+        module: z.ZodString;
+        runId: z.ZodOptional<z.ZodString>;
+        sourceId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    }, {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    }>;
+    author: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"user">;
+        displayName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "user";
+        displayName?: string | undefined;
+    }, {
+        kind: "user";
+        displayName?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"employee">;
+        roleId: z.ZodString;
+        digitalEmployeeName: z.ZodString;
+        digitalEmployeeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    }, {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"system">;
+        displayName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "system";
+        displayName: string;
+    }, {
+        kind: "system";
+        displayName: string;
+    }>]>>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    payload: Record<string, unknown>;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    anchor: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    };
+    conversationId: string;
+    eventId: string;
+    turnId: string;
+    presentationId: string;
+    lifecycle: "open" | "patch" | "settled" | "discarded";
+    revision: number;
+    emittedAt: number;
+    producer: {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    };
+    author?: {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    } | {
+        kind: "user";
+        displayName?: string | undefined;
+    } | undefined;
+}, {
+    payload: Record<string, unknown>;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    anchor: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    };
+    conversationId: string;
+    eventId: string;
+    turnId: string;
+    presentationId: string;
+    lifecycle: "open" | "patch" | "settled" | "discarded";
+    revision: number;
+    emittedAt: number;
+    producer: {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    };
+    author?: {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    } | {
+        kind: "user";
+        displayName?: string | undefined;
+    } | undefined;
+}>, {
+    payload: Record<string, unknown>;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    anchor: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    };
+    conversationId: string;
+    eventId: string;
+    turnId: string;
+    presentationId: string;
+    lifecycle: "open" | "patch" | "settled" | "discarded";
+    revision: number;
+    emittedAt: number;
+    producer: {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    };
+    author?: {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    } | {
+        kind: "user";
+        displayName?: string | undefined;
+    } | undefined;
+}, {
+    payload: Record<string, unknown>;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    anchor: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    };
+    conversationId: string;
+    eventId: string;
+    turnId: string;
+    presentationId: string;
+    lifecycle: "open" | "patch" | "settled" | "discarded";
+    revision: number;
+    emittedAt: number;
+    producer: {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    };
+    author?: {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    } | {
+        kind: "user";
+        displayName?: string | undefined;
+    } | undefined;
+}>;
+export declare const PresentationIntentSchema: z.ZodEffects<z.ZodObject<{
+    conversationId: z.ZodString;
+    turnId: z.ZodString;
+    presentationId: z.ZodOptional<z.ZodString>;
+    anchor: z.ZodOptional<z.ZodObject<{
+        afterMessageId: z.ZodString;
+        slot: z.ZodNumber;
+        tieBreaker: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    }, {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    }>>;
+    afterMessageId: z.ZodOptional<z.ZodString>;
+    tieBreaker: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<["final-response", "final-draft", "transient-thinking", "tool-execution", "orchestration", "execution-surface", "artifacts"]>;
+    lifecycle: z.ZodEnum<["open", "patch", "settled", "discarded"]>;
+    producer: z.ZodObject<{
+        module: z.ZodString;
+        runId: z.ZodOptional<z.ZodString>;
+        sourceId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    }, {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    }>;
+    author: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"user">;
+        displayName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "user";
+        displayName?: string | undefined;
+    }, {
+        kind: "user";
+        displayName?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"employee">;
+        roleId: z.ZodString;
+        digitalEmployeeName: z.ZodString;
+        digitalEmployeeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    }, {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"system">;
+        displayName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "system";
+        displayName: string;
+    }, {
+        kind: "system";
+        displayName: string;
+    }>]>>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    payload: Record<string, unknown>;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    conversationId: string;
+    turnId: string;
+    lifecycle: "open" | "patch" | "settled" | "discarded";
+    producer: {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    };
+    author?: {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    } | {
+        kind: "user";
+        displayName?: string | undefined;
+    } | undefined;
+    afterMessageId?: string | undefined;
+    tieBreaker?: string | undefined;
+    anchor?: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    } | undefined;
+    presentationId?: string | undefined;
+}, {
+    payload: Record<string, unknown>;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    conversationId: string;
+    turnId: string;
+    lifecycle: "open" | "patch" | "settled" | "discarded";
+    producer: {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    };
+    author?: {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    } | {
+        kind: "user";
+        displayName?: string | undefined;
+    } | undefined;
+    afterMessageId?: string | undefined;
+    tieBreaker?: string | undefined;
+    anchor?: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    } | undefined;
+    presentationId?: string | undefined;
+}>, {
+    payload: Record<string, unknown>;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    conversationId: string;
+    turnId: string;
+    lifecycle: "open" | "patch" | "settled" | "discarded";
+    producer: {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    };
+    author?: {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    } | {
+        kind: "user";
+        displayName?: string | undefined;
+    } | undefined;
+    afterMessageId?: string | undefined;
+    tieBreaker?: string | undefined;
+    anchor?: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    } | undefined;
+    presentationId?: string | undefined;
+}, {
+    payload: Record<string, unknown>;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    conversationId: string;
+    turnId: string;
+    lifecycle: "open" | "patch" | "settled" | "discarded";
+    producer: {
+        module: string;
+        runId?: string | undefined;
+        sourceId?: string | undefined;
+    };
+    author?: {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    } | {
+        kind: "user";
+        displayName?: string | undefined;
+    } | undefined;
+    afterMessageId?: string | undefined;
+    tieBreaker?: string | undefined;
+    anchor?: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: string;
+    } | undefined;
+    presentationId?: string | undefined;
+}>;
+export interface HistoryPresentationOrderEntry {
+    presentationOrder: bigint;
+    id: string;
+}
+export declare function compareHistoryPresentationOrder(left: HistoryPresentationOrderEntry, right: HistoryPresentationOrderEntry): number;
+export declare function compareLivePresentationAnchor(left: ChatPresentationAnchor, right: ChatPresentationAnchor): number;
+export type ChatPresentationLifecycle = z.infer<typeof ChatPresentationLifecycleSchema>;
+export type ConversationChatAccepted = z.infer<typeof ConversationChatAcceptedSchema>;
+export type MessageAckFrame = z.infer<typeof MessageAckFrameSchema>;
+export type ChatPresentationAnchor = z.infer<typeof ChatPresentationAnchorSchema>;
+export type EmployeePresentationAuthor = z.infer<typeof EmployeePresentationAuthorSchema>;
+export type SystemPresentationAuthor = z.infer<typeof SystemPresentationAuthorSchema>;
+export type ChatPresentationAuthor = z.infer<typeof ChatPresentationAuthorSchema>;
+export type ChatPresentationProducer = z.infer<typeof ChatPresentationProducerSchema>;
+export type ChatPresentationEvent = z.infer<typeof ChatPresentationEventSchema>;
+export type PresentationIntent = z.infer<typeof PresentationIntentSchema>;
+//# sourceMappingURL=chatPresentation.d.ts.map

package/dist/chatPresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatPresentation.d.ts","sourceRoot":"","sources":["../src/chatPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,yBAAyB,mBAAmB,CAAC;AAC1D,eAAO,MAAM,yCAAyC,IAAI,CAAC;AAI3D,mCAAmC;AACnC,eAAO,MAAM,8BAA8B;;;;;;;;;;;;EAIzC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AAEH,eAAO,MAAM,+BAA+B,sDAK1C,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;EAIvC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;EAK3C,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;EAGzC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;EAGvC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIvC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;EAIzC,CAAC;AAkBH,eAAO,MAAM,2BAA2B;;;;;;;;IARtC,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBrD,CAAC;AAgBH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQnC,CAAC;AAEH,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,6BAA6B,EACnC,KAAK,EAAE,6BAA6B,GACnC,MAAM,CAKR;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,sBAAsB,EAC5B,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CAMR;AAED,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/chatPresentation.js

@@ -0,0 +1,118 @@
+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(),
+});
+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()),
+});
+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()),
+});
+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);
+}
+//# 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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"}

package/dist/index.d.ts

@@ -3,4 +3,7 @@ export * from './agentEngine.js';
 export * from './constants.js';
 export * from './types.js';
 export * from './helpers.js';
+export * from './chatPresentation.js';
+export * from './messageView.js';
+export * from './mcpUrl.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}