@davothebigafro/tools

Generic tool and MCP infrastructure for Shipwright agents.

Install

pnpm add @davothebigafro/tools --filter <your-package>

Inside this workspace, keep local dependencies on workspace:*. For unreleased local installs, use the tarball workflow in the root contributing guide.

Minimal Usage

import { Type } from '@google/genai';
import { defineTool } from '@davothebigafro/tools';

export const lookupAccount = defineTool({
  name: 'lookupAccount',
  description: 'Looks up an account by id.',
  costClass: 'cheap',
  durable: false,
  parameters: {
    type: Type.OBJECT,
    properties: {
      accountId: { type: Type.STRING },
    },
    required: ['accountId'],
  },
  execute: async ({ accountId }) => ({ accountId, status: 'active' }),
});

AVAILABLE_TOOLS and MCP_SERVERS are empty in this package. Register application-specific tools and MCP servers outside the framework package.

Docs

• Architecture
• Inngest integration
• Root README