README
¶
openbotstack-core
Documentation
¶
Overview ¶
Package openbotstack provides the control plane interfaces and models for OpenBotStack.
OpenBotStack is an open-source, enterprise-oriented AI execution stack that provides users with a "perceived persistent AI assistant" while keeping execution ephemeral, governed, and auditable.
This module (openbotstack-core) defines:
- Skill definitions and registry
- Agent state machine and lifecycle
- Memory abstraction interfaces
- Policy and permission interfaces
- Audit event schemas
- Core domain models (Tenant, User, AssistantProfile)
Key Principles:
- Request-scoped, ephemeral execution (agents are NOT persistent processes)
- Control plane only (no tool execution, no network calls, no side effects)
- Stateless between requests (all state is persisted externally)
- Bounded reflection (no infinite loops, no unbounded self-modification)
- Auditable and deterministic (all decisions must be traceable)
- Interfaces over implementations (core defines contracts, runtime implements)
For execution-related functionality, see github.com/openbotstack/openbotstack-runtime.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
access
|
|
|
ratelimit
Package ratelimit provides hierarchical rate limiting for OpenBotStack.
|
Package ratelimit provides hierarchical rate limiting for OpenBotStack. |
|
Package audit provides audit event schemas for OpenBotStack.
|
Package audit provides audit event schemas for OpenBotStack. |
|
Package context provides context assembly for OpenBotStack.
|
Package context provides context assembly for OpenBotStack. |
|
control
|
|
|
agent
Package agent provides the Agent orchestration layer for OpenBotStack runtime.
|
Package agent provides the Agent orchestration layer for OpenBotStack runtime. |
|
assistants
Package model provides core domain models for OpenBotStack.
|
Package model provides core domain models for OpenBotStack. |
|
policies
Package policy provides policy and permission interfaces for OpenBotStack.
|
Package policy provides policy and permission interfaces for OpenBotStack. |
|
Package runtime defines the execution interfaces for openbotstack-core.
|
Package runtime defines the execution interfaces for openbotstack-core. |
|
internal
|
|
|
version
Package version provides build version information.
|
Package version provides build version information. |
|
memory
|
|
|
abstraction
Package memory provides abstract access to the agent's memory.
|
Package memory provides abstract access to the agent's memory. |
|
registry
|
|
|
skills
Package skill defines the Skill interface and SkillRegistry for OpenBotStack.
|
Package skill defines the Skill interface and SkillRegistry for OpenBotStack. |
Click to show internal directories.
Click to hide internal directories.