Repository Overview

Repository Overview

Understand Agiwo from the repository structure.

Agiwo is organized around a canonical agent runtime, a separate scheduler orchestration layer, a tool abstraction, a model layer, and an internal control plane.

What Agiwo Contains

The repository is split across the SDK runtime, the internal Console control plane, and a small set of supporting directories for tests, scripts, and design docs. This page is generated from the code tree and selected supporting documents so it stays closer to the current repository state than a fully hand-written overview.

SDK

Path	Responsibility
Agent runtime agiwo/agent	Canonical agent runtime, execution loop, runtime state, models, nested-agent adapters, and persistence hooks. Directoryagiwo/agentRepository guideAGENTS.md
Model layer agiwo/llm	Model abstraction, provider adapters, configuration policy, and factory construction. Directoryagiwo/llmRepository guideAGENTS.md
Tool layer agiwo/tool	Tool contracts, builtin tools, execution context, process registry, and tool-side persistence. Directoryagiwo/toolRepository guideAGENTS.md
Scheduler agiwo/scheduler	Agent-level orchestration, runtime tools, lifecycle management, and scheduler state persistence. Directoryagiwo/schedulerRepository guideAGENTS.md
Observability agiwo/observability	Trace and span storage, querying, and runtime trace adaptation. Directoryagiwo/observabilityRepository guideAGENTS.md
Embedding agiwo/embedding	Embedding abstraction and provider-backed implementations. Directoryagiwo/embeddingRepository guideAGENTS.md
Skills agiwo/skill	Skill discovery, allowlisting, loading, and skill-to-tool bridging. Directoryagiwo/skillRepository guideAGENTS.md
Workspace agiwo/workspace	Workspace path semantics, bootstrap, and runtime workspace helpers. Directoryagiwo/workspaceRepository guideAGENTS.md
Memory agiwo/memory	Shared workspace memory indexing, chunking, and search services. Directoryagiwo/memoryRepository guideAGENTS.md
Configuration agiwo/config	Global SDK configuration and shared provider settings. Directoryagiwo/configRepository guideAGENTS.md
Shared utilities agiwo/utils	Cross-module runtime utilities and shared storage support. Directoryagiwo/utilsRepository guideAGENTS.md

Sources

• Directory
  agiwo/agent
• Repository guide — AGENTS.md
  AGENTS.md
• Directory
  agiwo/llm
• Directory
  agiwo/tool
• Directory
  agiwo/scheduler
• Directory
  agiwo/observability
• Directory
  agiwo/embedding
• Directory
  agiwo/skill
• Directory
  agiwo/workspace
• Directory
  agiwo/memory
• Directory
  agiwo/config
• Directory
  agiwo/utils

Console

Path	Responsibility
Control plane console/server	FastAPI control plane and runtime integration layer. Directoryconsole/serverRepository guideAGENTS.md
API boundary console/server/routers	HTTP and SSE API boundary for requests and responses. Directoryconsole/server/routersRepository guideAGENTS.md
Application services console/server/services	Application services for runtime management, registry, tool catalog, session storage, and metrics. Directoryconsole/server/servicesRepository guideAGENTS.md
Shared models console/server/models	Console-facing shared runtime, configuration, and view models. Directoryconsole/server/modelsRepository guideAGENTS.md
Channel adapters console/server/channels	Channel adapters for delivery, parsing, and integration workflows. Directoryconsole/server/channelsRepository guideAGENTS.md
Internal web UI console/web	Internal control-plane frontend for sessions, traces, scheduler, and settings. Directoryconsole/webRepository guideAGENTS.md
Console tests console/tests	Console backend test suite. Directoryconsole/testsRepository guideAGENTS.md

Sources

• Directory
  console/server
• Repository guide — AGENTS.md
  AGENTS.md
• Directory
  console/server/routers
• Directory
  console/server/services
• Directory
  console/server/models
• Directory
  console/server/channels
• Directory
  console/web
• Directory
  console/tests

Supporting directories

Path	Responsibility
SDK tests tests	SDK test suite organized by subsystem. DirectorytestsRepository guideAGENTS.md
Repo scripts scripts	Lint entrypoints, repo guardrails, and maintenance helpers. DirectoryscriptsRepository guideAGENTS.md
Guardrails lint	Import-linter and repository guard configuration. DirectorylintRepository guideAGENTS.md
Repository docs docs	Repository-native design notes, concepts, and architecture documentation. DirectorydocsRepository guideAGENTS.md
Templates templates	Template content consumed by runtime features. DirectorytemplatesRepository guideAGENTS.md

Sources

• Directory
  tests
• Repository guide — AGENTS.md
  AGENTS.md
• Directory
  scripts
• Directory
  lint
• Directory
  docs
• Directory
  templates

Core Runtime Surfaces

• agiwo.agent — Public entry for the canonical agent runtime, agent configuration, execution handles, and related types.
  agiwo.agentagiwo/agent__init__.pyagiwo/agent/__init__.pytypes.pyagiwo/agent/types.pyRepository guideAGENTS.md
• agiwo.scheduler — Public entry for orchestration, persistent roots, routing, waiting, and scheduler-backed agent coordination.
  agiwo.scheduleragiwo/schedulerengine.pyagiwo/scheduler/engine.pyRepository guideAGENTS.md
• agiwo.tool — Public entry for tool contracts, tool results, execution context, and builtin tool integration.
  agiwo.toolagiwo/toolmanager.pyagiwo/tool/manager.pyRepository guideAGENTS.md
• agiwo.llm — Public entry for model abstractions, provider implementations, and model construction helpers.
  agiwo.llmagiwo/llmfactory.pyagiwo/llm/factory.pyRepository guideAGENTS.md

Sources

• agiwo.agent
  agiwo/agent
• __init__.py
  agiwo/agent/__init__.py
• types.py
  agiwo/agent/types.py
• Repository guide — AGENTS.md
  AGENTS.md
• agiwo.scheduler
  agiwo/scheduler
• engine.py
  agiwo/scheduler/engine.py
• agiwo.tool
  agiwo/tool
• manager.py
  agiwo/tool/manager.py
• agiwo.llm
  agiwo/llm
• factory.py
  agiwo/llm/factory.py

Architectural Boundaries

• Scheduler sits on top of the agent runtime instead of the reverse direction.
  Scheduleragiwo/schedulerRepository guideAGENTS.md
• Console code should go through scheduler and agent facades rather than reading scheduler store internals directly.
  Console servicesconsole/server/servicesRepository guideAGENTS.md
• Public agent-facing types should enter through the correct facade instead of internal runtime modules when called from outside the agent package.
  Agent typesagiwo/agent/types.pyRepository guideAGENTS.md
• The public docs site is static and separate from the internal Console web app.
  Public docs sitewebsiteConsole webconsole/webDeployment guidedocs/public-site-deploy.md

Sources

• Scheduler
  agiwo/scheduler
• Repository guide — AGENTS.md
  AGENTS.md
• Console services
  console/server/services
• Agent types
  agiwo/agent/types.py
• Public docs site
  website
• Console web
  console/web
• Deployment guide — Public Site Deployment
  docs/public-site-deploy.md

Reference Documents

• Repository guide — AGENTS.md
  AGENTS.md
• Public entry README — Agiwo
  README.md
• Architecture overview — Architecture Overview
  docs/architecture/overview.md
• Getting started guide — Getting Started
  docs/getting-started.md
• Multi-agent guide — Multi-Agent & Composition
  docs/guides/multi-agent.md