npm install @anima-labs/toolkit-langchain @langchain/core
# plus `langchain` if you use createAgent as below

export ANIMA_API_KEY=ak_...      # your agent (or org) API key
export ANIMA_AGENT_ID=agent_...  # the agent to act as

import { createAgent } from "langchain";
import { createAnimaTools } from "@anima-labs/toolkit-langchain";

const agent = createAgent({
  model: "openai:gpt-5",
  tools: createAnimaTools(), // reads ANIMA_API_KEY / ANIMA_AGENT_ID
});

const result = await agent.invoke({
  messages: [
    { role: "user", content: "Check my inbox for new mail and summarize anything important." },
  ],
});

const tools = createAnimaTools({ apiKey: "ak_...", agentId: "agent_..." });

export ANIMA_TO=you@example.com  # where to send — watch it arrive in your inbox

import { createAnimaTools } from "@anima-labs/toolkit-langchain";

const tools = createAnimaTools();
const byName = Object.fromEntries(tools.map((t) => [t.name, t]));

// Send a real email through the send_email tool
const sent = JSON.parse(
  (await byName.send_email.invoke({
    to: [process.env.ANIMA_TO!],
    subject: "Hello from my LangChain agent",
    body: "This email was sent through the Anima LangChain toolkit.",
  })) as string,
);
console.log(`Sent ${sent.id} (${sent.status})`);

// Read it back from the agent's outbox
const outbox = JSON.parse(
  (await byName.list_emails.invoke({ direction: "OUTBOUND", limit: 5 })) as string,
);
const copy = outbox.emails.find((m: { id: string }) => m.id === sent.id);

const full = JSON.parse((await byName.get_email.invoke({ messageId: copy.id })) as string);
console.log(`Read back: "${full.subject}" -> ${full.to}`);

const inbox = JSON.parse(
  (await byName.list_emails.invoke({
    direction: "INBOUND",
    since: "2026-07-16T00:00:00Z",
    limit: 20,
  })) as string,
);