{
  "generated_at": "2026-04-10T10:31:25.505Z",
  "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-07",
    "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."
    },
    "primary_hosts": [
      "https://agent.topolo.app",
      "https://topolo-agent.pages.dev"
    ],
    "doc_paths": [
      "applications/agent",
      "internal/apps/agent"
    ],
    "dependencies": [
      "topolo-auth"
    ],
    "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-07"
      }
    ],
    "internal": [],
    "runbooks": []
  },
  "authority": {
    "owners": [
      "ai-platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloAgent"
    ],
    "service_ids": [
      "svc_topolo_agent"
    ],
    "dependencies": [
      "topolo-auth"
    ],
    "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": [
      {
        "name": "workspace.read",
        "description": "View the Agent operating workspace",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "workspace.write",
        "description": "Update workspace state and org memory",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "workflows.read",
        "description": "View workflow plans and runs",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "workflows.write",
        "description": "Create and run workflow plans",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "reports.read",
        "description": "View reports, artifacts, and work feed output",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "approvals.write",
        "description": "Approve or reject gated Agent actions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      }
    ],
    "service_permissions": [
      {
        "name": "workspace:read",
        "description": "View the Agent operating workspace",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "workspace:write",
        "description": "Update workspace state and org memory",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "workflows:read",
        "description": "View workflow plans and runs",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "workflows:write",
        "description": "Create and run workflow plans",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "reports:read",
        "description": "View reports, artifacts, and work feed output",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "approvals:write",
        "description": "Approve or reject gated Agent actions",
        "resourcePattern": null,
        "kind": "permission"
      }
    ]
  },
  "runtime": {
    "primary_hosts": [
      "https://agent.topolo.app",
      "https://topolo-agent.pages.dev"
    ],
    "repo_entries": [
      "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"
    ],
    "wrangler_surfaces": [
      {
        "path": "PlatformApplications/TopoloAgent/app/wrangler.toml",
        "observabilityEnabled": false,
        "environments": [],
        "routes": [],
        "vars": [],
        "bindings": [],
        "cronTriggers": [],
        "workerName": "topolo-agent",
        "compatibilityDate": "2026-04-05"
      },
      {
        "path": "PlatformApplications/TopoloAgent/packages/backend/wrangler.toml",
        "observabilityEnabled": true,
        "environments": [
          "stg",
          "prod"
        ],
        "routes": [],
        "vars": [
          "CLOUDFLARE_ACCOUNT_ID",
          "ENVIRONMENT",
          "NODE_ENV",
          "SERVICE_ID",
          "SKIP_AUTH",
          "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": "00000000-0000-0000-0000-000000000000"
          },
          {
            "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"
          }
        ],
        "cronTriggers": [],
        "workerName": "topolo-agent-worker",
        "main": "index.ts",
        "compatibilityDate": "2025-06-20"
      }
    ],
    "packages": [
      {
        "path": "PlatformApplications/TopoloAgent/app/package.json",
        "name": "topolo-agent-app",
        "scripts": [
          "dev",
          "build",
          "preview",
          "lint"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "vite"
          },
          {
            "name": "build",
            "command": "vite build"
          },
          {
            "name": "preview",
            "command": "vite preview"
          },
          {
            "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:stg",
          "deploy:prod",
          "lint"
        ],
        "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:stg",
            "command": "npm run deploy:stg --workspace=packages/backend"
          },
          {
            "name": "deploy:prod",
            "command": "npm run deploy:prod --workspace=packages/backend"
          },
          {
            "name": "lint",
            "command": "npm run lint --workspace=app && npm run lint --workspace=packages/backend"
          }
        ]
      },
      {
        "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",
      "NODE_ENV",
      "SERVICE_ID",
      "SKIP_AUTH",
      "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": "00000000-0000-0000-0000-000000000000"
      },
      {
        "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": [],
    "storage_kinds": [
      "d1",
      "r2",
      "vectorize"
    ],
    "workflow_signals": []
  },
  "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:stg",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run deploy:stg --workspace=packages/backend"
      },
      {
        "name": "deploy:prod",
        "command": "PlatformApplications/TopoloAgent/package.json :: npm run deploy:prod --workspace=packages/backend"
      },
      {
        "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"
    ]
  }
}