@criticalbridge/brain-client 1.0.0

package/dist/client.js

@@ -0,0 +1,1197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrainAPIClient = exports.INSURANCE_COMPLIANCE_COLLECTIONS = exports.HEALTHCARE_COMPLIANCE_COLLECTIONS = exports.ENTITY_ADMIN_CONFIG_KINDS = void 0;
+exports.createBrainClient = createBrainClient;
+const auth_1 = require("./auth");
+const errors_1 = require("./errors");
+const object_store_types_1 = require("./types/object-store.types");
+const API_PATH_PREFIX = '/api/brain';
+exports.ENTITY_ADMIN_CONFIG_KINDS = ['sso', 'ldap', 'log-streaming', 'rules-engine'];
+exports.HEALTHCARE_COMPLIANCE_COLLECTIONS = [
+    'access-log',
+    'consents',
+    'relationships',
+    'purpose-permissions',
+    'hipaa-checklist',
+];
+exports.INSURANCE_COMPLIANCE_COLLECTIONS = [
+    'user-tiers',
+    'claims',
+    'siu-investigations',
+    'underwriting',
+    'regulatory-status',
+    'policyholders',
+];
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+class BrainAPIClient {
+    baseUrl;
+    entityId;
+    apiKey;
+    getAccessToken;
+    fetchImpl;
+    requestTimeoutMs;
+    constructor(config) {
+        if (!config.baseUrl) {
+            throw new Error('BrainAPIClient: baseUrl is required');
+        }
+        if (!config.entityId) {
+            throw new Error('BrainAPIClient: entityId is required');
+        }
+        this.baseUrl = config.baseUrl.replace(/\/+$/, '');
+        this.entityId = config.entityId;
+        this.apiKey = config.apiKey;
+        this.getAccessToken = config.getAccessToken;
+        this.fetchImpl = config.fetchImpl ?? defaultFetch();
+        this.requestTimeoutMs = config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    }
+    getEntityId() {
+        return this.entityId;
+    }
+    async getEntityInfo() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/info`);
+    }
+    async registerAgent(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async resolveTenant() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/resolve-tenant`, { method: 'POST' });
+    }
+    async getMyRbacRoles() {
+        return this.request('/rbac/my-roles');
+    }
+    async getUserRbacRoles(userId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/rbac/users/${encodeURIComponent(userId)}/roles`);
+    }
+    async assignRbacRole(userId, roleName) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/rbac/users/${encodeURIComponent(userId)}/roles`, { method: 'POST', body: JSON.stringify({ roleName }) });
+    }
+    async removeRbacRole(userId, roleName) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/rbac/users/${encodeURIComponent(userId)}/roles/${encodeURIComponent(roleName)}`, { method: 'DELETE' });
+    }
+    async createDelegation(userId, roleName, expiresAt) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/rbac/users/${encodeURIComponent(userId)}/delegations`, { method: 'POST', body: JSON.stringify({ roleName, expiresAt }) });
+    }
+    async revokeDelegation(userId, roleName) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/rbac/users/${encodeURIComponent(userId)}/delegations/${encodeURIComponent(roleName)}`, { method: 'DELETE' });
+    }
+    async getDelegations(userId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/rbac/users/${encodeURIComponent(userId)}/delegations`);
+    }
+    async grantSuperUser(userId, body) {
+        return this.request(`/rbac/super-users/${encodeURIComponent(userId)}`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async revokeSuperUser(userId, reason) {
+        await this.request(`/rbac/super-users/${encodeURIComponent(userId)}`, {
+            method: 'DELETE',
+            body: JSON.stringify({ reason }),
+        });
+    }
+    async listSuperUsers() {
+        return this.request('/rbac/super-users');
+    }
+    async getSelfSuperUserAccess() {
+        return this.request('/rbac/super-users/me');
+    }
+    async getUserEntities() {
+        const { roles } = await this.getMyRbacRoles();
+        return roles;
+    }
+    async getEntityMetadata() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/rbac/entity-metadata`);
+    }
+    async bootstrapRbacLogin() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/rbac/bootstrap-login`, { method: 'POST' });
+    }
+    async getAgent(agentId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}`);
+    }
+    async getDriftDashboard() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/drift/dashboard`);
+    }
+    async deleteAgent(agentId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}`, { method: 'DELETE' });
+    }
+    async updateAgent(agentId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}`, {
+            method: 'PATCH',
+            body: JSON.stringify(body.patch),
+        });
+    }
+    async listAgents(params) {
+        const url = params?.stages
+            ? `/entities/${encodeURIComponent(this.entityId)}/agents?stages=${encodeURIComponent(params.stages.join(','))}`
+            : `/entities/${encodeURIComponent(this.entityId)}/agents`;
+        return this.request(url);
+    }
+    async listUsers() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/users`);
+    }
+    async assignAgent(agentId, params) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/assign`, {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
+    async unassignAgent(agentId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/assign`, { method: 'DELETE' });
+    }
+    async getAgentAssignment(agentId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/assignment`);
+    }
+    async listProcessInstances(params) {
+        const base = `/entities/${encodeURIComponent(this.entityId)}/processes`;
+        const url = params?.status ? `${base}?status=${encodeURIComponent(params.status)}` : base;
+        return this.request(url);
+    }
+    async listEvents(params) {
+        const search = new URLSearchParams();
+        if (typeof params?.limit === 'number' && Number.isFinite(params.limit)) {
+            search.set('limit', String(Math.floor(params.limit)));
+        }
+        if (params?.domainPackId) {
+            search.set('domainPackId', params.domainPackId);
+        }
+        if (params?.eventType) {
+            search.set('eventType', params.eventType);
+        }
+        const qs = search.toString();
+        const base = `/entities/${encodeURIComponent(this.entityId)}/events`;
+        return this.request(qs ? `${base}?${qs}` : base);
+    }
+    async getProcessStages(processId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/processes/${encodeURIComponent(processId)}/stages`);
+    }
+    async advanceStage(processId, stageId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/processes/${encodeURIComponent(processId)}/stages/${encodeURIComponent(stageId)}/decision`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async getDashboardMetrics() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/metrics/summary`);
+    }
+    async getRecentActivity(limit) {
+        const base = `/entities/${encodeURIComponent(this.entityId)}/activity`;
+        const url = typeof limit === 'number' ? `${base}?limit=${limit}` : base;
+        return this.request(url);
+    }
+    async getQueueDepths() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/dashboard/queue-depths`);
+    }
+    async getRecentFailures(opts = {}) {
+        const params = new URLSearchParams();
+        if (opts.limit !== undefined)
+            params.set('limit', String(opts.limit));
+        if (opts.since !== undefined)
+            params.set('since', opts.since);
+        if (opts.agentId !== undefined)
+            params.set('agentId', opts.agentId);
+        const query = params.toString();
+        const suffix = query ? `?${query}` : '';
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/dashboard/failures${suffix}`);
+    }
+    async getRunVolume(opts) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/dashboard/run-volume?window=${opts.window}&bucket=${opts.bucket}`);
+    }
+    async getLatencySeries(opts) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/dashboard/latency?window=${opts.window}&bucket=${opts.bucket}`);
+    }
+    async getTopCapabilities(opts = {}) {
+        const params = new URLSearchParams();
+        if (opts.window)
+            params.set('window', opts.window);
+        if (opts.limit !== undefined)
+            params.set('limit', String(opts.limit));
+        const query = params.toString();
+        const suffix = query ? `?${query}` : '';
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/dashboard/top-capabilities${suffix}`);
+    }
+    async getEntityLicenseUsage() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/licenses`);
+    }
+    async getLicensePool() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/licenses/pool`);
+    }
+    async getSeatLicenses() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/licenses/seats`);
+    }
+    async createSeatLicense(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/licenses/seats`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async updateSeatLicense(seatId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/licenses/seats/${encodeURIComponent(seatId)}`, {
+            method: 'PATCH',
+            body: JSON.stringify(body),
+        });
+    }
+    async deleteSeatLicense(seatId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/licenses/seats/${encodeURIComponent(seatId)}`, { method: 'DELETE' });
+    }
+    async getLicenseUsageHistory(period) {
+        const base = `/entities/${encodeURIComponent(this.entityId)}/licenses/history`;
+        const url = period ? `${base}?${new URLSearchParams({ period }).toString()}` : base;
+        return this.request(url);
+    }
+    async getLicenseAwareUtilization() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/licenses/utilization`);
+    }
+    async listAgentGroups() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/groups`);
+    }
+    async getSeatLicenseUsage(seatLicenseId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/seats/${encodeURIComponent(seatLicenseId)}/license`);
+    }
+    async listDispatches() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/dispatches`);
+    }
+    async getDispatch(dispatchId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/dispatches/${encodeURIComponent(dispatchId)}`);
+    }
+    async cancelDispatch(dispatchId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/dispatch/${encodeURIComponent(dispatchId)}/cancel`, { method: 'POST' });
+    }
+    async listMeshSubscriptionHealth() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/mesh/subscriptions`);
+    }
+    async stopAgent(agentId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/stop`, { method: 'POST' });
+    }
+    async restartAgent(agentId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/restart`, { method: 'POST' });
+    }
+    async dispatch(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/dispatch`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async getAgentWorkItems(agentId, params) {
+        const base = `/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/work-items`;
+        const query = new URLSearchParams();
+        if (typeof params?.limit === 'number') {
+            query.set('limit', String(params.limit));
+        }
+        if (typeof params?.offset === 'number') {
+            query.set('offset', String(params.offset));
+        }
+        const qs = query.toString();
+        return this.request(qs ? `${base}?${qs}` : base);
+    }
+    async enqueueWorkItem(agentId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/work-items/enqueue`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async reassignWorkItem(agentId, workItemId, body = {}) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/work-items/${encodeURIComponent(workItemId)}/reassign`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async listOperatorSignals(params) {
+        const url = params?.since
+            ? `/entities/${encodeURIComponent(this.entityId)}/operator-signals?since=${encodeURIComponent(params.since)}`
+            : `/entities/${encodeURIComponent(this.entityId)}/operator-signals`;
+        return this.request(url);
+    }
+    async getSystemHealth() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/system-health`);
+    }
+    async getPolicyCatalog() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/policies`);
+    }
+    async getAgentPolicyHistory(agentId, params) {
+        const base = `/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/policy-history`;
+        const url = params?.window ? `${base}?window=${encodeURIComponent(params.window)}` : base;
+        return this.request(url);
+    }
+    async listControlProfiles() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/control-profiles`);
+    }
+    async getControlProfile(tier) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/control-profiles/${encodeURIComponent(tier)}`);
+    }
+    async getControlProfileAudit(tier, opts = {}) {
+        const query = [];
+        if (opts.limit !== undefined)
+            query.push(`limit=${String(opts.limit)}`);
+        if (opts.offset !== undefined)
+            query.push(`offset=${String(opts.offset)}`);
+        const qs = query.length > 0 ? `?${query.join('&')}` : '';
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/control-profiles/${encodeURIComponent(tier)}/audit${qs}`);
+    }
+    async setControlProfileOverride(tier, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/control-profiles/${encodeURIComponent(tier)}`, { method: 'PUT', body: JSON.stringify(body) });
+    }
+    async clearControlProfileOverride(tier, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/control-profiles/${encodeURIComponent(tier)}`, { method: 'DELETE', body: JSON.stringify(body) });
+    }
+    async listChangeApprovalPolicies() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/change-approval/policies`);
+    }
+    async getChangeApprovalPolicy(tier) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/change-approval/policies/${encodeURIComponent(tier)}`);
+    }
+    async getChangeApprovalPolicyAudit(tier) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/change-approval/policies/${encodeURIComponent(tier)}/audit`);
+    }
+    async setChangeApprovalPolicyOverride(tier, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/change-approval/policies/${encodeURIComponent(tier)}`, { method: 'PUT', body: JSON.stringify(body) });
+    }
+    async clearChangeApprovalPolicyOverride(tier, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/change-approval/policies/${encodeURIComponent(tier)}`, { method: 'DELETE', body: JSON.stringify(body) });
+    }
+    async recordChangeApprovalDecision(changeId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/change-approval/changes/${encodeURIComponent(changeId)}/decisions`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async listChangeApprovalDecisions(changeId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/change-approval/changes/${encodeURIComponent(changeId)}/decisions`);
+    }
+    async getChangeApprovalVerdict(changeId, tier) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/change-approval/changes/${encodeURIComponent(changeId)}/verdict?tier=${encodeURIComponent(tier)}`);
+    }
+    async wizardAssistantTurn(agentId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/wizard-assistant/turn`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async transitionLifecycle(entityKind, targetId, body) {
+        const segment = entityKind === 'agent' ? 'agents' : 'skills';
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/${segment}/${encodeURIComponent(targetId)}/lifecycle/transition`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async getLifecycleStatus(entityKind, targetId) {
+        const segment = entityKind === 'agent' ? 'agents' : 'skills';
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/${segment}/${encodeURIComponent(targetId)}/lifecycle/status`);
+    }
+    async classifyAgent(agentId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/risk-classification`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async getEffectiveControlProfile(agentId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/agents/${encodeURIComponent(agentId)}/effective-control-profile`, { method: 'GET' });
+    }
+    async getBiasThresholdPolicy() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/bias-threshold-policy`, { method: 'GET' });
+    }
+    async updateBiasThresholdPolicy(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/bias-threshold-policy`, { method: 'PUT', body: JSON.stringify(body) });
+    }
+    async getWorkAssignmentEvents(params) {
+        const base = `/entities/${encodeURIComponent(this.entityId)}/work-assignments/events`;
+        const query = new URLSearchParams();
+        if (params?.agentId)
+            query.set('agentId', params.agentId);
+        if (params?.userSub)
+            query.set('userSub', params.userSub);
+        if (params?.workItemId)
+            query.set('workItemId', params.workItemId);
+        if (params?.since)
+            query.set('since', params.since);
+        if (typeof params?.limit === 'number')
+            query.set('limit', String(params.limit));
+        const qs = query.toString();
+        return this.request(qs ? `${base}?${qs}` : base);
+    }
+    async getDecisionLineage(signalId) {
+        if (!signalId) {
+            throw new Error('BrainAPIClient.getDecisionLineage: signalId is required');
+        }
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/signals/${encodeURIComponent(signalId)}/decision-lineage`);
+    }
+    async recordDecisionLineage(signalId, body) {
+        if (!signalId) {
+            throw new Error('BrainAPIClient.recordDecisionLineage: signalId is required');
+        }
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/signals/${encodeURIComponent(signalId)}/decision-lineage`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async listDecisionLineage(params) {
+        const base = `/entities/${encodeURIComponent(this.entityId)}/decision-lineage`;
+        const query = new URLSearchParams();
+        if (params?.decisionId)
+            query.set('decisionId', params.decisionId);
+        if (params?.consumerRef)
+            query.set('consumerRef', params.consumerRef);
+        if (params?.skill)
+            query.set('skill', params.skill);
+        if (params?.skillVersion)
+            query.set('skillVersion', params.skillVersion);
+        if (params?.modelProvider)
+            query.set('modelProvider', params.modelProvider);
+        if (params?.modelName)
+            query.set('modelName', params.modelName);
+        if (params?.riskTier)
+            query.set('riskTier', params.riskTier);
+        if (params?.consumerImpacting !== undefined) {
+            query.set('consumerImpacting', String(params.consumerImpacting));
+        }
+        if (params?.hitlApprovalRequired !== undefined) {
+            query.set('hitlApprovalRequired', String(params.hitlApprovalRequired));
+        }
+        if (params?.startDate)
+            query.set('from', params.startDate);
+        if (params?.endDate)
+            query.set('to', params.endDate);
+        if (typeof params?.limit === 'number')
+            query.set('limit', String(params.limit));
+        if (typeof params?.offset === 'number')
+            query.set('offset', String(params.offset));
+        const qs = query.toString();
+        return this.request(qs ? `${base}?${qs}` : base);
+    }
+    async listEntityPipelines() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/pipelines`);
+    }
+    async listPipelineRuns(pipelineId, options = {}) {
+        if (!pipelineId) {
+            throw new Error('BrainAPIClient.listPipelineRuns: pipelineId is required');
+        }
+        const params = new URLSearchParams();
+        if (options.limit !== undefined) {
+            params.set('limit', String(options.limit));
+        }
+        const query = params.toString();
+        const suffix = query ? `?${query}` : '';
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/pipelines/${encodeURIComponent(pipelineId)}/runs${suffix}`);
+    }
+    async deletePipeline(pipelineId) {
+        if (!pipelineId) {
+            throw new Error('BrainAPIClient.deletePipeline: pipelineId is required');
+        }
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/pipelines/${encodeURIComponent(pipelineId)}`, { method: 'DELETE' });
+    }
+    async listIncidents(filter) {
+        const base = `/entities/${encodeURIComponent(this.entityId)}/incidents`;
+        const query = new URLSearchParams();
+        if (filter?.status)
+            query.set('status', filter.status);
+        if (filter?.severity)
+            query.set('severity', filter.severity);
+        if (filter?.triggerType)
+            query.set('triggerType', filter.triggerType);
+        if (filter?.agentId)
+            query.set('agentId', filter.agentId);
+        const qs = query.toString();
+        return this.request(qs ? `${base}?${qs}` : base);
+    }
+    async getIncident(incidentId) {
+        if (!incidentId) {
+            throw new Error('BrainAPIClient.getIncident: incidentId is required');
+        }
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/incidents/${encodeURIComponent(incidentId)}`);
+    }
+    async createIncident(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/incidents`, {
+            method: 'POST',
+            body: JSON.stringify({ ...body, entityId: this.entityId }),
+        });
+    }
+    async ackIncident(incidentId, body) {
+        if (!incidentId) {
+            throw new Error('BrainAPIClient.ackIncident: incidentId is required');
+        }
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/incidents/${encodeURIComponent(incidentId)}/ack`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async assignIncident(incidentId, body) {
+        if (!incidentId) {
+            throw new Error('BrainAPIClient.assignIncident: incidentId is required');
+        }
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/incidents/${encodeURIComponent(incidentId)}/assign`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async resolveIncident(incidentId, body) {
+        if (!incidentId) {
+            throw new Error('BrainAPIClient.resolveIncident: incidentId is required');
+        }
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/incidents/${encodeURIComponent(incidentId)}/resolve`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async listA2AVendors() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/a2a/vendors`);
+    }
+    async registerA2AVendor(req) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/a2a/vendors`, {
+            method: 'POST',
+            body: JSON.stringify(req),
+        });
+    }
+    async suspendA2AVendor(vendor) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/a2a/vendors/${encodeURIComponent(vendor)}`, { method: 'DELETE' });
+    }
+    async getProvenanceMix() {
+        const response = await this.listA2AVendors();
+        return response.provenanceMix;
+    }
+    async listA2AAgents() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/a2a/agents`);
+    }
+    async listConnections() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/connections`);
+    }
+    async getConnection(connectionId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/connections/${encodeURIComponent(connectionId)}`);
+    }
+    async createConnection(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/connections`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async updateConnection(connectionId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/connections/${encodeURIComponent(connectionId)}`, { method: 'PUT', body: JSON.stringify(body) });
+    }
+    async deleteConnection(connectionId) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/connections/${encodeURIComponent(connectionId)}`, { method: 'DELETE' });
+    }
+    async putCredential(connectionId, secret) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/credentials/${encodeURIComponent(connectionId)}`, { method: 'PUT', body: JSON.stringify(secret) });
+    }
+    async deleteCredential(connectionId) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/credentials/${encodeURIComponent(connectionId)}`, { method: 'DELETE' });
+    }
+    async mintScopedCredential(connectionId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/credentials/${encodeURIComponent(connectionId)}/mint-scoped`, { method: 'POST' });
+    }
+    async persistRefreshedCredential(connectionId, refreshedCredential) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/credentials/${encodeURIComponent(connectionId)}/refresh`, {
+            method: 'POST',
+            body: JSON.stringify(refreshedCredential),
+        });
+    }
+    async introspectListTables(connectionId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/introspect/list-tables`, { method: 'POST', body: JSON.stringify({ connectionId }) });
+    }
+    async introspectTable(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/introspect/introspect-table`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async introspectSampleValues(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/introspect/sample-values`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async listSourceDefinitions() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/source-mappings/sources`);
+    }
+    async getSourceDefinition(sourceId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/source-mappings/sources/${encodeURIComponent(sourceId)}`);
+    }
+    async putSourceDefinition(sourceId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/source-mappings/sources/${encodeURIComponent(sourceId)}`, { method: 'PUT', body: JSON.stringify(body) });
+    }
+    async deleteSourceDefinition(sourceId) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/source-mappings/sources/${encodeURIComponent(sourceId)}`, { method: 'DELETE' });
+    }
+    async listMappingConfigs() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/source-mappings/configs`);
+    }
+    async getMappingConfig(configId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/source-mappings/configs/${encodeURIComponent(configId)}`);
+    }
+    async putMappingConfig(configId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/source-mappings/configs/${encodeURIComponent(configId)}`, { method: 'PUT', body: JSON.stringify(body) });
+    }
+    async deleteMappingConfig(configId) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/source-mappings/configs/${encodeURIComponent(configId)}`, { method: 'DELETE' });
+    }
+    async listEntityModels() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-models`);
+    }
+    async getEntityModel(modelId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-models/${encodeURIComponent(modelId)}`);
+    }
+    async upsertEntityModelType(modelId, entityType) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-models/${encodeURIComponent(modelId)}/entity-types`, { method: 'POST', body: JSON.stringify(entityType) });
+    }
+    async deleteEntityModelType(modelId, entityTypeId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-models/${encodeURIComponent(modelId)}/entity-types/${encodeURIComponent(entityTypeId)}`, { method: 'DELETE' });
+    }
+    async upsertEntityModelRelationship(modelId, relationship) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-models/${encodeURIComponent(modelId)}/relationships`, { method: 'POST', body: JSON.stringify(relationship) });
+    }
+    async deleteEntityModelRelationship(modelId, relationshipId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-models/${encodeURIComponent(modelId)}/relationships/${encodeURIComponent(relationshipId)}`, { method: 'DELETE' });
+    }
+    async aiKnowledge(op, body) {
+        const res = await this.request(`/entities/${encodeURIComponent(this.entityId)}/ai-knowledge/${op}`, { method: 'POST', body: JSON.stringify(body) });
+        return res.result;
+    }
+    aiSimilarWorkflows(body) {
+        return this.aiKnowledge('similar-workflows', body);
+    }
+    aiSuggestNextNodes(body) {
+        return this.aiKnowledge('suggest-next-nodes', body);
+    }
+    aiParameterSuggestions(body) {
+        return this.aiKnowledge('parameter-suggestions', body);
+    }
+    aiSmartDefaults(body) {
+        return this.aiKnowledge('smart-defaults', body);
+    }
+    aiScoreQuality(body) {
+        return this.aiKnowledge('score-quality', body);
+    }
+    async aiLearnFromImport(body) {
+        await this.aiKnowledge('learn-from-import', body);
+    }
+    async aiRecordNodeUsage(body) {
+        await this.aiKnowledge('record-node-usage', body);
+    }
+    async bestPracticesKg(op, body) {
+        const res = await this.request(`/entities/${encodeURIComponent(this.entityId)}/best-practices-kg/${op}`, { method: 'POST', body: JSON.stringify(body) });
+        return res.result;
+    }
+    bpkgStatistics() {
+        return this.bestPracticesKg('statistics', {});
+    }
+    bpkgTraverse(body) {
+        return this.bestPracticesKg('traverse', body);
+    }
+    bpkgRelationshipsForPractice(body) {
+        return this.bestPracticesKg('relationships-for-practice', body);
+    }
+    bpkgRecommendations(body) {
+        return this.bestPracticesKg('recommendations', body);
+    }
+    bpkgShortestPath(body) {
+        return this.bestPracticesKg('shortest-path', body);
+    }
+    bpkgDetectConflicts(body) {
+        return this.bestPracticesKg('detect-conflicts', body);
+    }
+    async kbKg(op, body) {
+        const res = await this.request(`/entities/${encodeURIComponent(this.entityId)}/kb-kg/${op}`, { method: 'POST', body: JSON.stringify(body) });
+        return res.result;
+    }
+    kbKgFindRelated(body) {
+        return this.kbKg('find-related', body);
+    }
+    kbKgFindByEntity(body) {
+        return this.kbKg('find-by-entity', body);
+    }
+    kbKgStatistics() {
+        return this.kbKg('statistics', {});
+    }
+    async entityKg(op, body) {
+        const res = await this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-kg/${op}`, { method: 'POST', body: JSON.stringify(body) });
+        return res.result;
+    }
+    entityKgHealthCheck() {
+        return this.entityKg('health-check', {});
+    }
+    entityKgStatistics() {
+        return this.entityKg('statistics', {});
+    }
+    entityKgGetEntity(body) {
+        return this.entityKg('get-entity', body);
+    }
+    entityKgFindEntities(body) {
+        return this.entityKg('find-entities', body);
+    }
+    entityKgSearchEntities(body) {
+        return this.entityKg('search-entities', body);
+    }
+    entityKgGetEntityRelationships(body) {
+        return this.entityKg('get-entity-relationships', body);
+    }
+    entityKgRelationshipsByEntityIds(body) {
+        return this.entityKg('relationships-by-entity-ids', body);
+    }
+    entityKgTraverse(body) {
+        return this.entityKg('traverse', body);
+    }
+    entityKgFindPath(body) {
+        return this.entityKg('find-path', body);
+    }
+    async entityKgRawReadQuery(body) {
+        const res = await this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-kg/raw-read-query`, { method: 'POST', body: JSON.stringify(body) });
+        return res.rows;
+    }
+    async listEntityModelSources() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-model-sources/sources`);
+    }
+    async getEntityModelSource(sourceId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-model-sources/sources/${encodeURIComponent(sourceId)}`);
+    }
+    async createEntityModelSource(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-model-sources/sources`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async updateEntityModelSource(sourceId, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-model-sources/sources/${encodeURIComponent(sourceId)}`, { method: 'PUT', body: JSON.stringify(body) });
+    }
+    async deleteEntityModelSource(sourceId) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-model-sources/sources/${encodeURIComponent(sourceId)}`, { method: 'DELETE' });
+    }
+    async syncEntityModelSource(sourceId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-model-sources/sources/${encodeURIComponent(sourceId)}/sync`, { method: 'POST' });
+    }
+    async checkEntityModelSourceReferences(sourceId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-model-sources/sources/${encodeURIComponent(sourceId)}/references`);
+    }
+    async discoverEntityModelSourceEntities(sourceId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-model-sources/sources/${encodeURIComponent(sourceId)}/discover-entities`, { method: 'POST' });
+    }
+    async testEntityModelSourceConnection(sourceId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/entity-model-sources/sources/${encodeURIComponent(sourceId)}/test-connection`, { method: 'POST' });
+    }
+    async triggerDocumentIngestion(input) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/document-ingestion`, { method: 'POST', body: JSON.stringify(input) });
+    }
+    async getDocumentIngestionStatus(jobId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/document-ingestion/${encodeURIComponent(jobId)}`);
+    }
+    async appendDomainEvent(event) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/event-log`, { method: 'POST', body: JSON.stringify(event) });
+    }
+    async appendDomainEventBatch(events) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/event-log/batch`, { method: 'POST', body: JSON.stringify({ events }) });
+    }
+    async getDomainEvent(eventId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/event-log/${encodeURIComponent(eventId)}`);
+    }
+    objectsPath(objectPath) {
+        const encoded = objectPath
+            .split('/')
+            .map((seg) => encodeURIComponent(seg))
+            .join('/');
+        return `/entities/${encodeURIComponent(this.entityId)}/objects/${encoded}`;
+    }
+    async getObject(bucket, objectPath) {
+        const response = await this.rawFetch(this.objectsPath(objectPath), {
+            method: 'GET',
+            headers: { [object_store_types_1.OBJECT_BUCKET_HEADER]: bucket },
+        });
+        const data = Buffer.from(await response.arrayBuffer());
+        return {
+            data,
+            contentType: response.headers.get('content-type') ?? 'application/octet-stream',
+        };
+    }
+    async putObject(bucket, objectPath, data, opts) {
+        const headers = {
+            [object_store_types_1.OBJECT_BUCKET_HEADER]: bucket,
+            'Content-Type': opts?.contentType ?? 'application/octet-stream',
+        };
+        if (opts?.cacheControl)
+            headers['Cache-Control'] = opts.cacheControl;
+        if (opts?.ifNotExists)
+            headers['If-None-Match'] = '*';
+        await this.rawFetch(this.objectsPath(objectPath), {
+            method: 'PUT',
+            headers,
+            body: Buffer.from(data),
+        });
+    }
+    async deleteObject(bucket, objectPath) {
+        await this.rawFetch(this.objectsPath(objectPath), {
+            method: 'DELETE',
+            headers: { [object_store_types_1.OBJECT_BUCKET_HEADER]: bucket },
+        });
+    }
+    async headObject(bucket, objectPath) {
+        const response = await this.rawFetch(this.objectsPath(objectPath), {
+            method: 'HEAD',
+            headers: { [object_store_types_1.OBJECT_BUCKET_HEADER]: bucket },
+        });
+        const sizeHeader = response.headers.get('x-object-size') ?? response.headers.get('content-length');
+        return {
+            size: Number(sizeHeader ?? '0'),
+            updated: response.headers.get('x-object-updated') ?? new Date(0).toISOString(),
+            checksum: response.headers.get('x-object-checksum') ?? '',
+            contentType: response.headers.get('content-type') ?? undefined,
+        };
+    }
+    async listObjects(bucket, prefix) {
+        return this.request(`${this.objectsPath(prefix)}?list=1`, {
+            method: 'GET',
+            headers: { [object_store_types_1.OBJECT_BUCKET_HEADER]: bucket },
+        });
+    }
+    async signObjectUrl(bucket, body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/objects:sign`, { method: 'POST', headers: { [object_store_types_1.OBJECT_BUCKET_HEADER]: bucket }, body: JSON.stringify(body) });
+    }
+    async rawFetch(endpoint, init = {}) {
+        const url = `${this.baseUrl}${API_PATH_PREFIX}${endpoint}`;
+        const headers = new Headers(init.headers);
+        const authHeader = await (0, auth_1.resolveAuthorizationHeader)(this.getAccessToken);
+        if (authHeader) {
+            headers.set('Authorization', authHeader);
+        }
+        else if (this.apiKey) {
+            headers.set('X-API-Key', this.apiKey);
+        }
+        const controller = new AbortController();
+        const callerSignal = init.signal;
+        if (callerSignal) {
+            if (callerSignal.aborted) {
+                controller.abort(callerSignal.reason);
+            }
+            else {
+                callerSignal.addEventListener('abort', () => controller.abort(callerSignal.reason));
+            }
+        }
+        let timeoutHandle;
+        if (this.requestTimeoutMs > 0) {
+            timeoutHandle = setTimeout(() => controller.abort(new Error('request-timeout')), this.requestTimeoutMs);
+        }
+        let response;
+        try {
+            response = await this.fetchImpl(url, { ...init, headers, signal: controller.signal });
+        }
+        catch (err) {
+            const errAsObj = err;
+            const errName = typeof errAsObj?.name === 'string' ? errAsObj.name : '';
+            const errMessage = typeof errAsObj?.message === 'string' ? errAsObj.message : '';
+            const isAbort = errName === 'AbortError' || /aborted|abort/i.test(errMessage);
+            if (isAbort && (!callerSignal || !callerSignal.aborted)) {
+                throw new errors_1.BrainAPIError({
+                    status: 408,
+                    url,
+                    method: init.method ?? 'GET',
+                    body: { error: `Request timed out after ${this.requestTimeoutMs}ms` },
+                    message: `Brain API request timed out after ${this.requestTimeoutMs}ms: ${init.method ?? 'GET'} ${url}`,
+                });
+            }
+            throw err;
+        }
+        finally {
+            if (timeoutHandle !== undefined) {
+                clearTimeout(timeoutHandle);
+            }
+        }
+        if (!response.ok) {
+            let body;
+            try {
+                body = await response.json();
+            }
+            catch {
+                body = undefined;
+            }
+            throw new errors_1.BrainAPIError({
+                status: response.status,
+                url,
+                method: init.method ?? 'GET',
+                body,
+            });
+        }
+        return response;
+    }
+    async getEntityAdminConfig(kind) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/admin-config/${encodeURIComponent(kind)}`);
+    }
+    async putEntityAdminConfig(kind, config) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/admin-config/${encodeURIComponent(kind)}`, { method: 'PUT', body: JSON.stringify(config) });
+    }
+    async getExternalSecretsConfig() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/external-secrets`);
+    }
+    async putExternalSecretsConfig(config) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/external-secrets`, {
+            method: 'PUT',
+            body: JSON.stringify(config),
+        });
+    }
+    async testExternalSecretsProvider(providerId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/external-secrets/` +
+            `${encodeURIComponent(providerId)}/test`, { method: 'POST', body: JSON.stringify({}) });
+    }
+    async rotateExternalSecretsProvider(providerId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/external-secrets/` +
+            `${encodeURIComponent(providerId)}/rotate`, { method: 'POST', body: JSON.stringify({}) });
+    }
+    async getExternalAdapterConfig() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/external-adapter-config`);
+    }
+    async putExternalAdapterConfig(config) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/external-adapter-config`, {
+            method: 'PUT',
+            body: JSON.stringify(config),
+        });
+    }
+    async getFieldSecurityPolicies() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/field-security/policies`);
+    }
+    async putFieldSecurityPolicies(config) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/field-security/policies`, {
+            method: 'PUT',
+            body: JSON.stringify(config),
+        });
+    }
+    async applyFieldSecurityPolicyChange(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/field-security/policies/actions/change`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    healthcarePath(suffix) {
+        return `/entities/${encodeURIComponent(this.entityId)}/compliance/healthcare${suffix}`;
+    }
+    async getHealthcareComplianceCollection(collection) {
+        return this.request(this.healthcarePath(`/${collection}`));
+    }
+    async accessHealthcarePHI(request) {
+        return this.request(this.healthcarePath('/phi-access'), {
+            method: 'POST',
+            body: JSON.stringify(request),
+        });
+    }
+    async createHealthcareRelationship(params) {
+        return this.request(this.healthcarePath('/relationships'), {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
+    async toggleHealthcareRelationship(relationshipId, active) {
+        await this.request(this.healthcarePath(`/relationships/${encodeURIComponent(relationshipId)}/toggle`), {
+            method: 'POST',
+            body: JSON.stringify({ active }),
+        });
+    }
+    async revokeHealthcareConsent(consentId) {
+        await this.request(this.healthcarePath(`/consents/${encodeURIComponent(consentId)}/revoke`), {
+            method: 'POST',
+            body: JSON.stringify({}),
+        });
+    }
+    async grantHealthcarePurpose(params) {
+        return this.request(this.healthcarePath('/purpose-permissions'), {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
+    async revokeHealthcarePurpose(permissionId) {
+        await this.request(this.healthcarePath(`/purpose-permissions/${encodeURIComponent(permissionId)}/revoke`), { method: 'POST', body: JSON.stringify({}) });
+    }
+    async getFinanceComplianceDoc() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/finance`);
+    }
+    async putFinanceComplianceDoc(config) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/finance`, {
+            method: 'PUT',
+            body: JSON.stringify(config),
+        });
+    }
+    async getComplianceSettings() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/settings`);
+    }
+    async putComplianceSettings(config, opts = {}) {
+        const res = await this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/settings`, {
+            method: 'PUT',
+            ...(opts.ifGenerationMatch !== undefined
+                ? { headers: { 'If-Match': String(opts.ifGenerationMatch) } }
+                : {}),
+            body: JSON.stringify(config),
+        });
+        return { generation: res.generation };
+    }
+    async financeAccessPCI(request) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/finance/access-pci`, { method: 'POST', body: JSON.stringify(request) });
+    }
+    async insuranceAccessPolicyholder(request) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/insurance/access-policyholder`, { method: 'POST', body: JSON.stringify(request) });
+    }
+    async getComplianceAuditLogs(query = {}) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined)
+                params.set(key, String(value));
+        }
+        const qs = params.toString();
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/audit/logs${qs ? `?${qs}` : ''}`);
+    }
+    async putComplianceAuditLog(doc) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/audit/logs`, {
+            method: 'PUT',
+            body: JSON.stringify(doc),
+        });
+    }
+    async verifyComplianceAuditChain() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/audit/verify-chain`);
+    }
+    async exportComplianceAuditCsv(query = {}) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined)
+                params.set(key, String(value));
+        }
+        const qs = params.toString();
+        return this.rawFetch(`/entities/${encodeURIComponent(this.entityId)}/compliance/audit/export.csv${qs ? `?${qs}` : ''}`, { method: 'GET' });
+    }
+    async getComplianceDashboardOverview() {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/dashboard/overview`);
+    }
+    async putComplianceDashboardOverview(config) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/dashboard/overview`, { method: 'PUT', body: JSON.stringify(config) });
+    }
+    async financeAccessSOX(request) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/finance/access-sox`, { method: 'POST', body: JSON.stringify(request) });
+    }
+    async financeVerifySoD(request) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/finance/verify-sod`, { method: 'POST', body: JSON.stringify(request) });
+    }
+    async getInsuranceComplianceDoc(collection) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/insurance/` +
+            encodeURIComponent(collection));
+    }
+    async putInsuranceComplianceDoc(collection, config, opts) {
+        await this.request(`/entities/${encodeURIComponent(this.entityId)}/compliance/insurance/` +
+            encodeURIComponent(collection), {
+            method: 'PUT',
+            body: JSON.stringify(config),
+            ...(opts?.ifGenerationMatch !== undefined
+                ? { headers: { 'If-Match': String(opts.ifGenerationMatch) } }
+                : {}),
+        });
+    }
+    async requestBreakGlassAccess(body) {
+        return this.request(`${this.breakGlassBase()}/grants`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async getActiveBreakGlassGrants() {
+        return this.request(`${this.breakGlassBase()}/grants/active`);
+    }
+    async getBreakGlassPendingReviews() {
+        return this.request(`${this.breakGlassBase()}/grants/pending-reviews`);
+    }
+    async revokeBreakGlassGrant(grantId, revokedBy) {
+        await this.request(`${this.breakGlassBase()}/grants/${encodeURIComponent(grantId)}/revoke`, {
+            method: 'POST',
+            body: JSON.stringify(revokedBy === undefined ? {} : { revokedBy }),
+        });
+    }
+    async approveBreakGlassPostHoc(grantId, body) {
+        await this.request(`${this.breakGlassBase()}/grants/${encodeURIComponent(grantId)}/approve-post-hoc`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async recordIntegrityHash(body) {
+        return this.request(`${this.breakGlassBase()}/integrity/hashes`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async getRecordIntegrityHash(recordType, recordId) {
+        return this.request(`${this.breakGlassBase()}/integrity/${encodeURIComponent(recordType)}/${encodeURIComponent(recordId)}/hash`);
+    }
+    async verifyRecordIntegrity(body) {
+        return this.request(`${this.breakGlassBase()}/integrity/verify-record`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    async verifyRecordIntegrityChain(body) {
+        return this.request(`${this.breakGlassBase()}/integrity/verify-chain`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    breakGlassBase() {
+        return `/entities/${encodeURIComponent(this.entityId)}/compliance/break-glass`;
+    }
+    async getRulesEngineConfig() {
+        return this.getEntityAdminConfig('rules-engine');
+    }
+    async putRulesEngineConfig(config) {
+        await this.putEntityAdminConfig('rules-engine', config);
+    }
+    async triggerRulesEngineConnectionTest(opts) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/admin-config/rules-engine/test-connection`, {
+            method: 'POST',
+            body: JSON.stringify({ connectionId: opts.connectionId }),
+        });
+    }
+    async createSSOProvider(body) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/admin-config/sso/providers`, { method: 'POST', body: JSON.stringify(body) });
+    }
+    async updateSSOProvider(providerId, patch) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/admin-config/sso/providers/${encodeURIComponent(providerId)}`, { method: 'PUT', body: JSON.stringify(patch) });
+    }
+    async deleteSSOProvider(providerId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/admin-config/sso/providers/${encodeURIComponent(providerId)}`, { method: 'DELETE' });
+    }
+    async getLdapConfig() {
+        return this.getEntityAdminConfig('ldap');
+    }
+    async putLdapConfig(config) {
+        await this.putEntityAdminConfig('ldap', config);
+    }
+    async triggerLdapSync(opts) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/admin-config/ldap/sync`, {
+            method: 'POST',
+            body: JSON.stringify({ syncType: opts?.syncType ?? 'manual' }),
+        });
+    }
+    async getLogStreamingConfig() {
+        return this.getEntityAdminConfig('log-streaming');
+    }
+    async putLogStreamingConfig(config) {
+        await this.putEntityAdminConfig('log-streaming', config);
+    }
+    async testLogStreamingDestination(destinationId) {
+        return this.request(`/entities/${encodeURIComponent(this.entityId)}/admin-config/log-streaming/test`, {
+            method: 'POST',
+            body: JSON.stringify({ destinationId }),
+        });
+    }
+    async getLicensePlatformDoc(subPath) {
+        return this.request(`/platform-config/license/${subPath}`);
+    }
+    async putLicensePlatformDoc(subPath, config) {
+        await this.request(`/platform-config/license/${subPath}`, {
+            method: 'PUT',
+            body: JSON.stringify(config),
+        });
+    }
+    async listLicenseTierHistory(tier, limit) {
+        return this.request(`/platform-config/license/tiers/${encodeURIComponent(tier)}/history?limit=${limit}`);
+    }
+    async appendLicenseTierHistory(tier, entry) {
+        await this.request(`/platform-config/license/tiers/${encodeURIComponent(tier)}/history`, {
+            method: 'POST',
+            body: JSON.stringify(entry),
+        });
+    }
+    async getAdminSecret(key) {
+        return this.request(`/platform-config/admin-secrets/${encodeURIComponent(key)}`);
+    }
+    async putAdminSecret(key, config) {
+        await this.request(`/platform-config/admin-secrets/${encodeURIComponent(key)}`, {
+            method: 'PUT',
+            body: JSON.stringify(config),
+        });
+    }
+    async request(endpoint, init = {}) {
+        const headers = new Headers({
+            'Content-Type': 'application/json',
+            ...init.headers,
+        });
+        const response = await this.rawFetch(endpoint, { ...init, headers });
+        const text = await response.text();
+        if (!text) {
+            return undefined;
+        }
+        return JSON.parse(text);
+    }
+}
+exports.BrainAPIClient = BrainAPIClient;
+function defaultFetch() {
+    if (typeof globalThis.fetch === 'function') {
+        return globalThis.fetch.bind(globalThis);
+    }
+    throw new Error('BrainAPIClient: no global `fetch` available. Pass `config.fetchImpl` ' +
+        "(e.g. `import { fetch } from 'undici'`) — required on Node < 18.");
+}
+function createBrainClient(config) {
+    return new BrainAPIClient(config);
+}
+//# sourceMappingURL=client.js.map