Go SDK
The Memory Go SDK is a fully type-safe client library for the Memory API, providing 29 service clients that cover the complete API surface.
Installation
Section titled “Installation”go get github.com/emergent-company/emergent.memory/apps/server/pkg/sdk@latestModule path: github.com/emergent-company/emergent.memory/apps/server/pkg/sdk
Current Version
Section titled “Current Version”v0.8.0 (unreleased) — See Changelog for full history.
Features
Section titled “Features”| Feature | Details |
|---|---|
| Service clients | 29 clients covering the full API surface |
| Authentication | API key, API token (emt_*), and OAuth device flow |
| Multi-tenancy | SetContext(orgID, projectID) propagates to 21 context-scoped clients |
| Streaming | SSE streaming for chat responses via chat.StreamChat |
| Error handling | Structured errors.Error with IsNotFound, IsForbidden, etc. |
| Graph utilities | graphutil.IDSet, ObjectIndex, UniqueByEntity for the dual-ID model |
| Thread safety | SetContext and all service clients use sync.RWMutex |
Quick Example
Section titled “Quick Example”package main
import ( "context" "fmt" "log"
sdk "github.com/emergent-company/emergent.memory/apps/server/pkg/sdk")
func main() { client, err := sdk.New(sdk.Config{ ServerURL: "https://memory.emergent-company.ai", Auth: sdk.AuthConfig{ Mode: "apikey", APIKey: "your-api-key", }, OrgID: "org_abc123", ProjectID: "proj_xyz789", }) if err != nil { log.Fatal(err) } defer client.Close()
// List graph objects resp, err := client.Graph.ListObjects(context.Background(), nil) if err != nil { log.Fatal(err) } fmt.Printf("Found %d objects\n", len(resp.Objects))}Service Clients
Section titled “Service Clients”Context-Scoped (25 clients)
Section titled “Context-Scoped (25 clients)”These clients send X-Org-ID and X-Project-ID headers on every request. Call client.SetContext(orgID, projectID) to update 21 of them atomically (Projects, Orgs, Users, and APITokens require re-initialization to change context).
| Client | Field | Description |
|---|---|---|
| Graph | client.Graph |
Graph objects, relationships, search, traversal |
| Documents | client.Documents |
Document upload, retrieval, deletion |
| Search | client.Search |
Unified lexical/semantic/hybrid search |
| Chat | client.Chat |
Conversations, messages, SSE streaming |
| Chunks | client.Chunks |
Chunk retrieval and deletion |
| Chunking | client.Chunking |
Re-chunk documents |
| Agents | client.Agents |
AI agent lifecycle and execution |
| AgentDefinitions | client.AgentDefinitions |
Agent definition CRUD |
| Branches | client.Branches |
Graph branch management |
| Projects | client.Projects |
Project CRUD and member management |
| Orgs | client.Orgs |
Organization CRUD |
| Users | client.Users |
User profile management |
| APITokens | client.APITokens |
API token lifecycle |
| MCP | client.MCP |
MCP JSON-RPC client |
| MCPRegistry | client.MCPRegistry |
MCP server registry |
| DataSources | client.DataSources |
Data source integrations |
| DiscoveryJobs | client.DiscoveryJobs |
Type discovery workflow |
| EmbeddingPolicy | client.EmbeddingPolicy |
Embedding policy management |
| Integrations | client.Integrations |
Third-party integrations |
| TemplatePacks | client.TemplatePacks |
Template pack assignment |
| TypeRegistry | client.TypeRegistry |
Project type definitions |
| Notifications | client.Notifications |
Notification management |
| Tasks | client.Tasks |
Background task tracking |
| Monitoring | client.Monitoring |
Extraction job monitoring |
| UserActivity | client.UserActivity |
User activity tracking |
Non-Context (4 clients)
Section titled “Non-Context (4 clients)”These clients do not require org/project context.
| Client | Field | Description |
|---|---|---|
| Health | client.Health |
Health probes, debug info, job metrics |
| Superadmin | client.Superadmin |
Administrative operations (superadmin role required) |
| APIDocs | client.APIDocs |
Built-in API documentation browser |
| Provider | client.Provider |
AI provider/model configuration |
Guides
Section titled “Guides”- Authentication — API key, API token, and OAuth device flow
- Multi-Tenancy —
SetContextand context-scoped clients - Error Handling — Structured errors with predicates
- Streaming — SSE chat streaming
- Graph ID Model — Dual-ID model:
VersionIDvsEntityID