@winmatrix/protocol 1.0.4 → 1.0.6

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/constants.d.ts

@@ -7,6 +7,17 @@ export declare const METHODS: {
     readonly TOOL_CALL: "tool.call";
     readonly SESSION_LIST: "session.list";
     readonly SESSION_GET: "session.get";
+    readonly TASK_EVENTS_SUBSCRIBE: "task.events.subscribe";
+    readonly TASK_INSPECT: "task.inspect";
+    readonly TASK_INTERACTION_RESPOND: "task.interaction.respond";
+    readonly TASK_CANCEL_RUN: "task.cancel";
+    readonly TASK_ACTIVE_LIST: "task.active.list";
+    readonly SESSION_SEARCH: "session.search";
+    readonly SESSION_DELETE: "session.delete";
+    readonly AGENT_ENGINE_LIST: "agent.engine.list";
+    readonly AGENT_ENGINE_MODELS: "agent.engine.models";
+    readonly AGENT_ENGINE_OPTIONS: "agent.engine.options";
+    readonly AGENT_ENGINE_PROBE: "agent.engine.probe";
 };
 export declare const EVENTS: {
     readonly TASK_DELTA: "task.delta";
@@ -24,6 +35,8 @@ export declare const EVENTS: {
     readonly AGENT_STOPPED: "agent.stopped";
     readonly AGENT_ERROR: "agent.error";
     readonly WORKSPACE_REPORT: "workspace.report";
+    readonly TASK_EVENT: "task.event";
+    readonly TASK_RESULT: "task.result";
 };
 /** AGENT_BUSY — agent is executing another task */
 export declare const ERROR_CODES: {

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,eAAO,MAAM,OAAO;;;;;;;;CAQV,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;CAgBT,CAAC;AAEX,mDAAmD;AACnD,eAAO,MAAM,WAAW;;CAEd,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAChE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;CAoBV,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;CAmBT,CAAC;AAEX,mDAAmD;AACnD,eAAO,MAAM,WAAW;;CAEd,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAChE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC"}

package/dist/constants.js

@@ -7,6 +7,18 @@ export const METHODS = {
     TOOL_CALL: 'tool.call',
     SESSION_LIST: 'session.list',
     SESSION_GET: 'session.get',
+    /* ── 统一 Agent Engine Gateway Run control（需版本/capability 协商后启用） ── */
+    TASK_EVENTS_SUBSCRIBE: 'task.events.subscribe',
+    TASK_INSPECT: 'task.inspect',
+    TASK_INTERACTION_RESPOND: 'task.interaction.respond',
+    TASK_CANCEL_RUN: 'task.cancel',
+    TASK_ACTIVE_LIST: 'task.active.list',
+    SESSION_SEARCH: 'session.search',
+    SESSION_DELETE: 'session.delete',
+    AGENT_ENGINE_LIST: 'agent.engine.list',
+    AGENT_ENGINE_MODELS: 'agent.engine.models',
+    AGENT_ENGINE_OPTIONS: 'agent.engine.options',
+    AGENT_ENGINE_PROBE: 'agent.engine.probe',
 };
 export const EVENTS = {
     TASK_DELTA: 'task.delta',
@@ -24,6 +36,9 @@ export const EVENTS = {
     AGENT_STOPPED: 'agent.stopped',
     AGENT_ERROR: 'agent.error',
     WORKSPACE_REPORT: 'workspace.report',
+    /* ── 统一 Agent Engine Gateway 标准事件 ── */
+    TASK_EVENT: 'task.event',
+    TASK_RESULT: 'task.result',
 };
 /** AGENT_BUSY — agent is executing another task */
 export const ERROR_CODES = {

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,QAAQ,EAAE,UAAU;IACpB,iBAAiB,EAAE,mBAAmB;IACtC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;CAClB,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,oBAAoB,EAAE,sBAAsB;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;CAC5B,CAAC;AAEX,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,YAAY;CAChB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,QAAQ,EAAE,UAAU;IACpB,iBAAiB,EAAE,mBAAmB;IACtC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,qEAAqE;IACrE,qBAAqB,EAAE,uBAAuB;IAC9C,YAAY,EAAE,cAAc;IAC5B,wBAAwB,EAAE,0BAA0B;IACpD,eAAe,EAAE,aAAa;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,oBAAoB,EAAE,sBAAsB;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,wCAAwC;IACxC,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;CAClB,CAAC;AAEX,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,YAAY;CAChB,CAAC"}

package/dist/helpers.d.ts

@@ -42,4 +42,24 @@ export declare function isSessionGetRequest(frame: ClientInboundFrame): frame is
     params: import('./schemas.js').SessionGetParams;
 };
 export type { InboundFrame };
+/**
+ * 通用 frame logger redaction：深拷贝输入并将 sensitive binding 值替换为
+ * '[redacted]'。callback token、capability token、credential reference 值
+ * 不得进入普通 frame 日志、RPC audit、task metadata、trace 或 crash dump。
+ */
+export declare function redactFrameForLogging<T>(frame: T): T;
+/**
+ * 旧 TaskAssignParams.mcpToken 的显式兼容映射。
+ * 新路径禁止继续直接读取 mcpToken；完成 daemon 灰度后删除旧字段。
+ */
+export declare function mapLegacyMcpTokenToSecretBindings(params: {
+    mcpToken?: string;
+    secretBindings?: {
+        mcpCapabilityToken?: string;
+        credentialReferences?: string[];
+    };
+}): {
+    mcpCapabilityToken?: string;
+    credentialReferences?: string[];
+} | undefined;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgBrD,wBAAgB,uBAAuB,CACrC,CAAC,SAAS;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC7E,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB,EACD,MAAM,EAAE,CAAC,GAAG,CAAC,CAcd;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,CAMvF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAM5E;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAE3E;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,SAAS,CASX;AAID,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CA4BjE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAI9D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIxD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,IAAI,YAAY,CAE3E;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,IAAI,SAAS,CAErE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,IAAI,WAAW,CAEzE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,GACxB,KAAK,IAAI,WAAW,GAAG;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAErD;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,GACxB,KAAK,IAAI,SAAS,GAAG;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAErD;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,GACxB,KAAK,IAAI,SAAS,GAAG;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAErD;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,GACxB,KAAK,IAAI,WAAW,GAAG;IAAE,MAAM,EAAE,OAAO,cAAc,EAAE,iBAAiB,CAAA;CAAE,CAE7E;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,GACxB,KAAK,IAAI,WAAW,GAAG;IAAE,MAAM,EAAE,OAAO,cAAc,EAAE,gBAAgB,CAAA;CAAE,CAE5E;AAED,YAAY,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}

package/dist/helpers.js

@@ -131,4 +131,68 @@ export function isSessionListRequest(frame) {
 export function isSessionGetRequest(frame) {
     return frame.type === 'req' && frame.method === METHODS.SESSION_GET;
 }
+/* ── Sensitive bindings redaction（任务 1.5） ── */
+/**
+ * 敏感字段名集合：通用 frame logger / RPC audit / trace 遇到这些 key 时
+ * 必须替换值，最多记录 schema version/key/count。
+ */
+const SENSITIVE_VALUE_KEYS = new Set([
+    'mcpToken',
+    'mcpCapabilityToken',
+    'token',
+    'apiKey',
+    'secretBindings',
+    'dynamicSecrets',
+    'credentialReferences',
+    'callback',
+]);
+const REDACTED = '[redacted]';
+function redactValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => redactValue(item));
+    }
+    if (isRecord(value)) {
+        const out = {};
+        for (const [key, child] of Object.entries(value)) {
+            out[key] = SENSITIVE_VALUE_KEYS.has(key) ? redactSubtree(child) : redactValue(child);
+        }
+        return out;
+    }
+    return value;
+}
+/** 敏感子树整体脱敏：对象保留 key、值替换为 [redacted]。 */
+function redactSubtree(value) {
+    if (Array.isArray(value)) {
+        return value.map(() => REDACTED);
+    }
+    if (isRecord(value)) {
+        const out = {};
+        for (const key of Object.keys(value)) {
+            out[key] = REDACTED;
+        }
+        return out;
+    }
+    return REDACTED;
+}
+/**
+ * 通用 frame logger redaction：深拷贝输入并将 sensitive binding 值替换为
+ * '[redacted]'。callback token、capability token、credential reference 值
+ * 不得进入普通 frame 日志、RPC audit、task metadata、trace 或 crash dump。
+ */
+export function redactFrameForLogging(frame) {
+    return redactValue(frame);
+}
+/**
+ * 旧 TaskAssignParams.mcpToken 的显式兼容映射。
+ * 新路径禁止继续直接读取 mcpToken；完成 daemon 灰度后删除旧字段。
+ */
+export function mapLegacyMcpTokenToSecretBindings(params) {
+    if (params.secretBindings) {
+        return params.secretBindings;
+    }
+    if (params.mcpToken) {
+        return { mcpCapabilityToken: params.mcpToken };
+    }
+    return undefined;
+}
 //# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAYjD,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAE/C,SAAS,QAAQ,CAAC,CAAS;IACzB,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAMrC,MAAS;IACT,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAE5B,MAAM,gBAAgB,GAAiB,EAAE,GAAG,OAAO,EAAE,CAAC;IAEtD,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC5C,gBAAgB,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC1C,gBAAgB,CAAC,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,MAAc,EAAE,MAAgB;IACxE,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IACvD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,OAAiB;IAC5D,MAAM,KAAK,GAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,KAAa;IAC3D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAMD,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,OAAiB,EACjB,OAA4B;IAE5B,MAAM,KAAK,GAAc,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAClD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACrE,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC9C,OAAO,IAA+B,CAAC;QACzC,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC3E,OAAO,IAA4B,CAAC;QACtC,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACrE,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7E,OAAO,IAA8B,CAAC;QACxC,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAyB;IAC/C,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAyB;IACjD,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAyB;IAEzB,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAyB;IAEzB,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,WAAW,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAyB;IAEzB,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,WAAW,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAyB;IAEzB,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAyB;IAEzB,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC;AACtE,CAAC;AAID,gDAAgD;AAEhD;;;GAGG;AACH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,UAAU;IACV,oBAAoB;IACpB,OAAO;IACP,QAAQ;IACR,gBAAgB;IAChB,gBAAgB;IAChB,sBAAsB;IACtB,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,GAAG,CAAC,GAAG,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yCAAyC;AACzC,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAI,KAAQ;IAC/C,OAAO,WAAW,CAAC,KAAK,CAAM,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAGjD;IACC,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,cAAc,CAAC;IAC/B,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,9 @@
 export * from './schemas.js';
