@ai2aim.ai/hivemind-sdk 1.0.15 → 2.0.1

package/dist/client.js

@@ -37,23 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HivemindClient = exports.HivemindError = void 0;
-// Re-export all types for consumers
 __exportStar(require("./types"), exports);
-/**
- * Error thrown when an API request fails.
- * Contains the HTTP status code and the raw response body for inspection.
- *
- * @example
- * ```typescript
- * try {
- *   await client.query("my-org", { query: "hello" });
- * } catch (err) {
- *   if (err instanceof HivemindError) {
- *     console.error(`HTTP ${err.statusCode}:`, err.detail);
- *   }
- * }
- * ```
- */
 class HivemindError extends Error {
     statusCode;
     detail;
@@ -87,9 +71,6 @@ class HivemindClient {
         this.baseUrl = this.config.baseUrl;
         this.prefix = this.config.apiPrefix ?? "/v1";
     }
-    // -----------------------------------------------------------------------
-    // Generic HTTP helpers
-    // -----------------------------------------------------------------------
     async request(method, path, opts = {}) {
         const url = new URL(`${this.prefix}${path}`, this.baseUrl);
         return this.performRequest(url, method, opts);
@@ -100,15 +81,16 @@ class HivemindClient {
     }
     async performRequest(url, method, opts = {}) {
         if (opts.query) {
-            for (const [k, v] of Object.entries(opts.query)) {
-                if (v !== undefined && v !== null)
-                    url.searchParams.set(k, v);
+            for (const [key, value] of Object.entries(opts.query)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
             }
         }
         const headers = { ...opts.headers };
         const apiKey = opts.apiKey ?? this.config.apiKey;
         if (apiKey) {
-            headers["Authorization"] = `Bearer ${apiKey}`;
+            headers.Authorization = `Bearer ${apiKey}`;
         }
         if (this.config.adminKey) {
             headers["X-Admin-Key"] = this.config.adminKey;
@@ -116,42 +98,38 @@ class HivemindClient {
         if (this.config.webhookSecret) {
             headers["X-Webhook-Secret"] = this.config.webhookSecret;
         }
-        if (this.config.employeeId) {
-            headers["X-Employee-Id"] = this.config.employeeId;
-        }
-        let bodyPayload;
+        let body;
         if (opts.formData) {
-            bodyPayload = opts.formData;
+            body = opts.formData;
         }
         else if (opts.body !== undefined) {
             headers["Content-Type"] = "application/json";
-            bodyPayload = JSON.stringify(opts.body);
+            body = JSON.stringify(opts.body);
         }
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs ?? 30_000);
         try {
-            const fetchOpts = {
+            const res = await fetch(url.toString(), {
                 method,
                 headers,
-                body: bodyPayload,
+                body: body,
                 signal: controller.signal,
-            };
-            const res = await fetch(url.toString(), fetchOpts);
-            if (res.status === 204)
+            });
+            if (res.status === 204) {
                 return undefined;
+            }
             const text = await res.text();
-            let json;
+            let parsed;
             try {
-                json = JSON.parse(text);
+                parsed = JSON.parse(text);
             }
             catch {
-                json = text;
+                parsed = text;
             }
-            const envelope = this.asEnvelope(json);
+            const envelope = this.asEnvelope(parsed);
             if (envelope) {
                 if (!envelope.success) {
-                    const message = envelope.message || this.extractErrorMessage(envelope.data) || undefined;
-                    throw new HivemindError(envelope.statusCode, envelope.data, message);
+                    throw new HivemindError(envelope.statusCode, envelope.data, envelope.message || this.extractErrorMessage(envelope.data) || undefined);
                 }
                 if (envelope.statusCode === 204 || envelope.data === null) {
                     return undefined;
@@ -159,48 +137,39 @@ class HivemindClient {
                 return envelope.data;
             }
             if (!res.ok) {
-                const message = this.extractErrorMessage(json) || undefined;
-                throw new HivemindError(res.status, json, message);
+                throw new HivemindError(res.status, parsed, this.extractErrorMessage(parsed) || undefined);
             }
-            return json;
+            return parsed;
         }
         finally {
             clearTimeout(timeoutId);
         }
     }
-    /**
-     * Build the same request a normal REST call would, but return the full
-     * envelope instead of unwrapping `.data`. Useful when callers need
-     * `message` or `statusCode` directly.
-     */
     async requestEnvelope(method, path, opts = {}) {
         const url = new URL(`${this.prefix}${path}`, this.baseUrl);
         if (opts.query) {
-            for (const [k, v] of Object.entries(opts.query)) {
-                if (v !== undefined && v !== null)
-                    url.searchParams.set(k, v);
+            for (const [key, value] of Object.entries(opts.query)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
             }
         }
         const headers = { ...opts.headers };
         const apiKey = opts.apiKey ?? this.config.apiKey;
         if (apiKey)
-            headers["Authorization"] = `Bearer ${apiKey}`;
+            headers.Authorization = `Bearer ${apiKey}`;
         if (this.config.adminKey)
             headers["X-Admin-Key"] = this.config.adminKey;
         if (this.config.webhookSecret)
             headers["X-Webhook-Secret"] = this.config.webhookSecret;
-        if (this.config.employeeId)
-            headers["X-Employee-Id"] = this.config.employeeId;
-        if (opts.body !== undefined) {
+        if (opts.body !== undefined)
             headers["Content-Type"] = "application/json";
-        }
         const res = await fetch(url.toString(), {
             method,
             headers,
             body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
         });
-        const json = await res.json();
-        return json;
+        return await res.json();
     }
     asEnvelope(payload) {
         if (payload &&
@@ -218,21 +187,17 @@ class HivemindClient {
         if (!detail || typeof detail !== "object")
             return null;
         const record = detail;
-        const directMessage = record.message;
-        if (typeof directMessage === "string")
-            return directMessage;
-        const nestedDetail = record.detail;
-        if (typeof nestedDetail === "string")
-            return nestedDetail;
-        if (Array.isArray(nestedDetail)) {
-            const parts = nestedDetail
+        if (typeof record.message === "string")
+            return record.message;
+        if (typeof record.detail === "string")
+            return record.detail;
+        if (Array.isArray(record.detail)) {
+            const parts = record.detail
                 .map((item) => {
                 if (typeof item === "string")
                     return item;
-                if (item && typeof item === "object") {
-                    const nestedMessage = item.msg;
-                    if (typeof nestedMessage === "string")
-                        return nestedMessage;
+                if (item && typeof item === "object" && typeof item.msg === "string") {
+                    return item.msg;
                 }
                 return null;
             })
@@ -241,814 +206,185 @@ class HivemindClient {
         }
         return null;
     }
-    isOrganizationAlreadyExistsError(err, orgId) {
-        if (!(err instanceof HivemindError))
-            return false;
-        if (err.statusCode !== 400 && err.statusCode !== 409)
-            return false;
-        const message = this.extractErrorMessage(err.detail)?.toLowerCase() ?? "";
-        const normalizedOrgId = orgId.toLowerCase();
-        return message.includes("already exists") && (message.includes("organization") || message.includes(normalizedOrgId));
-    }
     get(path, query, options) {
         return this.request("GET", path, { query, apiKey: options?.apiKey });
     }
     post(path, body, options) {
         return this.request("POST", path, { body, apiKey: options?.apiKey });
     }
-    del(path, options) {
-        return this.request("DELETE", path, { apiKey: options?.apiKey });
-    }
     put(path, body, options) {
         return this.request("PUT", path, { body, apiKey: options?.apiKey });
     }
     patch(path, body, options) {
         return this.request("PATCH", path, { body, apiKey: options?.apiKey });
     }
-    // -----------------------------------------------------------------------
-    // Health
-    // -----------------------------------------------------------------------
-    /**
-     * Fetch the unauthenticated service root metadata payload.
-     *
-     * @returns Service name plus relative health/docs entrypoints.
-     *
-     * **Endpoint:** `GET /`
-     */
+    del(path, options) {
+        return this.request("DELETE", path, { apiKey: options?.apiKey });
+    }
     root() {
         return this.requestUnprefixed("GET", "/");
     }
-    /**
-     * Check service health status. No authentication required.
-     *
-     * @returns Service name, version, status, and aggregate statistics.
-     *
-     * **Endpoint:** `GET /v1/health`
-     *
-     * @example
-     * ```typescript
-     * const health = await client.health();
-     * console.log(health.status); // "ok"
-     * console.log(health.stats); // { organizations: 12, documents: 450, total_chunks: 3200 }
-     * ```
-     */
     health() {
         return this.get("/health");
     }
-    // -----------------------------------------------------------------------
-    // Admin auth
-    // -----------------------------------------------------------------------
-    /**
-     * Exchange the bootstrap admin key for a signed session token.
-     * The token can be used as `Authorization: Bearer <token>` for admin endpoints
-     * instead of sending the raw admin key on every request.
-     *
-     * @param params - Object containing the `admin_key`.
-     * @returns Signed session token with type and expiry.
-     * @throws {@link HivemindError} 400 if admin key is not configured on the server.
-     * @throws {@link HivemindError} 401 if the admin key is invalid.
-     *
-     * **Endpoint:** `POST /v1/admin/login`
-     *
-     * @example
-     * ```typescript
-     * const { access_token, expires_in_seconds } = await client.adminLogin({
-     *   admin_key: "your-bootstrap-admin-key",
-     * });
-     * // Use access_token as Bearer token for subsequent admin requests
-     * ```
-     */
     adminLogin(params) {
         return this.post("/admin/login", params);
     }
-    async createOrganization(params, options) {
-        const allowExisting = options?.allowExisting !== false;
-        try {
-            const created = await this.post("/organizations", params);
-            if (allowExisting) {
-                return { ...created, created: true };
-            }
-            return created;
-        }
-        catch (err) {
-            if (!allowExisting || !this.isOrganizationAlreadyExistsError(err, params.org_id)) {
-                throw err;
-            }
-            const organization = await this.getAdminOrganization(params.org_id);
-            return {
-                created: false,
-                organization,
-                api_key: null,
-            };
-        }
+    issueApiKey(params = {}) {
+        return this.post("/api-keys", params);
+    }
+    getCurrentScope(options) {
+        return this.get("/api-key", undefined, options);
     }
-    /**
-     * Ensure an organization exists without throwing when it has already been provisioned.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param params - Organization creation parameters.
-     * @returns A discriminated result describing whether the org was created or already existed.
-     */
-    ensureOrganization(params) {
-        return this.createOrganization(params, { allowExisting: true });
-    }
-    /**
-     * Retrieve organization details including tier, status, and settings.
-     *
-     * **Auth:** Requires org-scoped API key (via config or `options.apiKey`).
-     *
-     * @param orgId - Organization identifier.
-     * @param options - Optional per-request overrides (e.g. `{ apiKey }`).
-     * @returns Full organization entity.
-     * @throws {@link HivemindError} 401 if API key is missing or invalid.
-     * @throws {@link HivemindError} 403 if the API key belongs to a different org.
-     * @throws {@link HivemindError} 404 if the organization does not exist.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}`
-     */
-    getOrganization(orgId, options) {
-        return this.get(`/organizations/${orgId}`, undefined, options);
-    }
-    /**
-     * Rotate the API key for an organization. The previous key remains valid
-     * for a 24-hour grace period.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param orgId - Organization identifier.
-     * @param options - Optional per-request overrides.
-     * @returns New API key and grace period expiry for the previous key.
-     * @throws {@link HivemindError} 401 if admin credentials are invalid.
-     * @throws {@link HivemindError} 404 if the organization does not exist.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/api-keys/rotate`
-     */
-    rotateApiKey(orgId, options) {
-        return this.post(`/organizations/${orgId}/api-keys/rotate`, undefined, options);
-    }
-    /**
-     * Suspend an organization, blocking all API key access until reactivated.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param orgId - Organization identifier.
-     * @param options - Optional per-request overrides.
-     * @returns Updated organization status.
-     * @throws {@link HivemindError} 401 if admin credentials are invalid.
-     * @throws {@link HivemindError} 404 if the organization does not exist.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/suspend`
-     */
-    suspendOrganization(orgId, options) {
-        return this.post(`/organizations/${orgId}/suspend`, undefined, options);
-    }
-    /**
-     * Reactivate a suspended organization, restoring API key access.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param orgId - Organization identifier.
-     * @param options - Optional per-request overrides.
-     * @returns Updated organization status.
-     * @throws {@link HivemindError} 401 if admin credentials are invalid.
-     * @throws {@link HivemindError} 404 if the organization does not exist.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/reactivate`
-     */
-    reactivateOrganization(orgId, options) {
-        return this.post(`/organizations/${orgId}/reactivate`, undefined, options);
-    }
-    /**
-     * Permanently delete an organization and all associated data.
-     * This action is irreversible.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param orgId - Organization identifier.
-     * @param options - Optional per-request overrides.
-     * @throws {@link HivemindError} 401 if admin credentials are invalid.
-     * @throws {@link HivemindError} 404 if the organization does not exist.
-     *
-     * **Endpoint:** `DELETE /v1/organizations/{orgId}`
-     */
-    deleteOrganization(orgId, options) {
-        return this.del(`/organizations/${orgId}`, options);
-    }
-    // -----------------------------------------------------------------------
-    // Documents
-    // -----------------------------------------------------------------------
-    /**
-     * Upload and ingest a document file (PDF, TXT, DOCX, etc.).
-     * The document is stored in GCS, split into chunks, and embedded for RAG retrieval.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param file - Document content as a `Blob` or `Buffer`.
-     * @param filename - Original filename (e.g. `"report.pdf"`).
-     * @param options - Optional per-request overrides (e.g. `{ apiKey }`).
-     * @returns Upload result with document ID, chunk count, and status.
-     * @throws {@link HivemindError} 400 if the file exceeds the maximum upload size (default 25 MB).
-     * @throws {@link HivemindError} 401 if API key is missing or invalid.
-     * @throws {@link HivemindError} 429 if rate limit is exceeded.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/documents/upload`
-     * **Content-Type:** `multipart/form-data`
-     *
-     * @example
-     * ```typescript
-     * import { readFileSync } from "fs";
-     * const file = readFileSync("./report.pdf");
-     * const result = await client.uploadDocument("acme-corp", file, "report.pdf");
-     * console.log(`Uploaded: ${result.document_id}, ${result.chunks} chunks`);
-     * ```
-     */
-    async uploadDocument(orgId, file, filename, options) {
+    rotateApiKey(options) {
+        return this.post("/api-key/rotate", undefined, options);
+    }
+    async uploadDocument(file, filename, options) {
         const form = new FormData();
         const blob = file instanceof Blob ? file : new Blob([file], { type: "application/octet-stream" });
         form.append("file", blob, filename);
-        return this.request("POST", `/organizations/${orgId}/documents/upload`, { formData: form, apiKey: options?.apiKey });
-    }
-    // -----------------------------------------------------------------------
-    // Query (RAG)
-    // -----------------------------------------------------------------------
-    /**
-     * Query the organization's document knowledge base using RAG
-     * (Retrieval-Augmented Generation). Retrieves relevant document chunks,
-     * then generates a response with citations.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Query parameters (query text, model, temperature, strategy).
-     * @param options - Optional per-request overrides (e.g. `{ apiKey }`).
-     * @returns Generated answer with source citations, confidence, and processing time.
-     * @throws {@link HivemindError} 401 if API key is missing or invalid.
-     * @throws {@link HivemindError} 403 if cross-organization access is attempted.
-     * @throws {@link HivemindError} 429 if rate limit or token quota is exceeded.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/query`
-     *
-     * @example
-     * ```typescript
-     * const result = await client.query("acme-corp", {
-     *   query: "What are the key findings in Q4?",
-     *   temperature: 0.2,
-     *   retrieval_strategy: "hybrid",
-     * });
-     * console.log(result.answer);
-     * console.log(result.sources); // citations with doc_id, chunk_id, score, snippet
-     * ```
-     */
-    query(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/query`, params, options);
-    }
-    /**
-     * Search indexed sources for source discovery.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/search`
-     */
-    search(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/search`, params, options);
-    }
-    // -----------------------------------------------------------------------
-    // Content Creator
-    // -----------------------------------------------------------------------
-    createProject(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/projects`, params, options);
-    }
-    listProjects(orgId, options) {
-        return this.get(`/organizations/${orgId}/projects`, undefined, options);
-    }
-    getProject(orgId, projectId, options) {
-        return this.get(`/organizations/${orgId}/projects/${projectId}`, undefined, options);
-    }
-    updateProject(orgId, projectId, params, options) {
-        return this.patch(`/organizations/${orgId}/projects/${projectId}`, params, options);
-    }
-    deleteProject(orgId, projectId, options) {
-        return this.del(`/organizations/${orgId}/projects/${projectId}`, options);
-    }
-    chatProject(orgId, projectId, params, options) {
-        return this.post(`/organizations/${orgId}/projects/${projectId}/chat`, params, options);
-    }
-    getProjectChatHistory(orgId, projectId, userId, options) {
-        return this.get(`/organizations/${orgId}/projects/${projectId}/chat`, { user_id: userId }, options);
-    }
-    createContentItem(orgId, projectId, params, options) {
-        return this.post(`/organizations/${orgId}/projects/${projectId}/content`, params, options);
-    }
-    listContentItems(orgId, projectId, options) {
-        return this.get(`/organizations/${orgId}/projects/${projectId}/content`, undefined, options);
-    }
-    getContentItem(orgId, projectId, contentId, options) {
-        return this.get(`/organizations/${orgId}/projects/${projectId}/content/${contentId}`, undefined, options);
-    }
-    updateContentItem(orgId, projectId, contentId, params, options) {
-        return this.patch(`/organizations/${orgId}/projects/${projectId}/content/${contentId}`, params, options);
-    }
-    deleteContentItem(orgId, projectId, contentId, options) {
-        return this.del(`/organizations/${orgId}/projects/${projectId}/content/${contentId}`, options);
-    }
-    createProjectSource(orgId, projectId, params, options) {
-        return this.post(`/organizations/${orgId}/projects/${projectId}/sources`, params, options);
-    }
-    /**
-     * Scrape external URLs and save the normalized results as project sources.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/projects/{projectId}/sources/scrape`
-     */
-    scrapeProjectSources(orgId, projectId, params, options) {
-        return this.post(`/organizations/${orgId}/projects/${projectId}/sources/scrape`, params, options);
-    }
-    listProjectSources(orgId, projectId, options) {
-        return this.get(`/organizations/${orgId}/projects/${projectId}/sources`, undefined, options);
-    }
-    getProjectSource(orgId, projectId, sourceId, options) {
-        return this.get(`/organizations/${orgId}/projects/${projectId}/sources/${sourceId}`, undefined, options);
-    }
-    updateProjectSource(orgId, projectId, sourceId, params, options) {
-        return this.patch(`/organizations/${orgId}/projects/${projectId}/sources/${sourceId}`, params, options);
-    }
-    deleteProjectSource(orgId, projectId, sourceId, options) {
-        return this.del(`/organizations/${orgId}/projects/${projectId}/sources/${sourceId}`, options);
-    }
-    /**
-     * Create a publish schedule for an existing content item.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/projects/{projectId}/schedules`
-     */
-    createPublishSchedule(orgId, projectId, params, options) {
-        return this.post(`/organizations/${orgId}/projects/${projectId}/schedules`, params, options);
-    }
-    /**
-     * List publish schedules for a project.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/projects/{projectId}/schedules`
-     */
-    listPublishSchedules(orgId, projectId, options) {
-        return this.get(`/organizations/${orgId}/projects/${projectId}/schedules`, undefined, options);
-    }
-    /**
-     * Get a single publish schedule.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/projects/{projectId}/schedules/{scheduleId}`
-     */
-    getPublishSchedule(orgId, projectId, scheduleId, options) {
-        return this.get(`/organizations/${orgId}/projects/${projectId}/schedules/${scheduleId}`, undefined, options);
-    }
-    /**
-     * Update a publish schedule.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `PATCH /v1/organizations/{orgId}/projects/{projectId}/schedules/{scheduleId}`
-     */
-    updatePublishSchedule(orgId, projectId, scheduleId, params, options) {
-        return this.patch(`/organizations/${orgId}/projects/${projectId}/schedules/${scheduleId}`, params, options);
-    }
-    /**
-     * Delete a publish schedule.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `DELETE /v1/organizations/{orgId}/projects/{projectId}/schedules/{scheduleId}`
-     */
-    deletePublishSchedule(orgId, projectId, scheduleId, options) {
-        return this.del(`/organizations/${orgId}/projects/${projectId}/schedules/${scheduleId}`, options);
-    }
-    /**
-     * Manually run due Content Creator schedules immediately.
-     *
-     * This is primarily an admin fallback or operational tool. In normal
-     * deployments, due schedules are processed automatically by the backend's
-     * background content schedule runner.
-     *
-     * **Auth:** Requires admin key.
-     *
-     * **Endpoint:** `POST /v1/admin/content-creator/schedules/run-due`
-     */
+        return this.request("POST", "/documents/upload", {
+            formData: form,
+            apiKey: options?.apiKey,
+        });
+    }
+    query(params, options) {
+        return this.post("/query", params, options);
+    }
+    search(params, options) {
+        return this.post("/search", params, options);
+    }
+    createProject(params, options) {
+        return this.post("/projects", params, options);
+    }
+    listProjects(options) {
+        return this.get("/projects", undefined, options);
+    }
+    getProject(projectId, options) {
+        return this.get(`/projects/${projectId}`, undefined, options);
+    }
+    updateProject(projectId, params, options) {
+        return this.patch(`/projects/${projectId}`, params, options);
+    }
+    deleteProject(projectId, options) {
+        return this.del(`/projects/${projectId}`, options);
+    }
+    chatProject(projectId, params, options) {
+        return this.post(`/projects/${projectId}/chat`, params, options);
+    }
+    getProjectChatHistory(projectId, userId, options) {
+        return this.get(`/projects/${projectId}/chat`, { user_id: userId }, options);
+    }
+    createContentItem(projectId, params, options) {
+        return this.post(`/projects/${projectId}/content`, params, options);
+    }
+    listContentItems(projectId, options) {
+        return this.get(`/projects/${projectId}/content`, undefined, options);
+    }
+    getContentItem(projectId, contentId, options) {
+        return this.get(`/projects/${projectId}/content/${contentId}`, undefined, options);
+    }
+    updateContentItem(projectId, contentId, params, options) {
+        return this.patch(`/projects/${projectId}/content/${contentId}`, params, options);
+    }
+    deleteContentItem(projectId, contentId, options) {
+        return this.del(`/projects/${projectId}/content/${contentId}`, options);
+    }
+    createProjectSource(projectId, params, options) {
+        return this.post(`/projects/${projectId}/sources`, params, options);
+    }
+    scrapeProjectSources(projectId, params, options) {
+        return this.post(`/projects/${projectId}/sources/scrape`, params, options);
+    }
+    listProjectSources(projectId, options) {
+        return this.get(`/projects/${projectId}/sources`, undefined, options);
+    }
+    getProjectSource(projectId, sourceId, options) {
+        return this.get(`/projects/${projectId}/sources/${sourceId}`, undefined, options);
+    }
+    updateProjectSource(projectId, sourceId, params, options) {
+        return this.patch(`/projects/${projectId}/sources/${sourceId}`, params, options);
+    }
+    deleteProjectSource(projectId, sourceId, options) {
+        return this.del(`/projects/${projectId}/sources/${sourceId}`, options);
+    }
+    createPublishSchedule(projectId, params, options) {
+        return this.post(`/projects/${projectId}/schedules`, params, options);
+    }
+    listPublishSchedules(projectId, options) {
+        return this.get(`/projects/${projectId}/schedules`, undefined, options);
+    }
+    getPublishSchedule(projectId, scheduleId, options) {
+        return this.get(`/projects/${projectId}/schedules/${scheduleId}`, undefined, options);
+    }
+    updatePublishSchedule(projectId, scheduleId, params, options) {
+        return this.patch(`/projects/${projectId}/schedules/${scheduleId}`, params, options);
+    }
+    deletePublishSchedule(projectId, scheduleId, options) {
+        return this.del(`/projects/${projectId}/schedules/${scheduleId}`, options);
+    }
     runDueSchedules() {
         return this.post("/admin/content-creator/schedules/run-due");
     }
-    // -----------------------------------------------------------------------
-    // Generation
-    // -----------------------------------------------------------------------
-    /**
-     * Start an asynchronous video generation job using Vertex AI Veo.
-     * Returns a job ID — poll with `getJob()` or `waitForJob()` for results.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Video generation parameters (prompt, duration, aspect_ratio, style).
-     * @param options - Optional per-request overrides.
-     * @returns Job ID and estimated processing time (HTTP 202).
-     * @throws {@link HivemindError} 429 if rate limit, video quota, or concurrent job limit is exceeded.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/generate/video`
-     *
-     * @example
-     * ```typescript
-     * const job = await client.generateVideo("acme-corp", {
-     *   prompt: "A drone flyover of a mountain lake at sunset",
-     *   duration: 8,
-     *   aspect_ratio: "16:9",
-     *   style: "cinematic",
-     * });
-     * const result = await client.waitForJob("acme-corp", job.job_id);
-     * console.log(result.result); // { output_url, signed_url }
-     * ```
-     */
-    generateVideo(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/generate/video`, params, options);
-    }
-    /**
-     * Start an asynchronous image generation job using Vertex AI Imagen.
-     * Returns a job ID — poll with `getJob()` or `waitForJob()` for results.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Image generation parameters (prompt, aspect_ratio, style, num_images).
-     * @param options - Optional per-request overrides.
-     * @returns Job ID and estimated processing time (HTTP 202).
-     * @throws {@link HivemindError} 429 if rate limit, image quota, or concurrent job limit is exceeded.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/generate/image`
-     *
-     * @example
-     * ```typescript
-     * const job = await client.generateImage("acme-corp", {
-     *   prompt: "A futuristic city skyline at dusk",
-     *   aspect_ratio: "16:9",
-     *   style: "digital art",
-     *   num_images: 4,
-     * });
-     * const result = await client.waitForJob("acme-corp", job.job_id);
-     * ```
-     */
-    generateImage(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/generate/image`, params, options);
-    }
-    /**
-     * Start an asynchronous music generation job.
-     * Returns a job ID — poll with `getJob()` or `waitForJob()` for results.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/generate/music`
-     */
-    generateMusic(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/generate/music`, params, options);
-    }
-    // -----------------------------------------------------------------------
-    // Jobs
-    // -----------------------------------------------------------------------
-    /**
-     * Check the status of an asynchronous job (video or image generation).
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param jobId - Job identifier (from `generateVideo()` or `generateImage()`).
-     * @param options - Optional per-request overrides.
-     * @returns Job status, result URLs (when completed), or error details (when failed).
-     * @throws {@link HivemindError} 404 if the job does not exist.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/jobs/{jobId}`
-     */
-    getJob(orgId, jobId, options) {
-        return this.get(`/organizations/${orgId}/jobs/${jobId}`, undefined, options);
-    }
-    /**
-     * Poll a job until it reaches a terminal status (`completed`, `failed`, or `cancelled`).
-     *
-     * @param orgId - Organization identifier.
-     * @param jobId - Job identifier.
-     * @param intervalMs - Polling interval in milliseconds. @default 2000
-     * @param maxWaitMs - Maximum wait time in milliseconds. @default 300000 (5 min)
-     * @param options - Optional per-request overrides.
-     * @returns Final job status with result or error.
-     * @throws Error if the job does not complete within `maxWaitMs`.
-     *
-     * @example
-     * ```typescript
-     * const job = await client.generateVideo("acme-corp", { prompt: "..." });
-     * const result = await client.waitForJob("acme-corp", job.job_id, 3000, 600_000);
-     * if (result.status === "completed") console.log(result.result);
-     * ```
-     */
-    async waitForJob(orgId, jobId, intervalMs = 2000, maxWaitMs = 300_000, options) {
+    generateVideo(params, options) {
+        return this.post("/generate/video", params, options);
+    }
+    generateImage(params, options) {
+        return this.post("/generate/image", params, options);
+    }
+    generateMusic(params, options) {
+        return this.post("/generate/music", params, options);
+    }
+    getJob(jobId, options) {
+        return this.get(`/jobs/${jobId}`, undefined, options);
+    }
+    async waitForJob(jobId, intervalMs = 2000, maxWaitMs = 300_000, options) {
         const start = Date.now();
         while (Date.now() - start < maxWaitMs) {
-            const job = await this.getJob(orgId, jobId, options);
+            const job = await this.getJob(jobId, options);
             if (["completed", "failed", "cancelled"].includes(job.status)) {
                 return job;
             }
-            await new Promise((r) => setTimeout(r, intervalMs));
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
         }
         throw new Error(`Job ${jobId} did not complete within ${maxWaitMs}ms`);
     }
-    // -----------------------------------------------------------------------
-    // Data chat
-    // -----------------------------------------------------------------------
-    /**
-     * Ask a natural-language question over BigQuery datasets.
-     * Gemini generates SQL from the question, executes it, and returns formatted results.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Question and optional user ID.
-     * @param options - Optional per-request overrides.
-     * @returns Generated SQL, natural-language answer, and result rows.
-     * @throws {@link HivemindError} 429 if rate limit or token quota is exceeded.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/data-chat`
-     *
-     * @example
-     * ```typescript
-     * const result = await client.dataChat("acme-corp", {
-     *   question: "How many active users this month?",
-     * });
-     * console.log(result.answer); // "There are 1,247 active users this month."
-     * console.log(result.sql);    // Generated SQL
-     * console.log(result.rows);   // [{ active_users: 1247 }]
-     * ```
-     */
-    dataChat(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/data-chat`, params, options);
-    }
-    // -----------------------------------------------------------------------
-    // Agents
-    // -----------------------------------------------------------------------
-    /**
-     * Create a custom AI agent template with system instructions and optional tool bindings.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Agent name, instructions, and optional tools.
-     * @param options - Optional per-request overrides.
-     * @returns Created agent with ID, name, and enabled tools.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/agents/custom`
-     *
-     * @example
-     * ```typescript
-     * const agent = await client.createAgent("acme-corp", {
-     *   name: "Support Bot",
-     *   instructions: "You are a helpful customer support agent.",
-     *   tools: ["rag_search", "ticket_create"],
-     * });
-     * console.log(agent.agent_id);
-     * ```
-     */
-    createAgent(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/agents/custom`, params, options);
-    }
-    /**
-     * Send a query to an AI agent. Routes to the specified agent type or auto-selects.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Query text, user ID, and optional agent type.
-     * @param options - Optional per-request overrides.
-     * @returns Agent response text, agent type, and any tool calls made.
-     * @throws {@link HivemindError} 429 if rate limit or token quota is exceeded.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/agents/query`
-     */
-    queryAgent(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/agents/query`, params, options);
-    }
-    // -----------------------------------------------------------------------
-    // Audio
-    // -----------------------------------------------------------------------
-    /**
-     * Transcribe audio content to text (speech-to-text).
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Audio content and optional BCP-47 language code.
-     * @param options - Optional per-request overrides.
-     * @returns Transcription result with transcript text, confidence, and language.
-     * @throws {@link HivemindError} 429 if rate limit is exceeded.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/audio/transcribe`
-     */
-    transcribeAudio(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/audio/transcribe`, params, options);
-    }
-    /**
-     * Convert text to speech (text-to-speech synthesis).
-     * Returns a signed URL to the generated audio file.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Text to synthesize and optional voice name.
-     * @param options - Optional per-request overrides.
-     * @returns Audio URL, duration, and voice used.
-     * @throws {@link HivemindError} 429 if rate limit is exceeded.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/audio/synthesize`
-     */
-    synthesizeAudio(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/audio/synthesize`, params, options);
-    }
-    // -----------------------------------------------------------------------
-    // Analytics / ML
-    // -----------------------------------------------------------------------
-    /**
-     * Train a predictive model on tabular data.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Target column, feature columns, and training data rows.
-     * @param options - Optional per-request overrides.
-     * @returns Deployed model ID and status.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/analytics/train`
-     *
-     * @example
-     * ```typescript
-     * const model = await client.trainModel("acme-corp", {
-     *   target_column: "churn",
-     *   feature_columns: ["tenure", "monthly_charges", "total_charges"],
-     *   rows: [
-     *     { tenure: 12, monthly_charges: 50, total_charges: 600, churn: 0 },
-     *     { tenure: 2, monthly_charges: 80, total_charges: 160, churn: 1 },
-     *   ],
-     * });
-     * console.log(model.model_id); // Use with predict()
-     * ```
-     */
-    trainModel(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/analytics/train`, params, options);
-    }
-    /**
-     * Run predictions using a previously trained model.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Model ID and data instances to predict on.
-     * @param options - Optional per-request overrides.
-     * @returns Predictions for each input instance.
-     * @throws {@link HivemindError} 404 if the model does not exist.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/analytics/predict`
-     */
-    predict(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/analytics/predict`, params, options);
-    }
-    /**
-     * Generate a time-series forecast from historical data using ARIMA-based modeling.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Historical series values and optional forecast horizon (1–365).
-     * @param options - Optional per-request overrides.
-     * @returns Predicted future values.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/analytics/forecast`
-     */
-    forecast(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/analytics/forecast`, params, options);
-    }
-    // -----------------------------------------------------------------------
-    // Billing
-    // -----------------------------------------------------------------------
-    /**
-     * Get the monthly usage summary for an organization.
-     * Includes token, image, video, storage, and compute usage against tier limits.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param month - Month in `YYYY-MM` format. Defaults to current month.
-     * @param options - Optional per-request overrides.
-     * @returns Usage counters, tier limits, and quota status.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/usage?month={month}`
-     */
-    getUsage(orgId, month, options) {
-        const query = month ? { month } : undefined;
-        return this.get(`/organizations/${orgId}/usage`, query, options);
-    }
-    /**
-     * Get the monthly invoice with detailed cost breakdown by resource type.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param month - Month in `YYYY-MM` format. Defaults to current month.
-     * @param options - Optional per-request overrides.
-     * @returns Invoice with itemized costs and total in USD.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/invoice?month={month}`
-     */
-    getInvoice(orgId, month, options) {
-        const query = month ? { month } : undefined;
-        return this.get(`/organizations/${orgId}/invoice`, query, options);
-    }
-    // -----------------------------------------------------------------------
-    // Audit
-    // -----------------------------------------------------------------------
-    /**
-     * Retrieve audit log records for an organization.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param options - Optional per-request overrides.
-     * @returns Audit log entries with timestamps, actions, and metadata.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/audit`
-     */
-    getAuditLogs(orgId, options) {
-        return this.get(`/organizations/${orgId}/audit`, undefined, options);
-    }
-    // -----------------------------------------------------------------------
-    // Scraping
-    // -----------------------------------------------------------------------
-    /**
-     * Get the current scraping runtime configuration.
-     *
-     * **Auth:** None required.
-     *
-     * @returns Execution mode, Cloud Run status, and cache statistics.
-     *
-     * **Endpoint:** `GET /v1/scraping/config`
-     */
+    dataChat(params, options) {
+        return this.post("/data-chat", params, options);
+    }
+    createAgent(params, options) {
+        return this.post("/agents/custom", params, options);
+    }
+    queryAgent(params, options) {
+        return this.post("/agents/query", params, options);
+    }
+    transcribeAudio(params, options) {
+        return this.post("/audio/transcribe", params, options);
+    }
+    synthesizeAudio(params, options) {
+        return this.post("/audio/synthesize", params, options);
+    }
+    trainModel(params, options) {
+        return this.post("/analytics/train", params, options);
+    }
+    predict(params, options) {
+        return this.post("/analytics/predict", params, options);
+    }
+    forecast(params, options) {
+        return this.post("/analytics/forecast", params, options);
+    }
+    getAuditLogs(options) {
+        return this.get("/audit", undefined, options);
+    }
     getScrapingConfig() {
         return this.get("/scraping/config");
     }
-    /**
-     * Submit URLs for scraping. JS-heavy sites (Reddit, Twitter, LinkedIn)
-     * are auto-routed to Selenium.
-     *
-     * **Auth:** None required.
-     *
-     * @param params - Object containing the `urls` array.
-     * @returns Task ID and submission status.
-     *
-     * **Endpoint:** `POST /v1/scraping/scrape`
-     */
     scrape(params) {
         return this.post("/scraping/scrape", params);
     }
-    /**
-     * Check the status and results of a scrape task.
-     *
-     * **Auth:** None required.
-     *
-     * @param taskId - Task identifier (from `scrape()`).
-     * @returns Task status and scraped results (empty while pending).
-     *
-     * **Endpoint:** `GET /v1/scraping/status/{taskId}`
-     */
     getScrapeStatus(taskId) {
         return this.get(`/scraping/status/${taskId}`);
     }
-    /**
-     * Submit a scrape job and poll until results are ready.
-     *
-     * @param urls - URLs to scrape.
-     * @param intervalMs - Polling interval in milliseconds. @default 2000
-     * @param maxWaitMs - Maximum wait time in milliseconds. @default 120000 (2 min)
-     * @returns Final scrape status with results.
-     * @throws Error if the task does not complete within `maxWaitMs`.
-     *
-     * @example
-     * ```typescript
-     * const result = await client.scrapeAndWait(
-     *   ["https://example.com", "https://example.org"],
-     *   2000,
-     *   60_000,
-     * );
-     * for (const item of result.result) {
-     *   console.log(item.title, item.full_text?.substring(0, 200));
-     * }
-     * ```
-     */
     async scrapeAndWait(urls, intervalMs = 2000, maxWaitMs = 120_000) {
         const { task_id } = await this.scrape({ urls });
         const start = Date.now();
@@ -1057,679 +393,158 @@ class HivemindClient {
             if (["SUCCESS", "FAILURE", "completed"].includes(status.status)) {
                 return status;
             }
-            await new Promise((r) => setTimeout(r, intervalMs));
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
         }
         throw new Error(`Scrape ${task_id} did not complete within ${maxWaitMs}ms`);
     }
-    // -----------------------------------------------------------------------
-    // Webhooks
-    // -----------------------------------------------------------------------
-    /**
-     * Send a video generation completion webhook notification.
-     *
-     * **Auth:** Requires `webhookSecret` in client config (sends `X-Webhook-Secret` header).
-     *
-     * @param payload - Webhook payload with job_id, org_id, status, and optional metadata.
-     * @returns `{ received: true }` on success.
-     * @throws {@link HivemindError} 401 if the webhook secret is invalid.
-     *
-     * **Endpoint:** `POST /v1/webhook/video-complete`
-     */
     sendVideoCompleteWebhook(payload) {
         return this.post("/webhook/video-complete", payload);
     }
-    /**
-     * Send a document processing completion webhook notification.
-     *
-     * **Auth:** Requires `webhookSecret` in client config (sends `X-Webhook-Secret` header).
-     *
-     * @param payload - Webhook payload with document_id, org_id, status, and optional metadata.
-     * @returns `{ received: true }` on success.
-     * @throws {@link HivemindError} 401 if the webhook secret is invalid.
-     *
-     * **Endpoint:** `POST /v1/webhook/document-processed`
-     */
     sendDocumentProcessedWebhook(payload) {
         return this.post("/webhook/document-processed", payload);
     }
-    // -----------------------------------------------------------------------
-    // Admin — Configuration
-    // -----------------------------------------------------------------------
-    /**
-     * Get full service configuration overview.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/config`
-     */
     getAdminConfig() {
         return this.get("/admin/config");
     }
-    /**
-     * Get runtime setting overrides.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/config/overrides`
-     */
     getAdminConfigOverrides() {
         return this.get("/admin/config/overrides");
     }
-    /**
-     * Update a mutable runtime setting (e.g. log_level, debug, cors_allow_origins).
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param params - Setting key and new value.
-     *
-     * **Endpoint:** `PUT /v1/admin/settings`
-     */
     updateAdminSetting(params) {
         return this.put("/admin/settings", params);
     }
-    // -----------------------------------------------------------------------
-    // Admin — Logging
-    // -----------------------------------------------------------------------
-    /**
-     * Get the current application log level.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/logging/level`
-     */
     getLogLevel() {
         return this.get("/admin/logging/level");
     }
-    /**
-     * Change the application log level.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param params - The new log level (DEBUG, INFO, WARNING, ERROR, CRITICAL).
-     *
-     * **Endpoint:** `PUT /v1/admin/logging/level`
-     */
     setLogLevel(params) {
         return this.put("/admin/logging/level", params);
     }
-    /**
-     * List all loggers with their levels and handlers.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/logging/loggers`
-     */
     getLoggers() {
         return this.get("/admin/logging/loggers");
     }
-    // -----------------------------------------------------------------------
-    // Admin — Traffic & Monitoring
-    // -----------------------------------------------------------------------
-    /**
-     * Get inbound traffic statistics.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/traffic/inbound`
-     */
     getInboundTraffic() {
         return this.get("/admin/traffic/inbound");
     }
-    /**
-     * Reset inbound traffic counters.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `POST /v1/admin/traffic/inbound/reset`
-     */
     resetInboundTraffic() {
         return this.post("/admin/traffic/inbound/reset");
     }
-    /**
-     * Check health of outbound dependencies (GCP, Vertex, BigQuery, Redis).
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/traffic/outbound`
-     */
     getOutboundStatus() {
         return this.get("/admin/traffic/outbound");
     }
-    // -----------------------------------------------------------------------
-    // Admin — CORS
-    // -----------------------------------------------------------------------
-    /**
-     * Get the current CORS allowed origins.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/cors`
-     */
     getCors() {
         return this.get("/admin/cors");
     }
-    /**
-     * Update the CORS allowed origins.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param allowOrigins - Comma-separated origins or `"*"`.
-     *
-     * **Endpoint:** `PUT /v1/admin/cors`
-     */
     setCors(allowOrigins) {
         return this.put("/admin/cors", { allow_origins: allowOrigins });
     }
-    // -----------------------------------------------------------------------
-    // Admin — Rate Limiting
-    // -----------------------------------------------------------------------
-    /**
-     * List all rate-limit entries.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/rate-limits`
-     */
     getRateLimits() {
         return this.get("/admin/rate-limits");
     }
-    /**
-     * Reset the rate-limit counter for an organization.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param orgId - Organization identifier.
-     *
-     * **Endpoint:** `POST /v1/admin/rate-limits/reset/{orgId}`
-     */
-    resetRateLimit(orgId) {
-        return this.post(`/admin/rate-limits/reset/${orgId}`);
-    }
-    // -----------------------------------------------------------------------
-    // Admin — Organization & Job listing
-    // -----------------------------------------------------------------------
-    /**
-     * List all organizations (admin view).
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param limit - Maximum number of organizations to return (1–1000, default 100).
-     *
-     * **Endpoint:** `GET /v1/admin/organizations`
-     */
-    listOrganizations(limit) {
-        const query = limit !== undefined ? { limit: String(limit) } : undefined;
-        return this.get("/admin/organizations", query);
-    }
-    /**
-     * Get a single organization (admin view).
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param orgId - Organization identifier.
-     *
-     * **Endpoint:** `GET /v1/admin/organizations/{orgId}`
-     */
-    getAdminOrganization(orgId) {
-        return this.get(`/admin/organizations/${orgId}`);
-    }
-    /**
-     * List recent jobs across all organizations (admin view).
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param limit - Maximum number of jobs to return (1–500, default 50).
-     *
-     * **Endpoint:** `GET /v1/admin/jobs`
-     */
+    resetRateLimit(scopeId) {
+        return this.post(`/admin/rate-limits/reset/${scopeId}`);
+    }
     listJobs(limit) {
-        const query = limit !== undefined ? { limit: String(limit) } : undefined;
+        const query = limit !== undefined ? { limit } : undefined;
         return this.get("/admin/jobs", query);
     }
-    // -----------------------------------------------------------------------
-    // Admin — Feature Flags
-    // -----------------------------------------------------------------------
-    /**
-     * Get all feature flags.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/feature-flags`
-     */
     getFeatureFlags() {
         return this.get("/admin/feature-flags");
     }
-    /**
-     * Get a single feature flag by key.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param key - Feature flag key.
-     *
-     * **Endpoint:** `GET /v1/admin/feature-flags/{key}`
-     */
     getFeatureFlag(key) {
         return this.get(`/admin/feature-flags/${key}`);
     }
-    /**
-     * Create or update a feature flag.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param params - Flag key and enabled status.
-     *
-     * **Endpoint:** `PUT /v1/admin/feature-flags`
-     */
     setFeatureFlag(params) {
         return this.put("/admin/feature-flags", params);
     }
-    /**
-     * Delete a feature flag.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param key - Feature flag key to delete.
-     *
-     * **Endpoint:** `DELETE /v1/admin/feature-flags/{key}`
-     */
     deleteFeatureFlag(key) {
         return this.del(`/admin/feature-flags/${key}`);
     }
-    // -----------------------------------------------------------------------
-    // Admin — Maintenance Mode
-    // -----------------------------------------------------------------------
-    /**
-     * Get current maintenance mode state.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/maintenance`
-     */
     getMaintenanceMode() {
         return this.get("/admin/maintenance");
     }
-    /**
-     * Enable or disable maintenance mode.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param params - Enabled flag and optional message.
-     *
-     * **Endpoint:** `PUT /v1/admin/maintenance`
-     */
     setMaintenanceMode(params) {
         return this.put("/admin/maintenance", params);
     }
-    // -----------------------------------------------------------------------
-    // Admin — Cache
-    // -----------------------------------------------------------------------
-    /**
-     * Get cache statistics.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/cache`
-     */
     getCacheStats() {
         return this.get("/admin/cache");
     }
-    /**
-     * Flush all caches.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `POST /v1/admin/cache/flush`
-     */
     flushCache() {
         return this.post("/admin/cache/flush");
     }
-    // -----------------------------------------------------------------------
-    // Admin — Tiers & Pricing
-    // -----------------------------------------------------------------------
-    /**
-     * Get all tier configurations.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/tiers`
-     */
-    getTiers() {
-        return this.get("/admin/tiers");
-    }
-    /**
-     * Get current pricing configuration.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/pricing`
-     */
-    getPricing() {
-        return this.get("/admin/pricing");
-    }
-    // -----------------------------------------------------------------------
-    // Admin — Audit & System
-    // -----------------------------------------------------------------------
-    /**
-     * Get admin-level audit log entries.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param limit - Maximum entries to return (1–1000, default 100).
-     *
-     * **Endpoint:** `GET /v1/admin/audit`
-     */
     getAdminAudit(limit) {
-        const query = limit !== undefined ? { limit: String(limit) } : undefined;
+        const query = limit !== undefined ? { limit } : undefined;
         return this.get("/admin/audit", query);
     }
-    /**
-     * Get system information (Python version, platform, architecture, PID, etc.).
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/system`
-     */
     getSystemInfo() {
         return this.get("/admin/system");
     }
-    // -----------------------------------------------------------------------
-    // Jira Integration
-    // -----------------------------------------------------------------------
-    /**
-     * Connect a Jira Cloud site using an API token.
-     * Validates credentials, registers a webhook, and stores the encrypted token.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Jira connection details (site_url, email, api_token).
-     * @param options - Optional per-request overrides.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/integrations/jira/connect`
-     */
-    connectJira(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/integrations/jira/connect`, params, options);
-    }
-    /**
-     * Get the current Jira integration status for an organization.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param options - Optional per-request overrides.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/integrations/jira/status`
-     */
-    getJiraStatus(orgId, options) {
-        return this.get(`/organizations/${orgId}/integrations/jira/status`, undefined, options);
-    }
-    /**
-     * Disconnect (unlink) an organization's Jira integration.
-     * Deregisters the webhook and deletes stored credentials.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param options - Optional per-request overrides.
-     *
-     * **Endpoint:** `DELETE /v1/organizations/{orgId}/integrations/jira`
-     */
-    disconnectJira(orgId, options) {
-        return this.del(`/organizations/${orgId}/integrations/jira`, options);
-    }
-    /**
-     * Trigger a bulk sync of Jira issues from specified projects into the
-     * document store for RAG retrieval.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization identifier.
-     * @param params - Object containing `project_keys` array.
-     * @param options - Optional per-request overrides.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/integrations/jira/sync`
-     */
-    syncJira(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/integrations/jira/sync`, params, options);
-    }
-    /**
-     * Send a Jira webhook event manually.
-     *
-     * **Auth:** Requires `webhookSecret` in client config.
-     *
-     * @param payload - Jira webhook payload (issue, webhookEvent, etc.).
-     *
-     * **Endpoint:** `POST /v1/webhook/jira`
-     */
+    connectJira(params, options) {
+        return this.post("/integrations/jira/connect", params, options);
+    }
+    getJiraStatus(options) {
+        return this.get("/integrations/jira/status", undefined, options);
+    }
+    disconnectJira(options) {
+        return this.del("/integrations/jira", options);
+    }
+    syncJira(params, options) {
+        return this.post("/integrations/jira/sync", params, options);
+    }
     sendJiraWebhook(payload) {
         return this.post("/webhook/jira", payload);
     }
-    // ---------------------------------------------------------------------------
-    // Blueprint Management
-    // ---------------------------------------------------------------------------
-    /**
-     * Create a new document blueprint (template).
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param params - Blueprint details (name, sections, workflow_config, etc.).
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/blueprints`
-     */
-    createBlueprint(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/blueprints`, params, options);
-    }
-    /**
-     * List all blueprints for an organization.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/blueprints`
-     */
-    listBlueprints(orgId, options) {
-        return this.get(`/organizations/${orgId}/blueprints`, undefined, options);
-    }
-    /**
-     * Get a single blueprint by ID.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param blueprintId - Blueprint ID.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/blueprints/{blueprintId}`
-     */
-    getBlueprint(orgId, blueprintId, options) {
-        return this.get(`/organizations/${orgId}/blueprints/${blueprintId}`, undefined, options);
-    }
-    /**
-     * Update an existing blueprint. Only provided fields are changed.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param blueprintId - Blueprint ID.
-     * @param params - Fields to update.
-     *
-     * **Endpoint:** `PUT /v1/organizations/{orgId}/blueprints/{blueprintId}`
-     */
-    updateBlueprint(orgId, blueprintId, params, options) {
-        return this.put(`/organizations/${orgId}/blueprints/${blueprintId}`, params, options);
-    }
-    /**
-     * Publish a blueprint, making it available for document creation.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param blueprintId - Blueprint ID.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/blueprints/{blueprintId}/publish`
-     */
-    publishBlueprint(orgId, blueprintId, options) {
-        return this.post(`/organizations/${orgId}/blueprints/${blueprintId}/publish`, {}, options);
-    }
-    /**
-     * Archive a blueprint, preventing new documents from being created from it.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param blueprintId - Blueprint ID.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/blueprints/{blueprintId}/archive`
-     */
-    archiveBlueprint(orgId, blueprintId, options) {
-        return this.post(`/organizations/${orgId}/blueprints/${blueprintId}/archive`, {}, options);
-    }
-    /**
-     * Permanently delete a blueprint.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param blueprintId - Blueprint ID.
-     *
-     * **Endpoint:** `DELETE /v1/organizations/{orgId}/blueprints/{blueprintId}`
-     */
-    deleteBlueprint(orgId, blueprintId, options) {
-        return this.del(`/organizations/${orgId}/blueprints/${blueprintId}`, options);
-    }
-    // ---------------------------------------------------------------------------
-    // Managed Documents
-    // ---------------------------------------------------------------------------
-    /**
-     * Create a new managed document from a published blueprint.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param params - Document details (blueprint_id, title, sections, etc.).
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/documents/create`
-     */
-    createDocumentFromBlueprint(orgId, params, options) {
-        return this.post(`/organizations/${orgId}/documents/create`, params, options);
-    }
-    /**
-     * List all managed documents for an organization.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/documents/managed`
-     */
-    listManagedDocuments(orgId, options) {
-        return this.get(`/organizations/${orgId}/documents/managed`, undefined, options);
-    }
-    /**
-     * Get a single managed document by ID.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param documentId - Document ID.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/documents/managed/{documentId}`
-     */
-    getManagedDocument(orgId, documentId, options) {
-        return this.get(`/organizations/${orgId}/documents/managed/${documentId}`, undefined, options);
-    }
-    /**
-     * Update the content of a document section. Only allowed in draft/revision status.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param documentId - Document ID.
-     * @param params - Section ID and new content.
-     *
-     * **Endpoint:** `PATCH /v1/organizations/{orgId}/documents/managed/{documentId}/sections`
-     */
-    updateDocumentSection(orgId, documentId, params, options) {
-        return this.patch(`/organizations/${orgId}/documents/managed/${documentId}/sections`, params, options);
-    }
-    /**
-     * Perform a workflow action on a managed document.
-     *
-     * Actions: submit, approve, reject, request_changes, seal.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param documentId - Document ID.
-     * @param params - Action type and optional comment.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/documents/managed/{documentId}/workflow`
-     */
-    performDocumentWorkflow(orgId, documentId, params, options) {
-        return this.post(`/organizations/${orgId}/documents/managed/${documentId}/workflow`, params, options);
-    }
-    /**
-     * Permanently delete a managed document.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param documentId - Document ID.
-     *
-     * **Endpoint:** `DELETE /v1/organizations/{orgId}/documents/managed/{documentId}`
-     */
-    deleteManagedDocument(orgId, documentId, options) {
-        return this.del(`/organizations/${orgId}/documents/managed/${documentId}`, options);
-    }
-    /**
-     * AI-generate content for a document section using the blueprint's AI rules.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     * @param documentId - Document ID.
-     * @param params - Section ID and optional context for generation.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/documents/managed/{documentId}/generate`
-     */
-    generateDocumentSection(orgId, documentId, params, options) {
-        return this.post(`/organizations/${orgId}/documents/managed/${documentId}/generate`, params, options);
-    }
-    // -----------------------------------------------------------------------
-    // Streaming — SSE
-    // -----------------------------------------------------------------------
-    /**
-     * Chat inside a content project using Server-Sent Events.
-     * Returns an async iterator of typed {@link ChatStreamEvent} objects.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/projects/{projectId}/chat/stream`
-     *
-     * @example
-     * ```typescript
-     * for await (const evt of client.chatProjectSse("acme", "proj-1", {
-     *   message: "Summarize our sources",
-     *   user_id: "u1",
-     * })) {
-     *   if (evt.event === "done") console.log(evt.data.answer);
-     * }
-     * ```
-     */
-    async *chatProjectSse(orgId, projectId, params, options) {
-        const url = new URL(`${this.prefix}/organizations/${orgId}/projects/${projectId}/chat/stream`, this.baseUrl);
+    createBlueprint(params, options) {
+        return this.post("/blueprints", params, options);
+    }
+    listBlueprints(options) {
+        return this.get("/blueprints", undefined, options);
+    }
+    getBlueprint(blueprintId, options) {
+        return this.get(`/blueprints/${blueprintId}`, undefined, options);
+    }
+    updateBlueprint(blueprintId, params, options) {
+        return this.put(`/blueprints/${blueprintId}`, params, options);
+    }
+    publishBlueprint(blueprintId, options) {
+        return this.post(`/blueprints/${blueprintId}/publish`, {}, options);
+    }
+    archiveBlueprint(blueprintId, options) {
+        return this.post(`/blueprints/${blueprintId}/archive`, {}, options);
+    }
+    deleteBlueprint(blueprintId, options) {
+        return this.del(`/blueprints/${blueprintId}`, options);
+    }
+    createDocumentFromBlueprint(params, options) {
+        return this.post("/documents/create", params, options);
+    }
+    listManagedDocuments(options) {
+        return this.get("/documents/managed", undefined, options);
+    }
+    getManagedDocument(documentId, options) {
+        return this.get(`/documents/managed/${documentId}`, undefined, options);
+    }
+    updateDocumentSection(documentId, params, options) {
+        return this.patch(`/documents/managed/${documentId}/sections`, params, options);
+    }
+    performDocumentWorkflow(documentId, params, options) {
+        return this.post(`/documents/managed/${documentId}/workflow`, params, options);
+    }
+    deleteManagedDocument(documentId, options) {
+        return this.del(`/documents/managed/${documentId}`, options);
+    }
+    generateDocumentSection(documentId, params, options) {
+        return this.post(`/documents/managed/${documentId}/generate`, params, options);
+    }
+    async *chatProjectSse(projectId, params, options) {
+        const url = new URL(`${this.prefix}/projects/${projectId}/chat/stream`, this.baseUrl);
         const headers = {
             "Content-Type": "application/json",
             Accept: "text/event-stream",
         };
         const apiKey = options?.apiKey ?? this.config.apiKey;
         if (apiKey)
-            headers["Authorization"] = `Bearer ${apiKey}`;
+            headers.Authorization = `Bearer ${apiKey}`;
         if (this.config.adminKey)
             headers["X-Admin-Key"] = this.config.adminKey;
-        if (this.config.employeeId)
-            headers["X-Employee-Id"] = this.config.employeeId;
         const res = await fetch(url.toString(), {
             method: "POST",
             headers,
@@ -1758,27 +573,8 @@ class HivemindClient {
             yield { event: raw.event, data };
         }
     }
-    // -----------------------------------------------------------------------
-    // Streaming — WebSocket
-    // -----------------------------------------------------------------------
-    /**
-     * Open a WebSocket to the project chat endpoint and return a
-     * convenience handle for sending commands and receiving frames.
-     *
-     * **Auth:** API key is sent as `?api_key=` query param (browser-safe).
-     *
-     * **Endpoint:** `WS /v1/organizations/{orgId}/projects/{projectId}/chat/ws`
-     *
-     * @example
-     * ```typescript
-     * const ws = await client.chatProjectWebSocket("acme", "proj-1");
-     * const frame = await ws.chat({ message: "Hello", user_id: "u1" });
-     * if (frame.type === "result") console.log(frame.payload.answer);
-     * ws.close();
-     * ```
-     */
-    async chatProjectWebSocket(orgId, projectId, options) {
-        const httpUrl = new URL(`${this.prefix}/organizations/${orgId}/projects/${projectId}/chat/ws`, this.baseUrl);
+    async chatProjectWebSocket(projectId, options) {
+        const httpUrl = new URL(`${this.prefix}/projects/${projectId}/chat/ws`, this.baseUrl);
         const wsUrl = httpUrl.toString().replace(/^http/, "ws");
         const apiKey = options?.apiKey ?? this.config.apiKey;
         const { openHivemindWebSocket, sendChatCommand } = await Promise.resolve().then(() => __importStar(require("./ws")));
@@ -1787,13 +583,10 @@ class HivemindClient {
             signal: options?.signal,
         });
         return {
-            /** The underlying WebSocket instance. */
             raw: ws,
-            /** Send a chat command and wait for the server response frame. */
             chat(params) {
                 return sendChatCommand(ws, { type: "chat", ...params });
             },
-            /** Gracefully close the connection. */
             close(code, reason) {
                 ws.close(code ?? 1000, reason);
             },