@csntgao/ai-employee-client 0.15.0 → 0.15.2

package/dist/index.d.ts

@@ -61,7 +61,7 @@ interface AiEmployeeTransport {
 }
 type AiEmployeeTransportErrorCode = 'UNAUTHORIZED' | 'ACCESS_DENIED' | 'AI_EMPLOYEE_NOT_AVAILABLE' | 'APPLICATION_NOT_SUPPORTED' | 'ORGANIZATION_CONTEXT_REQUIRED' | 'INVALID_ARGUMENT' | 'IDEMPOTENCY_CONFLICT' | 'REALTIME_UNAVAILABLE' | 'TOO_MANY_REQUESTS';
 type AiEmployeeConnectionState = 'idle' | 'connecting' | 'authenticating' | 'subscribing' | 'connected' | 'reconnecting' | 'disconnected' | 'destroyed';
-type AiEmployeeErrorCode = 'INVALID_CONFIGURATION' | 'SESSION_UNAVAILABLE' | 'HISTORY_LOAD_FAILED' | 'TOKEN_UNAVAILABLE' | 'WEBSOCKET_UNAVAILABLE' | 'WEBSOCKET_ERROR' | 'AUTHENTICATION_FAILED' | 'ORGANIZATION_CONTEXT_REQUIRED' | 'REALTIME_UNAVAILABLE' | 'CHANNEL_UNAVAILABLE' | 'SESSION_NOT_FOUND' | 'PROTOCOL_ERROR' | 'SEND_FAILED' | 'FIRST_MESSAGE_CONFLICT' | 'RATE_LIMITED' | 'SEND_IN_PROGRESS' | 'EMPTY_MESSAGE' | 'SOURCE_SESSION_NOT_FOUND' | 'SOURCE_SESSION_ACCESS_DENIED' | 'HANDOFF_ACTION_NOT_FOUND' | 'HANDOFF_ACTION_MISMATCH' | 'CUSTOMER_SUPPORT_UNAVAILABLE' | 'CUSTOMER_SUPPORT_HANDOFF_FAILED' | 'CLIENT_DESTROYED';
+type AiEmployeeErrorCode = 'INVALID_CONFIGURATION' | 'SESSION_UNAVAILABLE' | 'HISTORY_LOAD_FAILED' | 'TOKEN_UNAVAILABLE' | 'WEBSOCKET_UNAVAILABLE' | 'WEBSOCKET_ERROR' | 'AUTHENTICATION_FAILED' | 'ORGANIZATION_CONTEXT_REQUIRED' | 'REALTIME_UNAVAILABLE' | 'CHANNEL_UNAVAILABLE' | 'SESSION_NOT_FOUND' | 'PROTOCOL_ERROR' | 'SEND_FAILED' | 'FIRST_MESSAGE_CONFLICT' | 'RATE_LIMITED' | 'SEND_IN_PROGRESS' | 'EMPTY_MESSAGE' | 'SOURCE_SESSION_NOT_FOUND' | 'SOURCE_SESSION_ACCESS_DENIED' | 'HANDOFF_ACTION_NOT_FOUND' | 'HANDOFF_ACTION_MISMATCH' | 'CUSTOMER_SUPPORT_UNAVAILABLE' | 'CUSTOMER_SUPPORT_HANDOFF_FAILED' | 'FILE_ACCESS_DENIED' | 'FILE_NOT_FOUND' | 'FILE_PATH_AMBIGUOUS' | 'FILE_DOWNLOAD_FAILED' | 'CLIENT_DESTROYED';
 interface AiEmployeeClientErrorDetail {
     code: AiEmployeeErrorCode;
     message: string;
@@ -91,6 +91,10 @@ interface AiEmployeeClientEventMap {
     'processing-state-change': {
         processing: boolean;
     };
+    'work-activity': {
+        sessionId: string;
+        text: string;
+    };
     error: AiEmployeeClientErrorDetail;
 }
 interface AiEmployeeReconnectOptions {
@@ -226,16 +230,27 @@ interface OpenCustomerSupportAssistantAction {
     trigger: 'out_of_scope';
     entry: 'help_and_support';
 }
-type AiEmployeeAssistantAction = OpenCustomerSupportAssistantAction;
+interface OpenFileAssistantAction {
+    type: 'assistant_action';
+    action: 'open_file';
+    transactionId: string;
+    sessionId: string;
+    name: string;
+    size: string;
+    path: string;
+}
+type AiEmployeeAssistantAction = OpenCustomerSupportAssistantAction | OpenFileAssistantAction;
 interface ParsedAiEmployeeAssistantContent {
     content: string;
     actions: readonly AiEmployeeAssistantAction[];
+    rejectedActionTypes?: readonly AiEmployeeAssistantAction['action'][];
 }
 /**
- * Parses a structurally valid platform action from the final standalone JSON
- * block of an assistant response. Invalid or ambiguous input is returned
- * unchanged and is never made executable. Renderers must additionally compare
- * `action.sessionId` with the session that owns the assistant message.
+ * Parses structurally valid platform actions from consecutive standalone JSON
+ * blocks at the end of an assistant response. Invalid or ambiguous trailing
+ * action blocks are removed from display content, reported only by stable action
+ * type, and never made executable. Renderers must additionally compare every
+ * `action.sessionId` with the session that owns the message.
  */
 declare function parseAiEmployeeAssistantContent(content: string): ParsedAiEmployeeAssistantContent;
 declare function isUuidV4(value: unknown): value is string;
@@ -658,6 +673,7 @@ interface PingFrame {
 }
 interface ParsedSessionMessage {
     messages: AiEmployeeMessage[];
+    activities: string[];
     fallbackResult?: AiEmployeeMessage;
     processing?: boolean;
 }
@@ -679,4 +695,4 @@ declare function parseJsonRecord(raw: string): JsonRecord | null;
 declare function parseAiEmployeeEvent(raw: unknown): ParsedAiEmployeeEvent;
 declare function hashText(value: string): string;
 
-export { type AiEmployeeAssistantAction, type AiEmployeeAttachmentReference, AiEmployeeClient, AiEmployeeClientError, type AiEmployeeClientErrorDetail, type AiEmployeeClientEventMap, type AiEmployeeClientListener, type AiEmployeeClientOptions, type AiEmployeeClientStartResult, type AiEmployeeConnectionState, type AiEmployeeErrorCode, type AiEmployeeFirstMessageOptions, type AiEmployeeFirstMessageRequest, type AiEmployeeFirstMessageRequestState, type AiEmployeeFirstMessageRequestStore, type AiEmployeeFirstMessageResult, type AiEmployeeMessage, type AiEmployeeMessageRole, type AiEmployeeReconnectOptions, type AiEmployeeSessionSummary, type AiEmployeeTransport, AiEmployeeTransportError, type AiEmployeeTransportErrorCode, type AiEmployeeWebSocketFactory, type AuthenticateFrame, type CustomerSupportAgent, CustomerSupportClient, CustomerSupportClientError, type CustomerSupportClientEventMap, type CustomerSupportClientListener, type CustomerSupportClientOptions, type CustomerSupportCreateSessionRequest, type CustomerSupportCreateSessionResult, type CustomerSupportErrorCode, type CustomerSupportErrorDetail, type CustomerSupportHandoffRequest, type CustomerSupportHandoffResult, type CustomerSupportMessage, type CustomerSupportMessagePage, type CustomerSupportSenderType, type CustomerSupportSession, type CustomerSupportSessionStatus, type CustomerSupportTransport, type NotificationAttachment, NotificationCenterClient, NotificationCenterClientError, type NotificationCenterClientEventMap, type NotificationCenterClientListener, type NotificationCenterClientOptions, type NotificationCenterErrorCode, type NotificationCenterErrorDetail, type NotificationCenterTransport, type NotificationContentType, type NotificationDto, type NotificationInboxQuery, type NotificationInboxResult, type NotificationMarkAllReadResult, type NotificationMarkReadResult, type NotificationReadStatus, type NotificationRealtimeChange, type NotificationResource, type NotificationSource, type NotificationTypeSummary, type OpenCustomerSupportAssistantAction, type ParsedAiEmployeeAssistantContent, type ParsedAiEmployeeEvent, type ParsedSessionMessage, type PingFrame, type SessionSubscriptionFrame, createAuthenticateFrame, createPingFrame, createSubscriptionFrame, hashText, isUuidV4, parseAiEmployeeAssistantContent, parseAiEmployeeEvent, parseJsonRecord };
+export { type AiEmployeeAssistantAction, type AiEmployeeAttachmentReference, AiEmployeeClient, AiEmployeeClientError, type AiEmployeeClientErrorDetail, type AiEmployeeClientEventMap, type AiEmployeeClientListener, type AiEmployeeClientOptions, type AiEmployeeClientStartResult, type AiEmployeeConnectionState, type AiEmployeeErrorCode, type AiEmployeeFirstMessageOptions, type AiEmployeeFirstMessageRequest, type AiEmployeeFirstMessageRequestState, type AiEmployeeFirstMessageRequestStore, type AiEmployeeFirstMessageResult, type AiEmployeeMessage, type AiEmployeeMessageRole, type AiEmployeeReconnectOptions, type AiEmployeeSessionSummary, type AiEmployeeTransport, AiEmployeeTransportError, type AiEmployeeTransportErrorCode, type AiEmployeeWebSocketFactory, type AuthenticateFrame, type CustomerSupportAgent, CustomerSupportClient, CustomerSupportClientError, type CustomerSupportClientEventMap, type CustomerSupportClientListener, type CustomerSupportClientOptions, type CustomerSupportCreateSessionRequest, type CustomerSupportCreateSessionResult, type CustomerSupportErrorCode, type CustomerSupportErrorDetail, type CustomerSupportHandoffRequest, type CustomerSupportHandoffResult, type CustomerSupportMessage, type CustomerSupportMessagePage, type CustomerSupportSenderType, type CustomerSupportSession, type CustomerSupportSessionStatus, type CustomerSupportTransport, type NotificationAttachment, NotificationCenterClient, NotificationCenterClientError, type NotificationCenterClientEventMap, type NotificationCenterClientListener, type NotificationCenterClientOptions, type NotificationCenterErrorCode, type NotificationCenterErrorDetail, type NotificationCenterTransport, type NotificationContentType, type NotificationDto, type NotificationInboxQuery, type NotificationInboxResult, type NotificationMarkAllReadResult, type NotificationMarkReadResult, type NotificationReadStatus, type NotificationRealtimeChange, type NotificationResource, type NotificationSource, type NotificationTypeSummary, type OpenCustomerSupportAssistantAction, type OpenFileAssistantAction, type ParsedAiEmployeeAssistantContent, type ParsedAiEmployeeEvent, type ParsedSessionMessage, type PingFrame, type SessionSubscriptionFrame, createAuthenticateFrame, createPingFrame, createSubscriptionFrame, hashText, isUuidV4, parseAiEmployeeAssistantContent, parseAiEmployeeEvent, parseJsonRecord };

package/dist/index.js

@@ -45,10 +45,13 @@ function parseAiEmployeeEvent(raw) {
 }
 function parseSessionPayload(payload, sessionId) {
   const messages = [];
+  const activities = [];
   const patches = Array.isArray(payload.JsonPatch) ? payload.JsonPatch : [];
   for (const rawPatch of patches) {
     const patch = asRecord(rawPatch);
     const value = asRecord(patch.value);
+    const activity = workActivityFromEntry(value);
+    if (activity) activities.push(activity);
     const parsed = messageFromEntry(value, sessionId);
     if (parsed) messages.push(parsed);
   }
@@ -74,7 +77,58 @@ function parseSessionPayload(payload, sessionId) {
   let processing;
   if (payload.Ready === true) processing = true;
   if (payload.finished === true || payload.stopped === true) processing = false;
-  return { messages, fallbackResult, processing };
+  return { messages, activities, fallbackResult, processing };
+}
+function workActivityFromEntry(entry) {
+  const entryTypeValue = entry.entry_type;
+  const entryType = typeof entryTypeValue === "string" ? entryTypeValue : stringValue(asRecord(entryTypeValue).type);
+  const entryTypeRecord = asRecord(entryTypeValue);
+  if (entryType === "thinking" || entryType === "status_update" || entryType === "output") {
+    return safeActivityText(extractActivityText(entry.content));
+  }
+  if (entryType === "loading") {
+    return safeActivityText(extractActivityText(entry.content)) || "\u6B63\u5728\u52A0\u8F7D\u6240\u9700\u4FE1\u606F\u2026";
+  }
+  if (entryType === "tool_result") return "\u5DE5\u5177\u5904\u7406\u5B8C\u6210\uFF0C\u6B63\u5728\u7EE7\u7EED\u2026";
+  if (entryType !== "tool_use") return "";
+  const actionType = asRecord(entryTypeRecord.action_type);
+  const action = stringValue(actionType.action);
+  if (action === "search") {
+    const query = safeActivityText(stringValue(actionType.query), 60);
+    return query ? `\u6B63\u5728\u641C\u7D22\uFF1A${query}` : "\u6B63\u5728\u641C\u7D22\u76F8\u5173\u4FE1\u606F\u2026";
+  }
+  if (action === "web_fetch") return "\u6B63\u5728\u8BFB\u53D6\u7F51\u9875\u5185\u5BB9\u2026";
+  if (action === "file_read") return "\u6B63\u5728\u8BFB\u53D6\u8D44\u6599\u2026";
+  if (action === "file_edit") return "\u6B63\u5728\u6574\u7406\u6587\u4EF6\u2026";
+  if (action === "command_run") return "\u6B63\u5728\u6267\u884C\u4EFB\u52A1\u2026";
+  const toolName = safeActivityText(stringValue(entryTypeRecord.tool_name), 40);
+  return toolName ? `\u6B63\u5728\u8C03\u7528 ${toolName}\u2026` : "\u6B63\u5728\u8C03\u7528\u5DE5\u5177\u2026";
+}
+function extractActivityText(raw) {
+  if (typeof raw !== "string") return "";
+  const value = raw.trim();
+  if (!value) return "";
+  try {
+    const parsed = JSON.parse(value);
+    if (typeof parsed === "string") return parsed.trim();
+    const activity = asRecord(parsed);
+    for (const key of ["thinking", "status", "text", "message", "content", "result"]) {
+      const candidate = stringValue(activity[key]).trim();
+      if (candidate) return candidate;
+    }
+    return "";
+  } catch {
+    return value;
+  }
+}
+function safeActivityText(value, maximumCharacters = 120) {
+  const withoutCredentials = value.replace(/\bBearer\s+[^\s]+/gi, "Bearer [\u5DF2\u9690\u85CF]").replace(/\b[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\b/g, "[\u5DF2\u9690\u85CF]");
+  const normalized = [...withoutCredentials].map((character) => {
+    const codePoint = character.codePointAt(0) ?? 0;
+    return codePoint > 31 && codePoint !== 127 ? character : " ";
+  }).join("").replace(/\s+/g, " ").trim();
+  const characters = [...normalized];
+  return characters.length <= maximumCharacters ? normalized : `${characters.slice(0, maximumCharacters).join("")}\u2026`;
 }
 function messageFromEntry(entry, sessionId) {
   const entryTypeValue = entry.entry_type;
@@ -618,6 +672,11 @@ var AiEmployeeClient = class {
     }
     if (event.result.processing === true) this.assistantReceivedInCurrentTurn = false;
     if (event.result.processing !== void 0) this.setProcessing(event.result.processing);
+    for (const text2 of event.result.activities) {
+      if (!this.assistantReceivedInCurrentTurn) {
+        this.emit("work-activity", { sessionId: event.sessionId, text: text2 });
+      }
+    }
     for (const message of event.result.messages) {
       if (message.role === "user") this.assistantReceivedInCurrentTurn = false;
       if (message.role === "user" && this.matchesPendingLocalMessage(message)) continue;
@@ -1085,25 +1144,65 @@ function numberValue(value) {
 }
 
 // src/assistant-actions.ts
-var ACTION_KEYS = ["action", "entry", "session-id", "transaction-id", "trigger", "type"];
-var OPEN_CUSTOMER_SUPPORT_MARKER = /"action"\s*:\s*"open_customer_support"/g;
+var CUSTOMER_SUPPORT_ACTION_KEYS = [
+  "action",
+  "entry",
+  "session-id",
+  "transaction-id",
+  "trigger",
+  "type"
+];
+var FILE_ACTION_KEYS = [
+  "action",
+  "name",
+  "path",
+  "session-id",
+  "size",
+  "transaction-id",
+  "type"
+];
+var SUPPORTED_ACTION_MARKER = /"action"\s*:\s*"(open_customer_support|open_file)"/g;
 var UUID_V4_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 var SESSION_ID_PATTERN = /^[A-Za-z0-9._:-]{1,64}$/;
+var FILE_SIZE_PATTERN = /^\d+(?:\.\d+)?(?:B|KB|MB|GB|TB)$/;
 function parseAiEmployeeAssistantContent(content) {
   const source = typeof content === "string" ? content : "";
-  const candidate = trailingStructuredJson(source);
-  if (!candidate || markerCount(source) !== 1) return unchanged(source);
-  let value;
-  try {
-    value = JSON.parse(candidate.json);
-  } catch {
-    return unchanged(source);
+  let remaining = source;
+  const actions = [];
+  const rejectedActionTypes = [];
+  let strippedMarkerCount = 0;
+  while (true) {
+    const candidate = trailingStructuredJson(remaining);
+    if (!candidate) break;
+    const candidateActionTypes = actionMarkerTypes(candidate.json);
+    if (candidateActionTypes.length === 0) break;
+    strippedMarkerCount += candidateActionTypes.length;
+    let value;
+    try {
+      value = JSON.parse(candidate.json);
+    } catch {
+      rejectedActionTypes.unshift(...candidateActionTypes);
+      remaining = candidate.content;
+      continue;
+    }
+    const action = parseAssistantAction(value);
+    if (!action || candidateActionTypes.length !== 1) {
+      rejectedActionTypes.unshift(...candidateActionTypes);
+    } else {
+      actions.unshift(action);
+    }
+    remaining = candidate.content;
+  }
+  const sourceActionTypes = actionMarkerTypes(source);
+  if (sourceActionTypes.length === 0) return unchanged(source);
+  if (strippedMarkerCount !== sourceActionTypes.length) return unchanged(source);
+  const transactionIds = new Set(actions.map((action) => action.transactionId));
+  if (rejectedActionTypes.length > 0 || actions.length === 0 || transactionIds.size !== actions.length || actions.filter((action) => action.action === "open_customer_support").length > 1) {
+    return rejected(remaining, sourceActionTypes);
   }
-  const action = parseOpenCustomerSupportAction(value);
-  if (!action) return unchanged(source);
   return Object.freeze({
-    content: candidate.content,
-    actions: Object.freeze([action])
+    content: remaining,
+    actions: Object.freeze(actions)
   });
 }
 function isUuidV4(value) {
@@ -1111,13 +1210,17 @@ function isUuidV4(value) {
 }
 function trailingStructuredJson(content) {
   const withoutTrailingWhitespace = content.trimEnd();
-  const fenced = withoutTrailingWhitespace.match(
-    /(?:^|\r?\n)[\t ]*```json[\t ]*\r?\n([\s\S]*?)\r?\n[\t ]*```$/i
-  );
-  if (fenced?.index !== void 0) {
+  const fencedPattern = /(?:^|\r?\n)[\t ]*```json[\t ]*\r?\n([\s\S]*?)\r?\n[\t ]*```[\t ]*/gi;
+  let trailingFence = null;
+  for (const match of withoutTrailingWhitespace.matchAll(fencedPattern)) {
+    if (match.index + match[0].length === withoutTrailingWhitespace.length) {
+      trailingFence = match;
+    }
+  }
+  if (trailingFence) {
     return {
-      content: withoutTrailingWhitespace.slice(0, fenced.index).trimEnd(),
-      json: fenced[1]?.trim() ?? ""
+      content: withoutTrailingWhitespace.slice(0, trailingFence.index).trimEnd(),
+      json: trailingFence[1]?.trim() ?? ""
     };
   }
   const starts = [...withoutTrailingWhitespace.matchAll(/(?:^|\r?\n)[\t ]*(\{)/g)];
@@ -1137,10 +1240,16 @@ function trailingStructuredJson(content) {
   }
   return null;
 }
+function parseAssistantAction(value) {
+  if (!isRecord(value)) return null;
+  if (value.action === "open_customer_support") return parseOpenCustomerSupportAction(value);
+  if (value.action === "open_file") return parseOpenFileAction(value);
+  return null;
+}
 function parseOpenCustomerSupportAction(value) {
   if (!isRecord(value)) return null;
   const keys = Object.keys(value).sort();
-  if (keys.length !== ACTION_KEYS.length || keys.some((key, index) => key !== ACTION_KEYS[index])) {
+  if (keys.length !== CUSTOMER_SUPPORT_ACTION_KEYS.length || keys.some((key, index) => key !== CUSTOMER_SUPPORT_ACTION_KEYS[index])) {
     return null;
   }
   if (value.type !== "assistant_action" || value.action !== "open_customer_support" || !isUuidV4(value["transaction-id"]) || !isAssistantActionSessionId(value["session-id"]) || value.trigger !== "out_of_scope" || value.entry !== "help_and_support") {
@@ -1155,15 +1264,64 @@ function parseOpenCustomerSupportAction(value) {
     entry: "help_and_support"
   });
 }
+function parseOpenFileAction(value) {
+  if (!isRecord(value)) return null;
+  const keys = Object.keys(value).sort();
+  if (keys.length !== FILE_ACTION_KEYS.length || keys.some((key, index) => key !== FILE_ACTION_KEYS[index])) {
+    return null;
+  }
+  const transactionId = value["transaction-id"];
+  const sessionId = value["session-id"];
+  const name = value.name;
+  const size = value.size;
+  const path = value.path;
+  if (value.type !== "assistant_action" || value.action !== "open_file" || !isCanonicalUuidV4(transactionId) || !isAssistantActionSessionId(sessionId) || !isSafeRelativeFilePath(path) || typeof name !== "string" || !name || name !== name.trim() || name !== path.slice(path.lastIndexOf("/") + 1) || typeof size !== "string" || size !== size.trim() || !FILE_SIZE_PATTERN.test(size)) {
+    return null;
+  }
+  return Object.freeze({
+    type: "assistant_action",
+    action: "open_file",
+    transactionId,
+    sessionId,
+    name,
+    size,
+    path
+  });
+}
 function isAssistantActionSessionId(value) {
   return typeof value === "string" && SESSION_ID_PATTERN.test(value);
 }
-function markerCount(value) {
-  return [...value.matchAll(OPEN_CUSTOMER_SUPPORT_MARKER)].length;
+function actionMarkerTypes(value) {
+  return [...value.matchAll(SUPPORTED_ACTION_MARKER)].flatMap((match) => {
+    const action = match[1];
+    return action === "open_customer_support" || action === "open_file" ? [action] : [];
+  });
+}
+function isCanonicalUuidV4(value) {
+  return isUuidV4(value) && value === value.toLowerCase();
+}
+function isSafeRelativeFilePath(value) {
+  if (typeof value !== "string" || !value || value !== value.trim() || value.startsWith("/") || value.startsWith("\\") || value.includes("\\") || /^[A-Za-z]:/.test(value) || hasControlCharacter(value)) {
+    return false;
+  }
+  return value.split("/").every((part) => part && part !== "." && part !== ".." && !part.startsWith("."));
+}
+function hasControlCharacter(value) {
+  return [...value].some((character) => {
+    const codePoint = character.codePointAt(0) ?? 0;
+    return codePoint <= 31 || codePoint === 127;
+  });
 }
 function unchanged(content) {
   return Object.freeze({ content, actions: Object.freeze([]) });
 }
+function rejected(content, actionTypes) {
+  return Object.freeze({
+    content,
+    actions: Object.freeze([]),
+    rejectedActionTypes: Object.freeze([...new Set(actionTypes)])
+  });
+}
 function isRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }