dooers-agents-client 0.9.2 → 0.9.3

package/dist/main.d.cts

@@ -115,6 +115,8 @@ interface AudioDisplayPart {
     mimeType?: string;
     duration?: number;
     filename?: string;
+    /** Upload ref when present on the wire (replay / blob key correlation). */
+    refId?: string;
 }
 interface ImageDisplayPart {
     type: 'image';
@@ -124,6 +126,7 @@ interface ImageDisplayPart {
     height?: number;
     alt?: string;
     filename?: string;
+    refId?: string;
 }
 interface DocumentDisplayPart {
     type: 'document';
@@ -131,6 +134,7 @@ interface DocumentDisplayPart {
     filename?: string;
     mimeType?: string;
     sizeBytes?: number;
+    refId?: string;
 }
 type DisplayContentPart = TextDisplayPart | AudioDisplayPart | ImageDisplayPart | DocumentDisplayPart;
 type ContentPart = SendContentPart;
@@ -230,6 +234,8 @@ interface User {
     userId: string;
     userName?: string | null;
     userEmail?: string | null;
+    userMobileNumber?: string | null;
+    userWhatsappNumber?: string | null;
     identityIds?: string[];
     systemRole: string;
     organizationRole: string;
@@ -414,11 +420,15 @@ interface AgentConnectionConfig {
     userId?: string;
     userName?: string;
     userEmail?: string;
+    userMobileNumber?: string;
+    userWhatsappNumber?: string;
     identityIds?: string[];
     systemRole?: string;
     organizationRole?: string;
     workspaceRole?: string;
     authToken?: string;
+    channel?: string;
+    channelMeta?: Record<string, unknown>;
 }
 type OnErrorCallback = (error: {
     code: string;
@@ -523,6 +533,7 @@ declare class AgentClient {
         formEventId: string;
         cancelled: boolean;
         values: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
     }): Promise<{
         threadId: string;
     }>;
@@ -532,6 +543,7 @@ declare class AgentClient {
     private route;
     private scheduleReconnect;
     private send;
+    private withChannelMetadata;
     private sendRaw;
     /** Resolve relative URLs in event content parts against the agent's HTTP base. */
     private resolveEventUrls;
@@ -694,16 +706,23 @@ interface AgentProviderProps {
     userId?: string;
     userName?: string;
     userEmail?: string;
+    userMobileNumber?: string;
+    userWhatsappNumber?: string;
     identityIds?: string[];
     systemRole?: string;
     organizationRole?: string;
     workspaceRole?: string;
     authToken?: string;
+    channel?: string;
+    channelMeta?: Record<string, unknown>;
     uploadUrl?: string;
     onError?: OnErrorCallback;
     children: ReactNode;
 }
-declare function AgentProvider({ url, agentId, organizationId, workspaceId, userId, userName, userEmail, identityIds, systemRole, organizationRole, workspaceRole, authToken, uploadUrl, onError, children, }: AgentProviderProps): react_jsx_runtime.JSX.Element;
+declare function AgentProvider({ url, agentId, organizationId, workspaceId, userId, userName, userEmail, userMobileNumber, userWhatsappNumber, identityIds, systemRole, organizationRole, workspaceRole, authToken, channel, channelMeta, uploadUrl, onError, children, }: AgentProviderProps): react_jsx_runtime.JSX.Element;
 declare function useAgentContext(): AgentContextValue;
 
-export { type Actor, type AgentConnectionConfig, AgentProvider, type AgentProviderProps, AgentServerClient, type AnalyticsEvent, type AudioDisplayPart, type AudioPart, type AudioSendPart, type ConnectionStatus, type ContentPart, type DisplayContentPart, type DocumentDisplayPart, type DocumentPart, type DocumentSendPart, type EventType, type FeedbackTarget, type FeedbackType, type FormCheckboxElement, type FormElement, type FormEventData, type FormFileElement, type FormFileMetadata, type FormOption, type FormRadioElement, type FormResponseEventData, type FormSelectElement, type FormSize, type FormTextElement, type FormTextareaElement, type ImageDisplayPart, type ImagePart, type ImageSendPart, type OnErrorCallback, type PublicSettingsSchemaResult, type Run, type RunStatus, type SendContentPart, type SettingsField, type SettingsFieldGroup, type SettingsFieldType, type SettingsFieldVisibility, type SettingsFileMetadata, type SettingsItem, type SettingsSelectOption, type TextDisplayPart, type TextPart, type TextSendPart, type Thread, type ThreadEvent, type ThreadState, type UploadResult, type User, apiMessagesUrlToWebSocketUrl, isSettingsFieldGroup, toFormElement, toFormEventData, toFormResponseEventData, useAgentContext, useAnalytics, useAudioRecorder, useConnection, useFeedback, useForm, useFormFileUpload, useMessage, useSettings, useSettingsFileUpload, useThreadDetails, useThreadEvents, useThreadsActions, useThreadsList, useUpload };
+/** Must match `package.json` `"version"` (connect frame telemetry). */
+declare const PACKAGE_VERSION: "0.9.3";
+
+export { type Actor, type AgentConnectionConfig, AgentProvider, type AgentProviderProps, AgentServerClient, type AnalyticsEvent, type AudioDisplayPart, type AudioPart, type AudioSendPart, type ConnectionStatus, type ContentPart, type DisplayContentPart, type DocumentDisplayPart, type DocumentPart, type DocumentSendPart, type EventType, type FeedbackTarget, type FeedbackType, type FormCheckboxElement, type FormElement, type FormEventData, type FormFileElement, type FormFileMetadata, type FormOption, type FormRadioElement, type FormResponseEventData, type FormSelectElement, type FormSize, type FormTextElement, type FormTextareaElement, type ImageDisplayPart, type ImagePart, type ImageSendPart, type OnErrorCallback, PACKAGE_VERSION, type PublicSettingsSchemaResult, type Run, type RunStatus, type SendContentPart, type SettingsField, type SettingsFieldGroup, type SettingsFieldType, type SettingsFieldVisibility, type SettingsFileMetadata, type SettingsItem, type SettingsSelectOption, type TextDisplayPart, type TextPart, type TextSendPart, type Thread, type ThreadEvent, type ThreadState, type UploadResult, type User, apiMessagesUrlToWebSocketUrl, isSettingsFieldGroup, toFormElement, toFormEventData, toFormResponseEventData, useAgentContext, useAnalytics, useAudioRecorder, useConnection, useFeedback, useForm, useFormFileUpload, useMessage, useSettings, useSettingsFileUpload, useThreadDetails, useThreadEvents, useThreadsActions, useThreadsList, useUpload };

package/dist/main.d.ts

@@ -115,6 +115,8 @@ interface AudioDisplayPart {
     mimeType?: string;
     duration?: number;
     filename?: string;
+    /** Upload ref when present on the wire (replay / blob key correlation). */
+    refId?: string;
 }
 interface ImageDisplayPart {
     type: 'image';
@@ -124,6 +126,7 @@ interface ImageDisplayPart {
     height?: number;
     alt?: string;
     filename?: string;
+    refId?: string;
 }
 interface DocumentDisplayPart {
     type: 'document';
@@ -131,6 +134,7 @@ interface DocumentDisplayPart {
     filename?: string;
     mimeType?: string;
     sizeBytes?: number;
+    refId?: string;
 }
 type DisplayContentPart = TextDisplayPart | AudioDisplayPart | ImageDisplayPart | DocumentDisplayPart;
 type ContentPart = SendContentPart;
@@ -230,6 +234,8 @@ interface User {
     userId: string;
     userName?: string | null;
     userEmail?: string | null;
+    userMobileNumber?: string | null;
+    userWhatsappNumber?: string | null;
     identityIds?: string[];
     systemRole: string;
     organizationRole: string;
@@ -414,11 +420,15 @@ interface AgentConnectionConfig {
     userId?: string;
     userName?: string;
     userEmail?: string;
+    userMobileNumber?: string;
+    userWhatsappNumber?: string;
     identityIds?: string[];
     systemRole?: string;
     organizationRole?: string;
     workspaceRole?: string;
     authToken?: string;
+    channel?: string;
+    channelMeta?: Record<string, unknown>;
 }
 type OnErrorCallback = (error: {
     code: string;
@@ -523,6 +533,7 @@ declare class AgentClient {
         formEventId: string;
         cancelled: boolean;
         values: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
     }): Promise<{
         threadId: string;
     }>;
@@ -532,6 +543,7 @@ declare class AgentClient {
     private route;
     private scheduleReconnect;
     private send;
+    private withChannelMetadata;
     private sendRaw;
     /** Resolve relative URLs in event content parts against the agent's HTTP base. */
     private resolveEventUrls;
@@ -694,16 +706,23 @@ interface AgentProviderProps {
     userId?: string;
     userName?: string;
     userEmail?: string;
+    userMobileNumber?: string;
+    userWhatsappNumber?: string;
     identityIds?: string[];
     systemRole?: string;
     organizationRole?: string;
     workspaceRole?: string;
     authToken?: string;
+    channel?: string;
+    channelMeta?: Record<string, unknown>;
     uploadUrl?: string;
     onError?: OnErrorCallback;
     children: ReactNode;
 }
-declare function AgentProvider({ url, agentId, organizationId, workspaceId, userId, userName, userEmail, identityIds, systemRole, organizationRole, workspaceRole, authToken, uploadUrl, onError, children, }: AgentProviderProps): react_jsx_runtime.JSX.Element;
+declare function AgentProvider({ url, agentId, organizationId, workspaceId, userId, userName, userEmail, userMobileNumber, userWhatsappNumber, identityIds, systemRole, organizationRole, workspaceRole, authToken, channel, channelMeta, uploadUrl, onError, children, }: AgentProviderProps): react_jsx_runtime.JSX.Element;
 declare function useAgentContext(): AgentContextValue;
 
-export { type Actor, type AgentConnectionConfig, AgentProvider, type AgentProviderProps, AgentServerClient, type AnalyticsEvent, type AudioDisplayPart, type AudioPart, type AudioSendPart, type ConnectionStatus, type ContentPart, type DisplayContentPart, type DocumentDisplayPart, type DocumentPart, type DocumentSendPart, type EventType, type FeedbackTarget, type FeedbackType, type FormCheckboxElement, type FormElement, type FormEventData, type FormFileElement, type FormFileMetadata, type FormOption, type FormRadioElement, type FormResponseEventData, type FormSelectElement, type FormSize, type FormTextElement, type FormTextareaElement, type ImageDisplayPart, type ImagePart, type ImageSendPart, type OnErrorCallback, type PublicSettingsSchemaResult, type Run, type RunStatus, type SendContentPart, type SettingsField, type SettingsFieldGroup, type SettingsFieldType, type SettingsFieldVisibility, type SettingsFileMetadata, type SettingsItem, type SettingsSelectOption, type TextDisplayPart, type TextPart, type TextSendPart, type Thread, type ThreadEvent, type ThreadState, type UploadResult, type User, apiMessagesUrlToWebSocketUrl, isSettingsFieldGroup, toFormElement, toFormEventData, toFormResponseEventData, useAgentContext, useAnalytics, useAudioRecorder, useConnection, useFeedback, useForm, useFormFileUpload, useMessage, useSettings, useSettingsFileUpload, useThreadDetails, useThreadEvents, useThreadsActions, useThreadsList, useUpload };
+/** Must match `package.json` `"version"` (connect frame telemetry). */
+declare const PACKAGE_VERSION: "0.9.3";
+
+export { type Actor, type AgentConnectionConfig, AgentProvider, type AgentProviderProps, AgentServerClient, type AnalyticsEvent, type AudioDisplayPart, type AudioPart, type AudioSendPart, type ConnectionStatus, type ContentPart, type DisplayContentPart, type DocumentDisplayPart, type DocumentPart, type DocumentSendPart, type EventType, type FeedbackTarget, type FeedbackType, type FormCheckboxElement, type FormElement, type FormEventData, type FormFileElement, type FormFileMetadata, type FormOption, type FormRadioElement, type FormResponseEventData, type FormSelectElement, type FormSize, type FormTextElement, type FormTextareaElement, type ImageDisplayPart, type ImagePart, type ImageSendPart, type OnErrorCallback, PACKAGE_VERSION, type PublicSettingsSchemaResult, type Run, type RunStatus, type SendContentPart, type SettingsField, type SettingsFieldGroup, type SettingsFieldType, type SettingsFieldVisibility, type SettingsFileMetadata, type SettingsItem, type SettingsSelectOption, type TextDisplayPart, type TextPart, type TextSendPart, type Thread, type ThreadEvent, type ThreadState, type UploadResult, type User, apiMessagesUrlToWebSocketUrl, isSettingsFieldGroup, toFormElement, toFormEventData, toFormResponseEventData, useAgentContext, useAnalytics, useAudioRecorder, useConnection, useFeedback, useForm, useFormFileUpload, useMessage, useSettings, useSettingsFileUpload, useThreadDetails, useThreadEvents, useThreadsActions, useThreadsList, useUpload };

package/dist/main.js

@@ -22,6 +22,9 @@ function apiMessagesUrlToWebSocketUrl(url) {
   throw new Error("API Messages URL must start with http://, https://, ws://, or wss://");
 }
 
+// src/version.ts
+var PACKAGE_VERSION = "0.9.3";
+
 // src/types.ts
 function isSettingsFieldGroup(item) {
   return "fields" in item && Array.isArray(item.fields);
@@ -32,6 +35,8 @@ function toUser(w) {
     userId: w.user_id,
     userName: w.user_name,
     userEmail: w.user_email,
+    userMobileNumber: w.user_mobile_number,
+    userWhatsappNumber: w.user_whatsapp_number,
     identityIds: w.identity_ids,
     systemRole: w.system_role,
     organizationRole: w.organization_role,
@@ -63,7 +68,8 @@ function toDisplayContentPart(w) {
         url: w.url,
         mimeType: w.mime_type,
         duration: w.duration,
-        filename: w.filename
+        filename: w.filename,
+        ...w.ref_id ? { refId: w.ref_id } : {}
       };
     case "image":
       return {
@@ -73,7 +79,8 @@ function toDisplayContentPart(w) {
         width: w.width,
         height: w.height,
         alt: w.alt,
-        filename: w.filename
+        filename: w.filename,
+        ...w.ref_id ? { refId: w.ref_id } : {}
       };
     case "document":
       return {
@@ -81,7 +88,8 @@ function toDisplayContentPart(w) {
         url: w.url,
         filename: w.filename,
         mimeType: w.mime_type,
-        sizeBytes: w.size_bytes
+        sizeBytes: w.size_bytes,
+        ...w.ref_id ? { refId: w.ref_id } : {}
       };
   }
 }
@@ -408,7 +416,8 @@ var AgentClient = class {
   config = {
     organizationId: "",
     workspaceId: "",
-    userId: ""
+    userId: "",
+    channel: "dooers-platform"
   };
   connectFrameId = "";
   isIntentionallyClosed = false;
@@ -695,9 +704,7 @@ var AgentClient = class {
         content
       }
     };
-    if (params.metadata) {
-      payload.metadata = params.metadata;
-    }
+    payload.metadata = this.withChannelMetadata(params.metadata);
     this.sendRaw({
       id: clientEventId,
       type: "event.create",
@@ -725,7 +732,8 @@ var AgentClient = class {
             values: params.values
           }
         }
-      }
+      },
+      metadata: this.withChannelMetadata(params.metadata)
     });
     return promise;
   }
@@ -785,13 +793,15 @@ var AgentClient = class {
           user_id: this.config.userId ?? "",
           user_name: this.config.userName ?? null,
           user_email: this.config.userEmail ?? null,
+          user_mobile_number: this.config.userMobileNumber ?? null,
+          user_whatsapp_number: this.config.userWhatsappNumber ?? null,
           identity_ids: this.config.identityIds ?? [],
           system_role: this.config.systemRole ?? "user",
           organization_role: this.config.organizationRole ?? "member",
           workspace_role: this.config.workspaceRole ?? "member"
         },
         auth_token: this.config.authToken,
-        client: { name: "dooers-agents-client", version: "0.1.0" }
+        client: { name: "dooers-agents-client", version: PACKAGE_VERSION }
       }
     });
   }
@@ -969,6 +979,17 @@ var AgentClient = class {
   send(type, payload) {
     this.sendRaw({ id: crypto.randomUUID(), type, payload });
   }
+  withChannelMetadata(metadata) {
+    const channel = (this.config.channel || "dooers-platform").trim() || "dooers-platform";
+    const base = metadata ? { ...metadata } : {};
+    if (!("channel" in base)) {
+      base.channel = channel;
+    }
+    if (this.config.channelMeta && !("channel_meta" in base)) {
+      base.channel_meta = this.config.channelMeta;
+    }
+    return Object.keys(base).length > 0 ? base : void 0;
+  }
   sendRaw(frame) {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
     this.ws.send(JSON.stringify(frame));
@@ -1410,11 +1431,15 @@ function AgentProvider({
   userId,
   userName,
   userEmail,
+  userMobileNumber,
+  userWhatsappNumber,
   identityIds,
   systemRole,
   organizationRole,
   workspaceRole,
   authToken,
+  channel,
+  channelMeta,
   uploadUrl,
   onError,
   children
@@ -1443,11 +1468,15 @@ function AgentProvider({
       userId,
       userName,
       userEmail,
+      userMobileNumber,
+      userWhatsappNumber,
       identityIds: identityIdsKey ? identityIdsKey.split(",") : void 0,
       systemRole,
       organizationRole,
       workspaceRole,
-      authToken
+      authToken,
+      channel,
+      channelMeta
     });
     return () => clientRef.current?.disconnect();
   }, [
@@ -1458,11 +1487,15 @@ function AgentProvider({
     userId,
     userName,
     userEmail,
+    userMobileNumber,
+    userWhatsappNumber,
     identityIdsKey,
     systemRole,
     organizationRole,
     workspaceRole,
-    authToken
+    authToken,
+    channel,
+    channelMeta
   ]);
   const contextValue = useMemo(
     () => ({ store: storeRef.current, client: clientRef.current }),
@@ -1915,6 +1948,6 @@ function useUpload() {
   return { upload, isUploading };
 }
 
-export { AgentProvider, AgentServerClient, apiMessagesUrlToWebSocketUrl, isSettingsFieldGroup, toFormElement, toFormEventData, toFormResponseEventData, useAgentContext, useAnalytics, useAudioRecorder, useConnection, useFeedback, useForm, useFormFileUpload, useMessage, useSettings, useSettingsFileUpload, useThreadDetails, useThreadEvents, useThreadsActions, useThreadsList, useUpload };
+export { AgentProvider, AgentServerClient, PACKAGE_VERSION, apiMessagesUrlToWebSocketUrl, isSettingsFieldGroup, toFormElement, toFormEventData, toFormResponseEventData, useAgentContext, useAnalytics, useAudioRecorder, useConnection, useFeedback, useForm, useFormFileUpload, useMessage, useSettings, useSettingsFileUpload, useThreadDetails, useThreadEvents, useThreadsActions, useThreadsList, useUpload };
 //# sourceMappingURL=main.js.map
 //# sourceMappingURL=main.js.map