JSPM – @funkai/agents@1.0.0

Package Exports

@funkai/agents

Readme

@funkai/agents

Lightweight workflow and agent orchestration framework built on the Vercel AI SDK.

Features

⚡ Functions all the way down — agent, tool, workflow are functions that return plain objects.
🧩 Composition over configuration — Combine small pieces instead of configuring large ones.
🛡️ Result, never ~~panic~~ throw — Every public method returns Result<T>. Pattern-match on ok instead of try/catch.
🔒 Closures are state — Workflow state is just let variables in your handler.
🔍 $ is optional sugar — The $ helpers register data flow for observability; plain imperative code works too.

Install

npm install @funkai/agents

Usage

Agent

import { agent } from "@funkai/agents";
import { openai } from "@ai-sdk/openai";

const helper = agent({
  name: "helper",
  model: openai("gpt-4.1"),
  system: "You are a helpful assistant.",
});

const result = await helper.generate({ prompt: "What is TypeScript?" });

if (!result.ok) {
  console.error(result.error.code, result.error.message);
} else {
  console.log(result.output);
}

Tool

import { tool } from "@funkai/agents";
import { z } from "zod";

const fetchPage = tool({
  description: "Fetch the contents of a web page by URL",
  inputSchema: z.object({ url: z.url() }),
  execute: async ({ url }) => {
    const res = await fetch(url);
    return { url, status: res.status, body: await res.text() };
  },
});

Flow Agent

import { flowAgent } from "@funkai/agents";
import { z } from "zod";

const research = flowAgent(
  {
    name: "research",
    input: z.object({ topic: z.string() }),
    output: z.object({ summary: z.string(), sources: z.array(z.string()) }),
  },
  async ({ input, $ }) => {
    let sources: string[] = [];

    const data = await $.step({
      id: "fetch-sources",
      execute: async () => findSources(input.topic),
    });
    if (data.ok) sources = data.value;

    const analysis = await $.agent({
      id: "summarize",
      agent: summarizer,
      input: { text: sources.join("\n") },
    });

    return {
      summary: analysis.ok ? analysis.value.output : "Failed to summarize",
      sources,
    };
  },
);

const result = await research.generate({ topic: "Effect systems" });

Streaming

const result = await helper.stream({ prompt: "Explain closures" });

if (result.ok) {
  for await (const part of result.fullStream) {
    if (part.type === "text-delta") {
      process.stdout.write(part.textDelta);
    }
  }
}

API

Export	Description
`agent(config)`	Create an agent. Returns `{ generate, stream, fn }`.
`tool(config)`	Create a tool for function calling.
`flowAgent(config, handler)`	Create a flow agent with typed I/O and tracked steps.
`createFlowEngine(config)`	Create a flow agent factory with shared configuration and custom steps.

Documentation

For comprehensive documentation, see the Agents concept and agent() reference.

License

MIT