The application framework for agent systems.

import { createAdapter } from "glove-core/models/providers";
import { defineAgent } from "glove-foundry";
import { z } from "zod";
import { FileStore } from "../../lib/file-store.js"; // 25 lines, from the tutorial

export default defineAgent({
  description: "Answers questions about orders",
  model: () => createAdapter({
    provider: "openrouter",
    model: "openai/gpt-4.1-mini",
    stream: true,
  }),
  // Each run is its own process: keep the transcript somewhere durable.
  store: ({ conversationId }) => FileStore.open(conversationId),
  // Resolved per run, from the instance's own data.
  systemPrompt: (_agent, ctx) =>
    `You are support for ${ctx.agentInstance.context.company}.`,
  tools: [{
    name: "lookup_order",
    description: "Find an order by id",
    inputSchema: z.object({ orderId: z.string() }),
    async do({ orderId }) {
      return { status: "success", data: { orderId, state: "shipped" } };
    },
  }],
});

$ pnpm dev

  Glove Foundry

  Local:    http://127.0.0.1:4141
  Agents:   1
  Runtime:  ready
  Types:    .foundry/routes.d.ts

# Create an instance of "support" for one customer
$ curl -s localhost:4141/api/agent-instances \
    -H 'content-type: application/json' \
    -d '{"definitionId":"support","context":{"company":"Acme"}}'
{"id":"agent_…","definitionId":"support",…}

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "http://127.0.0.1:4141/v1",
  apiKey: "unused-on-loopback",
});

// model = an instance id, or a route
// with exactly one instance
const reply = await openai.chat.completions.create({
  model: "support",
  messages: [
    { role: "user", content: "Where is order 1042?" },
  ],
});