@402flow/sdk-third-party-executors 0.1.0-alpha.26

package/README.md

@@ -0,0 +1,63 @@
+# @402flow/sdk-third-party-executors
+
+Official supported delegated-execution adapters for `@402flow/sdk`.
+
+This package is intentionally separate from the main `@402flow/sdk` package so the core SDK stays provider-neutral while officially supported provider adapters can evolve on their own dependency surface.
+
+Current scope:
+
+1. Dexter delegated-execution adapter
+2. pay.sh x402 Solana exact delegated-execution adapter
+
+## Install
+
+Install this package alongside the matching `@402flow/sdk` version.
+
+```bash
+npm install @402flow/sdk @402flow/sdk-third-party-executors
+```
+
+If you pin versions explicitly, pin both packages to the same version:
+
+```bash
+npm install @402flow/sdk@<version> @402flow/sdk-third-party-executors@<version>
+```
+
+This adapter package is versioned and supported in lockstep with `@402flow/sdk`, so keep the two package versions aligned.
+
+## Usage
+
+```ts
+import { AgentPayClient } from '@402flow/sdk';
+import {
+  createDexterExecutor,
+  createPayShExecutor,
+} from '@402flow/sdk-third-party-executors';
+```
+
+The main SDK package owns:
+
+1. the public executor contract
+2. delegated authorization and finalization
+3. outward result normalization to `PaidResponse` or `FetchPaidError`
+
+This package owns:
+
+1. provider-specific adapter implementations
+2. provider-specific proof tests
+3. source-level examples in this repo under `third-party-executors/examples/`
+
+## In-Repo Verification
+
+If you are working in this repo, useful commands are:
+
+1. `npm run check`
+2. `npm run pack:check`
+3. `npm run example:dexter-delegated-executor -- --help`
+4. `npm run example:pay-sh-delegated-executor -- --help`
+
+From the SDK root, you can also run `npm run check:all` to validate both the main SDK package and this package in one pass.
+
+## Release Order
+
+When publishing from this repo, publish the main `@402flow/sdk` package first, then publish `@402flow/sdk-third-party-executors` after the matching SDK version is available.

package/dist/dexter-executor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Dexter delegated-execution adapter for the repo-local third-party executors
+ * package.
+ *
+ * This module stays outside the main @402flow/sdk package so provider-specific
+ * SDK dependencies can evolve independently from the provider-neutral SDK core.
+ */
+import { type PayAndFetchOptions, type WalletSet } from '@dexterai/x402/client';
+import type { PreparedRequestExecutor } from '@402flow/sdk';
+export type DexterExecutorOptions = {
+    wallets: WalletSet;
+    payAndFetchOptions?: PayAndFetchOptions;
+};
+export declare function createDexterExecutor(options: DexterExecutorOptions): PreparedRequestExecutor;

package/dist/dexter-executor.js

