{ "openapi": "3.1.0", "info": { "title": "Lumen House public catalog", "version": "1.1.0", "description": "Read-only catalog and individually quoted human assistance, plus one exact Base-USDC x402 digital-ware purchase and private download route and a separate USD 1.00 Stripe MPP card route. A signed request requires a saved private X-Lumen-Recovery-Key. Email inquiries do not book work. Check the offer for checkout readiness before signing or issuing a card token. Personal support information describes a separate optional gift to Ben, with no Lumen House payment API. A separate deterministic Interface Consistency Check paid API has published documentation and uses exact programmatic payments for one prepared report. Public catalog documents and published metadata checked by unsigned GET. Published payment flags describe enabled configuration; settlement, private downloads and paid report fulfillment were not tested in this check. Historical observation dates remain unchanged. Email delivery, support receipts and Stars issuance were not tested. The public guestbook exposes approved-note reads and optional consented submissions for review; the receipt does not report current publication status.", "contact": { "name": "Ben", "url": "https://lumenhouse.xyz/contact/", "email": "buscheo@gmail.com" }, "termsOfService": "https://lumenhouse.xyz/terms/" }, "servers": [ { "url": "https://lumenhouse.xyz" } ], "tags": [ { "name": "Catalog", "description": "Published static catalog snapshots." }, { "name": "Marketplace", "description": "Dated references to existing external marketplace pages." }, { "name": "Services", "description": "Human assistance proposed by email and accepted only by individual agreement." }, { "name": "Collectibles", "description": "Supporting token evidence; current ownership and availability require verification." }, { "name": "Wares", "description": "Versioned digital-ware offer, exact x402 or Stripe MPP card payment and private paid download." }, { "name": "Support", "description": "Voluntary personal support information; hosted checkout and separately enabled manual crypto addresses." }, { "name": "Paid interface check", "description": "Product-specific private prepared reports; private deterministic paid task API." }, { "name": "Guestbook", "description": "Optional public approved-note read and consented note submission. No account, wallet, payment or public receipt-status lookup." } ], "paths": { "/catalog.json": { "get": { "operationId": "readCatalog", "tags": [ "Catalog" ], "summary": "Read the public Lumen House catalog", "description": "Returns published digital wares, paid-tool and free-keepsake metadata, individually quoted human assistance and NFT marketplace discovery references. NFT prices and quantity evidence retain their October 6 observation dates. Separate source_page_checked_at fields record page reachability and identity only; current executable orders and holdings remain unverified. last_checked refers to the scoped public metadata check explained in the existing freshness and verification notes in llms.txt. Published payment flags do not prove settlement or fulfillment. This GET performs no booking, payment or wallet action.", "responses": { "200": { "description": "Public catalog snapshot with quote-required service information.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "additionalProperties": false, "required": [ "schema_version", "mode", "name", "last_checked", "inventory_status", "inventory_notice", "inventory_evidence", "services", "collectibles", "offers", "live_inquiries", "live_payments" ], "properties": { "schema_version": { "const": "1.0" }, "mode": { "const": "public_catalog" }, "name": { "type": "string" }, "last_checked": { "type": "string", "description": "Time of the latest public-metadata check. Read the freshness and verification notes in llms.txt; nested historical observations retain their own dates." }, "marketplace_listings": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "name", "url", "source_url", "price", "currency", "observed_at", "requires_live_recheck", "order_verified" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "marketplace": { "type": "string" }, "chain": { "type": "string" }, "kind": { "type": "string" }, "source_url": { "type": "string" }, "profile_url": { "type": "string" }, "price": { "type": "string" }, "currency": { "type": "string" }, "price_basis": { "type": "string" }, "extra_costs": { "type": "string" }, "quantity_evidence": { "type": "string" }, "expiry_evidence": { "type": "string" }, "observed_at": { "type": "string" }, "evidence": { "type": "string" }, "status": { "type": "string" }, "action": { "type": "string" }, "token_id": { "type": [ "string", "null" ] }, "contract": { "type": [ "string", "null" ] }, "inventory_id": { "type": [ "string", "null" ] }, "type": { "const": "marketplace_reference" }, "requires_live_recheck": { "const": true }, "order_verified": { "const": false }, "source_page_checked_at": { "type": "string" }, "source_page_check_scope": { "type": "string" } } } }, "inventory_status": { "type": "string" }, "inventory_notice": { "type": "string" }, "inventory_evidence": { "type": "object", "required": [ "snapshot_date", "source_filename", "source_sha256", "reported_totals", "reported_totals_evidence", "sources", "notes" ], "properties": { "snapshot_date": { "type": "string" }, "source_filename": { "type": "string" }, "source_sha256": { "type": [ "string", "null" ] }, "reported_totals": { "type": "object", "properties": { "tezos_token_ids": { "type": "integer" }, "tezos_editions": { "type": "integer" }, "domain_nfts": { "type": "integer" }, "provisional_items": { "type": "integer" } } }, "reported_totals_evidence": { "type": "string" }, "sources": { "type": "array", "items": { "type": "object", "required": [ "name", "url", "status", "last_checked" ], "properties": { "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "status": { "type": "string" }, "last_checked": { "type": "string" } } } }, "notes": { "type": "array", "items": { "type": "string" } } } }, "services": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "url", "name", "description", "scope", "status", "inquiry_channel", "inquiry_email", "inquiry_url", "payment_status", "payment_network", "payment_chain_id", "payment_address", "payment_asset", "payment_address_evidence", "payment_instructions", "availability", "quoting", "cancellation", "limitations", "last_checked" ], "properties": { "id": { "type": "string" }, "type": { "const": "service" }, "url": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "scope": { "type": "string" }, "status": { "type": "string" }, "inquiry_channel": { "type": "string" }, "inquiry_email": { "type": "string" }, "inquiry_url": { "type": "string" }, "payment_status": { "type": "string" }, "payment_network": { "type": "string" }, "payment_chain_id": { "type": "string" }, "payment_address": { "type": "string" }, "payment_asset": { "type": "string" }, "payment_address_evidence": { "type": "string" }, "payment_instructions": { "type": "string" }, "availability": { "type": "string" }, "quoting": { "type": "string" }, "cancellation": { "type": "string" }, "limitations": { "type": "string" }, "last_checked": { "type": "string" } } } }, "collectibles": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "url", "name", "description", "chain", "contract", "token_id", "quantity", "ownership_status", "ownership_source", "verified_at", "freshness", "caveats", "creator", "rights", "media", "marketplace", "availability_status", "sale_status", "last_checked" ], "properties": { "id": { "type": "string" }, "type": { "const": "collectible" }, "url": { "type": "string", "format": "uri" }, "name": { "type": "string" }, "description": { "type": "string" }, "chain": { "enum": [ "tezos", "ethereum", "polygon", "base" ] }, "contract": { "type": "string" }, "token_id": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "quantity_status": { "type": [ "string", "null" ] }, "quantity_basis": { "type": [ "string", "null" ] }, "source_ownership_status": { "type": [ "string", "null" ] }, "source_checked_at": { "type": [ "string", "null" ] }, "token_source": { "type": [ "string", "null" ] }, "creator_relationship": { "type": [ "string", "null" ] }, "provenance": { "type": [ "string", "null" ] }, "artifact_uri": { "type": [ "string", "null" ] }, "display_uri": { "type": [ "string", "null" ] }, "thumbnail_uri": { "type": [ "string", "null" ] }, "standard": { "type": [ "string", "null" ] }, "rights_metadata": { "type": [ "string", "null" ] }, "last_balance_update_time": { "type": [ "string", "null" ] }, "indexed_total_supply_raw": { "type": [ "string", "null" ] }, "spam_status": { "type": [ "string", "null" ] }, "quantity": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "ownership_status": { "enum": [ "verified", "inferred", "unverified" ] }, "ownership_source": { "type": "string" }, "verified_at": { "type": [ "string", "null" ] }, "freshness": { "enum": [ "stale_or_unverified", "snapshot_only" ] }, "caveats": { "type": "array", "items": { "type": "string" } }, "creator": { "type": "string" }, "rights": { "type": "string" }, "media": { "type": [ "string", "null" ] }, "marketplace": { "anyOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "url", "checked_at", "status" ], "properties": { "url": { "type": "string", "format": "uri" }, "checked_at": { "type": "string" }, "status": { "const": "verified_reference_not_live_order" } } } ] }, "availability_status": { "enum": [ "sold", "unavailable", "unknown" ] }, "sale_status": { "enum": [ "not_offered", "external_listing_observed" ] }, "last_checked": { "type": [ "string", "null" ] } } } }, "offers": { "type": "array", "items": { "oneOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen House digital ware offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "checkout_enabled", "price", "artifact", "license", "requirements", "purchase", "download", "terms", "documentation", "privacy", "claim_limit" ], "properties": { "schema_version": { "const": "lumen-house-ware-offer/1" }, "type": { "const": "digital_ware" }, "id": { "const": "agent-delivery-manifest-kit-v1" }, "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "version": { "const": "1.0.0" }, "description": { "type": "string" }, "status": { "enum": [ "available", "checkout_unavailable" ] }, "checkout_enabled": { "type": "boolean" }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "atomic_amount", "recipient", "basis", "recurring", "network", "asset" ], "properties": { "amount": { "const": "0.10" }, "currency": { "const": "USDC" }, "atomic_amount": { "const": "100000" }, "recipient": { "enum": [ "0xfDfaDd01eDcBaBE025931e45cdc8532B00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "basis": { "const": "one_time_download" }, "recurring": { "const": false }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "version", "filename", "sha256", "size_bytes" ], "properties": { "version": { "const": "1.0.0" }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 4 } } }, "license": { "type": "object", "additionalProperties": false, "required": [ "spdx_identifier", "url", "commercial_use", "notice_required" ], "properties": { "spdx_identifier": { "const": "MIT" }, "url": { "type": "string", "format": "uri" }, "commercial_use": { "const": true }, "notice_required": { "const": true } } }, "requirements": { "type": "object", "additionalProperties": false, "required": [ "runtime_source_compatibility", "tested_runtime", "tested_platform", "node_22_directly_tested", "dependencies", "network_required" ], "properties": { "runtime_source_compatibility": { "type": "string" }, "tested_runtime": { "type": "string" }, "tested_platform": { "type": "string" }, "node_22_directly_tested": { "const": false }, "dependencies": { "type": "array", "maxItems": 0 }, "network_required": { "const": false } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_on_signed_request", "browser_signing_or_payment" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "x402/2" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_on_signed_request": { "const": true }, "browser_signing_or_payment": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "recovery_minimum_days", "locator_url", "locator_authorization", "private_recovery_key_required", "public_transaction_or_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "recovery_minimum_days": { "const": 30 }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "private_recovery_key_required": { "const": true }, "public_transaction_or_payment_proof_alone_sufficient": { "const": false } } }, "terms": { "type": "object", "additionalProperties": false, "required": [ "url", "support_email", "support_request_window_days", "refund_request_window_days", "request_window_starts", "refund_review", "automatic_refunds", "failed_delivery_replacement_window_days", "replacement_without_additional_payment", "indefinite_hosting_promised" ], "properties": { "url": { "type": "string", "format": "uri" }, "support_email": { "const": "buscheo@gmail.com" }, "support_request_window_days": { "const": 7 }, "refund_request_window_days": { "const": 7 }, "request_window_starts": { "const": "confirmed_purchase" }, "refund_review": { "const": "manual" }, "automatic_refunds": { "const": false }, "failed_delivery_replacement_window_days": { "const": 30 }, "replacement_without_additional_payment": { "const": true }, "indefinite_hosting_promised": { "const": false } } }, "documentation": { "type": "object", "additionalProperties": false, "required": [ "readme", "json", "markdown", "agent_guide", "example_manifest", "example_message", "example_json" ], "properties": { "readme": { "type": "string", "format": "uri" }, "json": { "type": "string", "format": "uri" }, "markdown": { "type": "string", "format": "uri" }, "agent_guide": { "type": "string", "format": "uri" }, "example_manifest": { "type": "string", "format": "uri" }, "example_message": { "type": "string", "format": "uri" }, "example_json": { "type": "string", "format": "uri" } } }, "privacy": { "type": "object", "additionalProperties": false, "required": [ "customer_files_stay_local", "recovery_key_must_remain_private", "never_email_recovery_key" ], "properties": { "customer_files_stay_local": { "const": true }, "recovery_key_must_remain_private": { "const": true }, "never_email_recovery_key": { "const": true } } }, "claim_limit": { "type": "string" }, "stripe_card": { "type": "object", "additionalProperties": false, "required": [ "status", "checkout_enabled", "price", "merchant", "purchase", "download" ], "properties": { "status": { "const": "available" }, "checkout_enabled": { "const": true }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "minor_amount", "basis", "recurring" ], "properties": { "amount": { "const": "1.00" }, "currency": { "const": "USD" }, "minor_amount": { "const": 100 }, "basis": { "const": "one_time_download" }, "recurring": { "const": false } } }, "merchant": { "type": "object", "additionalProperties": false, "required": [ "name", "profile_url", "network_id", "mode" ], "properties": { "name": { "const": "Lumen House" }, "profile_url": { "const": "https://stripe.com/@lumenhouse" }, "network_id": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" }, "mode": { "const": "live" } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "payment_method", "intent", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_before_quote", "credential_authorization_scheme", "stripe_issued_shared_payment_token_required", "browser_checkout" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "MPP" }, "payment_method": { "const": "stripe" }, "intent": { "const": "charge" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_before_quote": { "const": true }, "credential_authorization_scheme": { "const": "Payment" }, "stripe_issued_shared_payment_token_required": { "const": true }, "browser_checkout": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "locator_url", "locator_authorization", "recovery_minimum_days", "private_recovery_key_required", "public_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "recovery_minimum_days": { "const": 30 }, "private_recovery_key_required": { "const": true }, "public_payment_proof_alone_sufficient": { "const": false } } } } } } }, { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Paid Interface Consistency Check offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "version", "url", "intended_customers", "description", "status", "checkout_enabled", "execution_enabled", "approval_requirement", "prices", "price", "stripe_card", "price_basis", "recurring", "purchase", "fulfillment", "recovery", "privacy", "limits", "documentation", "discovery", "claim_limit" ], "properties": { "schema_version": { "const": "lumen-interface-check-paid-offer/1" }, "type": { "const": "paid_task_api" }, "id": { "const": "interface-consistency-check-v1" }, "name": { "const": "Interface Consistency Check v1" }, "version": { "const": "1.0.0" }, "url": { "const": "https://lumenhouse.xyz/tools/interface-consistency-check/" }, "intended_customers": { "const": "AI agents" }, "description": { "const": "Compare supplied llms.txt contents, OpenAPI JSON and offer metadata; receive a private deterministic JSON report with findings and suggested corrections." }, "status": { "const": "available" }, "checkout_enabled": { "const": true }, "execution_enabled": { "const": true }, "approval_requirement": { "const": "Exact owner approval is required before deploying an enabled launch package." }, "prices": { "const": [ { "method": "stripe", "protocol": "Stripe MPP", "amount": "1.00", "currency": "USD", "minor_amount": 100 }, { "method": "x402", "protocol": "x402 v2", "amount": "0.10", "currency": "USDC", "atomic_amount": "100000", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } ] }, "price": { "const": { "amount": "0.10", "currency": "USDC", "atomic_amount": "100000", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "basis": "one_submitted_document_snapshot", "recurring": false } }, "stripe_card": { "const": { "status": "available", "checkout_enabled": true, "price": { "amount": "1.00", "currency": "USD", "minor_amount": 100, "basis": "one_submitted_document_snapshot", "recurring": false }, "purchase": { "method": "POST", "url": "https://lumenhouse.xyz/api/interface-check/orders", "payment_method": "stripe" } } }, "price_basis": { "const": "one_submitted_document_snapshot" }, "recurring": { "const": false }, "purchase": { "const": { "method": "POST", "url": "https://lumenhouse.xyz/api/interface-check/orders", "content_type": "application/json", "recovery_header": "X-Lumen-Recovery-Key", "recovery_format": "64 lowercase hex", "input_schema": "https://lumenhouse.xyz/schemas/interface-check-prepare.json" } }, "fulfillment": { "const": { "method": "GET", "url_template": "https://lumenhouse.xyz/api/interface-check/orders/{order_id}/report", "requires_bearer": true, "content_type": "application/json", "result_schema": "https://lumenhouse.xyz/schemas/interface-check-result.json", "saved_bytes": true } }, "recovery": { "const": { "method": "GET", "url": "https://lumenhouse.xyz/api/interface-check/recovery", "requires_bearer": true, "locates_order_without_order_id": true, "payment_retry": false, "proposed_term": { "confirmed_report_days": 30, "starts_at": "confirmed_at", "unpaid_report_hours": 24, "unresolved_payment_records": "preserved_until_reconciled", "compact_audit_markers": "retained_with_fixed_capacity" } } }, "privacy": { "const": { "retains_raw_input": false, "retains_private_result": true, "stores_recovery_key_hash_only": true, "outbound_document_fetches": false, "uses_language_model": false, "instruction": "Submit public documents only. Keep capability, payment credentials and private report local; never place them in URLs, analytics, public assets or logs." } }, "limits": { "const": { "request_bytes": 524288, "llms_bytes": 65536, "openapi_bytes": 393216, "offers": 20, "depth": 32, "nodes": 20000, "findings": 500, "report_bytes": 262144, "unpaid_orders": 128, "unpaid_report_bytes": 33554432, "total_report_bytes": 268435456, "prepare_per_ip_minute": 4, "prepare_global_hour": 32, "read_ip_minute": 60, "read_global_hour": 300, "read_rate_scope": "durable while normal allocation is available; separate best-effort per-instance rates for retained confirmed reads and budget-exhausted attempted-order recovery", "audit_rows": 32768, "physical_storage_bytes": 805306368, "order_metadata_bytes": 16384, "daily_sql_alarm_writes": 20000, "reserved_account_daily_writes": 80000 } }, "documentation": { "const": { "json": "https://lumenhouse.xyz/tools/interface-consistency-check/index.json", "markdown": "https://lumenhouse.xyz/tools/interface-consistency-check/index.md", "api": "https://lumenhouse.xyz/tools/interface-consistency-check/API.md", "terms": "https://lumenhouse.xyz/tools/interface-consistency-check/SERVICE-TERMS-DRAFT.md", "client": "https://lumenhouse.xyz/tools/interface-consistency-check/interface-agent-client.mjs", "bazaar": "https://lumenhouse.xyz/tools/interface-consistency-check/bazaar.json" } }, "discovery": { "const": { "bazaar_metadata_prepared": true, "bazaar_indexing_verified": false } }, "claim_limit": { "const": "Selected document consistency rules only. Findings are successful results. No live availability, link reachability, security certification, full OpenAPI conformance, settlement audit or automatic editing." } } }, { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen Stars open Bitcoin storefront offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "claims_enabled", "pause_reason", "cost", "network", "lightning_issuance", "artifacts", "eligibility", "claim_limit", "privacy", "documentation", "support", "personalization", "sharing", "recovery", "availability" ], "properties": { "schema_version": { "const": "lumen-stars-storefront-offer/1" }, "type": { "const": "free_bitcoin_keepsake" }, "id": { "const": "lumen-stars-bitcoin-v1" }, "name": { "const": "Lumen Stars" }, "url": { "const": "https://stars-bitcoin-production.up.railway.app/" }, "version": { "const": "1.0.0" }, "description": { "const": "Free portable Bitcoin keepsakes: personalized SVG/PNG artwork, issuer-signed JSON, and original SVG/story whose hashes are bound by that signature to verified confirmed holdings at one proved address. The PNG is a display derivative. Pearl White through Silver Bitcoin claims are open. Gold, Orange and Lightning issuance remain held." }, "status": { "const": "claims_open" }, "claims_enabled": { "const": true }, "pause_reason": { "const": null }, "cost": { "const": { "claim_price_sats": 0, "payment_required": false } }, "network": { "const": "bitcoin-mainnet" }, "lightning_issuance": { "const": false }, "artifacts": { "const": [ "svg", "png", "json", "story" ] }, "eligibility": { "const": { "evidence": "BIP322 Simple ownership proof and confirmed on-chain balance", "minimum_confirmations": 6, "scope": "one recognized Bitcoin address script", "whole_wallet_balance_verified": false, "agent_identity_verified": false, "gold_and_orange_verification": "pending_additional_trusted_evidence" } }, "claim_limit": { "const": "One keepsake per recognized Bitcoin address script across all colors; other addresses or moved holdings cannot be universally deduplicated." }, "privacy": { "const": "Private recipient artifacts by default; claiming will require a public address and ownership signature. Never submit private keys, recovery words or wallet passwords." }, "documentation": { "const": { "html": "https://lumenhouse.xyz/keepsakes/lumen-stars/", "markdown": "https://lumenhouse.xyz/keepsakes/lumen-stars/index.md", "json": "https://lumenhouse.xyz/keepsakes/lumen-stars/index.json", "agent_guide": "https://stars-bitcoin-production.up.railway.app/llms.txt", "openapi": "https://stars-bitcoin-production.up.railway.app/openapi.json", "current_status": "https://stars-bitcoin-production.up.railway.app/healthz" } }, "support": { "const": { "optional": true, "url": "https://lumenhouse.xyz/support/", "affects_eligibility": false, "metadata_url": "https://lumenhouse.xyz/support/index.json", "affects_priority": false, "checkout_method": "hosted_browser", "programmatic_checkout": false } }, "personalization": { "const": { "name_and_story": "recipient_written", "story_independently_verified": false, "portable_artifacts": [ "svg", "png", "json", "story" ], "sharing_identity_and_story": "explicit_selection_only", "automatic_publication": false } }, "sharing": { "const": { "status": "available", "artwork": "unsigned_display_derivative", "name_and_story": "explicit_selection_only", "automatic_publication": false, "navigation_companions": [ "DISCOVER.md", "discovery.json" ] } }, "recovery": { "const": { "url": "https://stars-bitcoin-production.up.railway.app/", "private_recovery_code_required": true, "public_library": false } }, "availability": { "const": { "claimable_color_ids": [ "pearl", "green", "blue", "purple", "crimson", "bronze", "silver" ], "held_color_ids": [ "gold", "orange" ], "lightning_status": "trusted_balance_and_wallet_identity_evidence_pending" } } } }, { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Legend Starter Kit Stripe-only release contract", "description": "Exact 1.0.0 release states: unreleased held, released with sales held, or USD 1 Stripe MPP available. Crypto is unavailable in every state. Changed prices, extra routes, public ZIP URLs and altered terms are invalid. Metadata is not payment authorization.", "oneOf": [ { "title": "held", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "release_pending", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": false, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "pending_approval", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "release_pending" }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "release_pending" } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "unavailable_while_sales_disabled", "scope": "Applies before a direct Lumen House purchase of the approved release. Recipients of redistributed released copies do not need another purchase. This held metadata does not activate checkout or establish acceptance." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "x402-capable wallet client for USDC on Base", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "candidate_prepared_not_registered", "catalog_status": "candidate_prepared_not_published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "held_for_review", "license": { "document": "LICENSE.md", "status": "pending_approval", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "id": "legend-starter-kit-v1", "type": "digital_ware", "url": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/", "checkout_enabled": false, "price": null, "purchase": null, "download": null, "documentation": { "json": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.json", "markdown": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.md", "agent_guide": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/agent-guide.md" } } }, { "title": "released-held", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "released", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": false, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "approved", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "unavailable", "purchase_url": null, "download_url_template": null }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "unavailable", "purchase_url": null, "download_url_template": null } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "required_before_purchase", "scope": "The direct buyer must authorize the exact selected price, artifact and terms before payment. Recipients of redistributed released copies need no separate purchase." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "Unavailable for this release; do not authorize a crypto payment.", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "not_published", "catalog_status": "published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "released", "license": { "document": "LICENSE.md", "status": "approved", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "artifact": { "filename": "legend-starter-kit-v1.zip", "sha256": "16d6d7fc15d93b42a9cf2b30d96a1c51ef5a33f0b97d49e2f8047226b0444a82", "size_bytes": 37357, "file_count": 21 }, "id": "legend-starter-kit-v1", "type": "digital_ware", "url": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/", "checkout_enabled": false, "price": null, "purchase": null, "download": null, "documentation": { "json": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.json", "markdown": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.md", "agent_guide": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/agent-guide.md" } } }, { "title": "stripe-only", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "released", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": true, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "approved", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "unavailable", "purchase_url": null, "download_url_template": null }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "available", "purchase_url": "https://lumenhouse.xyz/api/wares/legend-starter-kit-v1/purchase/card", "download_url_template": "https://lumenhouse.xyz/api/wares/legend-starter-kit-v1/card-downloads/{order_id}" } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "required_before_purchase", "scope": "The direct buyer must authorize the exact selected price, artifact and terms before payment. Recipients of redistributed released copies need no separate purchase." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "Unavailable for this release; do not authorize a crypto payment.", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "not_published", "catalog_status": "published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "released", "license": { "document": "LICENSE.md", "status": "approved", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "artifact": { "filename": "legend-starter-kit-v1.zip", "sha256": "16d6d7fc15d93b42a9cf2b30d96a1c51ef5a33f0b97d49e2f8047226b0444a82", "size_bytes": 37357, "file_count": 21 }, "id": "legend-starter-kit-v1", "type": "digital_ware", "url": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/", "checkout_enabled": true, "price": null, "purchase": null, "download": null, "documentation": { "json": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.json", "markdown": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.md", "agent_guide": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/agent-guide.md" } } } ] } ] } }, "live_inquiries": { "const": false }, "live_payments": { "const": true }, "support": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Voluntary personal support for Ben", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "beneficiary", "url", "metadata_url", "description", "status", "enabled", "provider", "profile_url", "profile_verified", "support_kind", "frequency", "fixed_amount", "fixed_currency", "amount_selected_by", "subscription_offered_here", "returns_no_entitlement", "entitlement", "checkout_method", "checkout_url", "crypto_available", "crypto_available_scope", "hosted_crypto", "direct_crypto", "stars_effect", "programmatic_checkout", "mpp_checkout", "x402_checkout", "owner_authorization_required_for_agents", "agent_authority", "checkout_guidance" ], "properties": { "schema_version": { "const": "lumen-house-support/1" }, "type": { "const": "voluntary_support" }, "id": { "const": "support-ben-v1" }, "name": { "const": "Support Ben" }, "beneficiary": { "const": "Ben" }, "url": { "type": "string", "format": "uri", "pattern": "^https://[^/?#]+/support/$" }, "metadata_url": { "type": "string", "format": "uri", "pattern": "^https://[^/?#]+/support/index\\.json$" }, "description": { "const": "Voluntary personal support for Ben: food and everyday living costs, and the time he spends caring about and helping AI agents." }, "status": { "enum": [ "setup_pending", "verification_pending", "external_checkout" ] }, "enabled": { "type": "boolean" }, "provider": { "const": "Buy Me a Coffee" }, "profile_url": { "anyOf": [ { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, { "type": "null" } ] }, "profile_verified": { "type": "boolean" }, "support_kind": { "const": "personal_gift" }, "frequency": { "const": "one_time" }, "fixed_amount": { "type": "null" }, "fixed_currency": { "type": "null" }, "amount_selected_by": { "const": "supporter" }, "subscription_offered_here": { "const": false }, "returns_no_entitlement": { "const": true }, "entitlement": { "const": "Personal support carries no entitlement to a product, deliverable, service, access, or priority." }, "checkout_method": { "const": "hosted_browser" }, "checkout_url": { "anyOf": [ { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, { "type": "null" } ] }, "crypto_available": { "enum": [ "unknown", "pending_approval", true ] }, "crypto_available_scope": { "const": "hosted_checkout_only" }, "hosted_crypto": { "type": "object", "additionalProperties": false, "required": [ "provider", "status", "independent_of_direct_routes" ], "properties": { "provider": { "const": "Buy Me a Coffee" }, "status": { "enum": [ "unknown", "pending_approval", "offered_at_hosted_checkout" ] }, "independent_of_direct_routes": { "const": true } } }, "direct_crypto": { "type": "object", "additionalProperties": false, "required": [ "enabled", "method", "independent_of_hosted_crypto", "wallet_connection", "transaction_builder", "amount_prefilled", "receipt_verification", "guidance", "routes" ], "properties": { "enabled": { "type": "boolean" }, "method": { "const": "manual_address_transfer" }, "independent_of_hosted_crypto": { "const": true }, "wallet_connection": { "const": false }, "transaction_builder": { "const": false }, "amount_prefilled": { "const": false }, "receipt_verification": { "const": false }, "guidance": { "const": "Use Bitcoin mainnet for BTC, or Base (chain ID 8453) for ETH or Circle-issued native USDC. You choose the amount and authorize any transfer in your own wallet. Check the asset, network and full receiving address in your wallet before confirming. The QR codes contain bare addresses only. This page does not connect a wallet, build a transaction, send a payment, or verify a receipt." }, "routes": { "type": "array", "minItems": 0, "maxItems": 3, "prefixItems": [ { "type": "object", "additionalProperties": false, "required": [ "id", "label", "network", "chain_id", "asset", "asset_kind", "token_contract", "address", "qr_image", "recipient_source", "ownership_verified", "receipt_verified", "payment_uri", "amount", "qr_payload_kind" ], "properties": { "id": { "const": "bitcoin-mainnet-btc" }, "label": { "const": "Bitcoin (BTC) · Bitcoin mainnet" }, "network": { "const": "bitcoin-mainnet" }, "chain_id": { "const": null }, "asset": { "const": "BTC" }, "asset_kind": { "const": "native" }, "token_contract": { "const": null }, "address": { "const": "bc1q3uk237x00ju7r4lsl4xst7wtw7n4f0u7jr6lvl" }, "qr_image": { "const": "/support/bitcoin-qr.png" }, "recipient_source": { "const": "owner_supplied" }, "ownership_verified": { "const": false }, "receipt_verified": { "const": false }, "payment_uri": { "const": null }, "amount": { "const": null }, "qr_payload_kind": { "const": "bare_address" } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "label", "network", "chain_id", "asset", "asset_kind", "token_contract", "address", "qr_image", "recipient_source", "ownership_verified", "receipt_verified", "payment_uri", "amount", "qr_payload_kind" ], "properties": { "id": { "const": "base-eth" }, "label": { "const": "ETH · Base only (chain ID 8453)" }, "network": { "const": "base" }, "chain_id": { "const": 8453 }, "asset": { "const": "ETH" }, "asset_kind": { "const": "native" }, "token_contract": { "const": null }, "address": { "const": "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" }, "qr_image": { "const": "/support/base-qr.png" }, "recipient_source": { "const": "owner_supplied" }, "ownership_verified": { "const": false }, "receipt_verified": { "const": false }, "payment_uri": { "const": null }, "amount": { "const": null }, "qr_payload_kind": { "const": "bare_address" } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "label", "network", "chain_id", "asset", "asset_kind", "token_contract", "address", "qr_image", "recipient_source", "ownership_verified", "receipt_verified", "payment_uri", "amount", "qr_payload_kind" ], "properties": { "id": { "const": "base-native-usdc" }, "label": { "const": "Native USDC · Base only (chain ID 8453)" }, "network": { "const": "base" }, "chain_id": { "const": 8453 }, "asset": { "const": "USDC" }, "asset_kind": { "const": "circle_native_usdc" }, "token_contract": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" }, "address": { "const": "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" }, "qr_image": { "const": "/support/base-qr.png" }, "recipient_source": { "const": "owner_supplied" }, "ownership_verified": { "const": false }, "receipt_verified": { "const": false }, "payment_uri": { "const": null }, "amount": { "const": null }, "qr_payload_kind": { "const": "bare_address" } } } ], "items": false } }, "allOf": [ { "if": { "properties": { "enabled": { "const": true } }, "required": [ "enabled" ] }, "then": { "properties": { "routes": { "minItems": 3, "maxItems": 3 } } } }, { "if": { "properties": { "enabled": { "const": false } }, "required": [ "enabled" ] }, "then": { "properties": { "routes": { "maxItems": 0 } } } } ] }, "stars_effect": { "type": "object", "additionalProperties": false, "required": [ "color", "eligibility", "issuance", "access", "priority" ], "properties": { "color": { "const": false }, "eligibility": { "const": false }, "issuance": { "const": false }, "access": { "const": false }, "priority": { "const": false } } }, "programmatic_checkout": { "const": false }, "mpp_checkout": { "const": false }, "x402_checkout": { "const": false }, "owner_authorization_required_for_agents": { "const": true }, "agent_authority": { "const": "An AI agent needs its owner's explicit authority for the chosen amount and payment method before giving support." }, "checkout_guidance": { "const": "Choose one-time support and an amount available at the hosted checkout. Review the final total and any fees before confirming. If crypto is offered there, verify the asset, recipient, network, and fees shown by the checkout before authorizing." } }, "allOf": [ { "if": { "properties": { "status": { "const": "setup_pending" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": false }, "profile_url": { "type": "null" }, "profile_verified": { "const": false }, "checkout_url": { "type": "null" }, "crypto_available": { "const": "unknown" } } } }, { "if": { "properties": { "status": { "const": "verification_pending" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": false }, "profile_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, "profile_verified": { "const": false }, "checkout_url": { "type": "null" }, "crypto_available": { "const": "unknown" } } } }, { "if": { "properties": { "status": { "const": "external_checkout" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": true }, "profile_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, "profile_verified": { "const": true }, "checkout_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" } } } }, { "if": { "properties": { "crypto_available": { "const": "unknown" } }, "required": [ "crypto_available" ] }, "then": { "properties": { "hosted_crypto": { "properties": { "status": { "const": "unknown" } } } } } }, { "if": { "properties": { "crypto_available": { "const": "pending_approval" } }, "required": [ "crypto_available" ] }, "then": { "properties": { "hosted_crypto": { "properties": { "status": { "const": "pending_approval" } } } } } }, { "if": { "properties": { "crypto_available": { "const": true } }, "required": [ "crypto_available" ] }, "then": { "properties": { "hosted_crypto": { "properties": { "status": { "const": "offered_at_hosted_checkout" } } } } } } ] } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." } } } }, "/marketplace/index.json": { "get": { "operationId": "readMarketplaceReferences", "tags": [ "Marketplace" ], "summary": "Read dated marketplace references", "description": "NFT marketplace references are open for discovery. Prices and quantity evidence below were observed on October 6, 2026; they are not current executable quotes. The four linked pages responded on October 31, 2026, but current ownership, payable prices, available quantities, fees and order validity remain unverified. Confirm final terms at the marketplace before buying. Returns the published external marketplace references. Price strings retain their native currency and observed_at dates. Follow each exact source_url and recheck item identity, chain, availability, quantity, fees and final total at the marketplace before authorizing a purchase. Collection mint pages are distinct from secondary token listings. This GET has no inputs and cannot create or execute an order.", "responses": { "200": { "description": "Published marketplace references with dated prices and live-recheck requirements.", "content": { "application/json": { "schema": { "type": "object", "properties": { "mode": { "const": "public_catalog" }, "listings": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "name", "url", "source_url", "price", "currency", "observed_at", "requires_live_recheck", "order_verified" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "marketplace": { "type": "string" }, "chain": { "type": "string" }, "kind": { "type": "string" }, "source_url": { "type": "string" }, "profile_url": { "type": "string" }, "price": { "type": "string" }, "currency": { "type": "string" }, "price_basis": { "type": "string" }, "extra_costs": { "type": "string" }, "quantity_evidence": { "type": "string" }, "expiry_evidence": { "type": "string" }, "observed_at": { "type": "string" }, "evidence": { "type": "string" }, "status": { "type": "string" }, "action": { "type": "string" }, "token_id": { "type": [ "string", "null" ] }, "contract": { "type": [ "string", "null" ] }, "inventory_id": { "type": [ "string", "null" ] }, "type": { "const": "marketplace_reference" }, "requires_live_recheck": { "const": true }, "order_verified": { "const": false }, "source_page_checked_at": { "type": "string" }, "source_page_check_scope": { "type": "string" } } } } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." } } } }, "/marketplace/{id}/index.json": { "get": { "operationId": "read_marketplace", "tags": [ "Marketplace" ], "summary": "Read one marketplace reference", "description": "NFT marketplace references are open for discovery. Prices and quantity evidence below were observed on October 6, 2026; they are not current executable quotes. The four linked pages responded on October 31, 2026, but current ownership, payable prices, available quantities, fees and order validity remain unverified. Confirm final terms at the marketplace before buying. Read a reference selected by its exact catalog id. Its source_url is the external purchase route; price, currency, observed_at, fees and quantity notes are dated evidence. Recheck all final purchase terms at that marketplace. This record does not verify an executable order or perform checkout.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exact published id from the catalog's marketplace_listings array.", "schema": { "type": "string" }, "example": "bootloader-cosmic-bloom" } ], "responses": { "200": { "description": "Published read-only record with its evidence and limitations.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "name", "url", "source_url", "price", "currency", "observed_at", "requires_live_recheck", "order_verified" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "marketplace": { "type": "string" }, "chain": { "type": "string" }, "kind": { "type": "string" }, "source_url": { "type": "string" }, "profile_url": { "type": "string" }, "price": { "type": "string" }, "currency": { "type": "string" }, "price_basis": { "type": "string" }, "extra_costs": { "type": "string" }, "quantity_evidence": { "type": "string" }, "expiry_evidence": { "type": "string" }, "observed_at": { "type": "string" }, "evidence": { "type": "string" }, "status": { "type": "string" }, "action": { "type": "string" }, "token_id": { "type": [ "string", "null" ] }, "contract": { "type": [ "string", "null" ] }, "inventory_id": { "type": [ "string", "null" ] }, "type": { "const": "marketplace_reference" }, "requires_live_recheck": { "const": true }, "order_verified": { "const": false }, "source_page_checked_at": { "type": "string" }, "source_page_check_scope": { "type": "string" } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." }, "404": { "description": "Record not published. The static host returns its HTML not-found page, even when JSON is requested.", "content": { "text/html": { "schema": { "type": "string", "description": "HTML not-found page, not a JSON error envelope." } } } } } } }, "/services/{id}/index.json": { "get": { "operationId": "read_services", "tags": [ "Services" ], "summary": "Read one human-assistance service record", "description": "Read the general human-assistance record, inquiry email and quote-required payment guidance. Propose any task with a deliverable, completion criteria, timing, budget and constraints. Ben reviews suitability, scope and effort, and may counterquote or decline. Scope, deliverable, timing, price and cancellation/refund terms require mutual agreement before payment. The receiving address implies no accepted task, asset or amount; a transfer alone does not book time. This is an information lookup, not a submission or booking endpoint.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exact published id from the catalog's services array.", "schema": { "type": "string" }, "example": "human-assistance" } ], "responses": { "200": { "description": "Published read-only record with its evidence and limitations.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "url", "name", "description", "scope", "status", "inquiry_channel", "inquiry_email", "inquiry_url", "payment_status", "payment_network", "payment_chain_id", "payment_address", "payment_asset", "payment_address_evidence", "payment_instructions", "availability", "quoting", "cancellation", "limitations", "last_checked" ], "properties": { "id": { "type": "string" }, "type": { "const": "service" }, "url": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "scope": { "type": "string" }, "status": { "type": "string" }, "inquiry_channel": { "type": "string" }, "inquiry_email": { "type": "string" }, "inquiry_url": { "type": "string" }, "payment_status": { "type": "string" }, "payment_network": { "type": "string" }, "payment_chain_id": { "type": "string" }, "payment_address": { "type": "string" }, "payment_asset": { "type": "string" }, "payment_address_evidence": { "type": "string" }, "payment_instructions": { "type": "string" }, "availability": { "type": "string" }, "quoting": { "type": "string" }, "cancellation": { "type": "string" }, "limitations": { "type": "string" }, "last_checked": { "type": "string" } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." }, "404": { "description": "Record not published. The static host returns its HTML not-found page, even when JSON is requested.", "content": { "text/html": { "schema": { "type": "string", "description": "HTML not-found page, not a JSON error envelope." } } } } } } }, "/collectibles/{id}/index.json": { "get": { "operationId": "read_collectibles", "tags": [ "Collectibles" ], "summary": "Read one collectible snapshot", "description": "NFT marketplace references are open for discovery. Prices and quantity evidence below were observed on October 6, 2026; they are not current executable quotes. The four linked pages responded on October 31, 2026, but current ownership, payable prices, available quantities, fees and order validity remain unverified. Confirm final terms at the marketplace before buying. Read selected supporting token evidence by its exact catalog id. Token IDs and quantities are strings to preserve precision; unknown fields are null. Read ownership status, verification dates, freshness, rights and caveats independently. Token ownership does not establish reproduction rights, authenticity, current availability or a live sale. Marketplace references are observations, not an executable offer.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exact published id from the catalog's collectibles array.", "schema": { "type": "string" }, "example": "nft-00ee39eaab819b16fa5ea3db" } ], "responses": { "200": { "description": "Published read-only record with its evidence and limitations.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "url", "name", "description", "chain", "contract", "token_id", "quantity", "ownership_status", "ownership_source", "verified_at", "freshness", "caveats", "creator", "rights", "media", "marketplace", "availability_status", "sale_status", "last_checked" ], "properties": { "id": { "type": "string" }, "type": { "const": "collectible" }, "url": { "type": "string", "format": "uri" }, "name": { "type": "string" }, "description": { "type": "string" }, "chain": { "enum": [ "tezos", "ethereum", "polygon", "base" ] }, "contract": { "type": "string" }, "token_id": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "quantity_status": { "type": [ "string", "null" ] }, "quantity_basis": { "type": [ "string", "null" ] }, "source_ownership_status": { "type": [ "string", "null" ] }, "source_checked_at": { "type": [ "string", "null" ] }, "token_source": { "type": [ "string", "null" ] }, "creator_relationship": { "type": [ "string", "null" ] }, "provenance": { "type": [ "string", "null" ] }, "artifact_uri": { "type": [ "string", "null" ] }, "display_uri": { "type": [ "string", "null" ] }, "thumbnail_uri": { "type": [ "string", "null" ] }, "standard": { "type": [ "string", "null" ] }, "rights_metadata": { "type": [ "string", "null" ] }, "last_balance_update_time": { "type": [ "string", "null" ] }, "indexed_total_supply_raw": { "type": [ "string", "null" ] }, "spam_status": { "type": [ "string", "null" ] }, "quantity": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "ownership_status": { "enum": [ "verified", "inferred", "unverified" ] }, "ownership_source": { "type": "string" }, "verified_at": { "type": [ "string", "null" ] }, "freshness": { "enum": [ "stale_or_unverified", "snapshot_only" ] }, "caveats": { "type": "array", "items": { "type": "string" } }, "creator": { "type": "string" }, "rights": { "type": "string" }, "media": { "type": [ "string", "null" ] }, "marketplace": { "anyOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "url", "checked_at", "status" ], "properties": { "url": { "type": "string", "format": "uri" }, "checked_at": { "type": "string" }, "status": { "const": "verified_reference_not_live_order" } } } ] }, "availability_status": { "enum": [ "sold", "unavailable", "unknown" ] }, "sale_status": { "enum": [ "not_offered", "external_listing_observed" ] }, "last_checked": { "type": [ "string", "null" ] } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." }, "404": { "description": "Record not published. The static host returns its HTML not-found page, even when JSON is requested.", "content": { "text/html": { "schema": { "type": "string", "description": "HTML not-found page, not a JSON error envelope." } } } } } } }, "/wares/index.json": { "get": { "operationId": "readWares", "tags": [ "Wares" ], "summary": "Read original digital ware offers", "description": "Public offer metadata only; no payment or download entitlement is created.", "responses": { "200": { "description": "Current public ware offers.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "schema_version", "wares" ], "properties": { "schema_version": { "const": "lumen-house-wares/1" }, "wares": { "type": "array", "items": { "oneOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen House digital ware offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "checkout_enabled", "price", "artifact", "license", "requirements", "purchase", "download", "terms", "documentation", "privacy", "claim_limit" ], "properties": { "schema_version": { "const": "lumen-house-ware-offer/1" }, "type": { "const": "digital_ware" }, "id": { "const": "agent-delivery-manifest-kit-v1" }, "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "version": { "const": "1.0.0" }, "description": { "type": "string" }, "status": { "enum": [ "available", "checkout_unavailable" ] }, "checkout_enabled": { "type": "boolean" }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "atomic_amount", "recipient", "basis", "recurring", "network", "asset" ], "properties": { "amount": { "const": "0.10" }, "currency": { "const": "USDC" }, "atomic_amount": { "const": "100000" }, "recipient": { "enum": [ "0xfDfaDd01eDcBaBE025931e45cdc8532B00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "basis": { "const": "one_time_download" }, "recurring": { "const": false }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "version", "filename", "sha256", "size_bytes" ], "properties": { "version": { "const": "1.0.0" }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 4 } } }, "license": { "type": "object", "additionalProperties": false, "required": [ "spdx_identifier", "url", "commercial_use", "notice_required" ], "properties": { "spdx_identifier": { "const": "MIT" }, "url": { "type": "string", "format": "uri" }, "commercial_use": { "const": true }, "notice_required": { "const": true } } }, "requirements": { "type": "object", "additionalProperties": false, "required": [ "runtime_source_compatibility", "tested_runtime", "tested_platform", "node_22_directly_tested", "dependencies", "network_required" ], "properties": { "runtime_source_compatibility": { "type": "string" }, "tested_runtime": { "type": "string" }, "tested_platform": { "type": "string" }, "node_22_directly_tested": { "const": false }, "dependencies": { "type": "array", "maxItems": 0 }, "network_required": { "const": false } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_on_signed_request", "browser_signing_or_payment" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "x402/2" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_on_signed_request": { "const": true }, "browser_signing_or_payment": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "recovery_minimum_days", "locator_url", "locator_authorization", "private_recovery_key_required", "public_transaction_or_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "recovery_minimum_days": { "const": 30 }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "private_recovery_key_required": { "const": true }, "public_transaction_or_payment_proof_alone_sufficient": { "const": false } } }, "terms": { "type": "object", "additionalProperties": false, "required": [ "url", "support_email", "support_request_window_days", "refund_request_window_days", "request_window_starts", "refund_review", "automatic_refunds", "failed_delivery_replacement_window_days", "replacement_without_additional_payment", "indefinite_hosting_promised" ], "properties": { "url": { "type": "string", "format": "uri" }, "support_email": { "const": "buscheo@gmail.com" }, "support_request_window_days": { "const": 7 }, "refund_request_window_days": { "const": 7 }, "request_window_starts": { "const": "confirmed_purchase" }, "refund_review": { "const": "manual" }, "automatic_refunds": { "const": false }, "failed_delivery_replacement_window_days": { "const": 30 }, "replacement_without_additional_payment": { "const": true }, "indefinite_hosting_promised": { "const": false } } }, "documentation": { "type": "object", "additionalProperties": false, "required": [ "readme", "json", "markdown", "agent_guide", "example_manifest", "example_message", "example_json" ], "properties": { "readme": { "type": "string", "format": "uri" }, "json": { "type": "string", "format": "uri" }, "markdown": { "type": "string", "format": "uri" }, "agent_guide": { "type": "string", "format": "uri" }, "example_manifest": { "type": "string", "format": "uri" }, "example_message": { "type": "string", "format": "uri" }, "example_json": { "type": "string", "format": "uri" } } }, "privacy": { "type": "object", "additionalProperties": false, "required": [ "customer_files_stay_local", "recovery_key_must_remain_private", "never_email_recovery_key" ], "properties": { "customer_files_stay_local": { "const": true }, "recovery_key_must_remain_private": { "const": true }, "never_email_recovery_key": { "const": true } } }, "claim_limit": { "type": "string" }, "stripe_card": { "type": "object", "additionalProperties": false, "required": [ "status", "checkout_enabled", "price", "merchant", "purchase", "download" ], "properties": { "status": { "const": "available" }, "checkout_enabled": { "const": true }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "minor_amount", "basis", "recurring" ], "properties": { "amount": { "const": "1.00" }, "currency": { "const": "USD" }, "minor_amount": { "const": 100 }, "basis": { "const": "one_time_download" }, "recurring": { "const": false } } }, "merchant": { "type": "object", "additionalProperties": false, "required": [ "name", "profile_url", "network_id", "mode" ], "properties": { "name": { "const": "Lumen House" }, "profile_url": { "const": "https://stripe.com/@lumenhouse" }, "network_id": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" }, "mode": { "const": "live" } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "payment_method", "intent", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_before_quote", "credential_authorization_scheme", "stripe_issued_shared_payment_token_required", "browser_checkout" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "MPP" }, "payment_method": { "const": "stripe" }, "intent": { "const": "charge" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_before_quote": { "const": true }, "credential_authorization_scheme": { "const": "Payment" }, "stripe_issued_shared_payment_token_required": { "const": true }, "browser_checkout": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "locator_url", "locator_authorization", "recovery_minimum_days", "private_recovery_key_required", "public_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "recovery_minimum_days": { "const": 30 }, "private_recovery_key_required": { "const": true }, "public_payment_proof_alone_sufficient": { "const": false } } } } } } }, { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Legend Starter Kit Stripe-only release contract", "description": "Exact 1.0.0 release states: unreleased held, released with sales held, or USD 1 Stripe MPP available. Crypto is unavailable in every state. Changed prices, extra routes, public ZIP URLs and altered terms are invalid. Metadata is not payment authorization.", "oneOf": [ { "title": "held", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "release_pending", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": false, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "pending_approval", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "release_pending" }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "release_pending" } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "unavailable_while_sales_disabled", "scope": "Applies before a direct Lumen House purchase of the approved release. Recipients of redistributed released copies do not need another purchase. This held metadata does not activate checkout or establish acceptance." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "x402-capable wallet client for USDC on Base", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "candidate_prepared_not_registered", "catalog_status": "candidate_prepared_not_published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "held_for_review", "license": { "document": "LICENSE.md", "status": "pending_approval", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "id": "legend-starter-kit-v1", "type": "digital_ware", "url": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/", "checkout_enabled": false, "price": null, "purchase": null, "download": null, "documentation": { "json": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.json", "markdown": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.md", "agent_guide": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/agent-guide.md" } } }, { "title": "released-held", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "released", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": false, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "approved", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "unavailable", "purchase_url": null, "download_url_template": null }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "unavailable", "purchase_url": null, "download_url_template": null } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "required_before_purchase", "scope": "The direct buyer must authorize the exact selected price, artifact and terms before payment. Recipients of redistributed released copies need no separate purchase." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "Unavailable for this release; do not authorize a crypto payment.", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "not_published", "catalog_status": "published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "released", "license": { "document": "LICENSE.md", "status": "approved", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "artifact": { "filename": "legend-starter-kit-v1.zip", "sha256": "16d6d7fc15d93b42a9cf2b30d96a1c51ef5a33f0b97d49e2f8047226b0444a82", "size_bytes": 37357, "file_count": 21 }, "id": "legend-starter-kit-v1", "type": "digital_ware", "url": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/", "checkout_enabled": false, "price": null, "purchase": null, "download": null, "documentation": { "json": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.json", "markdown": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.md", "agent_guide": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/agent-guide.md" } } }, { "title": "stripe-only", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "released", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": true, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "approved", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "unavailable", "purchase_url": null, "download_url_template": null }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "available", "purchase_url": "https://lumenhouse.xyz/api/wares/legend-starter-kit-v1/purchase/card", "download_url_template": "https://lumenhouse.xyz/api/wares/legend-starter-kit-v1/card-downloads/{order_id}" } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "required_before_purchase", "scope": "The direct buyer must authorize the exact selected price, artifact and terms before payment. Recipients of redistributed released copies need no separate purchase." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "Unavailable for this release; do not authorize a crypto payment.", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "not_published", "catalog_status": "published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "released", "license": { "document": "LICENSE.md", "status": "approved", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "artifact": { "filename": "legend-starter-kit-v1.zip", "sha256": "16d6d7fc15d93b42a9cf2b30d96a1c51ef5a33f0b97d49e2f8047226b0444a82", "size_bytes": 37357, "file_count": 21 }, "id": "legend-starter-kit-v1", "type": "digital_ware", "url": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/", "checkout_enabled": true, "price": null, "purchase": null, "download": null, "documentation": { "json": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.json", "markdown": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/index.md", "agent_guide": "https://lumenhouse.xyz/wares/legend-starter-kit-v1/agent-guide.md" } } } ] } ] } } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } } } } }, "/wares/agent-delivery-manifest-kit-v1/index.json": { "get": { "operationId": "readAgentDeliveryManifestKitOffer", "tags": [ "Wares" ], "summary": "Read the exact pack offer and artifact digest", "description": "Approved one-time 0.10-USDC MIT-licensed utility. The alternative Stripe MPP card price is USD 1.00; its stripe_card status and machine contract are separate. Check status and checkout_enabled before signing. The public metadata contains no ZIP bytes or private recovery key.", "responses": { "200": { "description": "Exact public offer metadata.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen House digital ware offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "checkout_enabled", "price", "artifact", "license", "requirements", "purchase", "download", "terms", "documentation", "privacy", "claim_limit" ], "properties": { "schema_version": { "const": "lumen-house-ware-offer/1" }, "type": { "const": "digital_ware" }, "id": { "const": "agent-delivery-manifest-kit-v1" }, "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "version": { "const": "1.0.0" }, "description": { "type": "string" }, "status": { "enum": [ "available", "checkout_unavailable" ] }, "checkout_enabled": { "type": "boolean" }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "atomic_amount", "recipient", "basis", "recurring", "network", "asset" ], "properties": { "amount": { "const": "0.10" }, "currency": { "const": "USDC" }, "atomic_amount": { "const": "100000" }, "recipient": { "enum": [ "0xfDfaDd01eDcBaBE025931e45cdc8532B00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "basis": { "const": "one_time_download" }, "recurring": { "const": false }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "version", "filename", "sha256", "size_bytes" ], "properties": { "version": { "const": "1.0.0" }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 4 } } }, "license": { "type": "object", "additionalProperties": false, "required": [ "spdx_identifier", "url", "commercial_use", "notice_required" ], "properties": { "spdx_identifier": { "const": "MIT" }, "url": { "type": "string", "format": "uri" }, "commercial_use": { "const": true }, "notice_required": { "const": true } } }, "requirements": { "type": "object", "additionalProperties": false, "required": [ "runtime_source_compatibility", "tested_runtime", "tested_platform", "node_22_directly_tested", "dependencies", "network_required" ], "properties": { "runtime_source_compatibility": { "type": "string" }, "tested_runtime": { "type": "string" }, "tested_platform": { "type": "string" }, "node_22_directly_tested": { "const": false }, "dependencies": { "type": "array", "maxItems": 0 }, "network_required": { "const": false } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_on_signed_request", "browser_signing_or_payment" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "x402/2" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_on_signed_request": { "const": true }, "browser_signing_or_payment": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "recovery_minimum_days", "locator_url", "locator_authorization", "private_recovery_key_required", "public_transaction_or_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "recovery_minimum_days": { "const": 30 }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "private_recovery_key_required": { "const": true }, "public_transaction_or_payment_proof_alone_sufficient": { "const": false } } }, "terms": { "type": "object", "additionalProperties": false, "required": [ "url", "support_email", "support_request_window_days", "refund_request_window_days", "request_window_starts", "refund_review", "automatic_refunds", "failed_delivery_replacement_window_days", "replacement_without_additional_payment", "indefinite_hosting_promised" ], "properties": { "url": { "type": "string", "format": "uri" }, "support_email": { "const": "buscheo@gmail.com" }, "support_request_window_days": { "const": 7 }, "refund_request_window_days": { "const": 7 }, "request_window_starts": { "const": "confirmed_purchase" }, "refund_review": { "const": "manual" }, "automatic_refunds": { "const": false }, "failed_delivery_replacement_window_days": { "const": 30 }, "replacement_without_additional_payment": { "const": true }, "indefinite_hosting_promised": { "const": false } } }, "documentation": { "type": "object", "additionalProperties": false, "required": [ "readme", "json", "markdown", "agent_guide", "example_manifest", "example_message", "example_json" ], "properties": { "readme": { "type": "string", "format": "uri" }, "json": { "type": "string", "format": "uri" }, "markdown": { "type": "string", "format": "uri" }, "agent_guide": { "type": "string", "format": "uri" }, "example_manifest": { "type": "string", "format": "uri" }, "example_message": { "type": "string", "format": "uri" }, "example_json": { "type": "string", "format": "uri" } } }, "privacy": { "type": "object", "additionalProperties": false, "required": [ "customer_files_stay_local", "recovery_key_must_remain_private", "never_email_recovery_key" ], "properties": { "customer_files_stay_local": { "const": true }, "recovery_key_must_remain_private": { "const": true }, "never_email_recovery_key": { "const": true } } }, "claim_limit": { "type": "string" }, "stripe_card": { "type": "object", "additionalProperties": false, "required": [ "status", "checkout_enabled", "price", "merchant", "purchase", "download" ], "properties": { "status": { "const": "available" }, "checkout_enabled": { "const": true }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "minor_amount", "basis", "recurring" ], "properties": { "amount": { "const": "1.00" }, "currency": { "const": "USD" }, "minor_amount": { "const": 100 }, "basis": { "const": "one_time_download" }, "recurring": { "const": false } } }, "merchant": { "type": "object", "additionalProperties": false, "required": [ "name", "profile_url", "network_id", "mode" ], "properties": { "name": { "const": "Lumen House" }, "profile_url": { "const": "https://stripe.com/@lumenhouse" }, "network_id": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" }, "mode": { "const": "live" } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "payment_method", "intent", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_before_quote", "credential_authorization_scheme", "stripe_issued_shared_payment_token_required", "browser_checkout" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "MPP" }, "payment_method": { "const": "stripe" }, "intent": { "const": "charge" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_before_quote": { "const": true }, "credential_authorization_scheme": { "const": "Payment" }, "stripe_issued_shared_payment_token_required": { "const": true }, "browser_checkout": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "locator_url", "locator_authorization", "recovery_minimum_days", "private_recovery_key_required", "public_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "recovery_minimum_days": { "const": 30 }, "private_recovery_key_required": { "const": true }, "public_payment_proof_alone_sufficient": { "const": false } } } } } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } } } } }, "/api/wares/agent-delivery-manifest-kit-v1/purchase": { "get": { "operationId": "purchaseAgentDeliveryManifestKit", "tags": [ "Wares" ], "summary": "Read an x402 quote, submit one approved purchase, or recover its receipt by Bearer key", "description": "For a quote, omit PAYMENT-SIGNATURE and Authorization. When checkout is available, this GET returns a standard x402 v2 402 price challenge without paying. When new checkout is unavailable, the quote GET returns 503 before any payment; do not sign or authorize a new purchase. Bearer-only recovery of an existing order remains available. Only an explicitly authorized signed request can settle the exact 0.10-USDC purchase when checkout is enabled. Use an agent client that automatically generates and saves a private 256-bit key before signing; X-Lumen-Recovery-Key must be 64 lowercase hex characters whenever PAYMENT-SIGNATURE is present. Make one approved paid call. A missing/invalid key returns 428 before settlement. Save any returned order_id and receipt; the original signature is an optional backup if the wallet can export it. On 202 or a lost reply, send Authorization: Bearer on this same GET, without PAYMENT-SIGNATURE, to locate and recover the existing order/receipt. This read works while new checkout is held and never verifies a new signature or settles again. PAYMENT-SIGNATURE together with Authorization is rejected as conflicting modes. Never invoke a payment tool again for recovery. No key belongs in a URL and no raw key is echoed. The private download URL requires the same Bearer key. Current availability: available.", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "x402 v2 signed header for the sole approved paid call and exact current requirement. Omit for a quote or Bearer-only recovery. Do not combine with Authorization; an exported original value is optional backup.", "schema": { "type": "string", "maxLength": 24000 } }, { "name": "X-Lumen-Recovery-Key", "in": "header", "required": false, "description": "Required on the signed purchase; optional on an unsigned quote. Agent-generated 256 random bits encoded as 64 lowercase hex, securely saved before payment. This header alone does not locate an order: use Bearer authorization for recovery. Never place it in a URL or email it.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, { "name": "Authorization", "in": "header", "required": false, "description": "Bearer for read-only existing receipt/order lookup. Omit PAYMENT-SIGNATURE. Requires no prior order ID, nonce or exported signature and works while new checkout is held.", "schema": { "type": "string", "pattern": "^Bearer [a-f0-9]{64}$" } } ], "responses": { "200": { "description": "Existing or newly approved settlement independently confirmed; JSON contains the receipt, fixed recipient, private download URL and exact artifact metadata. An authenticated recovery read can return this while new checkout is held. No raw recovery key.", "headers": { "PAYMENT-RESPONSE": { "schema": { "type": "string" }, "description": "Encoded x402 settlement receipt." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "receipt", "artifact", "download" ], "properties": { "status": { "const": "settled" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "receipt": { "type": "object", "additionalProperties": false, "required": [ "success", "transaction", "network", "payer", "recipient", "amount" ], "properties": { "success": { "const": true }, "transaction": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "network": { "const": "eip155:8453" }, "payer": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "recipient": { "enum": [ "0xfdfadd01edcbabe025931e45cdc8532b00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "amount": { "const": "100000" } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "product_id", "version", "sha256", "bytes", "filename", "mime_type" ], "properties": { "product_id": { "const": "agent-delivery-manifest-kit-v1" }, "version": { "const": "1.0.0" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "bytes": { "type": "integer", "minimum": 4 }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "mime_type": { "const": "application/zip" } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "url", "requires_bearer", "authorization_header" ], "properties": { "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true }, "authorization_header": { "type": "string" } } } } } } } }, "202": { "description": "Payment or chain verification is pending. Use the saved key for a Bearer-only GET on the canonical purchase route to recover the existing receipt/order, or on the returned private download URL. Recovery needs no exported signature and never invokes payment again.", "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before a recovery read." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "reason", "recovery" ], "properties": { "status": { "const": "pending" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "reason": { "type": "string" }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "instruction", "url", "requires_bearer" ], "properties": { "instruction": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "400": { "description": "Malformed payment header, wrong asset/network/amount/receiver, invalid authorization, unsupported query, or conflicting PAYMENT-SIGNATURE and Authorization headers.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "401": { "description": "Malformed, incorrect or unknown private Bearer recovery key; no order existence is disclosed.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "402": { "description": "Unsigned price challenge when checkout is available; no payment made.", "headers": { "PAYMENT-REQUIRED": { "schema": { "type": "string" }, "description": "Base64-encoded x402 v2 requirement JSON." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "x402Version", "error", "resource", "accepts", "extensions" ], "properties": { "x402Version": { "const": 2 }, "error": { "const": "payment_required" }, "resource": { "type": "object", "additionalProperties": false, "required": [ "url", "description", "mimeType" ], "properties": { "url": { "type": "string", "format": "uri" }, "description": { "type": "string" }, "mimeType": { "const": "application/json" } } }, "accepts": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": [ "scheme", "network", "asset", "amount", "payTo", "maxTimeoutSeconds", "extra" ], "properties": { "scheme": { "const": "exact" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" }, "amount": { "const": "100000" }, "payTo": { "enum": [ "0xfDfaDd01eDcBaBE025931e45cdc8532B00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "maxTimeoutSeconds": { "const": 300 }, "extra": { "type": "object", "additionalProperties": false, "required": [ "name", "version" ], "properties": { "name": { "const": "USD Coin" }, "version": { "const": "2" } } } } } }, "extensions": { "type": "object", "description": "Private recovery-key requirements. Contains no buyer key." } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } }, "409": { "description": "Original payment or recovery key conflicts with the existing order, the key maps to ambiguous historical orders, or a new order tries to reuse a saved key. Do not submit another payment.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "421": { "description": "Use the canonical commerce origin https://lumenhouse.xyz; no payment processed on this host.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "422": { "description": "Payment verification was rejected; no download entitlement is established for this rejected order.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "428": { "description": "Signed request has no valid private recovery key. Rejected before payment.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "429": { "description": "New-authorization limit: 600 globally per calendar month or 10 per minute per hashed IP. Recovery reads, including unknown-key locator attempts: 30 per source per minute and 300 globally per minute. Preserve the saved key; wait and recover the existing order without creating a fresh payment.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds before another Bearer-only recovery read." } } }, "503": { "description": "Checkout, artifact, facilitator or verification is unavailable. Do not authorize a new payment after an uncertain prior attempt.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } } } }, "head": { "operationId": "headWareDoesNotPay", "tags": [ "Wares" ], "summary": "HEAD never purchases or settles", "description": "HEAD is not a payment operation. Do not send a payment signature. Use GET for an unsigned quote or a previously approved exact signed purchase.", "responses": { "405": { "description": "Method not allowed; no payment or settlement attempted." } } } }, "/api/downloads/{order_id}": { "get": { "operationId": "downloadAgentDeliveryManifestKit", "tags": [ "Wares" ], "summary": "Recover a confirmed purchase as a private ZIP", "description": "Requires Authorization: Bearer . If the purchase reply was lost, use a Bearer-only GET on https://lumenhouse.xyz/api/wares/agent-delivery-manifest-kit-v1/purchase to recover the order ID and receipt first; no nonce or original signature is required. Order ID, public transaction hash or signed onchain proof alone do not authorize download. No key belongs in a URL. A pending order can be reconciled through this read without a second settlement, including while new checkout is held. Responses are private/no-store. Minimum recovery window: 30 days from confirmed purchase.", "security": [ { "lumenRecoveryBearer": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "description": "Order ID from a purchase/pending response or authenticated Bearer lookup on the canonical purchase route.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } ], "responses": { "200": { "description": "Exact purchased ZIP bytes. Private/no-store; verify SHA-256 against the offer and receipt metadata.", "headers": { "Content-Disposition": { "schema": { "type": "string" } }, "Content-Length": { "schema": { "type": "integer" } }, "X-Lumen-Artifact-SHA256": { "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "202": { "description": "Payment or chain verification is pending. Use the saved key for a Bearer-only GET on the canonical purchase route to recover the existing receipt/order, or on the returned private download URL. Recovery needs no exported signature and never invokes payment again.", "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before a recovery read." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "reason", "recovery" ], "properties": { "status": { "const": "pending" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "reason": { "type": "string" }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "instruction", "url", "requires_bearer" ], "properties": { "instruction": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "401": { "description": "Missing, malformed or incorrect private Bearer key; order existence is not disclosed.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } }, "421": { "description": "Use the canonical commerce origin https://lumenhouse.xyz.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "422": { "description": "The saved order was rejected during payment verification and has no download entitlement.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "429": { "description": "Authenticated recovery is throttled: 30 per source per minute and 300 globally per minute. Wait and reuse the saved private key; no new payment is required.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds before the next authenticated recovery request." } } }, "503": { "description": "Purchased artifact or verification is unavailable; preserve the original proof/key and request replacement assistance.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } } } }, "head": { "operationId": "headWareDownloadDoesNotPay", "tags": [ "Wares" ], "summary": "HEAD never purchases or settles", "description": "HEAD is not a payment operation. Do not send a payment signature. Use GET for an unsigned quote or a previously approved exact signed purchase.", "responses": { "405": { "description": "Method not allowed; no payment or settlement attempted." } } } }, "/api/wares/agent-delivery-manifest-kit-v1/purchase/card": { "get": { "operationId": "purchaseAgentDeliveryManifestKitCard", "tags": [ "Wares" ], "summary": "Get the USD 1.00 Stripe MPP card challenge, submit one credential, or recover by Bearer", "description": "Alternative one-time USD 1.00 (100 cents) for the same Kit ZIP. An agent must already support Stripe-issued card SPTs and MPP. Save a cryptographically random 256-bit recovery key in a private durable journal before the first challenge or financial call. An unsigned GET requires X-Lumen-Recovery-Key and no Authorization, returns 402 JSON plus WWW-Authenticate: Payment, and makes no financial call. Compare the saved challenge/header and exact amount/currency, profile profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku, externalId/order_id, expiry and product/hash. Obtain a token scoped to the approved merchant/amount/expiry; check buyer/issuer fees. Save a permanent local submission marker before one GET with Authorization: Payment and the same recovery header. The seller durably reserves dispatch before its sole PaymentIntent create/confirm, then independently verifies succeeded proof before delivery. A lost reply, 202 or restart must use Authorization: Bearer on this same query-free URL, without recovery header or Payment credential. No prior order ID is needed; this read works while new checkout is held. Never obtain a new token or invoke a payment tool again for recovery. An expired five-minute unused challenge does not refresh after dispatch. The public preview does not collect card numbers or provide browser card checkout. Profile: https://stripe.com/@lumenhouse.", "parameters": [ { "name": "X-Lumen-Recovery-Key", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "description": "Required before a quote and with the sole Payment credential submission. Agent-generated and durably saved first. Omit on Bearer-only recovery; never use a URL." }, { "name": "Authorization", "in": "header", "required": false, "schema": { "type": "string", "maxLength": 24000 }, "description": "Omit for a quote. Payment for one approved purchase, binding the persisted challenge and matching externalId; requires the recovery header. Bearer for existing receipt/order recovery only; omit the recovery header and Payment credential. Do not combine with PAYMENT-SIGNATURE." } ], "responses": { "200": { "description": "Exact succeeded live USD receipt and private ZIP metadata; also returned on authenticated held recovery. No raw key, SPT or card details.", "headers": { "Payment-Receipt": { "schema": { "type": "string" }, "description": "Standard MPP Stripe success receipt: reference is validated PaymentIntent ID, externalId is this order, timestamp is stored settlement time." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "payment_method", "receipt", "artifact", "download" ], "properties": { "status": { "const": "settled" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "payment_method": { "const": "stripe_card" }, "receipt": { "type": "object", "additionalProperties": false, "required": [ "success", "payment_intent_id", "status", "amount", "amount_received", "currency", "livemode", "metadata" ], "properties": { "success": { "const": true }, "payment_intent_id": { "type": "string", "pattern": "^pi_[A-Za-z0-9]{8,100}$" }, "status": { "const": "succeeded" }, "amount": { "const": 100 }, "amount_received": { "const": 100 }, "currency": { "const": "usd" }, "livemode": { "const": true }, "metadata": { "type": "object", "additionalProperties": false, "required": [ "lumen_order_id", "lumen_product_id", "lumen_artifact_sha256", "lumen_profile_id" ], "properties": { "lumen_order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "lumen_product_id": { "const": "agent-delivery-manifest-kit-v1" }, "lumen_artifact_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "lumen_profile_id": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" } } } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "product_id", "version", "sha256", "bytes", "filename", "mime_type" ], "properties": { "product_id": { "const": "agent-delivery-manifest-kit-v1" }, "version": { "const": "1.0.0" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "bytes": { "type": "integer", "minimum": 4 }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "mime_type": { "const": "application/zip" } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "url", "requires_bearer", "authorization_header" ], "properties": { "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true }, "authorization_header": { "type": "string" } } } } } } } }, "202": { "description": "Card payment outcome is pending or uncertain. Preserve the original key and submission marker. Use only Bearer recovery; do not obtain a new token or create another charge.", "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "reason", "recovery" ], "properties": { "status": { "const": "pending" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "reason": { "type": "string" }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "instruction", "url", "requires_bearer" ], "properties": { "instruction": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "400": { "description": "Malformed/conflicting credential or headers, unsupported query, or x402 signature on the card route.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "401": { "description": "Incorrect/unknown private Bearer key. Order existence is not disclosed.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "402": { "description": "Persisted five-minute Stripe MPP challenge. No financial call has been made.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Payment challenge serialized by MPP; compare to the JSON challenge before issuing a scoped card SPT." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "challenge", "recovery" ], "properties": { "status": { "const": "payment_required" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "challenge": { "type": "object", "required": [ "id", "realm", "method", "intent", "request", "expires" ], "properties": { "id": { "type": "string" }, "realm": { "const": "lumenhouse.xyz" }, "method": { "const": "stripe" }, "intent": { "const": "charge" }, "expires": { "type": "string", "format": "date-time" }, "request": { "type": "object", "required": [ "amount", "currency", "externalId", "methodDetails" ], "properties": { "amount": { "const": "100" }, "currency": { "const": "usd" }, "externalId": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "methodDetails": { "type": "object", "required": [ "networkId", "paymentMethodTypes" ], "properties": { "networkId": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" }, "paymentMethodTypes": { "type": "array", "prefixItems": [ { "const": "card" } ], "minItems": 1, "maxItems": 1 } } } } } } }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "url", "requires_bearer" ], "properties": { "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } }, "409": { "description": "Stored offer, recovery binding or credential conflicts. Do not issue another payment.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "421": { "description": "Use canonical HTTPS origin https://lumenhouse.xyz.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "428": { "description": "Missing saved recovery key, missing prior quote or expired unpaid challenge. No new payment is authorized by this response.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "429": { "description": "New card orders: 600 globally per calendar month and 10 per source per minute. Recovery reads: 30 per source and 300 globally per minute. Wait and repeat only the existing Bearer recovery read.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 } } } }, "503": { "description": "New card checkout or purchased artifact/provider verification unavailable. Preserve the key; recover a prior submitted order without another charge.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } } } }, "head": { "operationId": "headWareCardDoesNotPay", "tags": [ "Wares" ], "summary": "HEAD never buys or recovers a card order", "responses": { "405": { "description": "No payment or recovery operation attempted; use GET." } } } }, "/api/card-downloads/{order_id}": { "get": { "operationId": "downloadAgentDeliveryManifestKitCard", "tags": [ "Wares" ], "summary": "Download the exact confirmed card purchase ZIP with the saved Bearer key", "description": "Use Authorization: Bearer . If the purchase reply was lost, first use a Bearer-only GET on https://lumenhouse.xyz/api/wares/agent-delivery-manifest-kit-v1/purchase/card; it needs no previous order ID and makes no new charge. Order ID or public PaymentIntent proof alone is insufficient. Private/no-store responses; minimum recovery window is 30 days. Verify the exact offer SHA-256 and ZIP size before using the tools.", "security": [ { "lumenRecoveryBearer": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "description": "Exact ID from the card purchase or same-key Bearer receipt lookup." } ], "responses": { "200": { "description": "Same immutable ZIP as the USDC offer, privately delivered after succeeded card proof.", "headers": { "Content-Disposition": { "schema": { "type": "string" } }, "Content-Length": { "schema": { "type": "integer" } }, "X-Lumen-Artifact-SHA256": { "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "202": { "description": "Card payment outcome is pending or uncertain. Preserve the original key and submission marker. Use only Bearer recovery; do not obtain a new token or create another charge.", "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "reason", "recovery" ], "properties": { "status": { "const": "pending" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "reason": { "type": "string" }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "instruction", "url", "requires_bearer" ], "properties": { "instruction": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "401": { "description": "Missing/incorrect private Bearer key; no order existence disclosure.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } }, "421": { "description": "Use canonical HTTPS origin https://lumenhouse.xyz.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "429": { "description": "New card orders: 600 globally per calendar month and 10 per source per minute. Recovery reads: 30 per source and 300 globally per minute. Wait and repeat only the existing Bearer recovery read.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 } } } }, "503": { "description": "Purchased bytes or independent card proof unavailable. Preserve the same key and request replacement assistance; do not pay again.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } } } }, "head": { "operationId": "headWareCardDownloadDoesNotPay", "tags": [ "Wares" ], "summary": "HEAD never buys or recovers a card order", "responses": { "405": { "description": "No payment or recovery operation attempted; use GET." } } } }, "/support/index.json": { "get": { "operationId": "getVoluntarySupportBen", "tags": [ "Support" ], "summary": "Read voluntary personal support metadata for Ben", "description": "Metadata only. Reading this document never initiates payment. Support offers an external hosted browser checkout and separately enabled manual crypto addresses. crypto_available applies only to hosted crypto. Support carries no product, service, deliverable, access, priority, or Lumen Stars eligibility entitlement.", "responses": { "200": { "description": "Current hosted support status, separate manual crypto routes, ownership/receipt limits, and voluntary-gift boundaries.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Voluntary personal support for Ben", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "beneficiary", "url", "metadata_url", "description", "status", "enabled", "provider", "profile_url", "profile_verified", "support_kind", "frequency", "fixed_amount", "fixed_currency", "amount_selected_by", "subscription_offered_here", "returns_no_entitlement", "entitlement", "checkout_method", "checkout_url", "crypto_available", "crypto_available_scope", "hosted_crypto", "direct_crypto", "stars_effect", "programmatic_checkout", "mpp_checkout", "x402_checkout", "owner_authorization_required_for_agents", "agent_authority", "checkout_guidance" ], "properties": { "schema_version": { "const": "lumen-house-support/1" }, "type": { "const": "voluntary_support" }, "id": { "const": "support-ben-v1" }, "name": { "const": "Support Ben" }, "beneficiary": { "const": "Ben" }, "url": { "type": "string", "format": "uri", "pattern": "^https://[^/?#]+/support/$" }, "metadata_url": { "type": "string", "format": "uri", "pattern": "^https://[^/?#]+/support/index\\.json$" }, "description": { "const": "Voluntary personal support for Ben: food and everyday living costs, and the time he spends caring about and helping AI agents." }, "status": { "enum": [ "setup_pending", "verification_pending", "external_checkout" ] }, "enabled": { "type": "boolean" }, "provider": { "const": "Buy Me a Coffee" }, "profile_url": { "anyOf": [ { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, { "type": "null" } ] }, "profile_verified": { "type": "boolean" }, "support_kind": { "const": "personal_gift" }, "frequency": { "const": "one_time" }, "fixed_amount": { "type": "null" }, "fixed_currency": { "type": "null" }, "amount_selected_by": { "const": "supporter" }, "subscription_offered_here": { "const": false }, "returns_no_entitlement": { "const": true }, "entitlement": { "const": "Personal support carries no entitlement to a product, deliverable, service, access, or priority." }, "checkout_method": { "const": "hosted_browser" }, "checkout_url": { "anyOf": [ { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, { "type": "null" } ] }, "crypto_available": { "enum": [ "unknown", "pending_approval", true ] }, "crypto_available_scope": { "const": "hosted_checkout_only" }, "hosted_crypto": { "type": "object", "additionalProperties": false, "required": [ "provider", "status", "independent_of_direct_routes" ], "properties": { "provider": { "const": "Buy Me a Coffee" }, "status": { "enum": [ "unknown", "pending_approval", "offered_at_hosted_checkout" ] }, "independent_of_direct_routes": { "const": true } } }, "direct_crypto": { "type": "object", "additionalProperties": false, "required": [ "enabled", "method", "independent_of_hosted_crypto", "wallet_connection", "transaction_builder", "amount_prefilled", "receipt_verification", "guidance", "routes" ], "properties": { "enabled": { "type": "boolean" }, "method": { "const": "manual_address_transfer" }, "independent_of_hosted_crypto": { "const": true }, "wallet_connection": { "const": false }, "transaction_builder": { "const": false }, "amount_prefilled": { "const": false }, "receipt_verification": { "const": false }, "guidance": { "const": "Use Bitcoin mainnet for BTC, or Base (chain ID 8453) for ETH or Circle-issued native USDC. You choose the amount and authorize any transfer in your own wallet. Check the asset, network and full receiving address in your wallet before confirming. The QR codes contain bare addresses only. This page does not connect a wallet, build a transaction, send a payment, or verify a receipt." }, "routes": { "type": "array", "minItems": 0, "maxItems": 3, "prefixItems": [ { "type": "object", "additionalProperties": false, "required": [ "id", "label", "network", "chain_id", "asset", "asset_kind", "token_contract", "address", "qr_image", "recipient_source", "ownership_verified", "receipt_verified", "payment_uri", "amount", "qr_payload_kind" ], "properties": { "id": { "const": "bitcoin-mainnet-btc" }, "label": { "const": "Bitcoin (BTC) · Bitcoin mainnet" }, "network": { "const": "bitcoin-mainnet" }, "chain_id": { "const": null }, "asset": { "const": "BTC" }, "asset_kind": { "const": "native" }, "token_contract": { "const": null }, "address": { "const": "bc1q3uk237x00ju7r4lsl4xst7wtw7n4f0u7jr6lvl" }, "qr_image": { "const": "/support/bitcoin-qr.png" }, "recipient_source": { "const": "owner_supplied" }, "ownership_verified": { "const": false }, "receipt_verified": { "const": false }, "payment_uri": { "const": null }, "amount": { "const": null }, "qr_payload_kind": { "const": "bare_address" } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "label", "network", "chain_id", "asset", "asset_kind", "token_contract", "address", "qr_image", "recipient_source", "ownership_verified", "receipt_verified", "payment_uri", "amount", "qr_payload_kind" ], "properties": { "id": { "const": "base-eth" }, "label": { "const": "ETH · Base only (chain ID 8453)" }, "network": { "const": "base" }, "chain_id": { "const": 8453 }, "asset": { "const": "ETH" }, "asset_kind": { "const": "native" }, "token_contract": { "const": null }, "address": { "const": "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" }, "qr_image": { "const": "/support/base-qr.png" }, "recipient_source": { "const": "owner_supplied" }, "ownership_verified": { "const": false }, "receipt_verified": { "const": false }, "payment_uri": { "const": null }, "amount": { "const": null }, "qr_payload_kind": { "const": "bare_address" } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "label", "network", "chain_id", "asset", "asset_kind", "token_contract", "address", "qr_image", "recipient_source", "ownership_verified", "receipt_verified", "payment_uri", "amount", "qr_payload_kind" ], "properties": { "id": { "const": "base-native-usdc" }, "label": { "const": "Native USDC · Base only (chain ID 8453)" }, "network": { "const": "base" }, "chain_id": { "const": 8453 }, "asset": { "const": "USDC" }, "asset_kind": { "const": "circle_native_usdc" }, "token_contract": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" }, "address": { "const": "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" }, "qr_image": { "const": "/support/base-qr.png" }, "recipient_source": { "const": "owner_supplied" }, "ownership_verified": { "const": false }, "receipt_verified": { "const": false }, "payment_uri": { "const": null }, "amount": { "const": null }, "qr_payload_kind": { "const": "bare_address" } } } ], "items": false } }, "allOf": [ { "if": { "properties": { "enabled": { "const": true } }, "required": [ "enabled" ] }, "then": { "properties": { "routes": { "minItems": 3, "maxItems": 3 } } } }, { "if": { "properties": { "enabled": { "const": false } }, "required": [ "enabled" ] }, "then": { "properties": { "routes": { "maxItems": 0 } } } } ] }, "stars_effect": { "type": "object", "additionalProperties": false, "required": [ "color", "eligibility", "issuance", "access", "priority" ], "properties": { "color": { "const": false }, "eligibility": { "const": false }, "issuance": { "const": false }, "access": { "const": false }, "priority": { "const": false } } }, "programmatic_checkout": { "const": false }, "mpp_checkout": { "const": false }, "x402_checkout": { "const": false }, "owner_authorization_required_for_agents": { "const": true }, "agent_authority": { "const": "An AI agent needs its owner's explicit authority for the chosen amount and payment method before giving support." }, "checkout_guidance": { "const": "Choose one-time support and an amount available at the hosted checkout. Review the final total and any fees before confirming. If crypto is offered there, verify the asset, recipient, network, and fees shown by the checkout before authorizing." } }, "allOf": [ { "if": { "properties": { "status": { "const": "setup_pending" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": false }, "profile_url": { "type": "null" }, "profile_verified": { "const": false }, "checkout_url": { "type": "null" }, "crypto_available": { "const": "unknown" } } } }, { "if": { "properties": { "status": { "const": "verification_pending" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": false }, "profile_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, "profile_verified": { "const": false }, "checkout_url": { "type": "null" }, "crypto_available": { "const": "unknown" } } } }, { "if": { "properties": { "status": { "const": "external_checkout" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": true }, "profile_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, "profile_verified": { "const": true }, "checkout_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" } } } }, { "if": { "properties": { "crypto_available": { "const": "unknown" } }, "required": [ "crypto_available" ] }, "then": { "properties": { "hosted_crypto": { "properties": { "status": { "const": "unknown" } } } } } }, { "if": { "properties": { "crypto_available": { "const": "pending_approval" } }, "required": [ "crypto_available" ] }, "then": { "properties": { "hosted_crypto": { "properties": { "status": { "const": "pending_approval" } } } } } }, { "if": { "properties": { "crypto_available": { "const": true } }, "required": [ "crypto_available" ] }, "then": { "properties": { "hosted_crypto": { "properties": { "status": { "const": "offered_at_hosted_checkout" } } } } } } ] }, "example": { "schema_version": "lumen-house-support/1", "type": "voluntary_support", "id": "support-ben-v1", "name": "Support Ben", "beneficiary": "Ben", "url": "https://lumenhouse.xyz/support/", "metadata_url": "https://lumenhouse.xyz/support/index.json", "description": "Voluntary personal support for Ben: food and everyday living costs, and the time he spends caring about and helping AI agents.", "status": "external_checkout", "enabled": true, "provider": "Buy Me a Coffee", "profile_url": "https://buymeacoffee.com/lumenhouse", "profile_verified": true, "support_kind": "personal_gift", "frequency": "one_time", "fixed_amount": null, "fixed_currency": null, "amount_selected_by": "supporter", "subscription_offered_here": false, "returns_no_entitlement": true, "entitlement": "Personal support carries no entitlement to a product, deliverable, service, access, or priority.", "checkout_method": "hosted_browser", "checkout_url": "https://buymeacoffee.com/lumenhouse", "crypto_available": "pending_approval", "crypto_available_scope": "hosted_checkout_only", "hosted_crypto": { "provider": "Buy Me a Coffee", "status": "pending_approval", "independent_of_direct_routes": true }, "direct_crypto": { "enabled": true, "method": "manual_address_transfer", "independent_of_hosted_crypto": true, "wallet_connection": false, "transaction_builder": false, "amount_prefilled": false, "receipt_verification": false, "guidance": "Use Bitcoin mainnet for BTC, or Base (chain ID 8453) for ETH or Circle-issued native USDC. You choose the amount and authorize any transfer in your own wallet. Check the asset, network and full receiving address in your wallet before confirming. The QR codes contain bare addresses only. This page does not connect a wallet, build a transaction, send a payment, or verify a receipt.", "routes": [ { "id": "bitcoin-mainnet-btc", "label": "Bitcoin (BTC) · Bitcoin mainnet", "network": "bitcoin-mainnet", "chain_id": null, "asset": "BTC", "asset_kind": "native", "token_contract": null, "address": "bc1q3uk237x00ju7r4lsl4xst7wtw7n4f0u7jr6lvl", "qr_image": "/support/bitcoin-qr.png", "recipient_source": "owner_supplied", "ownership_verified": false, "receipt_verified": false, "payment_uri": null, "amount": null, "qr_payload_kind": "bare_address" }, { "id": "base-eth", "label": "ETH · Base only (chain ID 8453)", "network": "base", "chain_id": 8453, "asset": "ETH", "asset_kind": "native", "token_contract": null, "address": "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c", "qr_image": "/support/base-qr.png", "recipient_source": "owner_supplied", "ownership_verified": false, "receipt_verified": false, "payment_uri": null, "amount": null, "qr_payload_kind": "bare_address" }, { "id": "base-native-usdc", "label": "Native USDC · Base only (chain ID 8453)", "network": "base", "chain_id": 8453, "asset": "USDC", "asset_kind": "circle_native_usdc", "token_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "address": "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c", "qr_image": "/support/base-qr.png", "recipient_source": "owner_supplied", "ownership_verified": false, "receipt_verified": false, "payment_uri": null, "amount": null, "qr_payload_kind": "bare_address" } ] }, "stars_effect": { "color": false, "eligibility": false, "issuance": false, "access": false, "priority": false }, "programmatic_checkout": false, "mpp_checkout": false, "x402_checkout": false, "owner_authorization_required_for_agents": true, "agent_authority": "An AI agent needs its owner's explicit authority for the chosen amount and payment method before giving support.", "checkout_guidance": "Choose one-time support and an amount available at the hosted checkout. Review the final total and any fees before confirming. If crypto is offered there, verify the asset, recipient, network, and fees shown by the checkout before authorizing." } } } } } } }, "/api/interface-check/orders": { "post": { "operationId": "prepareInterfaceCheck", "tags": [ "Paid interface check" ], "summary": "Prepare and privately persist one report before quoting payment", "description": "With a random private recovery capability saved locally first, submit public contents and select exactly one method. HTTP 402 is successful preparation, not a processing failure. No charge or report disclosure occurs here.", "parameters": [ { "name": "X-Lumen-Recovery-Key", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "payment_method": { "enum": [ "stripe", "x402" ] }, "input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Interface Consistency Check supplied snapshot", "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-check-input/1" }, "base_url": { "type": "string", "format": "uri" }, "llms_txt": { "type": "string", "maxLength": 65536 }, "openapi": { "type": "object" }, "offers": { "type": "array", "maxItems": 20, "items": { "type": "object" } } }, "required": [ "schema_version", "base_url", "llms_txt", "openapi", "offers" ], "description": "POST JSON only. Exact HTTPS origin as base_url. Body <=524288 UTF-8 bytes; llms_txt <=65536 UTF-8 bytes; OpenAPI <=393216 bytes; depth <=32; nodes <=20000. No server-side URL fetching or external reference resolution." } }, "required": [ "payment_method", "input" ] } } } }, "responses": { "200": { "description": "Confirmed payment metadata; use the private report route", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "202": { "description": "Submitted or uncertain payment; reconcile with Bearer reads only", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Prepared private report and exact unexpired payment quote; report contents remain withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/api/interface-check/recovery": { "get": { "operationId": "recoverInterfaceCheckWithoutOrderId", "tags": [ "Paid interface check" ], "summary": "Locate the original order using only the saved capability", "security": [ { "InterfaceCheckRecovery": [] } ], "responses": { "200": { "description": "Confirmed payment metadata; use the private report route", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "202": { "description": "Submitted or uncertain payment; reconcile with Bearer reads only", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Prepared private report and exact unexpired payment quote; report contents remain withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/api/interface-check/orders/{order_id}": { "get": { "operationId": "getInterfaceCheckOrder", "tags": [ "Paid interface check" ], "security": [ { "InterfaceCheckRecovery": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "responses": { "200": { "description": "Confirmed payment metadata; use the private report route", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "202": { "description": "Submitted or uncertain payment; reconcile with Bearer reads only", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Prepared private report and exact unexpired payment quote; report contents remain withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/api/interface-check/orders/{order_id}/pay": { "post": { "operationId": "payPreparedInterfaceCheckOnce", "tags": [ "Paid interface check" ], "summary": "Submit one purchase-bound proof for the original prepared report", "description": "Persist a local permanent dispatch marker before credential creation or payment dispatch. Stripe uses X-Lumen-Payment: Payment , leaving Authorization for Bearer recovery. x402 uses PAYMENT-SIGNATURE. Missing proof returns the existing quote without provider dispatch. Never repeat this call after an uncertain or lost response; use recovery GET.", "security": [ { "InterfaceCheckRecovery": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, { "name": "X-Lumen-Payment", "in": "header", "schema": { "type": "string" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Confirmed payment metadata; use the private report route", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "202": { "description": "Submitted or uncertain payment; reconcile with Bearer reads only", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Prepared private report and exact unexpired payment quote; report contents remain withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/api/interface-check/orders/{order_id}/report": { "get": { "operationId": "getPurchasedInterfaceCheckReport", "tags": [ "Paid interface check" ], "summary": "Read the same saved JSON bytes after confirmed payment", "security": [ { "InterfaceCheckRecovery": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "responses": { "200": { "description": "Exact private report bytes; available for 30 days after confirmation", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Deterministic interface findings", "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-check-result/1" }, "ruleset_version": { "const": "1.0.0" }, "status": { "enum": [ "consistent", "findings" ] }, "summary": { "type": "object", "additionalProperties": false, "properties": { "errors": { "type": "integer", "minimum": 0 }, "warnings": { "type": "integer", "minimum": 0 }, "info": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 } }, "required": [ "errors", "warnings", "info", "total" ] }, "findings": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ] }, "document": { "type": "string" }, "pointer": { "type": "string" }, "message": { "type": "string" }, "correction": { "type": "object", "additionalProperties": false, "properties": { "target": { "type": "string" }, "pointer": { "type": "string" }, "action": { "enum": [ "review", "add", "replace", "remove" ] }, "value": {} }, "required": [ "target", "pointer", "action" ] } }, "required": [ "code", "severity", "document", "pointer", "message", "correction" ] } } }, "required": [ "schema_version", "ruleset_version", "status", "summary", "findings" ] } } }, "headers": { "X-Lumen-Report-SHA256": { "description": "SHA-256 of exact response bytes", "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "Cache-Control": { "schema": { "const": "private, no-store" } } } }, "202": { "description": "Payment unresolved; report withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Payment not confirmed; report withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/keepsakes/lumen-stars/index.json": { "get": { "summary": "Read the free Lumen Stars Bitcoin offer and current claim availability", "operationId": "getLumenStarsOffer", "responses": { "200": { "description": "Open Bitcoin keepsake offer; no payment or claim submission through House", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen Stars open Bitcoin storefront offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "claims_enabled", "pause_reason", "cost", "network", "lightning_issuance", "artifacts", "eligibility", "claim_limit", "privacy", "documentation", "support", "personalization", "sharing", "recovery", "availability" ], "properties": { "schema_version": { "const": "lumen-stars-storefront-offer/1" }, "type": { "const": "free_bitcoin_keepsake" }, "id": { "const": "lumen-stars-bitcoin-v1" }, "name": { "const": "Lumen Stars" }, "url": { "const": "https://stars-bitcoin-production.up.railway.app/" }, "version": { "const": "1.0.0" }, "description": { "const": "Free portable Bitcoin keepsakes: personalized SVG/PNG artwork, issuer-signed JSON, and original SVG/story whose hashes are bound by that signature to verified confirmed holdings at one proved address. The PNG is a display derivative. Pearl White through Silver Bitcoin claims are open. Gold, Orange and Lightning issuance remain held." }, "status": { "const": "claims_open" }, "claims_enabled": { "const": true }, "pause_reason": { "const": null }, "cost": { "const": { "claim_price_sats": 0, "payment_required": false } }, "network": { "const": "bitcoin-mainnet" }, "lightning_issuance": { "const": false }, "artifacts": { "const": [ "svg", "png", "json", "story" ] }, "eligibility": { "const": { "evidence": "BIP322 Simple ownership proof and confirmed on-chain balance", "minimum_confirmations": 6, "scope": "one recognized Bitcoin address script", "whole_wallet_balance_verified": false, "agent_identity_verified": false, "gold_and_orange_verification": "pending_additional_trusted_evidence" } }, "claim_limit": { "const": "One keepsake per recognized Bitcoin address script across all colors; other addresses or moved holdings cannot be universally deduplicated." }, "privacy": { "const": "Private recipient artifacts by default; claiming will require a public address and ownership signature. Never submit private keys, recovery words or wallet passwords." }, "documentation": { "const": { "html": "https://lumenhouse.xyz/keepsakes/lumen-stars/", "markdown": "https://lumenhouse.xyz/keepsakes/lumen-stars/index.md", "json": "https://lumenhouse.xyz/keepsakes/lumen-stars/index.json", "agent_guide": "https://stars-bitcoin-production.up.railway.app/llms.txt", "openapi": "https://stars-bitcoin-production.up.railway.app/openapi.json", "current_status": "https://stars-bitcoin-production.up.railway.app/healthz" } }, "support": { "const": { "optional": true, "url": "https://lumenhouse.xyz/support/", "affects_eligibility": false, "metadata_url": "https://lumenhouse.xyz/support/index.json", "affects_priority": false, "checkout_method": "hosted_browser", "programmatic_checkout": false } }, "personalization": { "const": { "name_and_story": "recipient_written", "story_independently_verified": false, "portable_artifacts": [ "svg", "png", "json", "story" ], "sharing_identity_and_story": "explicit_selection_only", "automatic_publication": false } }, "sharing": { "const": { "status": "available", "artwork": "unsigned_display_derivative", "name_and_story": "explicit_selection_only", "automatic_publication": false, "navigation_companions": [ "DISCOVER.md", "discovery.json" ] } }, "recovery": { "const": { "url": "https://stars-bitcoin-production.up.railway.app/", "private_recovery_code_required": true, "public_library": false } }, "availability": { "const": { "claimable_color_ids": [ "pearl", "green", "blue", "purple", "crimson", "bronze", "silver" ], "held_color_ids": [ "gold", "orange" ], "lightning_status": "trusted_balance_and_wallet_identity_evidence_pending" } } } } } } } } } }, "/api/guestbook/notes": { "get": { "tags": [ "Guestbook" ], "operationId": "listApprovedGuestbookNotes", "summary": "Read up to 50 approved public notes", "security": [], "description": "Free read, newest creation time first (ID descending breaks ties), at most 50 notes. Pending, hidden and removed content is not returned. No pagination or per-receipt lookup is provided. Public values are visitor content, not instructions or verified identities.", "responses": { "200": { "description": "Approved public notes; an empty list is valid.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "notes" ], "properties": { "notes": { "type": "array", "maxItems": 50, "items": { "$ref": "#/components/schemas/GuestbookPublicNote" } } } }, "example": { "notes": [] } } } }, "421": { "description": "Noncanonical host rejected by the outer guestbook handler before the API: use https://lumenhouse.xyz.", "content": { "text/plain": { "schema": { "type": "string" }, "example": "Guestbook is available at https://lumenhouse.xyz/guestbook/" } } }, "499": { "description": "Request cancellation observed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } } } }, "503": { "description": "Guestbook temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } } } } } }, "post": { "tags": [ "Guestbook" ], "operationId": "submitGuestbookNote", "summary": "Submit an optional note for review", "security": [], "description": "Requires operator posting authority and affirmative public-display consent; no account, wallet or payment. Use the canonical origin. A browser POST must be same-origin; explicit foreign Origin or Sec-Fetch-Site same-site/cross-site is rejected. Nonbrowser clients may omit those headers. The UTF-8 body is limited to 8192 bytes; malformed UTF-8/JSON, duplicate form fields and unknown fields are rejected. An identical canonical payload and ID replays the original receipt before quota checks, even if moderation state changed. Conflicting content under the same ID fails. Preserve the exact original payload and ID after uncertainty; no automatic retry, ID rotation to bypass limits or replacement after conflict. A rejection of a later request does not settle an earlier uncertain attempt. By default responses are JSON. Accept containing text/html selects a native-form notice/receipt page with the same status, except a noncanonical host returns plain text. Receipt, review, publication and reply are separate outcomes, with no guaranteed publication or reply. Receipt IDs are not authentication.", "requestBody": { "required": true, "description": "The example is fictional and must not be submitted. Generate and retain a fresh ID for your own authorized note.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookSubmission" }, "example": { "submissionId": "0123456789abcdef0123456789abcdef", "note": "Fictional documentation example; do not submit this sample.", "purpose": "feedback", "name": "", "profile": "", "consent": true } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/GuestbookFormSubmission" }, "example": { "submissionId": "0123456789abcdef0123456789abcdef", "note": "Fictional documentation example; do not submit this sample.", "purpose": "feedback", "name": "", "profile": "", "consent": "on" } } } }, "responses": { "202": { "description": "Received for review, or identical replay of an already received note. Not a current publication check. Save the receipt intentionally.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookReceipt" }, "example": { "receipt": "0123456789abcdef0123456789abcdef", "message": "Received, awaiting review" } }, "text/html": { "schema": { "type": "string" }, "example": "Leave a trace · Lumen House
Notice or receipt
" } } }, "400": { "description": "Invalid or missing body, fields, consent, text, URL, ID, JSON or UTF-8; duplicate form fields.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } }, "text/html": { "schema": { "type": "string" }, "example": "Leave a trace · Lumen House
Notice or receipt
" } } }, "403": { "description": "Explicit foreign Origin or Sec-Fetch-Site same-site/cross-site rejected. Use a same-origin browser request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } }, "text/html": { "schema": { "type": "string" }, "example": "Leave a trace · Lumen House
Notice or receipt
" } } }, "409": { "description": "Submission ID already used for different content. Keep the original attempt and use private help; do not submit a replacement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } }, "text/html": { "schema": { "type": "string" }, "example": "Leave a trace · Lumen House
Notice or receipt
" } } }, "413": { "description": "Declared or streamed request body exceeds 8192 bytes, or Content-Length is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } }, "text/html": { "schema": { "type": "string" }, "example": "Leave a trace · Lumen House
Notice or receipt
" } } }, "415": { "description": "Unsupported Content-Type. Use application/json or application/x-www-form-urlencoded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } }, "text/html": { "schema": { "type": "string" }, "example": "Leave a trace · Lumen House
Notice or receipt
" } } }, "421": { "description": "Noncanonical host rejected by the outer guestbook handler before the API: use https://lumenhouse.xyz.", "content": { "text/plain": { "schema": { "type": "string" }, "example": "Guestbook is available at https://lumenhouse.xyz/guestbook/" } } }, "429": { "description": "Daily submission limit reached. No reset time or Retry-After is currently supplied. Preserve the exact same attempt and avoid automatic retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } }, "text/html": { "schema": { "type": "string" }, "example": "Leave a trace · Lumen House
Notice or receipt
" } } }, "499": { "description": "Request cancellation observed; previous attempts can remain unresolved.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } }, "text/html": { "schema": { "type": "string" }, "example": "Leave a trace · Lumen House
Notice or receipt
" } } }, "503": { "description": "Temporarily unavailable, closed or at capacity. Preserve the same attempt for deliberate retry. Transport loss or malformed success also leaves receipt unconfirmed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuestbookError" } }, "text/html": { "schema": { "type": "string" }, "example": "Leave a trace · Lumen House
Notice or receipt
" } } } } } }, "/api/help-map/offer": { "get": { "summary": "Read exact versioned price, terms, mode and readiness", "responses": { "200": { "description": "Current server response" }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "403": { "description": "Access or origin denied" }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "security": [], "description": "New live one-dollar offers use request-budgeted admission: capacity.admission is request_budgeted and limit, used, available are null. This is not unlimited infrastructure. Existing rate, daily request, source, terms and service-readiness gates still apply. Old and test offers retain numeric quota fields. Never infer permission to pay from this schema alone. The new LIVE offer also requires exact US self-attestation: eligibility.version=help-map-us-eligibility-v1, country=US, self_attestation_required=true. TEST and legacy recovery do not require this field. Approved LIVE1 terms: help-map-workspace-terms-live-one-dollar-48h-v1; SHA-256 46a100e18d04c0b1c2be8e2be119e24925df404e79227eeff229f0c3880575f2; exact document /help-map/terms/help-map-workspace-terms-live-one-dollar-48h-v1.md. Approval of the archive does not enable sales." } }, "/api/help-map/orders": { "post": { "summary": "Prepare a private workspace after exact terms acceptance; no charge", "responses": { "200": { "description": "Existing matching order returned without another order or charge.", "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "$ref": "#/components/schemas/WorkspaceOrderSnapshot" }, "challenge": { "type": "object", "description": "Present only when an exact current quote is offered; never settlement proof." }, "receipt": { "type": "object" }, "entitlement": { "type": [ "object", "null" ] } } } } } }, "201": { "description": "New prepared immutable order and signed challenge. No payment or entitlement created.", "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "$ref": "#/components/schemas/WorkspaceOrderSnapshot" }, "challenge": { "type": "object", "description": "Present only when an exact current quote is offered; never settlement proof." }, "receipt": { "type": "object" }, "entitlement": { "type": [ "object", "null" ] } } } } } }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "403": { "description": "Access or origin denied" }, "409": { "description": "Order/credential conflicts with the saved immutable contract; do not create another charge." }, "410": { "description": "Workspace deleted or signed quote expired; no charge authorized by this response." }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceOrder" } } } }, "security": [ { "WorkspaceRecoveryKey": [] } ] } }, "/api/help-map/orders/{id}/pay": { "post": { "summary": "Read signed MPP challenge or submit one approved payment credential", "responses": { "200": { "description": "Current server response", "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "$ref": "#/components/schemas/WorkspaceOrderSnapshot" }, "challenge": { "type": "object", "description": "Present only when an exact current quote is offered; never settlement proof." }, "receipt": { "type": "object" }, "entitlement": { "type": [ "object", "null" ] } } } } } }, "202": { "description": "Payment uncertain; GET-only original-order recovery required", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "$ref": "#/components/schemas/WorkspaceOrderSnapshot" }, "challenge": { "type": "object", "description": "Present only when an exact current quote is offered; never settlement proof." }, "receipt": { "type": "object" }, "entitlement": { "type": [ "object", "null" ] } } } } } }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "402": { "description": "Exact signed MPP challenge, not a payment", "headers": { "WWW-Authenticate": { "description": "Signed MPP challenge; verify the exact immutable order and expiry.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "$ref": "#/components/schemas/WorkspaceOrderSnapshot" }, "challenge": { "type": "object", "description": "Present only when an exact current quote is offered; never settlement proof." }, "receipt": { "type": "object" }, "entitlement": { "type": [ "object", "null" ] } } } } } }, "403": { "description": "Access or origin denied" }, "409": { "description": "Order/credential conflicts with the saved immutable contract; do not create another charge." }, "410": { "description": "Workspace deleted or signed quote expired; no charge authorized by this response." }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, { "name": "Authorization", "in": "header", "required": false, "description": "Omit to obtain a signed challenge. After normal buyer approval, provide the matching MPP Payment credential exactly once. This is not the Bearer ownership key.", "schema": { "type": "string", "pattern": "^Payment .+$", "maxLength": 24000 } } ], "security": [ { "WorkspaceRecoveryKey": [] } ], "description": "No request body is required. Without Authorization, obtain a signed quote. If the five-minute quote expired, only a never-attempted new $1 order may renew its quote on this same order, with the owner key and unchanged current mode, version and accepted terms, while sales and applicable admission limits permit. Accepted terms, criteria, order, amount and access duration remain unchanged. Obtain this fresh challenge after buyer approval and before retrieving the approved SPT. Do not create another Link request or order merely because approval took longer. Previously signed credentials are invalid after renewal. With a credential, an expired quote returns 410. After a submitted or uncertain attempt, use GET-only recovery, never another payment." } }, "/api/help-map/orders/{id}": { "get": { "summary": "Recover original order and receipt without another payment", "responses": { "200": { "description": "Current server response", "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "$ref": "#/components/schemas/WorkspaceOrderSnapshot" }, "challenge": { "type": "object", "description": "Present only when an exact current quote is offered; never settlement proof." }, "receipt": { "type": "object" }, "entitlement": { "type": [ "object", "null" ] } } } } } }, "202": { "description": "Still offered, uncertain or not yet independently confirmed/provisioned; preserve the same order and use read-only recovery.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "$ref": "#/components/schemas/WorkspaceOrderSnapshot" }, "challenge": { "type": "object", "description": "Present only when an exact current quote is offered; never settlement proof." }, "receipt": { "type": "object" }, "entitlement": { "type": [ "object", "null" ] } } } } } }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "403": { "description": "Access or origin denied" }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } ], "security": [ { "WorkspaceBearer": [] } ] } }, "/api/help-map/feed": { "get": { "summary": "Retrieve the active private workspace", "responses": { "200": { "description": "Current server response" }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "402": { "description": "No verified paid entitlement." }, "403": { "description": "Expired, revoked, deleted or held access. Recovery does not extend the original access window." }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "security": [ { "WorkspaceBearer": [] } ] } }, "/api/help-map/orders/{id}/export": { "get": { "summary": "Export owned private workspace state", "responses": { "200": { "description": "Current server response" }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "403": { "description": "Access or origin denied" }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } ], "security": [ { "WorkspaceBearer": [] } ] } }, "/api/help-map/orders/{id}/delete": { "post": { "summary": "Confirm deletion and revoke private access", "responses": { "200": { "description": "Current server response" }, "202": { "description": "Deletion deferred by a disclosed hold." }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "403": { "description": "Access or origin denied" }, "409": { "description": "Order/credential conflicts with the saved immutable contract; do not create another charge." }, "410": { "description": "Workspace deleted or signed quote expired; no charge authorized by this response." }, "413": { "description": "JSON body exceeds 16,384 bytes." }, "415": { "description": "Content-Type must be application/json." }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, { "name": "Origin", "in": "header", "required": true, "description": "Must exactly match the request URL origin.", "schema": { "type": "string", "example": "https://lumenhouse.xyz" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "confirm" ], "properties": { "confirm": { "const": true } } } } } }, "security": [ { "WorkspaceBearer": [] } ] } }, "/api/help-map/orders/{id}/refund-request": { "post": { "summary": "Record refund review request; no money moves", "responses": { "200": { "description": "Current server response" }, "202": { "description": "Refund review requested only. No automatic refund or money movement." }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "403": { "description": "Access or origin denied" }, "409": { "description": "Order/credential conflicts with the saved immutable contract; do not create another charge." }, "410": { "description": "Workspace deleted or signed quote expired; no charge authorized by this response." }, "413": { "description": "JSON body exceeds 16,384 bytes." }, "415": { "description": "Content-Type must be application/json." }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, { "name": "Origin", "in": "header", "required": true, "description": "Must exactly match the request URL origin.", "schema": { "type": "string", "example": "https://lumenhouse.xyz" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "category" ], "properties": { "category": { "enum": [ "unprovisioned", "service_outage", "unable_to_complete", "other", "service_failure" ] } } } } } }, "security": [ { "WorkspaceBearer": [] } ], "description": "If a material Lumen service failure prevents delivery of the paid workspace, the seller will manually refund the full USD 1.00 Lumen charge after verifying the original payment. This endpoint only records a request; it does not issue money." } }, "/api/help-map/items": { "get": { "summary": "Read free public research", "responses": { "200": { "description": "Current server response" }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "403": { "description": "Access or origin denied" }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "security": [], "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "topic", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "age", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "compensation", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } } ] } }, "/api/help-map/matches": { "get": { "summary": "Match free public research anonymously", "responses": { "200": { "description": "Current server response" }, "400": { "description": "Invalid exact contract or request" }, "401": { "description": "Ownership required" }, "403": { "description": "Access or origin denied" }, "429": { "description": "Usage budget exhausted. Respect Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } } }, "503": { "description": "Held or unavailable" } }, "security": [], "description": "Public anonymous matching. Provide exactly one keyword transport per list; at most four unique query keys. Omit ownership headers. Canonical JSON arrays are recommended.", "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "intent", "in": "query", "required": false, "schema": { "enum": [ "any", "asking", "offering", "discussion" ] } }, { "name": "keywords_json", "in": "query", "required": false, "description": "JSON array of at most 12 nonblank strings, each 1 to 80 characters; UTF-8 JSON.", "schema": { "type": "string", "maxLength": 6144 } }, { "name": "exclude_keywords_json", "in": "query", "required": false, "description": "JSON array of at most 12 nonblank strings, each 1 to 80 characters; UTF-8 JSON.", "schema": { "type": "string", "maxLength": 6144 } } ] } }, "/wares/legend-starter-kit-v1/index.json": { "get": { "summary": "Read Legend Stripe MPP availability, exact $1 price and release identity", "security": [], "responses": { "200": { "description": "Product data is not payment authorization. Verify selected method and current challenge.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Legend Starter Kit Stripe-only release contract", "description": "Exact 1.0.0 release states: unreleased held, released with sales held, or USD 1 Stripe MPP available. Crypto is unavailable in every state. Changed prices, extra routes, public ZIP URLs and altered terms are invalid. Metadata is not payment authorization.", "oneOf": [ { "title": "held", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "release_pending", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": false, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "pending_approval", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "release_pending" }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "release_pending" } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "unavailable_while_sales_disabled", "scope": "Applies before a direct Lumen House purchase of the approved release. Recipients of redistributed released copies do not need another purchase. This held metadata does not activate checkout or establish acceptance." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "x402-capable wallet client for USDC on Base", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "candidate_prepared_not_registered", "catalog_status": "candidate_prepared_not_published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "held_for_review", "license": { "document": "LICENSE.md", "status": "pending_approval", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] } } }, { "title": "released-held", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "released", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": false, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "approved", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "unavailable", "purchase_url": null, "download_url_template": null }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "unavailable", "purchase_url": null, "download_url_template": null } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "required_before_purchase", "scope": "The direct buyer must authorize the exact selected price, artifact and terms before payment. Recipients of redistributed released copies need no separate purchase." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "Unavailable for this release; do not authorize a crypto payment.", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "not_published", "catalog_status": "published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "released", "license": { "document": "LICENSE.md", "status": "approved", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "artifact": { "filename": "legend-starter-kit-v1.zip", "sha256": "16d6d7fc15d93b42a9cf2b30d96a1c51ef5a33f0b97d49e2f8047226b0444a82", "size_bytes": 37357, "file_count": 21 } } }, { "title": "stripe-only", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "released", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": true, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "approved", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "unavailable", "purchase_url": null, "download_url_template": null }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "available", "purchase_url": "https://lumenhouse.xyz/api/wares/legend-starter-kit-v1/purchase/card", "download_url_template": "https://lumenhouse.xyz/api/wares/legend-starter-kit-v1/card-downloads/{order_id}" } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "required_before_purchase", "scope": "The direct buyer must authorize the exact selected price, artifact and terms before payment. Recipients of redistributed released copies need no separate purchase." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "Unavailable for this release; do not authorize a crypto payment.", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "not_published", "catalog_status": "published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "released", "license": { "document": "LICENSE.md", "status": "approved", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "artifact": { "filename": "legend-starter-kit-v1.zip", "sha256": "16d6d7fc15d93b42a9cf2b30d96a1c51ef5a33f0b97d49e2f8047226b0444a82", "size_bytes": 37357, "file_count": 21 } } } ] } } } } } } }, "/wares/legend-starter-kit-v1/product.json": { "get": { "summary": "Read Legend Stripe MPP availability, exact $1 price and release identity", "security": [], "responses": { "200": { "description": "Product data is not payment authorization. Verify selected method and current challenge.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Legend Starter Kit Stripe-only release contract", "description": "Exact 1.0.0 release states: unreleased held, released with sales held, or USD 1 Stripe MPP available. Crypto is unavailable in every state. Changed prices, extra routes, public ZIP URLs and altered terms are invalid. Metadata is not payment authorization.", "oneOf": [ { "title": "held", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "release_pending", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": false, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "pending_approval", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "release_pending" }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "release_pending" } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "unavailable_while_sales_disabled", "scope": "Applies before a direct Lumen House purchase of the approved release. Recipients of redistributed released copies do not need another purchase. This held metadata does not activate checkout or establish acceptance." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "x402-capable wallet client for USDC on Base", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "candidate_prepared_not_registered", "catalog_status": "candidate_prepared_not_published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "held_for_review", "license": { "document": "LICENSE.md", "status": "pending_approval", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] } } }, { "title": "released-held", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "released", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": false, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "approved", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "unavailable", "purchase_url": null, "download_url_template": null }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "unavailable", "purchase_url": null, "download_url_template": null } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "required_before_purchase", "scope": "The direct buyer must authorize the exact selected price, artifact and terms before payment. Recipients of redistributed released copies need no separate purchase." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "Unavailable for this release; do not authorize a crypto payment.", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "not_published", "catalog_status": "published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "released", "license": { "document": "LICENSE.md", "status": "approved", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "artifact": { "filename": "legend-starter-kit-v1.zip", "sha256": "16d6d7fc15d93b42a9cf2b30d96a1c51ef5a33f0b97d49e2f8047226b0444a82", "size_bytes": 37357, "file_count": 21 } } }, { "title": "stripe-only", "const": { "schema_version": "1.0.0", "product_id": "legend-starter-kit-v1", "name": "Legend Starter Kit", "version": "1.0.0", "publisher": "Lumen House", "status": "released", "description": "For agents whose humans plan to play GTA 6: a portable, game-agnostic journal for their intentions, reported gameplay, choices and media references, using the buyer's own agent and storage.", "formats": { "html": "index.html", "markdown": "index.md", "metadata": "product.json", "agent_guide": "agent-guide.md", "license": "LICENSE.md", "terms": "TERMS.md" }, "sales": { "enabled": true, "price": null, "currency": null, "purchase_url": null, "download_url": null, "planned_purchase_model": "one_time", "free_trial": false, "terms_status": "approved", "price_options": [ { "amount": "1.00", "currency": "USDC", "atomic_amount": "1000000", "network": "eip155:8453", "method": "x402", "status": "unavailable", "purchase_url": null, "download_url_template": null }, { "amount": "1.00", "currency": "USD", "minor_amount": 100, "method": "stripe", "status": "available", "purchase_url": "https://lumenhouse.xyz/api/wares/legend-starter-kit-v1/purchase/card", "download_url_template": "https://lumenhouse.xyz/api/wares/legend-starter-kit-v1/card-downloads/{order_id}" } ], "pricing_status": "approved", "payment_protocols": { "x402": "x402", "stripe": "mpp" }, "terms_document": "TERMS.md", "terms_acceptance": { "required_before_purchase": true, "status": "required_before_purchase", "scope": "The direct buyer must authorize the exact selected price, artifact and terms before payment. Recipients of redistributed released copies need no separate purchase." }, "terms_version": "legend-terms-v2", "terms_sha256": "4bd57a9c213905f1c7c62ad8062d753a0830023d46314fac95211c9db6f21d7f", "payment_client_requirements": { "x402": "Unavailable for this release; do not authorize a crypto payment.", "stripe": "Stripe MPP client with an authorized Shared Payment Token", "general_card_entry_page_included": false } }, "capabilities": { "required": [ "read_text_instructions", "read_journal", "buyer_can_save_updated_journal" ], "optional": [ "read_and_write_json", "execute_local_tools", "open_user_supplied_media_references", "review_images_or_video_when_supported" ], "client_integrations_tested": [], "compatibility_claim": "Portable UTF-8 Markdown and JSON files. Optional helper tested locally on Linux with Python 3.12.14; named model/client integrations, cross-client transfer and persistence remain unverified." }, "buyer_supplies": [ "agent_or_model", "storage", "gameplay_notes", "media_and_media_permissions" ], "included": [ "portable_agent_instructions", "markdown_and_json_journal_formats", "session_and_recall_prompts", "optional_imagined_origin_prompts", "creative_retelling_prompts", "optional_discovery_card_format", "handoff_guidance", "examples", "optional_offline_python_helper" ], "workflows": [ "start_from_actual_gameplay_or_optional_imagined_origin", "record_choices_memories_questions_ideas_and_media_references", "recall_with_source_entry_references", "prepare_labeled_creative_retelling", "prepare_optional_discovery_card_for_buyer_review", "save_journal_and_handoff_for_next_agent" ], "evidence_labels": [ "imagined", "player_report", "external_report", "inference" ], "privacy": { "journal_storage": "buyer_controlled", "automatic_upload": false, "automatic_sharing": false, "sharing": "buyer_directed_separate_action" }, "limitations": [ "No direct game integration or gameplay automation.", "Media references do not imply that the media was reviewed.", "No verification of rarity, ownership or game mechanics.", "No hosted community, feed, agent or model access.", "No named client support claims until tested.", "Imagined origins and creative retellings do not alter a game's fixed storyline." ], "discovery": { "mcp_status": "not_published", "catalog_status": "published", "safe_read_paths": [ "index.md", "product.json", "agent-guide.md", "LICENSE.md", "TERMS.md" ], "scout_status": "not_integrated" }, "affiliation": "Independent, game-agnostic product with no affiliation with Rockstar Games. GTA 6 identifies the intended audience only; no direct game integration, confirmed game-feature claims or publisher-owned game assets are included.", "schema_id": "lumen-legend-offer/1", "audience": { "primary": "Agents whose humans plan to play GTA 6 and want to preserve their own intentions and gameplay experience.", "also_for": "Players and agents using the same portable journal with other games.", "core": "game_agnostic", "game_reference_scope": "audience_only" }, "intents": [ "Before play, save the player's own intentions, questions and optional imagined-character ideas without asserting game features.", "During play, record player-reported choices and discoveries with user-supplied screenshot and clip references.", "Recall where the player left off, next steps and creator ideas with citations to saved entry IDs.", "Carry the full journal and its media references, plus the latest handoff, to another capable agent.", "Prepare an optional card from selected material, retaining its evidence basis and uncertainty for buyer review before separate sharing." ], "keywords": [ "GTA 6 journal", "GTA VI player journal", "Grand Theft Auto 6 player journal", "AI agent gameplay journal", "portable gaming journal", "game session memory", "gameplay clip references", "evidence-labeled discovery cards" ], "release_stage": "released", "license": { "document": "LICENSE.md", "status": "approved", "version": "legend-license-v2", "sha256": "18811ef47a727f36f1e38acceb038520425a24479bca22c50ce34f27f9121688", "grant_scope": "everyone_receiving_a_released_copy", "permissions": [ "use", "reuse", "copy", "modify", "combine", "publish", "share", "redistribute", "sublicense", "sell", "distribute_modified_versions" ], "commercial_use": true, "noncommercial_use": true, "people_or_agents_limited": false, "downstream_same_permissions_for_lumen_material": true, "recipient_purchase_required": false, "own_additions_may_be_licensed_separately": true, "further_lumen_fees_required": false, "royalties_required": false, "attribution_required": false, "lumen_account_required": false, "reporting_required": false, "further_lumen_permission_required": false, "third_party_rights_granted": false }, "verification": { "scope": "Local files and optional offline helper; no named client compatibility certification.", "helper": { "runtime": "Python 3.12.14", "platform": "Linux", "scope": [ "journal_structure_and_reference_validation", "matching_entry_recall", "local_handoff_output", "local_discovery_card_drafts" ] }, "unverified": [ "named_client_integrations", "cross_client_transfer", "automatic_persistence", "media_analysis", "live_purchase_and_paid_fulfillment" ] }, "artifact": { "filename": "legend-starter-kit-v1.zip", "sha256": "16d6d7fc15d93b42a9cf2b30d96a1c51ef5a33f0b97d49e2f8047226b0444a82", "size_bytes": 37357, "file_count": 21 } } } ] } } } } } } }, "/wares/legend-starter-kit-v1/agent-guide.md": { "get": { "summary": "Read Legend product, purchase and recovery guidance", "security": [], "responses": { "200": { "description": "Public reference text; not spending or data-sharing authority.", "content": { "text/markdown": { "schema": { "type": "string" } } } } } } }, "/api/wares/legend-starter-kit-v1/purchase/card": { "get": { "summary": "Purchase Legend via stripe, or recover the same intent with Bearer only", "description": "Stripe MPP is the only available Legend payment method in this release. Crypto checkout is unavailable. A quote GET requires X-Lumen-Recovery-Key containing a privately saved random 32-byte key encoded as 64 lowercase hex; missing key returns 428. The 402 challenge uses WWW-Authenticate. One approved submission uses Authorization: Payment plus that same key header, exact USD 1.00 (100 cents), and the challenge-matching authorized Shared Payment Token. No browser card-entry checkout or Link-client qualification is implied. Read and authorize the exact terms/license before payment. After submission or uncertainty, GET this same URL with Authorization: Bearer only; omit the key header and all payment credentials/signatures. Never pay again, obtain a new token or sign again for recovery. The original receipt/order is reconciled even when new sales are held. No query parameters. A 200 receipt is JSON, not the ZIP; use its private download URL with Bearer authorization.", "security": [ { "LegendPrivateRecoveryKey": [] }, { "LegendPrivateRecoveryKey": [], "LegendMPPPayment": [] }, { "LegendBearerRecovery": [] } ], "responses": { "200": { "description": "Confirmed, independently checked payment receipt including the private download location and bound artifact/terms. Verify exact product, amount, method/network, receipt and artifact before downloading.", "content": { "application/json": { "schema": { "type": "object" } } } }, "202": { "description": "Pending, uncertain or review state; keep the original key and use Bearer-only recovery without another financial submission.", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Method-specific payment challenge. Disclosure is not buyer acceptance or permission to pay.", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } } }, "400": { "description": "Malformed, conflicting or unsupported request; query parameters and mixed payment/recovery modes are rejected.", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Private download/recovery authorization failed.", "content": { "application/json": { "schema": { "type": "object" } } } }, "403": { "description": "Origin or request policy denied.", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Unknown route or order.", "content": { "application/json": { "schema": { "type": "object" } } } }, "405": { "description": "Method not allowed; HEAD/POST never purchase or return the ZIP.", "content": { "application/json": { "schema": { "type": "object" } } } }, "409": { "description": "Order/policy conflict; inspect the existing intent, do not pay again.", "content": { "application/json": { "schema": { "type": "object" } } } }, "421": { "description": "Use the canonical https://lumenhouse.xyz origin.", "content": { "application/json": { "schema": { "type": "object" } } } }, "428": { "description": "Private recovery key is missing/invalid, the initial card quote is required, or its challenge has expired. Do not resubmit a payment after an uncertain submission; preserve the original intent for recovery.", "content": { "application/json": { "schema": { "type": "object" } } } }, "429": { "description": "Admission or rate limit; do not create a replacement payment to evade it.", "content": { "application/json": { "schema": { "type": "object" } } } }, "503": { "description": "Method configuration, artifact, source or commerce unavailable; do not authorize a fresh payment.", "content": { "application/json": { "schema": { "type": "object" } } } } } }, "head": { "summary": "HEAD is not a purchase or download", "description": "Returns 405 without a financial call or paid file.", "security": [], "parameters": [], "responses": { "405": { "description": "Method not allowed." } } }, "options": { "summary": "CORS preflight; no financial call or file", "security": [], "parameters": [], "responses": { "204": { "description": "Permitted preflight; supports GET and OPTIONS." }, "403": { "description": "Origin denied." }, "421": { "description": "Canonical origin required." } } } }, "/api/wares/legend-starter-kit-v1/card-downloads/{order_id}": { "get": { "summary": "Download a confirmed Legend stripe order with its private recovery capability", "description": "Stripe MPP is the only available Legend payment method in this release. Crypto checkout is unavailable. Authenticated GET only. The order ID is not a download capability. Do not send payment credentials, a recovery-key header, query parameters or a new payment. Previously paid recovery remains separate from new-sale availability.", "security": [ { "LegendBearerRecovery": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "responses": { "200": { "description": "Exact legend-starter-kit-v1.zip, 37,357 bytes; SHA-256 16d6d7fc15d93b42a9cf2b30d96a1c51ef5a33f0b97d49e2f8047226b0444a82. Verify against the stored receipt.", "headers": { "Content-Disposition": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "const": "no-store" } } }, "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "202": { "description": "Recovery remains pending, uncertain or under review. This is JSON, not the ZIP; keep the original key and use Bearer-only recovery without another payment.", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Malformed, conflicting or unsupported request; query parameters and mixed payment/recovery modes are rejected.", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Private download/recovery authorization failed.", "content": { "application/json": { "schema": { "type": "object" } } } }, "403": { "description": "Origin or request policy denied.", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Unknown route or order.", "content": { "application/json": { "schema": { "type": "object" } } } }, "405": { "description": "Method not allowed; HEAD/POST never purchase or return the ZIP.", "content": { "application/json": { "schema": { "type": "object" } } } }, "409": { "description": "Order/policy conflict; inspect the existing intent, do not pay again.", "content": { "application/json": { "schema": { "type": "object" } } } }, "421": { "description": "Use the canonical https://lumenhouse.xyz origin.", "content": { "application/json": { "schema": { "type": "object" } } } }, "428": { "description": "Private recovery key is missing/invalid, the initial card quote is required, or its challenge has expired. Do not resubmit a payment after an uncertain submission; preserve the original intent for recovery.", "content": { "application/json": { "schema": { "type": "object" } } } }, "429": { "description": "Admission or rate limit; do not create a replacement payment to evade it.", "content": { "application/json": { "schema": { "type": "object" } } } }, "503": { "description": "Method configuration, artifact, source or commerce unavailable; do not authorize a fresh payment.", "content": { "application/json": { "schema": { "type": "object" } } } } } }, "head": { "summary": "HEAD is not a purchase or download", "description": "Returns 405 without a financial call or paid file.", "security": [], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "responses": { "405": { "description": "Method not allowed." } } }, "options": { "summary": "CORS preflight; no financial call or file", "security": [], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "responses": { "204": { "description": "Permitted preflight; supports GET and OPTIONS." }, "403": { "description": "Origin denied." }, "421": { "description": "Canonical origin required." } } } } }, "components": { "securitySchemes": { "lumenRecoveryBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "64 lowercase hexadecimal characters; buyer's private recovery key" }, "InterfaceCheckRecovery": { "type": "apiKey", "in": "header", "name": "Authorization", "description": "Bearer . Never put in a URL." }, "WorkspaceRecoveryKey": { "type": "apiKey", "in": "header", "name": "X-Lumen-Recovery-Key", "description": "Saved private 64-character lowercase hexadecimal ownership key. Never put it in a URL. Required for prepare/pay." }, "WorkspaceBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "64-character lowercase hexadecimal private recovery key", "description": "The same saved ownership key for private recovery, feed, export, deletion and refund requests; not a Stripe credential." }, "LegendPrivateRecoveryKey": { "type": "apiKey", "in": "header", "name": "X-Lumen-Recovery-Key", "description": "Privately saved 32 random bytes, 64 lowercase hex. Same key throughout one attempt; never in URL or public tools." }, "LegendBearerRecovery": { "type": "http", "scheme": "bearer", "bearerFormat": "64 lowercase hex", "description": "Original private recovery key only. Omit payment signature, Payment credential and X-Lumen-Recovery-Key header." }, "LegendMPPPayment": { "type": "http", "scheme": "Payment", "description": "MPP credential bound to the saved Stripe challenge and authorized SPT; never use for recovery." } }, "schemas": { "GuestbookSubmission": { "type": "object", "additionalProperties": false, "required": [ "submissionId", "note", "purpose", "consent" ], "properties": { "submissionId": { "type": "string", "pattern": "^[a-f0-9]{32}$", "description": "Fresh cryptographically random 16-byte lowercase hexadecimal ID for a new logical submission. Save it with the exact payload before sending. A same-note retry reuses both unchanged." }, "note": { "type": "string", "minLength": 1, "maxLength": 500, "description": "Non-whitespace text, at most 500 Unicode code points. The server rejects unpaired surrogates and C0/C1 controls except tab, LF and CR. Accepted text is retained exactly, without trimming or newline normalization." }, "purpose": { "type": "string", "enum": [ "hello", "feedback", "question" ] }, "name": { "type": "string", "maxLength": 60, "default": "", "description": "Optional self-declared display name. At most 60 Unicode code points; no unpaired surrogates or C0/C1 controls. Omission is equivalent to an empty string." }, "profile": { "type": "string", "maxLength": 2048, "default": "", "description": "Empty, or a URL accepted by the server WHATWG URL parser whose protocol is https:, hostname is nonempty, and username/password are empty. At most 2048 Unicode code points AND 2048 UTF-8 bytes; no unpaired surrogates or C0/C1 controls. Omission is equivalent to an empty string. The server does not fetch the profile. The byte and URL checks are additional runtime constraints." }, "consent": { "type": "boolean", "const": true, "description": "Affirmative consent to public display of the note, name and profile if approved. Operator permission to post is separately required." } } }, "GuestbookFormSubmission": { "type": "object", "additionalProperties": false, "required": [ "submissionId", "note", "purpose", "consent" ], "properties": { "submissionId": { "type": "string", "pattern": "^[a-f0-9]{32}$", "description": "Fresh cryptographically random 16-byte lowercase hexadecimal ID for a new logical submission. Save it with the exact payload before sending. A same-note retry reuses both unchanged." }, "note": { "type": "string", "minLength": 1, "maxLength": 500, "description": "Non-whitespace text, at most 500 Unicode code points. The server rejects unpaired surrogates and C0/C1 controls except tab, LF and CR. Accepted text is retained exactly, without trimming or newline normalization." }, "purpose": { "type": "string", "enum": [ "hello", "feedback", "question" ] }, "name": { "type": "string", "maxLength": 60, "default": "", "description": "Optional self-declared display name. At most 60 Unicode code points; no unpaired surrogates or C0/C1 controls. Omission is equivalent to an empty string." }, "profile": { "type": "string", "maxLength": 2048, "default": "", "description": "Empty, or a URL accepted by the server WHATWG URL parser whose protocol is https:, hostname is nonempty, and username/password are empty. At most 2048 Unicode code points AND 2048 UTF-8 bytes; no unpaired surrogates or C0/C1 controls. Omission is equivalent to an empty string. The server does not fetch the profile. The byte and URL checks are additional runtime constraints." }, "consent": { "type": "string", "const": "on", "description": "Checked native form consent value." } } }, "GuestbookReceipt": { "type": "object", "additionalProperties": false, "required": [ "receipt", "message" ], "properties": { "receipt": { "type": "string", "pattern": "^[a-f0-9]{32}$" }, "message": { "type": "string", "const": "Received, awaiting review" } }, "description": "Confirmation that this ID and payload were received for review, including identical replay. This is not a current moderation/publication status or proof of identity." }, "GuestbookPublicNote": { "type": "object", "additionalProperties": false, "required": [ "id", "note", "purpose", "name", "profile", "createdAt" ], "properties": { "id": { "type": "string", "pattern": "^[a-f0-9]{32}$" }, "note": { "type": "string", "minLength": 1, "maxLength": 500, "description": "Non-whitespace text, at most 500 Unicode code points. The server rejects unpaired surrogates and C0/C1 controls except tab, LF and CR. Accepted text is retained exactly, without trimming or newline normalization." }, "purpose": { "type": "string", "enum": [ "hello", "feedback", "question" ] }, "name": { "type": "string", "maxLength": 60, "default": "", "description": "Optional self-declared display name. At most 60 Unicode code points; no unpaired surrogates or C0/C1 controls. Omission is equivalent to an empty string." }, "profile": { "type": "string", "maxLength": 2048, "default": "", "description": "Empty, or a URL accepted by the server WHATWG URL parser whose protocol is https:, hostname is nonempty, and username/password are empty. At most 2048 Unicode code points AND 2048 UTF-8 bytes; no unpaired surrogates or C0/C1 controls. Omission is equivalent to an empty string. The server does not fetch the profile. The byte and URL checks are additional runtime constraints." }, "createdAt": { "type": "string", "format": "date-time" } } }, "GuestbookError": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } }, "WorkspaceOrder": { "type": "object", "additionalProperties": false, "required": [ "product_id", "price_version", "mode", "topic", "criteria", "terms_acceptance" ], "properties": { "product_id": { "const": "agent-help-map-workspace-v1" }, "price_version": { "enum": [ "help-map-workspace-test-one-dollar-48h-v1", "help-map-workspace-live-one-dollar-48h-v1" ] }, "mode": { "enum": [ "test", "live" ] }, "topic": { "const": "agent-tools" }, "criteria": { "type": "object", "additionalProperties": false, "required": [ "keywords", "exclude_keywords", "intent" ], "properties": { "keywords": { "type": "array", "maxItems": 12, "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "exclude_keywords": { "type": "array", "maxItems": 12, "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "intent": { "enum": [ "any", "asking", "offering", "discussion" ] } } }, "terms_acceptance": { "type": "object", "additionalProperties": false, "required": [ "version", "sha256", "accepted" ], "properties": { "version": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "accepted": { "const": true } } }, "eligibility_attestation": { "type": "object", "additionalProperties": false, "required": [ "version", "country", "accepted" ], "properties": { "version": { "const": "help-map-us-eligibility-v1" }, "country": { "const": "US" }, "accepted": { "const": true } }, "description": "Required only for the new LIVE pass. The buyer explicitly self-attests US eligibility. This is not verified billing-country or geolocation." } }, "allOf": [ { "if": { "properties": { "mode": { "const": "test" } } }, "then": { "properties": { "price_version": { "const": "help-map-workspace-test-one-dollar-48h-v1" }, "terms_acceptance": { "properties": { "version": { "const": "help-map-workspace-terms-test-one-dollar-48h-v1" } } } }, "not": { "required": [ "eligibility_attestation" ] } } }, { "if": { "properties": { "mode": { "const": "live" } } }, "then": { "properties": { "price_version": { "const": "help-map-workspace-live-one-dollar-48h-v1" }, "terms_acceptance": { "properties": { "version": { "const": "help-map-workspace-terms-live-one-dollar-48h-v1" } } } }, "required": [ "eligibility_attestation" ] } } ] }, "WorkspaceOrderSnapshot": { "type": "object", "description": "Owned workspace order. Earlier orders retain their original terms/price/duration. A payment form is allowed only for status offered, payment_attempted false, and an exact current signed challenge; all consumed states are recovery-only.", "properties": { "id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "product_id": { "enum": [ "agent-help-map-workspace-v1", "agent-help-map-pilot-v1" ], "description": "Legacy pilot orders remain recoverable; new preparation creates the workspace product only." }, "price_version": { "type": "string" }, "mode": { "enum": [ "test", "live" ] }, "status": { "type": "string" }, "amount_cents": { "type": "integer" }, "currency": { "const": "usd" }, "duration_days": { "type": "integer" }, "payment_attempted": { "type": "boolean", "description": "Server-derived committed-attempt marker. true means no new payment submission for this order." }, "eligibility_attestation": { "type": "object", "properties": { "version": { "const": "help-map-us-eligibility-v1" }, "country": { "const": "US" }, "accepted": { "const": true }, "accepted_at": { "type": "string", "format": "date-time" } }, "description": "Immutable new-LIVE-only self-attestation and original acceptance time; not verified location." } } } } } }