@jgalego/teamapi-chat

Chat as a team or a specific team member from a Team API as Code org — backed by a live tool-use loop over the same 13 org-graph operations @jgalego/teamapi-mcp-server exposes, so the persona can answer questions about any team in the org.

Normally used via teamapi chat --team <id> [--member <id>] [--ask <question>].

Providers#

The package includes two adapters:

The openai adapter calls a configurable base URL with fetch. The shared wire format reaches Azure OpenAI, Ollama, vLLM, llama.cpp, Together, Groq, Fireworks, OpenRouter, and most self-hosted gateways without a vendor SDK. Authentication is optional because local models usually do not require it.

Install#

npm install @jgalego/teamapi-chat

Usage#

import { buildChatPersona, buildChatTools, createChatSession } from "@jgalego/teamapi-chat";

const persona = buildChatPersona(graph, { teamId: "stream-checkout", memberId: "diego-alves" });

const session = createChatSession({
  provider: "openai",
  baseUrl: "http://localhost:11434/v1", // or omit for api.openai.com
  model: "llama3.1",
  system: persona.systemPrompt,
  tools: buildChatTools(graph),
});

const answer = await session.ask("is payments overloaded right now?");
console.log(answer.text);
if (answer.stoppedBecause) console.warn(`incomplete: ${answer.stoppedBecause}`);

ask never pretends a turn finished when it didn't: stoppedBecause is tool-limit, refusal or truncated when the model stopped for a reason other than completing its answer.

Adding a provider#

A tool is a name, a description, a zod schema and a function — ChatTool, in tool.ts, with no vendor content in it. An adapter converts that list to the provider's shape and drives the call-observe-call loop, which is about a hundred lines. runToolByName handles the parts every adapter needs identically: validating arguments against the schema, and turning an unknown tool or a thrown error into a message the model can read and recover from rather than an exception that ends the turn.

Full docs and a sample transcript: https://github.com/JGalego/TeamAPI

The TeamAPI toolchain#

Seven packages expose the same org graph. Install the ones you need:

Docs, examples and the extended spec: teamapi.dev · github.com/JGalego/TeamAPI

License#

MIT