LangChain & Vercel AI SDK - Gork

LangChain

@gork/sdk ships four StructuredTool tools plus two assembly helpers — gorkTools (aliased as createGorkTools) and the GorkToolkit class.

npm i @gork/sdk @langchain/core zod

import { gorkTools, createGorkTools, GorkToolkit } from "@gork/sdk/langchain";

// All three are equivalent:
const toolsA = gorkTools({ apiKey: process.env.GORK_API_KEY });
const toolsB = createGorkTools({ apiKey: process.env.GORK_API_KEY });
const toolsC = new GorkToolkit({ apiKey: process.env.GORK_API_KEY }).getTools();

Tool	What it does
`gork_create_inbox`	Provision an agent inbox (`username`, `name?`)
`gork_send_email`	Send from an inbox (`inboxId`, `to`, `subject`, `text`)
`gork_read_emails`	List mail (`inboxId?`, `threadId?`, `limit?`)
`gork_reply_email`	Threaded reply (`inboxId`, `messageId`, `to`, `subject`, `text`)

import { gorkTools } from "@gork/sdk/langchain";

const tools = gorkTools({ apiKey: process.env.GORK_API_KEY });
// Pass `tools` to your LangChain agent executor alongside your model.

Vercel AI SDK

getGorkAiTools returns tools that drop straight into generateText / streamText. Pass a Gork client or { apiKey, baseUrl }.

npm i @gork/sdk ai zod

import { generateText } from "ai";
import { Gork } from "@gork/sdk";
import { getGorkAiTools } from "@gork/sdk/ai";

const gork = new Gork({ apiKey: process.env.GORK_API_KEY });

const { text } = await generateText({
  model: "openai/gpt-4o-mini",
  tools: getGorkAiTools(gork),
  prompt: "Send a follow-up to prospect@example.com from inbox inb_123.",
});

Tool	What it does
`gork_create_inbox`	Provision an agent inbox
`gork_list_inboxes`	List inboxes on this key
`gork_send_email`	Send (`inboxId`, `to`, `subject`, `text`, `inReplyTo?`)
`gork_read_emails`	List / search (`inboxId?`, `q?`, `limit?`)
`gork_get_message`	Full body of one message (`messageId`)
`gork_create_draft`	Draft for human review
`gork_send_draft`	Dispatch a draft (`draftId`)

Agent-called sends execute immediately. For approval flows, expose only the draft tools (gork_create_draft, gork_send_draft) and let a human trigger the send.