@kynver-app/tool-sdk

@kynver-app/tool-sdk

The author-facing SDK for the Kynver Tool Marketplace. Use it to declare tools that Kynver bundles, deploys to a sandbox, and exposes to the personal agent.

Phase-1 alpha. See tool-marketplace-map. Run npm run build before publish — the build bundles lib/tool-executor into dist/.

Example

import { z } from "zod";
import { defineTool, createToolModule } from "@kynver-app/tool-sdk";

const greet = defineTool({
  name: "greet",
  description: "Greet someone by name.",
  inputSchema: z.object({ name: z.string() }),
  handler: ({ name }) => `hello, ${name}`,
});

export default createToolModule(greet);

A handler receives a constrained ctx (egress-guarded fetch, secrets, log) and returns a string, a structured payload, or a widget descriptor.

See the Tool Marketplace map for the full executor contract.