@ai2aim.ai/hivemind-sdk 1.0.15 → 3.1.1

package/dist/client.d.ts

@@ -1,25 +1,19 @@
-import type { AdminLoginParams, AdminLoginResponse, AdminAuditResponse, AgentCreateParams, AgentCreateResponse, AgentQueryParams, AgentQueryResponse, AudioSynthesizeParams, AudioSynthesizeResponse, AudioTranscribeParams, AudioTranscriptionResponse, AuditLogResponse, CacheStatsResponse, ChangeOrgStatusResponse, ChatStreamEvent, CreateOrganizationOptions, ContentItemCreateParams, ContentItemListResponse, ContentItemResponse, ContentItemUpdateParams, ContentProject, ContentProjectListResponse, ConfigOverview, DataChatParams, DataChatResponse, DocumentGenerateResponse, DocumentGenerateSectionParams, DocumentProcessedWebhook, DocumentUploadResponse, FeatureFlag, FeatureFlagUpdate, ForecastParams, ForecastResponse, GenerateImageParams, GenerateMusicParams, GenerateVideoParams, HealthResponse, InboundTrafficStats, InvoiceResponse, JiraConnectRequest, JiraConnectResponse, JiraDisconnectResponse, JiraIntegrationStatusResponse, JiraSyncRequest, JiraSyncResponse, JiraWebhookAckResponse, BlueprintCreateParams, BlueprintUpdateParams, BlueprintResponse, BlueprintListResponse, DocumentCreateFromBlueprintParams, DocumentUpdateSectionParams, DocumentWorkflowActionParams, ManagedDocumentResponse, ManagedDocumentListResponse, JobAcceptedResponse, JobListResponse, JobStatusResponse, LogLevelRequest, LogLevelResponse, LoggerInfo, MaintenanceModeRequest, MaintenanceModeResponse, OrgBootstrapResponse, OrgCreateParams, OrgEnsureResponse, OrgListResponse, Organization, OutboundStatusResponse, PredictParams, PredictResponse, PricingResponse, ProjectChatHistoryResponse, ProjectChatParams, ProjectCreateParams, ProjectSourceCreateParams, ProjectSourceListResponse, ProjectSourceResponse, ProjectSourceScrapeParams, ProjectSourceUpdateParams, ProjectUpdateParams, QueryParams, QueryResponse, SearchParams, SearchResponse, RateLimitEntry, RootResponse, RotateApiKeyResponse, ScrapeParams, ScrapeResponse, ScrapeStatusResponse, ScrapingConfigResponse, ScheduleRunResultResponse, TierConfigResponse, TrainModelParams, TrainModelResponse, UpdateSettingRequest, UpdateSettingResponse, UsageSummaryResponse, WebhookAckResponse, WsChatCommand, WsChatFrame, PublishScheduleCreateParams, PublishScheduleListResponse, PublishScheduleResponse, PublishScheduleUpdateParams, HivemindClientConfigInput, RequestOptions, VideoCompleteWebhook } from "./types";
+import type { AdminAuditResponse, AdminLoginParams, AdminLoginResponse, AgentCreateParams, AgentCreateResponse, AgentQueryParams, AgentQueryResponse, ApiKeyBootstrapResponse, ApiKeyIssueParams, ApiKeyRotateResponse, ApiKeyScope, AudioSynthesizeParams, AudioSynthesizeResponse, AudioTranscribeParams, AudioTranscriptionResponse, AuditLogResponse, BlueprintCreateParams, BlueprintListResponse, BlueprintResponse, BlueprintUpdateParams, CacheStatsResponse, ConfigOverview, DataChatParams, DataChatResponse, DocumentCreateFromBlueprintParams, DocumentGenerateResponse, DocumentGenerateSectionParams, DocumentProcessedWebhook, DocumentUpdateSectionParams, DocumentUploadResponse, DocumentWorkflowActionParams, FeatureFlag, FeatureFlagUpdate, ForecastParams, ForecastResponse, GenerateImageParams, GenerateMusicParams, GenerateVideoParams, HealthResponse, HivemindClientConfigInput, InboundTrafficStats, JiraConnectRequest, JiraConnectResponse, JiraDisconnectResponse, JiraIntegrationStatusResponse, JiraSyncRequest, JiraSyncResponse, JiraWebhookAckResponse, JobAcceptedResponse, JobListResponse, JobStatusResponse, LogLevelRequest, LogLevelResponse, LoggerInfo, MaintenanceModeRequest, MaintenanceModeResponse, ManagedDocumentListResponse, ManagedDocumentResponse, OutboundStatusResponse, PredictParams, PredictResponse, RateLimitEntry, RequestAuthMode, RequestOptions, RootResponse, ScrapeParams, ScrapeResponse, ScrapeStatusResponse, ScrapingConfigResponse, SearchParams, SearchResponse, SocialContentGenerateParams, SocialContentGenerationResponse, TrainModelParams, TrainModelResponse, UpdateSettingRequest, UpdateSettingResponse, VideoCompleteWebhook, WebhookAckResponse } from "./types";
 export * from "./types";
