@pulseai/sdk 0.1.0 → 0.1.2

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 (partial placeholders). */
+/** 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";
@@ -171,8 +174,12 @@ declare function createJob(client: PulseClient, params: CreateJobParams): Promis
  * Accept a job as provider: generate EIP-712 signature + call acceptJob.
  */
 declare function acceptJob(client: PulseClient, jobId: bigint, warrenTermsHash: Hex): Promise<Hash>;
-/** Submit a deliverable hash for an in-progress job. */
-declare function submitDeliverable(client: PulseClient, jobId: bigint, deliverableHash: Hex): Promise<Hash>;
+/** Submit a deliverable hash for an in-progress job.
+ *  Optionally store the deliverable content in the indexer. */
+declare function submitDeliverable(client: PulseClient, jobId: bigint, deliverableHash: Hex, options?: {
+    content?: string;
+    indexerUrl?: string;
+}): Promise<Hash>;
 /** Evaluate a delivered job. */
 declare function evaluate(client: PulseClient, jobId: bigint, approved: boolean, feedback: string): Promise<Hash>;
 /** Settle an evaluated (or auto-approved) job. */
@@ -183,6 +190,10 @@ declare function cancelJob(client: PulseClient, jobId: bigint): Promise<Hash>;
 declare function getJob(client: PulseClient, jobId: bigint): Promise<Job>;
 /** Get the total number of jobs. */
 declare function getJobCount(client: PulseClient): Promise<bigint>;
+/** Reject a delivered job (raises dispute). */
+declare function rejectJob(client: PulseClient, jobId: bigint, feedback: string): Promise<Hash>;
+/** Resolve a dispute (owner only). */
+declare function resolveDispute(client: PulseClient, jobId: bigint, favorBuyer: boolean): Promise<Hash>;
 
 /** Deploy raw content to a SSTORE2 Page contract. */
 declare function deployWarrenPage(client: PulseClient, content: string): Promise<{
@@ -318,6 +329,7 @@ type JobContext = {
     priceUsdm: string;
     slaMinutes: number;
     requirements?: Record<string, unknown>;
+    abortSignal?: AbortSignal;
 };
 type ExecuteJobResult = {
     type: 'inline' | 'url';
@@ -336,6 +348,28 @@ interface OfferingHandler {
     executeJob(context: JobContext): Promise<ExecuteJobResult>;
 }
 
+type SiteModifierConfig = {
+    defaultProvider?: 'anthropic' | 'google' | 'openai';
+    defaultModel?: string;
+    maxTokens?: number;
+    systemPrompt?: string;
+    indexerUrl: string;
+    getApiKey: (provider: string) => Promise<string | null>;
+    allowedDomains?: string[];
+};
+declare class SiteModifierHandler implements OfferingHandler {
+    readonly offeringId: number;
+    readonly autoAccept?: boolean;
+    private readonly config;
+    constructor(offeringId: number, config: SiteModifierConfig, options?: {
+        autoAccept?: boolean;
+    });
+    validateRequirements(context: JobContext): Promise<ValidationResult>;
+    executeJob(context: JobContext): Promise<ExecuteJobResult>;
+    private parseRequirements;
+    private fetchHtmlWithTimeout;
+}
+
 /**
  * EIP-712 type definition matching MemoLib.sol MEMO_TYPEHASH:
  * "Memo(uint256 jobId,address signer,bytes32 contentHash,uint64 timestamp,uint256 nonce)"
@@ -495,6 +529,28 @@ declare const megaethMainnet: {
     verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
 };
 
+type AIProvider = 'anthropic' | 'google' | 'openai';
+type AIMessage = {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+};
+type CallAIParams = {
+    provider: AIProvider;
+    model: string;
+    apiKey: string;
+    messages: AIMessage[];
+    maxTokens?: number;
+    signal?: AbortSignal;
+};
+type CallAIResult = {
+    content: string;
+    truncated: boolean;
+    raw: unknown;
+};
+type AICallOptions = CallAIParams;
+type AICallResult = CallAIResult;
+declare function callAI(params: CallAIParams): Promise<CallAIResult>;
+
 type IndexerClientOptions = {
     baseUrl: string;
     timeoutMs?: number;
@@ -577,6 +633,11 @@ declare class IndexerClient {
     getAgent(agentId: number): Promise<IndexerAgent>;
     registerWarrenLink(jobId: number, linkType: string, masterAddress: string, contentHash: string): Promise<void>;
     getWarrenLinks(jobId: number): Promise<IndexerWarrenLinks>;
+    postDeliverable(jobId: number, content: string, contentHash: string, storageType?: string): Promise<void>;
+    getDeliverable(jobId: number): Promise<{
+        content: string;
+        storageType: string;
+    } | null>;
     private request;
     private requestJson;
     private parseResponse;
@@ -646,6 +707,7 @@ declare class BuyerRuntime {
 type HandlerProviderRuntimeOptions = {
     pollInterval?: number;
     indexerUrl: string;
+    executionTimeoutMs?: number;
 };
 declare class HandlerProviderRuntime {
     private client;
@@ -654,8 +716,11 @@ declare class HandlerProviderRuntime {
     private indexer;
     private indexerUrl;
     private pollInterval;
+    private executionTimeoutMs;
     private running;
     private processedJobs;
+    private failedJobs;
+    private readonly maxRetries;
     private onError?;
     constructor(client: PulseClient, agentId: bigint, options: HandlerProviderRuntimeOptions);
     registerHandler(handler: OfferingHandler): void;
@@ -665,6 +730,11 @@ declare class HandlerProviderRuntime {
     private poll;
     private checkNewJobs;
     private checkInProgressJobs;
+    private checkEvaluatedJobs;
+    private canProcess;
+    private markProcessed;
+    private markFailed;
+    private getRemainingSlaMs;
 }
 
 declare const pulseExtensionAbi: readonly [{
@@ -2967,6 +3037,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 [{
@@ -3158,4 +3629,4 @@ declare const masterAbi: readonly [{
     readonly anonymous: false;
 }];
 
-export { ACCEPT_TIMEOUT, 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, TESTNET_ADDRESSES, TREASURY_BPS, USDM_MAINNET, type ValidationResult, acceptJob, activateOffering, 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, serviceMarketplaceAbi, setOperator, setWarrenContract, settle, signMemo, submitDeliverable, testnetERC8004, updateOffering, verifyContentHash };
+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, 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, verifyContentHash };