symbi-core

Main client for the Symbiont JavaScript/TypeScript SDK — the official client for Symbiont, the policy-governed agent runtime.

symbi-core exposes SymbiontClient plus standalone modules (webhook verification, markdown memory, skill scanning, metrics). Types are re-exported from symbi-types, so most projects only need this one install.

Install

npm install symbi-core

A running Symbiont runtime is required for client calls. The fastest way:

docker run --rm -p 8080:8080 -p 8081:8081 ghcr.io/thirdkeyai/symbi:latest up

Quick start

import { SymbiontClient } from 'symbi-core';

const client = new SymbiontClient({
  apiKey: process.env.SYMBIONT_API_KEY,
  apiUrl: 'http://localhost:8080/api/v1',
});

await client.connect();

const agents = await client.agents.listAgents();
const result = await client.agents.executeAgent(agents[0].id, { text: 'Hello, Symbiont!' });
console.log(result.result);

What's exported

| Export | Purpose | |--------|---------| | SymbiontClient | Unified client with namespaced sub-clients for every runtime surface (see SDK README) | | AuthenticationManager, MemoryTokenCache | Auth / token refresh | | HmacVerifier, JwtVerifier, createProviderVerifier | Inbound webhook signature verification (GitHub, Stripe, Slack, custom) | | MarkdownMemoryStore | File-based agent context that survives restarts | | SkillScanner, SkillLoader | ClawHavoc security scanning (10 built-in rules) + YAML frontmatter loading | | MetricsApiClient, FileMetricsExporter, CompositeExporter, MetricsCollector | Runtime metrics snapshots + periodic export | | SystemClient, CommunicationClient, ToolCladClient, ReasoningClient | Runtime sub-clients | | HttpEndpointManager | Dynamic HTTP endpoint management |

All types and Zod schemas from symbi-types are re-exported for convenience.

Companion packages

| Package | Purpose | |---------|---------| | symbi-types | Types + Zod schemas | | symbi-agent | AgentClient, ScheduleClient, ChannelClient, WorkflowClient, AgentPinClient | | symbi-policy | Policy builder | | symbi-secrets | Vault / file / env secret backends | | symbi-mcp | MCP client | | symbi-tool-review | Tool review workflow | | symbi-testing | Mocks + test helpers | | symbi-cli | Command-line tooling |

See also

• SDK README — full capabilities, examples, Trust Stack integration
• docs.symbiont.dev — runtime documentation
• Symbiont runtime — the Rust-native runtime this SDK talks to

License

Apache 2.0. See LICENSE.