@hsuite/smart-engines-sdk 4.1.0 → 4.2.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 4.2.0 — 2026-06-26
+
+### Added
+
+- **Two-phase EXECUTABLE-agent surface (additive, non-breaking).** Reflects the host change that promotes a payer-funded XRPL agent into an executable AGENT record during the execute-create/finalize half. Lets the app-as-proxy consumer drive the full prepare → fund → execute agent flow type-safely.
+  - **`EntityCreationResult.agentId?: string` + `status?: string`.** The host now merges `{ agentId, status }` additively onto the execute-create envelope once the funded entity is promoted to an agent record (`executeCreateAgent`, and the convenience `createAgent` on payer-funded chains). Present ONLY on the agent execute/finalize path; undefined for non-agent entity types and on the prepare half. Field names + `string` types match the host controller's `executeCreate` return (`apps/smart-host/.../entities.controller.ts`) verbatim.
+  - **`CreateAgentRequest.rulesConfig?: Record<string, unknown>` + `capabilities?: string[]`.** Carried through `prepareCreateAgent` (which already forwards the whole request body) so the host can stash them VERBATIM on the PENDING registry row at prepare and recover them at execute to mint the agent record — avoiding a `rulesHash` divergence from re-deriving them from the bound rule. Field names + types mirror the host `PrepareCreateDto` / `entity-registry.schema.ts` verbatim. Optional/additive; ignored by the legacy synchronous `createAgent` and by non-agent entity types.
+  - **App-as-payer `fundWith` documented.** `CreateAgentRequest.fundWith` now documents that a smart-app may supply a SERVER-SIDE `fundWith` that signs the prepared payer `Payment` with the app's OWN treasury key and sets `payerAccountId` to that treasury account. No new method — the existing `prepareCreateAgent` → `fundWith` → `executeCreateAgent` sequence already supports an app funding an agent on a customer's behalf.
+
 ## 4.1.0 — 2026-06-25
 
 ### Added

package/dist/index.d.ts

@@ -25329,6 +25329,8 @@ export type CreateAgentRequest = {
 	agentType?: string;
 	securityMode?: EntitySecurityMode;
 	payerAccountId?: string;
+	rulesConfig?: Record<string, unknown>;
+	capabilities?: string[];
 	fundWith?: FundWith;
 };
 export type EntityCreationResult = {
@@ -25336,6 +25338,8 @@ export type EntityCreationResult = {
 	ruleRef: RuleRef;
 	chainAccounts: Record<string, string>;
 	transactionId?: string;
+	agentId?: string;
+	status?: string;
 };
 export type EntityInfo = {
 	entityId: string;

package/dist/nestjs/index.d.ts

@@ -12384,6 +12384,8 @@ export type CreateAgentRequest = {
 	agentType?: string;
 	securityMode?: EntitySecurityMode;
 	payerAccountId?: string;
+	rulesConfig?: Record<string, unknown>;
+	capabilities?: string[];
 	fundWith?: FundWith;
 };
 export type EntityCreationResult = {
@@ -12391,6 +12393,8 @@ export type EntityCreationResult = {
 	ruleRef: RuleRef;
 	chainAccounts: Record<string, string>;
 	transactionId?: string;
+	agentId?: string;
+	status?: string;
 };
 export type EntityInfo = {
 	entityId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hsuite/smart-engines-sdk",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "Simplified client SDK for Smart Engines multi-chain infrastructure",
   "sideEffects": false,
   "main": "dist/index.js",