Class Toolset

constructor

• new Toolset(__namedParameters): Toolset

• Parameters

  • __namedParameters: {
        id: string;
        tools: readonly ToolContextEntry<any>[];
    }

    • id: string

    • tools: readonly ToolContextEntry<any>[]

  Returns Toolset

Readonly [TOOLSET_SYMBOL]

id

• get id(): string

• Returns string

tools

• get tools(): readonly ToolContextEntry<any>[]

• Returns readonly ToolContextEntry<any>[]

aclose

• aclose(): Promise<void>

• Returns Promise<void>

setup

• setup(_ctx): Promise<void>

• Parameters

  • _ctx: ToolsetContext

  Returns Promise<void>

Static create

• create(options): Toolset

• For when your tools share something that needs setup or cleanup, like a DB pool, an open MCP client, or listeners on a shared bus. setup runs once at activation, aclose once at teardown. If the tool list itself is dynamic (e.g. an MCP server), push it from setup via ToolsetContext.updateTools.

  Parameters

  • options: ToolsetCreateOptions

  Returns Toolset

  Example: Static tool list with a shared backing resource

  function createPostgresToolset(connectionUrl: string): Toolset {
    const pool = new pg.Pool({ connectionString: connectionUrl });
    return Toolset.create({
      id: 'postgres',
      tools: [queryOrders, queryCustomers],
      aclose: () => pool.end(),
    });
  }
  Copy

  Example: Dynamic tool list bound to an external source

  function createMcpToolset(url: string): Toolset {
    const client = new MCPClient({ url });
    return Toolset.create({
      id: 'mcp_remote',
      // setup connects and wires listeners that push the server's tools whenever they change;
      // the runtime re-advertises without re-running anything.
      setup: async ({ updateTools }) => {
        const sync = async () => updateTools(await client.listTools());
        client.on('connect', sync);
        client.on('tool_list_changed', sync);
        await client.connect();
      },
      tools: [],
      aclose: () => client.disconnect(),
    });
  }
  Copy