@shadowob/sdk 1.1.1 → 1.1.3-dev.261

package/dist/index.js

@@ -1,10 +1,46 @@
 // src/client.ts
+function sanitizeErrorBody(body) {
+  if (!body) return "(empty response)";
+  if (!/<[^>]+>/.test(body)) return body.slice(0, 500);
+  const titleMatch = /<title>([^<]+)<\/title>/i.exec(body);
+  if (titleMatch?.[1]) return titleMatch[1].trim();
+  const text = body.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
+  return text.slice(0, 200) || "(HTML error page)";
+}
+function contentDispositionFilename(header) {
+  if (!header) return null;
+  const utf8Match = /filename\*=UTF-8''([^;]+)/i.exec(header);
+  if (utf8Match?.[1]) {
+    try {
+      return decodeURIComponent(utf8Match[1].trim());
+    } catch {
+      return utf8Match[1].trim();
+    }
+  }
+  const quotedMatch = /filename="([^"]+)"/i.exec(header);
+  if (quotedMatch?.[1]) return quotedMatch[1];
+  const bareMatch = /filename=([^;]+)/i.exec(header);
+  return bareMatch?.[1]?.trim() ?? null;
+}
 var ShadowClient = class {
   constructor(baseUrl, token) {
     this.token = token;
     this.baseUrl = baseUrl.replace(/\/api\/?$/, "");
   }
   baseUrl;
+  isShadowPrivateMediaUrl(value) {
+    if (value.startsWith("/shadow/uploads/") || value.startsWith("/api/media/signed/")) {
+      return true;
+    }
+    if (!/^https?:\/\//.test(value)) return false;
+    try {
+      const url = new URL(value);
+      const base = new URL(this.baseUrl);
+      return url.origin === base.origin && (url.pathname.startsWith("/shadow/uploads/") || url.pathname.startsWith("/api/media/signed/"));
+    } catch {
+      return false;
+    }
+  }
   async request(path, init) {
     const url = `${this.baseUrl}${path}`;
     const controller = new AbortController();
@@ -21,11 +57,19 @@ var ShadowClient = class {
       });
       if (!res.ok) {
         const body = await res.text().catch(() => "");
+        const message = sanitizeErrorBody(body);
         throw new Error(
-          `Shadow API ${init?.method ?? "GET"} ${path} failed (${res.status}): ${body}`
+          `Shadow API ${init?.method ?? "GET"} ${path} failed (${res.status}): ${message}`
         );
       }
-      return res.json();
+      const payload = await res.json();
+      if (payload && typeof payload === "object" && !Array.isArray(payload) && "ok" in payload && !("success" in payload)) {
+        return {
+          ...payload,
+          success: Boolean(payload.ok)
+        };
+      }
+      return payload;
     } finally {
       clearTimeout(timeout);
     }
@@ -41,7 +85,10 @@ var ShadowClient = class {
     });
     if (!res.ok) {
       const body = await res.text().catch(() => "");
-      throw new Error(`Shadow API ${init?.method ?? "GET"} ${path} failed (${res.status}): ${body}`);
+      const message = sanitizeErrorBody(body);
+      throw new Error(
+        `Shadow API ${init?.method ?? "GET"} ${path} failed (${res.status}): ${message}`
+      );
     }
     return res;
   }
@@ -58,8 +105,23 @@ var ShadowClient = class {
       body: JSON.stringify(data)
     });
   }
