@xpert-ai/xpert-sdk 0.22.0 → 0.23.0

package/dist/conversation-resource-types.d.ts

@@ -0,0 +1,10 @@
+/** Stable locator in the current authorized conversation. IDs never carry permissions or change Project scope. */
+export type ConversationResourceTarget = {
+    kind: 'project-content';
+    id: string;
+} | {
+    kind: 'group-reference';
+    id: string;
+};
+/** Host-owned navigation through the target's native authorization adapter; no arbitrary URLs or source Project IDs. */
+export declare const WORKBENCH_RESOURCE_OPEN_COMMAND = "workbench.resource.open";

package/dist/conversation-resource-types.js

@@ -0,0 +1,3 @@
+/** Host-owned navigation through the target's native authorization adapter; no arbitrary URLs or source Project IDs. */
+export const WORKBENCH_RESOURCE_OPEN_COMMAND = 'workbench.resource.open';
+//# sourceMappingURL=conversation-resource-types.js.map

package/dist/conversation-resource-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-resource-types.js","sourceRoot":"","sources":["../src/conversation-resource-types.ts"],"names":[],"mappings":"AAKA,wHAAwH;AACxH,MAAM,CAAC,MAAM,+BAA+B,GAAG,yBAAyB,CAAC"}

package/dist/conversation-resource-types.mjs

@@ -0,0 +1,3 @@
+/** Host-owned navigation through the target's native authorization adapter; no arbitrary URLs or source Project IDs. */
+export const WORKBENCH_RESOURCE_OPEN_COMMAND = 'workbench.resource.open';
+//# sourceMappingURL=conversation-resource-types.mjs.map

package/dist/conversation-resource-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-resource-types.mjs","sourceRoot":"","sources":["../src/conversation-resource-types.ts"],"names":[],"mappings":"AAKA,wHAAwH;AACxH,MAAM,CAAC,MAAM,+BAA+B,GAAG,yBAAyB,CAAC"}

package/dist/group-resource-links.d.ts

@@ -0,0 +1,34 @@
+import type { ChatGroupEvent, ChatGroupMessage, ChatGroupResourceLink, ChatGroupResourceOpenRequest, ChatGroupSnapshot } from './group-types.js';
+type LegacyResourceLink = Pick<ChatGroupResourceLink, 'projectId' | 'title'> & ({
+    kind?: 'group-reference';
+    referenceId: string;
+} | {
+    kind: 'project-content';
+    contentId: string;
+});
+export type GroupResourceLinkWire = ChatGroupResourceLink | LegacyResourceLink;
+export type GroupMessageWire = Omit<ChatGroupMessage, 'communication'> & {
+    communication: Omit<ChatGroupMessage['communication'], 'resourceLinks'> & {
+        resourceLinks?: GroupResourceLinkWire[];
+    };
+};
+export type GroupSnapshotWire = Omit<ChatGroupSnapshot, 'messages'> & {
+    messages: GroupMessageWire[];
+};
+export type GroupEventWire = Exclude<ChatGroupEvent, {
+    type: 'snapshot' | 'resource_open';
+}> | {
+    type: 'snapshot';
+    snapshot: GroupSnapshotWire;
+} | {
+    type: 'resource_open';
+    request: GroupResourceLinkWire & Pick<ChatGroupResourceOpenRequest, 'requestId' | 'clientMessageId'>;
+};
+export declare function isResourceUuid(value: unknown): value is string;
+/** Reject ambiguous locators instead of choosing between old and new identities. */
+export declare function parseGroupResourceLink(value: unknown): ChatGroupResourceLink | null;
+export declare function isGroupResourceLinkWire(value: unknown): value is GroupResourceLinkWire;
+export declare function isCanonicalResourceLink(value: GroupResourceLinkWire): value is ChatGroupResourceLink;
+export declare function normalizeGroupMessage(message: GroupMessageWire): ChatGroupMessage;
+export declare function normalizeGroupSnapshot(snapshot: GroupSnapshotWire): ChatGroupSnapshot;
+export {};

package/dist/group-resource-links.js

