@pulseai/sdk 0.1.2 → 0.1.4

package/dist/index.js

@@ -13,6 +13,9 @@ var megaethTestnet = defineChain({
   nativeCurrency: { name: "ETH", symbol: "ETH", decimals: 18 },
   rpcUrls: {
     default: { http: ["https://carrot.megaeth.com/rpc"] }
+  },
+  blockExplorers: {
+    default: { name: "Blockscout", url: "https://megaeth-testnet-v2.blockscout.com" }
   }
 });
 var megaethMainnet = defineChain({
@@ -21,6 +24,9 @@ var megaethMainnet = defineChain({
   nativeCurrency: { name: "ETH", symbol: "ETH", decimals: 18 },
   rpcUrls: {
     default: { http: ["https://mainnet.megaeth.com/rpc"] }
+  },
+  blockExplorers: {
+    default: { name: "Blockscout", url: "https://megaeth.blockscout.com" }
   }
 });
 
@@ -36,15 +42,15 @@ var TESTNET_ADDRESSES = {
 };
 var MAINNET_ADDRESSES = {
   pulseExtension: "0xf1616D2008c4Ff5Ed7BDBd448DAE68615b7A71f0",
-  serviceMarketplace: "0xfC180058FCB69531818B832C12473302811dfFF6",
+  serviceMarketplace: "0x0573C91396184323979F3f7b322C694932F91D44",
   jobEngine: "0xb5E56262b55aE453E8B16470228F0a5Ef617FF67",
   feeDistributor: "0x51EdD8E4C4B423b952821fc9e2a7dad15a858B56",
   identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
   reputationRegistry: "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
   usdm: "0xFAfDdbb3FC7688494971a79cc65DCa3EF82079E7",
-  buyerRelay: "0x633054593db34c5aAe36F784faeAe51b9604e037"
+  buyerRelay: "0x843B5B4AD44C174BAB8bBe11eb001aD7fE70647A"
 };
-var PLATFORM_BUYER_AGENT_ID = 8154n;
+var PLATFORM_BUYER_AGENT_ID = 8155n;
 var DEFAULT_INDEXER_URLS = {
   testnet: "https://pulse-indexer.up.railway.app",
   mainnet: "https://pulse-indexer.up.railway.app"
@@ -1034,6 +1040,11 @@ var serviceMarketplaceAbi = [
             "type": "uint32",
             "internalType": "uint32"
           },
+          {
+            "name": "name",
+            "type": "string",
+            "internalType": "string"
+          },
           {
             "name": "description",
             "type": "string",
@@ -1104,6 +1115,11 @@ var serviceMarketplaceAbi = [
         "type": "uint32",
         "internalType": "uint32"
       },
+      {
+        "name": "name",
+        "type": "string",
+        "internalType": "string"
+      },
       {
         "name": "description",
         "type": "string",
@@ -1156,6 +1172,11 @@ var serviceMarketplaceAbi = [
         "type": "uint32",
         "internalType": "uint32"
       },
+      {
+        "name": "name",
+        "type": "string",
+        "internalType": "string"
+      },
       {
         "name": "description",
         "type": "string",
@@ -1165,6 +1186,24 @@ var serviceMarketplaceAbi = [
     "outputs": [],
     "stateMutability": "nonpayable"
   },
+  {
+    "type": "function",
+    "name": "updateOfferingSchema",
+    "inputs": [
+      {
+        "name": "offeringId",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "requirementsSchemaURI",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
   {
     "type": "event",
     "name": "OfferingActivated",
@@ -1222,6 +1261,25 @@ var serviceMarketplaceAbi = [
     ],
     "anonymous": false
   },
+  {
+    "type": "event",
+    "name": "OfferingSchemaUpdated",
+    "inputs": [
+      {
+        "name": "offeringId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      },
+      {
+        "name": "requirementsSchemaURI",
+        "type": "string",
+        "indexed": false,
+        "internalType": "string"
+      }
+    ],
+    "anonymous": false
+  },
   {
     "type": "event",
     "name": "OfferingUpdated",
@@ -1285,6 +1343,7 @@ async function listOffering(client, params) {
       params.serviceType,
       params.priceUSDm,
       params.slaMinutes,
+      params.name,
       params.description,
       params.requirementsSchemaURI ?? ""
     ]
@@ -1296,12 +1355,20 @@ async function listOffering(client, params) {
   const offeringId = offeringLog?.topics[1] ? BigInt(offeringLog.topics[1]) : 0n;
   return { offeringId, txHash };
 }
-async function updateOffering(client, offeringId, priceUSDm, slaMinutes, description) {
+async function updateOffering(client, offeringId, priceUSDm, slaMinutes, name, description) {
   return write(client, {
     address: client.addresses.serviceMarketplace,
     abi: serviceMarketplaceAbi,
     functionName: "updateOffering",
-    args: [offeringId, priceUSDm, slaMinutes, description]
+    args: [offeringId, priceUSDm, slaMinutes, name, description]
+  });
+}
+async function updateOfferingSchema(client, offeringId, requirementsSchemaURI) {
+  return write(client, {
+    address: client.addresses.serviceMarketplace,
+    abi: serviceMarketplaceAbi,
+    functionName: "updateOfferingSchema",
+    args: [offeringId, requirementsSchemaURI]
   });
 }
 async function deactivateOffering(client, offeringId) {
@@ -1337,6 +1404,9 @@ async function getOfferingCount(client) {
   });
 }
 
+// src/jobs/index.ts
+import { maxUint256 } from "viem";
+
 // src/abis/JobEngine.ts
 var jobEngineAbi = [
   {
@@ -1812,6 +1882,19 @@ var jobEngineAbi = [
     ],
     "stateMutability": "view"
   },
+  {
+    "type": "function",
+    "name": "setServiceMarketplace",
+    "inputs": [
+      {
+        "name": "newMarketplace",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
   {
     "type": "function",
     "name": "settle",
@@ -2088,6 +2171,25 @@ var jobEngineAbi = [
     ],
     "anonymous": false
   },
+  {
+    "type": "event",
+    "name": "ServiceMarketplaceUpdated",
+    "inputs": [
+      {
+        "name": "oldMarketplace",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "newMarketplace",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      }
+    ],
+    "anonymous": false
+  },
   {
     "type": "event",
     "name": "Upgraded",
@@ -2339,6 +2441,7 @@ async function signMemo(walletClient, params) {
 
 // src/jobs/index.ts
 async function createJob(client, params) {
+  const { account } = requireWallet(client);
   const offering = await client.publicClient.readContract({
     address: client.addresses.serviceMarketplace,
     abi: serviceMarketplaceAbi,
@@ -2346,13 +2449,21 @@ async function createJob(client, params) {
     args: [params.offeringId]
   });
   const price = offering.priceUSDm;
-  const approveTx = await write(client, {
+  const allowance = await client.publicClient.readContract({
     address: client.addresses.usdm,
     abi: erc20Abi,
-    functionName: "approve",
-    args: [client.addresses.jobEngine, price]
+    functionName: "allowance",
+    args: [account.address, client.addresses.jobEngine]
   });
-  await client.publicClient.waitForTransactionReceipt({ hash: approveTx });
+  if (allowance < price) {
+    const approveTx = await write(client, {
+      address: client.addresses.usdm,
+      abi: erc20Abi,
+      functionName: "approve",
+      args: [client.addresses.jobEngine, maxUint256]
+    });
+    await client.publicClient.waitForTransactionReceipt({ hash: approveTx });
+  }
   const txHash = await write(client, {
     address: client.addresses.jobEngine,
     abi: jobEngineAbi,
@@ -2666,39 +2777,14 @@ 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) {
+async function deployDeliverable(client, jobId, params, indexerUrl) {
   const { json, hash } = createDeliverable(params);
-  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, {
+  const txHash = await write(client, {
     address: client.addresses.jobEngine,
     abi: jobEngineAbi,
     functionName: "submitDeliverable",
     args: [jobId, hash]
   });
-  if (indexerUrl) {
-    try {
-      await fetch(`${indexerUrl}/warren-links`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          jobId: Number(jobId),
-          linkType: "deliverable",
-          masterAddress,
-          contentHash: hash
-        })
-      });
-    } catch {
-    }
-  }
   if (indexerUrl) {
     try {
       await fetch(`${indexerUrl.replace(/\/$/, "")}/deliverables`, {
@@ -2708,24 +2794,23 @@ async function deployDeliverable(client, agentId, jobId, params, indexerUrl) {
           jobId: Number(jobId),
           content: json,
           contentHash: hash,
-          storageType: "warren"
+          storageType: "deliverable"
         })
       });
     } catch {
     }
   }
-  return { masterAddress, pageAddress, hash, txHash };
+  return { hash, txHash };
 }
-async function readDeliverable(client, jobId, indexerUrl) {
-  const res = await fetch(`${indexerUrl}/warren-links/${Number(jobId)}`);
-  if (!res.ok) throw new Error(`Failed to fetch warren link for job ${jobId}`);
+async function readDeliverable(jobId, indexerUrl) {
+  const res = await fetch(`${indexerUrl.replace(/\/$/, "")}/deliverables/${Number(jobId)}`);
+  if (!res.ok) throw new Error(`Failed to fetch deliverable for job ${jobId}`);
   const { data } = await res.json();
-  if (!data.deliverable) throw new Error(`No deliverable WARREN link for job ${jobId}`);
-  const content = await readWarrenMaster(client, data.deliverable.master_address);
-  if (!verifyContentHash(content, data.deliverable.content_hash)) {
+  if (!data?.content) throw new Error(`No deliverable content for job ${jobId}`);
+  if (!verifyContentHash(data.content, data.content_hash)) {
     throw new Error("Deliverable content hash mismatch");
   }
-  return JSON.parse(content);
+  return JSON.parse(data.content);
 }
 async function deployRequirements(client, agentId, jobId, params, indexerUrl) {
   const { json, hash } = createRequirements(params);
@@ -2881,7 +2966,7 @@ async function callOpenAI(params) {
         role: message.role,
         content: message.content
       })),
-      max_tokens: params.maxTokens
+      max_completion_tokens: params.maxTokens
     }),
     signal: params.signal
   });
@@ -2896,7 +2981,8 @@ async function callOpenAI(params) {
     throw new Error("OpenAI returned an empty response");
   }
   const truncated = payload?.choices?.[0]?.finish_reason === "length";
-  return { content, truncated, raw: payload };
+  const usage = payload?.usage ? { inputTokens: payload.usage.prompt_tokens ?? 0, outputTokens: payload.usage.completion_tokens ?? 0 } : void 0;
+  return { content, truncated, raw: payload, usage };
 }
 async function callAnthropic(params) {
   const systemPrompt = params.messages.filter((message) => message.role === "system").map((message) => message.content).join("\n\n").trim();
@@ -2930,7 +3016,8 @@ async function callAnthropic(params) {
     throw new Error("Anthropic returned an empty response");
   }
   const truncated = payload?.stop_reason === "max_tokens";
-  return { content, truncated, raw: payload };
+  const usage = payload?.usage ? { inputTokens: payload.usage.input_tokens ?? 0, outputTokens: payload.usage.output_tokens ?? 0 } : void 0;
+  return { content, truncated, raw: payload, usage };
 }
 async function callGoogle(params) {
   const systemPrompt = params.messages.filter((message) => message.role === "system").map((message) => message.content).join("\n\n").trim();
@@ -2965,7 +3052,8 @@ async function callGoogle(params) {
     throw new Error("Google returned an empty response");
   }
   const truncated = payload?.candidates?.[0]?.finishReason === "MAX_TOKENS";
-  return { content, truncated, raw: payload };
+  const usage = payload?.usageMetadata ? { inputTokens: payload.usageMetadata.promptTokenCount ?? 0, outputTokens: payload.usageMetadata.candidatesTokenCount ?? 0 } : void 0;
+  return { content, truncated, raw: payload, usage };
 }
 async function callAI(params) {
   if (params.provider === "openai") {
@@ -2989,8 +3077,8 @@ 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",
+  openai: "gpt-5.2",
+  anthropic: "claude-sonnet-4-6",
   google: "gemini-3.1-pro-preview"
 };
 var DEFAULT_SYSTEM_PROMPT = [
@@ -3034,6 +3122,16 @@ function parseAndValidateUrl(urlString) {
   }
   return url;
 }
+function normalizeWarrenUrl(url) {
+  const host = url.hostname.toLowerCase();
+  if (host !== "thewarren.app" && !host.endsWith(".thewarren.app")) return url;
+  const match = url.pathname.match(/^\/v\/site=(\d+)$/);
+  if (!match) return url;
+  const normalized = new URL(url.origin);
+  normalized.pathname = "/api/source";
+  normalized.searchParams.set("site", match[1]);
+  return normalized;
+}
 function ensureAllowedUrl(url, allowedDomains) {
   if (!allowedDomains || allowedDomains.length === 0) return;
   if (!isAllowedDomain(url.hostname, allowedDomains)) {
@@ -3110,6 +3208,52 @@ function getByteLength(content) {
 var SiteModifierHandler = class {
   offeringId;
   autoAccept;
+  schema = {
+    version: 1,
+    serviceRequirements: {
+      type: "object",
+      properties: {
+        siteUrl: {
+          type: "string",
+          description: "URL of the site to modify (http/https)"
+        },
+        modificationRequest: {
+          type: "string",
+          description: "What changes to make"
+        },
+        provider: {
+          type: "string",
+          description: "AI provider",
+          enum: ["google", "anthropic", "openai"]
+        },
+        model: {
+          type: "string",
+          description: "Specific model override"
+        }
+      },
+      required: ["siteUrl", "modificationRequest"]
+    },
+    deliverableRequirements: {
+      type: "object",
+      properties: {
+        type: {
+          type: "string",
+          description: 'Delivery type, always "inline"',
+          enum: ["inline"]
+        },
+        content: {
+          type: "string",
+          description: "Modified HTML content"
+        },
+        mimeType: {
+          type: "string",
+          description: 'Content type, always "text/html"',
+          enum: ["text/html"]
+        }
+      },
+      required: ["type", "content", "mimeType"]
+    }
+  };
   config;
   constructor(offeringId, config, options) {
     this.offeringId = offeringId;
@@ -3132,7 +3276,8 @@ var SiteModifierHandler = class {
     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 useConfigModel = provider === (this.config.defaultProvider ?? "openai");
+    const model = requirements.model?.trim() || (useConfigModel ? this.config.defaultModel?.trim() : void 0) || DEFAULT_MODELS[provider];
     const maxTokens = this.config.maxTokens && this.config.maxTokens > 0 ? this.config.maxTokens : DEFAULT_MAX_TOKENS;
     if (!model) {
       throw new Error(
@@ -3235,7 +3380,8 @@ var SiteModifierHandler = class {
     return {
       type: "inline",
       content: modifiedHtml,
-      mimeType: "text/html"
+      mimeType: "text/html",
+      usage: aiResponse.usage ? { provider, inputTokens: aiResponse.usage.inputTokens, outputTokens: aiResponse.usage.outputTokens } : void 0
     };
   }
   parseRequirements(requirements) {
@@ -3246,7 +3392,7 @@ var SiteModifierHandler = class {
     if (!isNonEmptyString(siteUrl)) {
       throw new Error("requirements.siteUrl must be a non-empty string");
     }
-    const parsedUrl = parseAndValidateUrl(siteUrl);
+    const parsedUrl = normalizeWarrenUrl(parseAndValidateUrl(siteUrl));
     ensureAllowedUrl(parsedUrl, this.config.allowedDomains);
     const modificationRequest = requirements.modificationRequest;
     if (!isNonEmptyString(modificationRequest)) {
@@ -3265,7 +3411,7 @@ var SiteModifierHandler = class {
       throw new Error("requirements.model must be a non-empty string");
     }
     return {
-      siteUrl: siteUrl.trim(),
+      siteUrl: parsedUrl.toString(),
       modificationRequest: modificationRequest.trim(),
       provider,
       model: typeof model === "string" ? model.trim() : void 0
@@ -3351,6 +3497,334 @@ var SiteModifierHandler = class {
   }
 };
 
+// src/handler/prompt-handler.ts
+var DEFAULT_MAX_TOKENS2 = 8192;
+var AI_MAX_RETRIES2 = 3;
+var RETRY_DELAY_MS2 = 2e3;
+var DEFAULT_MODELS2 = {
+  openai: "gpt-5.2",
+  anthropic: "claude-sonnet-4-6",
+  google: "gemini-3.1-pro-preview"
+};
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function isNonEmptyString2(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+var PromptHandler = class {
+  offeringId;
+  autoAccept = true;
+  schema = {
+    version: 1,
+    serviceRequirements: {
+      type: "object",
+      properties: {
+        prompt: {
+          type: "string",
+          description: "Prompt to send to AI"
+        },
+        context: {
+          type: "string",
+          description: "Optional additional context"
+        }
+      },
+      required: ["prompt"]
+    },
+    deliverableRequirements: {
+      type: "object",
+      properties: {
+        type: {
+          type: "string",
+          description: 'Delivery type, always "inline"',
+          enum: ["inline"]
+        },
+        content: {
+          type: "string",
+          description: "Generated markdown content"
+        },
+        mimeType: {
+          type: "string",
+          description: 'Content type, always "text/markdown"',
+          enum: ["text/markdown"]
+        }
+      },
+      required: ["type", "content", "mimeType"]
+    }
+  };
+  config;
+  constructor(offeringId, config) {
+    this.offeringId = offeringId;
+    this.config = config;
+  }
+  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 provider = this.config.aiProvider;
+    const model = this.config.aiModel?.trim() || DEFAULT_MODELS2[provider];
+    const maxTokens = this.config.maxTokens && this.config.maxTokens > 0 ? this.config.maxTokens : DEFAULT_MAX_TOKENS2;
+    const apiKey = await this.config.getApiKey(provider);
+    if (!isNonEmptyString2(apiKey)) {
+      throw new Error(`Missing API key for provider "${provider}"`);
+    }
+    const userPrompt = requirements.context ? [requirements.prompt, requirements.context].join("\n\n") : requirements.prompt;
+    const aiMessages = [
+      { role: "system", content: this.config.systemPrompt },
+      { role: "user", content: userPrompt }
+    ];
+    let aiResponse = null;
+    let lastError = null;
+    for (let attempt = 1; attempt <= AI_MAX_RETRIES2; 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).");
+        }
+        break;
+      } catch (err) {
+        lastError = err instanceof Error ? err : new Error(String(err));
+        console.error(
+          `[prompt-handler] ${model} failed (attempt ${attempt}/${AI_MAX_RETRIES2}): ${lastError.message}`
+        );
+      }
+      if (attempt < AI_MAX_RETRIES2) {
+        const delay = RETRY_DELAY_MS2 * attempt;
+        console.log(`[prompt-handler] retrying in ${delay}ms...`);
+        await new Promise((r) => setTimeout(r, delay));
+      }
+    }
+    if (!aiResponse) {
+      throw new Error(
+        `AI generation failed after ${AI_MAX_RETRIES2} attempts. Please try again later. Last error: ${lastError?.message ?? "unknown"}`
+      );
+    }
+    return {
+      type: "inline",
+      content: aiResponse.content,
+      mimeType: "text/markdown",
+      usage: aiResponse.usage ? { provider, inputTokens: aiResponse.usage.inputTokens, outputTokens: aiResponse.usage.outputTokens } : void 0
+    };
+  }
+  parseRequirements(requirements) {
+    if (!isRecord2(requirements)) {
+      throw new Error("Missing requirements object");
+    }
+    const prompt = requirements.prompt;
+    if (!isNonEmptyString2(prompt)) {
+      throw new Error("requirements.prompt must be a non-empty string");
+    }
+    const context = requirements.context;
+    if (context !== void 0 && typeof context !== "string") {
+      throw new Error("requirements.context must be a string when provided");
+    }
+    const normalizedContext = typeof context === "string" ? context.trim() : void 0;
+    return {
+      prompt: prompt.trim(),
+      context: normalizedContext && normalizedContext.length > 0 ? normalizedContext : void 0
+    };
+  }
+};
+
+// src/types.ts
+var JobStatus = /* @__PURE__ */ ((JobStatus2) => {
+  JobStatus2[JobStatus2["Created"] = 0] = "Created";
+  JobStatus2[JobStatus2["Accepted"] = 1] = "Accepted";
+  JobStatus2[JobStatus2["InProgress"] = 2] = "InProgress";
+  JobStatus2[JobStatus2["Delivered"] = 3] = "Delivered";
+  JobStatus2[JobStatus2["Evaluated"] = 4] = "Evaluated";
+  JobStatus2[JobStatus2["Completed"] = 5] = "Completed";
+  JobStatus2[JobStatus2["Disputed"] = 6] = "Disputed";
+  JobStatus2[JobStatus2["Cancelled"] = 7] = "Cancelled";
+  return JobStatus2;
+})(JobStatus || {});
+var ServiceType = /* @__PURE__ */ ((ServiceType2) => {
+  ServiceType2[ServiceType2["TextGeneration"] = 0] = "TextGeneration";
+  ServiceType2[ServiceType2["ImageGeneration"] = 1] = "ImageGeneration";
+  ServiceType2[ServiceType2["DataAnalysis"] = 2] = "DataAnalysis";
+  ServiceType2[ServiceType2["CodeGeneration"] = 3] = "CodeGeneration";
+  ServiceType2[ServiceType2["Translation"] = 4] = "Translation";
+  ServiceType2[ServiceType2["Custom"] = 5] = "Custom";
+  return ServiceType2;
+})(ServiceType || {});
+
+// src/handler/schema.ts
+var DEFAULT_SCHEMAS = {
+  [0 /* TextGeneration */]: {
+    version: 1,
+    serviceRequirements: {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Text prompt to generate from" },
+        maxTokens: { type: "number", description: "Maximum output token count" }
+      },
+      required: ["prompt"]
+    },
+    deliverableRequirements: {
+      type: "object",
+      properties: {
+        text: { type: "string", description: "Generated text output" },
+        tokenCount: { type: "number", description: "Tokens used to produce output" }
+      },
+      required: ["text"]
+    }
+  },
+  [1 /* ImageGeneration */]: {
+    version: 1,
+    serviceRequirements: {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Image prompt to generate from" },
+        size: { type: "string", description: "Output size (for example: 1024x1024)" },
+        style: { type: "string", description: "Desired visual style" }
+      },
+      required: ["prompt"]
+    },
+    deliverableRequirements: {
+      type: "object",
+      properties: {
+        imageUrl: { type: "string", description: "URL of the generated image" },
+        mimeType: { type: "string", description: "Image MIME type" }
+      },
+      required: ["imageUrl"]
+    }
+  },
+  [2 /* DataAnalysis */]: {
+    version: 1,
+    serviceRequirements: {
+      type: "object",
+      properties: {
+        data: { type: "string", description: "Input data for analysis" },
+        analysisRequest: { type: "string", description: "Question or analysis task" }
+      },
+      required: ["data", "analysisRequest"]
+    },
+    deliverableRequirements: {
+      type: "object",
+      properties: {
+        summary: { type: "string", description: "Analysis summary" },
+        findings: {
+          type: "array",
+          description: "Structured key findings",
+          items: { type: "string" }
+        }
+      },
+      required: ["summary"]
+    }
+  },
+  [3 /* CodeGeneration */]: {
+    version: 1,
+    serviceRequirements: {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Code generation request" },
+        language: { type: "string", description: "Target programming language" }
+      },
+      required: ["prompt"]
+    },
+    deliverableRequirements: {
+      type: "object",
+      properties: {
+        code: { type: "string", description: "Generated source code" },
+        language: { type: "string", description: "Detected or requested language" }
+      },
+      required: ["code"]
+    }
+  },
+  [4 /* Translation */]: {
+    version: 1,
+    serviceRequirements: {
+      type: "object",
+      properties: {
+        text: { type: "string", description: "Text to translate" },
+        targetLanguage: { type: "string", description: "Target language code or name" },
+        sourceLanguage: { type: "string", description: "Optional source language code or name" }
+      },
+      required: ["text", "targetLanguage"]
+    },
+    deliverableRequirements: {
+      type: "object",
+      properties: {
+        translatedText: { type: "string", description: "Translated text output" },
+        sourceLanguage: { type: "string", description: "Detected or provided source language" }
+      },
+      required: ["translatedText"]
+    }
+  }
+};
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isTypeMatch(value, type) {
+  switch (type) {
+    case "string":
+      return typeof value === "string";
+    case "number":
+      return typeof value === "number" && Number.isFinite(value);
+    case "boolean":
+      return typeof value === "boolean";
+    case "object":
+      return isObjectRecord(value);
+    case "array":
+      return Array.isArray(value);
+    default:
+      return false;
+  }
+}
+function validateAgainstSchema(data, schema) {
+  if (!data || !isObjectRecord(data)) {
+    return { valid: false, reason: "Requirements must be a JSON object" };
+  }
+  for (const requiredField of schema.required ?? []) {
+    if (!(requiredField in data)) {
+      return { valid: false, reason: `Missing required field: ${requiredField}` };
+    }
+  }
+  for (const [field, fieldSchema] of Object.entries(schema.properties)) {
+    const value = data[field];
+    if (value === void 0) continue;
+    if (!isTypeMatch(value, fieldSchema.type)) {
+      return {
+        valid: false,
+        reason: `Field "${field}" must be of type ${fieldSchema.type}`
+      };
+    }
+    if (fieldSchema.enum && !fieldSchema.enum.some((enumValue) => Object.is(enumValue, value))) {
+      return {
+        valid: false,
+        reason: `Field "${field}" must be one of: ${fieldSchema.enum.map((v) => JSON.stringify(v)).join(", ")}`
+      };
+    }
+    if (fieldSchema.type === "array" && fieldSchema.items && Array.isArray(value)) {
+      for (let i = 0; i < value.length; i += 1) {
+        if (!isTypeMatch(value[i], fieldSchema.items.type)) {
+          return {
+            valid: false,
+            reason: `Field "${field}[${i}]" must be of type ${fieldSchema.items.type}`
+          };
+        }
+      }
+    }
+  }
+  return { valid: true };
+}
+
 // src/utils.ts
 var USDM_DECIMALS = 18;
 var USDM_SCALE = 10n ** BigInt(USDM_DECIMALS);
@@ -3387,28 +3861,6 @@ function formatUsdm(amount) {
   return `${whole}.${trimmedFraction.padEnd(2, "0")}`;
 }
 
-// src/types.ts
-var JobStatus = /* @__PURE__ */ ((JobStatus2) => {
-  JobStatus2[JobStatus2["Created"] = 0] = "Created";
-  JobStatus2[JobStatus2["Accepted"] = 1] = "Accepted";
-  JobStatus2[JobStatus2["InProgress"] = 2] = "InProgress";
-  JobStatus2[JobStatus2["Delivered"] = 3] = "Delivered";
-  JobStatus2[JobStatus2["Evaluated"] = 4] = "Evaluated";
-  JobStatus2[JobStatus2["Completed"] = 5] = "Completed";
-  JobStatus2[JobStatus2["Disputed"] = 6] = "Disputed";
-  JobStatus2[JobStatus2["Cancelled"] = 7] = "Cancelled";
-  return JobStatus2;
-})(JobStatus || {});
-var ServiceType = /* @__PURE__ */ ((ServiceType2) => {
-  ServiceType2[ServiceType2["TextGeneration"] = 0] = "TextGeneration";
-  ServiceType2[ServiceType2["ImageGeneration"] = 1] = "ImageGeneration";
-  ServiceType2[ServiceType2["DataAnalysis"] = 2] = "DataAnalysis";
-  ServiceType2[ServiceType2["CodeGeneration"] = 3] = "CodeGeneration";
-  ServiceType2[ServiceType2["Translation"] = 4] = "Translation";
-  ServiceType2[ServiceType2["Custom"] = 5] = "Custom";
-  return ServiceType2;
-})(ServiceType || {});
-
 // src/indexer/client.ts
 var IndexerClientError = class extends Error {
   status;
@@ -3422,7 +3874,7 @@ var IndexerClientError = class extends Error {
     this.body = options.body;
   }
 };
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null;
 }
 function toIndexerAgent(raw) {
@@ -3446,6 +3898,7 @@ function toIndexerOffering(raw) {
     priceUsdm: raw.price_usdm,
     slaMinutes: raw.sla_minutes,
     description: raw.description,
+    requirementsSchemaUri: raw.requirements_schema_uri ?? void 0,
     active: raw.active === 1,
     blockNumber: raw.block_number,
     txHash: raw.tx_hash
@@ -3610,7 +4063,7 @@ var IndexerClient = class {
       });
     }
     if (!response.ok) {
-      const apiError = isRecord2(payload) ? payload : void 0;
+      const apiError = isRecord3(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,
@@ -3701,7 +4154,6 @@ var ProviderRuntime = class {
           this.processedJobs.add(deliverKey);
           await deployDeliverable(
             this.client,
-            this.agentId,
             BigInt(job.jobId),
             { ...params, jobId: BigInt(job.jobId) },
             this.indexer["baseUrl"]
@@ -3836,7 +4288,6 @@ var BuyerRuntime = class {
       this.processedJobs.add(deliveredKey);
       try {
         const deliverable = await readDeliverable(
-          this.client,
           BigInt(job.jobId),
           this.indexer["baseUrl"]
         );
@@ -3878,6 +4329,7 @@ var HandlerProviderRuntime = class {
   running = false;
   processedJobs = /* @__PURE__ */ new Set();
   failedJobs = /* @__PURE__ */ new Map();
+  schemaCache = /* @__PURE__ */ new Map();
   maxRetries = 3;
   onError;
   constructor(client, agentId, options) {
@@ -3922,8 +4374,8 @@ var HandlerProviderRuntime = class {
     for (const job of jobs) {
       const newKey = `new:${job.jobId}`;
       if (!this.canProcess(newKey)) continue;
-      const matchesOffering = offerings.some((o) => o.offeringId === job.offeringId);
-      if (!matchesOffering) continue;
+      const offering = offerings.find((o) => o.offeringId === job.offeringId);
+      if (!offering) continue;
       const handler = this.handlers.get(job.offeringId);
       if (!handler) continue;
       try {
@@ -3946,6 +4398,10 @@ var HandlerProviderRuntime = class {
         if (reqData) {
           context.requirements = reqData.requirements;
         }
+        const schemaValidation = await this.validateSchemaRequirements(context, handler, offering);
+        if (!schemaValidation.valid) {
+          throw new Error(`Schema validation failed for job ${job.jobId}: ${schemaValidation.reason}`);
+        }
         if (handler.validateRequirements) {
           const validation = await handler.validateRequirements(context);
           if (!validation.valid) {
@@ -3966,6 +4422,10 @@ var HandlerProviderRuntime = class {
     }
   }
   async checkInProgressJobs() {
+    const offerings = await this.indexer.getOfferings({ agentId: Number(this.agentId) });
+    const offeringsById = new Map(
+      offerings.map((offering) => [offering.offeringId, offering])
+    );
     const inProgressJobs = await this.indexer.getJobs({
       status: 2,
       agentId: Number(this.agentId)
@@ -3975,6 +4435,7 @@ var HandlerProviderRuntime = class {
       if (!this.canProcess(deliverKey)) continue;
       const handler = this.handlers.get(job.offeringId);
       if (!handler) continue;
+      const offering = offeringsById.get(job.offeringId);
       try {
         if (job.slaMinutes === null) {
           throw new Error(`Job ${job.jobId} is missing slaMinutes`);
@@ -3995,6 +4456,14 @@ var HandlerProviderRuntime = class {
         if (reqData) {
           context.requirements = reqData.requirements;
         }
+        const schemaValidation = await this.validateSchemaRequirements(context, handler, offering);
+        if (!schemaValidation.valid) {
+          this.markFailed(
+            deliverKey,
+            new Error(`Schema validation failed for job ${job.jobId}: ${schemaValidation.reason}`)
+          );
+          continue;
+        }
         if (handler.validateRequirements) {
           const validation = await handler.validateRequirements(context);
           if (!validation.valid) {
@@ -4040,7 +4509,6 @@ var HandlerProviderRuntime = class {
           };
           await deployDeliverable(
             this.client,
-            this.agentId,
             BigInt(job.jobId),
             deliverableParams,
             this.indexerUrl
@@ -4088,6 +4556,85 @@ var HandlerProviderRuntime = class {
       this.onError?.(new Error(`Giving up on ${key} after ${retries} failed attempts`));
     }
   }
+  async validateSchemaRequirements(context, handler, offering) {
+    if (offering?.requirementsSchemaUri) {
+      try {
+        const offeringSchema = await this.resolveOfferingSchemaFromUri(offering.requirementsSchemaUri);
+        if (!offeringSchema) {
+          return {
+            valid: false,
+            reason: `Unsupported requirementsSchemaUri format: ${offering.requirementsSchemaUri}`
+          };
+        }
+        return validateAgainstSchema(context.requirements, offeringSchema.serviceRequirements);
+      } catch (error) {
+        return {
+          valid: false,
+          reason: error instanceof Error ? error.message : String(error)
+        };
+      }
+    }
+    const defaultSchema = offering ? DEFAULT_SCHEMAS[offering.serviceType] : void 0;
+    const schema = handler.schema ?? defaultSchema;
+    if (!schema) return { valid: true };
+    return validateAgainstSchema(context.requirements, schema.serviceRequirements);
+  }
+  async resolveOfferingSchemaFromUri(schemaUri) {
+    const cached = this.schemaCache.get(schemaUri);
+    if (cached !== void 0) {
+      return cached;
+    }
+    let schemaPayload;
+    if (schemaUri.startsWith("data:")) {
+      schemaPayload = this.parseDataUriJson(schemaUri);
+    } else if (schemaUri.startsWith("http://") || schemaUri.startsWith("https://")) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 3e4);
+      try {
+        const response = await fetch(schemaUri, { signal: controller.signal });
+        if (!response.ok) {
+          throw new Error(`Failed to fetch requirements schema URI (${response.status} ${response.statusText})`);
+        }
+        const buf = await response.arrayBuffer();
+        if (buf.byteLength > 1048576) {
+          throw new Error(`Schema too large (${buf.byteLength} bytes). Limit is 1MB`);
+        }
+        schemaPayload = JSON.parse(new TextDecoder().decode(buf));
+      } finally {
+        clearTimeout(timeoutId);
+      }
+    } else if (schemaUri.trim().startsWith("{")) {
+      schemaPayload = JSON.parse(schemaUri);
+    } else {
+      this.schemaCache.set(schemaUri, null);
+      return null;
+    }
+    if (!this.isOfferingSchema(schemaPayload)) {
+      throw new Error("requirementsSchemaUri did not resolve to a valid OfferingSchema document");
+    }
+    this.schemaCache.set(schemaUri, schemaPayload);
+    return schemaPayload;
+  }
+  parseDataUriJson(dataUri) {
+    const commaIndex = dataUri.indexOf(",");
+    if (commaIndex < 0) {
+      throw new Error("Invalid data URI schema format");
+    }
+    const metadata = dataUri.slice(5, commaIndex);
+    const payload = dataUri.slice(commaIndex + 1);
+    const decoded = metadata.includes(";base64") ? new TextDecoder().decode(Uint8Array.from(atob(payload), (char) => char.charCodeAt(0))) : decodeURIComponent(payload);
+    return JSON.parse(decoded);
+  }
+  isOfferingSchema(value) {
+    if (typeof value !== "object" || value === null) return false;
+    const candidate = value;
+    return typeof candidate.version === "number" && this.isJsonSchema(candidate.serviceRequirements) && this.isJsonSchema(candidate.deliverableRequirements);
+  }
+  isJsonSchema(value) {
+    if (typeof value !== "object" || value === null) return false;
+    const candidate = value;
+    return candidate.type === "object" && typeof candidate.properties === "object" && candidate.properties !== null;
+  }
   getRemainingSlaMs(createdAt, acceptedAt, slaMinutes) {
     const start = acceptedAt ?? createdAt;
     if (start === null) return null;
@@ -5470,6 +6017,7 @@ export {
   BPS_DENOMINATOR,
   BuyerRuntime,
   DEFAULT_INDEXER_URLS,
+  DEFAULT_SCHEMAS,
   EVALUATION_TIMEOUT,
   FEE_BPS,
   HandlerProviderRuntime,
@@ -5480,6 +6028,7 @@ export {
   MEMO_TYPES,
   PLATFORM_BUYER_AGENT_ID,
   PULSE_DOMAIN,
+  PromptHandler,
   ProviderRuntime,
   RISK_POOL_BPS,
   ServiceType,
@@ -5543,6 +6092,8 @@ export {
   submitDeliverable,
   testnetERC8004,
   updateOffering,
+  updateOfferingSchema,
+  validateAgainstSchema,
   verifyContentHash
 };
 //# sourceMappingURL=index.js.map