For developers

Build with and inside DataMind Oda: SDKs, automation and remote APIs, plugin development, testing benches and internals.

• Oda SDK overview

  The parts of the Oda SDK, how a client starts a runtime and talks to it, and where to read next.

• TypeScript client guide

  Use the Oda SDK client: launch options, defaults, the run loop, error messages and clean shutdown.

• SDK wire protocol

  The JSON-RPC messages the Oda SDK exchanges, their payloads, error codes and documented limits.

• Run an Oda runtime server

  Serve an Oda SDK client over standard input and output, and know what the runtime does at the handshake, prompts, images, statuses and shutdown.

• Preset compositions

  For advanced authors: how a preset is declared in a composition, and how to read the composition inventory.

• The Oda Remote API

  The interface the Oda client uses to drive sessions and events: calls, streams, forwarded events, limits and close codes.

• Automation with ACP

  Drive Oda from your own automation client over standard input and output, with sessions, permissions and configuration options.

• Remote APIs

  For package authors: how Remote methods are declared, called, streamed and validated.

• Building and loading package artifacts

  For package authors: how build-time artifacts are generated, loaded and registered, with their messages.

• The Cordis API catalog

  How the API catalog and its documentation regions are generated, gated and served.

• How Oda stores chats

  Where a chat's history lives, what a log records, and how older logs are brought forward.

• Chat log format and compatibility

  The rules that keep older chat logs readable: versioning, change kinds and retention.

• Permissions and approvals

  How Oda decides what it may do: approval prompts, presets, sandboxes and authority rules.

• Subagents and Agent Teams

  How Oda delegates work to subagents and teammates, and the controls that bound them.

• Tool availability

  Why some Oda tools appear only in some deployments, and what happens when one is missing.

• Developer inspector

  For Oda maintainers: turn on the built-in inspection endpoint and connect developer tools to the app.

• The suggest-task tool and service

  For Oda developers: the suggestion tool's fields and refusals, the service behind the cards, and the authority rules for started chats.

• Extending Oda's interface

  Add UI to Oda through slots, use the client services, and follow the copy and theme rules.

• Testing tiers

  For Oda developers: the test benches available, what each proves, and how to choose one for a given change.

• The mock LLM server

  For Oda developers: run a scripted model server for tests and demos, and understand its behaviours, failure cases and limits.

• Plugins and configuration

  Install and manage plugins, and where a plugin's configuration is described.

• Recorded-session snapshots

  For Oda developers: the recorded-session test suite: fixtures, tokens, generations, and record, replay and refresh.

• Session replay fixtures

  For Oda developers: replay model traffic from recorded sessions, with overrides for what changed.

• The loader smoke test

  For Oda developers: boot an application fixture from its real entry point and drive one task through it.

• Remote mocks and the client test runtime

  For Oda developers: endpoint-named mocks for the client's remote calls and the runtime that boots the real web client against them.

• The agent-loop testkit

  For Oda developers: mount the agent loop in tests, create and claim agents, and stub their inboxes.

• The Oda Python SDK

  Install the Python SDK and drive DataMind Oda as a subprocess from your own Python programs.

• Python SDK reference

  Look up the Python SDK's sessions, results, events, supported platforms and error messages.

• Web search providers

  Configure the search provider Oda uses, fix search failures, and understand what each provider returns and costs.

• GitHub webhooks

  Connect a repository's webhooks so deliveries start Oda work, and read what runs and what cannot.

• The workflow tool

  What the workflow tool does, how a script fans work out across helper agents, and how to follow or stop a run.

• Workflow runs: limits and failures

  The limits that apply to workflow runs, how runs end, and the errors a script or a run can report.

• Background runs and jobs

  Follow, read and stop long-running work started in the background, from the job list and the activity monitor.

• The Ralph tool

  The Ralph tool: fresh-agent loops, when Oda uses them, their limits and the reports they produce.

• How Oda stores workspaces

  Where Oda keeps its workspace list, how chats join a workspace, and what removal, hiding and archiving never touch.

• Platform support

  Which systems Oda runs on, and the native pieces behind its confinement and file locking.

• Building and shipping Oda

  Run, build and package Oda from source, and how builds are identified and published.

• Live reload for client plugins

  For plugin developers: how edited client code swaps into an open Oda page while you work, and what to do when a reload fails.

• Oda SDK: TypeScript client

  Use the Oda SDK from TypeScript: launch settings, defaults, the run loop, errors and shutdown.

• Language packs

  For plugin developers: add a language to Oda's interface, follow the registry rules, and read the validation and lookup messages.

• Oda SDK: Python

  Install the Oda Python SDK, choose a profile, and run your first task from Python.

• How client plugins load

  For plugin developers: how client plugins are listed, prefetched and loaded into the interface, and what the loading metadata means.

• Oda SDK: Python reference

  The Oda Python SDK reference: results, lifecycle, errors and the wire surface.

• Oda SDK: the runtime server

  Run a session server for out-of-process clients: behaviour, status mapping, shutdown and validation rules.

• Terminal sessions

  The persistent shells Oda keeps between steps: lifecycle, readiness, signals, limits and cleanup.

• Terminal tools

  The six terminal tools, their parameters, results and limits.

• The mock model server

  A local server that stands in for the model with scripted responses, for tests without a key.

• Client test benches

  Boot Oda's client in tests and mock the interfaces it talks to.

• Remote methods and streams

  The programming model for plugin methods that clients call across a process boundary: decorators, streams, cancellation and error codes.

• Plugin artifacts and the catalog

  How plugin artifacts are generated and loaded, the checks that must pass, and how the machine-readable API catalog stays fresh.