application public active Verified 2026-03-29

Topolo Agent

Agent and automation surface in the broader Topolo application portfolio.

Documentation Map

What It Is

Agent and automation surface in the broader Topolo application portfolio.

Cloudflare-first agent platform for the Topolo ecosystem. Frontend runs on Cloudflare Pages, backend runs on Cloudflare Workers with D1 + R2.

1. Install dependencies: ```bash npm install ```

2. Backend env: ```bash cp packages/backend/.dev.vars.example packages/backend/.dev.vars ```

Architecture

Owners: ai-platform

Source repos: Applications/TopoloAgent

Dependencies: topolo-auth

Repo shape

  • Applications/TopoloAgent/README.md
  • Applications/TopoloAgent/app/
  • Applications/TopoloAgent/docs/
  • Applications/TopoloAgent/infra/
  • Applications/TopoloAgent/package-lock.json
  • Applications/TopoloAgent/package.json
  • Applications/TopoloAgent/packages/
  • Applications/TopoloAgent/scripts/

Runtime Surfaces

Hosts:

No primary host is registered.

topolo-agent-worker

Config: Applications/TopoloAgent/packages/backend/wrangler.toml

Main: index.ts

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: Applications/TopoloAgent

Source exists in repo: yes

No formal OpenAPI spec is registered in this docs phase.

App API page: /reference/apps/topolo-agent

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

No Auth service ID mapped in docs yet.

API key scopes

No API key scopes were found in the checked-in Auth catalog for this system.

Service permissions

No role/permission catalog rows were found in the checked-in Auth permissions seed.

Data Ownership

d1

Binding: AGENT_DB

Target: 00000000-0000-0000-0000-000000000000

Environment: default

Source: Applications/TopoloAgent/packages/backend/wrangler.toml

r2

Binding: AGENT_LOGS

Target: topolo-agent-logs-local

Environment: default

Source: Applications/TopoloAgent/packages/backend/wrangler.toml

vectorize

Binding: KNOWLEDGE_VECTOR

Target: topolo-agent-knowledge-local

Environment: default

Source: Applications/TopoloAgent/packages/backend/wrangler.toml

d1

Binding: AGENT_DB

Target: 00000000-0000-0000-0000-000000000000

Environment: stg

Source: Applications/TopoloAgent/packages/backend/wrangler.toml

r2

Binding: AGENT_LOGS

Target: topolo-agent-logs-staging

Environment: stg

Source: Applications/TopoloAgent/packages/backend/wrangler.toml

vectorize

Binding: KNOWLEDGE_VECTOR

Target: topolo-agent-knowledge-staging

Environment: stg

Source: Applications/TopoloAgent/packages/backend/wrangler.toml

d1

Binding: AGENT_DB

Target: 4b536b30-6fc6-430f-99c8-1c80575833bb

Environment: prod

Source: Applications/TopoloAgent/packages/backend/wrangler.toml

r2

Binding: AGENT_LOGS

Target: topolo-agent-logs-production

Environment: prod

Source: Applications/TopoloAgent/packages/backend/wrangler.toml

vectorize

Binding: KNOWLEDGE_VECTOR

Target: topolo-agent-knowledge-production

Environment: prod

Source: Applications/TopoloAgent/packages/backend/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

CLOUDFLARE_ACCOUNT_ID ENVIRONMENT NODE_ENV SERVICE_ID SKIP_AUTH TOPOLO_AUTH_URL account_id

All wrangler bindings

  • AGENT_DB (d1) -> 00000000-0000-0000-0000-000000000000
  • AGENT_LOGS (r2) -> topolo-agent-logs-local
  • KNOWLEDGE_VECTOR (vectorize) -> topolo-agent-knowledge-local
  • AGENT_DB (d1) -> 00000000-0000-0000-0000-000000000000 [stg]
  • AGENT_LOGS (r2) -> topolo-agent-logs-staging [stg]
  • KNOWLEDGE_VECTOR (vectorize) -> topolo-agent-knowledge-staging [stg]
  • AGENT_DB (d1) -> 4b536b30-6fc6-430f-99c8-1c80575833bb [prod]
  • AGENT_LOGS (r2) -> topolo-agent-logs-production [prod]
  • KNOWLEDGE_VECTOR (vectorize) -> topolo-agent-knowledge-production [prod]

Deployments

Deployment environments: stg, prod

Routes: workers.dev or Pages-only delivery

Observability enabled: yes

Wrangler surfaces

  • Applications/TopoloAgent/packages/backend/wrangler.toml -> topolo-agent-worker

Build and deploy commands

  • build — Applications/TopoloAgent/app/package.json :: vite build
  • preview — Applications/TopoloAgent/app/package.json :: vite preview
  • build — Applications/TopoloAgent/package.json :: npm run build --workspace=packages/backend
  • build:app — Applications/TopoloAgent/package.json :: npm run build --workspace=app
  • build:all — Applications/TopoloAgent/package.json :: npm run build && npm run build:app
  • deploy:stg — Applications/TopoloAgent/package.json :: npm run deploy:stg --workspace=packages/backend
  • deploy:prod — Applications/TopoloAgent/package.json :: npm run deploy:prod --workspace=packages/backend
  • build — Applications/TopoloAgent/packages/backend/package.json :: tsc --noEmit
  • deploy:stg — Applications/TopoloAgent/packages/backend/package.json :: wrangler deploy --env stg
  • deploy:prod — Applications/TopoloAgent/packages/backend/package.json :: wrangler deploy --env prod

Failure Modes

  • No Auth service ID is registered for this system.
  • No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

  • Applications/TopoloAgent/packages/backend/wrangler.toml
  • Applications/TopoloAgent
  • Applications/TopoloAgent/README.md
  • Applications/TopoloAgent/app/package.json
  • Applications/TopoloAgent/package.json
  • Applications/TopoloAgent/packages/backend/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-03-29

Any code change to this system is expected to update the canonical docs in Websites/docs and refresh the verification date.