Packages
Every @robota-sdk/* package with its own documentation. Each page links to the package's SPEC — its contract, invariants and design decisions. Packages marked internal are part of the monorepo but not published to npm.
@robota-sdk/agent-cli— @robota-sdk/agent-cli provides robota, an AI coding assistant for the terminal and the maintained agent interface built from the Robota libraries. The CLI owns argument parsing, the choice of presentation — the terminal UI, print mode (-p)…@robota-sdk/agent-core— @robota-sdk/agent-core is the foundation package of the Robota SDK. It owns the ConversationAgent agent and its execution loop, the provider, tool and plugin contracts, message and history types, permission evaluation, the hook runner, eve…@robota-sdk/agent-executor— @robota-sdk/agent-executor owns the runtime layer for long-running agent runtime work: the background task manager and its state machine, snapshots, watchdogs and log pages; the shell, scheduled and tool-invocation runners; the subagent ma…@robota-sdk/agent-framework— @robota-sdk/agent-framework is the assembly layer of the Robota SDK. It owns InteractiveSession, createQuery() and createAgentRuntime(), and the pieces they compose: workspace trust and project access, settings and context loading (AGENTS.…@robota-sdk/agent-gui-web(internal) — The GUI as a web app. A private product-shell package: the desktop app (apps/agent-app) loads its build, the configured CLI serves it with --serve --open, and it runs in a browser for development:@robota-sdk/agent-interface— Type contracts for the Robota SDK, one subpath per family.@robota-sdk/agent-keyring— @robota-sdk/agent-keyring owns key custody and sealing for secure conversations: a passphrase and a recovery key each unwrap one master key, the master key derives a sealing keypair, an attach keypair and an authorship key, and artifacts a…@robota-sdk/agent-local-host(internal) — @robota-sdk/agent-local-host is the private Node-only authority for owner-controlled local runtime state: the keyring file store, the owner-private session directory and control carrier through which a supervised runtime is registered and…@robota-sdk/agent-mcp— The Model Context Protocol client for the Robota SDK. It lets an agent use tools from external MCP servers while keeping three concerns separate: definitions (decoding configuration, precedence between sources, disable overlays, redacted p…@robota-sdk/agent-organization— @robota-sdk/agent-organization owns the shared canonical JSON and organization resource budget contracts: deterministic, bounded canonical JSON for interoperable resource records, and validators for immutable resource units and budgets. It…@robota-sdk/agent-organization-host(internal) — @robota-sdk/agent-organization-host is the private workspace SDK for an operator-owned organization broker: signed workload, request and approval contracts, durable hierarchical budget reservations, fenced task and Git state, and an indepe…@robota-sdk/agent-os— @robota-sdk/agent-os holds the Node host primitives of the Robota SDK, one subpath each: bounded root-relative file reads and atomic UTF-8 writes through a retained native directory authority (file-authority), nonblocking operation locks b…@robota-sdk/agent-plugin— @robota-sdk/agent-plugin owns the ready-made plugins of the Robota SDK: ConversationHistoryPlugin, ErrorHandlingPlugin, ExecutionAnalyticsPlugin, LimitsPlugin, LoggingPlugin, PerformancePlugin, UsagePlugin and WebhookPlugin. Each extends A…@robota-sdk/agent-product— @robota-sdk/agent-product owns the product-assembly kernel: the IProductProfile declaration, the IAssembledProduct result, and assembleProduct(profile), a pure, deterministic, I/O-free fold that turns a profile into runtime materials. It r…@robota-sdk/agent-provider— @robota-sdk/agent-provider holds the official provider implementations, one subpath per vendor. The package README lists the subpaths and what to install for each.@robota-sdk/agent-provider-replay(internal) — @robota-sdk/agent-provider-replay is an internal test utility (private, not published to npm). It is a provider that answers each chat call with the next response recorded in an agent session log, so a real conversation can run offline, de…@robota-sdk/agent-remote-pairing— Pairing and DTLS-fingerprint channel binding for Robota's peer-to-peer remote control. A host proves that a connecting peer holds a single-use pairing secret and binds that proof to the DTLS channel each side actually observes, so a signal…@robota-sdk/agent-roundtable— @robota-sdk/agent-roundtable coordinates independently constructed agents and people in one shared conversation: it selects turns, runs parallel groups, and publishes their messages in a stable order while each participant keeps its own ru…@robota-sdk/agent-roundtable-robota— @robota-sdk/agent-roundtable-robota runs an agent runtime Session or a plain ConversationAgent agent as an @robota-sdk/agent-roundtable participant, and an agent as its selector: rendering, per-call metering, approval-wait mapping, checkpo…@robota-sdk/agent-session— @robota-sdk/agent-session owns the session lifecycle of the Robota SDK: permission-gated tool execution, lifecycle hooks, context-window tracking, compaction, versioned session logs and replay, and session-record persistence. Session logs…@robota-sdk/agent-session-analytics— @robota-sdk/agent-session-analytics analyzes persisted agent session records: per-turn timing (LLM wait vs. tool execution), token usage and cost per source, cross-session personal usage, and content-free OTLP projections of that usage. It…@robota-sdk/agent-subagent-runner— @robota-sdk/agent-subagent-runner is the optional child-process runner for agent runtime subagents. It implements agent-executor's ISubagentRunner by starting a copy of the running program in worker mode, sending the job over a validated I…@robota-sdk/agent-telemetry-otel— @robota-sdk/agent-telemetry-otel turns Robota's provider calls and tool bodies into OpenTelemetry spans, with either Robota's agent.* names or the OpenTelemetry GenAI semantic conventions: recorded on the host's tracer for a run, or projec…@robota-sdk/agent-tools— @robota-sdk/agent-tools owns the Robota SDK's tool implementations: the Zod tool factories, the built-in tools (Shell, Read, Write, Edit, Glob, Grep, WebFetch, AskUserQuestion, ToolSearch), codebase retrieval and computer-use tools, the sa…@robota-sdk/agent-transport— The transport-neutral protocol layer shared by every agent runtime transport: the wire messages a client and a host exchange, the session bridge that applies them to a live session, and the delivery helpers (backpressure, resumable deliver…@robota-sdk/agent-ui-terminal— @robota-sdk/agent-ui-terminal is the React + Ink terminal UI package for the Robota SDK. It owns the Ink rendering pipeline, the session-owning TuiInteractionChannel, the full TUI attached to a daemon's session, and the supervised-session…@robota-sdk/agent-ui-web— The GUI presentation layer for an agent session — the graphical analog of @robota-sdk/agent-ui-terminal. It reconstructs conversation state from the transport-neutral TServerMessage stream and renders it as React components. Its public /cl…@robota-sdk/product-config— The pure entry exports PRODUCT_CONFIG_DESCRIPTORS, PRODUCT_CONFIG_FILE_VARIABLE, ProductConfigError, productConfigEntries, productSettingAlias, resolveProductConfig, generateDefaultEnvironment, publicProductConfig, parsePublicProductConfig…