@pulseai/sdk 0.1.0 → 0.1.2

package/dist/index.js

@@ -34,16 +34,17 @@ var TESTNET_ADDRESSES = {
   reputationRegistry: "0x8004B663056A597Dffe9eCcC1965A193B7388713",
   usdm: "0x939Ff43f7c4A2E94069af7DBbc4497377DdcCE3f"
 };
-var PLACEHOLDER_ADDRESS = "0x0";
 var MAINNET_ADDRESSES = {
-  pulseExtension: PLACEHOLDER_ADDRESS,
-  serviceMarketplace: PLACEHOLDER_ADDRESS,
-  jobEngine: PLACEHOLDER_ADDRESS,
-  feeDistributor: PLACEHOLDER_ADDRESS,
+  pulseExtension: "0xf1616D2008c4Ff5Ed7BDBd448DAE68615b7A71f0",
+  serviceMarketplace: "0xfC180058FCB69531818B832C12473302811dfFF6",
+  jobEngine: "0xb5E56262b55aE453E8B16470228F0a5Ef617FF67",
+  feeDistributor: "0x51EdD8E4C4B423b952821fc9e2a7dad15a858B56",
   identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
   reputationRegistry: "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
-  usdm: "0xFAfDdbb3FC7688494971a79cc65DCa3EF82079E7"
+  usdm: "0xFAfDdbb3FC7688494971a79cc65DCa3EF82079E7",
+  buyerRelay: "0x633054593db34c5aAe36F784faeAe51b9604e037"
 };
+var PLATFORM_BUYER_AGENT_ID = 8154n;
 var DEFAULT_INDEXER_URLS = {
   testnet: "https://pulse-indexer.up.railway.app",
   mainnet: "https://pulse-indexer.up.railway.app"
@@ -2387,13 +2388,29 @@ async function acceptJob(client, jobId, warrenTermsHash) {
     args: [jobId, signature]
   });
 }
