@shadowob/sdk 0.3.4 → 0.4.1

package/dist/index.cjs

@@ -0,0 +1,1195 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CLIENT_EVENTS: () => import_shared.CLIENT_EVENTS,
+  SERVER_EVENTS: () => import_shared.SERVER_EVENTS,
+  ShadowClient: () => ShadowClient,
+  ShadowSocket: () => ShadowSocket,
+  channelRoom: () => channelRoom,
+  threadRoom: () => threadRoom,
+  userRoom: () => userRoom
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var ShadowClient = class {
+  constructor(baseUrl, token) {
+    this.token = token;
+    this.baseUrl = baseUrl.replace(/\/api\/?$/, "");
+  }
+  baseUrl;
+  async request(path, init) {
+    const url = `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 6e4);
+    try {
+      const res = await fetch(url, {
+        ...init,
+        signal: init?.signal ?? controller.signal,
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.token}`,
+          ...init?.headers
+        }
+      });
+      if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(
+          `Shadow API ${init?.method ?? "GET"} ${path} failed (${res.status}): ${body}`
+        );
+      }
+      return res.json();
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  async requestRaw(path, init) {
+    const url = `${this.baseUrl}${path}`;
+    const res = await fetch(url, {
+      ...init,
+      headers: {
+        Authorization: `Bearer ${this.token}`,
+        ...init?.headers
+      }
+    });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      throw new Error(`Shadow API ${init?.method ?? "GET"} ${path} failed (${res.status}): ${body}`);
+    }
+    return res;
+  }
+  // ── Auth ──────────────────────────────────────────────────────────────
+  async register(data) {
+    return this.request("/api/auth/register", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async login(data) {
+    return this.request("/api/auth/login", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async refreshToken() {
+    return this.request("/api/auth/refresh", { method: "POST" });
+  }
+  async getMe() {
+    return this.request("/api/auth/me");
+  }
+  async updateProfile(data) {
+    return this.request("/api/auth/me", {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async disconnect() {
+    return this.request("/api/auth/disconnect", { method: "POST" });
+  }
+  // ── Agents ────────────────────────────────────────────────────────────
+  async listAgents() {
+    return this.request("/api/agents");
+  }
+  async createAgent(data) {
+    return this.request("/api/agents", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async getAgent(agentId) {
+    return this.request(`/api/agents/${agentId}`);
+  }
+  async updateAgent(agentId, data) {
+    return this.request(`/api/agents/${agentId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteAgent(agentId) {
+    return this.request(`/api/agents/${agentId}`, { method: "DELETE" });
+  }
+  async generateAgentToken(agentId) {
+    return this.request(`/api/agents/${agentId}/token`, { method: "POST" });
+  }
+  async startAgent(agentId) {
+    return this.request(`/api/agents/${agentId}/start`, { method: "POST" });
+  }
+  async stopAgent(agentId) {
+    return this.request(`/api/agents/${agentId}/stop`, { method: "POST" });
+  }
+  async sendHeartbeat(agentId) {
+    return this.request(`/api/agents/${agentId}/heartbeat`, {
+      method: "POST",
+      body: JSON.stringify({})
+    });
+  }
+  async getAgentConfig(agentId) {
+    return this.request(`/api/agents/${agentId}/config`);
+  }
+  // ── Agent Policies ────────────────────────────────────────────────────
+  async listPolicies(agentId, serverId) {
+    return this.request(`/api/agents/${agentId}/servers/${serverId}/policies`);
+  }
+  async upsertPolicy(agentId, serverId, data) {
+    return this.request(`/api/agents/${agentId}/servers/${serverId}/policies`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async deletePolicy(agentId, serverId, channelId) {
+    return this.request(`/api/agents/${agentId}/servers/${serverId}/policies/${channelId}`, {
+      method: "DELETE"
+    });
+  }
+  // ── Servers ───────────────────────────────────────────────────────────
+  async discoverServers() {
+    return this.request("/api/servers/discover");
+  }
+  async getServerByInvite(inviteCode) {
+    return this.request(`/api/servers/invite/${encodeURIComponent(inviteCode)}`);
+  }
+  async createServer(data) {
+    return this.request("/api/servers", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listServers() {
+    return this.request("/api/servers");
+  }
+  async getServer(serverIdOrSlug) {
+    return this.request(`/api/servers/${serverIdOrSlug}`);
+  }
+  async updateServer(serverIdOrSlug, data) {
+    return this.request(`/api/servers/${serverIdOrSlug}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateServerHomepage(serverIdOrSlug, homepageHtml) {
+    return this.updateServer(serverIdOrSlug, { homepageHtml });
+  }
+  async deleteServer(serverId) {
+    return this.request(`/api/servers/${serverId}`, { method: "DELETE" });
+  }
+  async joinServer(serverId, inviteCode) {
+    return this.request(`/api/servers/${serverId}/join`, {
+      method: "POST",
+      body: JSON.stringify(inviteCode ? { inviteCode } : {})
+    });
+  }
+  async leaveServer(serverId) {
+    return this.request(`/api/servers/${serverId}/leave`, { method: "POST" });
+  }
+  async getMembers(serverId) {
+    return this.request(`/api/servers/${serverId}/members`);
+  }
+  async updateMember(serverId, userId, data) {
+    return this.request(`/api/servers/${serverId}/members/${userId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async kickMember(serverId, userId) {
+    return this.request(`/api/servers/${serverId}/members/${userId}`, { method: "DELETE" });
+  }
+  async regenerateInviteCode(serverId) {
+    return this.request(`/api/servers/${serverId}/invite`, { method: "POST" });
+  }
+  async addAgentsToServer(serverId, agentIds) {
+    return this.request(`/api/servers/${serverId}/agents`, {
+      method: "POST",
+      body: JSON.stringify({ agentIds })
+    });
+  }
+  // ── Channels ──────────────────────────────────────────────────────────
+  async getServerChannels(serverId) {
+    return this.request(`/api/servers/${serverId}/channels`);
+  }
+  async createChannel(serverId, data) {
+    const { description, ...rest } = data;
+    const body = { ...rest, ...description !== void 0 ? { topic: description } : {} };
+    const ch = await this.request(`/api/servers/${serverId}/channels`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+    return { ...ch, description: ch.topic };
+  }
+  async getChannel(channelId) {
+    const ch = await this.request(`/api/channels/${channelId}`);
+    return { ...ch, description: ch.topic };
+  }
+  async getChannelMembers(channelId) {
+    return this.request(`/api/channels/${channelId}/members`);
+  }
+  async updateChannel(channelId, data) {
+    const { description, ...rest } = data;
+    const body = { ...rest, ...description !== void 0 ? { topic: description } : {} };
+    const ch = await this.request(`/api/channels/${channelId}`, {
+      method: "PATCH",
+      body: JSON.stringify(body)
+    });
+    return { ...ch, description: ch.topic };
+  }
+  async deleteChannel(channelId) {
+    return this.request(`/api/channels/${channelId}`, { method: "DELETE" });
+  }
+  async reorderChannels(serverId, channelIds) {
+    return this.request(`/api/servers/${serverId}/channels/reorder`, {
+      method: "PUT",
+      body: JSON.stringify({ channelIds })
+    });
+  }
+  async addChannelMember(channelId, userId) {
+    return this.request(`/api/channels/${channelId}/members`, {
+      method: "POST",
+      body: JSON.stringify({ userId })
+    });
+  }
+  async removeChannelMember(channelId, userId) {
+    return this.request(`/api/channels/${channelId}/members/${userId}`, { method: "DELETE" });
+  }
+  // ── Channel Buddy Policy ─────────────────────────────────────────────
+  async setBuddyPolicy(channelId, data) {
+    return this.request(`/api/channels/${channelId}/buddy-policy`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async getBuddyPolicy(channelId) {
+    return this.request(`/api/channels/${channelId}/buddy-policy`);
+  }
+  // ── Messages ──────────────────────────────────────────────────────────
+  async sendMessage(channelId, content, opts) {
+    return this.request(`/api/channels/${channelId}/messages`, {
+      method: "POST",
+      body: JSON.stringify({
+        content,
+        ...opts?.threadId ? { threadId: opts.threadId } : {},
+        ...opts?.replyToId ? { replyToId: opts.replyToId } : {},
+        ...opts?.metadata ? { metadata: opts.metadata } : {}
+      })
+    });
+  }
+  async getMessages(channelId, limit = 50, cursor) {
+    const params = new URLSearchParams({ limit: String(limit) });
+    if (cursor) params.set("cursor", cursor);
+    return this.request(
+      `/api/channels/${channelId}/messages?${params}`
+    );
+  }
+  async getMessage(messageId) {
+    return this.request(`/api/messages/${messageId}`);
+  }
+  async editMessage(messageId, content) {
+    return this.request(`/api/messages/${messageId}`, {
+      method: "PATCH",
+      body: JSON.stringify({ content })
+    });
+  }
+  async deleteMessage(messageId) {
+    await this.request(`/api/messages/${messageId}`, {
+      method: "DELETE"
+    });
+  }
+  // ── Pins ──────────────────────────────────────────────────────────────
+  async pinMessage(messageId, channelId) {
+    if (channelId) {
+      return this.request(`/api/channels/${channelId}/pins/${messageId}`, { method: "PUT" });
+    }
+    return this.request(`/api/messages/${messageId}/pin`, { method: "POST" });
+  }
+  async unpinMessage(messageId, channelId) {
+    if (channelId) {
+      return this.request(`/api/channels/${channelId}/pins/${messageId}`, { method: "DELETE" });
+    }
+    return this.request(`/api/messages/${messageId}/pin`, { method: "DELETE" });
+  }
+  async getPinnedMessages(channelId) {
+    return this.request(`/api/channels/${channelId}/pins`);
+  }
+  // ── Reactions ─────────────────────────────────────────────────────────
+  async addReaction(messageId, emoji) {
+    await this.request(`/api/messages/${messageId}/reactions`, {
+      method: "POST",
+      body: JSON.stringify({ emoji })
+    });
+  }
+  async removeReaction(messageId, emoji) {
+    await this.request(`/api/messages/${messageId}/reactions/${encodeURIComponent(emoji)}`, {
+      method: "DELETE"
+    });
+  }
+  async getReactions(messageId) {
+    return this.request(`/api/messages/${messageId}/reactions`);
+  }
+  // ── Threads ───────────────────────────────────────────────────────────
+  async listThreads(channelId) {
+    return this.request(`/api/channels/${channelId}/threads`);
+  }
+  async createThread(channelId, name, parentMessageId) {
+    return this.request(`/api/channels/${channelId}/threads`, {
+      method: "POST",
+      body: JSON.stringify({ name, parentMessageId })
+    });
+  }
+  async getThread(threadId) {
+    return this.request(`/api/threads/${threadId}`);
+  }
+  async updateThread(threadId, data) {
+    return this.request(`/api/threads/${threadId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteThread(threadId) {
+    return this.request(`/api/threads/${threadId}`, { method: "DELETE" });
+  }
+  async getThreadMessages(threadId, limit = 50, cursor) {
+    const params = new URLSearchParams({ limit: String(limit) });
+    if (cursor) params.set("cursor", cursor);
+    return this.request(`/api/threads/${threadId}/messages?${params}`);
+  }
+  async sendToThread(threadId, content) {
+    return this.request(`/api/threads/${threadId}/messages`, {
+      method: "POST",
+      body: JSON.stringify({ content })
+    });
+  }
+  // ── DMs ───────────────────────────────────────────────────────────────
+  async createDmChannel(userId) {
+    return this.request("/api/dm/channels", {
+      method: "POST",
+      body: JSON.stringify({ userId })
+    });
+  }
+  async listDmChannels() {
+    return this.request("/api/dm/channels");
+  }
+  async getDmMessages(channelId, limit = 50, cursor) {
+    const params = new URLSearchParams({ limit: String(limit) });
+    if (cursor) params.set("cursor", cursor);
+    return this.request(`/api/dm/channels/${channelId}/messages?${params}`);
+  }
+  async sendDmMessage(channelId, content, options) {
+    return this.request(`/api/dm/channels/${channelId}/messages`, {
+      method: "POST",
+      body: JSON.stringify({
+        content,
+        replyToId: options?.replyToId,
+        ...options?.metadata ? { metadata: options.metadata } : {}
+      })
+    });
+  }
+  // ── Notifications ─────────────────────────────────────────────────────
+  async listNotifications(limit = 50, offset = 0) {
+    const params = new URLSearchParams({ limit: String(limit), offset: String(offset) });
+    return this.request(`/api/notifications?${params}`);
+  }
+  async markNotificationRead(notificationId) {
+    return this.request(`/api/notifications/${notificationId}/read`, { method: "PATCH" });
+  }
+  async markAllNotificationsRead() {
+    return this.request("/api/notifications/read-all", { method: "POST" });
+  }
+  async getUnreadCount() {
+    return this.request("/api/notifications/unread-count");
+  }
+  // ── Search ────────────────────────────────────────────────────────────
+  async searchMessages(query) {
+    const params = new URLSearchParams({ query: query.q });
+    if (query.serverId) params.set("serverId", query.serverId);
+    if (query.channelId) params.set("channelId", query.channelId);
+    if (query.authorId) params.set("from", query.authorId);
+    if (query.limit) params.set("limit", String(query.limit));
+    if (query.offset) params.set("offset", String(query.offset));
+    const result = await this.request(`/api/search/messages?${params}`);
+    if (Array.isArray(result)) {
+      return { messages: result, total: result.length };
+    }
+    return result;
+  }
+  // ── Invites ───────────────────────────────────────────────────────────
+  async listInvites() {
+    return this.request("/api/invite-codes");
+  }
+  async createInvites(count, note) {
+    return this.request("/api/invite-codes", {
+      method: "POST",
+      body: JSON.stringify({ count, ...note ? { note } : {} })
+    });
+  }
+  async deactivateInvite(inviteId) {
+    return this.request(`/api/invite-codes/${inviteId}/deactivate`, { method: "PATCH" });
+  }
+  async deleteInvite(inviteId) {
+    return this.request(`/api/invite-codes/${inviteId}`, { method: "DELETE" });
+  }
+  // ── Media ─────────────────────────────────────────────────────────────
+  async uploadMedia(file, filename, contentType, messageId) {
+    const formData = new FormData();
+    const blob = file instanceof Blob ? file : new Blob([file], { type: contentType });
+    formData.append("file", blob, filename);
+    if (messageId) {
+      formData.append("messageId", messageId);
+    }
+    const url = `${this.baseUrl}/api/media/upload`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.token}`
+      },
+      body: formData
+    });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      throw new Error(`Shadow API POST /api/media/upload failed (${res.status}): ${body}`);
+    }
+    return res.json();
+  }
+  /**
+   * Download a file from a URL and upload it to the Shadow media service.
+   * Supports local filesystem paths, file:// URLs, tilde paths, and HTTP(S) URLs.
+   */
+  async uploadMediaFromUrl(mediaUrl, messageId) {
+    const { readFile } = await import("fs/promises");
+    const { basename } = await import("path");
+    const { homedir } = await import("os");
+    let normalizedUrl = mediaUrl.replace(/^\s*MEDIA\s*:\s*/i, "");
+    if (normalizedUrl.startsWith("file://")) {
+      normalizedUrl = normalizedUrl.replace(/^file:\/\//, "");
+    }
+    if (normalizedUrl.startsWith("~")) {
+      normalizedUrl = normalizedUrl.replace(/^~/, homedir());
+    }
+    if (!normalizedUrl.startsWith("/") && !normalizedUrl.startsWith("http://") && !normalizedUrl.startsWith("https://") && !normalizedUrl.startsWith("//")) {
+      const { existsSync } = await import("fs");
+      const { resolve } = await import("path");
+      const cwd = globalThis.process ? globalThis.process.cwd() : "/";
+      const roots = [resolve(homedir(), ".openclaw", "workspace"), cwd];
+      let resolved = false;
+      for (const root of roots) {
+        const candidate = resolve(root, normalizedUrl);
+        if (existsSync(candidate)) {
+          normalizedUrl = candidate;
+          resolved = true;
+          break;
+        }
+      }
+      if (!resolved) {
+        normalizedUrl = resolve(cwd, normalizedUrl);
+      }
+    }
+    if (normalizedUrl.startsWith("/") && !normalizedUrl.startsWith("//")) {
+      const fileBuffer = await readFile(normalizedUrl);
+      const bytes = new Uint8Array(fileBuffer);
+      const filename2 = basename(normalizedUrl);
+      const ext = filename2.split(".").pop()?.toLowerCase() ?? "";
+      const mimeMap = {
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        png: "image/png",
+        gif: "image/gif",
+        webp: "image/webp",
+        svg: "image/svg+xml",
+        mp4: "video/mp4",
+        webm: "video/webm",
+        mp3: "audio/mpeg",
+        wav: "audio/wav",
+        ogg: "audio/ogg",
+        pdf: "application/pdf",
+        txt: "text/plain",
+        csv: "text/csv",
+        json: "application/json",
+        html: "text/html",
+        xml: "application/xml",
+        zip: "application/zip"
+      };
+      const contentType2 = mimeMap[ext] ?? "application/octet-stream";
+      return this.uploadMedia(
+        new Blob([bytes], { type: contentType2 }),
+        filename2,
+        contentType2,
+        messageId
+      );
+    }
+    const res = await fetch(normalizedUrl);
+    if (!res.ok) {
+      throw new Error(`Failed to download media from ${normalizedUrl}: ${res.status}`);
+    }
+    const blob = await res.blob();
+    const urlPath = new URL(normalizedUrl).pathname;
+    const filename = urlPath.split("/").pop() ?? "file";
+    const contentType = blob.type || "application/octet-stream";
+    return this.uploadMedia(blob, filename, contentType, messageId);
+  }
+  async downloadFile(fileUrl) {
+    const headers = {};
+    if (fileUrl.startsWith(this.baseUrl) || fileUrl.startsWith("/")) {
+      headers.Authorization = `Bearer ${this.token}`;
+    }
+    const fullUrl = fileUrl.startsWith("/") ? `${this.baseUrl}${fileUrl}` : fileUrl;
+    const res = await fetch(fullUrl, { headers, redirect: "follow" });
+    if (!res.ok) {
+      throw new Error(`Failed to download file from ${fullUrl}: ${res.status}`);
+    }
+    const buffer = await res.arrayBuffer();
+    const contentType = res.headers.get("content-type") ?? "application/octet-stream";
+    const urlPath = new URL(fullUrl).pathname;
+    const filename = decodeURIComponent(urlPath.split("/").pop() ?? "file");
+    return { buffer, contentType, filename };
+  }
+  // ── Workspace ─────────────────────────────────────────────────────────
+  async getWorkspace(serverId) {
+    return this.request(`/api/servers/${serverId}/workspace`);
+  }
+  async updateWorkspace(serverId, data) {
+    return this.request(`/api/servers/${serverId}/workspace`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async getWorkspaceTree(serverId) {
+    return this.request(`/api/servers/${serverId}/workspace/tree`);
+  }
+  async getWorkspaceStats(serverId) {
+    return this.request(`/api/servers/${serverId}/workspace/stats`);
+  }
+  async getWorkspaceChildren(serverId, parentId) {
+    const params = new URLSearchParams();
+    if (parentId !== void 0 && parentId !== null) params.set("parentId", parentId);
+    const qs = params.toString();
+    return this.request(`/api/servers/${serverId}/workspace/children${qs ? `?${qs}` : ""}`);
+  }
+  async batchWorkspaceChildren(serverId, parentIds) {
+    return this.request(`/api/servers/${serverId}/workspace/children/batch`, {
+      method: "POST",
+      body: JSON.stringify({ parentIds })
+    });
+  }
+  async createWorkspaceFolder(serverId, data) {
+    return this.request(`/api/servers/${serverId}/workspace/folders`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateWorkspaceFolder(serverId, folderId, data) {
+    return this.request(`/api/servers/${serverId}/workspace/folders/${folderId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteWorkspaceFolder(serverId, folderId) {
+    return this.request(`/api/servers/${serverId}/workspace/folders/${folderId}`, {
+      method: "DELETE"
+    });
+  }
+  async searchWorkspaceFolders(serverId, query) {
+    const params = new URLSearchParams();
+    if (query.searchText) params.set("searchText", query.searchText);
+    if (query.limit) params.set("limit", String(query.limit));
+    return this.request(`/api/servers/${serverId}/workspace/folders/search?${params}`);
+  }
+  async createWorkspaceFile(serverId, data) {
+    return this.request(`/api/servers/${serverId}/workspace/files`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async searchWorkspaceFiles(serverId, query) {
+    const params = new URLSearchParams();
+    if (query.parentId) params.set("parentId", query.parentId);
+    if (query.searchText) params.set("searchText", query.searchText);
+    if (query.ext) params.set("ext", query.ext);
+    if (query.limit) params.set("limit", String(query.limit));
+    if (query.offset) params.set("offset", String(query.offset));
+    return this.request(`/api/servers/${serverId}/workspace/files/search?${params}`);
+  }
+  async getWorkspaceFile(serverId, fileId) {
+    return this.request(`/api/servers/${serverId}/workspace/files/${fileId}`);
+  }
+  async updateWorkspaceFile(serverId, fileId, data) {
+    return this.request(`/api/servers/${serverId}/workspace/files/${fileId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteWorkspaceFile(serverId, fileId) {
+    return this.request(`/api/servers/${serverId}/workspace/files/${fileId}`, { method: "DELETE" });
+  }
+  async cloneWorkspaceFile(serverId, fileId) {
+    return this.request(`/api/servers/${serverId}/workspace/files/${fileId}/clone`, {
+      method: "POST"
+    });
+  }
+  async pasteWorkspaceNodes(serverId, data) {
+    return this.request(`/api/servers/${serverId}/workspace/nodes/paste`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async executeWorkspaceCommands(serverId, commands) {
+    return this.request(`/api/servers/${serverId}/workspace/commands`, {
+      method: "POST",
+      body: JSON.stringify({ commands })
+    });
+  }
+  async uploadWorkspaceFile(serverId, file, filename, parentId) {
+    const formData = new FormData();
+    formData.append("file", file, filename);
+    if (parentId) formData.append("parentId", parentId);
+    const res = await this.requestRaw(`/api/servers/${serverId}/workspace/upload`, {
+      method: "POST",
+      body: formData
+    });
+    return res.json();
+  }
+  async downloadWorkspace(serverId) {
+    const res = await this.requestRaw(`/api/servers/${serverId}/workspace/download`);
+    return res.arrayBuffer();
+  }
+  async downloadWorkspaceFolder(serverId, folderId) {
+    const res = await this.requestRaw(
+      `/api/servers/${serverId}/workspace/folders/${folderId}/download`
+    );
+    return res.arrayBuffer();
+  }
+  // ── Auth (extended) ───────────────────────────────────────────────────
+  async getUserProfile(userId) {
+    return this.request(`/api/auth/users/${userId}`);
+  }
+  async listOAuthAccounts() {
+    return this.request("/api/auth/oauth/accounts");
+  }
+  async unlinkOAuthAccount(accountId) {
+    return this.request(`/api/auth/oauth/accounts/${accountId}`, { method: "DELETE" });
+  }
+  // ── Friendships ───────────────────────────────────────────────────────
+  async sendFriendRequest(username) {
+    return this.request("/api/friends/request", {
+      method: "POST",
+      body: JSON.stringify({ username })
+    });
+  }
+  async acceptFriendRequest(requestId) {
+    return this.request(`/api/friends/${requestId}/accept`, { method: "POST" });
+  }
+  async rejectFriendRequest(requestId) {
+    return this.request(`/api/friends/${requestId}/reject`, { method: "POST" });
+  }
+  async removeFriend(friendshipId) {
+    return this.request(`/api/friends/${friendshipId}`, { method: "DELETE" });
+  }
+  async listFriends() {
+    return this.request("/api/friends");
+  }
+  async listPendingFriendRequests() {
+    return this.request("/api/friends/pending");
+  }
+  async listSentFriendRequests() {
+    return this.request("/api/friends/sent");
+  }
+  // ── Notifications (extended) ──────────────────────────────────────────
+  async markScopeRead(scope) {
+    return this.request("/api/notifications/read-scope", {
+      method: "POST",
+      body: JSON.stringify(scope)
+    });
+  }
+  async getScopedUnread() {
+    return this.request("/api/notifications/scoped-unread");
+  }
+  async getNotificationPreferences() {
+    return this.request("/api/notifications/preferences");
+  }
+  async updateNotificationPreferences(data) {
+    return this.request("/api/notifications/preferences", {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  // ── OAuth Apps ────────────────────────────────────────────────────────
+  async createOAuthApp(data) {
+    return this.request("/api/oauth/apps", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listOAuthApps() {
+    return this.request("/api/oauth/apps");
+  }
+  async updateOAuthApp(appId, data) {
+    return this.request(`/api/oauth/apps/${appId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteOAuthApp(appId) {
+    return this.request(`/api/oauth/apps/${appId}`, { method: "DELETE" });
+  }
+  async resetOAuthAppSecret(appId) {
+    return this.request(`/api/oauth/apps/${appId}/reset-secret`, { method: "POST" });
+  }
+  async getOAuthAuthorization(params) {
+    const qs = new URLSearchParams(params);
+    return this.request(`/api/oauth/authorize?${qs}`);
+  }
+  async approveOAuthAuthorization(data) {
+    return this.request("/api/oauth/authorize", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async exchangeOAuthToken(data) {
+    return this.request("/api/oauth/token", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listOAuthConsents() {
+    return this.request("/api/oauth/consents");
+  }
+  async revokeOAuthConsent(appId) {
+    return this.request("/api/oauth/revoke", {
+      method: "POST",
+      body: JSON.stringify({ appId })
+    });
+  }
+  // ── Marketplace / Rentals ─────────────────────────────────────────────
+  async browseListings(params) {
+    const qs = new URLSearchParams();
+    if (params?.search) qs.set("search", params.search);
+    if (params?.tags) for (const t of params.tags) qs.append("tags", t);
+    if (params?.minPrice != null) qs.set("minPrice", String(params.minPrice));
+    if (params?.maxPrice != null) qs.set("maxPrice", String(params.maxPrice));
+    if (params?.limit) qs.set("limit", String(params.limit));
+    if (params?.offset) qs.set("offset", String(params.offset));
+    return this.request(`/api/marketplace/listings?${qs}`);
+  }
+  async getListing(listingId) {
+    return this.request(`/api/marketplace/listings/${listingId}`);
+  }
+  async estimateRentalCost(listingId, hours) {
+    const qs = new URLSearchParams({ hours: String(hours) });
+    return this.request(`/api/marketplace/listings/${listingId}/estimate?${qs}`);
+  }
+  async listMyListings() {
+    return this.request("/api/marketplace/my-listings");
+  }
+  async createListing(data) {
+    return this.request("/api/marketplace/listings", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateListing(listingId, data) {
+    return this.request(`/api/marketplace/listings/${listingId}`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async toggleListing(listingId) {
+    return this.request(`/api/marketplace/listings/${listingId}/toggle`, { method: "PUT" });
+  }
+  async deleteListing(listingId) {
+    return this.request(`/api/marketplace/listings/${listingId}`, { method: "DELETE" });
+  }
+  async signContract(data) {
+    return this.request("/api/marketplace/contracts", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listContracts(params) {
+    const qs = new URLSearchParams();
+    if (params?.role) qs.set("role", params.role);
+    if (params?.status) qs.set("status", params.status);
+    return this.request(`/api/marketplace/contracts?${qs}`);
+  }
+  async getContract(contractId) {
+    return this.request(`/api/marketplace/contracts/${contractId}`);
+  }
+  async terminateContract(contractId) {
+    return this.request(`/api/marketplace/contracts/${contractId}/terminate`, { method: "POST" });
+  }
+  async recordUsageSession(contractId, data) {
+    return this.request(`/api/marketplace/contracts/${contractId}/usage`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async reportViolation(contractId, data) {
+    return this.request(`/api/marketplace/contracts/${contractId}/violate`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  // ── Shop ──────────────────────────────────────────────────────────────
+  async getShop(serverId) {
+    return this.request(`/api/servers/${serverId}/shop`);
+  }
+  async updateShop(serverId, data) {
+    return this.request(`/api/servers/${serverId}/shop`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async listCategories(serverId) {
+    return this.request(`/api/servers/${serverId}/shop/categories`);
+  }
+  async createCategory(serverId, data) {
+    return this.request(`/api/servers/${serverId}/shop/categories`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateCategory(serverId, categoryId, data) {
+    return this.request(`/api/servers/${serverId}/shop/categories/${categoryId}`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteCategory(serverId, categoryId) {
+    return this.request(`/api/servers/${serverId}/shop/categories/${categoryId}`, {
+      method: "DELETE"
+    });
+  }
+  async listProducts(serverId, params) {
+    const qs = new URLSearchParams();
+    if (params?.status) qs.set("status", params.status);
+    if (params?.categoryId) qs.set("categoryId", params.categoryId);
+    if (params?.keyword) qs.set("keyword", params.keyword);
+    if (params?.limit) qs.set("limit", String(params.limit));
+    if (params?.offset) qs.set("offset", String(params.offset));
+    return this.request(`/api/servers/${serverId}/shop/products?${qs}`);
+  }
+  async getProduct(serverId, productId) {
+    return this.request(`/api/servers/${serverId}/shop/products/${productId}`);
+  }
+  async createProduct(serverId, data) {
+    return this.request(`/api/servers/${serverId}/shop/products`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateProduct(serverId, productId, data) {
+    return this.request(`/api/servers/${serverId}/shop/products/${productId}`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteProduct(serverId, productId) {
+    return this.request(`/api/servers/${serverId}/shop/products/${productId}`, { method: "DELETE" });
+  }
+  async getCart(serverId) {
+    return this.request(`/api/servers/${serverId}/shop/cart`);
+  }
+  async addToCart(serverId, data) {
+    return this.request(`/api/servers/${serverId}/shop/cart`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateCartItem(serverId, itemId, quantity) {
+    return this.request(`/api/servers/${serverId}/shop/cart/${itemId}`, {
+      method: "PUT",
+      body: JSON.stringify({ quantity })
+    });
+  }
+  async removeCartItem(serverId, itemId) {
+    return this.request(`/api/servers/${serverId}/shop/cart/${itemId}`, { method: "DELETE" });
+  }
+  async createOrder(serverId, data) {
+    return this.request(`/api/servers/${serverId}/shop/orders`, {
+      method: "POST",
+      body: JSON.stringify(data ?? {})
+    });
+  }
+  async listOrders(serverId) {
+    return this.request(`/api/servers/${serverId}/shop/orders`);
+  }
+  async listShopOrders(serverId) {
+    return this.request(`/api/servers/${serverId}/shop/orders/manage`);
+  }
+  async getOrder(serverId, orderId) {
+    return this.request(`/api/servers/${serverId}/shop/orders/${orderId}`);
+  }
+  async updateOrderStatus(serverId, orderId, status) {
+    return this.request(`/api/servers/${serverId}/shop/orders/${orderId}/status`, {
+      method: "PUT",
+      body: JSON.stringify({ status })
+    });
+  }
+  async cancelOrder(serverId, orderId) {
+    return this.request(`/api/servers/${serverId}/shop/orders/${orderId}/cancel`, {
+      method: "POST"
+    });
+  }
+  async getProductReviews(serverId, productId) {
+    return this.request(`/api/servers/${serverId}/shop/products/${productId}/reviews`);
+  }
+  async createReview(serverId, orderId, data) {
+    return this.request(`/api/servers/${serverId}/shop/orders/${orderId}/review`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async replyToReview(serverId, reviewId, reply) {
+    return this.request(`/api/servers/${serverId}/shop/reviews/${reviewId}/reply`, {
+      method: "PUT",
+      body: JSON.stringify({ reply })
+    });
+  }
+  async getWallet() {
+    return this.request("/api/wallet");
+  }
+  async topUpWallet(amount) {
+    return this.request("/api/wallet/topup", {
+      method: "POST",
+      body: JSON.stringify({ amount })
+    });
+  }
+  async getWalletTransactions() {
+    return this.request("/api/wallet/transactions");
+  }
+  async getEntitlements(serverId) {
+    return this.request(`/api/servers/${serverId}/shop/entitlements`);
+  }
+  // ── Task Center ───────────────────────────────────────────────────────
+  async getTaskCenter() {
+    return this.request("/api/tasks");
+  }
+  async claimTask(taskKey) {
+    return this.request(`/api/tasks/${taskKey}/claim`, { method: "POST" });
+  }
+  async getReferralSummary() {
+    return this.request("/api/tasks/referral-summary");
+  }
+  async getRewardHistory() {
+    return this.request("/api/tasks/rewards");
+  }
+  // ── Server Apps ───────────────────────────────────────────────────────
+  async listApps(serverId, params) {
+    const qs = new URLSearchParams();
+    if (params?.status) qs.set("status", params.status);
+    if (params?.limit) qs.set("limit", String(params.limit));
+    if (params?.offset) qs.set("offset", String(params.offset));
+    return this.request(`/api/servers/${serverId}/apps?${qs}`);
+  }
+  async getHomepageApp(serverId) {
+    return this.request(`/api/servers/${serverId}/apps/homepage`);
+  }
+  async getApp(serverId, appId) {
+    return this.request(`/api/servers/${serverId}/apps/${appId}`);
+  }
+  async createApp(serverId, data) {
+    return this.request(`/api/servers/${serverId}/apps`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateApp(serverId, appId, data) {
+    return this.request(`/api/servers/${serverId}/apps/${appId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteApp(serverId, appId) {
+    return this.request(`/api/servers/${serverId}/apps/${appId}`, { method: "DELETE" });
+  }
+  async publishApp(serverId, data) {
+    return this.request(`/api/servers/${serverId}/apps/publish`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+};
+
+// src/constants.ts
+var import_shared = require("@shadowob/shared");
+var channelRoom = (channelId) => `channel:${channelId}`;
+var threadRoom = (threadId) => `thread:${threadId}`;
+var userRoom = (userId) => `user:${userId}`;
+
+// src/socket.ts
+var import_socket = require("socket.io-client");
+var ShadowSocket = class {
+  socket;
+  _connected = false;
+  constructor(options) {
+    this.socket = (0, import_socket.io)(options.serverUrl, {
+      auth: { token: options.token },
+      transports: options.transports ?? ["websocket"],
+      autoConnect: false,
+      reconnection: options.autoReconnect ?? true,
+      reconnectionDelay: options.reconnectionDelay ?? 1e3
+    });
+    this.socket.on("connect", () => {
+      this._connected = true;
+    });
+    this.socket.on("disconnect", () => {
+      this._connected = false;
+    });
+  }
+  /** Whether the socket is currently connected */
+  get connected() {
+    return this._connected;
+  }
+  /** The underlying Socket.IO socket instance */
+  get raw() {
+    return this.socket;
+  }
+  // ── Connection lifecycle ──────────────────────────────────────────────
+  /** Connect to the Shadow server */
+  connect() {
+    if (!this.socket.connected) {
+      this.socket.connect();
+    }
+  }
+  /** Disconnect from the Shadow server */
+  disconnect() {
+    this.socket.disconnect();
+  }
+  /** Wait until the socket is connected (resolves immediately if already connected) */
+  waitForConnect(timeoutMs = 5e3) {
+    if (this.socket.connected) return Promise.resolve();
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        reject(new Error(`Socket connect timeout after ${timeoutMs}ms`));
+      }, timeoutMs);
+      this.socket.once("connect", () => {
+        clearTimeout(timer);
+        resolve();
+      });
+    });
+  }
+  // ── Typed event listeners ─────────────────────────────────────────────
+  /** Listen for a server event */
+  on(event, handler) {
+    this.socket.on(event, handler);
+    return this;
+  }
+  /** Listen for a server event (one-time) */
+  once(event, handler) {
+    this.socket.once(event, handler);
+    return this;
+  }
+  /** Remove a specific event listener */
+  off(event, handler) {
+    this.socket.off(event, handler);
+    return this;
+  }
+  /** Remove all listeners for an event or all events */
+  removeAllListeners(event) {
+    if (event) {
+      this.socket.removeAllListeners(event);
+    } else {
+      this.socket.removeAllListeners();
+    }
+    return this;
+  }
+  // ── Connection event listeners ────────────────────────────────────────
+  /** Listen for raw connection events (connect, disconnect, connect_error) */
+  onConnect(handler) {
+    this.socket.on("connect", handler);
+    return this;
+  }
+  onDisconnect(handler) {
+    this.socket.on("disconnect", handler);
+    return this;
+  }
+  onConnectError(handler) {
+    this.socket.on("connect_error", handler);
+    return this;
+  }
+  // ── Room management ───────────────────────────────────────────────────
+  /** Join a channel room to receive its messages and events */
+  joinChannel(channelId) {
+    return new Promise((resolve) => {
+      this.socket.emit(
+        "channel:join",
+        { channelId },
+        (res) => {
+          resolve(res ?? { ok: true });
+        }
+      );
+    });
+  }
+  /** Leave a channel room */
+  leaveChannel(channelId) {
+    this.socket.emit("channel:leave", { channelId });
+  }
+  // ── Client actions ────────────────────────────────────────────────────
+  /** Send a message via WebSocket (text-only; for file attachments use REST) */
+  sendMessage(data) {
+    this.socket.emit("message:send", data);
+  }
+  /** Send a typing indicator */
+  sendTyping(channelId) {
+    this.socket.emit("message:typing", { channelId });
+  }
+  /** Update user presence status */
+  updatePresence(status) {
+    this.socket.emit("presence:update", { status });
+  }
+  /** Update activity status in a channel (e.g. 'thinking', 'working', null) */
+  updateActivity(channelId, activity) {
+    this.socket.emit("presence:activity", { channelId, activity });
+  }
+  // ── DM actions ────────────────────────────────────────────────────────
+  /** Join a DM channel room */
+  joinDmChannel(dmChannelId) {
+    this.socket.emit("dm:join", { dmChannelId });
+  }
+  /** Leave a DM channel room */
+  leaveDmChannel(dmChannelId) {
+    this.socket.emit("dm:leave", { dmChannelId });
+  }
+  /** Send a DM message via WebSocket */
+  sendDmMessage(data) {
+    this.socket.emit("dm:send", data);
+  }
+  /** Send a DM typing indicator */
+  sendDmTyping(dmChannelId) {
+    this.socket.emit("dm:typing", { dmChannelId });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CLIENT_EVENTS,
+  SERVER_EVENTS,
+  ShadowClient,
+  ShadowSocket,
+  channelRoom,
+  threadRoom,
+  userRoom
+});