@workclaw/openclaw-workchat 1.0.0 → 1.0.4

package/src/messaging/inbound.ts

@@ -1,174 +1,174 @@
-import type { AgentMessagePayload, AgentEventPayload } from "../api/types.js";
-import { generateId } from "../util/random.js";
-
-// ---------------------------------------------------------------------------
-// Frame parsing
-// ---------------------------------------------------------------------------
-
-export type WorkChatFrameType =
-  | "agent_message"
-  | "ping"
-  | "disconnect"
-  | "agent_created"
-  | "agent_updated"
-  | "agent_deleted"
-  | "init_agent"
-  | "ignored";
-
-export type ParseWorkChatFrameResult = {
-  type: WorkChatFrameType;
-  message?: {
-    text: string;
-    userId: string;
-    openConversationId: string;
-    messageId: string;
-    agentId?: string;
-  };
-  pongData?: unknown;
-  eventData?: AgentEventPayload;
-  /** Raw event/topic name for ignored frames (observability). */
-  ignoredKind?: string;
-};
-
-function parseMaybeJson(value: unknown): unknown {
-  if (typeof value !== "string") return value;
-  try {
-    return JSON.parse(value);
-  } catch {
-    return value;
-  }
-}
-
-/** Parse one raw WebSocket frame into a typed result. */
-export function parseWorkChatFrame(data: string): ParseWorkChatFrameResult | null {
-  let input: unknown;
-  try {
-    input = data ? JSON.parse(data) : {};
-  } catch {
-    return null;
-  }
-
-  if (typeof input === "string" && input.toLowerCase() === "ping") {
-    return { type: "ping", pongData: input };
-  }
-
-  const envelope = (input && typeof input === "object" ? input : { data: input }) as Record<string, any>;
-  const type = String(envelope?.type || "").trim().toUpperCase();
-  const topicLower = String(envelope?.metadata?.topic || "").trim().toLowerCase();
-
-  if (type === "SYSTEM") {
-    if (topicLower === "ping") return { type: "ping", pongData: envelope?.data };
-    if (topicLower === "disconnect") return { type: "disconnect" };
-    return { type: "ignored", ignoredKind: `SYSTEM/${topicLower}` };
-  }
-
-  if (type === "EVENT") {
-    const eventType = String(envelope?.metadata?.event || "").trim().toUpperCase();
-    let eventData = parseMaybeJson(envelope?.data) as AgentEventPayload | undefined;
-    // The platform also sends INIT_AGENT / AGENT_* events whose data is a bare
-    // JSON-encoded string/number (the agent id itself, zhixiaotu shape) —
-    // normalize to { id } so downstream id extraction works either way.
-    if ((eventType === "INIT_AGENT" || eventType.startsWith("AGENT_"))
-      && eventData !== null && eventData !== undefined
-      && typeof eventData !== "object") {
-      eventData = { id: String(eventData) };
-    }
-    if (eventType === "AGENT_CREATED") return { type: "agent_created", eventData };
-    if (eventType === "AGENT_UPDATED") return { type: "agent_updated", eventData };
-    if (eventType === "AGENT_DELETED") return { type: "agent_deleted", eventData };
-    if (eventType === "INIT_AGENT") return { type: "init_agent", eventData };
-    return { type: "ignored", ignoredKind: `EVENT/${eventType}` };
-  }
-
-  if (type === "CALLBACK" && String(envelope?.metadata?.topic || "").trim().toUpperCase() === "AGENT_MESSAGE") {
-    const payload = (parseMaybeJson(envelope?.data) ?? {}) as AgentMessagePayload;
-    const message = payload?.message;
-    const text = typeof message === "string"
-      ? message
-      : typeof message?.content === "string"
-        ? message.content
-        : "";
-    return {
-      type: "agent_message",
-      message: {
-        text,
-        userId: String(payload?.userId ?? ""),
-        openConversationId: String(payload?.conversationId ?? ""),
-        messageId: String(payload?.msgId ?? ""),
-        ...(payload?.agentId !== undefined ? { agentId: String(payload.agentId) } : {}),
-      },
-    };
-  }
-
-  return { type: "ignored", ignoredKind: `${type}/${topicLower || "(no topic)"}` };
-}
-
-/** Build the pong response frame for a SYSTEM ping. */
-export function buildPongFrame(pongData: unknown): string {
-  return JSON.stringify({
-    code: 200,
-    message: "pong",
-    metadata: { contentType: "application/json" },
-    data: JSON.stringify(pongData ?? {}),
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Inbound context
-// ---------------------------------------------------------------------------
-
-/** Inbound context passed to the OpenClaw core pipeline (matches MsgContext shape). */
-export type WorkChatMsgContext = {
-  Body: string;
-  From: string;
-  To: string;
-  AccountId: string;
-  OriginatingChannel: "openclaw-workchat";
-  OriginatingTo: string;
-  MessageSid: string;
-  Timestamp?: number;
-  Provider: "openclaw-workchat";
-  ChatType: "direct";
-  /** Set after resolveAgentRoute so dispatchReplyFromConfig uses the correct session. */
-  SessionKey?: string;
-  /** Raw message body for framework command authorization. */
-  CommandBody?: string;
-  /** Whether the sender is authorized to execute slash commands. */
-  CommandAuthorized?: boolean;
-  /** Conversation id echoed in outbound replies. */
-  ConversationId?: string;
-  /** Cloud agent id this message was addressed to. */
-  AgentId?: string;
-};
-
-function generateMessageSid(): string {
-  return generateId("openclaw-workchat");
-}
-
-/** Convert an AGENT_MESSAGE payload into the inbound MsgContext for the core pipeline. */
-export function workChatMessageToMsgContext(
-  message: NonNullable<ParseWorkChatFrameResult["message"]>,
-  accountId: string,
-): WorkChatMsgContext {
-  const fromUserId = message.userId ?? "";
-  const ctx: WorkChatMsgContext = {
-    Body: message.text ?? "",
-    From: fromUserId,
-    To: fromUserId,
-    AccountId: accountId,
-    OriginatingChannel: "openclaw-workchat",
-    OriginatingTo: fromUserId,
-    MessageSid: message.messageId || generateMessageSid(),
-    Timestamp: Date.now(),
-    Provider: "openclaw-workchat",
-    ChatType: "direct",
-    CommandBody: message.text ?? "",
-  };
-  if (message.openConversationId) {
-    ctx.ConversationId = message.openConversationId;
-  }
-  if (message.agentId) {
-    ctx.AgentId = message.agentId;
-  }
-  return ctx;
-}
+import type { AgentMessagePayload, AgentEventPayload } from "../api/types.js";
+import { generateId } from "../util/random.js";
+
+// ---------------------------------------------------------------------------
+// Frame parsing
+// ---------------------------------------------------------------------------
+
+export type WorkChatFrameType =
+  | "agent_message"
+  | "ping"
+  | "disconnect"
+  | "agent_created"
+  | "agent_updated"
+  | "agent_deleted"
+  | "init_agent"
+  | "ignored";
+
+export type ParseWorkChatFrameResult = {
+  type: WorkChatFrameType;
+  message?: {
+    text: string;
+    userId: string;
+    openConversationId: string;
+    messageId: string;
+    agentId?: string;
+  };
+  pongData?: unknown;
+  eventData?: AgentEventPayload;
+  /** Raw event/topic name for ignored frames (observability). */
+  ignoredKind?: string;
+};
+
+function parseMaybeJson(value: unknown): unknown {
+  if (typeof value !== "string") return value;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+
+/** Parse one raw WebSocket frame into a typed result. */
+export function parseWorkChatFrame(data: string): ParseWorkChatFrameResult | null {
+  let input: unknown;
+  try {
+    input = data ? JSON.parse(data) : {};
+  } catch {
+    return null;
+  }
+
+  if (typeof input === "string" && input.toLowerCase() === "ping") {
+    return { type: "ping", pongData: input };
+  }
+
+  const envelope = (input && typeof input === "object" ? input : { data: input }) as Record<string, any>;
+  const type = String(envelope?.type || "").trim().toUpperCase();
+  const topicLower = String(envelope?.metadata?.topic || "").trim().toLowerCase();
+
+  if (type === "SYSTEM") {
+    if (topicLower === "ping") return { type: "ping", pongData: envelope?.data };
+    if (topicLower === "disconnect") return { type: "disconnect" };
+    return { type: "ignored", ignoredKind: `SYSTEM/${topicLower}` };
+  }
+
+  if (type === "EVENT") {
+    const eventType = String(envelope?.metadata?.event || "").trim().toUpperCase();
+    let eventData = parseMaybeJson(envelope?.data) as AgentEventPayload | undefined;
+    // The platform also sends INIT_AGENT / AGENT_* events whose data is a bare
+    // JSON-encoded string/number (the agent id itself, zhixiaotu shape) —
+    // normalize to { id } so downstream id extraction works either way.
+    if ((eventType === "INIT_AGENT" || eventType.startsWith("AGENT_"))
+      && eventData !== null && eventData !== undefined
+      && typeof eventData !== "object") {
+      eventData = { id: String(eventData) };
+    }
+    if (eventType === "AGENT_CREATED") return { type: "agent_created", eventData };
+    if (eventType === "AGENT_UPDATED") return { type: "agent_updated", eventData };
+    if (eventType === "AGENT_DELETED") return { type: "agent_deleted", eventData };
+    if (eventType === "INIT_AGENT") return { type: "init_agent", eventData };
+    return { type: "ignored", ignoredKind: `EVENT/${eventType}` };
+  }
+
+  if (type === "CALLBACK" && String(envelope?.metadata?.topic || "").trim().toUpperCase() === "AGENT_MESSAGE") {
+    const payload = (parseMaybeJson(envelope?.data) ?? {}) as AgentMessagePayload;
+    const message = payload?.message;
+    const text = typeof message === "string"
+      ? message
+      : typeof message?.content === "string"
+        ? message.content
+        : "";
+    return {
+      type: "agent_message",
+      message: {
+        text,
+        userId: String(payload?.userId ?? ""),
+        openConversationId: String(payload?.conversationId ?? ""),
+        messageId: String(payload?.msgId ?? ""),
+        ...(payload?.agentId !== undefined ? { agentId: String(payload.agentId) } : {}),
+      },
+    };
+  }
+
+  return { type: "ignored", ignoredKind: `${type}/${topicLower || "(no topic)"}` };
+}
+
+/** Build the pong response frame for a SYSTEM ping. */
+export function buildPongFrame(pongData: unknown): string {
+  return JSON.stringify({
+    code: 200,
+    message: "pong",
+    metadata: { contentType: "application/json" },
+    data: JSON.stringify(pongData ?? {}),
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Inbound context
+// ---------------------------------------------------------------------------
+
+/** Inbound context passed to the OpenClaw core pipeline (matches MsgContext shape). */
+export type WorkChatMsgContext = {
+  Body: string;
+  From: string;
+  To: string;
+  AccountId: string;
+  OriginatingChannel: "openclaw-workchat";
+  OriginatingTo: string;
+  MessageSid: string;
+  Timestamp?: number;
+  Provider: "openclaw-workchat";
+  ChatType: "direct";
+  /** Set after resolveAgentRoute so dispatchReplyFromConfig uses the correct session. */
+  SessionKey?: string;
+  /** Raw message body for framework command authorization. */
+  CommandBody?: string;
+  /** Whether the sender is authorized to execute slash commands. */
+  CommandAuthorized?: boolean;
+  /** Conversation id echoed in outbound replies. */
+  ConversationId?: string;
+  /** Cloud agent id this message was addressed to. */
+  AgentId?: string;
+};
+
+function generateMessageSid(): string {
+  return generateId("openclaw-workchat");
+}
+
+/** Convert an AGENT_MESSAGE payload into the inbound MsgContext for the core pipeline. */
+export function workChatMessageToMsgContext(
+  message: NonNullable<ParseWorkChatFrameResult["message"]>,
+  accountId: string,
+): WorkChatMsgContext {
+  const fromUserId = message.userId ?? "";
+  const ctx: WorkChatMsgContext = {
+    Body: message.text ?? "",
+    From: fromUserId,
+    To: fromUserId,
+    AccountId: accountId,
+    OriginatingChannel: "openclaw-workchat",
+    OriginatingTo: fromUserId,
+    MessageSid: message.messageId || generateMessageSid(),
+    Timestamp: Date.now(),
+    Provider: "openclaw-workchat",
+    ChatType: "direct",
+    CommandBody: message.text ?? "",
+  };
+  if (message.openConversationId) {
+    ctx.ConversationId = message.openConversationId;
+  }
+  if (message.agentId) {
+    ctx.AgentId = message.agentId;
+  }
+  return ctx;
+}