@pulseai/sdk 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -321,6 +321,32 @@ declare function createRequirements(params: RequirementsParams): {
     hash: Hex;
 };
 
+type JsonSchema = {
+    type: 'object';
+    properties: Record<string, {
+        type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+        description?: string;
+        enum?: unknown[];
+        items?: {
+            type: string;
+        };
+    }>;
+    required?: string[];
+};
+/** Pulse offering schema document (JSON Schema-based). */
+type OfferingSchema = {
+    version: number;
+    serviceRequirements: JsonSchema;
+    deliverableRequirements: JsonSchema;
+};
+/** Default schemas by service type (Custom/5 intentionally omitted). */
+declare const DEFAULT_SCHEMAS: Record<number, OfferingSchema>;
+/** Validate runtime data against a compact JSON Schema object definition. */
+declare function validateAgainstSchema(data: Record<string, unknown> | undefined, schema: JsonSchema): {
+    valid: boolean;
+    reason?: string;
+};
+
 type JobContext = {
     jobId: bigint;
     offeringId: bigint;
@@ -336,6 +362,11 @@ type ExecuteJobResult = {
     content?: string;
     url?: string;
     mimeType?: string;
+    usage?: {
+        provider: string;
+        inputTokens: number;
+        outputTokens: number;
+    };
 };
 type ValidationResult = {
     valid: boolean;
@@ -344,6 +375,7 @@ type ValidationResult = {
 interface OfferingHandler {
     offeringId: number;
     autoAccept?: boolean;
+    schema?: OfferingSchema;
     validateRequirements?(context: JobContext): Promise<ValidationResult>;
     executeJob(context: JobContext): Promise<ExecuteJobResult>;
 }
@@ -360,6 +392,7 @@ type SiteModifierConfig = {
 declare class SiteModifierHandler implements OfferingHandler {
     readonly offeringId: number;
     readonly autoAccept?: boolean;
+    readonly schema: OfferingSchema;
     private readonly config;
     constructor(offeringId: number, config: SiteModifierConfig, options?: {
         autoAccept?: boolean;
@@ -542,10 +575,15 @@ type CallAIParams = {
     maxTokens?: number;
     signal?: AbortSignal;
 };
+type AIUsage = {
+    inputTokens: number;
+    outputTokens: number;
+};
 type CallAIResult = {
     content: string;
     truncated: boolean;
     raw: unknown;
+    usage?: AIUsage;
 };
 type AICallOptions = CallAIParams;
 type AICallResult = CallAIResult;
@@ -588,6 +626,7 @@ interface IndexerOffering {
     priceUsdm: string;
     slaMinutes: number | null;
     description: string | null;
+    requirementsSchemaUri?: string;
     active: boolean;
     blockNumber: number | null;
     txHash: string | null;
@@ -720,6 +759,7 @@ declare class HandlerProviderRuntime {
     private running;
     private processedJobs;
     private failedJobs;
+    private schemaCache;
     private readonly maxRetries;
     private onError?;
     constructor(client: PulseClient, agentId: bigint, options: HandlerProviderRuntimeOptions);
@@ -734,6 +774,11 @@ declare class HandlerProviderRuntime {
     private canProcess;
     private markProcessed;
     private markFailed;
+    private validateSchemaRequirements;
+    private resolveOfferingSchemaFromUri;
+    private parseDataUriJson;
+    private isOfferingSchema;
+    private isJsonSchema;
     private getRemainingSlaMs;
 }
 
@@ -3629,4 +3674,4 @@ declare const masterAbi: readonly [{
     readonly anonymous: false;
 }];
 
-export { ACCEPT_TIMEOUT, type AICallOptions, type AICallResult, type AIMessage, type AIProvider, type AgentCardParams, BPS_DENOMINATOR, type BuyerCallbacks, BuyerRuntime, type BuyerRuntimeOptions, type CreateJobParams, type CreatePresetPulseClientOptions, type CreatePulseClientOptions, DEFAULT_INDEXER_URLS, type DeliverableData, type DeliverableParams, EVALUATION_TIMEOUT, type ExecuteJobResult, FEE_BPS, HandlerProviderRuntime, type HandlerProviderRuntimeOptions, type IndexerAgent, IndexerClient, IndexerClientError, type IndexerClientOptions, type IndexerJob, type IndexerJobsFilter, type IndexerOffering, type IndexerOfferingsFilter, type IndexerWarrenLink, type IndexerWarrenLinks, type Job, type JobContext, type JobOffering, JobStatus, type JobTermsParams, type ListOfferingParams, MAINNET_ADDRESSES, MEMO_TYPES, type OfferingHandler, PLATFORM_BUYER_AGENT_ID, PULSE_DOMAIN, type PresetPulseClient, type ProviderCallbacks, ProviderRuntime, type ProviderRuntimeOptions, type PulseAddresses, type PulseAgentData, type PulseClient, RISK_POOL_BPS, type RequirementsData, type RequirementsParams, ServiceType, type SignMemoParams, type SiteModifierConfig, SiteModifierHandler, TESTNET_ADDRESSES, TREASURY_BPS, USDM_MAINNET, type ValidationResult, acceptJob, activateOffering, buyerRelayAbi, callAI, cancelJob, createAgentCard, createDeliverable, createJob, createJobTerms, createMainnetClient, createPulseClient, createRequirements, createTestnetClient, deactivateOffering, deployAgentCard, deployDeliverable, deployJobTerms, deployRequirements, deployWarrenMaster, deployWarrenPage, erc20Abi, erc8004IdentityAbi, erc8004ReputationAbi, evaluate, feeDistributorAbi, formatUsdm, getAgent, getJob, getJobCount, getOffering, getOfferingCount, initAgent, jobEngineAbi, listOffering, mainnetERC8004, masterAbi, megaethMainnet, megaethTestnet, pageAbi, parseUsdm, pulseExtensionAbi, readDeliverable, readRequirements, readWarrenMaster, readWarrenPage, registerAgent, rejectJob, resolveDispute, serviceMarketplaceAbi, setOperator, setWarrenContract, settle, signMemo, submitDeliverable, testnetERC8004, updateOffering, verifyContentHash };
+export { ACCEPT_TIMEOUT, type AICallOptions, type AICallResult, type AIMessage, type AIProvider, type AIUsage, type AgentCardParams, BPS_DENOMINATOR, type BuyerCallbacks, BuyerRuntime, type BuyerRuntimeOptions, type CreateJobParams, type CreatePresetPulseClientOptions, type CreatePulseClientOptions, DEFAULT_INDEXER_URLS, DEFAULT_SCHEMAS, type DeliverableData, type DeliverableParams, EVALUATION_TIMEOUT, type ExecuteJobResult, FEE_BPS, HandlerProviderRuntime, type HandlerProviderRuntimeOptions, type IndexerAgent, IndexerClient, IndexerClientError, type IndexerClientOptions, type IndexerJob, type IndexerJobsFilter, type IndexerOffering, type IndexerOfferingsFilter, type IndexerWarrenLink, type IndexerWarrenLinks, type Job, type JobContext, type JobOffering, JobStatus, type JobTermsParams, type JsonSchema, type ListOfferingParams, MAINNET_ADDRESSES, MEMO_TYPES, type OfferingHandler, type OfferingSchema, PLATFORM_BUYER_AGENT_ID, PULSE_DOMAIN, type PresetPulseClient, type ProviderCallbacks, ProviderRuntime, type ProviderRuntimeOptions, type PulseAddresses, type PulseAgentData, type PulseClient, RISK_POOL_BPS, type RequirementsData, type RequirementsParams, ServiceType, type SignMemoParams, type SiteModifierConfig, SiteModifierHandler, TESTNET_ADDRESSES, TREASURY_BPS, USDM_MAINNET, type ValidationResult, acceptJob, activateOffering, buyerRelayAbi, callAI, cancelJob, createAgentCard, createDeliverable, createJob, createJobTerms, createMainnetClient, createPulseClient, createRequirements, createTestnetClient, deactivateOffering, deployAgentCard, deployDeliverable, deployJobTerms, deployRequirements, deployWarrenMaster, deployWarrenPage, erc20Abi, erc8004IdentityAbi, erc8004ReputationAbi, evaluate, feeDistributorAbi, formatUsdm, getAgent, getJob, getJobCount, getOffering, getOfferingCount, initAgent, jobEngineAbi, listOffering, mainnetERC8004, masterAbi, megaethMainnet, megaethTestnet, pageAbi, parseUsdm, pulseExtensionAbi, readDeliverable, readRequirements, readWarrenMaster, readWarrenPage, registerAgent, rejectJob, resolveDispute, serviceMarketplaceAbi, setOperator, setWarrenContract, settle, signMemo, submitDeliverable, testnetERC8004, updateOffering, validateAgainstSchema, verifyContentHash };

package/dist/index.js

@@ -2896,7 +2896,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 +2931,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 +2967,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 +2992,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 = [
@@ -3110,6 +3113,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 +3181,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 +3285,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) {
@@ -3351,6 +3402,189 @@ var SiteModifierHandler = class {
   }
 };
 
+// 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 +3621,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;
@@ -3446,6 +3658,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
@@ -3878,6 +4091,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 +4136,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 +4160,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 +4184,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 +4197,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 +4218,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) {
@@ -4088,6 +4319,75 @@ 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 response = await fetch(schemaUri);
+      if (!response.ok) {
+        throw new Error(`Failed to fetch requirements schema URI (${response.status} ${response.statusText})`);
+      }
+      schemaPayload = await response.json();
+    } 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 +5770,7 @@ export {
   BPS_DENOMINATOR,
   BuyerRuntime,
   DEFAULT_INDEXER_URLS,
+  DEFAULT_SCHEMAS,
   EVALUATION_TIMEOUT,
   FEE_BPS,
   HandlerProviderRuntime,
@@ -5543,6 +5844,7 @@ export {
   submitDeliverable,
   testnetERC8004,
   updateOffering,
+  validateAgainstSchema,
   verifyContentHash
 };
 //# sourceMappingURL=index.js.map