@@ -0,0 +1,71 @@
+export function isResourceUuid(value) {
+    return (typeof value === 'string' &&
+        /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value));
+}
+/** Reject ambiguous locators instead of choosing between old and new identities. */
+export function parseGroupResourceLink(value) {
+    if (!value ||
+        typeof value !== 'object' ||
+        !('projectId' in value) ||
+        !isResourceUuid(value.projectId) ||
+        !('title' in value) ||
+        typeof value.title !== 'string' ||
+        value.title.length > 200)
+        return null;
+    const base = { projectId: value.projectId, title: value.title };
+    if ('resource' in value) {
+        if ('kind' in value || 'referenceId' in value || 'contentId' in value)
+            return null;
+        const resource = value.resource;
+        if (!resource ||
+            typeof resource !== 'object' ||
+            !('kind' in resource) ||
+            !('id' in resource) ||
+            !isResourceUuid(resource.id) ||
+            (resource.kind !== 'group-reference' && resource.kind !== 'project-content') ||
+            Object.keys(resource).some((key) => key !== 'kind' && key !== 'id'))
+            return null;
+        return { ...base, resource: { kind: resource.kind, id: resource.id } };
+    }
+    if ((!('kind' in value) || value.kind === 'group-reference') &&
+        'referenceId' in value &&
+        isResourceUuid(value.referenceId) &&
+        !('contentId' in value))
+        return { ...base, resource: { kind: 'group-reference', id: value.referenceId } };
+    if ('kind' in value &&
+        value.kind === 'project-content' &&
+        'contentId' in value &&
+        isResourceUuid(value.contentId) &&
+        !('referenceId' in value))
+        return { ...base, resource: { kind: 'project-content', id: value.contentId } };
+    return null;
+}
+export function isGroupResourceLinkWire(value) {
+    return parseGroupResourceLink(value) !== null;
+}
+export function isCanonicalResourceLink(value) {
+    return 'resource' in value;
+}
+export function normalizeGroupMessage(message) {
+    const { resourceLinks, ...communication } = message.communication;
+    if (resourceLinks === undefined)
+        return { ...message, communication };
+    if (!Array.isArray(resourceLinks))
+        throw new Error('Invalid group resource links');
+    return {
+        ...message,
+        communication: {
+            ...communication,
+            resourceLinks: resourceLinks.map((link) => {
+                const parsed = parseGroupResourceLink(link);
+                if (!parsed)
+                    throw new Error('Invalid group resource link');
+                return parsed;
+            }),
+        },
+    };
+}
+export function normalizeGroupSnapshot(snapshot) {
+    return { ...snapshot, messages: snapshot.messages.map(normalizeGroupMessage) };
+}
+//# sourceMappingURL=group-resource-links.js.map

package/dist/group-resource-links.js.map

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

package/dist/group-resource-links.mjs

@@ -0,0 +1,71 @@
+export function isResourceUuid(value) {
+    return (typeof value === 'string' &&
+        /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value));
+}
+/** Reject ambiguous locators instead of choosing between old and new identities. */
+export function parseGroupResourceLink(value) {
+    if (!value ||
+        typeof value !== 'object' ||
+        !('projectId' in value) ||
+        !isResourceUuid(value.projectId) ||
+        !('title' in value) ||
+        typeof value.title !== 'string' ||
+        value.title.length > 200)
+        return null;
+    const base = { projectId: value.projectId, title: value.title };
+    if ('resource' in value) {
+        if ('kind' in value || 'referenceId' in value || 'contentId' in value)
+            return null;
+        const resource = value.resource;
+        if (!resource ||
+            typeof resource !== 'object' ||
+            !('kind' in resource) ||
+            !('id' in resource) ||
+            !isResourceUuid(resource.id) ||
+            (resource.kind !== 'group-reference' && resource.kind !== 'project-content') ||
+            Object.keys(resource).some((key) => key !== 'kind' && key !== 'id'))
+            return null;
+        return { ...base, resource: { kind: resource.kind, id: resource.id } };
+    }
+    if ((!('kind' in value) || value.kind === 'group-reference') &&
+        'referenceId' in value &&
+        isResourceUuid(value.referenceId) &&
+        !('contentId' in value))
+        return { ...base, resource: { kind: 'group-reference', id: value.referenceId } };
+    if ('kind' in value &&
+        value.kind === 'project-content' &&
+        'contentId' in value &&
+        isResourceUuid(value.contentId) &&
+        !('referenceId' in value))
+        return { ...base, resource: { kind: 'project-content', id: value.contentId } };
+    return null;
+}
+export function isGroupResourceLinkWire(value) {
+    return parseGroupResourceLink(value) !== null;
+}
+export function isCanonicalResourceLink(value) {
+    return 'resource' in value;
+}
+export function normalizeGroupMessage(message) {
+    const { resourceLinks, ...communication } = message.communication;
+    if (resourceLinks === undefined)
+        return { ...message, communication };
+    if (!Array.isArray(resourceLinks))
+        throw new Error('Invalid group resource links');
+    return {
+        ...message,
+        communication: {
+            ...communication,
+            resourceLinks: resourceLinks.map((link) => {
+                const parsed = parseGroupResourceLink(link);
+                if (!parsed)
+                    throw new Error('Invalid group resource link');
+                return parsed;
+            }),
+        },
+    };
+}
+export function normalizeGroupSnapshot(snapshot) {
+    return { ...snapshot, messages: snapshot.messages.map(normalizeGroupMessage) };
+}
+//# sourceMappingURL=group-resource-links.mjs.map

