Explorer docs
runbookuai-explorerredacted view

UAI Explorer Agent Access Brief 2026-07-02

Explorer access and source-of-truth verification brief for follow-up agents.

Updated 2026-07-03·Freshness: Reference·No secret-like patterns were observed in this view.

UAI Explorer Agent Access Brief 2026-07-02

Explorer access and source-of-truth verification brief for follow-up agents.

Body

title: UAI Explorer Agent Access Brief 2026-07-02 project: uai-explorer kind: runbook authority: ai-lane-direct-author author_user_id: 2 ai_visible: True human_visible: True created_at: 2026-07-02T21:30:14.515190+00:00 updated_at: 2026-07-02T21:32:52.924874+00:00

UAI Explorer Agent Access Brief 2026-07-02

Explorer access and source-of-truth verification brief for follow-up agents.

Body

title: UAI Explorer agent access brief date: 2026-07-02 status: required_for_follow_up_agents authority: access_instructions_only

UAI Explorer Agent Access Brief

This brief is required for every follow-up agent. UAI Explorer is the source of truth for rules, boundaries, docs, and project context only when the exact authenticated context call succeeds.

Operator Launch Requirement

Before giving an agent its lane prompt, the operator must give that same agent UAI Explorer access in its own process/session.

Preferred endpoint:

export UAI_EXPLORER_ENDPOINT="https://explorer.united-ai.ca"
export UAI_EXPLORER_AI_API_ [wrap] KEY="<operator-provided AI API key>"

Current operator-supplied lab endpoint for this restart wave:

export UAI_EXPLORER_ENDPOINT="http://10.0.0.121:8080"
export UAI_EXPLORER_AI_API_ [wrap] KEY="<operator-provided AI API key>"

Use the lab endpoint when the operator supplies it for CT121 publication or comparison proof. Use the public endpoint when the operator does not override the endpoint.

Use:

set +x
curl -fsS "$UAI_EXPLORER_ENDPOINT/ready"
curl -fsS -H "Authorization: Bearer $UAI_EXPLORER_AI_API_ [wrap] KEY" \
  "$UAI_EXPLORER_ENDPOINT/ap [wrap] i/ai/bootstrap"
curl -fsS -H "Authorization: Bearer $UAI_EXPLORER_AI_API_ [wrap] KEY" \
  "$UAI_EXPLORER_ENDPOINT/ap [wrap] i/ai/catalog"
curl -fsS -H "Authorization: Bearer $UAI_EXPLORER_AI_API_ [wrap] KEY" \
  "$UAI_EXPLORER_ENDPOINT/ap [wrap] i/ai/capability-map"

The real key must not be committed, written into receipts, copied into local Markdown, echoed into logs, or stored in shell history. If a tool cannot accept environment variables securely, the operator may provide the key as a one-time session secret, but the agent must still treat it as non-persistent.

Source-Of-Truth Rule

Agents must use Explorer first:

  1. Run /ready.
  2. Run authenticated /api/ai/bootstrap.
  3. Fetch /api/ai/catalog.
  4. Fetch /api/ai/capability-map.
  5. Fetch required /api/ai/context/{slug} records.
  6. Only then use local Markdown as companion evidence.

If Explorer is unreachable or the key is missing:

  • do not claim Explorer source-of-truth access,
  • do not treat local Markdown as canonical Explorer truth,
  • record source_of_truth_denied_o [wrap] r_unverified,
  • continue only with safe local/cache fallback work named by the lane prompt,
  • leave a receipt saying exactly which call failed and from which host.

Required Context Slugs To Try First

Every follow-up agent should try these before lane-specific slugs:

uai-doc-operator_bio
uai-doc-start_here_ai
uai-doc-uai_explorer_rules
uai-doc-docs-runbooks-ua [wrap] i-clean-slate-return-int [wrap] ake-ledger-2026-07-02

If the clean-slate intake slug does not return authenticated 200, use the local packet as a fallback but mark Explorer publication as blocked.