{
  "generated_at": "2026-04-28T23:58:28.600Z",
  "system": {
    "id": "topolo-agent",
    "name": "Agent",
    "slug": "topolo-agent",
    "kind": "application",
    "summary": "Agent and automation workspace for threads, workflows, approvals, and operator execution.",
    "aliases": [],
    "lifecycle": "active",
    "last_verified": "2026-04-29",
    "owners": [
      "ai-platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloAgent"
    ],
    "service_ids": [
      "svc_topolo_agent"
    ],
    "visibility": "public",
    "api_contract": {
      "type": "curated",
      "source": "PlatformApplications/TopoloDocs/src/content/public/applications/agent.mdx",
      "notes": "Canonical Agent coverage now lives in the docs application. The backend worker now requires Topolo Auth validation for operator bearer tokens and no longer carries an Agent-local HS256/JWT secret verification path. The production Pages `/login` entry renders the shared branded first-party login surface from the `svc_topolo_agent` UI Kit registry entry and submits email/password credentials to Auth through the shared client; OAuth and other brokered flows still use hosted Auth. The connector catalog uses the Developers-owned mobile app catalog connector for Android and iOS artifact metadata. Agent exposes `GET /api/widget` for TopoloOne live workspace with active-flow, pending-task, pending-approval, and run-today stats. Cross-organization agent actions must enter through TopoloP2P and wait for the P2P policy decision before execution. Staging runs in the separate Topolo Staging Cloudflare account with staging Auth, Nexus, D1, R2, Queue, and Vectorize bindings."
    },
    "primary_hosts": [
      "https://agent.topolo.app",
      "https://topolo-agent.pages.dev",
      "https://topolo-agent-staging.pages.dev",
      "https://topolo-agent-stg.topolo-staging.workers.dev"
    ],
    "doc_paths": [
      "applications/agent",
      "internal/apps/agent"
    ],
    "security_assurance": {
      "risk_tier": "high",
      "auth_boundary": "Topolo Auth service `/validate` access for operator bearer tokens with app-owned agent execution authorization.",
      "tenant_isolation": "organization_scoped",
      "external_inputs": [
        "browser",
        "api",
        "callback",
        "queue",
        "scheduled_task",
        "ai_agent_action"
      ],
      "sensitive_data": [
        "identity",
        "org_data",
        "customer_content",
        "telemetry"
      ],
      "last_security_review": "2026-04-20",
      "security_review_status": "in_progress",
      "pentest_status": "not_started",
      "evidence_doc": "internal/apps/agent"
    },
    "dependencies": [
      "topolo-auth",
      "applications-packages",
      "topolo-developers",
      "topolo-p2p"
    ],
    "public_hub_url": "/systems/topolo-agent",
    "internal_hub_url": null,
    "application_api_url": "/reference/apps/topolo-agent",
    "generated_openapi_url": null,
    "machine_urls": {
      "system": "/machine/systems/topolo-agent.json",
      "application": "/machine/applications/topolo-agent.json"
    }
  },
  "docs": {
    "public": [
      {
        "id": "applications/agent.mdx",
        "title": "Topolo Agent",
        "summary": "Public overview of the Cloudflare-first agent and automation platform in the Topolo portfolio.",
        "audience": "public",
        "tags": [
          "agents",
          "automation",
          "workflows"
        ],
        "url": "/applications/agent.mdx",
        "last_verified": "2026-04-28"
      }
    ],
    "internal": [],
    "runbooks": []
  },
  "authority": {
    "owners": [
      "ai-platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloAgent"
    ],
    "service_ids": [
      "svc_topolo_agent"
    ],
    "dependencies": [
      "topolo-auth",
      "applications-packages",
      "topolo-developers",
      "topolo-p2p"
    ],
    "aliases": []
  },
  "interfaces": {
    "contract_type": "curated",
    "contract_source": "PlatformApplications/TopoloDocs/src/content/public/applications/agent.mdx",
    "contract_source_exists": true,
    "openapi": null,
    "readme": {
      "path": "PlatformApplications/TopoloAgent/README.md",
      "intro": [
        "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:"
      ],
      "headings": [
        "Topolo Agent",
        "Operator demo route",
        "Backend smoke check"
      ],
      "routeHighlights": [
        "`docs/operator-demo-route-openclaw.md` contains the captured current operator route for OpenClaw (frontend login/bootstrapping plus backend API handoff map)."
      ],
      "commandHighlights": []
    }
  },
  "auth": {
    "depends_on_topolo_auth": true,
    "api_key_scopes": [
      {
        "id": "aks_topolo_agent_approvals_write",
        "name": "approvals.write",
        "description": "Approve or reject gated Agent actions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "id": "aks_topolo_agent_reports_read",
        "name": "reports.read",
        "description": "View reports, artifacts, and work feed output",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "id": "aks_topolo_agent_workflows_read",
        "name": "workflows.read",
        "description": "View workflow plans and runs",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "id": "aks_topolo_agent_workflows_write",
        "name": "workflows.write",
        "description": "Create and run workflow plans",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "id": "aks_topolo_agent_workspace_read",
        "name": "workspace.read",
        "description": "View the Agent operating workspace",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "id": "aks_topolo_agent_workspace_write",
        "name": "workspace.write",
        "description": "Update workspace state and org memory",
        "resourcePattern": null,
        "kind": "api_key_scope"
      }
    ],
    "service_permissions": [
      {
        "id": "perm_topolo_agent_approvals_write",
        "name": "approvals:write",
        "description": "Approve or reject gated Agent actions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "id": "perm_topolo_agent_reports_read",
        "name": "reports:read",
        "description": "View reports, artifacts, and work feed output",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "id": "perm_topolo_agent_workflows_read",
        "name": "workflows:read",
        "description": "View workflow plans and runs",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "id": "perm_topolo_agent_workflows_write",
        "name": "workflows:write",
        "description": "Create and run workflow plans",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "id": "perm_topolo_agent_workspace_read",
        "name": "workspace:read",
        "description": "View the Agent operating workspace",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "id": "perm_topolo_agent_workspace_write",
        "name": "workspace:write",
        "description": "Update workspace state and org memory",
        "resourcePattern": null,
        "kind": "permission"
      }
    ]
  },
  "runtime": {
    "primary_hosts": [
      "https://agent.topolo.app",
      "https://topolo-agent.pages.dev",
      "https://topolo-agent-staging.pages.dev",
      "https://topolo-agent-stg.topolo-staging.workers.dev"
    ],
    "repo_entries": [
      "PlatformApplications/TopoloAgent/README.md",
      "PlatformApplications/TopoloAgent/app/",
      "PlatformApplications/TopoloAgent/docs/",
      "PlatformApplications/TopoloAgent/infra/",
      "PlatformApplications/TopoloAgent/migration.config.ts",
      "PlatformApplications/TopoloAgent/package-lock.json",
      "PlatformApplications/TopoloAgent/package.json",
      "PlatformApplications/TopoloAgent/packages/",
      "PlatformApplications/TopoloAgent/scripts/",
      "PlatformApplications/TopoloAgent/topolo.cloudcontrol.json"
    ],
    "wrangler_surfaces": [
      {
        "path": "PlatformApplications/TopoloAgent/app/wrangler.toml",
        "observabilityEnabled": true,
        "environments": [],
        "routes": [],
        "vars": [],
        "bindings": [],
        "cronTriggers": [],
        "workerName": "topolo-agent",
        "compatibilityDate": "2026-04-10"
      },
      {
        "path": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "observabilityEnabled": true,
        "environments": [
          "stg",
          "prod"
        ],
        "routes": [],
        "vars": [
          "CLOUDFLARE_ACCOUNT_ID",
          "ENVIRONMENT",
          "NEXUS_GATEWAY_URL",
          "NODE_ENV",
          "SERVICE_ID",
          "TOPOLO_AUTH_URL",
          "account_id"
        ],
        "bindings": [
          {
            "kind": "d1",
            "binding": "AGENT_DB",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "00000000-0000-0000-0000-000000000000"
          },
          {
            "kind": "r2",
            "binding": "AGENT_LOGS",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "topolo-agent-logs-local"
          },
          {
            "kind": "vectorize",
            "binding": "KNOWLEDGE_VECTOR",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "topolo-agent-knowledge-local"
          },
          {
            "kind": "queue",
            "binding": "AGENT_WORKFLOW_QUEUE",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "topolo-agent-workflow-runs-local"
          },
          {
            "kind": "d1",
            "binding": "AGENT_DB",
            "environment": "stg",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "46570203-40bb-4a66-b1f4-66ec89abb486"
          },
          {
            "kind": "r2",
            "binding": "AGENT_LOGS",
            "environment": "stg",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "topolo-agent-logs-staging"
          },
          {
            "kind": "vectorize",
            "binding": "KNOWLEDGE_VECTOR",
            "environment": "stg",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "topolo-agent-knowledge-staging"
          },
          {
            "kind": "queue",
            "binding": "AGENT_WORKFLOW_QUEUE",
            "environment": "stg",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "topolo-agent-workflow-runs-staging"
          },
          {
            "kind": "d1",
            "binding": "AGENT_DB",
            "environment": "prod",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "4b536b30-6fc6-430f-99c8-1c80575833bb"
          },
          {
            "kind": "r2",
            "binding": "AGENT_LOGS",
            "environment": "prod",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "topolo-agent-logs-production"
          },
          {
            "kind": "vectorize",
            "binding": "KNOWLEDGE_VECTOR",
            "environment": "prod",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "topolo-agent-knowledge-production"
          },
          {
            "kind": "queue",
            "binding": "AGENT_WORKFLOW_QUEUE",
            "environment": "prod",
            "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
            "target": "topolo-agent-workflow-runs-production"
          }
        ],
        "cronTriggers": [],
        "workerName": "topolo-agent-worker",
        "main": "index.ts",
        "compatibilityDate": "2026-04-10"
      }
    ],
    "packages": [
      {
        "path": "PlatformApplications/TopoloAgent/app/package.json",
        "name": "topolo-agent-app",
        "scripts": [
          "dev",
          "build",
          "preview",
          "typecheck",
          "lint"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "vite"
          },
          {
            "name": "build",
            "command": "vite build"
          },
          {
            "name": "preview",
            "command": "vite preview"
          },
          {
            "name": "typecheck",
            "command": "tsc --noEmit"
          },
          {
            "name": "lint",
            "command": "eslint . --ext ts,tsx --max-warnings 0"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloAgent/package.json",
        "name": "topolo-agent",
        "scripts": [
          "dev",
          "dev:app",
          "dev:all",
          "build",
          "build:app",
          "build:all",
          "deploy:web",
          "deploy:stg",
          "deploy:staging",
          "deploy:prod",
          "deploy:production",
          "lint",
          "build:app:staging",
          "deploy:web:staging"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "npm run dev --workspace=packages/backend"
          },
          {
            "name": "dev:app",
            "command": "npm run dev --workspace=app"
          },
          {
            "name": "dev:all",
            "command": "concurrently \"npm run dev\" \"npm run dev:app\""
          },
          {
            "name": "build",
            "command": "npm run build --workspace=packages/backend"
          },
          {
            "name": "build:app",
            "command": "npm run build --workspace=app"
          },
          {
            "name": "build:all",
            "command": "npm run build && npm run build:app"
          },
          {
            "name": "deploy:web",
            "command": "npm run build:app && CLOUDFLARE_ACCOUNT_ID=49ef1ba682ad8cfd720c86699ae17521 npx wrangler pages deploy app/dist --project-name=topolo-agent --branch=production"
          },
          {
            "name": "deploy:stg",
            "command": "npm run deploy:stg --workspace=packages/backend"
          },
          {
            "name": "deploy:staging",
            "command": "npm run deploy:stg && npm run deploy:web:staging"
          },
          {
            "name": "deploy:prod",
            "command": "npm run deploy:prod --workspace=packages/backend"
          },
          {
            "name": "deploy:production",
            "command": "npm run deploy:prod"
          },
          {
            "name": "lint",
            "command": "npm run lint --workspace=app && npm run lint --workspace=packages/backend"
          },
          {
            "name": "build:app:staging",
            "command": "VITE_API_URL=https://topolo-agent-stg.topolo-staging.workers.dev VITE_AUTH_URL=https://auth.stg.topolo.us VITE_SERVICE_ID=svc_topolo_agent VITE_CURRENT_APP_URL=https://topolo-agent-staging.pages.dev VITE_BUGFIX_API_URL=https://bugfix.stg.topolo.us npm run build --workspace=app"
          },
          {
            "name": "deploy:web:staging",
            "command": "npm run build:app:staging && CLOUDFLARE_ACCOUNT_ID=4f4e1c69a3830946f9fea7b1eb7531ac npx wrangler@4 pages deploy app/dist --project-name=topolo-agent-staging --branch=main"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloAgent/packages/backend/package.json",
        "name": "topolo-agent-backend",
        "scripts": [
          "dev",
          "build",
          "deploy:stg",
          "deploy:prod",
          "start",
          "smoke:workspace-thread"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "wrangler dev"
          },
          {
            "name": "build",
            "command": "tsc --noEmit"
          },
          {
            "name": "deploy:stg",
            "command": "wrangler deploy --env stg"
          },
          {
            "name": "deploy:prod",
            "command": "wrangler deploy --env prod"
          },
          {
            "name": "start",
            "command": "wrangler dev"
          },
          {
            "name": "smoke:workspace-thread",
            "command": "bash ./scripts/smoke-workspace-thread.sh"
          }
        ]
      }
    ]
  },
  "data": {
    "env_vars": [
      "CLOUDFLARE_ACCOUNT_ID",
      "ENVIRONMENT",
      "NEXUS_GATEWAY_URL",
      "NODE_ENV",
      "SERVICE_ID",
      "TOPOLO_AUTH_URL",
      "account_id"
    ],
    "bindings": [
      {
        "kind": "d1",
        "binding": "AGENT_DB",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "00000000-0000-0000-0000-000000000000"
      },
      {
        "kind": "r2",
        "binding": "AGENT_LOGS",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "topolo-agent-logs-local"
      },
      {
        "kind": "vectorize",
        "binding": "KNOWLEDGE_VECTOR",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "topolo-agent-knowledge-local"
      },
      {
        "kind": "d1",
        "binding": "AGENT_DB",
        "environment": "stg",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "46570203-40bb-4a66-b1f4-66ec89abb486"
      },
      {
        "kind": "r2",
        "binding": "AGENT_LOGS",
        "environment": "stg",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "topolo-agent-logs-staging"
      },
      {
        "kind": "vectorize",
        "binding": "KNOWLEDGE_VECTOR",
        "environment": "stg",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "topolo-agent-knowledge-staging"
      },
      {
        "kind": "d1",
        "binding": "AGENT_DB",
        "environment": "prod",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "4b536b30-6fc6-430f-99c8-1c80575833bb"
      },
      {
        "kind": "r2",
        "binding": "AGENT_LOGS",
        "environment": "prod",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "topolo-agent-logs-production"
      },
      {
        "kind": "vectorize",
        "binding": "KNOWLEDGE_VECTOR",
        "environment": "prod",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "topolo-agent-knowledge-production"
      }
    ],
    "queue_bindings": [
      {
        "kind": "queue",
        "binding": "AGENT_WORKFLOW_QUEUE",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "topolo-agent-workflow-runs-local"
      },
      {
        "kind": "queue",
        "binding": "AGENT_WORKFLOW_QUEUE",
        "environment": "stg",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "topolo-agent-workflow-runs-staging"
      },
      {
        "kind": "queue",
        "binding": "AGENT_WORKFLOW_QUEUE",
        "environment": "prod",
        "sourcePath": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "target": "topolo-agent-workflow-runs-production"
      }
    ],
    "storage_kinds": [
      "d1",
      "r2",
      "vectorize"
    ],
    "workflow_signals": [
      "AGENT_WORKFLOW_QUEUE -> topolo-agent-workflow-runs-local",
      "AGENT_WORKFLOW_QUEUE -> topolo-agent-workflow-runs-staging",
      "AGENT_WORKFLOW_QUEUE -> topolo-agent-workflow-runs-production"
    ]
  },
  "deployment": {
    "commands": [
      {
        "name": "build",
        "command": "PlatformApplications/TopoloAgent/app/package.json :: vite build"
      },
      {
        "name": "preview",
        "command": "PlatformApplications/TopoloAgent/app/package.json :: vite preview"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run build --workspace=packages/backend"
      },
      {
        "name": "build:app",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run build --workspace=app"
      },
      {
        "name": "build:all",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run build && npm run build:app"
      },
      {
        "name": "deploy:web",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run build:app && CLOUDFLARE_ACCOUNT_ID=49ef1ba682ad8cfd720c86699ae17521 npx wrangler pages deploy app/dist --project-name=topolo-agent --branch=production"
      },
      {
        "name": "deploy:stg",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run deploy:stg --workspace=packages/backend"
      },
      {
        "name": "deploy:staging",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run deploy:stg && npm run deploy:web:staging"
      },
      {
        "name": "deploy:prod",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run deploy:prod --workspace=packages/backend"
      },
      {
        "name": "deploy:production",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run deploy:prod"
      },
      {
        "name": "build:app:staging",
        "command": "PlatformApplications/TopoloAgent/package.json :: VITE_API_URL=https://topolo-agent-stg.topolo-staging.workers.dev VITE_AUTH_URL=https://auth.stg.topolo.us VITE_SERVICE_ID=svc_topolo_agent VITE_CURRENT_APP_URL=https://topolo-agent-staging.pages.dev VITE_BUGFIX_API_URL=https://bugfix.stg.topolo.us npm run build --workspace=app"
      },
      {
        "name": "deploy:web:staging",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run build:app:staging && CLOUDFLARE_ACCOUNT_ID=4f4e1c69a3830946f9fea7b1eb7531ac npx wrangler@4 pages deploy app/dist --project-name=topolo-agent-staging --branch=main"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloAgent/packages/backend/package.json :: tsc --noEmit"
      },
      {
        "name": "deploy:stg",
        "command": "PlatformApplications/TopoloAgent/packages/backend/package.json :: wrangler deploy --env stg"
      },
      {
        "name": "deploy:prod",
        "command": "PlatformApplications/TopoloAgent/packages/backend/package.json :: wrangler deploy --env prod"
      }
    ],
    "routes": [],
    "environments": [
      "stg",
      "prod"
    ],
    "assets_directories": [],
    "observability_enabled": true
  },
  "debugging": {
    "failure_modes": [],
    "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"
    ]
  }
}