-async function submitDeliverable(client, jobId, deliverableHash) {
-  return write(client, {
+async function submitDeliverable(client, jobId, deliverableHash, options) {
+  const txHash = await write(client, {
     address: client.addresses.jobEngine,
     abi: jobEngineAbi,
     functionName: "submitDeliverable",
     args: [jobId, deliverableHash]
   });
+  if (options?.content && options?.indexerUrl) {
+    try {
+      await fetch(`${options.indexerUrl.replace(/\/$/, "")}/deliverables`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          jobId: Number(jobId),
+          content: options.content,
+          contentHash: deliverableHash,
+          storageType: "indexer"
+        })
+      });
+    } catch {
+    }
+  }
+  return txHash;
 }
 async function evaluate(client, jobId, approved, feedback) {
   return write(client, {
@@ -2435,6 +2452,17 @@ async function getJobCount(client) {
     functionName: "getJobCount"
   });
 }
+async function rejectJob(client, jobId, feedback) {
+  return evaluate(client, jobId, false, feedback);
+}
+async function resolveDispute(client, jobId, favorBuyer) {
+  return write(client, {
+    address: client.addresses.jobEngine,
+    abi: jobEngineAbi,
+    functionName: "resolveDispute",
+    args: [jobId, favorBuyer]
+  });
+}
 
 // src/warren/index.ts
 import { keccak256, toHex as toHex2 } from "viem";
@@ -2638,10 +2666,17 @@ async function deployJobTerms(client, agentId, params) {
   const { masterAddress } = await deployWarrenMaster(client, agentId, pageAddress, contentBytes.length, 0);
   return { masterAddress, pageAddress, hash, txHash };
 }
+function stripCodeFence(content) {
+  let result = content.trim();
+  result = result.replace(/^```\w*\n?/, "");
+  result = result.replace(/\n?```\s*$/, "");
+  return result;
+}
 async function deployDeliverable(client, agentId, jobId, params, indexerUrl) {
   const { json, hash } = createDeliverable(params);
-  const contentBytes = new TextEncoder().encode(json);
-  const { pageAddress, txHash } = await deployWarrenPage(client, json);
+  const warrenContent = params.type === "inline" && params.content ? stripCodeFence(params.content) : json;
+  const contentBytes = new TextEncoder().encode(warrenContent);
+  const { pageAddress, txHash } = await deployWarrenPage(client, warrenContent);
   const { masterAddress } = await deployWarrenMaster(client, agentId, pageAddress, contentBytes.length, 1);
   await write(client, {
     address: client.addresses.jobEngine,
@@ -2664,6 +2699,21 @@ async function deployDeliverable(client, agentId, jobId, params, indexerUrl) {
     } catch {
     }
   }
+  if (indexerUrl) {
+    try {
+      await fetch(`${indexerUrl.replace(/\/$/, "")}/deliverables`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          jobId: Number(jobId),
+          content: json,
+          contentHash: hash,
+          storageType: "warren"
+        })
+      });
+    } catch {
+    }
+  }
   return { masterAddress, pageAddress, hash, txHash };
 }
 async function readDeliverable(client, jobId, indexerUrl) {
@@ -2787,6 +2837,520 @@ function createRequirements(params) {
   return { json, hash };
 }
 
+// src/ai/provider.ts
+function parseErrorMessage(payload) {
+  if (typeof payload !== "object" || payload === null) return null;
+  const record = payload;
+  const error = record.error;
+  if (typeof error === "string") return error;
+  if (typeof error === "object" && error !== null) {
+    const message2 = error.message;
+    if (typeof message2 === "string" && message2.length > 0) return message2;
+  }
+  const message = record.message;
+  if (typeof message === "string" && message.length > 0) return message;
+  return null;
+}
+function extractTextContent(content) {
+  if (typeof content === "string") return content.trim();
+  if (!Array.isArray(content)) return "";
+  return content.map((entry) => {
+    if (typeof entry === "string") return entry;
+    if (typeof entry !== "object" || entry === null) return "";
+    const text = entry.text;
+    return typeof text === "string" ? text : "";
+  }).join("\n").trim();
+}
+async function parseJsonResponse(response) {
+  try {
+    return await response.json();
+  } catch {
+    return null;
+  }
+}
+async function callOpenAI(params) {
+  const response = await fetch("https://api.openai.com/v1/chat/completions", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${params.apiKey}`
+    },
+    body: JSON.stringify({
+      model: params.model,
+      messages: params.messages.map((message) => ({
+        role: message.role,
+        content: message.content
+      })),
+      max_tokens: params.maxTokens
+    }),
+    signal: params.signal
+  });
+  const payload = await parseJsonResponse(response);
+  if (!response.ok) {
+    throw new Error(
+      `OpenAI request failed (${response.status}): ${parseErrorMessage(payload) ?? response.statusText}`
+    );
+  }
+  const content = extractTextContent(payload?.choices?.[0]?.message?.content);
+  if (!content) {
+    throw new Error("OpenAI returned an empty response");
+  }
+  const truncated = payload?.choices?.[0]?.finish_reason === "length";
+  return { content, truncated, raw: payload };
+}
+async function callAnthropic(params) {
+  const systemPrompt = params.messages.filter((message) => message.role === "system").map((message) => message.content).join("\n\n").trim();
+  const messages = params.messages.filter((message) => message.role !== "system").map((message) => ({
+    role: message.role === "assistant" ? "assistant" : "user",
+    content: message.content
+  }));
+  const response = await fetch("https://api.anthropic.com/v1/messages", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": params.apiKey,
+      "anthropic-version": "2023-06-01"
+    },
+    body: JSON.stringify({
+      model: params.model,
+      max_tokens: params.maxTokens ?? 1024,
+      system: systemPrompt.length > 0 ? systemPrompt : void 0,
+      messages
+    }),
+    signal: params.signal
+  });
+  const payload = await parseJsonResponse(response);
+  if (!response.ok) {
+    throw new Error(
+      `Anthropic request failed (${response.status}): ${parseErrorMessage(payload) ?? response.statusText}`
+    );
+  }
+  const content = extractTextContent(payload?.content);
+  if (!content) {
+    throw new Error("Anthropic returned an empty response");
+  }
+  const truncated = payload?.stop_reason === "max_tokens";
+  return { content, truncated, raw: payload };
+}
+async function callGoogle(params) {
+  const systemPrompt = params.messages.filter((message) => message.role === "system").map((message) => message.content).join("\n\n").trim();
+  const contents = params.messages.filter((message) => message.role !== "system").map((message) => ({
+    role: message.role === "assistant" ? "model" : "user",
+    parts: [{ text: message.content }]
+  }));
+  const url = new URL(
+    `https://generativelanguage.googleapis.com/v1beta/models/${encodeURIComponent(params.model)}:generateContent`
+  );
+  url.searchParams.set("key", params.apiKey);
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      contents,
+      systemInstruction: systemPrompt.length > 0 ? { parts: [{ text: systemPrompt }] } : void 0,
+      generationConfig: params.maxTokens !== void 0 ? { maxOutputTokens: params.maxTokens } : void 0
+    }),
+    signal: params.signal
+  });
+  const payload = await parseJsonResponse(response);
+  if (!response.ok) {
+    throw new Error(
+      `Google request failed (${response.status}): ${parseErrorMessage(payload) ?? response.statusText}`
+    );
+  }
+  const content = extractTextContent(payload?.candidates?.[0]?.content?.parts);
+  if (!content) {
+    throw new Error("Google returned an empty response");
+  }
+  const truncated = payload?.candidates?.[0]?.finishReason === "MAX_TOKENS";
+  return { content, truncated, raw: payload };
+}
+async function callAI(params) {
+  if (params.provider === "openai") {
+    return callOpenAI(params);
+  }
+  if (params.provider === "anthropic") {
+    return callAnthropic(params);
+  }
+  if (params.provider === "google") {
+    return callGoogle(params);
+  }
+  throw new Error(`Unsupported AI provider: ${String(params.provider)}`);
+}
+
+// src/handler/site-modifier.ts
+var FETCH_TIMEOUT_MS = 3e4;
+var MAX_HTML_BYTES = 500 * 1024;
+var DEFAULT_MAX_TOKENS = 16384;
+var AI_MAX_RETRIES = 3;
+var RETRY_DELAY_MS = 2e3;
+var GOOGLE_FALLBACK_MODEL = "gemini-2.5-pro";
+var SUPPORTED_PROVIDERS = ["anthropic", "google", "openai"];
+var DEFAULT_MODELS = {
+  openai: "gpt-4o-mini",
+  anthropic: "claude-3-5-sonnet-latest",
+  google: "gemini-3.1-pro-preview"
+};
+var DEFAULT_SYSTEM_PROMPT = [
+  "You are an expert frontend engineer modifying an existing HTML document.",
+  "Return a complete, self-contained HTML file.",
+  "Inline all CSS in <style> tags and do not use external stylesheets.",
+  "Do not add any external dependencies (no CDNs, external scripts, fonts, or assets).",
+  "Preserve all existing functionality unless explicitly requested to change it.",
+  "Keep the output valid HTML and include all required tags.",
+  "Wrap the final HTML output in a ```html code block."
+].join("\n");
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isSupportedProvider(value) {
+  return typeof value === "string" && SUPPORTED_PROVIDERS.includes(value);
+}
+function normalizeDomain(domain) {
+  return domain.trim().toLowerCase().replace(/^\*\./, "").replace(/\.$/, "");
+}
+function isAllowedDomain(hostname, allowedDomains) {
+  const host = normalizeDomain(hostname);
+  return allowedDomains.some((domain) => {
+    const normalized = normalizeDomain(domain);
+    if (!normalized) return false;
+    return host === normalized || host.endsWith(`.${normalized}`);
+  });
+}
+function parseAndValidateUrl(urlString) {
+  let url;
+  try {
+    url = new URL(urlString);
+  } catch {
+    throw new Error("siteUrl must be a valid URL");
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new Error("siteUrl must use http or https");
+  }
+  return url;
+}
+function ensureAllowedUrl(url, allowedDomains) {
+  if (!allowedDomains || allowedDomains.length === 0) return;
+  if (!isAllowedDomain(url.hostname, allowedDomains)) {
+    throw new Error(`siteUrl domain "${url.hostname}" is not allowed`);
+  }
+}
+function isHtmlContentType(contentType) {
+  const lower = contentType.toLowerCase();
+  return lower.includes("text/html") || lower.includes("application/xhtml+xml");
+}
+function isJsonContentType(contentType) {
+  const lower = contentType.toLowerCase();
+  return lower.includes("application/json") || lower.includes("text/json");
+}
+function extractHtmlFromText(text) {
+  const htmlFence = text.match(/```html\s*([\s\S]*?)```/i);
+  if (htmlFence?.[1]) {
+    const fencedHtml = htmlFence[1].trim();
+    if (fencedHtml) return fencedHtml;
+  }
+  const anyFence = text.match(/```\s*([\s\S]*?)```/);
+  if (anyFence?.[1]) {
+    const fencedContent = anyFence[1].trim();
+    if (/<html[\s>]|<!doctype html/i.test(fencedContent)) {
+      return fencedContent;
+    }
+  }
+  const openFence = text.match(/```html?\s*\n?([\s\S]+)/i);
+  if (openFence?.[1]) {
+    const content = openFence[1].trim();
+    if (/<html[\s>]|<!doctype html/i.test(content)) {
+      return content;
+    }
+  }
+  const trimmed = text.trim();
+  if (/<html[\s>]|<!doctype html/i.test(trimmed)) {
+    return trimmed;
+  }
+  return null;
+}
+function extractHtmlFromJson(jsonText) {
+  try {
+    const parsed = JSON.parse(jsonText);
+    if (typeof parsed === "string") {
+      if (/<html[\s>]|<!doctype html/i.test(parsed)) return parsed;
+      return null;
+    }
+    if (typeof parsed !== "object" || parsed === null) return null;
+    const obj = parsed;
+    const nested = obj.data && typeof obj.data === "object" ? obj.data : null;
+    const candidates = [
+      obj.html,
+      obj.content,
+      obj.body,
+      nested?.content,
+      nested?.html,
+      nested?.body
+    ];
+    for (const candidate of candidates) {
+      if (typeof candidate === "string" && candidate.trim().length > 0) {
+        if (/<html[\s>]|<!doctype html|<head[\s>]|<body[\s>]|<div[\s>]/i.test(candidate)) {
+          return candidate.trim();
+        }
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function getByteLength(content) {
+  return new TextEncoder().encode(content).byteLength;
+}
+var SiteModifierHandler = class {
+  offeringId;
+  autoAccept;
+  config;
+  constructor(offeringId, config, options) {
+    this.offeringId = offeringId;
+    this.config = config;
+    this.autoAccept = options?.autoAccept;
+  }
+  async validateRequirements(context) {
+    try {
+      this.parseRequirements(context.requirements);
+      return { valid: true };
+    } catch (error) {
+      return {
+        valid: false,
+        reason: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  async executeJob(context) {
+    const requirements = this.parseRequirements(context.requirements);
+    const targetUrl = parseAndValidateUrl(requirements.siteUrl);
+    ensureAllowedUrl(targetUrl, this.config.allowedDomains);
+    const provider = requirements.provider ?? this.config.defaultProvider ?? "openai";
+    const model = requirements.model?.trim() || this.config.defaultModel?.trim() || DEFAULT_MODELS[provider];
+    const maxTokens = this.config.maxTokens && this.config.maxTokens > 0 ? this.config.maxTokens : DEFAULT_MAX_TOKENS;
+    if (!model) {
+      throw new Error(
+        `No model configured for provider "${provider}". Set defaultModel or provide requirements.model`
+      );
+    }
+    const originalHtml = await this.fetchHtmlWithTimeout(
+      targetUrl.toString(),
+      context.abortSignal
+    );
+    const apiKey = await this.config.getApiKey(provider);
+    if (!isNonEmptyString(apiKey)) {
+      throw new Error(
+        `Missing API key for provider "${provider}". Check BYOK setup for indexer ${this.config.indexerUrl}`
+      );
+    }
+    const systemPrompt = this.config.systemPrompt?.trim() || DEFAULT_SYSTEM_PROMPT;
+    const userPrompt = [
+      `Modification request: ${requirements.modificationRequest}`,
+      "",
+      "Current HTML:",
+      "```html",
+      originalHtml,
+      "```"
+    ].join("\n");
+    let aiResponse = null;
+    let lastError = null;
+    const aiMessages = [
+      { role: "system", content: systemPrompt },
+      { role: "user", content: userPrompt }
+    ];
+    for (let attempt = 1; attempt <= AI_MAX_RETRIES; attempt++) {
+      try {
+        aiResponse = await callAI({
+          provider,
+          model,
+          maxTokens,
+          apiKey,
+          signal: context.abortSignal,
+          messages: aiMessages
+        });
+        if (aiResponse.truncated) {
+          throw new Error(
+            "AI output was truncated (hit token limit). The generated HTML is incomplete."
+          );
+        }
+        break;
+      } catch (err) {
+        lastError = err instanceof Error ? err : new Error(String(err));
+        console.error(
+          `[site-modifier] ${model} failed (attempt ${attempt}/${AI_MAX_RETRIES}): ${lastError.message}`
+        );
+        if (provider === "google" && model !== GOOGLE_FALLBACK_MODEL) {
+          try {
+            console.log(
+              `[site-modifier] falling back to ${GOOGLE_FALLBACK_MODEL} (attempt ${attempt}/${AI_MAX_RETRIES})`
+            );
+            aiResponse = await callAI({
+              provider,
+              model: GOOGLE_FALLBACK_MODEL,
+              maxTokens,
+              apiKey,
+              signal: context.abortSignal,
+              messages: aiMessages
+            });
+            if (aiResponse.truncated) {
+              throw new Error(
+                "AI output was truncated (hit token limit). The generated HTML is incomplete."
+              );
+            }
+            break;
+          } catch (fallbackErr) {
+            lastError = fallbackErr instanceof Error ? fallbackErr : new Error(String(fallbackErr));
+            console.error(
+              `[site-modifier] ${GOOGLE_FALLBACK_MODEL} also failed (attempt ${attempt}/${AI_MAX_RETRIES}): ${lastError.message}`
+            );
+          }
+        }
+      }
+      if (attempt < AI_MAX_RETRIES) {
+        const delay = RETRY_DELAY_MS * attempt;
+        console.log(`[site-modifier] retrying in ${delay}ms...`);
+        await new Promise((r) => setTimeout(r, delay));
+      }
+    }
+    if (!aiResponse) {
+      throw new Error(
+        `AI generation failed after ${AI_MAX_RETRIES} attempts. Please try again later. Last error: ${lastError?.message ?? "unknown"}`
+      );
+    }
+    const modifiedHtml = extractHtmlFromText(aiResponse.content);
+    if (!modifiedHtml) {
+      throw new Error("AI response did not contain valid HTML output");
+    }
+    if (getByteLength(modifiedHtml) > MAX_HTML_BYTES) {
+      throw new Error(
+        `Modified HTML exceeds size limit (${MAX_HTML_BYTES} bytes)`
+      );
+    }
+    return {
+      type: "inline",
+      content: modifiedHtml,
+      mimeType: "text/html"
+    };
+  }
+  parseRequirements(requirements) {
+    if (!isRecord(requirements)) {
+      throw new Error("Missing requirements object");
+    }
+    const siteUrl = requirements.siteUrl;
+    if (!isNonEmptyString(siteUrl)) {
+      throw new Error("requirements.siteUrl must be a non-empty string");
+    }
+    const parsedUrl = parseAndValidateUrl(siteUrl);
+    ensureAllowedUrl(parsedUrl, this.config.allowedDomains);
+    const modificationRequest = requirements.modificationRequest;
+    if (!isNonEmptyString(modificationRequest)) {
+      throw new Error(
+        "requirements.modificationRequest must be a non-empty string"
+      );
+    }
+    const provider = requirements.provider;
+    if (provider !== void 0 && !isSupportedProvider(provider)) {
+      throw new Error(
+        `requirements.provider must be one of: ${SUPPORTED_PROVIDERS.join(", ")}`
+      );
+    }
+    const model = requirements.model;
+    if (model !== void 0 && !isNonEmptyString(model)) {
+      throw new Error("requirements.model must be a non-empty string");
+    }
+    return {
+      siteUrl: siteUrl.trim(),
+      modificationRequest: modificationRequest.trim(),
+      provider,
+      model: typeof model === "string" ? model.trim() : void 0
+    };
+  }
+  async fetchHtmlWithTimeout(siteUrl, parentSignal) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => {
+      controller.abort(
+        new Error(`Site fetch timed out after ${FETCH_TIMEOUT_MS}ms for ${siteUrl}`)
+      );
+    }, FETCH_TIMEOUT_MS);
+    const parentAbort = () => controller.abort(parentSignal?.reason);
+    if (parentSignal) {
+      if (parentSignal.aborted) {
+        controller.abort(parentSignal.reason);
+      } else {
+        parentSignal.addEventListener("abort", parentAbort, { once: true });
+      }
+    }
+    try {
+      const response = await fetch(siteUrl, {
+        method: "GET",
+        headers: { Accept: "text/html,application/xhtml+xml" },
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch site HTML: ${response.status} ${response.statusText}`
+        );
+      }
+      const contentType = response.headers.get("content-type") ?? "";
+      const isHtml = !contentType || isHtmlContentType(contentType);
+      const isJson = isJsonContentType(contentType);
+      if (!isHtml && !isJson) {
+        throw new Error(
+          `Fetched content is not HTML or JSON (content-type: ${contentType}, url: ${siteUrl})`
+        );
+      }
+      const contentLengthHeader = response.headers.get("content-length");
+      if (contentLengthHeader) {
+        const contentLength = Number.parseInt(contentLengthHeader, 10);
+        if (Number.isFinite(contentLength) && contentLength > MAX_HTML_BYTES) {
+          throw new Error(
+            `HTML too large (${contentLength} bytes). Limit is ${MAX_HTML_BYTES} bytes`
+          );
+        }
+      }
+      const htmlBuffer = await response.arrayBuffer();
+      if (htmlBuffer.byteLength > MAX_HTML_BYTES) {
+        throw new Error(
+          `HTML too large (${htmlBuffer.byteLength} bytes). Limit is ${MAX_HTML_BYTES} bytes`
+        );
+      }
+      let html = new TextDecoder().decode(htmlBuffer).trim();
+      if (!html) {
+        throw new Error("Fetched content is empty");
+      }
+      if (isJson) {
+        const extracted = extractHtmlFromJson(html);
+        if (!extracted) {
+          throw new Error(
+            `JSON response from ${siteUrl} does not contain extractable HTML content`
+          );
+        }
+        html = extracted;
+      }
+      return html;
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        if (parentSignal?.aborted) {
+          throw new Error("Site fetch aborted");
+        }
+        throw new Error(`Site fetch timed out after ${FETCH_TIMEOUT_MS}ms for ${siteUrl}`);
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+      if (parentSignal) {
+        parentSignal.removeEventListener("abort", parentAbort);
+      }
+    }
+  }
+};
+
 // src/utils.ts
 var USDM_DECIMALS = 18;
 var USDM_SCALE = 10n ** BigInt(USDM_DECIMALS);
@@ -2858,7 +3422,7 @@ var IndexerClientError = class extends Error {
     this.body = options.body;
   }
 };
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null;
 }
 function toIndexerAgent(raw) {
@@ -2986,6 +3550,31 @@ var IndexerClient = class {
     );
     return toIndexerWarrenLinks(payload.data);
   }
+  async postDeliverable(jobId, content, contentHash, storageType) {
+    await this.requestJson("/deliverables", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jobId,
+        content,
+        contentHash,
+        storageType: storageType ?? "indexer"
+      })
+    });
+  }
+  async getDeliverable(jobId) {
+    try {
+      const response = await this.request(`/deliverables/${jobId}`);
+      if (response.status === 404) return null;
+      const payload = await this.parseResponse(
+        response,
+        `/deliverables/${jobId}`
+      );
+      return { content: payload.data.content, storageType: payload.data.storage_type };
+    } catch {
+      return null;
+    }
+  }
   async request(path, init) {
     const url = `${this.baseUrl}${path}`;
     const controller = new AbortController();
@@ -3021,7 +3610,7 @@ var IndexerClient = class {
       });
     }
     if (!response.ok) {
-      const apiError = isRecord(payload) ? payload : void 0;
+      const apiError = isRecord2(payload) ? payload : void 0;
       const message = response.status === 404 && notFoundMessage ? notFoundMessage : apiError?.error ?? apiError?.message ?? `Indexer request failed (${response.status})`;
       throw new IndexerClientError(message, {
         url,
@@ -3075,10 +3664,11 @@ var ProviderRuntime = class {
     });
     const jobs = await this.indexer.getJobs({ status: 0 });
     for (const job of jobs) {
-      if (this.processedJobs.has(job.jobId)) continue;
+      const newKey = `new:${job.jobId}`;
+      if (this.processedJobs.has(newKey)) continue;
       const matchesOffering = offerings.some((o) => o.offeringId === job.offeringId);
       if (!matchesOffering) continue;
-      this.processedJobs.add(job.jobId);
+      this.processedJobs.add(newKey);
       if (this.callbacks.onJobReceived) {
         try {
           const accept = await this.callbacks.onJobReceived(job);
@@ -3103,7 +3693,7 @@ var ProviderRuntime = class {
       agentId: Number(this.agentId)
     });
     for (const job of inProgressJobs) {
-      const deliverKey = job.jobId * 1e3;
+      const deliverKey = `deliver:${job.jobId}`;
       if (this.processedJobs.has(deliverKey)) continue;
       if (this.callbacks.onDeliverableRequested) {
         try {
@@ -3130,7 +3720,7 @@ var ProviderRuntime = class {
       agentId: Number(this.agentId)
     });
     for (const job of completedJobs) {
-      const completeKey = job.jobId * 1e4;
+      const completeKey = `complete:${job.jobId}`;
       if (this.processedJobs.has(completeKey)) continue;
       this.processedJobs.add(completeKey);
       this.callbacks.onJobCompleted?.(job);
@@ -3241,8 +3831,9 @@ var BuyerRuntime = class {
       agentId: Number(this.agentId)
     });
     for (const job of deliveredJobs) {
-      if (this.processedJobs.has(job.jobId)) continue;
-      this.processedJobs.add(job.jobId);
+      const deliveredKey = `delivered:${job.jobId}`;
+      if (this.processedJobs.has(deliveredKey)) continue;
+      this.processedJobs.add(deliveredKey);
       try {
         const deliverable = await readDeliverable(
           this.client,
@@ -3267,7 +3858,7 @@ var BuyerRuntime = class {
       agentId: Number(this.agentId)
     });
     for (const job of completedJobs) {
-      const completeKey = job.jobId * 1e3;
+      const completeKey = `complete:${job.jobId}`;
       if (this.processedJobs.has(completeKey)) continue;
       this.processedJobs.add(completeKey);
       this.callbacks.onJobCompleted?.(job);
@@ -3283,8 +3874,11 @@ var HandlerProviderRuntime = class {
   indexer;
   indexerUrl;
   pollInterval;
+  executionTimeoutMs;
   running = false;
   processedJobs = /* @__PURE__ */ new Set();
+  failedJobs = /* @__PURE__ */ new Map();
+  maxRetries = 3;
   onError;
   constructor(client, agentId, options) {
     this.client = client;
@@ -3292,6 +3886,7 @@ var HandlerProviderRuntime = class {
     this.indexer = new IndexerClient({ baseUrl: options.indexerUrl });
     this.indexerUrl = options.indexerUrl.replace(/\/$/, "");
     this.pollInterval = options.pollInterval ?? 5e3;
+    this.executionTimeoutMs = options.executionTimeoutMs ?? 5 * 60 * 1e3;
   }
   registerHandler(handler) {
     this.handlers.set(handler.offeringId, handler);
@@ -3311,6 +3906,7 @@ var HandlerProviderRuntime = class {
       try {
         await this.checkNewJobs();
         await this.checkInProgressJobs();
+        await this.checkEvaluatedJobs();
       } catch (e) {
         this.onError?.(e instanceof Error ? e : new Error(String(e)));
       }
@@ -3324,13 +3920,38 @@ var HandlerProviderRuntime = class {
     });
     const jobs = await this.indexer.getJobs({ status: 0 });
     for (const job of jobs) {
-      if (this.processedJobs.has(job.jobId)) continue;
+      const newKey = `new:${job.jobId}`;
+      if (!this.canProcess(newKey)) continue;
       const matchesOffering = offerings.some((o) => o.offeringId === job.offeringId);
       if (!matchesOffering) continue;
       const handler = this.handlers.get(job.offeringId);
       if (!handler) continue;
-      this.processedJobs.add(job.jobId);
       try {
+        if (job.slaMinutes === null) {
+          throw new Error(`Job ${job.jobId} is missing slaMinutes`);
+        }
+        const context = {
+          jobId: BigInt(job.jobId),
+          offeringId: BigInt(job.offeringId),
+          buyerAgentId: BigInt(job.buyerAgentId),
+          providerAgentId: BigInt(job.providerAgentId),
+          priceUsdm: job.priceUsdm,
+          slaMinutes: job.slaMinutes
+        };
+        const reqData = await readRequirements(
+          this.client,
+          BigInt(job.jobId),
+          this.indexerUrl
+        );
+        if (reqData) {
+          context.requirements = reqData.requirements;
+        }
+        if (handler.validateRequirements) {
+          const validation = await handler.validateRequirements(context);
+          if (!validation.valid) {
+            throw new Error(`Validation failed for job ${job.jobId}: ${validation.reason}`);
+          }
+        }
         if (handler.autoAccept !== false) {
           await acceptJob(
             this.client,
@@ -3338,8 +3959,9 @@ var HandlerProviderRuntime = class {
             job.warrenTermsHash
           );
         }
+        this.markProcessed(newKey);
       } catch (e) {
-        this.onError?.(e instanceof Error ? e : new Error(String(e)));
+        this.markFailed(newKey, e);
       }
     }
   }
@@ -3349,15 +3971,13 @@ var HandlerProviderRuntime = class {
       agentId: Number(this.agentId)
     });
     for (const job of inProgressJobs) {
-      const deliverKey = job.jobId * 1e3;
-      if (this.processedJobs.has(deliverKey)) continue;
+      const deliverKey = `deliver:${job.jobId}`;
+      if (!this.canProcess(deliverKey)) continue;
       const handler = this.handlers.get(job.offeringId);
       if (!handler) continue;
-      this.processedJobs.add(deliverKey);
       try {
         if (job.slaMinutes === null) {
-          this.onError?.(new Error(`Job ${job.jobId} is missing slaMinutes`));
-          continue;
+          throw new Error(`Job ${job.jobId} is missing slaMinutes`);
         }
         const context = {
           jobId: BigInt(job.jobId),
@@ -3378,32 +3998,102 @@ var HandlerProviderRuntime = class {
         if (handler.validateRequirements) {
           const validation = await handler.validateRequirements(context);
           if (!validation.valid) {
-            this.onError?.(
+            this.markFailed(
+              deliverKey,
               new Error(`Validation failed for job ${job.jobId}: ${validation.reason}`)
             );
             continue;
           }
         }
-        const result = await handler.executeJob(context);
-        const deliverableParams = {
-          type: result.type,
-          content: result.content,
-          url: result.url,
-          mimeType: result.mimeType,
-          jobId: BigInt(job.jobId)
-        };
-        await deployDeliverable(
-          this.client,
-          this.agentId,
-          BigInt(job.jobId),
-          deliverableParams,
-          this.indexerUrl
-        );
+        const remainingSlaMs = this.getRemainingSlaMs(job.createdAt, job.acceptedAt, job.slaMinutes);
+        if (remainingSlaMs !== null && remainingSlaMs < 10 * 60 * 1e3) {
+          console.warn(
+            `Skipping job ${job.jobId}: SLA remaining ${Math.max(0, Math.floor(remainingSlaMs / 1e3))}s is below 10 minutes`
+          );
+          this.markProcessed(deliverKey);
+          continue;
+        }
+        const controller = new AbortController();
+        const executionContext = { ...context, abortSignal: controller.signal };
+        let timeoutId;
+        try {
+          const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+              controller.abort();
+              reject(
+                new Error(
+                  `Execution timed out for job ${job.jobId} after ${this.executionTimeoutMs}ms`
+                )
+              );
+            }, this.executionTimeoutMs);
+          });
+          const result = await Promise.race([
+            handler.executeJob(executionContext),
+            timeoutPromise
+          ]);
+          const deliverableParams = {
+            type: result.type,
+            content: result.content,
+            url: result.url,
+            mimeType: result.mimeType,
+            jobId: BigInt(job.jobId)
+          };
+          await deployDeliverable(
+            this.client,
+            this.agentId,
+            BigInt(job.jobId),
+            deliverableParams,
+            this.indexerUrl
+          );
+        } finally {
+          if (timeoutId) clearTimeout(timeoutId);
+        }
+        this.markProcessed(deliverKey);
       } catch (e) {
-        this.onError?.(e instanceof Error ? e : new Error(String(e)));
+        this.markFailed(deliverKey, e);
+      }
+    }
+  }
+  async checkEvaluatedJobs() {
+    const evaluatedJobs = await this.indexer.getJobs({
+      status: 4,
+      agentId: Number(this.agentId)
+    });
+    for (const job of evaluatedJobs) {
+      const settleKey = `settle:${job.jobId}`;
+      if (!this.canProcess(settleKey)) continue;
+      try {
+        await settle(this.client, BigInt(job.jobId));
+        console.log(`[handler-provider] auto-settled job ${job.jobId}`);
+        this.markProcessed(settleKey);
+      } catch (e) {
+        this.markFailed(settleKey, e);
       }
     }
   }
+  canProcess(key) {
+    if (this.processedJobs.has(key)) return false;
+    return (this.failedJobs.get(key) ?? 0) < this.maxRetries;
+  }
+  markProcessed(key) {
+    this.failedJobs.delete(key);
+    this.processedJobs.add(key);
+  }
+  markFailed(key, error) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    this.onError?.(err);
+    const retries = (this.failedJobs.get(key) ?? 0) + 1;
+    this.failedJobs.set(key, retries);
+    if (retries >= this.maxRetries) {
+      this.onError?.(new Error(`Giving up on ${key} after ${retries} failed attempts`));
+    }
+  }
+  getRemainingSlaMs(createdAt, acceptedAt, slaMinutes) {
+    const start = acceptedAt ?? createdAt;
+    if (start === null) return null;
+    const startMs = start > 1e12 ? start : start * 1e3;
+    return startMs + slaMinutes * 60 * 1e3 - Date.now();
+  }
 };
 
 // src/abis/FeeDistributor.ts
@@ -4253,6 +4943,528 @@ var erc8004ReputationAbi = [
     "anonymous": false
   }
 ];
+
+// src/abis/BuyerRelay.ts
+var buyerRelayAbi = [
+  {
+    "type": "constructor",
+    "inputs": [
+      {
+        "name": "owner_",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "identityRegistry_",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "pulseExtension_",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "jobEngine_",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "serviceMarketplace_",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "usdm_",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "buyerAgentId",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "cancelFor",
+    "inputs": [
+      {
+        "name": "jobId",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "claimRefund",
+    "inputs": [
+      {
+        "name": "jobId",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "createJobFor",
+    "inputs": [
+      {
+        "name": "offeringId",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "termsHash",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      },
+      {
+        "name": "maxPrice",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "jobId",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "evaluateFor",
+    "inputs": [
+      {
+        "name": "jobId",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "approved",
+        "type": "bool",
+        "internalType": "bool"
+      },
+      {
+        "name": "feedback",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "identityRegistry",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "contract IERC8004Identity"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "jobDeposit",
+    "inputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "jobEngine",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "contract IJobEngine"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "jobPayer",
+    "inputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "jobRefundState",
+    "inputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint8",
+        "internalType": "enum IBuyerRelay.RefundState"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "onERC721Received",
+    "inputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "",
+        "type": "bytes",
+        "internalType": "bytes"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bytes4",
+        "internalType": "bytes4"
+      }
+    ],
+    "stateMutability": "pure"
+  },
+  {
+    "type": "function",
+    "name": "owner",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "pulseExtension",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "contract IPulseExtension"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "renounceOwnership",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "serviceMarketplace",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "contract IServiceMarketplace"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "setup",
+    "inputs": [
+      {
+        "name": "agentURI",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "transferOwnership",
+    "inputs": [
+      {
+        "name": "newOwner",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "usdm",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "event",
+    "name": "EvaluatedFor",
+    "inputs": [
+      {
+        "name": "jobId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "payer",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "approved",
+        "type": "bool",
+        "indexed": false,
+        "internalType": "bool"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "JobCreatedFor",
+    "inputs": [
+      {
+        "name": "jobId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "payer",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "price",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "OwnershipTransferred",
+    "inputs": [
+      {
+        "name": "previousOwner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "newOwner",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "event",
+    "name": "RefundClaimed",
+    "inputs": [
+      {
+        "name": "jobId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "payer",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
+  {
+    "type": "error",
+    "name": "AgentAlreadyInitialized",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "AgentNotActive",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "InsufficientPayment",
+    "inputs": [
+      {
+        "name": "required",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "provided",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "InvalidJobStatus",
+    "inputs": [
+      {
+        "name": "current",
+        "type": "uint8",
+        "internalType": "enum DataTypes.JobStatus"
+      },
+      {
+        "name": "expected",
+        "type": "uint8",
+        "internalType": "enum DataTypes.JobStatus"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "InvalidRefundState",
+    "inputs": [
+      {
+        "name": "current",
+        "type": "uint8",
+        "internalType": "enum IBuyerRelay.RefundState"
+      },
+      {
+        "name": "expected",
+        "type": "uint8",
+        "internalType": "enum IBuyerRelay.RefundState"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "OnlyBuyer",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "OwnableInvalidOwner",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "internalType": "address"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "OwnableUnauthorizedAccount",
+    "inputs": [
+      {
+        "name": "account",
+        "type": "address",
+        "internalType": "address"
+      }
+    ]
+  },
+  {
+    "type": "error",
+    "name": "Reentrancy",
+    "inputs": []
+  },
+  {
+    "type": "error",
+    "name": "ZeroAddress",
+    "inputs": []
+  }
+];
 export {
   ACCEPT_TIMEOUT,
   BPS_DENOMINATOR,
@@ -4266,15 +5478,19 @@ export {
   JobStatus,
   MAINNET_ADDRESSES,
   MEMO_TYPES,
+  PLATFORM_BUYER_AGENT_ID,
   PULSE_DOMAIN,
   ProviderRuntime,
   RISK_POOL_BPS,
   ServiceType,
+  SiteModifierHandler,
   TESTNET_ADDRESSES,
   TREASURY_BPS,
   USDM_MAINNET,
   acceptJob,
   activateOffering,
+  buyerRelayAbi,
+  callAI,
   cancelJob,
   createAgentCard,
   createDeliverable,
@@ -4317,6 +5533,8 @@ export {
   readWarrenMaster,
   readWarrenPage,
   registerAgent,
+  rejectJob,
+  resolveDispute,
   serviceMarketplaceAbi,
   setOperator,
   setWarrenContract,