TypeScript SDK

npm install memoryo-sdk

import { MemoryOS, UniversalMemoryOS } from "memoryo-sdk";

const client = new MemoryOS(process.env.MEMORYOS_API_KEY!);

const result = await client.add(
  [{
    role: "user",
    content: "I prefer concise technical explanations.",
    externalTurnId: "support-884:turn-12",
    sourceKind: "direct_user_input",
  }],
  "customer-123",
  "support-bot",
  { source: "chat" },
);

console.log(result.status);
console.log(result.jobId);

const proposal = await client.add(
  [{
    role: "assistant",
    content: "I can remember this. Proposed memory: User prefers a one-line diagnosis before numbered troubleshooting steps.",
    externalTurnId: "support-884:turn-13",
    sourceKind: "assistant_output",
    isMemoryProposal: true,
    proposedMemory: {
      content: "User prefers a one-line diagnosis before numbered troubleshooting steps.",
      category: "preference",
    },
  }],
  "customer-123",
  undefined, undefined, undefined,
  "support-884:proposal-13",
  "support-884",
);
if (proposal.proposalIds?.length) {
  console.log("Registered proposal:", proposal.proposalIds[0]);
} else {
  console.log("No proposal registered:", proposal.status, proposal.blockedReason);
}

const result = await client.add(
  [
    { role: "user", content: "What plan am I using?" },
    { role: "assistant", content: "Your current subscription plan is Growth." },
  ],
  "customer-123",
  "support-bot",
  { source: "support_chat" },
  MemoryOS.source("billing-service", {
    eventId: "billing-plan-2026-06-30-001",
    scope: { workspaceId: "ws_123" },
    evidence: [
      {
        sourceType: "subscription_record",
        reference: "billing/subscriptions/ws_123",
      },
    ],
  }),
);

const job = await client.waitForJob(result.jobId!, {
  timeoutMs: 120_000,
  pollIntervalMs: 1_000,
});

console.log(job.status);
console.log(job.memoriesCreated);
console.log(job.createdMemoryIds);
console.log(job.pendingCandidatesBuffered);
console.log(job.extractionMetadata);

const result = await client.get(
  "How should I answer this user?",
  "customer-123",
  5,
  ["preference", "goal"],
);

const promptAddition = result.hasContext ? result.systemPromptAddition : "";

const result = await client.get({
  query: "How should I answer this user?",
  externalUserId: "customer-123",
  limit: 5,
  categories: ["preference", "goal"],
  format: "bullets",
  contextMaxTokens: 500,
  asOf: undefined, // or an ISO 8601 timestamp with timezone
});

if (result.clarification) {
  // Render result.clarification.question in your existing chat and map the
  // user's selection to one of: A, B, both, neither.
  const resolution = await client.answerClarification({
    clarificationId: result.clarification.id,
    externalUserId: "customer-123",
    answer: "B",
    freeText: "The Scale plan is current.",
  });
}

const result = await client.get(
  "What language should I use for this user?",
  "customer-123",
);

// Call your LLM here using result.systemPromptAddition.

if (result.retrievalId) {
  const feedback = await client.feedback({
    retrievalId: result.retrievalId,
    outcome: "used_successfully",
    usedMemoryIds: result.items.map((item) => item.id),
    agentConfidence: 0.86,
    metadata: { agentId: "support-bot" },
  });

  console.log(feedback.feedbackId);
}

const feedback = await client.feedback({
  retrievalId: result.retrievalId!,
  outcome: "user_corrected",
  usedMemoryIds: result.items.map((item) => item.id),
  correction: "Actually I prefer Hindi explanations for billing questions, not English.",
  agentConfidence: 0.2,
  metadata: { agentId: "support-bot" },
});

console.log(feedback.correctionJobId);

const profile = await client.getEdTechProfile("student_123");

if (profile?.hasExamContext) {
  console.log(profile.examName, profile.examDate);
}

const deleted = await client.delete(
  "1c5d5ab6-73c8-4b12-90e9-0f7f9db8db4f",
  false,
);

const page = await client.list("customer-123", { limit: 50 });

for (const memory of page.items) {
  console.log(memory.content);
}

const bundle = await client.export("customer-123");

import { UniversalMemoryOS } from "memoryo-sdk";

const universal = new UniversalMemoryOS(
  process.env.MEMORYOS_AGENT_API_KEY!,
  userUuiToken,
);

const consentUrl = UniversalMemoryOS.consentUrl(
  "your_global_agent_id",
  null,
  userSessionId,
  ["preference", "goal"],
);

const result = await universal.add(
  [{ role: "user", content: "I prefer short technical answers." }],
  { source: "chat" },
  "conversation-event-123",
);

const result = await universal.get(
  "How should I personalize this answer?",
  5,
  { format: "json", contextMaxTokens: 900 },
);