@seaflow/seaflow-tools

Versioned SeaFlow tool contracts for agent and host integrations.

This package is the source of truth for SeaFlow tool metadata:

• tool name
• description
• JSON input schema
• contract version
• contract hash

It intentionally does not export browser handlers, React code, store access, or host routing logic.

Usage

import {
  contractHash,
  contractVersion,
  getSeaflowCanvasToolContracts,
  seaflowCanvasToolCatalog,
  seaflowCanvasToolContracts,
} from '@seaflow/seaflow-tools';

SeaFlow app implementations bind these contracts to browser-side handlers. Host plugins can use the same contracts to generate manifests or proxy tools.

seaflowCanvasToolContracts contains the tools enabled by default. It intentionally excludes seaflow_canvas_ask_user_questions. Enable that interaction-only tool explicitly for agents that support user interaction:

const tools = getSeaflowCanvasToolContracts({ enableUserInteraction: true });

Use seaflowCanvasToolCatalog only for discovery, documentation, and validation. Do not pass the whole catalog to an agent as its enabled tool manifest.