Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qredence.ai/llms.txt

Use this file to discover all available pages before exploring further.

Fleet Pi is a TanStack Start web app with a Nitro-backed API, a React 19 UI, and a repo-local agent workspace. This page maps the runtime boundaries.

​
Topology

​
Layers

​
Browser client

React 19 with TanStack Router. AgentChat composes InputBar, MessageList, and the right-hand resource and workspace panels. Streaming chat, structured plan cards, and tool cards are rendered with the shared agent-elements integration from packages/ui.

​
apps/web — TanStack Start

The Vite dev server hosts the API routes:
  • /api/chat — Pi-backed chat with streaming, PII sanitization, and Pino logging.
  • /api/chat/models, /api/chat/resources, /api/chat/session — model catalog, resource browser, and session persistence.
  • /api/workspace/* — reads and writes the agent-workspace/ projection surface.
  • /api/health — smoke endpoint used by the quickstart.
The Pi server module wraps the Pi runtime, applies a circuit breaker around Bedrock calls, and exposes the plan-mode extension.

​
agent-workspace/

The durable adaptive layer. The workspace server reads memory, plans, skills, and artifacts directly from files so every change shows up in Git diffs.

​
.pi/

Committed project Pi configuration. settings.json is a compatibility bridge that points Pi at workspace-native resource directories. Built-in Pi extensions and committed skills also live here.

​
External

Amazon Bedrock is the only required external service. Fleet Pi uses your normal AWS credential chain; AWS_REGION defaults to us-east-1.

​
Packages

  • apps/web — TanStack Start app and /api/chat backend.
  • packages/ui — shared React UI and agent-elements integration.
  • apps/web/src/routeTree.gen.ts is generated. Do not edit by hand.

Agent workspace

What lives in agent-workspace/ and why it is reviewable.

Adaptive workspace contract

Canonical sections, manifest, and projection rules.