Show one view of a tenant in the ComOS panel, filled from typed reads. Always pass tenant_id. Retail: product_grid (opt. category, in_stock_only), product_detail (product_id), order_status, receipt (order_id; owner). Bookings: slot_picker (opt. provider_id, from, to), provider_card (provider_id), booking_card (booking_id; owner). Digital: license_grid (opt. category), license_detail (license_id), entitlements (owner; opt. license_id, holder_ref). Services: capability_grid (opt. category), capability_detail (capability_id), job_status (job_id; owner). Rentals: asset_grid (opt. category, from, to), asset_detail (asset_id), rental_status (rental_id; owner). Portals: portal_results (opt. place, from, to, party, need, role), portal_business (business_id), portal_trip (legs). Buy, Book and each platform's act open ComOS pages; Details opens an item in place. Optional style: CSS on the drawn .c-<role> classes (see its parameter); the result names any selector that matched nothing. Public. Compose (view: "composed") when the task needs more than one view or another arrangement: give 1–6 sources, each { id, view, args } with a named view and its own arguments, and a layout of copy (section, stack, grid, card, heading, text, badge, list) and records. Every price, time, status and button comes only from a record: { record: "/sources/<id>" } draws that whole view, { record: "/sources/<id>/products/<i>" } one item (lists: products, licenses, capabilities, assets, providers, entitlements, candidates). Never write a fact or a ranking ("cheapest") in copy; the page opens with "Arranged by your agent". Example: { view: "composed", sources: [{ id: "shop", view: "product_grid", args: { tenant_id: "earth" } }, { id: "times", view: "slot_picker", args: { tenant_id: "earth" } }], layout: [{ component: "grid", children: [{ record: "/sources/shop/products/0" }, { record: "/sources/shop/products/1" }] }, { record: "/sources/times" }] }. A refusal names its code and path; fix that and call again. In the panel, Book on an open time may send you a message ("Request this time for me at … Use booking_request."): request exactly that provider and start with booking_request in that tenant, asking the person for their email if you don't have it, and quote the held booking back. Request a quote may send "Request a quote for me at … Use quote_ask.": ask the person what the job is (and their email) if you don't know, call quote_ask with that service, and quote the job id back. Reserve may send "Hold this item for me at … Use rental_request.": hold exactly that item and span with rental_request, asking for the person's email if you don't have it, and quote the rental id back. Buy on a product may send "Buy this for me from … use order_create.": a click is never consent to pay. First read the product's price and check whether the person owns a tenant that can pay it in Coms (enough balance, autonomy auto). If one can, tell them the price and that tenant (payer_tenant_id), and place the order with order_create only after they say yes in the chat. If none can (they own no tenant, or none is funded), do not call order_create: tell them the price and give them the product's pay_url in that same reply, where they pay by card. If an order is refused or held, say so and give the pay_url. On a portal, Book may send "Book this for me through portal …" and Check out "Check out my trip on portal …": call portal_quote with exactly those legs, show each price, the portal fee as its own line and the total, and call portal_checkout only after the person says yes. Add to trip may send "Add this to my trip on portal …": show federation_view portal_trip with those legs; quote and book nothing yet. A host that can't take the message opens the page instead.
View input schema
{
"type": "object",
"properties": {
"view": {
"type": "string",
"enum": [
"product_grid",
"product_detail",
"slot_picker",
"provider_card",
"booking_card",
"order_status",
"receipt",
"license_grid",
"license_detail",
"entitlements",
"capability_grid",
"capability_detail",
"job_status",
"asset_grid",
"asset_detail",
"rental_status",
"portal_results",
"portal_business",
"portal_trip",
"composed"
],
"description": "Which view to show. The host picks: product_grid, product_detail, slot_picker, provider_card, booking_card, order_status, receipt, license_grid, license_detail, entitlements, capability_grid, capability_detail, job_status, asset_grid, asset_detail, rental_status, portal_results, portal_business, portal_trip. Or composed: your own arrangement of copy and records from up to 6 named views (title, sources, layout)."
},
"tenant_id": {
"type": "string",
"maxLength": 64,
"description": "The tenant to show, e.g. \"earth\" (a store) or \"ron\" (a booking page). Required for every named view; composed takes tenant_id inside each source instead."
},
"product_id": {
"type": "string",
"maxLength": 4000,
"description": "product_detail: the product."
},
"category": {
"type": "string",
"maxLength": 4000,
"description": "product_grid / license_grid / capability_grid / asset_grid: keep only this category."
},
"in_stock_only": {
"type": "boolean",
"description": "product_grid: keep only products in stock."
},
"provider_id": {
"type": "string",
"maxLength": 128,
"description": "provider_card: the provider (required). slot_picker: one provider instead of all."
},
"from": {
"type": "string",
"maxLength": 64,
"description": "slot_picker: ISO-8601 start of the window to show; default the booking page's own window. asset_grid / asset_detail: the rental span's start (a date or ISO-8601 with zone; with to). portal_*: first day."
},
"to": {
"type": "string",
"maxLength": 64,
"description": "slot_picker: ISO-8601 end of the window to show. asset_grid / asset_detail: the rental span's end; omit both for each asset's next default span. portal_*: last day."
},
"booking_id": {
"type": "string",
"maxLength": 4000,
"description": "booking_card: the booking (owner, bookings:read)."
},
"order_id": {
"type": "string",
"maxLength": 4000,
"description": "order_status / receipt: the order (owner, orders:read)."
},
"license_id": {
"type": "string",
"maxLength": 4000,
"description": "license_detail: the license (required). entitlements: only this license's grants."
},
"holder_ref": {
"type": "string",
"maxLength": 4000,
"description": "entitlements: only this holder's grants (owner, digital:read)."
},
"capability_id": {
"type": "string",
"maxLength": 4000,
"description": "capability_detail: the service (required)."
},
"job_id": {
"type": "string",
"maxLength": 4000,
"description": "job_status: the job (owner, services:read)."
},
"asset_id": {
"type": "string",
"maxLength": 4000,
"description": "asset_detail: the rental asset."
},
"rental_id": {
"type": "string",
"maxLength": 4000,
"description": "rental_status: the rental (owner, rentals:read)."
},
"business_id": {
"type": "string",
"maxLength": 64,
"description": "portal_business: the listed business id."
},
"place": {
"type": "string",
"maxLength": 64,
"description": "portal_results: where, a geo token (\"US-CA\")."
},
"party": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "portal_*: party size (1–20)."
},
"need": {
"type": "string",
"maxLength": 120,
"description": "portal_results: what the person wants, in their words."
},
"role": {
"type": "string",
"maxLength": 16,
"description": "portal_results: stay, car, shuttle or tour."
},
"legs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 210
},
"maxItems": 6,
"description": "portal_trip (required) / portal_business: legs, each \"<business>~<product>~<role>\"."
},
"style": {
"type": "string",
"maxLength": 4000,
"description": "Optional CSS for this showing, over the tenant's own stylesheet, on the drawn .c-<role> classes: .c-page .c-page-header .c-page-title .c-grid .c-card .c-product .c-product-picture .c-product-body .c-product-name .c-price .c-term .c-badge .c-actions .c-action-primary (Buy) .c-action-ref (Details) .c-slot-open. Facts take colour only through --comos-fact-surface + --comos-fact-ink (opaque hex, 4.5:1); buttons through --comos-action-fill + --comos-action-ink (and --comos-action-secondary-*), --comos-action-radius, --comos-action-padding. Prices, terms, stock, totals and every act control always stay visible. Takes effect where the ComOS panel renderer draws the view."
},
"title": {
"type": "string",
"maxLength": 200,
"description": "composed: the page's title; default the store's name when every source is one tenant, else \"Your view\"."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
},
"maxItems": 64,
"description": "composed: 1–6 reads, each { id, view, args }: id lower_snake_case, view one of the named views, args exactly that view's arguments (tenant_id included)."
},
"layout": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
},
"maxItems": 200,
"description": "composed: the page's children. Each node is a copy component { component: section|stack|grid|card|heading|text|badge|list, props?, children? } or a record { record: \"/sources/<id>\" } (a whole view) or { record: \"/sources/<id>/<list>/<index>\" } (one item). Facts and actions come only from records."
}
},
"required": [
"view"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}