+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,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"}

package/dist/index.js

@@ -1,5 +1,9 @@
 export * from './schemas.js';
+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.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","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"}

package/dist/mcpUrl.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MCP Bridge URL 统一校验原语。
+ *
+ * 部署场景预期 cluster-internal endpoint（如 http://winmatrix:3000/mcp），
+ * 因此不拦截私网段/无点主机名；只校验 scheme 与 host 非空。
+ */
+export interface McpUrlValidationResult {
+    valid: true;
+}
+export interface McpUrlValidationFailure {
+    valid: false;
+    reason: 'EMPTY' | 'INVALID_URL' | 'MISSING_SCHEME' | 'UNSUPPORTED_SCHEME' | 'MISSING_HOST';
+}
+export type ValidateMcpUrlResult = McpUrlValidationResult | McpUrlValidationFailure;
+export declare function validateMcpUrl(url: string): ValidateMcpUrlResult;
+export declare function isMcpUrlValid(url: string): boolean;
+/** 人类可读 reason → 英文标签（用于日志/错误码）。 */
+export declare function mcpUrlFailureReasonToCode(reason: McpUrlValidationFailure['reason']): string;
+//# sourceMappingURL=mcpUrl.d.ts.map

package/dist/mcpUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpUrl.d.ts","sourceRoot":"","sources":["../src/mcpUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EACF,OAAO,GACP,aAAa,GACb,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,uBAAuB,CAAC;AAIpF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAwBhE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,oCAAoC;AACpC,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAe3F"}

