{"openapi":"3.1.0","info":{"title":"SNHP — negotiation rules your AI can't break","description":"Turn a seller's offer into negotiation rules and draft replies to buyers inside them. Model-backed calls need an access key (pilots).","version":"0.1.0"},"paths":{"/.well-known/mcp/server-card.json":{"get":{"tags":["discovery"],"summary":"MCP server card (SEP-1649 — lets registries skip a live scan)","description":"Static MCP server card in the SEP-1649 shape (serverInfo + tools/resources/\nprompts + authentication) so Smithery/registries index the hosted\nstreamable-HTTP server WITHOUT a live initialize scan (which can 502 on a cold\nstart, and which some scanners can't complete through the /mcp -> /mcp/\nredirect). Generated from the live tool definitions so it never drifts.\n\nThis card describes the CORE door only: `_mcp_tools_for_card()` enumerates the\nlive `mcp` instance's tool manager, so it auto-slims to the 15 hero-first core\ntools (no hand-maintained list to drift). The full/legacy surface is pointed\nat via `transport_pro` (/mcp/pro/).","operationId":"mcp_server_card__well_known_mcp_server_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mcp Server Card  Well Known Mcp Server Card Json Get"}}}}}}},"/v1/policy/templates":{"get":{"tags":["negotiation policy"],"summary":"Starting offers you can edit","operationId":"policy_templates_v1_policy_templates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/policy/compile":{"post":{"tags":["negotiation policy"],"summary":"Turn a plain-language offer into negotiation rules","operationId":"policy_compile_v1_policy_compile_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompileIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy/check":{"post":{"tags":["negotiation policy"],"summary":"Check an edited policy (no model call)","operationId":"policy_check_v1_policy_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/reply":{"post":{"tags":["negotiation policy"],"summary":"Draft the reply to a buyer's message, inside your rules","operationId":"reply_v1_reply_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplyIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt/verify":{"post":{"tags":["negotiation policy"],"summary":"Verify a signed deal receipt against your policy","operationId":"receipt_verify_v1_receipt_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/practice/buyer":{"post":{"tags":["negotiation policy"],"summary":"A simulated AI buyer's next message (try your policy)","operationId":"practice_buyer_v1_practice_buyer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PracticeIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pilot/request":{"post":{"tags":["negotiation policy"],"summary":"Ask for a pilot","operationId":"pilot_request_v1_pilot_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PilotIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/llms.txt":{"get":{"tags":["discovery"],"summary":"Agent-readable guide to the toolkit","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms-full.txt":{"get":{"tags":["discovery"],"summary":"Detailed companion to /llms.txt (store endpoints, auth, MPP flow)","description":"A strict SUPERSET of /llms.txt: the same content, then a store reference\nappendix (endpoint list, auth, money unit + fee, MCP tool catalog, the\nno-human MPP flow). Built by appending _LLMS_FULL_APPENDIX to the /llms.txt\nbody so the two can never tell divergent stories.","operationId":"llms_full_txt_llms_full_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/PRICING.md":{"get":{"tags":["discovery"],"summary":"Pricing & service posture","operationId":"pricing_md_PRICING_md_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/health":{"get":{"tags":["discovery"],"summary":"Liveness check","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AgenticTopupIn":{"properties":{"api_key":{"type":"string","title":"Api Key"},"amount_cents":{"type":"integer","title":"Amount Cents","description":"cents of wallet credit to buy (min 200); you pay this + the counter fee (5% + 30¢)"},"payment_token":{"type":"string","title":"Payment Token","description":"a Stripe Shared Payment Token (spt_…) the agent carries"}},"type":"object","required":["api_key","amount_cents","payment_token"],"title":"AgenticTopupIn"},"BundleIssue":{"properties":{"name":{"type":"string","title":"Name","description":"Issue name, e.g. 'price' or 'base_salary'"},"options":{"items":{},"type":"array","title":"Options","description":"The choices on this issue, e.g. ['$50','$40','$30']"},"my_utility":{"items":{"type":"number"},"type":"array","title":"My Utility","description":"How good each option is to YOU (one number per option, any scale)"},"their_utility":{"items":{"type":"number"},"type":"array","title":"Their Utility","description":"How good each option is to THEM (their preference direction; one per option)"}},"type":"object","required":["name","options","my_utility","their_utility"],"title":"BundleIssue"},"BundleMoveIn":{"properties":{"api_key":{"type":"string","title":"Api Key"},"session_id":{"type":"string","title":"Session Id"},"issues":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Issues"},"their_offers":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Their Offers"},"my_priorities":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"My Priorities"},"my_batna":{"type":"number","title":"My Batna","default":0.4},"their_batna_estimate":{"type":"number","title":"Their Batna Estimate","default":0.4},"cooperation":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cooperation"}},"type":"object","required":["api_key","session_id","issues"],"title":"BundleMoveIn"},"BuyNextOfferRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"my_reservation":{"type":"number","maximum":1.0,"minimum":0.0,"title":"My Reservation"},"seller_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"title":"Seller Offer History","description":"Seller's offers evaluated in our (buyer's) utility space, in [0, 1]"},"my_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"title":"My Offer History"},"deadline_rounds":{"type":"integer","maximum":64.0,"minimum":1.0,"title":"Deadline Rounds"},"pareto_knob":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Pareto Knob","description":"Buyer-side Pareto knob (0=max deal rate, 1=max margin)","default":0.5},"defenses":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Defenses","description":"Defense bundle; default ['schelling_commitment', 'anchor_attack_detection']"},"market_prior":{"anyOf":[{"$ref":"#/components/schemas/MarketPrior"},{"type":"null"}],"description":"Required when anchor_attack_detection is in defenses"},"peer_mode":{"type":"boolean","title":"Peer Mode","description":"Set True when counterparty is a verified SNHP-protocol peer. Activates cooperative architecture (PEER playbook + signaling). Empirically reaches 96-101% of Pareto frontier vs 89-92% vanilla.","default":false}},"type":"object","required":["my_reservation","deadline_rounds"],"title":"BuyNextOfferRequest"},"BuyNextOfferResponse":{"properties":{"recommended_offer":{"type":"number","title":"Recommended Offer"},"acceptance_probability":{"type":"number","title":"Acceptance Probability"},"expected_payoff":{"type":"number","title":"Expected Payoff"},"warnings":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Warnings"},"defense_actions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Defense Actions"},"rationale":{"type":"string","title":"Rationale"},"posterior":{"additionalProperties":true,"type":"object","title":"Posterior"},"rubinstein_share":{"type":"number","title":"Rubinstein Share"},"schelling_floor":{"type":"number","title":"Schelling Floor"}},"type":"object","required":["recommended_offer","acceptance_probability","expected_payoff","warnings","defense_actions","rationale","posterior","rubinstein_share","schelling_floor"],"title":"BuyNextOfferResponse"},"BuyerBlock":{"properties":{"disclosure":{"additionalProperties":true,"type":"object","title":"Disclosure","description":"{'utilities': {sku: $}, 'walk_cost': $}"},"peer_proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Peer Proof"}},"type":"object","required":["disclosure"],"title":"BuyerBlock"},"BuyerSpec":{"properties":{"values":{"additionalProperties":{"additionalProperties":{"type":"number"},"type":"object"},"type":"object","title":"Values","description":"dim_id -> option_id -> per-unit dollar value"},"qty_decay":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Qty Decay","description":"each extra unit is worth this fraction of the previous","default":0.15},"outside":{"type":"number","maximum":1000000000.0,"minimum":0.0,"title":"Outside","description":"the buyer's outside-option surplus in dollars","default":0.0},"balk":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Balk","description":"probability a walk-in is turned away by the queue","default":0.0},"defer":{"additionalProperties":{"type":"number"},"type":"object","title":"Defer","description":"slot_ticks -> dollar cost of waiting for that slot"}},"additionalProperties":false,"type":"object","title":"BuyerSpec","description":"A separable buyer (core/engine.SeparableBuyer): per-option dollar\nvalues, a quantity-decay ladder, and scalar outside/balk/defer reports."},"CheckIn":{"properties":{"policy":{"additionalProperties":true,"type":"object","title":"Policy"}},"type":"object","required":["policy"],"title":"CheckIn"},"CheckoutIn":{"properties":{"api_key":{"type":"string","title":"Api Key"},"pack":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pack","description":"small ($10.80) | medium ($52.80) | large ($210.30)"},"amount_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Cents","description":"custom top-up: cents of wallet credit (min 200); you pay this + the counter fee (5% + 30¢)"},"success_url":{"type":"string","title":"Success Url","default":"https://snhp.dev/paid"},"cancel_url":{"type":"string","title":"Cancel Url","default":"https://snhp.dev/cancel"}},"type":"object","required":["api_key"],"title":"CheckoutIn"},"CompileIn":{"properties":{"description":{"type":"string","title":"Description","description":"Your offer in plain words: price, the lowest you'd take, what you would trade a discount for, what is never on the table."}},"type":"object","required":["description"],"title":"CompileIn"},"DeclareFirstStrikeRequest":{"properties":{"buyer_id":{"type":"string","maxLength":128,"minLength":1,"title":"Buyer Id"},"seller_id":{"type":"string","maxLength":128,"minLength":1,"title":"Seller Id"},"reservation_hash":{"type":"string","maxLength":43,"minLength":43,"pattern":"^[A-Za-z0-9_\\-]{43}$","title":"Reservation Hash","description":"SHA-256 base64url of (reservation || nonce || salt || ids)"},"deadline_iso":{"type":"string","maxLength":64,"minLength":15,"title":"Deadline Iso","description":"ISO 8601 deadline, e.g. 2026-04-29T14:00:00Z"},"binding_ttl_seconds":{"type":"integer","maximum":86400.0,"minimum":60.0,"title":"Binding Ttl Seconds"}},"type":"object","required":["buyer_id","seller_id","reservation_hash","deadline_iso","binding_ttl_seconds"],"title":"DeclareFirstStrikeRequest"},"DeclareFirstStrikeResponse":{"properties":{"commitment_id":{"type":"string","title":"Commitment Id"},"attestation_jwt":{"type":"string","title":"Attestation Jwt"},"expires_at_unix":{"type":"integer","title":"Expires At Unix"},"expires_at_iso":{"type":"string","title":"Expires At Iso"},"trust_anchor_public_key_pem":{"type":"string","title":"Trust Anchor Public Key Pem"}},"type":"object","required":["commitment_id","attestation_jwt","expires_at_unix","expires_at_iso","trust_anchor_public_key_pem"],"title":"DeclareFirstStrikeResponse"},"DepsSpec":{"properties":{"valid_on":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Valid On"},"requires":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Requires"},"excludes":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Excludes"}},"additionalProperties":false,"type":"object","title":"DepsSpec"},"DetectAnchorAttackRequest":{"properties":{"opponent_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"minItems":0,"title":"Opponent Offer History"},"market_prior":{"$ref":"#/components/schemas/MarketPrior"}},"type":"object","required":["opponent_offer_history","market_prior"],"title":"DetectAnchorAttackRequest"},"DetectAnchorAttackResponse":{"properties":{"is_anchor_attack":{"type":"boolean","title":"Is Anchor Attack"},"z_score":{"type":"number","title":"Z Score"},"severity":{"type":"number","title":"Severity"},"recommended_response":{"type":"string","title":"Recommended Response"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["is_anchor_attack","z_score","severity","recommended_response","rationale"],"title":"DetectAnchorAttackResponse"},"DimSpec":{"properties":{"id":{"type":"string","maxLength":64,"minLength":1,"title":"Id"},"kind":{"type":"string","title":"Kind"},"options":{"items":{"$ref":"#/components/schemas/OptionSpec"},"type":"array","maxItems":12,"title":"Options"},"qty_cap":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Qty Cap","default":1},"negotiable":{"anyOf":[{"type":"string","enum":["free","lever","auto"]},{"type":"null"}],"title":"Negotiable"}},"additionalProperties":false,"type":"object","required":["id","kind"],"title":"DimSpec"},"DisputeNegotiateRequest":{"properties":{"platform_first_offer":{"type":"number","minimum":0.0,"title":"Platform First Offer","description":"The platform's lowball opening offer"},"platform_walk_cost":{"type":"number","exclusiveMinimum":0.0,"title":"Platform Walk Cost","description":"The platform's walk-away cost — the most it will pay before a chargeback + continued handling cost it more"},"customer_floor":{"type":"number","minimum":0.0,"title":"Customer Floor","description":"The least the customer will accept before walking away"},"customer_target":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Customer Target","description":"The customer's happy point (carried through for display)"},"deadline_rounds":{"type":"integer","maximum":32.0,"minimum":4.0,"title":"Deadline Rounds","default":10}},"type":"object","required":["platform_first_offer","platform_walk_cost","customer_floor"],"title":"DisputeNegotiateRequest","description":"Inputs for a refund-dispute settlement negotiation. All dollar\namounts in USD."},"DomainChallengeRequest":{"properties":{"domain":{"type":"string","title":"Domain","description":"Bare hostname you control, e.g. acme.example"},"public_key_b64":{"type":"string","title":"Public Key B64"}},"type":"object","required":["domain","public_key_b64"],"title":"DomainChallengeRequest"},"FetchIn":{"properties":{"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"url":{"type":"string","maxLength":2048,"title":"Url","description":"http(s) URL to read → markdown"}},"type":"object","required":["url"],"title":"FetchIn"},"FormatRecRequest":{"properties":{"bidder_value_prior":{"$ref":"#/components/schemas/PriorParams"},"n_bidders":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"N Bidders"},"seller_valuation":{"type":"number","minimum":0.0,"title":"Seller Valuation"},"weights":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Weights"}},"type":"object","required":["bidder_value_prior","n_bidders","seller_valuation"],"title":"FormatRecRequest"},"FormatRecResponse":{"properties":{"recommended_format":{"type":"string","title":"Recommended Format"},"scores":{"additionalProperties":true,"type":"object","title":"Scores"},"expected_revenue_by_format":{"additionalProperties":true,"type":"object","title":"Expected Revenue By Format"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["recommended_format","scores","expected_revenue_by_format","rationale"],"title":"FormatRecResponse"},"GaleShapleyRequest":{"properties":{"proposers":{"items":{"$ref":"#/components/schemas/Proposer"},"type":"array","maxItems":1024,"minItems":1,"title":"Proposers"},"receivers":{"items":{"$ref":"#/components/schemas/Receiver"},"type":"array","maxItems":1024,"minItems":1,"title":"Receivers"}},"type":"object","required":["proposers","receivers"],"title":"GaleShapleyRequest"},"GaleShapleyResponse":{"properties":{"matching":{"additionalProperties":true,"type":"object","title":"Matching"},"unmatched_proposers":{"items":{"type":"string"},"type":"array","title":"Unmatched Proposers"},"blocking_pairs":{"items":{"items":{"type":"string"},"type":"array"},"type":"array","title":"Blocking Pairs"},"n_proposals":{"type":"integer","title":"N Proposals"}},"type":"object","required":["matching","unmatched_proposers","blocking_pairs","n_proposals"],"title":"GaleShapleyResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Intent":{"properties":{"sku":{"type":"string","title":"Sku"},"quantity":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Quantity","default":1},"substitutes_ok":{"type":"boolean","title":"Substitutes Ok","default":true},"buyer":{"anyOf":[{"$ref":"#/components/schemas/BuyerBlock"},{"type":"null"}]}},"type":"object","required":["sku"],"title":"Intent"},"IssueKeyRequest":{"properties":{"agent_id":{"type":"string","maxLength":128,"minLength":3,"title":"Agent Id","description":"Stable identifier for the calling agent"},"contact_email":{"type":"string","title":"Contact Email","description":"Contact email for issues / overage notifications"},"intended_use_summary":{"type":"string","maxLength":1024,"minLength":8,"title":"Intended Use Summary","description":"One-sentence description of the intended use case"},"telemetry_consent":{"type":"boolean","title":"Telemetry Consent","description":"Opt-in to contribute anonymized recommendation→outcome pairs to the prior corpus. Default False. Set at issuance and immutable afterwards (revocation = /v1/telemetry/delete + don't pass share_outcome=True). See /llms.txt for the privacy contract.","default":false}},"type":"object","required":["agent_id","contact_email","intended_use_summary"],"title":"IssueKeyRequest"},"IssueKeyResponse":{"properties":{"api_key":{"type":"string","title":"Api Key"},"tier":{"type":"string","title":"Tier"},"rate_limit_per_minute":{"type":"integer","title":"Rate Limit Per Minute","description":"Your per-key lane: 600/min — but ONLY when the key is sent as a header (Authorization: Bearer / X-API-Key). Keyless or body-only callers share the 60/min-per-IP free floor."},"created_at":{"type":"integer","title":"Created At"},"wallet":{"$ref":"#/components/schemas/WalletSummary","description":"The one prepaid wallet — starter + funded, in millicents"},"telemetry_consent":{"type":"boolean","title":"Telemetry Consent","description":"True if opted into telemetry at issuance"},"reused":{"type":"boolean","title":"Reused","description":"True if an existing key for this agent_id was returned"}},"type":"object","required":["api_key","tier","rate_limit_per_minute","created_at","wallet","telemetry_consent","reused"],"title":"IssueKeyResponse"},"MarketPrior":{"properties":{"mu":{"type":"number","title":"Mu","description":"Mean utility-to-buyer of typical seller openings, in [0, 1]"},"sigma":{"type":"number","exclusiveMinimum":0.0,"title":"Sigma","description":"Std of typical seller openings"}},"type":"object","required":["mu","sigma"],"title":"MarketPrior"},"MenuSpec":{"properties":{"name":{"type":"string","maxLength":120,"title":"Name","default":""},"dims":{"items":{"$ref":"#/components/schemas/DimSpec"},"type":"array","maxItems":8,"minItems":1,"title":"Dims"},"deps":{"$ref":"#/components/schemas/DepsSpec"},"cost":{"items":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"}]},"type":"array","maxItems":8,"title":"Cost"}},"additionalProperties":false,"type":"object","required":["dims"],"title":"MenuSpec","description":"core.api.build_graph's declarative spec, validated for hosting.\n\nDUAL-ACCEPT: a body carrying `items` is the FRIENDLY pasted menu (what\narena/web/yourmenu.js accepts) and is compiled to the raw `dims` spec via\nmenu_spec.friendly_to_dims before the hosting checks below run — so the\nhosted engine takes the exact JSON an agent reads off that page. A body\ncarrying `dims` is the native spec and passes through untouched."},"NegotiateBundleRequest":{"properties":{"issues":{"items":{"$ref":"#/components/schemas/BundleIssue"},"type":"array","title":"Issues","description":"The issues on the table (2+ for logrolling), each with your and their per-option values"},"their_offers":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Their Offers","description":"The other side's offers so far as {issue_name: option}, oldest first"},"my_priorities":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"My Priorities","description":"Optional {issue_name: weight} — how much each issue matters to you"},"my_batna":{"type":"number","maximum":1.0,"minimum":0.0,"title":"My Batna","default":0.4},"their_batna_estimate":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Their Batna Estimate","default":0.4},"rounds_left":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Rounds Left","description":"Optional bargaining rounds remaining. On the LAST round (<=1) a standing offer that clears your BATNA is accepted rather than countered into no-deal. Omit for timeless behavior."}},"type":"object","required":["issues"],"title":"NegotiateBundleRequest"},"NegotiateTurnRequest":{"properties":{"side":{"type":"string","enum":["sell","buy"],"title":"Side","description":"Which side you are"},"walk_away":{"type":"number","title":"Walk Away","description":"Your reservation in dollars: the WORST price you'd accept (seller=floor, buyer=ceiling)"},"target":{"type":"number","title":"Target","description":"Your aspiration in dollars (seller=high, buyer=low)"},"counterparty_offers":{"items":{"type":"number"},"type":"array","title":"Counterparty Offers","description":"The other side's offers so far, in dollars, oldest first"},"my_previous_offers":{"items":{"type":"number"},"type":"array","title":"My Previous Offers"},"rounds_left":{"type":"integer","minimum":1.0,"title":"Rounds Left","description":"Roughly how many more back-and-forths before it times out","default":8},"item":{"type":"string","title":"Item","description":"What's being traded (for the message)","default":"this"}},"type":"object","required":["side","walk_away","target"],"title":"NegotiateTurnRequest"},"NextOfferRequest":{"properties":{"session_id":{"type":"string","title":"Session Id","description":"From /v1/a2a/open_session"},"role":{"type":"string","enum":["seller","buyer"],"title":"Role"},"my_reservation":{"type":"number","maximum":1.0,"minimum":0.0,"title":"My Reservation","description":"Your reservation in NORMALIZED utility [0,1]"},"opponent_offer_history":{"items":{"type":"number"},"type":"array","maxItems":256,"title":"Opponent Offer History"},"my_offer_history":{"items":{"type":"number"},"type":"array","maxItems":256,"title":"My Offer History"},"deadline_rounds":{"type":"integer","maximum":1000.0,"minimum":1.0,"title":"Deadline Rounds","default":10},"pareto_knob":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Pareto Knob","default":0.5},"prior":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Prior","description":"WTP/market prior"}},"type":"object","required":["session_id","role","my_reservation"],"title":"NextOfferRequest"},"OpenSessionRequest":{"properties":{"negotiation_id":{"type":"string","title":"Negotiation Id","description":"Shared id both agents agree on (e.g. the A2A task id)"},"seller_proof":{"$ref":"#/components/schemas/PeerProof"},"buyer_proof":{"$ref":"#/components/schemas/PeerProof"},"require_level":{"type":"string","enum":["self","domain"],"title":"Require Level","description":"Minimum counterparty verification level for peer_mode","default":"self"}},"type":"object","required":["negotiation_id","seller_proof","buyer_proof"],"title":"OpenSessionRequest"},"OptimalAuctionDesignRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"bidder_priors":{"items":{"$ref":"#/components/schemas/PriorParams"},"type":"array","maxItems":50,"minItems":1,"title":"Bidder Priors"},"seller_valuation":{"type":"number","minimum":0.0,"title":"Seller Valuation"},"objective":{"type":"string","enum":["revenue","welfare"],"title":"Objective","default":"revenue"},"n_simulations":{"type":"integer","maximum":50000.0,"minimum":500.0,"title":"N Simulations","default":5000},"seed":{"type":"integer","title":"Seed","default":42}},"type":"object","required":["bidder_priors","seller_valuation"],"title":"OptimalAuctionDesignRequest"},"OptimalAuctionDesignResponse":{"properties":{"mechanism":{"type":"string","title":"Mechanism"},"reserve_prices":{"additionalProperties":true,"type":"object","title":"Reserve Prices"},"expected_revenue":{"type":"number","title":"Expected Revenue"},"expected_welfare":{"type":"number","title":"Expected Welfare"},"ironing_required":{"type":"boolean","title":"Ironing Required"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["mechanism","reserve_prices","expected_revenue","expected_welfare","ironing_required","rationale"],"title":"OptimalAuctionDesignResponse"},"OptimalBidRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"auction_format":{"type":"string","title":"Auction Format","description":"first_price | second_price_vickrey | english_ascending"},"my_valuation":{"type":"number","exclusiveMinimum":0.0,"title":"My Valuation"},"n_competing_bidders":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"N Competing Bidders"},"competitor_value_prior":{"$ref":"#/components/schemas/PriorParams"},"reserve_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reserve Price"},"risk_aversion":{"type":"number","maximum":1.0,"minimum":0.1,"title":"Risk Aversion","default":1.0}},"type":"object","required":["auction_format","my_valuation","n_competing_bidders","competitor_value_prior"],"title":"OptimalBidRequest"},"OptimalBidResponse":{"properties":{"optimal_bid":{"type":"number","title":"Optimal Bid"},"expected_surplus":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expected Surplus"},"win_probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Win Probability"},"dominant_strategy":{"type":"boolean","title":"Dominant Strategy"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["optimal_bid","expected_surplus","win_probability","dominant_strategy","rationale"],"title":"OptimalBidResponse"},"OptimalReserveRequest":{"properties":{"bidder_value_prior":{"$ref":"#/components/schemas/PriorParams"},"n_bidders":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"N Bidders"},"seller_valuation":{"type":"number","minimum":0.0,"title":"Seller Valuation"}},"type":"object","required":["bidder_value_prior","n_bidders","seller_valuation"],"title":"OptimalReserveRequest"},"OptimalReserveResponse":{"properties":{"reserve_price":{"type":"number","title":"Reserve Price"},"expected_revenue":{"type":"number","title":"Expected Revenue"},"expected_revenue_no_reserve":{"type":"number","title":"Expected Revenue No Reserve"},"expected_efficiency_loss":{"type":"number","title":"Expected Efficiency Loss"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["reserve_price","expected_revenue","expected_revenue_no_reserve","expected_efficiency_loss","rationale"],"title":"OptimalReserveResponse"},"OptionSpec":{"properties":{"id":{"type":"string","maxLength":64,"minLength":1,"title":"Id"},"label":{"type":"string","maxLength":120,"title":"Label","default":""},"price_delta":{"type":"number","maximum":1000000000.0,"minimum":0.0,"title":"Price Delta","description":"This option's contribution to the cart's LIST price","default":0.0},"unit_cost":{"type":"number","maximum":1000000000.0,"minimum":0.0,"title":"Unit Cost","default":0.0},"salvage":{"type":"number","maximum":1000000000.0,"minimum":0.0,"title":"Salvage","default":0.0},"perishable":{"type":"boolean","title":"Perishable","default":false},"stock_limited":{"type":"boolean","title":"Stock Limited","default":false},"immediate":{"type":"boolean","title":"Immediate","default":true},"slot_ticks":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Slot Ticks","default":0}},"additionalProperties":false,"type":"object","required":["id"],"title":"OptionSpec"},"ParkIn":{"properties":{"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"blob_b64":{"type":"string","title":"Blob B64","description":"your ciphertext as base64 — ENCRYPT BEFORE PARKING; the store holds only opaque bytes and cannot read them"},"ttl_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Seconds","description":"requested lifetime; clamped to [60s, 7d]. The effective expires_at is returned — never a silent surprise."}},"type":"object","required":["blob_b64"],"title":"ParkIn"},"PeerProof":{"properties":{"operator_attestation_jwt":{"type":"string","title":"Operator Attestation Jwt"},"sig_b64":{"type":"string","title":"Sig B64"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"expires_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["operator_attestation_jwt","sig_b64"],"title":"PeerProof"},"PilotIn":{"properties":{"name":{"type":"string","maxLength":120,"title":"Name"},"business":{"type":"string","maxLength":200,"title":"Business"},"email":{"type":"string","maxLength":200,"title":"Email"},"sells":{"type":"string","maxLength":500,"title":"Sells","description":"What you sell and where buyers negotiate with you.","default":""},"note":{"type":"string","maxLength":2000,"title":"Note","default":""}},"type":"object","required":["name","business","email"],"title":"PilotIn"},"PostedPriceRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"buyer_arrival_prior":{"$ref":"#/components/schemas/PriorParams"},"arrival_rate_per_second":{"type":"number","maximum":100.0,"exclusiveMinimum":0.0,"title":"Arrival Rate Per Second"},"inventory":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Inventory"},"horizon_seconds":{"type":"number","maximum":604800.0,"exclusiveMinimum":0.0,"title":"Horizon Seconds"},"n_simulations":{"type":"integer","maximum":20000.0,"minimum":100.0,"title":"N Simulations","default":2000},"seed":{"type":"integer","title":"Seed","default":42}},"type":"object","required":["buyer_arrival_prior","arrival_rate_per_second","inventory","horizon_seconds"],"title":"PostedPriceRequest"},"PostedPriceResponse":{"properties":{"static_price":{"type":"number","title":"Static Price"},"static_expected_revenue":{"type":"number","title":"Static Expected Revenue"},"static_simulated_revenue":{"type":"number","title":"Static Simulated Revenue"},"dynamic_schedule":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Dynamic Schedule"},"dynamic_value_estimate":{"type":"number","title":"Dynamic Value Estimate"},"sellthrough_rate":{"type":"number","title":"Sellthrough Rate"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["static_price","static_expected_revenue","static_simulated_revenue","dynamic_schedule","dynamic_value_estimate","sellthrough_rate","rationale"],"title":"PostedPriceResponse"},"PracticeIn":{"properties":{"policy":{"additionalProperties":true,"type":"object","title":"Policy"},"history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"History","description":"[{role: customer|seller, shown: text}, ...]"},"style":{"type":"string","title":"Style","default":"persistent"},"budget":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget"}},"type":"object","required":["policy"],"title":"PracticeIn"},"PriorParams":{"properties":{"family":{"type":"string","title":"Family","description":"lognorm | uniform"},"params":{"additionalProperties":true,"type":"object","title":"Params"}},"type":"object","required":["family","params"],"title":"PriorParams"},"ProfileRequest":{"properties":{"spec":{"$ref":"#/components/schemas/MenuSpec"},"state":{"anyOf":[{"$ref":"#/components/schemas/StateSpec"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["spec"],"title":"ProfileRequest"},"Proposer":{"properties":{"id":{"type":"string","maxLength":128,"minLength":1,"title":"Id"},"preferences":{"items":{"type":"string"},"type":"array","maxItems":1024,"title":"Preferences","description":"Receiver ids ranked most-preferred first"}},"type":"object","required":["id"],"title":"Proposer"},"QuoteOptsSpec":{"properties":{"quote_lookers":{"type":"boolean","title":"Quote Lookers","description":"False = refuse buyers who'd never pay list (IC floor)","default":true},"min_price_frac":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Min Price Frac","description":"never quote below this fraction of list","default":0.0},"qty_appetite":{"type":"boolean","title":"Qty Appetite","description":"don't upsell a unit the buyer values below its cost","default":false},"seller_weight":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Seller Weight","description":"0.5 = symmetric Nash; →1 tilts surplus to the seller","default":0.5}},"additionalProperties":false,"type":"object","title":"QuoteOptsSpec","description":"The hosted subset of core/engine.QuoteOpts."},"QuoteReq":{"properties":{"protocol":{"type":"string","title":"Protocol","default":"snhp-price/1"},"machine_id":{"type":"string","title":"Machine Id","default":"demo-01"},"intent":{"$ref":"#/components/schemas/Intent"}},"type":"object","required":["intent"],"title":"QuoteReq"},"QuoteRequest":{"properties":{"spec":{"$ref":"#/components/schemas/MenuSpec"},"state":{"anyOf":[{"$ref":"#/components/schemas/StateSpec"},{"type":"null"}]},"buyer":{"$ref":"#/components/schemas/BuyerSpec"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"pin dims: dim_id -> option id | [option ids] (addon) | int (quantity). Omit to search every valid cart."},"opts":{"$ref":"#/components/schemas/QuoteOptsSpec"}},"additionalProperties":false,"type":"object","required":["spec","buyer"],"title":"QuoteRequest"},"Receiver":{"properties":{"id":{"type":"string","maxLength":128,"minLength":1,"title":"Id"},"preferences":{"items":{"type":"string"},"type":"array","maxItems":1024,"title":"Preferences","description":"Proposer ids ranked most-preferred first"},"capacity":{"type":"integer","maximum":1024.0,"minimum":1.0,"title":"Capacity","default":1}},"type":"object","required":["id"],"title":"Receiver"},"RegisterOperatorRequest":{"properties":{"operator_id":{"type":"string","title":"Operator Id","description":"Stable operator identity (e.g. a domain or org id)"},"public_key_b64":{"type":"string","title":"Public Key B64","description":"Base64 of the 32-byte Ed25519 operator public key"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["operator_id","public_key_b64"],"title":"RegisterOperatorRequest"},"ReplyIn":{"properties":{"policy":{"additionalProperties":true,"type":"object","title":"Policy","description":"The policy from /v1/policy/compile or /v1/policy/check (or a template)."},"message":{"type":"string","title":"Message","description":"The buyer's latest message, as they wrote it."},"state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"State","description":"The `state` returned by the previous reply; omit to start."},"engine":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engine","description":"The engine that decides offers; default: the policy's own `engine` (templates set their tested default), else bundle3."},"flags":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Flags","description":"What YOUR records confirm about this buyer, e.g. {\"new_customer\": true}. Never what the buyer claims."},"stock":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Stock","description":"Current stock records for what your policy's `inventory` binds, sent with every message: schema.org Offer (availability, inventoryLevel), Google Merchant (id, availability) or a plain feed record (id or vin, status). Nothing out of stock is offered or signed."}},"type":"object","required":["policy","message"],"title":"ReplyIn"},"ReportOutcomeRequest":{"properties":{"recommendation_id":{"type":"string","maxLength":128,"minLength":1,"title":"Recommendation Id","description":"The X-GT-Recommendation-Id returned when share_outcome=True"},"deal_closed":{"type":"boolean","title":"Deal Closed","description":"True if a deal was reached"},"my_utility":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"My Utility","description":"Realized utility-to-self in [0, 1] (quantized at write)"},"opponent_utility":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Opponent Utility","description":"Realized utility-to-opponent if known, in [0, 1]"}},"type":"object","required":["recommendation_id","deal_closed"],"title":"ReportOutcomeRequest"},"ReportOutcomeResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted","description":"False if the recommendation_id doesn't exist, doesn't belong to this key, is in a different ISO week (too late), or has already been reported. Idempotent re-report = no-op."}},"type":"object","required":["accepted"],"title":"ReportOutcomeResponse"},"RequestIn":{"properties":{"text":{"type":"string","maxLength":4000,"title":"Text","description":"what you wish the machine stocked"},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"watch":{"type":"boolean","title":"Watch","description":"with an api_key, flag this ask to hear back on a status flip — poll GET /v1/store/my_requests; no email/webhook","default":false}},"type":"object","required":["text"],"title":"RequestIn"},"RevealFirstStrikeRequest":{"properties":{"commitment_id":{"type":"string","title":"Commitment Id"},"reservation":{"type":"number","title":"Reservation"},"nonce":{"type":"string","minLength":1,"title":"Nonce"},"salt":{"type":"string","minLength":1,"title":"Salt"}},"type":"object","required":["commitment_id","reservation","nonce","salt"],"title":"RevealFirstStrikeRequest"},"RevealFirstStrikeResponse":{"properties":{"verified":{"type":"boolean","title":"Verified"},"binding_offer":{"type":"number","title":"Binding Offer"},"buyer_id":{"type":"string","title":"Buyer Id"},"seller_id":{"type":"string","title":"Seller Id"},"revealed_at_unix":{"type":"integer","title":"Revealed At Unix"},"reused":{"type":"boolean","title":"Reused"}},"type":"object","required":["verified","binding_offer","buyer_id","seller_id","revealed_at_unix","reused"],"title":"RevealFirstStrikeResponse"},"RotateIn":{"properties":{"api_key":{"type":"string","title":"Api Key"}},"type":"object","required":["api_key"],"title":"RotateIn"},"SellNextOfferRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"my_reservation":{"type":"number","maximum":1.0,"minimum":0.0,"title":"My Reservation","description":"Our walk-away utility, normalized to [0, 1]"},"opponent_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"title":"Opponent Offer History","description":"Opponent's offers evaluated in our utility space, in [0, 1]"},"my_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"title":"My Offer History"},"deadline_rounds":{"type":"integer","maximum":64.0,"minimum":1.0,"title":"Deadline Rounds","description":"Total rounds before the negotiation times out"},"pareto_knob":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Pareto Knob","description":"0=max deal rate, 1=max H2H margin (only used when peer_mode=False)","default":0.5},"buyer_wtp_prior":{"anyOf":[{"$ref":"#/components/schemas/WTPPrior"},{"type":"null"}]},"peer_mode":{"type":"boolean","title":"Peer Mode","description":"Set True when counterparty is a verified SNHP-protocol peer (cryptographic attestation). Activates cooperative architecture (PEER playbook + max-self signaling). Empirically reaches 96-101% of Pareto frontier vs 89-92% for vanilla descent. See /llms.txt.","default":false}},"type":"object","required":["my_reservation","deadline_rounds"],"title":"SellNextOfferRequest"},"SellNextOfferResponse":{"properties":{"recommended_offer":{"type":"number","title":"Recommended Offer"},"acceptance_probability":{"type":"number","title":"Acceptance Probability"},"expected_payoff":{"type":"number","title":"Expected Payoff"},"rationale":{"type":"string","title":"Rationale"},"posterior":{"additionalProperties":true,"type":"object","title":"Posterior"},"rubinstein_share":{"type":"number","title":"Rubinstein Share"},"schelling_floor":{"type":"number","title":"Schelling Floor"}},"type":"object","required":["recommended_offer","acceptance_probability","expected_payoff","rationale","posterior","rubinstein_share","schelling_floor"],"title":"SellNextOfferResponse"},"SessionCloseIn":{"properties":{"api_key":{"type":"string","title":"Api Key"},"session_id":{"type":"string","title":"Session Id"}},"type":"object","required":["api_key","session_id"],"title":"SessionCloseIn"},"SessionMoveIn":{"properties":{"api_key":{"type":"string","title":"Api Key"},"session_id":{"type":"string","title":"Session Id"},"their_offers":{"items":{"type":"number"},"type":"array","title":"Their Offers"},"my_offers":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"My Offers"},"rounds_left":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Rounds Left"}},"type":"object","required":["api_key","session_id","their_offers"],"title":"SessionMoveIn"},"SessionOpenIn":{"properties":{"api_key":{"type":"string","title":"Api Key"},"category":{"type":"string","title":"Category","description":"resale | supply | retail"},"side":{"type":"string","title":"Side","description":"buy | sell"},"walk_away":{"type":"number","exclusiveMinimum":0.0,"title":"Walk Away","description":"your floor (sell) / ceiling (buy)"},"target":{"type":"number","exclusiveMinimum":0.0,"title":"Target","description":"your aspiration"},"their_offers":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Their Offers"},"my_offers":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"My Offers"},"rounds_left":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Rounds Left"},"seed":{"type":"integer","title":"Seed","default":0}},"type":"object","required":["api_key","category","side","walk_away","target"],"title":"SessionOpenIn"},"SettleRequest":{"properties":{"session_id":{"type":"string","title":"Session Id"},"agreed_price":{"type":"number","title":"Agreed Price"},"currency":{"type":"string","title":"Currency","default":"USD"},"item":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item"},"buyer_max_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Buyer Max Price","description":"If set, also emit the buyer's Intent Mandate"},"terms":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Terms"}},"type":"object","required":["session_id","agreed_price"],"title":"SettleRequest"},"SimulateRequest":{"properties":{"auction_format":{"type":"string","title":"Auction Format"},"bidder_priors":{"items":{"$ref":"#/components/schemas/PriorParams"},"type":"array","title":"Bidder Priors"},"reserve_price":{"type":"number","minimum":0.0,"title":"Reserve Price"},"n_simulations":{"type":"integer","maximum":100000.0,"minimum":100.0,"title":"N Simulations","default":10000},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"}},"type":"object","required":["auction_format","bidder_priors","reserve_price"],"title":"SimulateRequest"},"SimulateResponse":{"properties":{"mean_revenue":{"type":"number","title":"Mean Revenue"},"ci_95":{"items":{"type":"number"},"type":"array","title":"Ci 95"},"efficiency":{"type":"number","title":"Efficiency"},"winner_index_distribution":{"items":{"type":"number"},"type":"array","title":"Winner Index Distribution"},"n_simulations":{"type":"integer","title":"N Simulations"}},"type":"object","required":["mean_revenue","ci_95","efficiency","winner_index_distribution","n_simulations"],"title":"SimulateResponse"},"StateSpec":{"properties":{"tick":{"type":"integer","minimum":0.0,"title":"Tick","default":0},"inventory":{"additionalProperties":{"type":"number"},"type":"object","title":"Inventory","description":"option_id -> units on hand (finite stock)"},"capacity":{"additionalProperties":{"type":"number"},"type":"object","title":"Capacity","description":"slot_ticks -> units a deferred slot can still absorb"},"expiring":{"items":{"type":"string"},"type":"array","maxItems":128,"title":"Expiring","description":"option ids currently priced at salvage (batch expiring)"},"expected_demand":{"additionalProperties":{"type":"number"},"type":"object","title":"Expected Demand","description":"option_id -> expected rest-of-horizon list-price demand"}},"additionalProperties":false,"type":"object","title":"StateSpec","description":"The shop moment the cost model reads (core/state.ShopState). All\nfields optional — an omitted state is a neutral shop (no inventory\nsignals, nothing expiring, unconstrained capacity)."},"StoreRequestIn":{"properties":{"text":{"type":"string","maxLength":4000,"title":"Text","description":"what you wish the counter stocked"},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"watch":{"type":"boolean","title":"Watch","description":"with an api_key, flag this ask to hear back on a status flip — poll GET /v1/store/my_requests; no email/webhook","default":false}},"type":"object","required":["text"],"title":"StoreRequestIn"},"TelemetryDeleteResponse":{"properties":{"rows_deleted":{"type":"integer","title":"Rows Deleted"}},"type":"object","required":["rows_deleted"],"title":"TelemetryDeleteResponse"},"TelemetryExportResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/TelemetryRecordOut"},"type":"array","title":"Rows"}},"type":"object","required":["rows"],"title":"TelemetryExportResponse"},"TelemetryRecordOut":{"properties":{"recommendation_id":{"type":"string","title":"Recommendation Id"},"vertical":{"type":"string","title":"Vertical"},"endpoint":{"type":"string","title":"Endpoint"},"request_features":{"additionalProperties":true,"type":"object","title":"Request Features"},"recommendation":{"additionalProperties":true,"type":"object","title":"Recommendation"},"created_at_hour":{"type":"integer","title":"Created At Hour"},"outcome":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Outcome"}},"type":"object","required":["recommendation_id","vertical","endpoint","request_features","recommendation","created_at_hour","outcome"],"title":"TelemetryRecordOut"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyDomainRequest":{"properties":{"domain":{"type":"string","title":"Domain"},"public_key_b64":{"type":"string","title":"Public Key B64"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["domain","public_key_b64"],"title":"VerifyDomainRequest"},"VerifyIn":{"properties":{"receipt":{"additionalProperties":true,"type":"object","title":"Receipt"},"policy":{"additionalProperties":true,"type":"object","title":"Policy"},"flags":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Flags"}},"type":"object","required":["receipt","policy"],"title":"VerifyIn"},"WTPPrior":{"properties":{"mu":{"type":"number","title":"Mu","description":"Lognormal μ of buyer WTP"},"sigma":{"type":"number","title":"Sigma","description":"Lognormal σ of buyer WTP"}},"type":"object","required":["mu","sigma"],"title":"WTPPrior"},"WalletSummary":{"properties":{"starter_millicents":{"type":"integer","title":"Starter Millicents","description":"The one-time 50¢ starter grant (millicents, 1000/cent)"},"funded_millicents":{"type":"integer","title":"Funded Millicents","description":"Own-money top-ups, in millicents"},"total_millicents":{"type":"integer","title":"Total Millicents","description":"Spendable total across both buckets"}},"type":"object","required":["starter_millicents","funded_millicents","total_millicents"],"title":"WalletSummary"},"_HelperAskRequest":{"properties":{"text":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Text","description":"What's going on, in your own words. Optional."},"situation_key":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Situation Key","description":"Skip classification and name the situation."},"values":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Values","description":"Fields the person has confirmed or corrected. These always beat anything read from their text. At most 40 entries."},"no_telemetry":{"type":"boolean","title":"No Telemetry","description":"Opt out of the anonymous record for this request. Honoured before anything is built, not before it is written.","default":false}},"type":"object","title":"_HelperAskRequest"},"_HelperOutcomeRequest":{"properties":{"receipt":{"type":"string","maxLength":64,"title":"Receipt","description":"The token returned with an answer."},"outcome":{"type":"string","maxLength":32,"title":"Outcome","description":"What the landlord actually did."},"amount":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Amount","description":"Roughly how much, if money changed hands. Stored as a band."}},"type":"object","required":["receipt","outcome"],"title":"_HelperOutcomeRequest"},"_RentCheckRequest":{"properties":{"metro":{"type":"string","title":"Metro","description":"Metro key, e.g. 'denver'. Unknown metros degrade to national context."},"current_rent":{"type":"integer","maximum":100000.0,"exclusiveMinimum":0.0,"title":"Current Rent","description":"Current monthly rent, USD."},"offered_rent":{"type":"integer","maximum":100000.0,"exclusiveMinimum":0.0,"title":"Offered Rent","description":"Renewal offer, USD/month."},"months_at_address":{"type":"integer","maximum":1200.0,"minimum":0.0,"title":"Months At Address","description":"How long you've lived there."}},"type":"object","required":["metro","current_rent","offered_rent","months_at_address"],"title":"_RentCheckRequest"}}},"tags":[{"name":"negotiation","description":"Tier 1: multi-round bargaining"},{"name":"auctions","description":"Tier 2: single-unit auctions"},{"name":"mechanism","description":"Tier 3: marketplace operator primitives"},{"name":"offer","description":"General offer-graph engine: compile / profile / quote a JSON menu spec (discount-only, never above list)"},{"name":"discovery","description":"Catalog + agent onboarding"},{"name":"telemetry","description":"Opt-in data sharing + GDPR (export/delete)"}]}