@allem-sdk/agents

Agentic AI hooks for React. Multi-step tool calling, agent status tracking, and typed tool definitions built on Vercel AI SDK v6.

Installation

npm install @allem-sdk/agents @allem-sdk/ai ai @ai-sdk/react

# Install at least one provider
npm install @ai-sdk/google    # Google Gemini
npm install @ai-sdk/anthropic # Anthropic Claude
npm install @ai-sdk/openai    # OpenAI GPT

# For defining tools with schemas
npm install zod

Client Usage

import { AllemAIProvider } from "@allem-sdk/ai";
import { useAllemAgent } from "@allem-sdk/agents";

function App() {
  return (
    <AllemAIProvider api="/api/agent" provider="google">
      <Agent />
    </AllemAIProvider>
  );
}

function Agent() {
  const {
    messages,
    sendMessage,
    agentStatus,
    steps,
    currentToolCalls,
    isAgentRunning,
  } = useAllemAgent();

  return (
    <div>
      {agentStatus === "calling-tool" && (
        <p>Using tool: {currentToolCalls[0]?.toolName}</p>
      )}
      {messages.map((m) => (
        <div key={m.id}>
          {m.parts?.filter((p) => p.type === "text").map((p) => p.text).join("")}
        </div>
      ))}
      <p>Steps taken: {steps.length}</p>
    </div>
  );
}

Server Usage

// app/api/agent/route.ts (Next.js)
import { createAllemAgentHandler, createAllemTool } from "@allem-sdk/agents";
import { google } from "@ai-sdk/google";
import { z } from "zod";

const weatherTool = createAllemTool({
  description: "Get the current weather for a location",
  parameters: z.object({ city: z.string() }),
  execute: async ({ city }) => {
    return { city, temperature: 72, condition: "sunny" };
  },
});

export const POST = createAllemAgentHandler({
  providers: {
    google: (model) => google(model ?? "gemini-2.0-flash"),
  },
  tools: { weather: weatherTool },
});

Exports

| Export | Type | Description | |--------|------|-------------| | useAllemAgent | Hook | Agent hook with status tracking, step history, and tool call awareness | | AgentProvider | Component | Optional context for registering tool metadata (names/descriptions) | | useAgentTools | Hook | Read registered tool metadata from AgentProvider | | createAllemAgentHandler | Server | Request handler with tool calling support for agentic workflows | | createAllemTool | Server | Typed tool definition helper with zod schema validation |

Part of Allem SDK

This package can be used standalone or as part of the full SDK. Install allem-sdk to get all packages in one install.

Support

If you find Allem SDK useful, consider supporting its development:

License

MIT - Ahmed Allem