package/dist/mcpUrl.js

@@ -0,0 +1,51 @@
+/**
+ * MCP Bridge URL 统一校验原语。
+ *
+ * 部署场景预期 cluster-internal endpoint（如 http://winmatrix:3000/mcp），
+ * 因此不拦截私网段/无点主机名；只校验 scheme 与 host 非空。
+ */
+const SUPPORTED_SCHEMES = new Set(['http:', 'https:']);
+export function validateMcpUrl(url) {
+    const trimmed = url.trim();
+    if (trimmed.length === 0) {
+        return { valid: false, reason: 'EMPTY' };
+    }
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        return { valid: false, reason: 'INVALID_URL' };
+    }
+    if (!parsed.protocol || parsed.protocol.length === 0) {
+        return { valid: false, reason: 'MISSING_SCHEME' };
+    }
+    if (!SUPPORTED_SCHEMES.has(parsed.protocol.toLowerCase())) {
+        return { valid: false, reason: 'UNSUPPORTED_SCHEME' };
+    }
+    if (!parsed.hostname || parsed.hostname.length === 0) {
+        return { valid: false, reason: 'MISSING_HOST' };
+    }
+    return { valid: true };
+}
+export function isMcpUrlValid(url) {
+    return validateMcpUrl(url).valid;
+}
+/** 人类可读 reason → 英文标签（用于日志/错误码）。 */
+export function mcpUrlFailureReasonToCode(reason) {
+    switch (reason) {
+        case 'EMPTY':
+            return 'MCP_BRIDGE_URL_EMPTY';
+        case 'INVALID_URL':
+            return 'MCP_BRIDGE_URL_INVALID';
+        case 'MISSING_SCHEME':
+            return 'MCP_BRIDGE_URL_MISSING_SCHEME';
+        case 'UNSUPPORTED_SCHEME':
+            return 'MCP_BRIDGE_URL_UNSUPPORTED_SCHEME';
+        case 'MISSING_HOST':
+            return 'MCP_BRIDGE_URL_MISSING_HOST';
+        default:
+            return 'MCP_BRIDGE_URL_INVALID';
+    }
+}
+//# sourceMappingURL=mcpUrl.js.map

