@chipi-stack/backend 14.14.0 → 14.15.0

package/dist/{client-CqD_yGH0.d.mts → client-D6SDBu5p.d.mts}

@@ -26,10 +26,12 @@ declare class ChipiClient {
         params?: Record<string, any>;
         bearerToken?: string;
     }): Promise<T>;
-    post<T>({ endpoint, bearerToken, body, }: {
+    post<T>({ endpoint, bearerToken, body, headers, }: {
         endpoint: string;
         bearerToken: string;
         body?: Record<string, any>;
+        /** Extra request headers, e.g. `X-PAYMENT`. Cannot override auth or content type. */
+        headers?: Record<string, string>;
     }): Promise<T>;
     put<T>({ endpoint, bearerToken, body, }: {
         endpoint: string;

package/dist/{client-CqD_yGH0.d.ts → client-D6SDBu5p.d.ts}

@@ -26,10 +26,12 @@ declare class ChipiClient {
         params?: Record<string, any>;
         bearerToken?: string;
     }): Promise<T>;
-    post<T>({ endpoint, bearerToken, body, }: {
+    post<T>({ endpoint, bearerToken, body, headers, }: {
         endpoint: string;
         bearerToken: string;
         body?: Record<string, any>;
+        /** Extra request headers, e.g. `X-PAYMENT`. Cannot override auth or content type. */
+        headers?: Record<string, string>;
     }): Promise<T>;
     put<T>({ endpoint, bearerToken, body, }: {
         endpoint: string;

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 import * as _chipi_stack_types from '@chipi-stack/types';
-import { CreateSessionKeyParams, SessionKeyData, AddSessionKeyParams, SetupSessionParams, RevokeSessionKeyParams, GetSessionDataParams, SessionDataResponse, ExecuteWithSessionParams, SetSpendingPolicyParams, GetSpendingPolicyParams, SpendingPolicyData, RemoveSpendingPolicyParams, Currency, AiSignalsParams, AiSignals, ThinkParams, ThinkResponse, AiExecuteParams, AiExecuteResponse, AiChatParams, AiChatResponse, AiPricesParams, AiPrices, AiModelsResponse, ThinkDecision, PaymasterAdapter, PaymasterAccount, X402FacilitatorConfig, NonceStore, PaymentPayload, VerifyResponse, SettleResponse, ChipiSDKConfig, ExecuteTransactionParams, SignTypedDataParams, SignTypedDataResult, TransferParams, ApproveParams, CallAnyContractParams, CreateWalletParams, CreateWalletResponse, RecordSendTransactionParams, Transaction, GetTransactionListQuery, PaginatedResponse, GetWalletParams, GetTokenBalanceParams, GetTokenBalanceResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, TransactionStatusResponse, PrepareWalletUpgradeParams, PrepareWalletUpgradeResponse, ExecuteWalletUpgradeParams, ExecuteWalletUpgradeResponse, ChipiServerSDKConfig, ChipiBrowserSDKConfig, SessionConfig, Call as Call$1, SpendingPolicyConfig, X402ClientConfig, PaymentRequirement, X402PaymentConfig, ShhhSignerKind } from '@chipi-stack/types';
+import { CreateSessionKeyParams, SessionKeyData, AddSessionKeyParams, SetupSessionParams, RevokeSessionKeyParams, GetSessionDataParams, SessionDataResponse, ExecuteWithSessionParams, SetSpendingPolicyParams, GetSpendingPolicyParams, SpendingPolicyData, RemoveSpendingPolicyParams, Currency, AiSignalsParams, AiSignals, ThinkParams, ThinkOptions, ThinkResponse, AiExecuteParams, AiExecuteResponse, AiChatParams, AiChatResponse, AiPricesParams, AiPrices, AiModelsResponse, ThinkDecision, PaymasterAdapter, PaymasterAccount, X402FacilitatorConfig, NonceStore, PaymentPayload, VerifyResponse, SettleResponse, ChipiSDKConfig, ExecuteTransactionParams, SignTypedDataParams, SignTypedDataResult, TransferParams, ApproveParams, CallAnyContractParams, CreateWalletParams, CreateWalletResponse, RecordSendTransactionParams, Transaction, GetTransactionListQuery, PaginatedResponse, GetWalletParams, GetTokenBalanceParams, GetTokenBalanceResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, TransactionStatusResponse, PrepareWalletUpgradeParams, PrepareWalletUpgradeResponse, ExecuteWalletUpgradeParams, ExecuteWalletUpgradeResponse, ChipiServerSDKConfig, ChipiBrowserSDKConfig, SessionConfig, Call as Call$1, SpendingPolicyConfig, X402ClientConfig, PaymentRequirement, X402PaymentConfig, ShhhSignerKind } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 export { Chain, ChainToken, Currency } from '@chipi-stack/types';
-import { C as ChipiWallets } from './wallets-CYCLyyXY.mjs';
-export { E as ExecuteMigrateResponse, M as MigrateChipiWalletToShhhParams, a as MigrationOutcome, P as PrepareMigrateResponse, m as migrateChipiWalletToShhh } from './wallets-CYCLyyXY.mjs';
+import { C as ChipiWallets } from './wallets-CX42j3eN.mjs';
+export { E as ExecuteMigrateResponse, M as MigrateChipiWalletToShhhParams, a as MigrationOutcome, P as PrepareMigrateResponse, m as migrateChipiWalletToShhh } from './wallets-CX42j3eN.mjs';
 import { ChipiTransactions } from './transactions.mjs';
 import { ChipiSkuPurchases } from './skuPurchases.mjs';
 import { ChipiSkus } from './skus.mjs';
-import { C as ChipiClient } from './client-CqD_yGH0.mjs';
+import { C as ChipiClient } from './client-D6SDBu5p.mjs';
 import { Call, ProviderInterface, Account } from 'starknet';
 
 /**
@@ -626,7 +626,11 @@ declare function isThinkDecision(decision: unknown): decision is ThinkDecision;
 declare class ChipiAi {
     private client;
     private apiSecretKey?;
-    constructor(client: ChipiClient, apiSecretKey?: string | undefined);
+    /** Needed only to pay think calls with `payWithSession`. */
+    private sessions?;
+    constructor(client: ChipiClient, apiSecretKey?: string | undefined, 
+    /** Needed only to pay think calls with `payWithSession`. */
+    sessions?: ChipiSessions | undefined);
     private secret;
     /**
      * `GET /v1/ai/signals`: technical signals per token, market sentiment and
@@ -639,8 +643,33 @@ declare class ChipiAi {
      *
      * The decision is advice, not an order: check it with `isThinkDecision` and
      * enforce your own limits before executing anything.
+     *
+     * **Paying per call (x402).** With `payWithSession`, a 402 that carries a
+     * session-transfer offer (credits short, x402 on) is paid with the agent's
+     * session key: a USDC `transfer` to the offer's `payTo`, then the same call
+     * again with `X-PAYMENT`. The price must be at most `maxAmount`, `model`
+     * must be payable and the input within `maxPromptBytes`, all checked before
+     * paying. The session must whitelist `transfer` and cap USDC. A payment
+     * that was made but not served is reported in `error.details.xPayment`;
+     * pass it back as `options.xPayment` to retry without paying again.
+     *
+     * @example
+     * ```typescript
+     * const res = await sdk.ai.think(
+     *   { portfolio, model: "haiku" },
+     *   { payWithSession: { encryptKey, wallet, session, maxAmount: 20_000n } } // $0.02 at most
+     * );
+     * res.x402Payment; // set when the call was paid over x402
+     * ```
+     */
+    think(params: ThinkParams, options?: ThinkOptions): Promise<ThinkResponse>;
+    private postThink;
+    /**
+     * Pay one think call with a session-key USDC transfer, then send it again
+     * with `X-PAYMENT`. Every check that can refuse the call runs before the
+     * transfer; the transfer counts only once its receipt shows the USDC moved.
      */
-    think(params: ThinkParams): Promise<ThinkResponse>;
+    private payAndThink;
     /**
      * `POST /v1/ai/execute`: unsigned AVNU swap calls (approve + swap) for
      * `walletAddress`. Nothing is submitted; sign the calls with a session key

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import * as _chipi_stack_types from '@chipi-stack/types';
-import { CreateSessionKeyParams, SessionKeyData, AddSessionKeyParams, SetupSessionParams, RevokeSessionKeyParams, GetSessionDataParams, SessionDataResponse, ExecuteWithSessionParams, SetSpendingPolicyParams, GetSpendingPolicyParams, SpendingPolicyData, RemoveSpendingPolicyParams, Currency, AiSignalsParams, AiSignals, ThinkParams, ThinkResponse, AiExecuteParams, AiExecuteResponse, AiChatParams, AiChatResponse, AiPricesParams, AiPrices, AiModelsResponse, ThinkDecision, PaymasterAdapter, PaymasterAccount, X402FacilitatorConfig, NonceStore, PaymentPayload, VerifyResponse, SettleResponse, ChipiSDKConfig, ExecuteTransactionParams, SignTypedDataParams, SignTypedDataResult, TransferParams, ApproveParams, CallAnyContractParams, CreateWalletParams, CreateWalletResponse, RecordSendTransactionParams, Transaction, GetTransactionListQuery, PaginatedResponse, GetWalletParams, GetTokenBalanceParams, GetTokenBalanceResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, TransactionStatusResponse, PrepareWalletUpgradeParams, PrepareWalletUpgradeResponse, ExecuteWalletUpgradeParams, ExecuteWalletUpgradeResponse, ChipiServerSDKConfig, ChipiBrowserSDKConfig, SessionConfig, Call as Call$1, SpendingPolicyConfig, X402ClientConfig, PaymentRequirement, X402PaymentConfig, ShhhSignerKind } from '@chipi-stack/types';
+import { CreateSessionKeyParams, SessionKeyData, AddSessionKeyParams, SetupSessionParams, RevokeSessionKeyParams, GetSessionDataParams, SessionDataResponse, ExecuteWithSessionParams, SetSpendingPolicyParams, GetSpendingPolicyParams, SpendingPolicyData, RemoveSpendingPolicyParams, Currency, AiSignalsParams, AiSignals, ThinkParams, ThinkOptions, ThinkResponse, AiExecuteParams, AiExecuteResponse, AiChatParams, AiChatResponse, AiPricesParams, AiPrices, AiModelsResponse, ThinkDecision, PaymasterAdapter, PaymasterAccount, X402FacilitatorConfig, NonceStore, PaymentPayload, VerifyResponse, SettleResponse, ChipiSDKConfig, ExecuteTransactionParams, SignTypedDataParams, SignTypedDataResult, TransferParams, ApproveParams, CallAnyContractParams, CreateWalletParams, CreateWalletResponse, RecordSendTransactionParams, Transaction, GetTransactionListQuery, PaginatedResponse, GetWalletParams, GetTokenBalanceParams, GetTokenBalanceResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, TransactionStatusResponse, PrepareWalletUpgradeParams, PrepareWalletUpgradeResponse, ExecuteWalletUpgradeParams, ExecuteWalletUpgradeResponse, ChipiServerSDKConfig, ChipiBrowserSDKConfig, SessionConfig, Call as Call$1, SpendingPolicyConfig, X402ClientConfig, PaymentRequirement, X402PaymentConfig, ShhhSignerKind } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 export { Chain, ChainToken, Currency } from '@chipi-stack/types';
-import { C as ChipiWallets } from './wallets-DxKnh21Q.js';
-export { E as ExecuteMigrateResponse, M as MigrateChipiWalletToShhhParams, a as MigrationOutcome, P as PrepareMigrateResponse, m as migrateChipiWalletToShhh } from './wallets-DxKnh21Q.js';
+import { C as ChipiWallets } from './wallets-C541u9mn.js';
+export { E as ExecuteMigrateResponse, M as MigrateChipiWalletToShhhParams, a as MigrationOutcome, P as PrepareMigrateResponse, m as migrateChipiWalletToShhh } from './wallets-C541u9mn.js';
 import { ChipiTransactions } from './transactions.js';
 import { ChipiSkuPurchases } from './skuPurchases.js';
 import { ChipiSkus } from './skus.js';
-import { C as ChipiClient } from './client-CqD_yGH0.js';
+import { C as ChipiClient } from './client-D6SDBu5p.js';
 import { Call, ProviderInterface, Account } from 'starknet';
 
 /**
@@ -626,7 +626,11 @@ declare function isThinkDecision(decision: unknown): decision is ThinkDecision;
 declare class ChipiAi {
     private client;
     private apiSecretKey?;
-    constructor(client: ChipiClient, apiSecretKey?: string | undefined);
+    /** Needed only to pay think calls with `payWithSession`. */
+    private sessions?;
+    constructor(client: ChipiClient, apiSecretKey?: string | undefined, 
+    /** Needed only to pay think calls with `payWithSession`. */
+    sessions?: ChipiSessions | undefined);
     private secret;
     /**
      * `GET /v1/ai/signals`: technical signals per token, market sentiment and
@@ -639,8 +643,33 @@ declare class ChipiAi {
      *
      * The decision is advice, not an order: check it with `isThinkDecision` and
      * enforce your own limits before executing anything.
+     *
+     * **Paying per call (x402).** With `payWithSession`, a 402 that carries a
+     * session-transfer offer (credits short, x402 on) is paid with the agent's
+     * session key: a USDC `transfer` to the offer's `payTo`, then the same call
+     * again with `X-PAYMENT`. The price must be at most `maxAmount`, `model`
+     * must be payable and the input within `maxPromptBytes`, all checked before
+     * paying. The session must whitelist `transfer` and cap USDC. A payment
+     * that was made but not served is reported in `error.details.xPayment`;
+     * pass it back as `options.xPayment` to retry without paying again.
+     *
+     * @example
+     * ```typescript
+     * const res = await sdk.ai.think(
+     *   { portfolio, model: "haiku" },
+     *   { payWithSession: { encryptKey, wallet, session, maxAmount: 20_000n } } // $0.02 at most
+     * );
+     * res.x402Payment; // set when the call was paid over x402
+     * ```
+     */
+    think(params: ThinkParams, options?: ThinkOptions): Promise<ThinkResponse>;
+    private postThink;
+    /**
+     * Pay one think call with a session-key USDC transfer, then send it again
+     * with `X-PAYMENT`. Every check that can refuse the call runs before the
+     * transfer; the transfer counts only once its receipt shows the USDC moved.
      */
-    think(params: ThinkParams): Promise<ThinkResponse>;
+    private payAndThink;
     /**
      * `POST /v1/ai/execute`: unsigned AVNU swap calls (approve + swap) for
      * `walletAddress`. Nothing is submitted; sign the calls with a session key