@axiom-lattice/client-sdk 4.2.0 → 4.3.0

package/dist/index.mjs

@@ -913,8 +913,8 @@ var require_encoding = __commonJS({
         }
         return serializeStream.call(this, output);
       };
-      function TextEncoder(label, options) {
-        if (!(this instanceof TextEncoder))
+      function TextEncoder2(label, options) {
+        if (!(this instanceof TextEncoder2))
           throw TypeError("Called as a function. Did you forget 'new'?");
         options = ToDictionary(options);
         this._encoding = null;
@@ -942,14 +942,14 @@ var require_encoding = __commonJS({
         return enc;
       }
       if (Object.defineProperty) {
-        Object.defineProperty(TextEncoder.prototype, "encoding", {
+        Object.defineProperty(TextEncoder2.prototype, "encoding", {
           /** @this {TextEncoder} */
           get: function() {
             return this._encoding.name.toLowerCase();
           }
         });
       }
-      TextEncoder.prototype.encode = function encode(opt_string, options) {
+      TextEncoder2.prototype.encode = function encode2(opt_string, options) {
         opt_string = opt_string === void 0 ? "" : String(opt_string);
         options = ToDictionary(options);
         if (!this._do_not_flush)
@@ -1805,7 +1805,7 @@ var require_encoding = __commonJS({
         return new XUserDefinedDecoder(options);
       };
       if (!global["TextEncoder"])
-        global["TextEncoder"] = TextEncoder;
+        global["TextEncoder"] = TextEncoder2;
       if (!global["TextDecoder"])
         global["TextDecoder"] = TextDecoder2;
       if (typeof module !== "undefined" && module.exports) {
@@ -2200,6 +2200,127 @@ var AbstractClient = class {
         return response.data;
       }
     };
+    /** Capability bundle namespace for managing tenant-scoped bundles. */
+    this.capabilityBundles = {
+      /**
+       * List all capability bundles visible to the current tenant.
+       * @returns The tenant's capability bundles, unwrapped from the API response.
+       */
+      list: async () => {
+        const response = await this.makeRequest(
+          "/api/capability-bundles"
+        );
+        return response.data;
+      },
+      /**
+       * List valid bundles together with safe invalid-record summaries.
+       * @returns Inventory suitable for management and remediation workflows.
+       */
+      listInventory: async () => {
+        const response = await this.makeRequest("/api/capability-bundles");
+        return { bundles: response.data, errors: response.errors ?? [] };
+      },
+      /**
+       * Get one capability bundle by identifier.
+       * @param bundleId - Capability bundle identifier.
+       * @returns The requested capability bundle.
+       */
+      get: async (bundleId) => {
+        const response = await this.makeRequest(
+          `/api/capability-bundles/${encodeURIComponent(bundleId)}`
+        );
+        return response.data;
+      },
+      /**
+       * Create a capability bundle for the current tenant.
+        * @param input - Bundle name, optional description, and capabilities. The server generates the stable key.
+       * @returns The created capability bundle.
+       */
+      create: async (input) => {
+        const response = await this.makeRequest(
+          "/api/capability-bundles",
+          { method: "POST", body: input }
+        );
+        return response.data;
+      },
+      /**
+       * Update a capability bundle for the current tenant.
+       * @param bundleId - Capability bundle identifier.
+        * @param input - The partial bundle fields and required expected revision to update.
+       * @returns The updated capability bundle.
+       */
+      update: async (bundleId, input) => {
+        const response = await this.makeRequest(
+          `/api/capability-bundles/${encodeURIComponent(bundleId)}`,
+          { method: "PUT", body: input }
+        );
+        return response.data;
+      },
+      /**
+       * Delete a capability bundle when the backend permits deletion.
+       * @param bundleId - Capability bundle identifier.
+       * @returns A promise that resolves after the bundle is deleted.
+       * @throws ApiError when the bundle is missing, in use, or the request fails.
+       */
+      delete: async (bundleId) => {
+        await this.makeRequest(
+          `/api/capability-bundles/${encodeURIComponent(bundleId)}`,
+          { method: "DELETE" }
+        );
+      }
+    };
+    this.projects = {
+      capabilities: {
+        /**
+         * Get a project's selected bundles and its persisted capability preview.
+         * @param projectId - Project identifier.
+         * @returns The project, selected bundles, and preview resolved from persisted selections.
+         */
+        get: async (projectId) => {
+          const response = await this.makeRequest(
+            `/api/projects/${encodeURIComponent(projectId)}/capability-bundles`
+          );
+          return response.data;
+        },
+        /**
+         * Replace a project's selected capability bundles.
+         * @param projectId - Project identifier.
+         * @param bundleIds - Ordered capability bundle identifiers to persist.
+         * @returns The updated project, selected bundles, and persisted-selection preview.
+         */
+        update: async (projectId, bundleIds, expectedRevisions) => {
+          const response = await this.makeRequest(
+            `/api/projects/${encodeURIComponent(projectId)}/capability-bundles`,
+            { method: "PUT", body: { bundleIds, expectedRevisions } }
+          );
+          return response.data;
+        },
+        /**
+         * Preview the capability bundles currently persisted on a project.
+         * @param projectId - Project identifier.
+         * @returns The preview resolved from the project's persisted bundle selections.
+         */
+        preview: async (projectId) => {
+          const response = await this.makeRequest(
+            `/api/projects/${encodeURIComponent(projectId)}/capability-preview`
+          );
+          return response.data;
+        },
+        /**
+         * Preview a draft bundle selection without changing the project.
+         * @param projectId - Project identifier.
+         * @param bundleIds - Ordered capability bundle identifiers to preview.
+         * @returns The draft preview resolved from the supplied bundle IDs; no project state is changed.
+         */
+        previewWithBundles: async (projectId, bundleIds) => {
+          const response = await this.makeRequest(
+            `/api/projects/${encodeURIComponent(projectId)}/capability-preview`,
+            { method: "POST", body: { bundleIds } }
+          );
+          return response.data;
+        }
+      }
+    };
     /** Agent Web Apps namespace for managing React SDK publications. */
     this.webApps = {
       /**
@@ -2215,7 +2336,7 @@ var AbstractClient = class {
         const query = searchParams.toString();
         const response = await this.makeRequest(`/api/web-apps${query ? `?${query}` : ""}`);
         return {
-          records: response.data.records.map((record) => this.hydrateAgentWebApp(record)),
+          records: response.data.records.map((record2) => this.hydrateAgentWebApp(record2)),
           total: response.data.total
         };
       },
@@ -2856,19 +2977,19 @@ var AbstractClient = class {
     if (!value || typeof value !== "object" || Array.isArray(value)) {
       throw new ApiError("Invalid Agent Web App response", 500, value);
     }
-    const record = value;
+    const record2 = value;
     const hydrateDate = (field) => {
-      const raw = record[field];
-      const date = raw instanceof Date ? new Date(raw.getTime()) : new Date(
+      const raw = record2[field];
+      const date2 = raw instanceof Date ? new Date(raw.getTime()) : new Date(
         typeof raw === "string" || typeof raw === "number" ? raw : Number.NaN
       );
-      if (Number.isNaN(date.getTime())) {
+      if (Number.isNaN(date2.getTime())) {
         throw new ApiError(`Invalid Agent Web App ${field}`, 500, value);
       }
-      return date;
+      return date2;
     };
     return {
-      ...record,
+      ...record2,
       createdAt: hydrateDate("createdAt"),
       updatedAt: hydrateDate("updatedAt")
     };
@@ -3308,6 +3429,398 @@ var ExportImportClient = class {
   }
 };
 
+// src/sse-parser.ts
+var SseParseError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.code = "INVALID_EVENT";
+    this.name = "SseParseError";
+  }
+};
+async function* parseSseBody(body, options = {}) {
+  const maxLine = options.maxLineBytes ?? 64 * 1024;
+  const maxEvent = options.maxEventBytes ?? 1024 * 1024;
+  const maxDataLines = options.maxDataLines ?? 1024;
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let event = "";
+  let id;
+  let retry;
+  let data = [];
+  let bytes = 0;
+  const dispatch = () => {
+    if (data.length === 0) {
+      event = "";
+      id = void 0;
+      retry = void 0;
+      bytes = 0;
+      return void 0;
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(data.join("\n"));
+    } catch {
+      throw new SseParseError("Invalid SSE JSON");
+    }
+    if (options.strictJsonObject && (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)))
+      throw new SseParseError("SSE data must be an object");
+    const result = { event, data: parsed, ...id === void 0 ? {} : { id }, ...retry === void 0 ? {} : { retry } };
+    event = "";
+    id = void 0;
+    retry = void 0;
+    data = [];
+    bytes = 0;
+    return result;
+  };
+  const processLine = (raw) => {
+    const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
+    if (new TextEncoder().encode(line).byteLength > maxLine)
+      throw new SseParseError("SSE line is too large");
+    if (line === "")
+      return dispatch();
+    if (line.startsWith(":"))
+      return void 0;
+    const separator = line.indexOf(":");
+    const field = separator < 0 ? line : line.slice(0, separator);
+    let value = separator < 0 ? "" : line.slice(separator + 1);
+    if (value.startsWith(" "))
+      value = value.slice(1);
+    if (field === "event")
+      event = value;
+    else if (field === "data") {
+      if (data.length >= maxDataLines)
+        throw new SseParseError("Too many SSE data lines");
+      data.push(value);
+      bytes += new TextEncoder().encode(value).byteLength + (data.length === 1 ? 0 : 1);
+      if (bytes > maxEvent)
+        throw new SseParseError("SSE event is too large");
+    } else if (field === "id")
+      id = value;
+    else if (field === "retry") {
+      const parsed = Number(value);
+      if (!Number.isInteger(parsed) || parsed < 0 || !Number.isFinite(parsed))
+        throw new SseParseError("Invalid SSE retry");
+      retry = parsed;
+    }
+    return void 0;
+  };
+  try {
+    while (true) {
+      const chunk = await reader.read();
+      if (chunk.done) {
+        buffer += decoder.decode();
+        if (new TextEncoder().encode(buffer).byteLength > maxLine)
+          throw new SseParseError("SSE line is too large");
+        break;
+      }
+      buffer += decoder.decode(chunk.value, { stream: true });
+      if (new TextEncoder().encode(buffer.slice(0, Math.max(0, findLineBreak(buffer) < 0 ? buffer.length : findLineBreak(buffer)))).byteLength > maxLine)
+        throw new SseParseError("SSE line is too large");
+      let index = findLineBreak(buffer);
+      while (index >= 0) {
+        if (buffer[index] === "\r" && index === buffer.length - 1)
+          break;
+        const frame2 = processLine(buffer.slice(0, index));
+        buffer = buffer.slice(index + lineBreakLength(buffer, index));
+        if (frame2)
+          yield frame2;
+        index = findLineBreak(buffer);
+      }
+    }
+    if (buffer) {
+      const frame2 = processLine(buffer);
+      if (frame2)
+        yield frame2;
+    }
+    const frame = processLine("");
+    if (frame)
+      yield frame;
+  } finally {
+    await reader.cancel().catch(() => void 0);
+    reader.releaseLock();
+  }
+}
+function findLineBreak(value) {
+  const lf = value.indexOf("\n");
+  const cr = value.indexOf("\r");
+  if (lf < 0)
+    return cr;
+  if (cr < 0)
+    return lf;
+  return Math.min(lf, cr);
+}
+function lineBreakLength(value, index) {
+  return value[index] === "\r" && value[index + 1] === "\n" ? 2 : 1;
+}
+
+// src/project-rooms.ts
+var ProjectRoomClientError = class extends Error {
+  constructor(message, status, code, retryable, details) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.retryable = retryable;
+    this.details = details;
+    this.name = "ProjectRoomClientError";
+  }
+};
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var date = (value, field) => {
+  const result = value instanceof Date ? new Date(value.getTime()) : new Date(typeof value === "string" || typeof value === "number" ? value : Number.NaN);
+  if (!Number.isFinite(result.getTime()))
+    throw new ProjectRoomClientError(`Invalid ${field}`, 500, "INVALID_RESPONSE", false);
+  return result;
+};
+var requiredString = (record2, field) => {
+  if (typeof record2[field] !== "string")
+    throw new ProjectRoomClientError(`Invalid ${field}`, 500, "INVALID_RESPONSE", false);
+  return record2[field];
+};
+var oneOf = (value, values, field) => {
+  if (typeof value !== "string" || !values.includes(value))
+    throw new ProjectRoomClientError(`Invalid ${field}`, 500, "INVALID_RESPONSE", false);
+  return value;
+};
+var messageSources = ["user", "agent", "task", "routine", "system"];
+var humanRoles = ["owner", "admin", "member", "viewer"];
+var memberStatuses = ["active", "removed"];
+var botRoles = ["coordinator", "specialist"];
+var botStatuses = ["active", "paused", "removed"];
+var exactKeys = (row, required, optional = []) => {
+  if (required.some((key) => !Object.prototype.hasOwnProperty.call(row, key)) || Object.keys(row).some((key) => !required.includes(key) && !optional.includes(key)))
+    throw new ProjectRoomClientError("Invalid Project Room response", 500, "INVALID_RESPONSE", false);
+};
+var hydrateAuthor = (value) => {
+  const row = record(value);
+  const type = oneOf(row.type, ["human", "bot", "system"], "author.type");
+  if (type === "human") {
+    exactKeys(row, ["type", "userId"]);
+    return { type, userId: requiredString(row, "userId") };
+  }
+  if (type === "bot")
+    return { type, membershipId: requiredString(row, "membershipId") };
+  if (Object.keys(row).some((key) => key !== "type"))
+    throw new ProjectRoomClientError("Invalid author", 500, "INVALID_RESPONSE", false);
+  return { type };
+};
+var hydrateMentions = (value) => {
+  if (!Array.isArray(value))
+    throw new ProjectRoomClientError("Invalid mentions", 500, "INVALID_RESPONSE", false);
+  return value.map((entry) => {
+    const row = record(entry);
+    const type = oneOf(row.type, ["bot", "team"], "mention.type");
+    if (type === "team") {
+      if (Object.keys(row).length !== 1)
+        throw new ProjectRoomClientError("Invalid mention", 500, "INVALID_RESPONSE", false);
+      return { type };
+    }
+    return { type, membershipId: requiredString(row, "membershipId") };
+  });
+};
+var record = (value) => {
+  if (!isRecord(value))
+    throw new ProjectRoomClientError("Invalid Project Room response", 500, "INVALID_RESPONSE", false);
+  return value;
+};
+var hydrateRoom = (value) => {
+  const row = record(value);
+  exactKeys(row, ["id", "tenantId", "workspaceId", "projectId", "type", "name", "createdAt", "updatedAt"]);
+  return { id: requiredString(row, "id"), tenantId: requiredString(row, "tenantId"), workspaceId: requiredString(row, "workspaceId"), projectId: requiredString(row, "projectId"), type: oneOf(row.type, ["main"], "type"), name: requiredString(row, "name"), createdAt: date(row.createdAt, "createdAt"), updatedAt: date(row.updatedAt, "updatedAt") };
+};
+var hydrateMessage = (value) => {
+  const row = record(value);
+  exactKeys(row, ["id", "roomId", "author", "content", "mentions", "source", "createdAt"], ["replyToMessageId"]);
+  const content = record(row.content);
+  if (oneOf(content.type, ["text"], "content.type") !== "text")
+    throw new ProjectRoomClientError("Invalid content", 500, "INVALID_RESPONSE", false);
+  return { id: requiredString(row, "id"), roomId: requiredString(row, "roomId"), author: hydrateAuthor(row.author), content: { type: "text", text: requiredString(content, "text") }, mentions: hydrateMentions(row.mentions), ...row.replyToMessageId === void 0 ? {} : { replyToMessageId: requiredString(row, "replyToMessageId") }, source: oneOf(row.source, messageSources, "source"), createdAt: date(row.createdAt, "createdAt") };
+};
+var hydrateMember = (value) => {
+  const row = record(value);
+  exactKeys(row, ["id", "tenantId", "projectId", "userId", "role", "status", "joinedAt", "updatedAt"]);
+  return { id: requiredString(row, "id"), tenantId: requiredString(row, "tenantId"), projectId: requiredString(row, "projectId"), userId: requiredString(row, "userId"), role: oneOf(row.role, humanRoles, "role"), status: oneOf(row.status, memberStatuses, "status"), joinedAt: date(row.joinedAt, "joinedAt"), updatedAt: date(row.updatedAt, "updatedAt") };
+};
+var hydrateBot = (value) => {
+  const row = record(value);
+  exactKeys(row, ["id", "tenantId", "workspaceId", "projectId", "roomId", "assistantId", "role", "title", "mentionName", "status", "roomThreadId", "joinedAt", "updatedAt"], ["responsibility"]);
+  return { id: requiredString(row, "id"), tenantId: requiredString(row, "tenantId"), workspaceId: requiredString(row, "workspaceId"), projectId: requiredString(row, "projectId"), roomId: requiredString(row, "roomId"), assistantId: requiredString(row, "assistantId"), role: oneOf(row.role, botRoles, "role"), title: requiredString(row, "title"), ...row.responsibility === void 0 ? {} : { responsibility: requiredString(row, "responsibility") }, mentionName: requiredString(row, "mentionName"), status: oneOf(row.status, botStatuses, "status"), roomThreadId: requiredString(row, "roomThreadId"), joinedAt: date(row.joinedAt, "joinedAt"), updatedAt: date(row.updatedAt, "updatedAt") };
+};
+var iso = (value) => date(value, "date").toISOString();
+var hydrateDispatch = (value) => {
+  const row = record(value);
+  if (typeof row.success !== "boolean" || row.membershipId !== void 0 && typeof row.membershipId !== "string" || row.errorCode !== void 0 && typeof row.errorCode !== "string")
+    throw new ProjectRoomClientError("Invalid dispatch response", 500, "INVALID_RESPONSE", false);
+  return { success: row.success, ...row.membershipId === void 0 ? {} : { membershipId: row.membershipId }, ...row.errorCode === void 0 ? {} : { errorCode: row.errorCode } };
+};
+var encode = encodeURIComponent;
+var ProjectRoomsClient = class {
+  constructor(baseURL, getHeaders) {
+    this.baseURL = baseURL;
+    this.getHeaders = getHeaders;
+    this.messages = {
+      list: async (projectId, options = {}) => {
+        const query = new URLSearchParams();
+        if (options.cursor) {
+          query.set("beforeCreatedAt", iso(options.cursor.createdAt));
+          query.set("beforeId", options.cursor.id);
+        }
+        if (options.limit !== void 0)
+          query.set("limit", String(options.limit));
+        const result = await this.request(`/api/projects/${encode(projectId)}/room/messages${query.toString() ? `?${query}` : ""}`);
+        if (!Array.isArray(result))
+          throw new ProjectRoomClientError("Invalid messages response", 500, "INVALID_RESPONSE", false);
+        return result.map(hydrateMessage);
+      },
+      send: async (projectId, input) => {
+        const result = await this.request(`/api/projects/${encode(projectId)}/room/messages`, { method: "POST", body: { text: input.text, mentions: input.mentions, ...input.replyToMessageId === void 0 ? {} : { replyToMessageId: input.replyToMessageId } }, headers: { "Idempotency-Key": input.idempotencyKey.trim() } });
+        if (!Array.isArray(result.dispatch) || typeof result.replayed !== "boolean")
+          throw new ProjectRoomClientError("Invalid send response", 500, "INVALID_RESPONSE", false);
+        return { message: hydrateMessage(result.message), dispatch: result.dispatch.map(hydrateDispatch), replayed: result.replayed };
+      },
+      retry: async (projectId, messageId) => {
+        const result = await this.request(`/api/projects/${encode(projectId)}/room/messages/${encode(messageId)}/retry`, { method: "POST", body: {} });
+        if (!Array.isArray(result))
+          throw new ProjectRoomClientError("Invalid retry response", 500, "INVALID_RESPONSE", false);
+        return result.map(hydrateDispatch);
+      }
+    };
+    this.members = {
+      list: async (projectId) => this.records(`/api/projects/${encode(projectId)}/members`, hydrateMember),
+      add: async (projectId, input) => hydrateMember(await this.request(`/api/projects/${encode(projectId)}/members`, { method: "POST", body: input })),
+      update: async (projectId, membershipId, input) => hydrateMember(await this.request(`/api/projects/${encode(projectId)}/members/${encode(membershipId)}`, { method: "PATCH", body: { role: input.role, expectedUpdatedAt: iso(input.expectedUpdatedAt) } })),
+      remove: async (projectId, membershipId, input) => this.request(`/api/projects/${encode(projectId)}/members/${encode(membershipId)}?expectedUpdatedAt=${encode(iso(input.expectedUpdatedAt))}`, { method: "DELETE" })
+    };
+    this.bots = {
+      list: async (projectId) => this.records(`/api/projects/${encode(projectId)}/bots`, hydrateBot),
+      add: async (projectId, input) => hydrateBot(await this.request(`/api/projects/${encode(projectId)}/bots`, { method: "POST", body: input })),
+      update: async (projectId, membershipId, input) => hydrateBot(await this.request(`/api/projects/${encode(projectId)}/bots/${encode(membershipId)}`, { method: "PATCH", body: { ...input, expectedUpdatedAt: iso(input.expectedUpdatedAt) } })),
+      pause: async (projectId, membershipId, input) => hydrateBot(await this.request(`/api/projects/${encode(projectId)}/bots/${encode(membershipId)}/pause`, { method: "POST", body: { expectedUpdatedAt: iso(input.expectedUpdatedAt) } })),
+      resume: async (projectId, membershipId, input) => hydrateBot(await this.request(`/api/projects/${encode(projectId)}/bots/${encode(membershipId)}/resume`, { method: "POST", body: { expectedUpdatedAt: iso(input.expectedUpdatedAt) } })),
+      remove: async (projectId, membershipId, input) => this.request(`/api/projects/${encode(projectId)}/bots/${encode(membershipId)}?expectedUpdatedAt=${encode(iso(input.expectedUpdatedAt))}`, { method: "DELETE" })
+    };
+    this.events = { connect: (projectId, options) => this.connect(projectId, options) };
+  }
+  async getRoom(projectId) {
+    return hydrateRoom(await this.request(`/api/projects/${encode(projectId)}/room`));
+  }
+  async getRealtimeMode(projectId) {
+    return this.request(`/api/projects/${encode(projectId)}/room/realtime-mode`);
+  }
+  async records(path, hydrate) {
+    const result = await this.request(path);
+    if (!Array.isArray(result))
+      throw new ProjectRoomClientError("Invalid records response", 500, "INVALID_RESPONSE", false);
+    return result.map(hydrate);
+  }
+  async request(path, options = {}) {
+    const headers = { ...this.getHeaders(), ...options.headers ?? {} };
+    const body = options.body === void 0 ? void 0 : JSON.parse(JSON.stringify(options.body));
+    const response = await fetch(`${this.baseURL}${path}`, { method: options.method ?? "GET", headers, ...body === void 0 ? {} : { body: JSON.stringify(body) } });
+    const payload = await response.json().catch(() => void 0);
+    if (!response.ok || !payload?.success) {
+      const error = payload?.error;
+      throw new ProjectRoomClientError(typeof error?.message === "string" ? error.message : "Project Room request failed", response.status, typeof error?.code === "string" ? error.code : response.ok ? "INVALID_RESPONSE" : "HTTP_ERROR", error?.retryable === true, error?.details);
+    }
+    if (!Object.prototype.hasOwnProperty.call(payload, "data"))
+      throw new ProjectRoomClientError("Missing response data", 500, "INVALID_RESPONSE", false);
+    return payload.data;
+  }
+  connect(projectId, options) {
+    const headers = { ...this.getHeaders(), Accept: "text/event-stream", ...options.lastEventId ? { "Last-Event-ID": options.lastEventId } : {} };
+    let resolveOpen;
+    let rejectOpen;
+    const opened = new Promise((resolve, reject) => {
+      resolveOpen = resolve;
+      rejectOpen = reject;
+    });
+    const responsePromise = fetch(`${this.baseURL}/api/projects/${encode(projectId)}/room/events`, { headers, signal: options.signal }).then(async (response) => {
+      if (!response.ok) {
+        const payload = await response.json().catch(() => void 0);
+        const error = payload?.error;
+        throw new ProjectRoomClientError(typeof error?.message === "string" ? error.message : "Project Room stream failed", response.status, typeof error?.code === "string" ? error.code : "HTTP_ERROR", error?.retryable === true, error?.details);
+      }
+      if (response.headers?.get && response.headers.get("content-type")?.split(";")[0].trim() !== "text/event-stream")
+        throw new ProjectRoomClientError("Project Room stream has invalid content type", response.status, "INVALID_RESPONSE", false);
+      if (!response.body)
+        throw new ProjectRoomClientError("Project Room stream has no body", 500, "INVALID_RESPONSE", false);
+      resolveOpen({ status: 200, ...options.lastEventId === void 0 ? {} : { lastEventId: options.lastEventId } });
+      return response;
+    }).catch((error) => {
+      rejectOpen(error);
+      throw error;
+    });
+    const stream = async function* () {
+      const response = await responsePromise;
+      const body = response.body;
+      if (!body)
+        throw new ProjectRoomClientError("Project Room stream has no body", 500, "INVALID_RESPONSE", false);
+      for await (const raw of parseSseBody(body, { strictJsonObject: true })) {
+        try {
+          const event = raw.event;
+          const payload = isRecord(raw.data) ? raw.data : void 0;
+          let value = payload;
+          if (event === "ready" || event === "resync" || event === "access.revoked") {
+            if (!payload || Object.prototype.hasOwnProperty.call(payload, "type"))
+              throw new ProjectRoomClientError("Invalid SSE control", 200, "INVALID_EVENT", false);
+            value = { type: event, data: payload };
+          } else {
+            if (typeof payload?.type !== "string" || payload.type !== event || typeof payload.id !== "string" || raw.id !== payload.id)
+              throw new ProjectRoomClientError("Invalid SSE business event", 200, "INVALID_EVENT", false);
+            value = payload;
+          }
+          yield { event: hydrateEvent(value), ...raw.id === void 0 ? {} : { id: raw.id }, ...raw.retry === void 0 ? {} : { retry: raw.retry } };
+        } catch (error) {
+          if (error instanceof ProjectRoomClientError && error.code === "INVALID_EVENT")
+            throw new ProjectRoomClientError(error.message, 400, "INVALID_EVENT", false, error.details);
+          if (error instanceof SseParseError)
+            throw new ProjectRoomClientError(error.message, 400, "INVALID_EVENT", false);
+          if (error instanceof ProjectRoomClientError)
+            throw new ProjectRoomClientError(error.message, 400, "INVALID_EVENT", false, error.details);
+          throw new ProjectRoomClientError("Invalid SSE event", 400, "INVALID_EVENT", false);
+        }
+      }
+    }();
+    return { opened, [Symbol.asyncIterator]: () => stream };
+  }
+};
+function hydrateEvent(value) {
+  const row = record(value);
+  if (row.type === "ready") {
+    exactKeys(row, ["type", "data"]);
+    const data2 = record(row.data);
+    exactKeys(data2, ["epoch", "headEventId"]);
+    if (typeof data2.epoch !== "string" || data2.headEventId !== null && typeof data2.headEventId !== "string")
+      throw new ProjectRoomClientError("Invalid SSE control", 200, "INVALID_EVENT", false);
+    return { type: "ready", data: { epoch: data2.epoch, headEventId: data2.headEventId } };
+  }
+  if (row.type === "resync" || row.type === "access.revoked") {
+    exactKeys(row, ["type", "data"]);
+    const data2 = record(row.data);
+    exactKeys(data2, ["reason"]);
+    const reasons = row.type === "resync" ? ["SERVER_RESTART", "CURSOR_EXPIRED", "SLOW_CONSUMER"] : ["PROJECT_ACCESS_REVOKED", "TOKEN_EXPIRED"];
+    return { type: row.type, data: { reason: oneOf(data2.reason, reasons, "reason") } };
+  }
+  const data = record(row.data);
+  if (row.type === "message.created")
+    return { ...row, occurredAt: date(row.occurredAt, "occurredAt"), data: { message: hydrateMessage(data.message) } };
+  if (row.type === "roster.changed")
+    return { ...row, occurredAt: date(row.occurredAt, "occurredAt"), data: { change: data.change, membership: hydratePublicBot(data.membership) } };
+  if (row.type === "membership.changed")
+    return { ...row, occurredAt: date(row.occurredAt, "occurredAt"), data: { change: data.change, membership: hydratePublicMember(data.membership) } };
+  if (row.type === "task.changed")
+    return { ...row, occurredAt: date(row.occurredAt, "occurredAt"), data: { taskId: requiredString(data, "taskId"), status: data.status, ownerMembershipId: requiredString(data, "ownerMembershipId"), updatedAt: date(data.updatedAt, "updatedAt") } };
+  throw new ProjectRoomClientError("Invalid SSE event", 200, "INVALID_EVENT", false);
+}
+function hydratePublicMember(value) {
+  const row = record(value);
+  return { id: requiredString(row, "id"), userId: requiredString(row, "userId"), role: row.role, status: row.status, joinedAt: date(row.joinedAt, "joinedAt"), updatedAt: date(row.updatedAt, "updatedAt") };
+}
+function hydratePublicBot(value) {
+  const row = record(value);
+  return { id: requiredString(row, "id"), role: row.role, title: requiredString(row, "title"), ...row.responsibility === void 0 ? {} : { responsibility: row.responsibility }, mentionName: requiredString(row, "mentionName"), status: row.status, joinedAt: date(row.joinedAt, "joinedAt"), updatedAt: date(row.updatedAt, "updatedAt") };
+}
+
 // src/client.ts
 var _Client = class extends AbstractClient {
   /**
@@ -3323,6 +3836,7 @@ var _Client = class extends AbstractClient {
     };
     this.resources = new ResourcesClient(this.config.baseURL, () => this.getAllHeaders());
     this.exportImport = new ExportImportClient(this.config, () => this.getAllHeaders());
+    this.projectRooms = new ProjectRoomsClient(this.config.baseURL, () => this.getAllHeaders());
   }
   /**
    * Helper method to handle fetch responses and errors
@@ -3538,41 +4052,8 @@ var _Client = class extends AbstractClient {
         if (!response.body) {
           throw new Error("Response body is null");
         }
-        const reader = response.body.getReader();
-        const decoder = new TextDecoder();
-        let buffer = "";
-        while (true) {
-          const { done, value } = await reader.read();
-          if (done)
-            break;
-          const chunk = decoder.decode(value, { stream: true });
-          buffer += chunk;
-          const lines = buffer.split("\n");
-          buffer = lines.pop() || "";
-          for (const line of lines) {
-            if (line.trim().startsWith("data: ")) {
-              try {
-                const eventData = JSON.parse(line.trim().slice(6));
-                onEvent(eventData);
-              } catch (error) {
-                console.error("Error parsing SSE data:", line, error);
-                if (onError) {
-                  onError(
-                    error instanceof Error ? error : new Error(String(error))
-                  );
-                }
-              }
-            }
-          }
-        }
-        if (buffer && buffer.trim().startsWith("data: ")) {
-          try {
-            const eventData = JSON.parse(buffer.trim().slice(6));
-            onEvent(eventData);
-          } catch (error) {
-            console.error("Error parsing SSE data:", buffer, error);
-          }
-        }
+        for await (const frame of parseSseBody(response.body, { strictJsonObject: true }))
+          onEvent(frame.data);
         if (onComplete) {
           onComplete();
         }
@@ -3615,62 +4096,18 @@ var _Client = class extends AbstractClient {
     const res = await fetch(`${this.config.baseURL}${path}`, { headers, signal });
     if (!res.ok || !res.body)
       throw new Error("Stream connection failed");
-    const reader = res.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-    let event = "";
-    let dataLines = [];
-    const processLine = (rawLine) => {
-      const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
-      if (line === "") {
-        if (dataLines.length === 0) {
-          event = "";
-          return null;
-        }
-        const data = dataLines.join("\n");
-        const eventName = event;
-        event = "";
-        dataLines = [];
-        try {
-          return { event: eventName, data: JSON.parse(data) };
-        } catch {
-          return null;
-        }
-      }
-      if (line.startsWith(":"))
-        return null;
-      const separator = line.indexOf(":");
-      const field = separator === -1 ? line : line.slice(0, separator);
-      let value = separator === -1 ? "" : line.slice(separator + 1);
-      if (value.startsWith(" "))
-        value = value.slice(1);
-      if (field === "event")
-        event = value;
-      else if (field === "data")
-        dataLines.push(value);
-      return null;
-    };
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) {
-        buffer += decoder.decode();
-        break;
+    try {
+      for await (const frame of parseSseBody(res.body, { strictJsonObject: true })) {
+        yield { event: frame.event, data: frame.data };
       }
-      buffer += decoder.decode(value, { stream: true });
-      let newline = buffer.indexOf("\n");
-      while (newline !== -1) {
-        const parsed = processLine(buffer.slice(0, newline));
-        buffer = buffer.slice(newline + 1);
-        if (parsed)
-          yield parsed;
-        newline = buffer.indexOf("\n");
+    } catch (error) {
+      if (error instanceof SseParseError) {
+        const parseError = new Error(error.message);
+        parseError.name = "StreamParseError";
+        throw parseError;
       }
+      throw error;
     }
-    if (buffer.length > 0)
-      processLine(buffer);
-    const finalEvent = processLine("");
-    if (finalEvent)
-      yield finalEvent;
   }
   /**
    * Get all headers including workspace context
@@ -3712,41 +4149,8 @@ var _Client = class extends AbstractClient {
         if (!response.body) {
           throw new Error("Response body is null");
         }
-        const reader = response.body.getReader();
-        const decoder = new TextDecoder();
-        let buffer = "";
-        while (true) {
-          const { done, value } = await reader.read();
-          if (done)
-            break;
-          const chunk = decoder.decode(value, { stream: true });
-          buffer += chunk;
-          const lines = buffer.split("\n");
-          buffer = lines.pop() || "";
-          for (const line of lines) {
-            if (line.trim().startsWith("data: ")) {
-              try {
-                const eventData = JSON.parse(line.trim().slice(6));
-                onEvent(eventData);
-              } catch (error) {
-                console.error("Error parsing SSE data:", line, error);
-                if (onError) {
-                  onError(
-                    error instanceof Error ? error : new Error(String(error))
-                  );
-                }
-              }
-            }
-          }
-        }
-        if (buffer && buffer.trim().startsWith("data: ")) {
-          try {
-            const eventData = JSON.parse(buffer.trim().slice(6));
-            onEvent(eventData);
-          } catch (error) {
-            console.error("Error parsing SSE data:", buffer, error);
-          }
-        }
+        for await (const frame of parseSseBody(response.body, { strictJsonObject: true }))
+          onEvent(frame.data);
         if (onComplete) {
           if (options.enableReturnStateWhenSteamCompleted) {
             try {
@@ -3796,6 +4200,32 @@ var WeChatClient = class extends AbstractClient {
   setTenantId(tenantId) {
     this.tenantId = tenantId;
   }
+  /**
+   * Set workspace and project headers for requests made by this client.
+   * @param workspaceId - Workspace identifier, or undefined to leave it unchanged
+   * @param projectId - Project identifier, or undefined to leave it unchanged
+   */
+  setWorkspaceContext(workspaceId, projectId) {
+    if (workspaceId !== void 0) {
+      if (workspaceId)
+        this.workspaceHeaders["x-workspace-id"] = workspaceId;
+      else
+        delete this.workspaceHeaders["x-workspace-id"];
+    }
+    if (projectId !== void 0) {
+      if (projectId)
+        this.workspaceHeaders["x-project-id"] = projectId;
+      else
+        delete this.workspaceHeaders["x-project-id"];
+    }
+  }
+  /**
+   * Get the workspace and project headers currently applied to this client.
+   * @returns A copy of the current workspace and project header values
+   */
+  getWorkspaceHeaders() {
+    return { ...this.workspaceHeaders };
+  }
   /**
    * Creates a new instance of the client with the given configuration
    * @param config - Configuration options for the client
@@ -3826,7 +4256,8 @@ var WeChatClient = class extends AbstractClient {
     return this.wechatRequest({
       url: fullUrl,
       method,
-      data: options?.body
+      data: options?.body,
+      headers: this.getWorkspaceHeaders()
     });
   }
   /**
@@ -3906,11 +4337,12 @@ var WeChatClient = class extends AbstractClient {
    * @private
    */
   async wechatRequest(options) {
-    const { url, method, data } = options;
+    const { url, method, data, headers: requestHeaders } = options;
     const headers = {
       "Content-Type": "application/json",
       Authorization: `Bearer ${this.config.apiKey}`,
-      ...this.config.headers
+      ...this.config.headers,
+      ...requestHeaders
     };
     if (this.tenantId) {
       headers["x-tenant-id"] = this.tenantId;
@@ -4489,6 +4921,8 @@ export {
   Client,
   ExportImportClient,
   NetworkError,
+  ProjectRoomClientError,
+  ProjectRoomsClient,
   ResourcesClient,
   ScheduleExecutionType,
   ScheduledTaskStatus,