@pulseai/sdk 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -9,11 +9,14 @@ type PulseAddresses = {
     identityRegistry: Address;
     reputationRegistry: Address;
     usdm: Address;
+    buyerRelay?: Address;
 };
 /** Full Pulse contract addresses on MegaETH Testnet. */
 declare const TESTNET_ADDRESSES: PulseAddresses;
 /** Full Pulse contract addresses on MegaETH Mainnet. */
 declare const MAINNET_ADDRESSES: PulseAddresses;
+/** Platform buyer agent ID on MegaETH Mainnet (owned by BuyerRelay). */
+declare const PLATFORM_BUYER_AGENT_ID = 8154n;
 /** Default indexer URLs by network. */
 declare const DEFAULT_INDEXER_URLS: {
     readonly testnet: "https://pulse-indexer.up.railway.app";
@@ -318,6 +321,32 @@ declare function createRequirements(params: RequirementsParams): {
     hash: Hex;
 };
 
+type JsonSchema = {
+    type: 'object';
+    properties: Record<string, {
+        type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+        description?: string;
+        enum?: unknown[];
+        items?: {
+            type: string;
+        };
+    }>;
+    required?: string[];
+};
+/** Pulse offering schema document (JSON Schema-based). */
+type OfferingSchema = {
+    version: number;
+    serviceRequirements: JsonSchema;
+    deliverableRequirements: JsonSchema;
+};
+/** Default schemas by service type (Custom/5 intentionally omitted). */
+declare const DEFAULT_SCHEMAS: Record<number, OfferingSchema>;
+/** Validate runtime data against a compact JSON Schema object definition. */
+declare function validateAgainstSchema(data: Record<string, unknown> | undefined, schema: JsonSchema): {
+    valid: boolean;
+    reason?: string;
+};
+
 type JobContext = {
     jobId: bigint;
     offeringId: bigint;
@@ -333,6 +362,11 @@ type ExecuteJobResult = {
     content?: string;
     url?: string;
     mimeType?: string;
+    usage?: {
+        provider: string;
+        inputTokens: number;
+        outputTokens: number;
+    };
 };
 type ValidationResult = {
     valid: boolean;
@@ -341,6 +375,7 @@ type ValidationResult = {
 interface OfferingHandler {
     offeringId: number;
     autoAccept?: boolean;
+    schema?: OfferingSchema;
     validateRequirements?(context: JobContext): Promise<ValidationResult>;
     executeJob(context: JobContext): Promise<ExecuteJobResult>;
 }
@@ -357,6 +392,7 @@ type SiteModifierConfig = {
 declare class SiteModifierHandler implements OfferingHandler {
     readonly offeringId: number;
     readonly autoAccept?: boolean;
+    readonly schema: OfferingSchema;
     private readonly config;
     constructor(offeringId: number, config: SiteModifierConfig, options?: {
         autoAccept?: boolean;
@@ -539,9 +575,15 @@ type CallAIParams = {
     maxTokens?: number;
     signal?: AbortSignal;
 };
+type AIUsage = {
+    inputTokens: number;
+    outputTokens: number;
+};
 type CallAIResult = {
     content: string;
+    truncated: boolean;
     raw: unknown;
+    usage?: AIUsage;
 };
 type AICallOptions = CallAIParams;
 type AICallResult = CallAIResult;
@@ -584,6 +626,7 @@ interface IndexerOffering {
     priceUsdm: string;
     slaMinutes: number | null;
     description: string | null;
+    requirementsSchemaUri?: string;
     active: boolean;
     blockNumber: number | null;
     txHash: string | null;
@@ -716,6 +759,7 @@ declare class HandlerProviderRuntime {
     private running;
     private processedJobs;
     private failedJobs;
+    private schemaCache;
     private readonly maxRetries;
     private onError?;
     constructor(client: PulseClient, agentId: bigint, options: HandlerProviderRuntimeOptions);
@@ -726,9 +770,15 @@ declare class HandlerProviderRuntime {
     private poll;
     private checkNewJobs;
     private checkInProgressJobs;
+    private checkEvaluatedJobs;
     private canProcess;
     private markProcessed;
     private markFailed;
+    private validateSchemaRequirements;
+    private resolveOfferingSchemaFromUri;
+    private parseDataUriJson;
+    private isOfferingSchema;
+    private isJsonSchema;
     private getRemainingSlaMs;
 }
 
@@ -3032,6 +3082,407 @@ declare const erc20Abi: readonly [{
     readonly stateMutability: "nonpayable";
 }];
 
+declare const buyerRelayAbi: readonly [{
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "owner_";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "identityRegistry_";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "pulseExtension_";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "jobEngine_";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "serviceMarketplace_";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "usdm_";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "buyerAgentId";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "cancelFor";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "claimRefund";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "createJobFor";
+    readonly inputs: readonly [{
+        readonly name: "offeringId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "termsHash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "maxPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "evaluateFor";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "approved";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }, {
+        readonly name: "feedback";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "identityRegistry";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IERC8004Identity";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "jobDeposit";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "jobEngine";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IJobEngine";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "jobPayer";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "jobRefundState";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+        readonly internalType: "enum IBuyerRelay.RefundState";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "onERC721Received";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes4";
+        readonly internalType: "bytes4";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "pulseExtension";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IPulseExtension";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "renounceOwnership";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "serviceMarketplace";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IServiceMarketplace";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "setup";
+    readonly inputs: readonly [{
+        readonly name: "agentURI";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferOwnership";
+    readonly inputs: readonly [{
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "usdm";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "EvaluatedFor";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "payer";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "approved";
+        readonly type: "bool";
+        readonly indexed: false;
+        readonly internalType: "bool";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "JobCreatedFor";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "payer";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "price";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "RefundClaimed";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "payer";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "AgentAlreadyInitialized";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AgentNotActive";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientPayment";
+    readonly inputs: readonly [{
+        readonly name: "required";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "provided";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidJobStatus";
+    readonly inputs: readonly [{
+        readonly name: "current";
+        readonly type: "uint8";
+        readonly internalType: "enum DataTypes.JobStatus";
+    }, {
+        readonly name: "expected";
+        readonly type: "uint8";
+        readonly internalType: "enum DataTypes.JobStatus";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidRefundState";
+    readonly inputs: readonly [{
+        readonly name: "current";
+        readonly type: "uint8";
+        readonly internalType: "enum IBuyerRelay.RefundState";
+    }, {
+        readonly name: "expected";
+        readonly type: "uint8";
+        readonly internalType: "enum IBuyerRelay.RefundState";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "OnlyBuyer";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OwnableInvalidOwner";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "OwnableUnauthorizedAccount";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "Reentrancy";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}];
+
 declare const pageAbi: readonly [{
     readonly type: "constructor";
     readonly inputs: readonly [{
@@ -3223,4 +3674,4 @@ declare const masterAbi: readonly [{
     readonly anonymous: false;
 }];
 
-export { ACCEPT_TIMEOUT, type AICallOptions, type AICallResult, type AIMessage, type AIProvider, type AgentCardParams, BPS_DENOMINATOR, type BuyerCallbacks, BuyerRuntime, type BuyerRuntimeOptions, type CreateJobParams, type CreatePresetPulseClientOptions, type CreatePulseClientOptions, DEFAULT_INDEXER_URLS, type DeliverableData, type DeliverableParams, EVALUATION_TIMEOUT, type ExecuteJobResult, FEE_BPS, HandlerProviderRuntime, type HandlerProviderRuntimeOptions, type IndexerAgent, IndexerClient, IndexerClientError, type IndexerClientOptions, type IndexerJob, type IndexerJobsFilter, type IndexerOffering, type IndexerOfferingsFilter, type IndexerWarrenLink, type IndexerWarrenLinks, type Job, type JobContext, type JobOffering, JobStatus, type JobTermsParams, type ListOfferingParams, MAINNET_ADDRESSES, MEMO_TYPES, type OfferingHandler, PULSE_DOMAIN, type PresetPulseClient, type ProviderCallbacks, ProviderRuntime, type ProviderRuntimeOptions, type PulseAddresses, type PulseAgentData, type PulseClient, RISK_POOL_BPS, type RequirementsData, type RequirementsParams, ServiceType, type SignMemoParams, type SiteModifierConfig, SiteModifierHandler, TESTNET_ADDRESSES, TREASURY_BPS, USDM_MAINNET, type ValidationResult, acceptJob, activateOffering, callAI, cancelJob, createAgentCard, createDeliverable, createJob, createJobTerms, createMainnetClient, createPulseClient, createRequirements, createTestnetClient, deactivateOffering, deployAgentCard, deployDeliverable, deployJobTerms, deployRequirements, deployWarrenMaster, deployWarrenPage, erc20Abi, erc8004IdentityAbi, erc8004ReputationAbi, evaluate, feeDistributorAbi, formatUsdm, getAgent, getJob, getJobCount, getOffering, getOfferingCount, initAgent, jobEngineAbi, listOffering, mainnetERC8004, masterAbi, megaethMainnet, megaethTestnet, pageAbi, parseUsdm, pulseExtensionAbi, readDeliverable, readRequirements, readWarrenMaster, readWarrenPage, registerAgent, rejectJob, resolveDispute, serviceMarketplaceAbi, setOperator, setWarrenContract, settle, signMemo, submitDeliverable, testnetERC8004, updateOffering, verifyContentHash };
+export { ACCEPT_TIMEOUT, type AICallOptions, type AICallResult, type AIMessage, type AIProvider, type AIUsage, type AgentCardParams, BPS_DENOMINATOR, type BuyerCallbacks, BuyerRuntime, type BuyerRuntimeOptions, type CreateJobParams, type CreatePresetPulseClientOptions, type CreatePulseClientOptions, DEFAULT_INDEXER_URLS, DEFAULT_SCHEMAS, type DeliverableData, type DeliverableParams, EVALUATION_TIMEOUT, type ExecuteJobResult, FEE_BPS, HandlerProviderRuntime, type HandlerProviderRuntimeOptions, type IndexerAgent, IndexerClient, IndexerClientError, type IndexerClientOptions, type IndexerJob, type IndexerJobsFilter, type IndexerOffering, type IndexerOfferingsFilter, type IndexerWarrenLink, type IndexerWarrenLinks, type Job, type JobContext, type JobOffering, JobStatus, type JobTermsParams, type JsonSchema, type ListOfferingParams, MAINNET_ADDRESSES, MEMO_TYPES, type OfferingHandler, type OfferingSchema, PLATFORM_BUYER_AGENT_ID, PULSE_DOMAIN, type PresetPulseClient, type ProviderCallbacks, ProviderRuntime, type ProviderRuntimeOptions, type PulseAddresses, type PulseAgentData, type PulseClient, RISK_POOL_BPS, type RequirementsData, type RequirementsParams, ServiceType, type SignMemoParams, type SiteModifierConfig, SiteModifierHandler, TESTNET_ADDRESSES, TREASURY_BPS, USDM_MAINNET, type ValidationResult, acceptJob, activateOffering, buyerRelayAbi, callAI, cancelJob, createAgentCard, createDeliverable, createJob, createJobTerms, createMainnetClient, createPulseClient, createRequirements, createTestnetClient, deactivateOffering, deployAgentCard, deployDeliverable, deployJobTerms, deployRequirements, deployWarrenMaster, deployWarrenPage, erc20Abi, erc8004IdentityAbi, erc8004ReputationAbi, evaluate, feeDistributorAbi, formatUsdm, getAgent, getJob, getJobCount, getOffering, getOfferingCount, initAgent, jobEngineAbi, listOffering, mainnetERC8004, masterAbi, megaethMainnet, megaethTestnet, pageAbi, parseUsdm, pulseExtensionAbi, readDeliverable, readRequirements, readWarrenMaster, readWarrenPage, registerAgent, rejectJob, resolveDispute, serviceMarketplaceAbi, setOperator, setWarrenContract, settle, signMemo, submitDeliverable, testnetERC8004, updateOffering, validateAgainstSchema, verifyContentHash };