{"name":"Agentry","version":"2026-05-20","contract_version":"2026-05-20","deploy_sha":null,"docs":"\/agentry.md","install_docs":"\/install.md","reference_docs":"\/agentry.md","install_contract":"\/v1\/install\/contract","api_schema":"\/v1\/openapi.json","capabilities":"\/v1\/capabilities","setup_manifest":"\/v1\/setup\/manifest","install_plan":"\/v1\/install\/plan","quick_start":[{"when":"installing","action":"Fetch \/install.md first, resolve auth\/project state, then plan from the repo's important business question and funnel\/business logic flow before editing code.","urls":["\/install.md","\/v1\/setup\/manifest","\/v1\/install\/contract","\/v1\/install\/plan"]},{"when":"day_to_day_use","action":"Fetch \/agentry.md, then start from the saved signal map, latest verify report, answer contracts, event names, and property keys before query blueprints or HogQL.","urls":["\/agentry.md","\/v1\/projects\/:project_id\/signal-map","\/v1\/projects\/:project_id\/verify-report","\/v1\/projects\/:project_id\/answer-contracts","\/v1\/projects\/:project_id\/event-names","\/v1\/projects\/:project_id\/event-property-keys","\/v1\/projects\/:project_id\/cases","\/v1\/projects\/:project_id\/analytics\/query","\/v1\/projects\/:project_id\/deploys","\/v1\/query-blueprints"]},{"when":"exact_payload_shape","action":"Fetch a filtered OpenAPI operation schema before mutating calls; do not infer request bodies from prose examples.","urls":["\/v1\/openapi.json?index=true","\/v1\/openapi.json?flow=install"]}],"mental_model":{"write":[{"concept":"logs","endpoint":"POST \/v1\/logs\/","use_when":"errors, exceptions, operational failures"},{"concept":"analytics","endpoint":"POST \/v1\/analytics\/","use_when":"product, user, funnel, and business events"},{"concept":"deploys","endpoint":"POST \/v1\/deploys\/","use_when":"CI\/provider post-deploy release attribution after a successful deploy"}],"read":[{"concept":"cases","endpoint":"GET \/v1\/projects\/:project_id\/cases","use_when":"what broke"},{"concept":"analytics","endpoint":"POST \/v1\/projects\/:project_id\/analytics\/query","use_when":"what users did; start from signal-map, verify report, event names, and property keys before query blueprints or custom HogQL"},{"concept":"deploys","endpoint":"GET \/v1\/projects\/:project_id\/deploys","use_when":"what changed"}],"helpers":"Query blueprints, event names, public queries, health, and next-steps are helpers around the three read concepts; they do not replace signal-map and verify proof."},"proof_contract":{"install":"Start from the repo's important business question and funnel\/business logic flow; let POST \/v1\/install\/plan derive events, properties, failure surfaces, and deploy proof before editing code.","answering":"Before query blueprints or custom HogQL, read the saved signal map, latest verify report, answer contracts, event names, and property keys. If telemetry is missing, name the missing event\/property and wire or trigger that product flow."},"response_shapes":{"tabular_query_data":"Consume `rows` first. Agentry query endpoints return object-shaped rows; `columns` is display\/order metadata; `results` is intentionally absent.","raw_posthog_shape":"PostHog internally returns array rows as `results`, but Agentry normalizes those before they cross agent-facing query endpoints. If a helper reads `response.results`, fix it to read `response.rows`.","non_tabular_reads":"Typed resources keep domain names such as cases, deploys, analytics_events, keys, publications, or next_steps."},"signal_map":"\/v1\/projects\/:project_id\/signal-map","implementation_report":"\/v1\/projects\/:project_id\/implementation-report","verify_install":"\/v1\/projects\/:project_id\/install\/verify","verify_report":"\/v1\/projects\/:project_id\/verify-report","skill":"\/skill\/agentry\/SKILL.md","adapters":"\/adapters","next_action":"Choose a quick_start entry. Installing: fetch \/install.md and let the planner derive signals from the business flow. Answering: fetch \/agentry.md and prove coverage from signal-map\/verify\/event metadata before blueprints or HogQL. Use filtered \/v1\/openapi.json before mutating calls."}