@@ -0,0 +1,172 @@
+/**
+ * Dexter delegated-execution adapter for the repo-local third-party executors
+ * package.
+ *
+ * This module stays outside the main @402flow/sdk package so provider-specific
+ * SDK dependencies can evolve independently from the provider-neutral SDK core.
+ */
+import { getPaymentReceipt, payAndFetch, } from '@dexterai/x402/client';
+import { buildPreparedRequestInit, toSdkMerchantResponse } from './request-utils.js';
+export function createDexterExecutor(options) {
+    return {
+        provider: 'dexter',
+        async execute(input) {
+            const result = await payAndFetch(input.prepared.request.url, buildPreparedRequestInit(input.prepared), options.wallets, options.payAndFetchOptions ?? {});
+            return mapDexterPayResult(input, result);
+        },
+    };
+}
+async function mapDexterPayResult(input, result) {
+    const protocol = input.prepared.protocol;
+    if (result.ok && result.paid) {
+        const merchantResponse = result.response
+            ? await toSdkMerchantResponse(result.response)
+            : undefined;
+        const paymentReceipt = result.response
+            ? getPaymentReceipt(result.response)
+            : undefined;
+        const settlementReference = result.txSignature ?? paymentReceipt?.transaction;
+        const signerSubmissionEvidence = settlementReference
+            ? {
+                txHash: settlementReference,
+                paymentReference: settlementReference,
+            }
+            : undefined;
+        if (merchantResponse) {
+            return {
+                protocol,
+                executionStatus: 'succeeded',
+                settlementEvidenceClass: 'merchant_verifiable_success',
+                merchantOutcome: 'success_response',
+                ...(settlementReference
+                    ? {
+                        settlementReference,
+                        paymentReference: settlementReference,
+                    }
+                    : {}),
+                evidenceSource: settlementReference ? 'merchant' : undefined,
+                ...(signerSubmissionEvidence ? { signerSubmissionEvidence } : {}),
+                merchantResponse,
+                protocolArtifacts: buildDexterProtocolArtifacts(result, paymentReceipt),
+            };
+        }
+        return {
+            protocol,
+            executionStatus: 'inconclusive',
+            settlementEvidenceClass: 'settled',
+            merchantOutcome: 'no_response',
+            ...(settlementReference
+                ? {
+                    settlementReference,
+                    paymentReference: settlementReference,
+                }
+                : {}),
+            ...(signerSubmissionEvidence ? { signerSubmissionEvidence } : {}),
+            protocolArtifacts: buildDexterProtocolArtifacts(result),
+        };
+    }
+    if (result.ok) {
+        const merchantResponse = await toSdkMerchantResponse(result.response);
+        return {
+            protocol,
+            executionStatus: 'preflight_failed',
+            settlementEvidenceClass: 'none',
+            merchantOutcome: merchantResponse.status >= 400 ? 'failure_response' : 'success_response',
+            merchantResponse,
+            diagnostic: {
+                code: 'preflight_incompatible',
+                message: 'Dexter executor retried the request but the merchant did not demand payment.',
+            },
+            protocolArtifacts: buildDexterProtocolArtifacts(result),
+        };
+    }
+    const failureMapping = mapDexterFailure(result.reason);
+    return {
+        protocol,
+        executionStatus: failureMapping.executionStatus,
+        settlementEvidenceClass: failureMapping.settlementEvidenceClass,
+        merchantOutcome: failureMapping.merchantOutcome,
+        diagnostic: {
+            code: failureMapping.diagnosticCode,
+            ...(result.detail ? { message: result.detail } : {}),
+        },
+        protocolArtifacts: buildDexterProtocolArtifacts(result),
+    };
+}
+function mapDexterFailure(reason) {
+    switch (reason) {
+        case 'unsupported_network':
+        case 'insufficient_funds':
+        case 'budget_exceeded':
+        case 'no_payment_options':
+            return {
+                executionStatus: 'preflight_failed',
+                settlementEvidenceClass: 'none',
+                merchantOutcome: 'unknown',
+                diagnosticCode: 'preflight_incompatible',
+            };
+        case 'merchant_rejected':
+            return {
+                executionStatus: 'failed',
+                settlementEvidenceClass: 'none',
+                merchantOutcome: 'failure_response',
+                diagnosticCode: 'merchant_rejected',
+            };
+        case 'settlement_failed':
+            return {
+                executionStatus: 'failed',
+                settlementEvidenceClass: 'inconclusive',
+                merchantOutcome: 'unknown',
+                diagnosticCode: 'merchant_execution_failed',
+            };
+        case 'error':
+            return {
+                executionStatus: 'inconclusive',
+                settlementEvidenceClass: 'inconclusive',
+                merchantOutcome: 'no_response',
+                diagnosticCode: 'merchant_transport_lost',
+            };
+        case 'payment_unconfirmed':
+            return {
+                executionStatus: 'inconclusive',
+                settlementEvidenceClass: 'inconclusive',
+                merchantOutcome: 'no_response',
+                diagnosticCode: 'merchant_transport_lost',
+            };
+        case 'timeout':
+            return {
+                executionStatus: 'preflight_failed',
+                settlementEvidenceClass: 'none',
+                merchantOutcome: 'no_response',
+                diagnosticCode: 'merchant_transport_lost',
+            };
+    }
+}
+function buildDexterProtocolArtifacts(result, paymentReceipt) {
+    if (result.ok && result.paid) {
+        return {
+            dexter: {
+                paid: true,
+                amountPaid: result.amountPaid,
+                network: result.network.caip2,
+                ...(result.txSignature ? { txSignature: result.txSignature } : {}),
+                ...(paymentReceipt ? { paymentReceipt } : {}),
+            },
+        };
+    }
+    if (result.ok) {
+        return {
+            dexter: {
+                paid: false,
+                status: result.response.status,
+            },
+        };
+    }
+    return {
+        dexter: {
+            reason: result.reason,
+            ...(result.detail ? { detail: result.detail } : {}),
+        },
+    };
+}
+//# sourceMappingURL=dexter-executor.js.map