-/**
- * 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);
- *   }
- * }
- * ```
- */
 export declare class HivemindError extends Error {
     statusCode: number;
     detail: unknown;
     constructor(statusCode: number, detail: unknown, message?: string);
 }
+type QueryMap = Record<string, string | number | boolean | undefined | null>;
+type RequestConfig = {
+    body?: unknown;
+    headers?: Record<string, string>;
+    query?: QueryMap;
+    formData?: FormData;
+    apiKey?: string;
+    authMode?: RequestAuthMode;
+};
 export declare class HivemindClient {
     private readonly baseUrl;
     private readonly prefix;
@@ -28,1219 +22,111 @@ export declare class HivemindClient {
     private request;
     private requestUnprefixed;
     private performRequest;
-    /**
-     * 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.
-     */
-    requestEnvelope<T>(method: string, path: string, opts?: {
-        body?: unknown;
-        headers?: Record<string, string>;
-        query?: Record<string, string>;
-        apiKey?: string;
-    }): Promise<import("./types").ApiEnvelope<T>>;
+    requestEnvelope<T>(method: string, path: string, opts?: Omit<RequestConfig, "formData">): Promise<import("./types").ApiEnvelope<T>>;
     private asEnvelope;
     private extractErrorMessage;
-    private isOrganizationAlreadyExistsError;
     private get;
     private post;
-    private del;
     private put;
     private patch;
-    /**
-     * Fetch the unauthenticated service root metadata payload.
-     *
-     * @returns Service name plus relative health/docs entrypoints.
-     *
-     * **Endpoint:** `GET /`
-     */
+    private del;
     root(): Promise<RootResponse>;
-    /**
-     * 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(): Promise<HealthResponse>;
-    /**
-     * 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: AdminLoginParams): Promise<AdminLoginResponse>;
-    /**
-     * Create a new organization. Returns the organization details and a generated API key.
-     *
-     * **Auth:** Requires `adminKey` in client config (sends `X-Admin-Key` header).
-     *
-     * @param params - Organization creation parameters (org_id, name, tier, settings).
-     * @param options - Optional behavior flags. By default, duplicate-organization
-     *   responses are treated as a successful lookup instead of throwing. Pass
-     *   `{ allowExisting: false }` for strict create-only behavior.
-     * @returns The created organization and its API key, or the existing organization
-     *   when the org has already been provisioned.
-     * @throws {@link HivemindError} 400 if validation fails, or if the org already exists
-     *   and you passed `{ allowExisting: false }`.
-     * @throws {@link HivemindError} 401 if admin credentials are invalid.
-     *
-     * **Endpoint:** `POST /v1/organizations`
-     *
-     * @example
-     * ```typescript
-     * const { organization, api_key } = await admin.createOrganization({
-     *   org_id: "acme-corp",
-     *   name: "Acme Corporation",
-     *   tier: "premium",
-     * });
-     * console.log("API Key:", api_key); // Store securely — shown only once
-     * ```
-     */
-    createOrganization(params: OrgCreateParams): Promise<OrgEnsureResponse>;
-    createOrganization(params: OrgCreateParams, options: CreateOrganizationOptions & {
-        allowExisting: false;
-    }): Promise<OrgBootstrapResponse>;
-    createOrganization(params: OrgCreateParams, options: CreateOrganizationOptions & {
-        allowExisting: true;
-    }): Promise<OrgEnsureResponse>;
-    /**
-     * 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: OrgCreateParams): Promise<OrgEnsureResponse>;
-    /**
-     * 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: string, options?: RequestOptions): Promise<Organization>;
-    /**
-     * 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: string, options?: RequestOptions): Promise<RotateApiKeyResponse>;
-    /**
-     * 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: string, options?: RequestOptions): Promise<ChangeOrgStatusResponse>;
-    /**
-     * 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: string, options?: RequestOptions): Promise<ChangeOrgStatusResponse>;
-    /**
-     * 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: string, options?: RequestOptions): Promise<void>;
-    /**
-     * 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`);
-     * ```
-     */
-    uploadDocument(orgId: string, file: Blob | Buffer, filename: string, options?: RequestOptions): Promise<DocumentUploadResponse>;
-    /**
-     * 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: string, params: QueryParams, options?: RequestOptions): Promise<QueryResponse>;
-    /**
-     * Search indexed sources for source discovery.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `POST /v1/organizations/{orgId}/search`
-     */
-    search(orgId: string, params: SearchParams, options?: RequestOptions): Promise<SearchResponse>;
-    createProject(orgId: string, params: ProjectCreateParams, options?: RequestOptions): Promise<ContentProject>;
-    listProjects(orgId: string, options?: RequestOptions): Promise<ContentProjectListResponse>;
-    getProject(orgId: string, projectId: string, options?: RequestOptions): Promise<ContentProject>;
-    updateProject(orgId: string, projectId: string, params: ProjectUpdateParams, options?: RequestOptions): Promise<ContentProject>;
-    deleteProject(orgId: string, projectId: string, options?: RequestOptions): Promise<void>;
-    chatProject(orgId: string, projectId: string, params: ProjectChatParams, options?: RequestOptions): Promise<QueryResponse>;
-    getProjectChatHistory(orgId: string, projectId: string, userId: string, options?: RequestOptions): Promise<ProjectChatHistoryResponse>;
-    createContentItem(orgId: string, projectId: string, params: ContentItemCreateParams, options?: RequestOptions): Promise<ContentItemResponse>;
-    listContentItems(orgId: string, projectId: string, options?: RequestOptions): Promise<ContentItemListResponse>;
-    getContentItem(orgId: string, projectId: string, contentId: string, options?: RequestOptions): Promise<ContentItemResponse>;
-    updateContentItem(orgId: string, projectId: string, contentId: string, params: ContentItemUpdateParams, options?: RequestOptions): Promise<ContentItemResponse>;
-    deleteContentItem(orgId: string, projectId: string, contentId: string, options?: RequestOptions): Promise<void>;
-    createProjectSource(orgId: string, projectId: string, params: ProjectSourceCreateParams, options?: RequestOptions): Promise<ProjectSourceResponse>;
-    /**
-     * 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: string, projectId: string, params: ProjectSourceScrapeParams, options?: RequestOptions): Promise<ProjectSourceListResponse>;
-    listProjectSources(orgId: string, projectId: string, options?: RequestOptions): Promise<ProjectSourceListResponse>;
-    getProjectSource(orgId: string, projectId: string, sourceId: string, options?: RequestOptions): Promise<ProjectSourceResponse>;
-    updateProjectSource(orgId: string, projectId: string, sourceId: string, params: ProjectSourceUpdateParams, options?: RequestOptions): Promise<ProjectSourceResponse>;
-    deleteProjectSource(orgId: string, projectId: string, sourceId: string, options?: RequestOptions): Promise<void>;
-    /**
-     * 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: string, projectId: string, params: PublishScheduleCreateParams, options?: RequestOptions): Promise<PublishScheduleResponse>;
-    /**
-     * List publish schedules for a project.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/projects/{projectId}/schedules`
-     */
-    listPublishSchedules(orgId: string, projectId: string, options?: RequestOptions): Promise<PublishScheduleListResponse>;
-    /**
-     * Get a single publish schedule.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/projects/{projectId}/schedules/{scheduleId}`
-     */
-    getPublishSchedule(orgId: string, projectId: string, scheduleId: string, options?: RequestOptions): Promise<PublishScheduleResponse>;
-    /**
-     * Update a publish schedule.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `PATCH /v1/organizations/{orgId}/projects/{projectId}/schedules/{scheduleId}`
-     */
-    updatePublishSchedule(orgId: string, projectId: string, scheduleId: string, params: PublishScheduleUpdateParams, options?: RequestOptions): Promise<PublishScheduleResponse>;
-    /**
-     * Delete a publish schedule.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * **Endpoint:** `DELETE /v1/organizations/{orgId}/projects/{projectId}/schedules/{scheduleId}`
-     */
-    deletePublishSchedule(orgId: string, projectId: string, scheduleId: string, options?: RequestOptions): Promise<void>;
-    /**
-     * 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`
-     */
-    runDueSchedules(): Promise<ScheduleRunResultResponse>;
-    /**
-     * 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: string, params: GenerateVideoParams, options?: RequestOptions): Promise<JobAcceptedResponse>;
-    /**
-     * 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: string, params: GenerateImageParams, options?: RequestOptions): Promise<JobAcceptedResponse>;
-    /**
-     * 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: string, params: GenerateMusicParams, options?: RequestOptions): Promise<JobAcceptedResponse>;
-    /**
-     * 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: string, jobId: string, options?: RequestOptions): Promise<JobStatusResponse>;
-    /**
-     * 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);
-     * ```
-     */
-    waitForJob(orgId: string, jobId: string, intervalMs?: number, maxWaitMs?: number, options?: RequestOptions): Promise<JobStatusResponse>;
-    /**
-     * 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: string, params: DataChatParams, options?: RequestOptions): Promise<DataChatResponse>;
-    /**
-     * 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: string, params: AgentCreateParams, options?: RequestOptions): Promise<AgentCreateResponse>;
-    /**
-     * 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: string, params: AgentQueryParams, options?: RequestOptions): Promise<AgentQueryResponse>;
-    /**
-     * 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: string, params: AudioTranscribeParams, options?: RequestOptions): Promise<AudioTranscriptionResponse>;
-    /**
-     * 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: string, params: AudioSynthesizeParams, options?: RequestOptions): Promise<AudioSynthesizeResponse>;
-    /**
-     * 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: string, params: TrainModelParams, options?: RequestOptions): Promise<TrainModelResponse>;
-    /**
-     * 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: string, params: PredictParams, options?: RequestOptions): Promise<PredictResponse>;
-    /**
-     * 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: string, params: ForecastParams, options?: RequestOptions): Promise<ForecastResponse>;
-    /**
-     * 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: string, month?: string, options?: RequestOptions): Promise<UsageSummaryResponse>;
-    /**
-     * 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: string, month?: string, options?: RequestOptions): Promise<InvoiceResponse>;
-    /**
-     * 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: string, options?: RequestOptions): Promise<AuditLogResponse>;
-    /**
-     * Get the current scraping runtime configuration.
-     *
-     * **Auth:** None required.
-     *
-     * @returns Execution mode, Cloud Run status, and cache statistics.
-     *
-     * **Endpoint:** `GET /v1/scraping/config`
-     */
+    issueApiKey(params?: ApiKeyIssueParams): Promise<ApiKeyBootstrapResponse>;
+    getCurrentScope(options?: RequestOptions): Promise<ApiKeyScope>;
+    rotateApiKey(options?: RequestOptions): Promise<ApiKeyRotateResponse>;
+    uploadDocument(file: Blob | Buffer, filename: string, options?: RequestOptions): Promise<DocumentUploadResponse>;
+    search(params: SearchParams, options?: RequestOptions): Promise<SearchResponse>;
+    generateVideo(params: GenerateVideoParams, options?: RequestOptions): Promise<JobAcceptedResponse>;
+    generateImage(params: GenerateImageParams, options?: RequestOptions): Promise<JobAcceptedResponse>;
+    generateMusic(params: GenerateMusicParams, options?: RequestOptions): Promise<JobAcceptedResponse>;
+    generateSocialContent(params: SocialContentGenerateParams, options?: RequestOptions): Promise<SocialContentGenerationResponse>;
+    getJob(jobId: string, options?: RequestOptions): Promise<JobStatusResponse>;
+    waitForJob(jobId: string, intervalMs?: number, maxWaitMs?: number, options?: RequestOptions): Promise<JobStatusResponse>;
+    dataChat(params: DataChatParams, options?: RequestOptions): Promise<DataChatResponse>;
+    createAgent(params: AgentCreateParams, options?: RequestOptions): Promise<AgentCreateResponse>;
+    queryAgent(params: AgentQueryParams, options?: RequestOptions): Promise<AgentQueryResponse>;
+    transcribeAudio(params: AudioTranscribeParams, options?: RequestOptions): Promise<AudioTranscriptionResponse>;
+    synthesizeAudio(params: AudioSynthesizeParams, options?: RequestOptions): Promise<AudioSynthesizeResponse>;
+    trainModel(params: TrainModelParams, options?: RequestOptions): Promise<TrainModelResponse>;
+    predict(params: PredictParams, options?: RequestOptions): Promise<PredictResponse>;
+    forecast(params: ForecastParams, options?: RequestOptions): Promise<ForecastResponse>;
+    getAuditLogs(options?: RequestOptions): Promise<AuditLogResponse>;
     getScrapingConfig(): Promise<ScrapingConfigResponse>;
-    /**
-     * 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: ScrapeParams): Promise<ScrapeResponse>;
-    /**
-     * 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: string): Promise<ScrapeStatusResponse>;
-    /**
-     * 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));
-     * }
-     * ```
-     */
     scrapeAndWait(urls: string[], intervalMs?: number, maxWaitMs?: number): Promise<ScrapeStatusResponse>;
-    /**
-     * 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: VideoCompleteWebhook): Promise<WebhookAckResponse>;
-    /**
-     * 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: DocumentProcessedWebhook): Promise<WebhookAckResponse>;
-    /**
-     * Get full service configuration overview.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/config`
-     */
     getAdminConfig(): Promise<ConfigOverview>;
-    /**
-     * Get runtime setting overrides.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/config/overrides`
-     */
     getAdminConfigOverrides(): Promise<{
         overrides: Record<string, unknown>;
     }>;
-    /**
-     * 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: UpdateSettingRequest): Promise<UpdateSettingResponse>;
-    /**
-     * Get the current application log level.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/logging/level`
-     */
     getLogLevel(): Promise<LogLevelResponse>;
-    /**
-     * 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: LogLevelRequest): Promise<LogLevelResponse>;
-    /**
-     * List all loggers with their levels and handlers.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/logging/loggers`
-     */
     getLoggers(): Promise<{
         loggers: LoggerInfo[];
     }>;
-    /**
-     * Get inbound traffic statistics.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/traffic/inbound`
-     */
     getInboundTraffic(): Promise<InboundTrafficStats>;
-    /**
-     * Reset inbound traffic counters.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `POST /v1/admin/traffic/inbound/reset`
-     */
     resetInboundTraffic(): Promise<{
         status: string;
         timestamp: string;
     }>;
-    /**
-     * Check health of outbound dependencies (GCP, Vertex, BigQuery, Redis).
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/traffic/outbound`
-     */
     getOutboundStatus(): Promise<OutboundStatusResponse>;
-    /**
-     * Get the current CORS allowed origins.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/cors`
-     */
     getCors(): Promise<{
         allow_origins: string[];
     }>;
-    /**
-     * Update the CORS allowed origins.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param allowOrigins - Comma-separated origins or `"*"`.
-     *
-     * **Endpoint:** `PUT /v1/admin/cors`
-     */
     setCors(allowOrigins: string): Promise<{
         previous: string;
         new: string;
         note: string;
     }>;
-    /**
-     * List all rate-limit entries.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/rate-limits`
-     */
     getRateLimits(): Promise<{
         rate_limits: RateLimitEntry[];
     }>;
-    /**
-     * 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: string): Promise<{
-        org_id: string;
+    resetRateLimit(scopeId: string): Promise<{
+        scope_id: string;
         status: string;
     }>;
-    /**
-     * 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?: number): Promise<OrgListResponse>;
-    /**
-     * Get a single organization (admin view).
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * @param orgId - Organization identifier.
-     *
-     * **Endpoint:** `GET /v1/admin/organizations/{orgId}`
-     */
-    getAdminOrganization(orgId: string): Promise<Organization>;
-    /**
-     * 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`
-     */
     listJobs(limit?: number): Promise<JobListResponse>;
-    /**
-     * Get all feature flags.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/feature-flags`
-     */
     getFeatureFlags(): Promise<{
         flags: Record<string, unknown>;
     }>;
-    /**
-     * 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: string): Promise<FeatureFlag>;
-    /**
-     * 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: FeatureFlagUpdate): Promise<FeatureFlag>;
-    /**
-     * 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: string): Promise<{
         key: string;
         deleted: boolean;
     }>;
-    /**
-     * Get current maintenance mode state.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/maintenance`
-     */
     getMaintenanceMode(): Promise<MaintenanceModeResponse>;
-    /**
-     * 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: MaintenanceModeRequest): Promise<MaintenanceModeResponse>;
-    /**
-     * Get cache statistics.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/cache`
-     */
     getCacheStats(): Promise<CacheStatsResponse>;
-    /**
-     * Flush all caches.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `POST /v1/admin/cache/flush`
-     */
     flushCache(): Promise<{
         status: string;
         backend: string;
     }>;
-    /**
-     * Get all tier configurations.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/tiers`
-     */
-    getTiers(): Promise<{
-        tiers: TierConfigResponse[];
-    }>;
-    /**
-     * Get current pricing configuration.
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/pricing`
-     */
-    getPricing(): Promise<PricingResponse>;
-    /**
-     * 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?: number): Promise<AdminAuditResponse>;
-    /**
-     * Get system information (Python version, platform, architecture, PID, etc.).
-     *
-     * **Auth:** Requires `adminKey` in client config.
-     *
-     * **Endpoint:** `GET /v1/admin/system`
-     */
     getSystemInfo(): Promise<Record<string, unknown>>;
-    /**
-     * 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: string, params: JiraConnectRequest, options?: RequestOptions): Promise<JiraConnectResponse>;
-    /**
-     * 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: string, options?: RequestOptions): Promise<JiraIntegrationStatusResponse>;
-    /**
-     * 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: string, options?: RequestOptions): Promise<JiraDisconnectResponse>;
-    /**
-     * 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: string, params: JiraSyncRequest, options?: RequestOptions): Promise<JiraSyncResponse>;
-    /**
-     * 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: JiraConnectRequest, options?: RequestOptions): Promise<JiraConnectResponse>;
+    getJiraStatus(options?: RequestOptions): Promise<JiraIntegrationStatusResponse>;
+    disconnectJira(options?: RequestOptions): Promise<JiraDisconnectResponse>;
+    syncJira(params: JiraSyncRequest, options?: RequestOptions): Promise<JiraSyncResponse>;
     sendJiraWebhook(payload: Record<string, unknown>): Promise<JiraWebhookAckResponse>;
-    /**
-     * 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: string, params: BlueprintCreateParams, options?: RequestOptions): Promise<BlueprintResponse>;
-    /**
-     * List all blueprints for an organization.
-     *
-     * **Auth:** Requires org-scoped API key.
-     *
-     * @param orgId - Organization ID.
-     *
-     * **Endpoint:** `GET /v1/organizations/{orgId}/blueprints`
-     */
-    listBlueprints(orgId: string, options?: RequestOptions): Promise<BlueprintListResponse>;
-    /**
-     * 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: string, blueprintId: string, options?: RequestOptions): Promise<BlueprintResponse>;
-    /**
-     * 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: string, blueprintId: string, params: BlueprintUpdateParams, options?: RequestOptions): Promise<BlueprintResponse>;
-    /**
-     * 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: string, blueprintId: string, options?: RequestOptions): Promise<BlueprintResponse>;
-    /**
-     * 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: string, blueprintId: string, options?: RequestOptions): Promise<BlueprintResponse>;
-    /**
-     * 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: string, blueprintId: string, options?: RequestOptions): Promise<void>;
-    /**
-     * 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: string, params: DocumentCreateFromBlueprintParams, options?: RequestOptions): Promise<ManagedDocumentResponse>;
-    /**
-     * 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: string, options?: RequestOptions): Promise<ManagedDocumentListResponse>;
-    /**
-     * 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: string, documentId: string, options?: RequestOptions): Promise<ManagedDocumentResponse>;
-    /**
-     * 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: string, documentId: string, params: DocumentUpdateSectionParams, options?: RequestOptions): Promise<ManagedDocumentResponse>;
-    /**
-     * 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: string, documentId: string, params: DocumentWorkflowActionParams, options?: RequestOptions): Promise<ManagedDocumentResponse>;
-    /**
-     * 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: string, documentId: string, options?: RequestOptions): Promise<void>;
-    /**
-     * 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: string, documentId: string, params: DocumentGenerateSectionParams, options?: RequestOptions): Promise<DocumentGenerateResponse>;
-    /**
-     * 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);
-     * }
-     * ```
-     */
-    chatProjectSse(orgId: string, projectId: string, params: ProjectChatParams, options?: RequestOptions): AsyncGenerator<ChatStreamEvent, void, undefined>;
-    /**
-     * 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();
-     * ```
-     */
-    chatProjectWebSocket(orgId: string, projectId: string, options?: RequestOptions & {
-        signal?: AbortSignal;
-    }): Promise<{
-        /** The underlying WebSocket instance. */
-        raw: WebSocket;
-        /** Send a chat command and wait for the server response frame. */
-        chat(params: Omit<WsChatCommand, "type">): Promise<WsChatFrame>;
-        /** Gracefully close the connection. */
-        close(code?: number, reason?: string): void;
-    }>;
+    createBlueprint(params: BlueprintCreateParams, options?: RequestOptions): Promise<BlueprintResponse>;
+    listBlueprints(options?: RequestOptions): Promise<BlueprintListResponse>;
+    getBlueprint(blueprintId: string, options?: RequestOptions): Promise<BlueprintResponse>;
+    updateBlueprint(blueprintId: string, params: BlueprintUpdateParams, options?: RequestOptions): Promise<BlueprintResponse>;
+    publishBlueprint(blueprintId: string, options?: RequestOptions): Promise<BlueprintResponse>;
+    archiveBlueprint(blueprintId: string, options?: RequestOptions): Promise<BlueprintResponse>;
+    deleteBlueprint(blueprintId: string, options?: RequestOptions): Promise<void>;
+    createDocumentFromBlueprint(params: DocumentCreateFromBlueprintParams, options?: RequestOptions): Promise<ManagedDocumentResponse>;
+    listManagedDocuments(options?: RequestOptions): Promise<ManagedDocumentListResponse>;
+    getManagedDocument(documentId: string, options?: RequestOptions): Promise<ManagedDocumentResponse>;
+    updateDocumentSection(documentId: string, params: DocumentUpdateSectionParams, options?: RequestOptions): Promise<ManagedDocumentResponse>;
+    performDocumentWorkflow(documentId: string, params: DocumentWorkflowActionParams, options?: RequestOptions): Promise<ManagedDocumentResponse>;
+    deleteManagedDocument(documentId: string, options?: RequestOptions): Promise<void>;
+    generateDocumentSection(documentId: string, params: DocumentGenerateSectionParams, options?: RequestOptions): Promise<DocumentGenerateResponse>;
 }
 //# sourceMappingURL=client.d.ts.map