TypeScript SDK

npm install @9d/memory

import { MemoryClient } from "@9d/memory";

const client = new MemoryClient("https://api.9dlabs.xyz", "your-api-key");

// Ingest an artifact
await client.ingest({
  workspace_id: "ws_1",
  actor_id: "user_1",
  artifact_type: "chat_turn",
  raw_payload: { role: "user", content: "I prefer Redis over Memcached." },
});

// Retrieve a context pack
const pack = await client.contextPack({
  query: "What database cache do I prefer?",
  workspace_id: "ws_1",
  max_tokens: 2048,
});

console.log(pack.context_text);
console.log(`Confidence: ${pack.confidence}`);

// Get the decision receipt
const receipt = await client.receipt(pack.receipt_id);

new MemoryClient(baseUrl: string, apiKey?: string)

const result = await client.ingest({
  workspace_id: "ws_1",
  actor_id: "system",
  artifact_type: "document",
  raw_payload: { title: "Policy", content: "..." },
  idempotency_key: "doc_001",
});

const pack = await client.contextPack({
  query: "What happened?",
  workspace_id: "ws_1",
  max_tokens: 4096,
});

await client.feedback({
  action: "pin",
  artifact_id: "...",
  span_id: "...",
  actor_id: "user_1",
  workspace_id: "ws_1",
});

const receipt = await client.receipt("receipt-uuid");

try {
  const pack = await client.contextPack({ ... });
} catch (error) {
  if (error.message.startsWith("HTTP 429")) {
    // Rate limited — back off
  } else if (error.message.startsWith("HTTP 403")) {
    // Policy denied
  }
}