package/dist/dexter-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dexter-executor.js","sourceRoot":"","sources":["../src/dexter-executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,iBAAiB,EACjB,WAAW,GAIZ,MAAM,uBAAuB,CAAC;AAY/B,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAOrF,MAAM,UAAU,oBAAoB,CAClC,OAA8B;IAE9B,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAC1B,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,EACxC,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,kBAAkB,IAAI,EAAE,CACjC,CAAC;YAEF,OAAO,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,KAAmC,EACnC,MAAiB;IAEjB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAEzC,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ;YACtC,CAAC,CAAC,MAAM,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC9C,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ;YACpC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC;YACpC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,mBAAmB,GAAG,MAAM,CAAC,WAAW,IAAI,cAAc,EAAE,WAAW,CAAC;QAC9E,MAAM,wBAAwB,GAAG,mBAAmB;YAClD,CAAC,CAAC;gBACE,MAAM,EAAE,mBAAmB;gBAC3B,gBAAgB,EAAE,mBAAmB;aACtC;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO;gBACL,QAAQ;gBACR,eAAe,EAAE,WAAW;gBAC5B,uBAAuB,EAAE,6BAA6B;gBACtD,eAAe,EAAE,kBAAkB;gBACnC,GAAG,CAAC,mBAAmB;oBACrB,CAAC,CAAC;wBACE,mBAAmB;wBACnB,gBAAgB,EAAE,mBAAmB;qBACtC;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;gBAC5D,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjE,gBAAgB;gBAChB,iBAAiB,EAAE,4BAA4B,CAAC,MAAM,EAAE,cAAc,CAAC;aACxE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,QAAQ;YACR,eAAe,EAAE,cAAc;YAC/B,uBAAuB,EAAE,SAAS;YAClC,eAAe,EAAE,aAAa;YAC9B,GAAG,CAAC,mBAAmB;gBACrB,CAAC,CAAC;oBACE,mBAAmB;oBACnB,gBAAgB,EAAE,mBAAmB;iBACtC;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,iBAAiB,EAAE,4BAA4B,CAAC,MAAM,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEtE,OAAO;YACL,QAAQ;YACR,eAAe,EAAE,kBAAkB;YACnC,uBAAuB,EAAE,MAAM;YAC/B,eAAe,EACb,gBAAgB,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB;YAC1E,gBAAgB;YAChB,UAAU,EAAE;gBACV,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EACL,8EAA8E;aACjF;YACD,iBAAiB,EAAE,4BAA4B,CAAC,MAAM,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEvD,OAAO;QACL,QAAQ;QACR,eAAe,EAAE,cAAc,CAAC,eAAe;QAC/C,uBAAuB,EAAE,cAAc,CAAC,uBAAuB;QAC/D,eAAe,EAAE,cAAc,CAAC,eAAe;QAC/C,UAAU,EAAE;YACV,IAAI,EAAE,cAAc,CAAC,cAAc;YACnC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD;QACD,iBAAiB,EAAE,4BAA4B,CAAC,MAAM,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAmD;IAOnD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,qBAAqB,CAAC;QAC3B,KAAK,oBAAoB,CAAC;QAC1B,KAAK,iBAAiB,CAAC;QACvB,KAAK,oBAAoB;YACvB,OAAO;gBACL,eAAe,EAAE,kBAAkB;gBACnC,uBAAuB,EAAE,MAAM;gBAC/B,eAAe,EAAE,SAAS;gBAC1B,cAAc,EAAE,wBAAwB;aACzC,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO;gBACL,eAAe,EAAE,QAAQ;gBACzB,uBAAuB,EAAE,MAAM;gBAC/B,eAAe,EAAE,kBAAkB;gBACnC,cAAc,EAAE,mBAAmB;aACpC,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO;gBACL,eAAe,EAAE,QAAQ;gBACzB,uBAAuB,EAAE,cAAc;gBACvC,eAAe,EAAE,SAAS;gBAC1B,cAAc,EAAE,2BAA2B;aAC5C,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,eAAe,EAAE,cAAc;gBAC/B,uBAAuB,EAAE,cAAc;gBACvC,eAAe,EAAE,aAAa;gBAC9B,cAAc,EAAE,yBAAyB;aAC1C,CAAC;QACJ,KAAK,qBAAqB;YACxB,OAAO;gBACL,eAAe,EAAE,cAAc;gBAC/B,uBAAuB,EAAE,cAAc;gBACvC,eAAe,EAAE,aAAa;gBAC9B,cAAc,EAAE,yBAAyB;aAC1C,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO;gBACL,eAAe,EAAE,kBAAkB;gBACnC,uBAAuB,EAAE,MAAM;gBAC/B,eAAe,EAAE,aAAa;gBAC9B,cAAc,EAAE,yBAAyB;aAC1C,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CACnC,MAAiB,EACjB,cAAqD;IAErD,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE;gBACN,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;gBAC7B,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO;YACL,MAAM,EAAE;gBACN,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;aAC/B;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE;YACN,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createDexterExecutor } from './dexter-executor.js';
+export type { DexterExecutorOptions } from './dexter-executor.js';
+export { createPayShExecutor } from './pay-sh-executor.js';
+export type { PayShExecutorOptions } from './pay-sh-executor.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createDexterExecutor } from './dexter-executor.js';
+export { createPayShExecutor } from './pay-sh-executor.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/pay-sh-executor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Repo-local host-owned pay.sh adapter for x402 Solana exact delegated execution.
+ * The SDK still owns authorize/finalize; this module only performs the paid retry
+ * and normalizes the provider result into the delegated execution contract.
+ */
+import { x402HTTPClient, type PaymentPolicy, type SelectPaymentRequirements } from '@x402/core/client';
+import type { Network } from '@x402/core/types';
+import { type SvmClientConfig } from '@x402/svm/exact/client';
+import type { PreparedRequestExecutor } from '@402flow/sdk';
+type PayShX402HttpClient = Pick<x402HTTPClient, 'createPaymentPayload' | 'encodePaymentSignatureHeader' | 'getPaymentRequiredResponse' | 'processResponse'>;
+export type PayShExecutorOptions = {
+    signer: SvmClientConfig['signer'];
+    fetch?: typeof fetch;
+    networks?: Network[];
+    paymentRequirementsSelector?: SelectPaymentRequirements;
+    policies?: PaymentPolicy[];
+    rpcUrl?: string;
+    x402HttpClient?: PayShX402HttpClient;
+};
+export declare function createPayShExecutor(options: PayShExecutorOptions): PreparedRequestExecutor;
+export {};