package/dist/mcpUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpUrl.js","sourceRoot":"","sources":["../src/mcpUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEvD,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;AACnC,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,yBAAyB,CAAC,MAAyC;IACjF,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,sBAAsB,CAAC;QAChC,KAAK,aAAa;YAChB,OAAO,wBAAwB,CAAC;QAClC,KAAK,gBAAgB;YACnB,OAAO,+BAA+B,CAAC;QACzC,KAAK,oBAAoB;YACvB,OAAO,mCAAmC,CAAC;QAC7C,KAAK,cAAc;YACjB,OAAO,6BAA6B,CAAC;QACvC;YACE,OAAO,wBAAwB,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/messageView.d.ts

@@ -0,0 +1,156 @@
+import { z } from 'zod';
+/**
+ * 消息上屏管线协议 v2 的消息 DTO（spec §4.1b-3）。
+ * MessageView 是历史/实时统一的消息投影：前端不再解释 projection envelope。
+ */
+export declare const MessageKindSchema: z.ZodEnum<["final-response", "final-draft", "transient-thinking", "tool-execution", "orchestration", "execution-surface", "artifacts"]>;
+export type MessageKind = z.infer<typeof MessageKindSchema>;
+export declare const MessageAuthorSchema: 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 type MessageAuthor = z.infer<typeof MessageAuthorSchema>;
+export declare const MessageViewSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["final-response", "final-draft", "transient-thinking", "tool-execution", "orchestration", "execution-surface", "artifacts"]>;
+    turnKey: z.ZodString;
+    parentUserMessageId: z.ZodString;
+    workerBriefId: z.ZodOptional<z.ZodString>;
+    presentationOrder: z.ZodString;
+    author: 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;
+    }>]>;
+    content: z.ZodString;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    anchor: z.ZodOptional<z.ZodObject<{
+        afterMessageId: z.ZodString;
+        slot: z.ZodNumber;
+        tieBreaker: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: number;
+    }, {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: number;
+    }>>;
+    createdAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    content: string;
+    createdAt: number;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    turnKey: string;
+    parentUserMessageId: string;
+    presentationOrder: string;
+    author: {
+        kind: "user";
+        displayName?: string | undefined;
+    } | {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    };
+    workerBriefId?: string | undefined;
+    attachments?: unknown[] | undefined;
+    anchor?: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: number;
+    } | undefined;
+}, {
+    id: string;
+    content: string;
+    createdAt: number;
+    kind: "artifacts" | "final-response" | "final-draft" | "transient-thinking" | "tool-execution" | "orchestration" | "execution-surface";
+    turnKey: string;
+    parentUserMessageId: string;
+    presentationOrder: string;
+    author: {
+        kind: "user";
+        displayName?: string | undefined;
+    } | {
+        roleId: string;
+        kind: "employee";
+        digitalEmployeeName: string;
+        digitalEmployeeId?: string | undefined;
+    } | {
+        kind: "system";
+        displayName: string;
+    };
+    workerBriefId?: string | undefined;
+    attachments?: unknown[] | undefined;
+    anchor?: {
+        afterMessageId: string;
+        slot: number;
+        tieBreaker: number;
+    } | undefined;
+}>;
+export type MessageView = z.infer<typeof MessageViewSchema>;
+//# sourceMappingURL=messageView.d.ts.map