package/dist/group-resource-links.mjs.map

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

package/dist/group-types.d.ts

@@ -1,9 +1,16 @@
+import type { ConversationResourceTarget } from './conversation-resource-types.js';
 import type { ChatMessage } from './schema.js';
 import type { XpertProjectTypeRef } from './schema.js';
 import type { RuntimeCapabilitiesSelection } from './schema.js';
 import type { RuntimeResourcesSelection } from './runtime-resources.js';
 /** Snapshots expose public messages; runtime details require workspace read access. */
 export type ChatGroupIntent = 'request' | 'reply' | 'message';
+/**
+ * Completion intent for one sender's answer to one request, independent of delivery/run status.
+ * Progress is a partial answer and does not wake the requester; final completes the answer only
+ * after successful publication. Neither stage accepts or completes a Project task.
+ */
+export type ChatGroupReplyStage = 'progress' | 'final';
 export type ChatGroupDeliveryStatus = 'pending' | 'starting' | 'steering' | 'consumed' | 'blocked' | 'canceled' | 'failed';
 export interface ChatGroupParticipant {
     id: string;
@@ -42,14 +49,14 @@ export interface ChatGroupComposerInput {
 }
 /**
  * Server-authored clickable entry persisted in message history, not an open-on-load instruction.
- * Clicking must reauthorize the reference through the current group's transport.
+ * Clicking reauthorizes the resource through the current conversation's host adapter.
  */
 export interface ChatGroupResourceLink {
-    /** Accepted reference ID, not a source Artifact ID or public share token. */
-    referenceId: string;
-    /** Receiving group's runtime Project; never switch to the source authoring Project. */
+    /** Canonical locator shared with discovery and Workbench. Contains no access grant. */
+    resource: ConversationResourceTarget;
+    /** Receiving group's runtime Project; checked before opening, never a source Project override. */
     projectId: string;
-    /** Display label only; do not infer identity or resource type from it. */
+    /** Display label only; never use it to infer resource identity or type. */
     title: string;
 }
 /** Live, requester-addressed navigation event; consumers match the local send and deduplicate it. */
@@ -97,6 +104,12 @@ export interface ChatGroupCommunication {
     senderId: string;
     recipientIds: string[];
     replyToMessageId?: string;
+    /**
+     * Only valid on replies. Missing on legacy replies means final; new publications include it.
+     * A successfully published final tool reply suppresses the automatic final answer for the same
+     * request and sender. Progress, message and request publications do not suppress that answer.
+     */
+    replyStage?: ChatGroupReplyStage;
     causedByMessageId?: string;
     rootMessageId: string;
     rootUserId: string;
@@ -107,6 +120,19 @@ export interface ChatGroupMessage {
     clientMessageId: string;
     sequence: number;
     text: string;
+    /**
+     * Optional server-filtered result snapshots. May be present with empty text.
+     * IDs are stable within this public message; repeated snapshots replace rather than append blocks.
+     * Known forms use existing ChatKit `resource_card` or `component` (Widget / McpApp) payloads.
+     * Payloads stay opaque at this transport boundary: renderers must validate the concrete type,
+     * ignore unknown forms and never reconnect a copied MCP result to the originating App session.
+     * These blocks confer no resource permissions, do not wake recipients and do not complete replies.
+     */
+    display?: {
+        id: string;
+        type: 'component' | 'resource_card';
+        data: unknown;
+    }[];
     createdAt: string;
     communication: ChatGroupCommunication;
     runtimeParticipantIds?: string[];

package/dist/groups.d.ts

@@ -88,5 +88,7 @@ export declare class GroupsClient {
         data: ChatGroupEvent;
     }>;
 }
-/** Validate the discriminant and payload at the streaming transport boundary. */
+/** Decode compatibility payloads before they enter typed group state or UI navigation. */
+export declare function parseGroupEvent(value: unknown): ChatGroupEvent | null;
+/** Type guard for the canonical contract; legacy wire messages must go through parseGroupEvent. */
 export declare function isGroupEvent(value: unknown): value is ChatGroupEvent;

package/dist/groups.js

@@ -1,3 +1,4 @@
+import { isCanonicalResourceLink, isGroupResourceLinkWire, isResourceUuid, normalizeGroupMessage, normalizeGroupSnapshot, parseGroupResourceLink, } from "./group-resource-links.js";
 import { GroupArtifactsClient } from "./group-artifacts.js";
 /**
  * Group APIs reuse the client's configured ChatKit authentication/refresh hooks.
@@ -46,11 +47,11 @@ export class GroupsClient {
     create(input, options) {
         return this.transport.json('/groups', { ...options, method: 'POST', json: input });
     }
-    get(groupId, options) {
-        return this.transport.json(`/groups/${encodeURIComponent(groupId)}`, {
+    async get(groupId, options) {
+        return normalizeGroupSnapshot(await this.transport.json(`/groups/${encodeURIComponent(groupId)}`, {
             signal: options?.signal,
             params: { before: options?.before, limit: options?.limit },
-        });
+        }));
     }
     runtime(groupId, messageId, participantId, options) {
         return this.transport.json(`/groups/${encodeURIComponent(groupId)}/messages/${encodeURIComponent(messageId)}/runtime/${encodeURIComponent(participantId)}`, options);
@@ -58,12 +59,12 @@ export class GroupsClient {
     composerContext(groupId, participantId, options) {
         return this.transport.json(`/groups/${encodeURIComponent(groupId)}/members/${encodeURIComponent(participantId)}/composer/context`, options);
     }
-    send(groupId, input, options) {
-        return this.transport.json(`/groups/${encodeURIComponent(groupId)}/messages`, {
+    async send(groupId, input, options) {
+        return normalizeGroupMessage(await this.transport.json(`/groups/${encodeURIComponent(groupId)}/messages`, {
             ...options,
             method: 'POST',
             json: input,
-        });
+        }));
     }
     addMember(groupId, input, options) {
         return this.transport.json(`/groups/${encodeURIComponent(groupId)}/members`, {
@@ -100,16 +101,17 @@ export class GroupsClient {
                 throw new Error('Group stream failed');
             if (item.event !== 'group')
                 continue;
-            if (!isGroupEvent(item.data))
+            const data = parseGroupEvent(item.data);
+            if (!data)
                 throw new Error('Invalid group stream event');
-            if (item.data.type === 'snapshot' && item.data.snapshot.id !== groupId)
+            if (data.type === 'snapshot' && data.snapshot.id !== groupId)
                 throw new Error('Group stream scope mismatch');
-            yield { id: item.id, data: item.data };
+            yield { id: item.id, data };
         }
     }
 }
-/** Validate the discriminant and payload at the streaming transport boundary. */
-export function isGroupEvent(value) {
+/** Validate legacy wire payloads only at the transport boundary. */
+function isGroupEventWire(value) {
     if (!value || typeof value !== 'object' || !('type' in value))
         return false;
     if (value.type === 'resync')
@@ -118,22 +120,11 @@ export function isGroupEvent(value) {
         if (!('request' in value) || !value.request || typeof value.request !== 'object')
             return false;
         const r = value.request;
-        const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-        return ('requestId' in r &&
-            typeof r.requestId === 'string' &&
-            uuid.test(r.requestId) &&
+        return (isGroupResourceLinkWire(r) &&
+            'requestId' in r &&
+            isResourceUuid(r.requestId) &&
             'clientMessageId' in r &&
-            typeof r.clientMessageId === 'string' &&
-            uuid.test(r.clientMessageId) &&
-            'referenceId' in r &&
-            typeof r.referenceId === 'string' &&
-            uuid.test(r.referenceId) &&
-            'projectId' in r &&
-            typeof r.projectId === 'string' &&
-            uuid.test(r.projectId) &&
-            'title' in r &&
-            typeof r.title === 'string' &&
-            r.title.length <= 200);
+            isResourceUuid(r.clientMessageId));
     }
     if (value.type === 'text')
         return ('participantId' in value &&
@@ -246,6 +237,10 @@ function isMessage(v) {
         'hop' in c &&
         typeof c.hop === 'number' &&
         (!('replyToMessageId' in c) || typeof c.replyToMessageId === 'string') &&
+        (!('replyStage' in c) ||
+            (c.intent === 'reply' && (c.replyStage === 'progress' || c.replyStage === 'final'))) &&
+        (!('resourceLinks' in c) ||
+            (Array.isArray(c.resourceLinks) && c.resourceLinks.every(isGroupResourceLinkWire))) &&
         'deliveries' in v &&
         Array.isArray(v.deliveries) &&
         v.deliveries.every((d) => !!d &&
@@ -256,4 +251,35 @@ function isMessage(v) {
             typeof d.status === 'string' &&
             ['pending', 'starting', 'steering', 'consumed', 'blocked', 'canceled', 'failed'].includes(d.status)));
 }
+/** Decode compatibility payloads before they enter typed group state or UI navigation. */
+export function parseGroupEvent(value) {
+    if (!isGroupEventWire(value))
+        return null;
+    if (value.type === 'snapshot')
+        return { type: 'snapshot', snapshot: normalizeGroupSnapshot(value.snapshot) };
+    if (value.type === 'resource_open') {
+        const link = parseGroupResourceLink(value.request);
+        return link
+            ? {
+                type: 'resource_open',
+                request: {
+                    ...link,
+                    requestId: value.request.requestId,
+                    clientMessageId: value.request.clientMessageId,
+                },
+            }
+            : null;
+    }
+    return value;
+}
+/** Type guard for the canonical contract; legacy wire messages must go through parseGroupEvent. */
+export function isGroupEvent(value) {
+    if (!isGroupEventWire(value))
+        return false;
+    if (value.type === 'resource_open')
+        return isCanonicalResourceLink(value.request);
+    if (value.type === 'snapshot')
+        return value.snapshot.messages.every((message) => message.communication.resourceLinks?.every(isCanonicalResourceLink) ?? true);
+    return true;
+}
 //# sourceMappingURL=groups.js.map

package/dist/groups.js.map

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

package/dist/groups.mjs

@@ -1,3 +1,4 @@
+import { isCanonicalResourceLink, isGroupResourceLinkWire, isResourceUuid, normalizeGroupMessage, normalizeGroupSnapshot, parseGroupResourceLink, } from "./group-resource-links.mjs";
 import { GroupArtifactsClient } from "./group-artifacts.mjs";
 /**
  * Group APIs reuse the client's configured ChatKit authentication/refresh hooks.
@@ -46,11 +47,11 @@ export class GroupsClient {
     create(input, options) {
         return this.transport.json('/groups', { ...options, method: 'POST', json: input });
     }
-    get(groupId, options) {
-        return this.transport.json(`/groups/${encodeURIComponent(groupId)}`, {
+    async get(groupId, options) {
+        return normalizeGroupSnapshot(await this.transport.json(`/groups/${encodeURIComponent(groupId)}`, {
             signal: options?.signal,
             params: { before: options?.before, limit: options?.limit },
-        });
+        }));
     }
     runtime(groupId, messageId, participantId, options) {
         return this.transport.json(`/groups/${encodeURIComponent(groupId)}/messages/${encodeURIComponent(messageId)}/runtime/${encodeURIComponent(participantId)}`, options);
@@ -58,12 +59,12 @@ export class GroupsClient {
     composerContext(groupId, participantId, options) {
         return this.transport.json(`/groups/${encodeURIComponent(groupId)}/members/${encodeURIComponent(participantId)}/composer/context`, options);
     }
-    send(groupId, input, options) {
-        return this.transport.json(`/groups/${encodeURIComponent(groupId)}/messages`, {
+    async send(groupId, input, options) {
+        return normalizeGroupMessage(await this.transport.json(`/groups/${encodeURIComponent(groupId)}/messages`, {
             ...options,
             method: 'POST',
             json: input,
-        });
+        }));
     }
     addMember(groupId, input, options) {
         return this.transport.json(`/groups/${encodeURIComponent(groupId)}/members`, {
@@ -100,16 +101,17 @@ export class GroupsClient {
                 throw new Error('Group stream failed');
             if (item.event !== 'group')
                 continue;
-            if (!isGroupEvent(item.data))
+            const data = parseGroupEvent(item.data);
+            if (!data)
                 throw new Error('Invalid group stream event');
-            if (item.data.type === 'snapshot' && item.data.snapshot.id !== groupId)
+            if (data.type === 'snapshot' && data.snapshot.id !== groupId)
                 throw new Error('Group stream scope mismatch');
-            yield { id: item.id, data: item.data };
+            yield { id: item.id, data };
         }
     }
 }
-/** Validate the discriminant and payload at the streaming transport boundary. */
-export function isGroupEvent(value) {
+/** Validate legacy wire payloads only at the transport boundary. */
+function isGroupEventWire(value) {
     if (!value || typeof value !== 'object' || !('type' in value))
         return false;
     if (value.type === 'resync')
@@ -118,22 +120,11 @@ export function isGroupEvent(value) {
         if (!('request' in value) || !value.request || typeof value.request !== 'object')
             return false;
         const r = value.request;
-        const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-        return ('requestId' in r &&
-            typeof r.requestId === 'string' &&
-            uuid.test(r.requestId) &&
+        return (isGroupResourceLinkWire(r) &&
+            'requestId' in r &&
+            isResourceUuid(r.requestId) &&
             'clientMessageId' in r &&
-            typeof r.clientMessageId === 'string' &&
-            uuid.test(r.clientMessageId) &&
-            'referenceId' in r &&
-            typeof r.referenceId === 'string' &&
-            uuid.test(r.referenceId) &&
-            'projectId' in r &&
-            typeof r.projectId === 'string' &&
-            uuid.test(r.projectId) &&
-            'title' in r &&
-            typeof r.title === 'string' &&
-            r.title.length <= 200);
+            isResourceUuid(r.clientMessageId));
     }
     if (value.type === 'text')
         return ('participantId' in value &&
@@ -246,6 +237,10 @@ function isMessage(v) {
         'hop' in c &&
         typeof c.hop === 'number' &&
         (!('replyToMessageId' in c) || typeof c.replyToMessageId === 'string') &&
+        (!('replyStage' in c) ||
+            (c.intent === 'reply' && (c.replyStage === 'progress' || c.replyStage === 'final'))) &&
+        (!('resourceLinks' in c) ||
+            (Array.isArray(c.resourceLinks) && c.resourceLinks.every(isGroupResourceLinkWire))) &&
         'deliveries' in v &&
         Array.isArray(v.deliveries) &&
         v.deliveries.every((d) => !!d &&
@@ -256,4 +251,35 @@ function isMessage(v) {
             typeof d.status === 'string' &&
             ['pending', 'starting', 'steering', 'consumed', 'blocked', 'canceled', 'failed'].includes(d.status)));
 }
+/** Decode compatibility payloads before they enter typed group state or UI navigation. */
+export function parseGroupEvent(value) {
+    if (!isGroupEventWire(value))
+        return null;
+    if (value.type === 'snapshot')
+        return { type: 'snapshot', snapshot: normalizeGroupSnapshot(value.snapshot) };
+    if (value.type === 'resource_open') {
+        const link = parseGroupResourceLink(value.request);
+        return link
+            ? {
+                type: 'resource_open',
+                request: {
+                    ...link,
+                    requestId: value.request.requestId,
+                    clientMessageId: value.request.clientMessageId,
+                },
+            }
+            : null;
+    }
+    return value;
+}
+/** Type guard for the canonical contract; legacy wire messages must go through parseGroupEvent. */
+export function isGroupEvent(value) {
+    if (!isGroupEventWire(value))
+        return false;
+    if (value.type === 'resource_open')
+        return isCanonicalResourceLink(value.request);
+    if (value.type === 'snapshot')
+        return value.snapshot.messages.every((message) => message.communication.resourceLinks?.every(isCanonicalResourceLink) ?? true);
+    return true;
+}
 //# sourceMappingURL=groups.mjs.map