@kognitivedev/tools

Provider-agnostic tool system for Kognitive agents and runtimes.

Installation

bun add @kognitivedev/tools zod

Quick Start

import { createTool, ToolRegistry } from "@kognitivedev/tools";
import { z } from "zod";

const searchTool = createTool({
  id: "search",
  description: "Search documentation",
  inputSchema: z.object({ query: z.string() }),
  execute: async (input, context) => {
    context.emit("progress", { query: input.query });
    return { results: [`Result for: ${input.query}`] };
  },
});

const registry = new ToolRegistry();
registry.register(searchTool);

console.log(registry.all().map((tool) => tool.id));

Features

• createTool for typed tool definitions
• ToolRegistry for grouping and lookup
• requireApproval for human-in-the-loop execution
• toModelOutput for summarizing large tool results
• Neutral ToolContext with abortSignal, resourceId, memory, metadata, and emit

Provider Bridges

The neutral package no longer exports provider-specific conversion helpers. Use adapter packages when you need a concrete runtime bridge:

• @kognitivedev/adapter-ai-sdk for toAISDKTool() and toAISDKTools()
• @kognitivedev/adapter-claude-agent-sdk when tools should be exposed through Claude Agent SDK's MCP bridge

import { createTool } from "@kognitivedev/tools";
import { toAISDKTool } from "@kognitivedev/adapter-ai-sdk";

const sdkTool = toAISDKTool(searchTool, {
  resourceId: { userId: "user_1" },
});