package/dist/pay-sh-executor.js

@@ -0,0 +1,309 @@
+/**
+ * Repo-local host-owned pay.sh adapter for x402 Solana exact delegated execution.
+ * The SDK still owns authorize/finalize; this module only performs the paid retry
+ * and normalizes the provider result into the delegated execution contract.
+ */
+import { x402Client, x402HTTPClient, } from '@x402/core/client';
+import { ExactSvmScheme } from '@x402/svm/exact/client';
+import { buildPreparedRequestInit, toSdkMerchantResponse } from './request-utils.js';
+export function createPayShExecutor(options) {
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    const x402HttpClient = options.x402HttpClient ?? createDefaultX402HttpClient(options);
+    return {
+        provider: 'pay_sh',
+        async execute(input) {
+            if (input.prepared.protocol !== 'x402') {
+                return buildPreflightFailureResult(input.prepared.protocol, 'pay.sh x402 executor only supports x402 prepared requests.');
+            }
+            let paymentRequired;
+            try {
+                paymentRequired = readPreparedPaymentRequired(input.prepared, x402HttpClient);
+            }
+            catch (error) {
+                return buildPreflightFailureResult(input.prepared.protocol, error instanceof Error
+                    ? error.message
+                    : 'Unable to decode the x402 payment-required challenge.');
+            }
+            const supportedPaymentRequired = filterSupportedPaymentRequired(paymentRequired);
+            if (!supportedPaymentRequired) {
+                return buildPreflightFailureResult(input.prepared.protocol, 'pay.sh x402 executor requires an exact Solana payment candidate with a facilitator fee payer.');
+            }
+            let paymentPayload;
+            try {
+                paymentPayload = await x402HttpClient.createPaymentPayload(supportedPaymentRequired);
+            }
+            catch (error) {
+                return buildPreflightFailureResult(input.prepared.protocol, error instanceof Error
+                    ? error.message
+                    : 'pay.sh x402 payload creation failed before retry.');
+            }
+            if (!isSupportedSvmExactRequirement(paymentPayload.accepted)) {
+                return buildPreflightFailureResult(input.prepared.protocol, 'pay.sh x402 executor selected an unsupported payment requirement.');
+            }
+            let merchantResponse;
+            try {
+                merchantResponse = await fetchImpl(input.prepared.request.url, buildPreparedRequestInit(input.prepared, x402HttpClient.encodePaymentSignatureHeader(paymentPayload)));
+            }
+            catch (error) {
+                return buildTransportLossResult(input.prepared.protocol, error, {
+                    paySh: {
+                        x402Version: paymentPayload.x402Version,
+                        accepted: paymentPayload.accepted,
+                        payloadKeys: Object.keys(paymentPayload.payload),
+                    },
+                });
+            }
+            const sdkMerchantResponse = await toSdkMerchantResponse(merchantResponse.clone());
+            let processedResponse;
+            try {
+                processedResponse = await x402HttpClient.processResponse(merchantResponse);
+            }
+            catch (error) {
+                return buildProcessedResponseFailureResult(input.prepared.protocol, sdkMerchantResponse, error, paymentPayload);
+            }
+            return mapProcessedResponse(input.prepared, sdkMerchantResponse, processedResponse, paymentPayload);
+        },
+    };
+}
+function createDefaultX402HttpClient(options) {
+    const client = new x402Client(options.paymentRequirementsSelector);
+    for (const policy of options.policies ?? []) {
+        client.registerPolicy(policy);
+    }
+    const networks = options.networks?.length
+        ? options.networks
+        : ['solana:*'];
+    for (const network of networks) {
+        client.register(network, new ExactSvmScheme(options.signer, options.rpcUrl ? { rpcUrl: options.rpcUrl } : undefined));
+    }
+    return new x402HTTPClient(client);
+}
+function readPreparedPaymentRequired(prepared, x402HttpClient) {
+    const challengeHeaders = new Headers(prepared.challenge.headers);
+    return x402HttpClient.getPaymentRequiredResponse((name) => challengeHeaders.get(name) ?? undefined, prepared.challenge.body);
+}
+function filterSupportedPaymentRequired(paymentRequired) {
+    const accepts = paymentRequired.accepts.filter(isSupportedSvmExactRequirement);
+    if (accepts.length === 0) {
+        return undefined;
+    }
+    return {
+        ...paymentRequired,
+        accepts,
+    };
+}
+function isSupportedSvmExactRequirement(requirement) {
+    return (requirement.scheme === 'exact'
+        && requirement.network.startsWith('solana:')
+        && typeof requirement.amount === 'string'
+        && requirement.amount.length > 0
+        && typeof requirement.asset === 'string'
+        && requirement.asset.length > 0
+        && typeof requirement.payTo === 'string'
+        && requirement.payTo.length > 0
+        && typeof requirement.extra?.feePayer === 'string'
+        && requirement.extra.feePayer.length > 0);
+}
+function mapProcessedResponse(prepared, merchantResponse, processedResponse, paymentPayload) {
+    switch (processedResponse.kind) {
+        case 'success':
+            return buildSuccessfulResult(prepared.protocol, merchantResponse, processedResponse.settleResponse, paymentPayload);
+        case 'settle_failed':
+            return buildSettlementFailureResult(prepared.protocol, merchantResponse, processedResponse.settleResponse, paymentPayload);
+        case 'payment_required':
+            return {
+                protocol: prepared.protocol,
+                executionStatus: 'failed',
+                settlementEvidenceClass: 'none',
+                merchantOutcome: 'failure_response',
+                merchantResponse,
+                diagnostic: {
+                    code: 'merchant_rejected',
+                    message: processedResponse.paymentRequired.error
+                        ?? 'merchant HTTP 402: payment required',
+                },
+                protocolArtifacts: {
+                    paySh: {
+                        x402Version: paymentPayload.x402Version,
+                        accepted: paymentPayload.accepted,
+                        payloadKeys: Object.keys(paymentPayload.payload),
+                        paymentRequired: processedResponse.paymentRequired,
+                    },
+                },
+            };
+        case 'passthrough':
+            return {
+                protocol: prepared.protocol,
+                executionStatus: 'preflight_failed',
+                settlementEvidenceClass: 'none',
+                merchantOutcome: classifyMerchantOutcome(merchantResponse.status),
+                merchantResponse,
+                diagnostic: {
+                    code: 'preflight_incompatible',
+                    message: 'Merchant completed the request without returning x402 settlement evidence.',
+                },
+                protocolArtifacts: {
+                    paySh: {
+                        x402Version: paymentPayload.x402Version,
+                        accepted: paymentPayload.accepted,
+                        payloadKeys: Object.keys(paymentPayload.payload),
+                    },
+                },
+            };
+        case 'error': {
+            const diagnosticCode = merchantResponse.status >= 500
+                ? 'merchant_execution_failed'
+                : 'merchant_rejected';
+            return {
+                protocol: prepared.protocol,
+                executionStatus: 'failed',
+                settlementEvidenceClass: 'none',
+                merchantOutcome: classifyMerchantOutcome(merchantResponse.status),
+                merchantResponse,
+                diagnostic: {
+                    code: diagnosticCode,
+                    message: `merchant HTTP ${processedResponse.status}`,
+                },
+                protocolArtifacts: {
+                    paySh: {
+                        x402Version: paymentPayload.x402Version,
+                        accepted: paymentPayload.accepted,
+                        payloadKeys: Object.keys(paymentPayload.payload),
+                    },
+                },
+            };
+        }
+    }
+}
+function buildSuccessfulResult(protocol, merchantResponse, settleResponse, paymentPayload) {
+    const settlementReference = settleResponse.transaction;
+    return {
+        protocol,
+        executionStatus: 'succeeded',
+        settlementEvidenceClass: 'merchant_verifiable_success',
+        merchantOutcome: 'success_response',
+        settlementReference,
+        paymentReference: settlementReference,
+        evidenceSource: 'merchant',
+        signerSubmissionEvidence: {
+            txHash: settlementReference,
+            paymentReference: settlementReference,
+            ...(settleResponse.payer ? { payer: settleResponse.payer } : {}),
+            ...(settleResponse.amount ? { amountMinor: settleResponse.amount } : {}),
+            network: settleResponse.network,
+        },
+        merchantResponse,
+        protocolArtifacts: {
+            paySh: {
+                x402Version: paymentPayload.x402Version,
+                accepted: paymentPayload.accepted,
+                payloadKeys: Object.keys(paymentPayload.payload),
+                settleResponse,
+            },
+        },
+    };
+}
+function buildSettlementFailureResult(protocol, merchantResponse, settleResponse, paymentPayload) {
+    const settlementReference = settleResponse.transaction || undefined;
+    return {
+        protocol,
+        executionStatus: 'failed',
+        settlementEvidenceClass: settlementReference ? 'inconclusive' : 'none',
+        merchantOutcome: classifyMerchantOutcome(merchantResponse.status),
+        ...(settlementReference
+            ? {
+                settlementReference,
+                paymentReference: settlementReference,
+                evidenceSource: 'merchant',
+                signerSubmissionEvidence: {
+                    txHash: settlementReference,
+                    paymentReference: settlementReference,
+                    ...(settleResponse.payer ? { payer: settleResponse.payer } : {}),
+                    ...(settleResponse.amount ? { amountMinor: settleResponse.amount } : {}),
+                    network: settleResponse.network,
+                },
+            }
+            : {}),
+        merchantResponse,
+        diagnostic: {
+            code: 'merchant_execution_failed',
+            message: settleResponse.errorMessage
+                ?? settleResponse.errorReason
+                ?? `x402 settlement failed with HTTP ${merchantResponse.status}`,
+        },
+        protocolArtifacts: {
+            paySh: {
+                x402Version: paymentPayload.x402Version,
+                accepted: paymentPayload.accepted,
+                payloadKeys: Object.keys(paymentPayload.payload),
+                settleResponse,
+            },
+        },
+    };
+}
+function buildProcessedResponseFailureResult(protocol, merchantResponse, error, paymentPayload) {
+    return {
+        protocol,
+        executionStatus: merchantResponse.status >= 500 ? 'failed' : 'preflight_failed',
+        settlementEvidenceClass: 'none',
+        merchantOutcome: classifyMerchantOutcome(merchantResponse.status),
+        merchantResponse,
+        diagnostic: {
+            code: merchantResponse.status >= 500
+                ? 'merchant_execution_failed'
+                : 'preflight_incompatible',
+            message: error instanceof Error
+                ? error.message
+                : 'Unable to parse x402 settlement response from merchant.',
+        },
+        protocolArtifacts: {
+            paySh: {
+                x402Version: paymentPayload.x402Version,
+                accepted: paymentPayload.accepted,
+                payloadKeys: Object.keys(paymentPayload.payload),
+            },
+        },
+    };
+}
+function buildPreflightFailureResult(protocol, message) {
+    return {
+        protocol,
+        executionStatus: 'preflight_failed',
+        settlementEvidenceClass: 'none',
+        merchantOutcome: 'unknown',
+        diagnostic: {
+            code: 'preflight_incompatible',
+            message,
+        },
+        protocolArtifacts: {
+            paySh: {
+                stage: 'preflight',
+            },
+        },
+    };
+}
+function buildTransportLossResult(protocol, error, protocolArtifacts) {
+    return {
+        protocol,
+        executionStatus: 'inconclusive',
+        settlementEvidenceClass: 'none',
+        merchantOutcome: 'no_response',
+        diagnostic: {
+            code: 'merchant_transport_lost',
+            message: error instanceof Error
+                ? error.message
+                : 'Merchant transport failed after x402 payment dispatch.',
+        },
+        ...(protocolArtifacts ? { protocolArtifacts } : {}),
+    };
+}
+function classifyMerchantOutcome(status) {
+    if (status >= 400) {
+        return 'failure_response';
+    }
+    if (status >= 200 && status < 400) {
+        return 'success_response';
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=pay-sh-executor.js.map

package/dist/pay-sh-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pay-sh-executor.js","sourceRoot":"","sources":["../src/pay-sh-executor.ts"],"names":[],"mappings":"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"}

package/dist/request-utils.d.ts

@@ -0,0 +1,4 @@
+import type { SdkMerchantResponse, SdkPreparedPaidRequestReady } from '@402flow/sdk';
+export declare function buildPreparedRequestInit(prepared: SdkPreparedPaidRequestReady, extraHeaders?: HeadersInit): RequestInit;
+export declare function toSdkMerchantResponse(response: Response): Promise<SdkMerchantResponse>;
+export declare function normalizeHeaders(headers: HeadersInit | undefined): Record<string, string>;

package/dist/request-utils.js

@@ -0,0 +1,33 @@
+export function buildPreparedRequestInit(prepared, extraHeaders) {
+    const headers = normalizeHeaders(prepared.request.headers);
+    if (extraHeaders) {
+        const extraHeaderMap = new Headers(extraHeaders);
+        extraHeaderMap.forEach((value, key) => {
+            headers[key] = value;
+        });
+    }
+    return {
+        method: prepared.request.method,
+        ...(Object.keys(headers).length > 0 ? { headers } : {}),
+        ...(prepared.request.body !== undefined ? { body: prepared.request.body } : {}),
+    };
+}
+export async function toSdkMerchantResponse(response) {
+    return {
+        status: response.status,
+        headers: normalizeHeaders(response.headers),
+        body: await response.text(),
+    };
+}
+export function normalizeHeaders(headers) {
+    if (!headers) {
+        return {};
+    }
+    const normalizedHeaders = {};
+    const headerMap = new Headers(headers);
+    headerMap.forEach((value, key) => {
+        normalizedHeaders[key] = value;
+    });
+    return normalizedHeaders;
+}
+//# sourceMappingURL=request-utils.js.map

package/dist/request-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-utils.js","sourceRoot":"","sources":["../src/request-utils.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,wBAAwB,CACtC,QAAqC,EACrC,YAA0B;IAE1B,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;QAEjD,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACpC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;QAC/B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAkB;IAElB,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC3C,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,iBAAiB,GAA2B,EAAE,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC/B,iBAAiB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@402flow/sdk-third-party-executors",
+  "version": "0.1.0-alpha.26",
+  "type": "module",
+  "description": "Official supported delegated-execution adapters for @402flow/sdk.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "license": "Apache-2.0",
+  "author": "402flow",
+  "homepage": "https://github.com/402flow/sdk/tree/main/third-party-executors#readme",
+  "bugs": {
+    "url": "https://github.com/402flow/sdk/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/402flow/sdk.git",
+    "directory": "third-party-executors"
+  },
+  "keywords": [
+    "402flow",
+    "sdk",
+    "x402",
+    "adapters",
+    "dexter",
+    "pay.sh"
+  ],
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@402flow/sdk": "0.1.0-alpha.26"
+  },
+  "peerDependenciesMeta": {
+    "@402flow/sdk": {
+      "optional": true
+    }
+  },
+  "overrides": {
+    "jayson": {
+      "uuid": "11.1.1"
+    }
+  },
+  "scripts": {
+    "build": "npm --prefix .. run build && npm run clean && tsc -p tsconfig.build.json",
+    "check": "npm run lint && npm test",
+    "clean": "node -e \"const fs = require('node:fs'); for (const path of ['dist', 'tsconfig.build.tsbuildinfo', 'tsconfig.tsbuildinfo', 'tsconfig.typecheck.tsbuildinfo']) { fs.rmSync(path, { recursive: true, force: true }); }\"",
+    "example:dexter-delegated-executor": "npm run build && node examples/dexter-delegated-executor.mjs",
+    "example:pay-sh-delegated-executor": "npm run build && node examples/pay-sh-delegated-executor.mjs",
+    "lint": "eslint src test vitest.config.ts && npm run typecheck",
+    "pack:check": "npm run build && npm pack --dry-run",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run check",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@dexterai/x402": "^3.9.0",
+    "@solana/kit": "^6.5.0",
+    "@x402/core": "^2.13.0",
+    "@x402/svm": "^2.13.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.22.0",
+    "@types/node": "^22.13.10",
+    "eslint": "^9.22.0",
+    "globals": "^15.15.0",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.26.1",
+    "vitest": "^3.0.8"
+  }
+}