{"name":"Agentry","version":"3","contract_version":"3","deploy_sha":"ead2e53adc0d8379aec4b1485e5049fc671dc542","repository":"https://github.com/agentry-sh/agentry","docs":"https://raw.githubusercontent.com/agentry-sh/agentry/main/AGENTRY.md","install_docs":"https://raw.githubusercontent.com/agentry-sh/agentry/main/INSTALL.md","reference_docs":"https://raw.githubusercontent.com/agentry-sh/agentry/main/AGENTRY.md","api_schema":"/v1/openapi.json","onboarding":"/v1/projects/:project_id/onboarding","onboarding_flow":"/v1/openapi.json?flow=onboarding","posthog_flow":"/v1/openapi.json?flow=posthog","onboarding_source_snapshot_helper":"/v1/onboarding/source-snapshot.mjs","automation_docs":"/v1/docs/automation","automation_flow":"/v1/openapi.json?flow=automation","automation_playbooks":"/v1/automation-playbooks","capabilities":"/v1/capabilities","setup_manifest":"/v1/setup/manifest","quick_start":[{"when":"installing","action":"Fetch https://raw.githubusercontent.com/agentry-sh/agentry/main/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":["https://raw.githubusercontent.com/agentry-sh/agentry/main/INSTALL.md","/v1/setup/manifest","/v1/openapi.json?flow=onboarding","/v1/projects/:project_id/onboarding","/v1/onboarding/source-snapshot.mjs"]},{"when":"day_to_day_use","action":"Fetch https://raw.githubusercontent.com/agentry-sh/agentry/main/AGENTRY.md. Use the posthog flow for direct provider-state questions; for runtime behavior or effects, start from the saved signal map, its source_verified receipt, and bounded customer PostHog event/property reads before query blueprints or HogQL.","urls":["https://raw.githubusercontent.com/agentry-sh/agentry/main/AGENTRY.md","/v1/openapi.json?flow=posthog","/v1/projects/:project_id/onboarding","/v1/projects/:project_id/signal-map","/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":"agentic_automation","action":"Fetch the automation guide and dependency-ordered OpenAPI flow, select and render one immutable disabled playbook candidate, then enable it explicitly. Follow only each run's recoverable next_action. Never infer scheduler authority, trigger payloads, clocks, or mutation fields from examples.","urls":["/v1/docs/automation","/v1/openapi.json?flow=automation","/v1/automation-playbooks","/v1/projects/:project_id/automation-control"]},{"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=onboarding","/v1/openapi.json?flow=automation"]}],"mental_model":{"customer_data_plane":{"analytics_and_errors":"Applications send telemetry directly to the customer-owned PostHog Cloud project through official PostHog SDKs.","source_maps":"Release tooling uploads source maps directly with the official PostHog CLI and customer-owned PostHog credentials.","agentry_access":"Agentry uses read-only PostHog OAuth for bounded queries; it does not proxy or retain the raw event stream."},"write":[{"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 the signal map, its source_verified receipt, and bounded customer PostHog event/property reads before query blueprints or custom HogQL"},{"concept":"posthog_resources","endpoint":"GET /v1/projects/:project_id/{session-recordings|feature-flags|surveys|experiments}","use_when":"current provider recording metadata, flag definitions, survey definitions/outcomes, or experiment definitions; discover exact operations at /v1/openapi.json?flow=posthog"},{"concept":"deploys","endpoint":"GET /v1/projects/:project_id/deploys","use_when":"what changed"}],"helpers":"Query blueprints, event names, public queries, health, and next-steps support the four read families. Provider configuration can answer direct provider-state questions; runtime or effect claims still require the signal map and source-verification receipt."},"proof_contract":{"install":"Submit a complete source-grounded value-flow plan, get explicit human approval, implement and commit it, submit the final source snapshot, then complete one real proof session for every approved milestone, the safe error, and the exact CI deploy. Follow state.next_action through the five project operations; installation is complete only at status=verified, installation_complete=true, and next_action=null.","answering":"Before query blueprints or custom HogQL, read the saved signal map, require source_verified for current source semantics, and inspect bounded customer PostHog event/property evidence. 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, session_recordings, feature_flags, surveys, responses, stats, experiments, analytics_events, keys, publications, or next_steps."},"signal_map":"/v1/projects/:project_id/signal-map","skill":"https://raw.githubusercontent.com/agentry-sh/agentry/main/plugins/agentry/skills/agentry/SKILL.md","adapters":"/adapters","next_action":"Choose one quick_start entry. Installing starts at install_docs and the onboarding flow; direct provider-state questions start at /v1/openapi.json?flow=posthog; runtime and effect answers add the saved signal map and its source_verified receipt; automation starts at /v1/docs/automation plus its filtered flow and immutable playbook catalog. Use exact filtered OpenAPI before every mutation."}