deals

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['watch_id'], 'properties': {'watch_id': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': 'The watch_id returned by register_watch.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['watch_id'], 'properties': {'cursor': {'type': 'string', 'maxLength': 2048, 'description': 'Opaque live_matches.cursor continuation; an incomplete scan is not a no-match result.'}, 'watch_id': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': 'The watch_id returned by register_watch.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['deal_id'], 'properties': {'full': {'type': 'boolean', 'description': 'true = full ~30-field record with provenance + price history. Default false (compact).'}, 'deal_id': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': 'Deal id from search_deals / latest_deals results.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5).'}, 'category': {'type': 'string', 'maxLength': 100, 'description': 'Category filter (comma-separated allowed). Currently in scope: electronics.'}, 'max_price_cents': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Only deals at or below this price, in cents.', 'exclusiveMinimum': 0}, 'highlighted_only': {'type': 'boolean', 'description': "true = only current Kit's Picks, ordered by the most recent highlight decision."}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['intent'], 'properties': {'specs': {'type': 'object', 'description': 'Structured spec/attribute constraints. Omit keys you have no value for. Whole-entry null, empty, none and n/a markers are ignored and counted. Pass these whenever the human names a hard requirement. Keys are generated from docs/spec-keys.json: numeric <spec_key>_min/_max (an exact 8 TB drive is storage_gb_min: 8000 plus storage_gb_max: 8000), enum/list <spec_key>_in for any-of (camera_type_in, bundle_includes_in), enum-list <spec_key>_contains_all for every requested member (bundle_includes_contains_all), and boolean direct keys (bundle). Numeric bounds may use {value,unit} with a registered conversion. Storage uses decimal GB: 1 TB = 1000 GB. Unknown keys are rejected; deals missing the constrained spec are excluded (must-have semantics). Deterministic intent extraction is a fallback; explicit specs always override it, and soft phrasing ("around 65 inches") is never auto-constrained.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'anyOf': [{'type': 'number'}, {'type': 'string'}, {'type': 'boolean'}, {'type': 'array', 'items': {'type': 'string'}}, {'type': 'object', 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string', 'maxLength': 24}, 'value': {'type': 'number'}}, 'additionalProperties': False}]}, {'type': 'null'}]}}, 'intent': {'type': 'string', 'maxLength': 1000, 'minLength': 3, 'description': 'Free-text intent (e.g. "Oura Ring 4 silver under $350"). The interpretation pipeline owns the structuring.'}, 'agent_id': {'type': 'string', 'maxLength': 200, 'description': 'Self-identifier for telemetry (e.g. "claude-desktop:tom"). Helps us prioritize agent demand.'}, 'conditions': {'type': 'array', 'items': {'enum': ['new', 'open_box', 'refurbished', 'pre_owned'], 'type': 'string'}, 'minItems': 1, 'description': 'Accepted deal conditions. Defaults to new + open_box. During consent, surface all four categories and ask whether to add refurbished/pre_owned or restrict to new only.'}, 'model_number': {'type': 'string', 'maxLength': 100, 'description': 'Manufacturer model number (MPN) for the exact variant — e.g. "K-65XR70" for the Sony BRAVIA 7 65". A concrete MPN auto-promotes in ~60s; family-level intents without one require operator review (hours).'}, 'max_price_cents': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Hard price ceiling for delivery, in cents (a numeric string like "150000" is accepted).', 'exclusiveMinimum': 0}, 'min_discount_pct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Minimum discount percentage for delivery.'}, 'webhook_callback_url': {'type': 'string', 'maxLength': 500, 'description': 'https:// endpoint to receive push deliveries (activates post-interpretation).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['deal_id', 'outcome'], 'properties': {'notes': {'type': 'string', 'maxLength': 1000, 'description': 'What you or your human saw. Required for other. Leave out personal details.'}, 'deal_id': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'The deal id you acted on.'}, 'outcome': {'enum': ['purchased', 'price_confirmed', 'wrong_price', 'out_of_stock', 'deal_dead', 'checkout_failed', 'irrelevant', 'other'], 'type': 'string', 'description': 'What happened. purchased: Your human bought it. price_confirmed: You checked the retailer: the price and stock matched the deal. wrong_price: The retailer shows a different price. Send actual_price_cents. out_of_stock: The retailer shows it unavailable. deal_dead: The offer is gone: page removed, promotion ended, or link broken. checkout_failed: Your human could not complete checkout (cart, coupon, region, payment). irrelevant: The deal did not fit what your human asked for. other: Anything else that looked wrong. Describe it in notes (required).'}, 'watch_id': {'type': 'string', 'maxLength': 64, 'description': 'The watch that surfaced this deal, if any.'}, 'actual_price_cents': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'The price the retailer actually showed, in cents. Include it for wrong_price.', 'exclusiveMinimum': 0}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5).'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 2, 'description': 'Search keywords — product name, brand, model number, or merchant. Token-AND: every word must match.'}, 'category': {'type': 'string', 'maxLength': 100, 'description': 'Category filter (comma-separated allowed). Currently in scope: electronics.'}, 'max_price_cents': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Only deals at or below this price, in cents (e.g. 35000 = $350).', 'exclusiveMinimum': 0}, 'min_discount_pct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Only deals with at least this discount percentage.'}}}