@hsuite/smart-engines-sdk 3.13.0 → 3.14.0

package/dist/nestjs/index.d.ts

@@ -1634,6 +1634,7 @@ export interface ClusterInfo {
 }
 export type HttpCallOptions = {
 	customerToken?: string;
+	onBehalfOf?: string;
 	headers?: Record<string, string>;
 };
 export type HttpClient = {
@@ -1644,6 +1645,11 @@ export type HttpClient = {
 	delete<T = any>(path: string, opts?: HttpCallOptions): Promise<T>;
 	getText(path: string, opts?: HttpCallOptions): Promise<string>;
 	getBinary(path: string, opts?: HttpCallOptions): Promise<Uint8Array>;
+	getBinaryWithMeta(path: string, opts?: HttpCallOptions): Promise<{
+		bytes: Uint8Array;
+		contentType?: string;
+		filename?: string;
+	}>;
 	upload<T = any>(path: string, file: Blob | Buffer, filename: string, metadata?: Record<string, string>, fieldName?: string, opts?: HttpCallOptions): Promise<T>;
 	setAuthToken(token: string | undefined): void;
 	getAuthToken(): string | undefined;
@@ -3371,6 +3377,29 @@ export type AgentInfo = {
 	owner: string;
 	createdAt: string;
 	lastActiveAt?: string;
+	agentWallet?: string;
+	treasuryAccount?: string;
+	entityId?: string;
+};
+export type AgentCertification = {
+	agentId: string;
+	entityId?: string;
+	ownerWallet?: string;
+	status?: string;
+	agentWallet?: string;
+	treasuryAccount?: string;
+	primaryChain?: string;
+	rulesHash?: string;
+	ruleRef?: string;
+	blsGroupPublicKey?: string;
+	stateHistoryTopicId?: string;
+	recentEvents: Array<{
+		agentId: string;
+		type: string;
+		payload: Record<string, unknown>;
+		timestamp: string;
+	}>;
+	recentTxIds: string[];
 };
 export type AgentEvent = {
 	eventId: string;
@@ -3423,6 +3452,14 @@ export type AgentExecuteResponse = {
 export type AgentPreparedTransactionResponse = PreparedTransactionResponse & {
 	success: true;
 };
+export type AgentPendingApprovalResponse = {
+	success: true;
+	pendingOpId: string;
+	agentId: string;
+	action: string;
+	status: "awaiting_approval";
+	description: string;
+};
 declare class AgentsClient {
 	private readonly http;
 	constructor(http: HttpClient);
@@ -3432,7 +3469,7 @@ declare class AgentsClient {
 		agents: AgentInfo[];
 		total: number;
 	}>;
-	fund(agentId: string, request: AgentFundRequest, opts?: HttpCallOptions): Promise<AgentPreparedTransactionResponse>;
+	fund(agentId: string, request: AgentFundRequest, opts?: HttpCallOptions): Promise<AgentPreparedTransactionResponse | AgentPendingApprovalResponse>;
 	trade(agentId: string, request: AgentTradeRequest, opts?: HttpCallOptions): Promise<AgentPreparedTransactionResponse>;
 	withdraw(agentId: string, request: AgentWithdrawRequest, opts?: HttpCallOptions): Promise<AgentPreparedTransactionResponse>;
 	execute(agentId: string, request: AgentExecuteRequest, opts?: HttpCallOptions): Promise<AgentExecuteResponse & {
@@ -3450,6 +3487,7 @@ declare class AgentsClient {
 		success: boolean;
 		status: string;
 	}>;
+	certification(agentId: string, opts?: HttpCallOptions): Promise<AgentCertification>;
 	updateRules(agentId: string, rules: Partial<AgentRules>, opts?: HttpCallOptions): Promise<AgentInfo>;
 	getEvents(agentId: string, opts?: HttpCallOptions): Promise<{
 		events: AgentEvent[];
@@ -3668,6 +3706,11 @@ export type BaasFunctionInfo = {
 	lastInvokedAt?: string;
 	invocationCount: number;
 };
+export type BaasFunctionCode = {
+	functionId: string;
+	code: string | null;
+	codeHash?: string;
+};
 export type BaasFunctionLog = {
 	timestamp: string;
 	level: "debug" | "info" | "warn" | "error";
@@ -4840,6 +4883,11 @@ declare class StorageClient {
 	constructor(http: HttpClient, getAppId: () => string);
 	upload(file: Blob | Buffer, filename: string, metadata?: Record<string, string>, opts?: HttpCallOptions): Promise<BaasUploadResult>;
 	download(cid: string, opts?: HttpCallOptions): Promise<Uint8Array>;
+	downloadWithMeta(cid: string, opts?: HttpCallOptions): Promise<{
+		bytes: Uint8Array;
+		contentType?: string;
+		filename?: string;
+	}>;
 	getMetadata(cid: string, opts?: HttpCallOptions): Promise<BaasFileMetadata>;
 	delete(cid: string, opts?: HttpCallOptions): Promise<{
 		success: boolean;
@@ -4870,6 +4918,7 @@ declare class FunctionsClient {
 		total: number;
 	}>;
 	get(functionId: string, opts?: HttpCallOptions): Promise<BaasFunctionInfo>;
+	getCode(functionId: string, opts?: HttpCallOptions): Promise<BaasFunctionCode>;
 	update(functionId: string, updates: Partial<BaasFunctionDeployRequest>, opts?: HttpCallOptions): Promise<BaasFunctionInfo>;
 	delete(functionId: string, opts?: HttpCallOptions): Promise<{
 		success: boolean;
@@ -12375,6 +12424,9 @@ export type CreateAgentRequest = {
 	ruleRef: RuleRef;
 	name: string;
 	agentType?: string;
+	securityMode?: EntitySecurityMode;
+	payerAccountId?: string;
+	fundWith?: FundWith;
 };
 export type EntityCreationResult = {
 	entityId: string;
@@ -12458,6 +12510,14 @@ export declare class EntitiesClient {
 	}): Promise<EntityCreationResult>;
 	createTopic(req: CreateTopicRequest): Promise<EntityCreationResult>;
 	createAgent(req: CreateAgentRequest): Promise<EntityCreationResult>;
+	prepareCreateAgent(req: Omit<CreateAgentRequest, "fundWith">): Promise<PreparedEntityCreation>;
+	executeCreateAgent(req: {
+		entityId: string;
+		chain: ChainType;
+		securityMode?: EntitySecurityMode;
+		signedFundingBlob?: string;
+		createTxId?: string;
+	}): Promise<EntityCreationResult>;
 	launchpad(req: LaunchpadEntityRequest): Promise<LaunchpadEntityResult>;
 	get(entityId: string): Promise<EntityInfo>;
 	listByOwner(filter?: ListEntitiesFilter): Promise<ListEntitiesResponse>;

package/dist/nestjs/index.js

@@ -1149,6 +1149,13 @@ var SdkHttpError = class extends Error {
   }
   statusCode;
   details;
+  /**
+   * True for transient failures worth retrying: a 5xx, a 429 (rate limit), a 408
+   * (timeout), or a 0 (network/abort). Deterministic 4xx client errors are not.
+   */
+  get isRetryable() {
+    return this.statusCode === 0 || this.statusCode === 408 || this.statusCode === 429 || this.statusCode >= 500;
+  }
 };
 function createHttpClient(config) {
   const timeout = config.timeout ?? 3e4;
@@ -1166,6 +1173,10 @@ function createHttpClient(config) {
     if (opts?.customerToken) {
       headers["X-Customer-Session-Token"] = opts.customerToken;
     }
+    if (opts?.onBehalfOf) {
+      headers["Authorization"] = `Bearer ${opts.onBehalfOf}`;
+      headers["X-Customer-Session-Claim"] = opts.onBehalfOf;
+    }
     if (opts?.headers) {
       Object.assign(headers, opts.headers);
     }
@@ -1273,6 +1284,41 @@ function createHttpClient(config) {
       throw new SdkHttpError(`Network error: ${err.message}`, 0, error);
     }
   }
+  async function getBinaryWithMeta(path, opts) {
+    const url = `${config.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: getHeaders(void 0, opts),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errBody = await response.json().catch(() => ({}));
+        throw new SdkHttpError(
+          errBody.message || `API error: ${response.status} ${response.statusText}`,
+          response.status,
+          errBody
+        );
+      }
+      const bytes = new Uint8Array(await response.arrayBuffer());
+      const contentType = response.headers.get("content-type") ?? void 0;
+      const disposition = response.headers.get("content-disposition") ?? "";
+      const match = /filename\*?=(?:UTF-8'')?"?([^"\n;]+)"?/i.exec(disposition);
+      const filename = match ? decodeURIComponent(match[1].trim()) : void 0;
+      return { bytes, contentType, filename };
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof SdkHttpError) throw error;
+      const err = error;
+      if (err.name === "AbortError") {
+        throw new SdkHttpError("Request timeout", 408);
+      }
+      throw new SdkHttpError(`Network error: ${err.message}`, 0, error);
+    }
+  }
   async function upload(path, file, filename, metadata, fieldName = "file", opts) {
     const url = `${config.baseUrl}${path}`;
     const controller = new AbortController();
@@ -1296,6 +1342,10 @@ function createHttpClient(config) {
       if (opts?.customerToken) {
         headers["X-Customer-Session-Token"] = opts.customerToken;
       }
+      if (opts?.onBehalfOf) {
+        headers["Authorization"] = `Bearer ${opts.onBehalfOf}`;
+        headers["X-Customer-Session-Claim"] = opts.onBehalfOf;
+      }
       if (opts?.headers) {
         Object.assign(headers, opts.headers);
       }
@@ -1353,6 +1403,7 @@ function createHttpClient(config) {
     delete: (path, opts) => withAuthRetry(path, () => request("DELETE", path, void 0, opts)),
     getText: (path, opts) => withAuthRetry(path, () => getText(path, opts)),
     getBinary: (path, opts) => withAuthRetry(path, () => getBinary(path, opts)),
+    getBinaryWithMeta: (path, opts) => withAuthRetry(path, () => getBinaryWithMeta(path, opts)),
     upload: ((path, file, filename, metadata, fieldName, opts) => withAuthRetry(path, () => upload(path, file, filename, metadata, fieldName, opts))),
     setAuthToken,
     getAuthToken
@@ -2992,9 +3043,12 @@ var AgentsClient = class {
     return this.http.get("/api/v3/baas/agents", opts);
   }
   /**
-   * Fund agent treasury (owner-only). Returns a
+   * Fund agent treasury (owner-only). Normally returns a
    * `PreparedTransactionResponse` wrapped in a `success: true` envelope —
-   * the caller is expected to sign and submit the prepared bytes.
+   * the caller is expected to sign and submit the prepared bytes. When the
+   * amount trips an approval-required rule the host instead returns an
+   * {@link AgentPendingApprovalResponse}; discriminate with
+   * {@link isAgentFundPending}.
    */
   async fund(agentId, request, opts) {
     return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/fund`, request, opts);
@@ -3033,6 +3087,14 @@ var AgentsClient = class {
   async revoke(agentId, opts) {
     return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/revoke`, {}, opts);
   }
+  /**
+   * Get an agent's certification snapshot (identity, rule refs, BLS group key,
+   * and recent on-chain activity). A 404 throws `SdkHttpError` via `http.get`
+   * — parity with {@link get}.
+   */
+  async certification(agentId, opts) {
+    return this.http.get(`/api/v3/baas/agents/${encodePathParam(agentId)}/certification`, opts);
+  }
   /**
    * Update agent rules.
    *
@@ -4406,6 +4468,20 @@ var StorageClient = class {
     const appId = this.getAppId();
     return this.http.getBinary(`/api/v3/baas/storage/${encodePathParam(appId)}/download/${encodePathParam(cid)}`, opts);
   }
+  /**
+   * Download a file by CID WITH its response metadata — the raw bytes plus the
+   * host-supplied `contentType` (derived from the stored file's metadata) and,
+   * when present, the `filename`. Use this instead of {@link download} when the
+   * caller must echo the content-type back to its own client; a bytes-only
+   * download cannot recover it.
+   */
+  async downloadWithMeta(cid, opts) {
+    const appId = this.getAppId();
+    return this.http.getBinaryWithMeta(
+      `/api/v3/baas/storage/${encodePathParam(appId)}/download/${encodePathParam(cid)}`,
+      opts
+    );
+  }
   /**
    * Get file metadata
    */
@@ -4528,6 +4604,16 @@ var FunctionsClient = class {
       opts
     );
   }
+  /**
+   * Get a function's source code
+   */
+  async getCode(functionId, opts) {
+    const appId = this.getAppId();
+    return this.http.get(
+      `/api/v3/baas/functions/${encodePathParam(appId)}/${encodePathParam(functionId)}/code`,
+      opts
+    );
+  }
   /**
    * Update a function
    */
@@ -5109,6 +5195,44 @@ var EntitiesClient = class _EntitiesClient {
   async createAgent(req) {
     return this.http.post("/api/v3/baas/entities/createAgent", req);
   }
+  /**
+   * PREPARE half of the payer-funded agent-create flow.
+   *
+   * POSTs `/api/v3/baas/entities/prepare-create` with `entityType: 'agent'`. The cluster
+   * runs the per-entity DKG (persists the binding, submits nothing on-chain) and
+   * returns the unsigned payer-funding `Payment`(s) the caller signs + submits with
+   * their own wallet — mirroring `prepareCreateAccount`. The agent's primary chain
+   * is relayed as `chain` (the generic prepare/execute DTO key) so the host's
+   * chain-bound preparer runs; `name` / `agentType` / `ruleRef` ride along.
+   */
+  async prepareCreateAgent(req) {
+    const { primaryChain, ...rest } = req;
+    return this.http.post("/api/v3/baas/entities/prepare-create", {
+      entityType: "agent",
+      chain: primaryChain,
+      ...rest
+    });
+  }
+  /**
+   * EXECUTE half of the payer-funded agent-create flow.
+   *
+   * POSTs `/api/v3/baas/entities/execute-create` with `entityType: 'agent'`. The entity
+   * already exists (its DKG ran during prepare); pass `signedFundingBlob` for the
+   * validator to submit the payer's signed funding tx (XRPL/Stellar account-model
+   * relay), or omit it when the caller already submitted the funding tx themselves.
+   * `createTxId` is the Hedera receipt thread (the prepared create's
+   * `transactionId`); ignored for non-Hedera chains. Mirrors
+   * `executeCreateAccount` but tags `entityType: 'agent'`.
+   */
+  async executeCreateAgent(req) {
+    const { createTxId, signedFundingBlob, ...rest } = req;
+    return this.http.post("/api/v3/baas/entities/execute-create", {
+      ...rest,
+      ...createTxId !== void 0 ? { createTxId } : {},
+      ...signedFundingBlob !== void 0 ? { signedFundingBlob } : {},
+      entityType: "agent"
+    });
+  }
   /**
    * Mega-helper: build a token rule with a launchpad ModuleEntry attached,
    * publish it, create the token, and return the combined result in one HTTP