@pulseai/sdk 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -12,7 +12,7 @@ type PulseAddresses = {
 };
 /** 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;
 /** Default indexer URLs by network. */
 declare const DEFAULT_INDEXER_URLS: {
@@ -171,8 +171,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 +187,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 +326,7 @@ type JobContext = {
     priceUsdm: string;
     slaMinutes: number;
     requirements?: Record<string, unknown>;
+    abortSignal?: AbortSignal;
 };
 type ExecuteJobResult = {
     type: 'inline' | 'url';
@@ -336,6 +345,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 +526,27 @@ 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;
+    raw: unknown;
+};
+type AICallOptions = CallAIParams;
+type AICallResult = CallAIResult;
+declare function callAI(params: CallAIParams): Promise<CallAIResult>;
+
 type IndexerClientOptions = {
     baseUrl: string;
     timeoutMs?: number;
@@ -577,6 +629,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 +703,7 @@ declare class BuyerRuntime {
 type HandlerProviderRuntimeOptions = {
     pollInterval?: number;
     indexerUrl: string;
+    executionTimeoutMs?: number;
 };
 declare class HandlerProviderRuntime {
     private client;
@@ -654,8 +712,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 +726,10 @@ declare class HandlerProviderRuntime {
     private poll;
     private checkNewJobs;
     private checkInProgressJobs;
+    private canProcess;
+    private markProcessed;
+    private markFailed;
+    private getRemainingSlaMs;
 }
 
 declare const pulseExtensionAbi: readonly [{
@@ -3158,4 +3223,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, 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 };