@hsuite/smart-engines-sdk 3.0.2 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 3.2.1 — 2026-05-16
+
+**Documentation-only fix.** No runtime behavior change.
+
+### Fixed
+- `DeploymentClient.init` JSDoc and `BaasInitResponse` type docs no longer
+  describe the registry as DOCR. The runtime arc routes pushes through a
+  per-tenant Harbor project (`hsuite-customers-<appId>`), and the credentials
+  returned in `registry.{server, username, password, repository}` are an
+  ephemeral project-scoped robot account whose secret is single-use and not
+  persisted server-side. README example aligned with the same wording.
+
+## 3.2.0 — undocumented (PR-A → PR-I, 2026-05-12 → 2026-05-13)
+
+Smart-app runtime arc surface — added `DeploymentClient` with the full
+init → push → uploadFrontend → deploy flow plus lifecycle (suspend/
+resume/update/rollback/delete) and ownership-gated metrics. See PRs
+#516 (PR-A), #523 (PR-C), and #530 (PR-H) for details.
+
+## 3.1.0 — undocumented (2026-05-12)
+
+Added `CustomerSessionClient` for NFT-gated customer→smart-app auth (PR #496).
+
+## 3.0.2 — undocumented (2026-05-12)
+
+Dropped `nestjs` re-exports from the root entry to keep tree-shaking clean for
+non-Nest consumers (PR #494).
+
 ## 3.0.0 — 2026-05-11
 
 **First publishable release.**

package/README.md

@@ -52,14 +52,24 @@ await baas.authenticate({
   },
 });
 
-// 4. Register a free_testnet smart-app (no HSUITE deposit on testnet; cluster runs DKG)
-const app = await baas.register({
-  name: 'My Smart App',
+// 4. Initialise a free_testnet smart-app via the four-step deploy flow
+//    (init → docker push → optional uploadFrontend → deploy). `init` runs
+//    the per-entity DKG ceremony on the cluster and returns the DKG entityId
+//    as `appId`, plus ephemeral push credentials for the cluster's per-tenant
+//    Harbor project (single-use secret — not persisted server-side).
+const init = await baas.deployment.init({
+  name: 'my-smart-app',
+  port: 3000,
   services: ['database', 'storage', 'messaging', 'functions'],
 });
 
-console.log(`Registered smart-app ${app.appId} — status: ${app.status}`);
-baas.setAppId(app.appId);
+console.log(`Allocated smart-app ${init.appId}`);
+console.log(`Push to: ${init.registry.server}/${init.registry.repository}:<tag>`);
+baas.setAppId(init.appId);
+
+// (out-of-band) docker login + docker push <init.registry.server>/<init.registry.repository>:v1
+// (optional)    await baas.deployment.uploadFrontend(init.appId, await fs.readFile('./bundle.tar.gz'));
+// (deploy)      await baas.deployment.deploy(init.appId, { tag: 'v1', replicas: 1 });
 ```
 
 **Why XRPL?** Per the Smart Engines V3 architecture, XRPL is canonical for
@@ -166,19 +176,40 @@ await baas.agents.resume(agent.agentId);
 const events = await baas.agents.getEvents(agent.agentId);
 ```
 
-### Deployment
+### Deployment (runtime orchestration — spec §6.1)
+
+The four-step deploy flow: **init → docker push → (optional) uploadFrontend → deploy**.
 
 ```ts
-const deployment = await baas.deployment.create({
-  name: 'My Smart App v2',
+// 1. init — allocate appId via DKG + receive ephemeral Harbor push credentials
+const init = await baas.deployment.init({
+  name: 'my-smart-app',
+  port: 3000,
   services: ['database', 'storage', 'messaging'],
-  config: { /* app-specific */ },
 });
 
+// 2. docker push — out-of-band, using the ephemeral creds returned above
+//    docker login -u <init.registry.username> -p <init.registry.password> <init.registry.server>
+//    docker push <init.registry.server>/<init.registry.repository>:v1
+
+// 3. uploadFrontend — optional SPA tarball (content-addressed, mounted read-only)
+await baas.deployment.uploadFrontend(init.appId, await fs.readFile('./bundle.tar.gz'));
+
+// 4. deploy — reconcile to k8s
+const deployed = await baas.deployment.deploy(init.appId, {
+  tag: 'v1',
+  replicas: 1,
+  env: { NODE_ENV: 'production' },
+});
+console.log(`live at ${deployed.url}`);
+
+// Lifecycle + listing
 const apps = await baas.deployment.list();
-const info = await baas.deployment.get(appId);
-await baas.deployment.suspend(appId);
-await baas.deployment.resume(appId);
+const info = await baas.deployment.get(init.appId);
+const status = await baas.deployment.status(init.appId);
+await baas.deployment.suspend(init.appId);
+await baas.deployment.resume(init.appId);
+await baas.deployment.rollback(init.appId, { toTag: 'v0' });
 ```
 
 ---

package/dist/index.d.ts

@@ -970,6 +970,46 @@ export declare class MirrorNodeError extends Error {
 	statusCode: number;
 	constructor(message: string, statusCode: number);
 }
+export interface ClusterEndpointsView {
+	clusterId: string;
+	gatewayUrl: string;
+	harborUrl?: string;
+	natsUrl?: string;
+	publicIp?: string;
+	region?: string;
+}
+export interface ClusterInfo {
+	clusterId: string;
+	endpoints: ClusterEndpointsView;
+	nodeIds: string[];
+}
+export interface ClusterDiscoveryConfig {
+	bootstrap: string[];
+	cacheTtlMs?: number;
+	fetchTimeoutMs?: number;
+	trustAnchor?: ValidatorDiscoveryConfig;
+	allowInsecure?: boolean;
+}
+declare class ClusterDiscoveryClient {
+	private readonly bootstrap;
+	private readonly cacheTtlMs;
+	private readonly fetchTimeoutMs;
+	private readonly allowInsecure;
+	private readonly trustAnchorClient;
+	private cache;
+	constructor(config: ClusterDiscoveryConfig);
+	getClusters(forceRefresh?: boolean): Promise<ClusterInfo[]>;
+	getRandomCluster(forceRefresh?: boolean): Promise<ClusterInfo | null>;
+	getRandomGatewayUrl(forceRefresh?: boolean): Promise<string | null>;
+	getClusterById(clusterId: string, forceRefresh?: boolean): Promise<ClusterInfo | null>;
+	clearCache(): void;
+	private isCacheValid;
+	private fetchFromFirstAvailableSeed;
+	private fetchClustersFromSeed;
+	private normalizeClusterEntry;
+	private verifyAgainstTrustAnchor;
+	private pickRandomIndex;
+}
 export type AuthChain = "hedera" | "xrpl" | "polkadot" | "stellar" | "solana";
 export interface SecurityConfig {
 	allowInsecure?: boolean;
@@ -1055,7 +1095,7 @@ export type HttpClient = {
 	get<T = any>(path: string): Promise<T>;
 	put<T = any>(path: string, body: unknown): Promise<T>;
 	delete<T = any>(path: string): Promise<T>;
-	upload<T = any>(path: string, file: Blob | Buffer, filename: string, metadata?: Record<string, string>): Promise<T>;
+	upload<T = any>(path: string, file: Blob | Buffer, filename: string, metadata?: Record<string, string>, fieldName?: string): Promise<T>;
 };
 export type HttpClientConfig = {
 	baseUrl: string;
@@ -1070,6 +1110,14 @@ export declare class SdkHttpError extends Error {
 }
 export declare function createHttpClient(config: HttpClientConfig): HttpClient;
 export declare function encodePathParam(param: string): string;
+export interface RuleRejectedDetails {
+	error: "rule_rejected";
+	reason: string;
+	ruleAtoms: string[];
+}
+export declare function isRuleRejected(err: unknown): err is SdkHttpError & {
+	details: RuleRejectedDetails;
+};
 export type SubscriptionTierName = "free_testnet" | "starter" | "professional" | "enterprise";
 export type SubscriptionStatus = "pending_deposit" | "deposit_confirmed" | "active" | "expired" | "cancelled";
 export type DepositWalletStatus = "pending" | "locked" | "expired" | "slashed" | "released";
@@ -1197,7 +1245,6 @@ export type EntityCreationResponse = {
 	success: boolean;
 	entityId: string;
 	publicKeys: string[];
-	signerIndices: number[];
 	threshold: number;
 	ceremonyIds: string[];
 };
@@ -1217,7 +1264,6 @@ export type ReshareResponse = {
 export type EntityDetails = {
 	success: boolean;
 	payload?: unknown;
-	signerIndices?: number[];
 	validators?: string[];
 	publicKeys?: string[];
 	error?: string;
@@ -1572,6 +1618,48 @@ export declare class SnapshotsClient {
 	listByToken(tokenId: string, pagination?: PaginationOptions): Promise<SnapshotListResponse>;
 	download(snapshotId: string, format?: SnapshotFormat): Promise<any>;
 }
+export type HistoricalBalanceChain = "hedera" | "xrpl" | "polkadot";
+export type HistoricalBalanceQueryParams = {
+	chain: HistoricalBalanceChain;
+	entityId: string;
+	account: string;
+	atTimestamp: number;
+};
+export type HistoricalBalanceResult = {
+	chain: HistoricalBalanceChain;
+	entityId: string;
+	account: string;
+	atTimestamp: number;
+	balance: string;
+	source: "archive";
+};
+export type HistoricalBalanceClientConfig = {
+	baseUrl: string;
+	authToken?: string;
+	apiKey?: string;
+	timeoutMs?: number;
+	fetchImpl?: typeof fetch;
+};
+export declare class HistoricalBalanceClientError extends Error {
+	readonly statusCode: number;
+	readonly details?: unknown | undefined;
+	constructor(message: string, statusCode: number, details?: unknown | undefined);
+}
+export declare class HistoricalBalanceClient {
+	private readonly baseUrl?;
+	private readonly authToken?;
+	private readonly apiKey?;
+	private readonly timeoutMs;
+	private readonly fetchImpl?;
+	private readonly http?;
+	constructor(config: HistoricalBalanceClientConfig | {
+		http: HttpClient;
+	});
+	static fromHttp(http: HttpClient): HistoricalBalanceClient;
+	getBalance(params: HistoricalBalanceQueryParams): Promise<HistoricalBalanceResult>;
+	private validateParams;
+	private standaloneFetch;
+}
 export type SettlementPurpose = "subscription" | "deposit" | "fee";
 export type SettlementAsset = {
 	symbol: string;
@@ -1613,6 +1701,121 @@ export declare class SettlementClient {
 	confirmXrpLanded(settlementId: string): Promise<SettlementStatusResponse>;
 	getHistory(entityId: string): Promise<SettlementHistoryEntry[]>;
 }
+export type GovernanceVotingPowerMethod = "token_balance" | "quadratic" | "one_person_one_vote" | "nft_based" | "time_weighted" | "delegated";
+export type GovernanceProposalStatus = "pending" | "active" | "passed" | "failed" | "executed" | "cancelled" | "expired" | "vetoed";
+export type GovernanceVoteType = "for" | "against" | "abstain";
+export interface GovernanceProposalData {
+	proposalId: string;
+	proposer: string;
+	title: string;
+	description: string;
+	actions: unknown[];
+	status: GovernanceProposalStatus;
+	createdAt: string | Date;
+	votingStartsAt: string | Date;
+	votingEndsAt: string | Date;
+	executionDeadline?: string | Date;
+	votes: {
+		for: string;
+		against: string;
+		abstain: string;
+		totalVotingPower: string;
+	};
+	executionResult?: {
+		success: boolean;
+		transactionId?: string;
+		error?: string;
+	};
+}
+export interface GovernanceConfig {
+	governanceTokenId: string;
+	decimals?: number;
+	votingPowerMethod?: GovernanceVotingPowerMethod;
+	quorumPercent?: number;
+	approvalThresholdPercent?: number;
+	proposalThreshold: string;
+	votingPeriodMs: number;
+	timeLockMs?: number;
+	maxExecutionDelayMs?: number;
+	votingEligibility?: Record<string, unknown>;
+	proposalEligibility?: Record<string, unknown>;
+	allowDelegation?: boolean;
+	allowVoteChange?: boolean;
+	vetoCouncil?: string[];
+	maxActiveProposalsPerAccount?: number;
+	proposalCooldownMs?: number;
+	wisdomWeightFn?: {
+		registryKey: string;
+	};
+	delegation?: {
+		maxHops?: number;
+		decayPerHop?: number;
+		concentrationAlert?: number;
+	};
+	description?: string;
+}
+export interface GovernanceValidationContext {
+	chain?: string;
+	network?: "mainnet" | "testnet";
+	callerAccountId: string;
+	timestamp?: string | Date;
+	action: "create_proposal" | "cast_vote" | "execute_proposal" | "cancel_proposal" | "veto" | "delegate";
+	proposal?: GovernanceProposalData;
+	voteType?: GovernanceVoteType;
+	tokenBalance?: string;
+	votingPower?: string;
+	lastProposalAt?: string | Date;
+	activeProposalCount?: number;
+	delegation?: {
+		delegateTo?: string;
+		delegatedPower?: string;
+	};
+	daoId?: string;
+	totalDaoVotingPower?: string;
+}
+export interface GovernanceValidationResult {
+	isValid: boolean;
+	reason?: string;
+	metadata?: Record<string, unknown>;
+	validatedAt?: string;
+}
+export interface GovernanceSimulateRequest {
+	config: GovernanceConfig;
+	context: GovernanceValidationContext;
+}
+export declare class GovernanceClient {
+	private readonly http;
+	constructor(http: HttpClient);
+	simulate(params: GovernanceSimulateRequest): Promise<GovernanceValidationResult>;
+}
+export type PersonhoodAttestationMethod = "web-of-trust" | "biometric" | "pop-protocol";
+export interface PersonhoodProof {
+	attestationMethod: PersonhoodAttestationMethod;
+	payload: unknown;
+}
+export interface PersonhoodCert {
+	address: string;
+	issuerId: string;
+	attestationMethod: PersonhoodAttestationMethod;
+	issuedAt: number;
+	expiresAt: number;
+	signature: string;
+}
+export interface PersonhoodVerifyParams {
+	candidate: string;
+	proof: PersonhoodProof;
+}
+export declare const PERSONHOOD_VERIFIER_NOT_CONFIGURED: "personhood_verifier_not_configured";
+export declare class PersonhoodClient {
+	private readonly http;
+	constructor(http: HttpClient);
+	verify(params: PersonhoodVerifyParams): Promise<PersonhoodCert | null>;
+}
+export declare function isPersonhoodVerifierNotConfigured(err: unknown): err is SdkHttpError & {
+	details: {
+		error: typeof PERSONHOOD_VERIFIER_NOT_CONFIGURED;
+	};
+};
 export interface SmartEngineClientConfig {
 	baseUrl: string;
 	apiKey?: string;
@@ -1635,6 +1838,28 @@ export interface NetworkConnectionConfig {
 	mirrorNodeUrl?: string;
 	allowInsecure?: boolean;
 }
+export interface ClusterConnectionConfig {
+	bootstrap: string[];
+	chain: AuthChain;
+	address: string;
+	publicKey: string;
+	signFn: (challenge: string) => string | Promise<string>;
+	metadata?: {
+		appId?: string;
+		appName?: string;
+	};
+	trustAnchor?: {
+		network: "mainnet" | "testnet" | "previewnet";
+		registryTopicId: string;
+		mirrorNodeUrl?: string;
+	};
+	allowInsecure?: boolean;
+}
+export interface ClusterConnectionResult {
+	client: SmartEngineClient;
+	cluster: ClusterInfo;
+	session: AuthenticateResponse;
+}
 export interface NetworkConnectionResult {
 	client: SmartEngineClient;
 	validator: ValidatorInfo;
@@ -1651,9 +1876,13 @@ export declare class SmartEngineClient {
 	readonly ipfs: IPFSClient;
 	readonly transactions: TransactionsClient;
 	readonly snapshots: SnapshotsClient;
+	readonly historicalBalance: HistoricalBalanceClient;
 	readonly settlement: SettlementClient;
+	readonly governance: GovernanceClient;
+	readonly personhood: PersonhoodClient;
 	constructor(config: SmartEngineClientConfig);
 	static connectToNetwork(config: NetworkConnectionConfig): Promise<NetworkConnectionResult>;
+	static connectToCluster(config: ClusterConnectionConfig): Promise<ClusterConnectionResult>;
 	getBaseUrl(): string;
 	isAuthenticated(): boolean;
 	getHttpHealth(): {
@@ -2193,24 +2422,6 @@ export type BaasSessionInfo = {
 	expiresAt?: number;
 	error?: string;
 };
-export type BaasRegisterRequest = {
-	name: string;
-	services: BaasService[];
-	environment?: Record<string, string>;
-	limits?: {
-		storage?: string;
-		functions?: number;
-		channels?: number;
-	};
-};
-export type BaasRegisterResponse = {
-	appId: string;
-	name: string;
-	status: DeployedAppStatus;
-	services: string[];
-	endpoints: BaasEndpoints;
-	createdAt: string;
-};
 export type BaasDocument = {
 	_id: string;
 	data: Record<string, unknown>;
@@ -2416,18 +2627,56 @@ export type BaasPublishResult = {
 	channel: string;
 	timestamp: string;
 };
-export type BaasDeployRequest = {
+export type BaasInitRequest = {
 	name: string;
+	port: number;
 	services: BaasService[];
-	config?: Record<string, unknown>;
+	limits?: {
+		cpu?: string;
+		memory?: string;
+	};
 };
-export type BaasDeployResult = {
+export type BaasInitResponse = {
 	appId: string;
-	name: string;
-	status: "active" | "deploying" | "error";
-	services: string[];
-	endpoints: BaasEndpoints;
-	createdAt: string;
+	registry: {
+		server: string;
+		username: string;
+		password: string;
+		repository: string;
+	};
+};
+export type BaasDeployRequest = {
+	tag: string;
+	replicas?: number;
+	env?: Record<string, string>;
+	resources?: {
+		cpu?: string;
+		memory?: string;
+	};
+	strategy?: "rolling" | "recreate";
+};
+export type BaasDeployResponse = {
+	appId: string;
+	status: string;
+	url: string;
+};
+export type BaasUploadFrontendResponse = {
+	bundleSha256: string;
+	bundleSizeBytes: number;
+};
+export type BaasRollbackRequest = {
+	toTag: string;
+};
+export type BaasRuntimeStatus = {
+	appId: string;
+	state: "PENDING_SUBSCRIPTION" | "ACTIVE" | "SUSPENDED" | "RETIRED";
+	runtime?: {
+		image: string;
+		runtimeState: "NOT_DEPLOYED" | "DEPLOYING" | "RUNNING" | "FAILED" | "DEGRADED";
+		replicas: number;
+		lastReconciledAt?: string;
+		lastError?: string;
+	};
 };
 export type BaasAppListResponse = {
 	apps: DeployedAppInfo[];
@@ -2571,7 +2820,11 @@ export declare class MessagingClient {
 export declare class DeploymentClient {
 	private readonly http;
 	constructor(http: HttpClient);
-	create(request: BaasDeployRequest): Promise<BaasDeployResult>;
+	init(request: BaasInitRequest): Promise<BaasInitResponse>;
+	uploadFrontend(appId: string, bundle: Blob | Buffer, filename?: string): Promise<BaasUploadFrontendResponse>;
+	deploy(appId: string, request: BaasDeployRequest): Promise<BaasDeployResponse>;
+	rollback(appId: string, request: BaasRollbackRequest): Promise<BaasDeployResponse>;
+	status(appId: string): Promise<BaasRuntimeStatus>;
 	list(): Promise<BaasAppListResponse>;
 	get(appId: string): Promise<DeployedAppInfo>;
 	update(appId: string, updates: Partial<BaasDeployRequest>): Promise<DeployedAppInfo>;
@@ -2586,7 +2839,11 @@ export declare class DeploymentClient {
 		success: boolean;
 		status: string;
 	}>;
-	getStats(): Promise<any>;
+	getStats(): Promise<{
+		totalApps: number;
+		activeApps: number;
+		totalOwners: number;
+	}>;
 }
 export type AgentStatus = "active" | "paused" | "revoked" | "pending";
 export type AgentRegisterRequest = {
@@ -2711,6 +2968,55 @@ export declare class AgentsClient {
 		success: boolean;
 	}>;
 }
+export type CustomerSessionChallenge = {
+	challenge: string;
+};
+export type CustomerSessionVerifyRequest = {
+	appId: string;
+	chain: string;
+	address: string;
+	publicKey?: string;
+	signature: string;
+	challenge: string;
+};
+export type CustomerSessionToken = {
+	token: string;
+	sessionId: string;
+	validatorId: string;
+	expiresAt: string;
+	sessionSecret: string;
+};
+export type CustomerSessionInfo = {
+	sessionId: string;
+	appId: string;
+	customerChain: string;
+	customerAddress: string;
+	subscriptionContext?: {
+		nftSerial: number;
+		tier: "free_testnet" | "starter" | "professional" | "enterprise";
+		expiresAt: string;
+		allowedAutomations?: string[];
+	};
+	createdAt: string;
+	expiresAt: string;
+	lastActivityAt: string;
+};
+export declare class CustomerSessionClient {
+	private readonly baseUrl;
+	private readonly timeoutMs;
+	constructor(baseUrl: string, timeoutMs?: number);
+	challenge(input: {
+		chain: string;
+		address: string;
+	}): Promise<CustomerSessionChallenge>;
+	verify(req: CustomerSessionVerifyRequest): Promise<CustomerSessionToken>;
+	validate(bearer: string): Promise<CustomerSessionInfo>;
+	end(bearer: string): Promise<{
+		revoked: boolean;
+		sessionId: string;
+	}>;
+	private fetch;
+}
 export type AuthenticateOptions = {
 	chain: BaasSupportedChain;
 	walletAddress: string;
@@ -2732,6 +3038,7 @@ export declare class BaasClient {
 	readonly messaging: MessagingClient;
 	readonly deployment: DeploymentClient;
 	readonly agents: AgentsClient;
+	readonly customerSession: CustomerSessionClient;
 	constructor(config: BaasClientConfig);
 	setAppId(appId: string): void;
 	isAuthenticated(): boolean;
@@ -2744,7 +3051,6 @@ export declare class BaasClient {
 	authenticate(options: AuthenticateOptions): Promise<BaasAuthResult>;
 	validateSession(): Promise<BaasSessionInfo>;
 	logout(): Promise<void>;
-	register(request: BaasRegisterRequest): Promise<BaasRegisterResponse>;
 	private requireAuth;
 	private getHeaders;
 	private post;
@@ -2776,10 +3082,10 @@ declare namespace stellar {
 	export { stroopsToXlm, validateStellarAddress, xlmToStroops };
 }
 declare namespace baas {
-	export { AgentBalance, AgentEvent, AgentFundRequest, AgentInfo, AgentOperation, AgentRegisterRequest, AgentRules, AgentRulesValidationResult, AgentStatus, AgentTradeRequest, AgentWithdrawRequest, AgentsClient, AuthenticateOptions, BaasAppListResponse, BaasAuthConfig, BaasAuthResult, BaasChallengeRequest, BaasChallengeResponse, BaasChannelConfig, BaasClient, BaasClientConfig, BaasDeleteResult, BaasDeployRequest, BaasDeployResult, BaasDocument, BaasEndpoints, BaasError, BaasErrorDetails, BaasErrorResponse, BaasFileInfo, BaasFileMetadata, BaasFindResult, BaasFunctionDeployRequest, BaasFunctionDeployResult, BaasFunctionInfo, BaasFunctionLog, BaasFunctionLogOptions, BaasFunctionResources, BaasFunctionResult, BaasFunctionRuntime, BaasHistoryOptions, BaasInsertResult, BaasMerkleProof, BaasMessage, BaasPresenceInfo, BaasPresenceMember, BaasPublishResult, BaasQueryOptions, BaasRegisterRequest, BaasRegisterResponse, BaasService, BaasSessionInfo, BaasStateTransition, BaasStorageUsage, BaasSupportedChain, BaasTriggerType, BaasUpdateResult, BaasUploadResult, BaasVerifyRequest, ChannelSubscription, DatabaseClient, DatabaseStatsResponse, DbComparisonOperator, DbDocument, DbQuery, DeployedApp, DeployedAppInfo, DeployedAppLimits, DeployedAppStatus, DeployedAppUsage, DeploymentClient, DocumentProofResponse, FunctionsClient, MessageHandler, MessagingClient, StateRootResponse, StateTransitionsResponse, StorageClient, validateAgentRules };
+	export { AgentBalance, AgentEvent, AgentFundRequest, AgentInfo, AgentOperation, AgentRegisterRequest, AgentRules, AgentRulesValidationResult, AgentStatus, AgentTradeRequest, AgentWithdrawRequest, AgentsClient, AuthenticateOptions, BaasAppListResponse, BaasAuthConfig, BaasAuthResult, BaasChallengeRequest, BaasChallengeResponse, BaasChannelConfig, BaasClient, BaasClientConfig, BaasDeleteResult, BaasDeployRequest, BaasDeployResponse, BaasDocument, BaasEndpoints, BaasError, BaasErrorDetails, BaasErrorResponse, BaasFileInfo, BaasFileMetadata, BaasFindResult, BaasFunctionDeployRequest, BaasFunctionDeployResult, BaasFunctionInfo, BaasFunctionLog, BaasFunctionLogOptions, BaasFunctionResources, BaasFunctionResult, BaasFunctionRuntime, BaasHistoryOptions, BaasInitRequest, BaasInitResponse, BaasInsertResult, BaasMerkleProof, BaasMessage, BaasPresenceInfo, BaasPresenceMember, BaasPublishResult, BaasQueryOptions, BaasRollbackRequest, BaasRuntimeStatus, BaasService, BaasSessionInfo, BaasStateTransition, BaasStorageUsage, BaasSupportedChain, BaasTriggerType, BaasUpdateResult, BaasUploadFrontendResponse, BaasUploadResult, BaasVerifyRequest, ChannelSubscription, DatabaseClient, DatabaseStatsResponse, DbComparisonOperator, DbDocument, DbQuery, DeployedApp, DeployedAppInfo, DeployedAppLimits, DeployedAppStatus, DeployedAppUsage, DeploymentClient, DocumentProofResponse, FunctionsClient, MessageHandler, MessagingClient, StateRootResponse, StateTransitionsResponse, StorageClient, validateAgentRules };
 }
 declare namespace discovery {
-	export { MIRROR_NODE_URLS, MirrorNodeClient, MirrorNodeConfig, MirrorNodeError, TopicMessage, TopicMessagesResponse, ValidatorDiscoveryClient, ValidatorDiscoveryConfig, ValidatorInfo, ValidatorMetadata, ValidatorNetworkEndpoints };
+	export { ClusterDiscoveryClient, ClusterDiscoveryConfig, ClusterEndpointsView, ClusterInfo, MIRROR_NODE_URLS, MirrorNodeClient, MirrorNodeConfig, MirrorNodeError, TopicMessage, TopicMessagesResponse, ValidatorDiscoveryClient, ValidatorDiscoveryConfig, ValidatorInfo, ValidatorMetadata, ValidatorNetworkEndpoints };
 }
 declare namespace auth {
 	export { AuthChain, AuthenticateRequest, AuthenticateResponse, ChallengeResponse, SecurityConfig, SessionInfo, ValidatorAuthClient, ValidatorAuthConfig, ValidatorAuthError };
@@ -2793,6 +3099,12 @@ declare namespace subscription {
 declare namespace settlement {
 	export { SettlementAsset, SettlementClient, SettlementHistoryEntry, SettlementInitiateRequest, SettlementPurpose, SettlementStatusResponse };
 }
+declare namespace governance {
+	export { GovernanceClient, GovernanceConfig, GovernanceProposalData, GovernanceProposalStatus, GovernanceSimulateRequest, GovernanceValidationContext, GovernanceValidationResult, GovernanceVoteType, GovernanceVotingPowerMethod };
+}
+declare namespace personhood {
+	export { PERSONHOOD_VERIFIER_NOT_CONFIGURED, PersonhoodAttestationMethod, PersonhoodCert, PersonhoodClient, PersonhoodProof, PersonhoodVerifyParams, isPersonhoodVerifierNotConfigured };
+}
 
 export {
 	RetryConfig as ResilienceRetryConfig,
@@ -2801,6 +3113,8 @@ export {
 	baas,
 	chains,
 	discovery,
+	governance,
+	personhood,
 	settlement,
 	subscription,
 };