{"id":"qualifier-compare","title":"Requested vs quoted specification attributes: met, not met or not comparable","description":"Compares up to 200 requested attribute requirements with the values a supplier quoted (voltage, grade, finish, tolerance, brand, certification), for an agent checking that a quote matches the request before buying. Requirements are eq, ne, gte, lte, gt, lt, between (value..max), in (a list) or present; numeric comparisons use exact decimals, an optional tolerance, and the caller's unit conversions (none are built in). A missing quoted value, a unit with no conversion, or a non-numeric value in a numeric requirement is not-comparable, so the result is unknown rather than a pass. Text is compared after trimming and Unicode NFKC, case-insensitively unless caseSensitive. With no ordering operator and no tolerance, eq and ne read numbers only in canonical form (so \"0123\" and \"123\" are different identifiers, \"100\" and \"100.0\" are equal). Does not judge equivalence of different words or part numbers.","roi":"A quote that omits the voltage or quotes it in different units is not a match. Each attribute is met, not met or not comparable, with both values shown.","audience":"business","package":"money-math-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/qualifier-compare","path":"/api/v1/qualifier-compare","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["items"],"properties":{"items":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"object","required":["attribute","requested"],"properties":{"attribute":{"type":"string","minLength":1,"maxLength":80},"requested":{"type":"object","required":["op"],"properties":{"op":{"type":"string","enum":["eq","ne","gte","lte","gt","lt","between","in","present"]},"value":{"type":"string","maxLength":200,"description":"Required value (numeric ops need a decimal string)."},"max":{"type":"string","pattern":"^-?\\d{1,15}(\\.\\d{1,12})?$","maxLength":30,"description":"Upper bound for between."},"values":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":200},"description":"Allowed values for in."},"unit":{"type":"string","minLength":1,"maxLength":24,"description":"Unit of the requested number."},"tolerance":{"type":"string","pattern":"^-?\\d{1,15}(\\.\\d{1,12})?$","maxLength":30,"description":"Absolute slack in the requested unit applied to numeric eq/gte/lte/gt/lt/between (e.g. a +/- 0.5 mm)."}},"additionalProperties":false},"quoted":{"type":"object","properties":{"value":{"type":"string","maxLength":200},"unit":{"type":"string","minLength":1,"maxLength":24}},"description":"Omit or leave value out when the quote does not state the attribute.","additionalProperties":false}},"additionalProperties":false}},"conversions":{"type":"array","maxItems":50,"items":{"type":"object","required":["from","to","factor"],"properties":{"from":{"type":"string","minLength":1,"maxLength":24},"to":{"type":"string","minLength":1,"maxLength":24},"factor":{"type":"string","pattern":"^-?\\d{1,15}(\\.\\d{1,12})?$","maxLength":30,"description":"value in `to` = value in `from` x factor."}},"additionalProperties":false},"description":"Caller-supplied unit conversions; none are built in."},"caseSensitive":{"type":"boolean"}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"attribute":{"type":"string"},"result":{"type":"string","enum":["met","not-met","not-comparable"]},"detail":{"type":"string"}}}},"counts":{"type":"object","properties":{"met":{"type":"integer"},"notMet":{"type":"integer"},"notComparable":{"type":"integer"}}},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"attribute":{"type":"string"},"result":{"type":"string","enum":["met","not-met","not-comparable"]},"detail":{"type":"string"}}}},"counts":{"type":"object","properties":{"met":{"type":"integer"},"notMet":{"type":"integer"},"notComparable":{"type":"integer"}}},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"items":[{"attribute":"voltage","requested":{"op":"gte","value":"24","unit":"V"},"quoted":{"value":"24","unit":"V"}},{"attribute":"length","requested":{"op":"eq","value":"100","unit":"mm","tolerance":"0.5"},"quoted":{"value":"10.2","unit":"cm"}},{"attribute":"finish","requested":{"op":"in","values":["anodized","powder coat"]},"quoted":{"value":"Anodised"}},{"attribute":"ip-rating","requested":{"op":"present"}}],"conversions":[{"from":"cm","to":"mm","factor":"10"}]},"openapiOperation":{"operationId":"qualifier_compare","summary":"Requested vs quoted specification attributes: met, not met or not comparable","description":"Compares up to 200 requested attribute requirements with the values a supplier quoted (voltage, grade, finish, tolerance, brand, certification), for an agent checking that a quote matches the request before buying. Requirements are eq, ne, gte, lte, gt, lt, between (value..max), in (a list) or present; numeric comparisons use exact decimals, an optional tolerance, and the caller's unit conversions (none are built in). A missing quoted value, a unit with no conversion, or a non-numeric value in a numeric requirement is not-comparable, so the result is unknown rather than a pass. Text is compared after trimming and Unicode NFKC, case-insensitively unless caseSensitive. With no ordering operator and no tolerance, eq and ne read numbers only in canonical form (so \"0123\" and \"123\" are different identifiers, \"100\" and \"100.0\" are equal). Does not judge equivalence of different words or part numbers.\n\nPrice: 0.005 USDC on Base (x402).","x-x402-price-usdc":"0.005","x-x402-amount":"5000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"x-audience":"business","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/qualifier-compare","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["items"],"properties":{"items":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"object","required":["attribute","requested"],"properties":{"attribute":{"type":"string","minLength":1,"maxLength":80},"requested":{"type":"object","required":["op"],"properties":{"op":{"type":"string","enum":["eq","ne","gte","lte","gt","lt","between","in","present"]},"value":{"type":"string","maxLength":200,"description":"Required value (numeric ops need a decimal string)."},"max":{"type":"string","pattern":"^-?\\d{1,15}(\\.\\d{1,12})?$","maxLength":30,"description":"Upper bound for between."},"values":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":200},"description":"Allowed values for in."},"unit":{"type":"string","minLength":1,"maxLength":24,"description":"Unit of the requested number."},"tolerance":{"type":"string","pattern":"^-?\\d{1,15}(\\.\\d{1,12})?$","maxLength":30,"description":"Absolute slack in the requested unit applied to numeric eq/gte/lte/gt/lt/between (e.g. a +/- 0.5 mm)."}},"additionalProperties":false},"quoted":{"type":"object","properties":{"value":{"type":"string","maxLength":200},"unit":{"type":"string","minLength":1,"maxLength":24}},"description":"Omit or leave value out when the quote does not state the attribute.","additionalProperties":false}},"additionalProperties":false}},"conversions":{"type":"array","maxItems":50,"items":{"type":"object","required":["from","to","factor"],"properties":{"from":{"type":"string","minLength":1,"maxLength":24},"to":{"type":"string","minLength":1,"maxLength":24},"factor":{"type":"string","pattern":"^-?\\d{1,15}(\\.\\d{1,12})?$","maxLength":30,"description":"value in `to` = value in `from` x factor."}},"additionalProperties":false},"description":"Caller-supplied unit conversions; none are built in."},"caseSensitive":{"type":"boolean"}}},"example":{"items":[{"attribute":"voltage","requested":{"op":"gte","value":"24","unit":"V"},"quoted":{"value":"24","unit":"V"}},{"attribute":"length","requested":{"op":"eq","value":"100","unit":"mm","tolerance":"0.5"},"quoted":{"value":"10.2","unit":"cm"}},{"attribute":"finish","requested":{"op":"in","values":["anodized","powder coat"]},"quoted":{"value":"Anodised"}},{"attribute":"ip-rating","requested":{"op":"present"}}],"conversions":[{"from":"cm","to":"mm","factor":"10"}]}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"attribute":{"type":"string"},"result":{"type":"string","enum":["met","not-met","not-comparable"]},"detail":{"type":"string"}}}},"counts":{"type":"object","properties":{"met":{"type":"integer"},"notMet":{"type":"integer"},"notComparable":{"type":"integer"}}},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/qualifier-compare/","docsJson":"https://agents.writerslogic.com/docs/qualifier-compare.json","sample":"https://agents.writerslogic.com/api/v1/samples/qualifier-compare","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}