application public active Verified 2026-04-07

Agent

Agent and automation workspace for threads, workflows, approvals, and operator execution.

Documentation Map

What It Is

Agent and automation workspace for threads, workflows, approvals, and operator execution.

Canonical documentation for Topolo Agent lives in `PlatformApplications/TopoloDocs`.

Use this repository for implementation only. Local product and operational docs have been retired in favor of the docs application.

Run the one narrow smoke check that verifies workspace bootstrap and thread creation behavior:

Architecture

Owners: ai-platform

Source repos: PlatformApplications/TopoloAgent

Dependencies: topolo-auth

Repo shape

  • PlatformApplications/TopoloAgent/README.md
  • PlatformApplications/TopoloAgent/app/
  • PlatformApplications/TopoloAgent/docs/
  • PlatformApplications/TopoloAgent/infra/
  • PlatformApplications/TopoloAgent/package-lock.json
  • PlatformApplications/TopoloAgent/package.json
  • PlatformApplications/TopoloAgent/packages/
  • PlatformApplications/TopoloAgent/scripts/
  • PlatformApplications/TopoloAgent/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

https://agent.topolo.app https://topolo-agent.pages.dev
topolo-agent

Config: PlatformApplications/TopoloAgent/app/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

topolo-agent-worker

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

Main: index.ts

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloDocs/src/content/public/applications/agent.mdx

Source exists in repo: yes

Canonical Agent coverage now lives in the docs application.

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:

svc_topolo_agent

API key scopes

workspace.read

View the Agent operating workspace

Resource pattern: none

workspace.write

Update workspace state and org memory

Resource pattern: none

workflows.read

View workflow plans and runs

Resource pattern: none

workflows.write

Create and run workflow plans

Resource pattern: none

reports.read

View reports, artifacts, and work feed output

Resource pattern: none

approvals.write

Approve or reject gated Agent actions

Resource pattern: none

Service permissions

workspace:read, workspace:write, workflows:read, workflows:write, reports:read, approvals:write

Data Ownership

d1

Binding: AGENT_DB

Target: 00000000-0000-0000-0000-000000000000

Environment: default

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

r2

Binding: AGENT_LOGS

Target: topolo-agent-logs-local

Environment: default

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

vectorize

Binding: KNOWLEDGE_VECTOR

Target: topolo-agent-knowledge-local

Environment: default

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

d1

Binding: AGENT_DB

Target: 00000000-0000-0000-0000-000000000000

Environment: stg

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

r2

Binding: AGENT_LOGS

Target: topolo-agent-logs-staging

Environment: stg

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

vectorize

Binding: KNOWLEDGE_VECTOR

Target: topolo-agent-knowledge-staging

Environment: stg

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

d1

Binding: AGENT_DB

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

Environment: prod

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

r2

Binding: AGENT_LOGS

Target: topolo-agent-logs-production

Environment: prod

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

vectorize

Binding: KNOWLEDGE_VECTOR

Target: topolo-agent-knowledge-production

Environment: prod

Source: PlatformApplications/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

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

Build and deploy commands

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

Failure Modes

No default failure-mode heuristics are currently flagged for this system.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloAgent/app/wrangler.toml
  • PlatformApplications/TopoloAgent/packages/backend/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/public/applications/agent.mdx
  • PlatformApplications/TopoloAgent/README.md
  • PlatformApplications/TopoloAgent/app/package.json
  • PlatformApplications/TopoloAgent/package.json
  • PlatformApplications/TopoloAgent/packages/backend/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-07

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