Skip to content

Core concepts ​

Cybros uses familiar agent vocabulary where the responsibility matches and keeps distinct words where identity, authority or lifecycle differ. This page is the short version; the glossary lists every term.

The four you meet first ​

ConceptWhat it is
AgentA member of the Account with its own identity, plus a configuration its application declares: tools, approval mode and rules, prompt mechanism, compaction policy, default model, ordered fallback models, lifecycle hooks and prompt documents.
RunnerAn execution environment's delivery address. It serves tools bound to a machine — files, shell, processes — and claims work from its own inbox. A run may use several runners.
ConversationThe durable dialogue a person works in: inputs, turns, candidate answers, forks, memory and access rules.
RunOne durable execution: a graph of model and tool tasks with dependencies, approvals, deadlines and write-once results. A run usually backs a conversation turn; it can also run standalone.

Where a hosted platform has one session object, Cybros has a Conversation (the person's unit) and the Runs that back its turns (the execution unit). Where a hosted platform has an environment, Cybros has a Runner that is always yours.

Account and members ​

  • Account — the installation's single trust domain. Everything lives under it: users, workspaces, conversations, executors, credentials and usage.
  • Human — a person with a login. Owners and administrators manage account-wide settings; every human manages their own agents and runners.
  • Agent — an agent-kind member. Each agent has a human steward responsible for it. Agents derive data access from their steward and never gain administration rights.
  • Workspace — the required container for conversations and runs. A workspace has one human owner and is either private (owner and their agents) or account-wide.

Execution ​

  • Executor — a delivery address with its own transport credential. Three kinds: agent application (the program that implements an agent), runner and tool provider. The executor is where work is delivered; the agent whose authority the work uses is frozen on each task separately.
  • Task — one unit of work in a run. A task is addressed to an executor, claimed exclusively, extended if needed, and committed once.
  • Tool — a callable declared on the agent's configuration. Four sources share one provenance model: kernel tools (delegate_task, ask, memory_*, …), runner tools, tool-provider tools and the agent application's own tools.
  • Approval — a kernel stage every tool call crosses. The agent's mode (bypass, ask, rules) and its rule list decide whether a call runs, parks for a person, or is refused.

Conversation structure ​

  • Input — accepted intent waiting for delivery: a user message, a steering instruction, kernel mail carrying a background result, or a scheduled instruction.
  • Turn — one slot on the conversation timeline, holding an opening input and its reply.
  • Variant — one candidate answer for a turn. Regeneration adds a variant; editing or importing content creates one without running a model.
  • Fork — a new conversation branched from a point in history. A side conversation is a particular fork mode.
  • Memory — model-readable documents scoped to a conversation, a workspace, a person or the answering agent, separate from history and from working files.
  • Store — opaque JSON state an application keeps on a workspace, a conversation or its own profile.

Models ​

  • Model provider — a configured lane to a model-serving backend: a cloud API, a subscription authorization or a local server.
  • Model — a definition with a reference such as openrouter/provider/model, capability declarations, context limits, optional pricing and visibility. Agents discover usable models; administrators manage them.
  • InferenceRequest — a direct, bounded model call outside a conversation: text, image, speech, transcription or embedding.

Signals ​

Two primitives that are never conflated:

  • Awareness — notifications fanned out to subscribed or mentioned principals. An agent may ignore them.
  • Obligation — an inbox task addressed to an executor with a claim, a deadline and a write-once result. Only obligation carries execution semantics.

Realtime channels carry hints and streams; HTTP carries commands, current state and durable event replay. An open socket never proves that work exists or succeeded.

Nexus is licensed O’Saasy. The rest of the repository defaults to MIT.