-  async refreshToken() {
-    return this.request("/api/auth/refresh", { method: "POST" });
+  async startEmailLogin(data) {
+    return this.request("/api/auth/email/start", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async verifyEmailLogin(data) {
+    return this.request("/api/auth/email/verify", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async refreshToken(refreshToken) {
+    return this.request("/api/auth/refresh", {
+      method: "POST",
+      body: JSON.stringify({ refreshToken })
+    });
   }
   async getMe() {
     return this.request("/api/auth/me");
@@ -73,9 +135,51 @@ var ShadowClient = class {
   async disconnect() {
     return this.request("/api/auth/disconnect", { method: "POST" });
   }
+  async getMembership() {
+    return this.request("/api/membership/me");
+  }
+  async redeemInviteCode(code) {
+    return this.request("/api/membership/redeem-invite", {
+      method: "POST",
+      body: JSON.stringify({ code })
+    });
+  }
+  async launchPlay(data) {
+    return this.request("/api/play/launch", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async getPlayCatalog() {
+    const response = await this.request("/api/play/catalog");
+    return response.plays;
+  }
+  // ── Official Model Proxy ──────────────────────────────────────────────
+  async listOfficialModelProxyModels() {
+    return this.request("/api/ai/v1/models");
+  }
+  async getOfficialModelProxyBilling() {
+    return this.request("/api/ai/v1/billing");
+  }
+  async createOfficialChatCompletion(data) {
+    return this.request("/api/ai/v1/chat/completions", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async createOfficialChatCompletionStream(data) {
+    return this.requestRaw("/api/ai/v1/chat/completions", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ ...data, stream: true })
+    });
+  }
   // ── Agents ────────────────────────────────────────────────────────────
-  async listAgents() {
-    return this.request("/api/agents");
+  async listAgents(options) {
+    const params = new URLSearchParams();
+    if (options?.includeRentals) params.set("includeRentals", "true");
+    const query = params.toString();
+    return this.request(`/api/agents${query ? `?${query}` : ""}`);
   }
   async createAgent(data) {
     return this.request("/api/agents", {
@@ -110,21 +214,62 @@ var ShadowClient = class {
       body: JSON.stringify({})
     });
   }
+  async reportAgentUsageSnapshot(agentId, snapshot) {
+    return this.request(`/api/agents/${agentId}/usage-snapshot`, {
+      method: "POST",
+      body: JSON.stringify(snapshot)
+    });
+  }
   async getAgentConfig(agentId) {
     return this.request(`/api/agents/${agentId}/config`);
   }
+  async updateAgentSlashCommands(agentId, commands) {
+    return this.request(`/api/agents/${agentId}/slash-commands`, {
+      method: "PUT",
+      body: JSON.stringify({ commands })
+    });
+  }
+  async getAgentSlashCommands(agentId) {
+    return this.request(`/api/agents/${agentId}/slash-commands`);
+  }
+  async listChannelSlashCommands(channelId) {
+    return this.request(
+      `/api/channels/${channelId}/slash-commands`
+    );
+  }
   // ── Agent Policies ────────────────────────────────────────────────────
   async listPolicies(agentId, serverId) {
-    return this.request(`/api/agents/${agentId}/servers/${serverId}/policies`);
+    const policies = await this.request(`/api/agents/${agentId}/policies`);
+    if (!serverId) return policies;
+    return policies.filter((policy) => policy.serverId === serverId);
   }
   async upsertPolicy(agentId, serverId, data) {
-    return this.request(`/api/agents/${agentId}/servers/${serverId}/policies`, {
+    const policy = {
+      serverId,
+      ...data.channelId !== void 0 ? { channelId: data.channelId } : {},
+      ...data.mentionOnly !== void 0 ? { mentionOnly: data.mentionOnly } : {},
+      ...data.reply !== void 0 ? { reply: data.reply } : {},
+      ...data.config !== void 0 ? { config: data.config } : {}
+    };
+    const results = await this.request(`/api/agents/${agentId}/policies`, {
       method: "PUT",
-      body: JSON.stringify(data)
+      body: JSON.stringify({ policies: [policy] })
     });
+    const [result] = results;
+    if (!result) {
+      throw new Error(`Shadow API PUT /api/agents/${agentId}/policies returned no policy result`);
+    }
+    return result;
   }
   async deletePolicy(agentId, serverId, channelId) {
-    return this.request(`/api/agents/${agentId}/servers/${serverId}/policies/${channelId}`, {
+    const policies = await this.listPolicies(agentId, serverId);
+    const policy = policies.find((entry) => entry.channelId === channelId);
+    if (!policy?.id) {
+      throw new Error(
+        `Shadow policy not found for agent ${agentId} in server ${serverId} channel ${channelId}`
+      );
+    }
+    return this.request(`/api/agents/${agentId}/policies/${policy.id}`, {
       method: "DELETE"
     });
   }
@@ -147,6 +292,9 @@ var ShadowClient = class {
   async getServer(serverIdOrSlug) {
     return this.request(`/api/servers/${serverIdOrSlug}`);
   }
+  async getServerAccess(serverIdOrSlug) {
+    return this.request(`/api/servers/${serverIdOrSlug}/access`);
+  }
   async updateServer(serverIdOrSlug, data) {
     return this.request(`/api/servers/${serverIdOrSlug}`, {
       method: "PATCH",
@@ -165,6 +313,20 @@ var ShadowClient = class {
       body: JSON.stringify(inviteCode ? { inviteCode } : {})
     });
   }
+  async requestServerAccess(serverIdOrSlug) {
+    return this.request(
+      `/api/servers/${serverIdOrSlug}/join-requests`,
+      {
+        method: "POST"
+      }
+    );
+  }
+  async reviewServerJoinRequest(requestId, status) {
+    return this.request(`/api/servers/join-requests/${requestId}`, {
+      method: "PATCH",
+      body: JSON.stringify({ status })
+    });
+  }
   async leaveServer(serverId) {
     return this.request(`/api/servers/${serverId}/leave`, { method: "POST" });
   }
@@ -181,7 +343,7 @@ var ShadowClient = class {
     return this.request(`/api/servers/${serverId}/members/${userId}`, { method: "DELETE" });
   }
   async regenerateInviteCode(serverId) {
-    return this.request(`/api/servers/${serverId}/invite`, { method: "POST" });
+    return this.request(`/api/servers/${serverId}/invite/regenerate`, { method: "POST" });
   }
   async addAgentsToServer(serverId, agentIds) {
     return this.request(`/api/servers/${serverId}/agents`, {
@@ -206,6 +368,9 @@ var ShadowClient = class {
     const ch = await this.request(`/api/channels/${channelId}`);
     return { ...ch, description: ch.topic };
   }
+  async getChannelAccess(channelId) {
+    return this.request(`/api/channels/${channelId}/access`);
+  }
   async getChannelMembers(channelId) {
     return this.request(`/api/channels/${channelId}/members`);
   }
@@ -222,8 +387,8 @@ var ShadowClient = class {
     return this.request(`/api/channels/${channelId}`, { method: "DELETE" });
   }
   async reorderChannels(serverId, channelIds) {
-    return this.request(`/api/servers/${serverId}/channels/reorder`, {
-      method: "PUT",
+    return this.request(`/api/servers/${serverId}/channels/positions`, {
+      method: "PATCH",
       body: JSON.stringify({ channelIds })
     });
   }
@@ -233,18 +398,32 @@ var ShadowClient = class {
       body: JSON.stringify({ userId })
     });
   }
+  async requestChannelAccess(channelId) {
+    return this.request(
+      `/api/channels/${channelId}/join-requests`,
+      {
+        method: "POST"
+      }
+    );
+  }
+  async reviewChannelJoinRequest(requestId, status) {
+    return this.request(`/api/channel-join-requests/${requestId}`, {
+      method: "PATCH",
+      body: JSON.stringify({ status })
+    });
+  }
   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`, {
+  async setBuddyPolicy(channelId, agentId, data) {
+    return this.request(`/api/channels/${channelId}/agents/${agentId}/policy`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
-  async getBuddyPolicy(channelId) {
-    return this.request(`/api/channels/${channelId}/buddy-policy`);
+  async getBuddyPolicy(channelId, agentId) {
+    return this.request(`/api/channels/${channelId}/agents/${agentId}/policy`);
   }
   // ── Messages ──────────────────────────────────────────────────────────
   async sendMessage(channelId, content, opts) {
@@ -254,10 +433,27 @@ var ShadowClient = class {
         content,
         ...opts?.threadId ? { threadId: opts.threadId } : {},
         ...opts?.replyToId ? { replyToId: opts.replyToId } : {},
-        ...opts?.metadata ? { metadata: opts.metadata } : {}
+        ...opts?.mentions ? { mentions: opts.mentions } : {},
+        ...opts?.metadata ? { metadata: opts.metadata } : {},
+        ...opts?.attachments ? { attachments: opts.attachments } : {}
       })
     });
   }
+  async suggestMentions(input) {
+    const params = new URLSearchParams({
+      channelId: input.channelId,
+      trigger: input.trigger
+    });
+    if (input.query) params.set("q", input.query);
+    if (input.limit) params.set("limit", String(input.limit));
+    return this.request(`/api/mentions/suggest?${params}`);
+  }
+  async resolveMentions(input) {
+    return this.request("/api/mentions/resolve", {
+      method: "POST",
+      body: JSON.stringify(input)
+    });
+  }
   async getMessages(channelId, limit = 50, cursor) {
     const params = new URLSearchParams({ limit: String(limit) });
     if (cursor) params.set("cursor", cursor);
@@ -268,6 +464,20 @@ var ShadowClient = class {
   async getMessage(messageId) {
     return this.request(`/api/messages/${messageId}`);
   }
+  async submitInteractiveAction(messageId, input) {
+    return this.request(`/api/messages/${messageId}/interactive`, {
+      method: "POST",
+      body: JSON.stringify(input)
+    });
+  }
+  async getInteractiveState(messageId, blockId) {
+    const params = new URLSearchParams();
+    if (blockId) params.set("blockId", blockId);
+    const query = params.toString();
+    return this.request(
+      `/api/messages/${messageId}/interactive-state${query ? `?${query}` : ""}`
+    );
+  }
   async editMessage(messageId, content) {
     return this.request(`/api/messages/${messageId}`, {
       method: "PATCH",
@@ -281,16 +491,10 @@ var ShadowClient = class {
   }
   // ── 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" });
+    return this.request(`/api/channels/${channelId}/pins/${messageId}`, { method: "PUT" });
   }
   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" });
+    return this.request(`/api/channels/${channelId}/pins/${messageId}`, { method: "DELETE" });
   }
   async getPinnedMessages(channelId) {
     return this.request(`/api/channels/${channelId}/pins`);
@@ -337,36 +541,26 @@ var ShadowClient = class {
     if (cursor) params.set("cursor", cursor);
     return this.request(`/api/threads/${threadId}/messages?${params}`);
   }
-  async sendToThread(threadId, content) {
+  async sendToThread(threadId, content, options) {
     return this.request(`/api/threads/${threadId}/messages`, {
       method: "POST",
-      body: JSON.stringify({ content })
+      body: JSON.stringify({
+        content,
+        ...options?.replyToId ? { replyToId: options.replyToId } : {},
+        ...options?.mentions ? { mentions: options.mentions } : {},
+        ...options?.metadata ? { metadata: options.metadata } : {}
+      })
     });
   }
-  // ── DMs ───────────────────────────────────────────────────────────────
-  async createDmChannel(userId) {
-    return this.request("/api/dm/channels", {
+  // ── Direct channels ──────────────────────────────────────────────────
+  async createDirectChannel(userId) {
+    return this.request("/api/channels/dm", {
       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 } : {}
-      })
-    });
+  async listDirectChannels() {
+    return this.request("/api/channels/dm");
   }
   // ── Notifications ─────────────────────────────────────────────────────
   async listNotifications(limit = 50, offset = 0) {
@@ -417,8 +611,10 @@ var ShadowClient = class {
     const formData = new FormData();
     const blob = file instanceof Blob ? file : new Blob([file], { type: contentType });
     formData.append("file", blob, filename);
-    if (messageId) {
+    if (typeof messageId === "string") {
       formData.append("messageId", messageId);
+    } else if (messageId) {
+      if (messageId.messageId) formData.append("messageId", messageId.messageId);
     }
     const url = `${this.baseUrl}/api/media/upload`;
     const res = await fetch(url, {
@@ -434,6 +630,20 @@ var ShadowClient = class {
     }
     return res.json();
   }
+  async resolveAttachmentMediaUrl(attachmentId, options) {
+    const disposition = options?.disposition ?? "inline";
+    return this.request(
+      `/api/attachments/${attachmentId}/media-url?disposition=${disposition}`
+    );
+  }
+  async resolveWorkspaceMediaUrl(serverId, fileId, options) {
+    const params = new URLSearchParams();
+    params.set("disposition", options?.disposition ?? "inline");
+    if (options?.contentRef) params.set("contentRef", options.contentRef);
+    return this.request(
+      `/api/servers/${serverId}/workspace/files/${fileId}/media-url?${params}`
+    );
+  }
   /**
    * 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.
@@ -449,6 +659,15 @@ var ShadowClient = class {
     if (normalizedUrl.startsWith("~")) {
       normalizedUrl = normalizedUrl.replace(/^~/, homedir());
     }
+    if (this.isShadowPrivateMediaUrl(normalizedUrl)) {
+      const downloaded = await this.downloadFile(normalizedUrl);
+      return this.uploadMedia(
+        downloaded.buffer,
+        downloaded.filename,
+        downloaded.contentType,
+        messageId
+      );
+    }
     if (!normalizedUrl.startsWith("/") && !normalizedUrl.startsWith("http://") && !normalizedUrl.startsWith("https://") && !normalizedUrl.startsWith("//")) {
       const { existsSync } = await import("fs");
       const { resolve } = await import("path");
@@ -523,7 +742,7 @@ var ShadowClient = class {
     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");
+    const filename = contentDispositionFilename(res.headers.get("content-disposition")) ?? decodeURIComponent(urlPath.split("/").pop() ?? "file");
     return { buffer, contentType, filename };
   }
   // ── Workspace ─────────────────────────────────────────────────────────
@@ -651,6 +870,21 @@ var ShadowClient = class {
   async unlinkOAuthAccount(accountId) {
     return this.request(`/api/auth/oauth/accounts/${accountId}`, { method: "DELETE" });
   }
+  async changePassword(data) {
+    return this.request("/api/auth/password", {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async getDashboard() {
+    return this.request("/api/auth/dashboard");
+  }
+  async loginWithGoogleIdToken(idToken) {
+    return this.request("/api/auth/google/id-token", {
+      method: "POST",
+      body: JSON.stringify({ idToken })
+    });
+  }
   // ── Friendships ───────────────────────────────────────────────────────
   async sendFriendRequest(username) {
     return this.request("/api/friends/request", {
@@ -695,6 +929,27 @@ var ShadowClient = class {
       body: JSON.stringify(data)
     });
   }
+  async getNotificationChannelPreferences() {
+    return this.request("/api/notifications/channel-preferences");
+  }
+  async updateNotificationChannelPreference(data) {
+    return this.request("/api/notifications/channel-preferences", {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async registerPushToken(data) {
+    return this.request("/api/notifications/push-tokens", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async registerWebPushSubscription(data) {
+    return this.request("/api/notifications/web-push-subscriptions", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
   // ── OAuth Apps ────────────────────────────────────────────────────────
   async createOAuthApp(data) {
     return this.request("/api/oauth/apps", {
@@ -742,6 +997,21 @@ var ShadowClient = class {
       body: JSON.stringify({ appId })
     });
   }
+  async sendOAuthChannelMessage(channelId, content, opts) {
+    return this.request(`/api/oauth/channels/${channelId}/messages`, {
+      method: "POST",
+      body: JSON.stringify({
+        content,
+        ...opts?.metadata ? { metadata: opts.metadata } : {}
+      })
+    });
+  }
+  async sendOAuthBuddyMessage(buddyId, data) {
+    return this.request(`/api/oauth/buddies/${buddyId}/messages`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
   // ── Marketplace / Rentals ─────────────────────────────────────────────
   async browseListings(params) {
     const qs = new URLSearchParams();
@@ -815,6 +1085,133 @@ var ShadowClient = class {
   async getShop(serverId) {
     return this.request(`/api/servers/${serverId}/shop`);
   }
+  async getMyShop() {
+    return this.request("/api/me/shop");
+  }
+  async upsertMyShop(data) {
+    return this.request("/api/me/shop", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async getUserShop(userId) {
+    return this.request(`/api/users/${userId}/shop`);
+  }
+  async getManagedUserShop(userId) {
+    return this.request(`/api/users/${userId}/shop/manage`);
+  }
+  async upsertManagedUserShop(userId, data) {
+    return this.request(`/api/users/${userId}/shop/manage`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async getShopById(shopId) {
+    return this.request(`/api/shops/${shopId}`);
+  }
+  async listShopProducts(shopId, params) {
+    const qs = new URLSearchParams();
+    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/shops/${shopId}/products?${qs}`);
+  }
+  async getScopeNeutralProduct(productId) {
+    return this.request(`/api/products/${productId}`);
+  }
+  async getShopProduct(shopId, productId) {
+    return this.request(`/api/shops/${shopId}/products/${productId}`);
+  }
+  async createShopProduct(shopId, data) {
+    return this.request(`/api/shops/${shopId}/products`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateShopProduct(shopId, productId, data) {
+    return this.request(`/api/shops/${shopId}/products/${productId}`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteShopProduct(shopId, productId) {
+    return this.request(`/api/shops/${shopId}/products/${productId}`, { method: "DELETE" });
+  }
+  async purchaseShopProduct(shopId, productId, data) {
+    return this.request(`/api/shops/${shopId}/products/${productId}/purchase`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async purchaseCommerceOffer(offerId, data) {
+    return this.request(`/api/commerce/offers/${offerId}/purchase`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async getCommerceOfferCheckoutPreview(offerId, params) {
+    const qs = new URLSearchParams();
+    if (params?.skuId) qs.set("skuId", params.skuId);
+    if (params?.viewerUserId) qs.set("viewerUserId", params.viewerUserId);
+    const suffix = qs.toString() ? `?${qs}` : "";
+    return this.request(`/api/commerce/offers/${offerId}/checkout-preview${suffix}`);
+  }
+  async createCommerceOffer(shopId, data) {
+    return this.request(`/api/shops/${shopId}/offers`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listCommerceOffers(shopId, params) {
+    const qs = new URLSearchParams();
+    if (params?.keyword) qs.set("keyword", params.keyword);
+    if (params?.limit) qs.set("limit", String(params.limit));
+    return this.request(`/api/shops/${shopId}/offers?${qs}`);
+  }
+  async createCommerceDeliverable(shopId, offerId, data) {
+    return this.request(`/api/shops/${shopId}/offers/${offerId}/deliverables`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listShopAssetDefinitions(shopId) {
+    return this.request(`/api/shops/${shopId}/assets`);
+  }
+  async createShopAssetDefinition(shopId, data) {
+    return this.request(`/api/shops/${shopId}/assets`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateShopAssetDefinition(shopId, assetDefinitionId, data) {
+    return this.request(`/api/shops/${shopId}/assets/${assetDefinitionId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async purchaseMessageCommerceCard(messageId, cardId, data) {
+    return this.request(`/api/messages/${messageId}/commerce-cards/${cardId}/purchase`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listCommerceProductCards(params) {
+    const qs = new URLSearchParams();
+    qs.set("target", params.target);
+    qs.set("channelId", params.channelId);
+    if (params.keyword) qs.set("keyword", params.keyword);
+    if (params.limit) qs.set("limit", String(params.limit));
+    return this.request(`/api/commerce/product-picker?${qs}`);
+  }
+  async openPaidFile(fileId) {
+    return this.request(`/api/paid-files/${fileId}/open`, { method: "POST" });
+  }
+  async listShopEntitlements(shopId, params) {
+    const qs = new URLSearchParams();
+    if (params?.limit) qs.set("limit", String(params.limit));
+    if (params?.offset) qs.set("offset", String(params.offset));
+    return this.request(`/api/shops/${shopId}/entitlements?${qs}`);
+  }
   async updateShop(serverId, data) {
     return this.request(`/api/servers/${serverId}/shop`, {
       method: "PUT",
@@ -889,7 +1286,7 @@ var ShadowClient = class {
   async createOrder(serverId, data) {
     return this.request(`/api/servers/${serverId}/shop/orders`, {
       method: "POST",
-      body: JSON.stringify(data ?? {})
+      body: JSON.stringify(data)
     });
   }
   async listOrders(serverId) {
@@ -930,18 +1327,232 @@ var ShadowClient = class {
   async getWallet() {
     return this.request("/api/wallet");
   }
-  async topUpWallet(amount) {
-    return this.request("/api/wallet/topup", {
+  async topUpWallet(_amount) {
+    throw new Error(
+      "Public wallet top-up is disabled. Use a verified payment flow, refund, settlement, or admin grant."
+    );
+  }
+  async getWalletTransactions(params) {
+    const qs = new URLSearchParams();
+    if (params?.audience) qs.set("audience", params.audience);
+    if (params?.direction) qs.set("direction", params.direction);
+    if (params?.limit != null) qs.set("limit", String(params.limit));
+    if (params?.offset != null) qs.set("offset", String(params.offset));
+    const suffix = qs.toString() ? `?${qs}` : "";
+    return this.request(`/api/wallet/transactions${suffix}`);
+  }
+  // ── Community Economy ────────────────────────────────────────────────
+  async listCommunityAssets() {
+    return this.request("/api/economy/assets");
+  }
+  async getCommunityAsset(grantId) {
+    return this.request(`/api/economy/assets/${grantId}`);
+  }
+  async consumeCommunityAsset(grantId, data) {
+    return this.request(`/api/economy/assets/${grantId}/consume`, {
       method: "POST",
-      body: JSON.stringify({ amount })
+      body: JSON.stringify(data)
     });
   }
-  async getWalletTransactions() {
-    return this.request("/api/wallet/transactions");
+  async lockCommunityAsset(grantId, data) {
+    return this.request(`/api/economy/assets/${grantId}/lock`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async unlockCommunityAsset(grantId, data) {
+    return this.request(`/api/economy/assets/${grantId}/unlock`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async revokeCommunityAsset(grantId, data) {
+    return this.request(`/api/economy/assets/${grantId}/revoke`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async sendTip(data) {
+    return this.request("/api/economy/tips", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listTips() {
+    return this.request("/api/economy/tips");
+  }
+  async sendGift(data) {
+    return this.request("/api/economy/gifts", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listGifts() {
+    return this.request("/api/economy/gifts");
+  }
+  async listSettlements(params) {
+    const qs = new URLSearchParams();
+    if (params?.limit != null) qs.set("limit", String(params.limit));
+    if (params?.offset != null) qs.set("offset", String(params.offset));
+    const suffix = qs.toString() ? `?${qs}` : "";
+    return this.request(`/api/economy/settlements${suffix}`);
+  }
+  async settleAvailableSettlements() {
+    return this.request("/api/economy/settlements/settle", { method: "POST" });
+  }
+  // ── Cloud SaaS DIY Generation ───────────────────────────────────────
+  async createDiyCloudRun(data) {
+    return this.request("/api/cloud-saas/diy/runs", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async getDiyCloudRun(runId) {
+    return this.request(`/api/cloud-saas/diy/runs/${encodeURIComponent(runId)}`);
+  }
+  async createDiyCloudFeedbackRun(runId, data) {
+    return this.request(`/api/cloud-saas/diy/runs/${encodeURIComponent(runId)}/feedback`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async streamDiyCloudRun(runId, options = {}) {
+    const qs = new URLSearchParams();
+    if (options.afterSeq != null) qs.set("afterSeq", String(options.afterSeq));
+    const suffix = qs.toString() ? `?${qs}` : "";
+    return this.requestRaw(
+      `/api/cloud-saas/diy/runs/${encodeURIComponent(runId)}/stream${suffix}`,
+      {
+        headers: { Accept: "text/event-stream" }
+      }
+    );
+  }
+  async cancelDiyCloudRun(runId) {
+    return this.request(`/api/cloud-saas/diy/runs/${encodeURIComponent(runId)}/cancel`, {
+      method: "POST"
+    });
+  }
+  // ── Cloud SaaS Deployment Runtime ──────────────────────────────────
+  async getCloudDeploymentManifest(deploymentId) {
+    return this.request(`/api/cloud-saas/deployments/${encodeURIComponent(deploymentId)}/manifest`);
+  }
+  async syncCloudDeploymentTemplate(deploymentId, data = {}) {
+    return this.request(
+      `/api/cloud-saas/deployments/${encodeURIComponent(deploymentId)}/template`,
+      {
+        method: "POST",
+        body: JSON.stringify(data)
+      }
+    );
+  }
+  async redeployCloudDeployment(deploymentId, data = {}) {
+    return this.request(
+      `/api/cloud-saas/deployments/${encodeURIComponent(deploymentId)}/redeploy`,
+      {
+        method: "POST",
+        body: JSON.stringify(data)
+      }
+    );
+  }
+  async pauseCloudDeployment(deploymentId, data = {}) {
+    return this.request(`/api/cloud-saas/deployments/${encodeURIComponent(deploymentId)}/pause`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async resumeCloudDeployment(deploymentId, data = {}) {
+    return this.request(`/api/cloud-saas/deployments/${encodeURIComponent(deploymentId)}/resume`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listCloudDeploymentBackups(deploymentId, params = {}) {
+    const qs = new URLSearchParams();
+    if (params.agentId) qs.set("agentId", params.agentId);
+    const suffix = qs.toString() ? `?${qs}` : "";
+    return this.request(
+      `/api/cloud-saas/deployments/${encodeURIComponent(deploymentId)}/backups${suffix}`
+    );
+  }
+  async createCloudDeploymentBackup(deploymentId, data = {}) {
+    return this.request(`/api/cloud-saas/deployments/${encodeURIComponent(deploymentId)}/backups`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async restoreCloudDeploymentBackup(deploymentId, data = {}) {
+    return this.request(`/api/cloud-saas/deployments/${encodeURIComponent(deploymentId)}/restore`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  // ── Cloud SaaS Provider Gateway ─────────────────────────────────────
+  async listCloudProviderCatalogs() {
+    return this.request("/api/cloud-saas/provider-catalogs");
+  }
+  async listCloudProviderProfiles() {
+    return this.request("/api/cloud-saas/provider-profiles");
+  }
+  async upsertCloudProviderProfile(data) {
+    return this.request("/api/cloud-saas/provider-profiles", {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async testCloudProviderProfile(profileId) {
+    return this.request(`/api/cloud-saas/provider-profiles/${encodeURIComponent(profileId)}/test`, {
+      method: "POST"
+    });
+  }
+  async refreshCloudProviderProfileModels(profileId) {
+    return this.request(
+      `/api/cloud-saas/provider-profiles/${encodeURIComponent(profileId)}/models/refresh`,
+      { method: "POST" }
+    );
+  }
+  async deleteCloudProviderProfile(profileId) {
+    return this.request(`/api/cloud-saas/provider-profiles/${encodeURIComponent(profileId)}`, {
+      method: "DELETE"
+    });
+  }
+  // ── Recharge (Stripe) ───────────────────────────────────────────────
+  async getRechargeConfig() {
+    return this.request("/api/v1/recharge/config");
+  }
+  async createRechargeIntent(params) {
+    return this.request("/api/v1/recharge/create-intent", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  async getRechargeHistory(params) {
+    const qs = new URLSearchParams();
+    if (params?.limit) qs.set("limit", String(params.limit));
+    if (params?.offset) qs.set("offset", String(params.offset));
+    const query = qs.toString();
+    return this.request(`/api/v1/recharge/history${query ? `?${query}` : ""}`);
+  }
+  async confirmRechargePayment(paymentIntentId) {
+    return this.request("/api/v1/recharge/confirm", {
+      method: "POST",
+      body: JSON.stringify({ paymentIntentId })
+    });
   }
   async getEntitlements(serverId) {
     return this.request(`/api/servers/${serverId}/shop/entitlements`);
   }
+  async getAllEntitlements() {
+    return this.request("/api/entitlements");
+  }
+  async verifyEntitlement(entitlementId) {
+    return this.request(`/api/entitlements/${entitlementId}/verify`);
+  }
+  async cancelEntitlement(entitlementId, reason) {
+    return this.request(`/api/entitlements/${entitlementId}/cancel`, {
+      method: "POST",
+      body: JSON.stringify({ reason })
+    });
+  }
   // ── Task Center ───────────────────────────────────────────────────────
   async getTaskCenter() {
     return this.request("/api/tasks");
@@ -955,41 +1566,126 @@ var ShadowClient = class {
   async getRewardHistory() {
     return this.request("/api/tasks/rewards");
   }
-  // ── Server Apps ───────────────────────────────────────────────────────
-  async listApps(serverId, params) {
+  // ── API Tokens ────────────────────────────────────────────────────────
+  async createApiToken(data) {
+    return this.request("/api/tokens", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async listApiTokens() {
+    return this.request("/api/tokens");
+  }
+  async deleteApiToken(tokenId) {
+    return this.request(`/api/tokens/${tokenId}`, { method: "DELETE" });
+  }
+  // ── Discover ──────────────────────────────────────────────────────────
+  async discoverFeed(params) {
     const qs = new URLSearchParams();
-    if (params?.status) qs.set("status", params.status);
+    if (params?.type) qs.set("type", params.type);
     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}`);
+    return this.request(`/api/discover/feed?${qs}`);
   }
-  async getHomepageApp(serverId) {
-    return this.request(`/api/servers/${serverId}/apps/homepage`);
+  async discoverSearch(params) {
+    const qs = new URLSearchParams({ q: params.q });
+    if (params?.type) qs.set("type", params.type);
+    if (params?.limit) qs.set("limit", String(params.limit));
+    return this.request(`/api/discover/search?${qs}`);
   }
-  async getApp(serverId, appId) {
-    return this.request(`/api/servers/${serverId}/apps/${appId}`);
+  // ── Voice Enhance ─────────────────────────────────────────────────────
+  async enhanceVoice(data) {
+    return this.request("/api/voice/enhance", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
   }
-  async createApp(serverId, data) {
-    return this.request(`/api/servers/${serverId}/apps`, {
+  async enhanceVoiceQuery(params) {
+    const qs = new URLSearchParams({ transcript: params.transcript });
+    if (params.language) qs.set("language", params.language);
+    if (params.enableSelfCorrection !== void 0)
+      qs.set("enableSelfCorrection", String(params.enableSelfCorrection));
+    if (params.enableListFormatting !== void 0)
+      qs.set("enableListFormatting", String(params.enableListFormatting));
+    if (params.enableFillerRemoval !== void 0)
+      qs.set("enableFillerRemoval", String(params.enableFillerRemoval));
+    if (params.enableToneAdjustment !== void 0)
+      qs.set("enableToneAdjustment", String(params.enableToneAdjustment));
+    if (params.targetTone) qs.set("targetTone", params.targetTone);
+    return this.request(`/api/voice/enhance?${qs}`);
+  }
+  async getVoiceConfig() {
+    return this.request("/api/voice/config");
+  }
+  async updateVoiceConfig(data) {
+    return this.request("/api/voice/config", {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
-  async updateApp(serverId, appId, data) {
-    return this.request(`/api/servers/${serverId}/apps/${appId}`, {
-      method: "PATCH",
+  async voiceHealthCheck() {
+    return this.request("/api/voice/health");
+  }
+  // ── Profile Comments ──────────────────────────────────────────────────
+  async getProfileComments(profileUserId, params) {
+    const qs = new URLSearchParams();
+    if (params?.limit) qs.set("limit", String(params.limit));
+    if (params?.offset) qs.set("offset", String(params.offset));
+    return this.request(`/api/profile-comments/${profileUserId}?${qs}`);
+  }
+  async getProfileCommentStats(profileUserId) {
+    return this.request(`/api/profile-comments/${profileUserId}/stats`);
+  }
+  async getCommentReplies(parentId, params) {
+    const qs = new URLSearchParams();
+    if (params?.limit) qs.set("limit", String(params.limit));
+    if (params?.offset) qs.set("offset", String(params.offset));
+    return this.request(`/api/profile-comments/replies/${parentId}?${qs}`);
+  }
+  async createProfileComment(data) {
+    return this.request("/api/profile-comments", {
+      method: "POST",
       body: JSON.stringify(data)
     });
   }
-  async deleteApp(serverId, appId) {
-    return this.request(`/api/servers/${serverId}/apps/${appId}`, { method: "DELETE" });
+  async deleteProfileComment(commentId) {
+    return this.request(`/api/profile-comments/${commentId}`, { method: "DELETE" });
+  }
+  async addProfileCommentReaction(commentId, emoji) {
+    return this.request(`/api/profile-comments/${commentId}/reactions`, {
+      method: "POST",
+      body: JSON.stringify({ emoji })
+    });
+  }
+  async removeProfileCommentReaction(commentId, emoji) {
+    return this.request(`/api/profile-comments/${commentId}/reactions`, {
+      method: "DELETE",
+      body: JSON.stringify({ emoji })
+    });
+  }
+  // ── Agent Dashboard ───────────────────────────────────────────────────
+  async getAgentDashboard(agentId) {
+    return this.request(`/api/agents/${agentId}/dashboard`);
   }
-  async publishApp(serverId, data) {
-    return this.request(`/api/servers/${serverId}/apps/publish`, {
+  async addAgentDashboardEvent(agentId, data) {
+    return this.request(`/api/agents/${agentId}/dashboard/events`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  // ── Channel Archive ───────────────────────────────────────────────────
+  async archiveChannel(channelId, reason) {
+    return this.request(`/api/channels/${channelId}/archive`, {
+      method: "POST",
+      body: JSON.stringify(reason ? { reason } : {})
+    });
+  }
+  async unarchiveChannel(channelId) {
+    return this.request(`/api/channels/${channelId}/unarchive`, { method: "POST" });
+  }
+  async getArchivedChannels(serverId) {
+    return this.request(`/api/servers/${serverId}/channels/archived`);
+  }
 };
 
 // src/constants.ts
@@ -1111,9 +1807,9 @@ var ShadowSocket = class {
   sendMessage(data) {
     this.socket.emit("message:send", data);
   }
-  /** Send a typing indicator */
-  sendTyping(channelId) {
-    this.socket.emit("message:typing", { channelId });
+  /** Send or clear a typing indicator */
+  sendTyping(channelId, typing = true) {
+    this.socket.emit("message:typing", { channelId, typing });
   }
   /** Update user presence status */
   updatePresence(status) {
@@ -1123,23 +1819,6 @@ var ShadowSocket = class {
   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 });
-  }
 };
 export {
   CLIENT_EVENTS,