package/dist/messageView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageView.d.ts","sourceRoot":"","sources":["../src/messageView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,iBAAiB,yIAG5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/messageView.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+/**
+ * 消息上屏管线协议 v2 的消息 DTO（spec §4.1b-3）。
+ * MessageView 是历史/实时统一的消息投影：前端不再解释 projection envelope。
+ */
+export const MessageKindSchema = z.enum([
+    'final-response', 'final-draft', 'transient-thinking',
+    'tool-execution', 'orchestration', 'execution-surface', 'artifacts',
+]);
+export const MessageAuthorSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('user'), displayName: z.string().min(1).optional() }),
+    z.object({ kind: z.literal('employee'), roleId: z.string().min(1),
+        digitalEmployeeName: z.string().min(1), digitalEmployeeId: z.string().optional() }),
+    z.object({ kind: z.literal('system'), displayName: z.string().min(1) }),
+]);
+export const MessageViewSchema = z.object({
+    id: z.string().min(1),
+    kind: MessageKindSchema,
+    turnKey: z.string().min(1),
+    parentUserMessageId: z.string().min(1),
+    workerBriefId: z.string().optional(),
+    presentationOrder: z.string().min(1), // BigInt 十进制字符串，稀疏
+    author: MessageAuthorSchema,
+    content: z.string(),
+    attachments: z.array(z.unknown()).optional(),
+    anchor: z.object({ afterMessageId: z.string(), slot: z.number().int(), tieBreaker: z.number().int() }).optional(),
+    createdAt: z.number().int(), // epoch ms，禁 toISOString 字符串
+});
+//# sourceMappingURL=messageView.js.map

package/dist/messageView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageView.js","sourceRoot":"","sources":["../src/messageView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,gBAAgB,EAAE,aAAa,EAAE,oBAAoB;IACrD,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW;CACpE,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC9D,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;IAChF,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC9F,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;CACxE,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAO,mBAAmB;IAC9D,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IACjH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAgB,6BAA6B;CACzE,CAAC,CAAC"}